/*
- This file is part of GNUnet
- (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors)
+ This file is part of GNUnet
+ Copyright (C) 2010, 2011 GNUnet e.V.
- GNUnet is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published
- by the Free Software Foundation; either version 3, or (at your
- option) any later version.
+ GNUnet is free software: you can redistribute it and/or modify it
+ under the terms of the GNU Affero General Public License as published
+ by the Free Software Foundation, either version 3 of the License,
+ or (at your option) any later version.
- GNUnet is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ GNUnet is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Affero General Public License for more details.
- You should have received a copy of the GNU General Public License
- along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
-*/
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
/**
* @file transport/plugin_transport_wlan.h
* @brief header for transport plugin and the helper for wlan
* @author David Brodski
*/
-
#ifndef PLUGIN_TRANSPORT_WLAN
#define PLUGIN_TRANSPORT_WLAN
-#include <stdint.h>
+#include "gnunet_crypto_lib.h"
#include "gnunet_common.h"
+/**
+ * Number fo bytes in a mac address.
+ */
+#ifdef MINGW
+ #define MAC_ADDR_SIZE 8
+ typedef uint8_t u_int8_t;
+#else
+ #define MAC_ADDR_SIZE 6
+#endif
+
+/**
+ * Value for "Management" in the 'frame_control' field of the
+ * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame.
+ */
+#define IEEE80211_FC0_TYPE_MGT 0x00
+
+/**
+ * Value for "Control" in the 'frame_control' field of the
+ * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame.
+ */
+#define IEEE80211_FC0_TYPE_CTL 0x04
+
+/**
+ * Value for DATA in the 'frame_control' field of the
+ * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame.
+ */
+#define IEEE80211_FC0_TYPE_DATA 0x08
+
+GNUNET_NETWORK_STRUCT_BEGIN
-struct MacAddress
+/**
+ * A MAC Address.
+ */
+struct GNUNET_TRANSPORT_WLAN_MacAddress
{
- char mac[6];
+ uint8_t mac[MAC_ADDR_SIZE];
};
-struct Wlan_Helper_Control_Message
+/**
+ * Format of a WLAN Control Message.
+ */
+struct GNUNET_TRANSPORT_WLAN_HelperControlMessage
{
+ /**
+ * Message header. Type is
+ * GNUNET_MESSAGE_TYPE_WLAN_HELPER_CONTROL
+ */
struct GNUNET_MessageHeader hdr;
- struct MacAddress mac ;
+
+ /**
+ * MAC Address of the local WLAN interface.
+ */
+ struct GNUNET_TRANSPORT_WLAN_MacAddress mac;
};
+/**
+ * generic definitions for IEEE 802.3 frames
+ */
+struct GNUNET_TRANSPORT_WLAN_Ieee8023Frame
+{
+
+ /**
+ * Address 1: destination address in ad-hoc mode or AP, BSSID if station,
+ */
+ struct GNUNET_TRANSPORT_WLAN_MacAddress dst;
+ /**
+ * Address 2: source address if in ad-hoc-mode or station, BSSID if AP
+ */
+ struct GNUNET_TRANSPORT_WLAN_MacAddress src;
-/* Wlan IEEE80211 header default */
-//Informations (in German) http://www.umtslink.at/content/WLAN_macheader-196.html
-static const uint8_t u8aIeeeHeader[] =
- {
- 0x08, 0x01, // Frame Control 0x08= 00001000 -> | b1,2 = 0 -> Version 0;
- // b3,4 = 10 -> Data; b5-8 = 0 -> Normal Data
- // 0x01 = 00000001 -> | b1 = 1 to DS; b2 = 0 not from DS;
- 0x00, 0x00, // Duration/ID
- 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, // mac1 - in this case receiver
- 0x13, 0x22, 0x33, 0x44, 0x55, 0x66, // mac2 - in this case bssid
- 0x13, 0x22, 0x33, 0x44, 0x55, 0x66, // mac3 - in this case sender
- 0x10, 0x86, //Sequence Control
- };
+ /**
+ * Packet type ID.
+ */
+ uint16_t type;
-// gnunet bssid
-static const char macbc[] =
- { 0x13, 0x22, 0x33, 0x44, 0x55, 0x66 };
+};
-// broadcast mac
-static const char bc_all_mac[] =
- { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF };
/**
- * Wlan header
+ * generic definitions for IEEE 802.11 frames
*/
-
-struct IeeeHeader
+struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame
{
/**
- * Wlan flags
+ * 802.11 Frame Control field. A bitmask. The overall field is a
+ * 16-bit mask of the respecitve fields. The lowest two bits should
+ * be 0, then comes the "type" (2 bits, see IEEE80211_FC0_TYPE_*
+ * constants), followed by 4-bit subtype (all zeros for ad-hoc),
+ * followed by various flags (to DS, from DS, more frag, retry,
+ * power management, more data, WEP, strict), all of which we also
+ * keep at zero.
*/
uint16_t frame_control GNUNET_PACKED;
/**
- * Duration / ID
+ * Microseconds to reserve link (duration), 0 by default
*/
- uint16_t duration_id GNUNET_PACKED;
-
+ uint16_t duration GNUNET_PACKED;
+
/**
- * first mac byte 1
+ * Address 1: destination address in ad-hoc mode or AP, BSSID if station,
*/
- struct MacAddress mac1;
+ struct GNUNET_TRANSPORT_WLAN_MacAddress addr1;
-
/**
- * second mac
+ * Address 2: source address if in ad-hoc-mode or station, BSSID if AP
*/
- struct MacAddress mac2;
-
+ struct GNUNET_TRANSPORT_WLAN_MacAddress addr2;
+
/**
- * third mac
+ * Address 3: BSSID in ad-hoc mode, Destination if station, source if AP
*/
- struct MacAddress mac3;
-
+ struct GNUNET_TRANSPORT_WLAN_MacAddress addr3;
+
/**
- * Wlan Sequence Control
+ * 802.11 sequence control field; contains fragment number an sequence
+ * number (we set this to all zeros).
*/
uint16_t sequence_control GNUNET_PACKED;
-};
-/* this is the template radiotap header we send packets out with */
-
-static const uint8_t u8aRadiotapHeader[] =
- {
- 0x00, 0x00, // <-- radiotap version
- 0x19, 0x00, // <- radiotap header length
- 0x6f, 0x08, 0x00, 0x00, // <-- bitmap
- 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // <-- timestamp
- 0x00, // <-- flags (Offset +0x10)
- 0x6c, // <-- rate (0ffset +0x11)
- 0x71, 0x09, 0xc0, 0x00, // <-- channel
- 0xde, // <-- antsignal
- 0x00, // <-- antnoise
- 0x01, // <-- antenna
+ /**
+ * Link layer control (LLC). Set to a GNUnet-specific value.
+ */
+ u_int8_t llc[4];
+
+ /* payload */
+
+} GNUNET_PACKED;
+
+
+
+/**
+ * Message from the plugin to the WLAN helper: send the given message with the
+ * given connection parameters.
+ */
+struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage
+{
+
+ /**
+ * Type is 'GNUNET_MESSAGE_TYPE_WLAN_DATA_TO_HELPER'.
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * wlan send rate
+ */
+ uint8_t rate;
+
+ /**
+ * Antenna; the first antenna is 0.
+ */
+ uint8_t antenna;
+
+ /**
+ * Transmit power expressed as unitless distance from max power set at factory calibration.
+ * 0 is max power. Monotonically nondecreasing with lower power levels.
+ */
+ uint16_t tx_power GNUNET_PACKED;
+
+ /**
+ * IEEE Frame to transmit (the sender MAC address will be overwritten by the helper as it does not
+ * trust the plugin to set it correctly).
+ */
+ struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame frame;
+
+ /* actual payload follows */
};
+
+/**
+ * Message from the WLAN helper to the plugin: we have received the given message with the
+ * given performance characteristics.
+ */
/**
- * Radiotap Header
+ * struct to represent infos gathered form the radiotap fields, see RadiotapHeader for more Infos
*/
-struct RadiotapHeader
+struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage
{
+
/**
- * radiotap version
+ * Type is 'GNUNET_MESSAGE_TYPE_WLAN_DATA_FROM_HELPER'.
*/
- uint16_t version GNUNET_PACKED;
-
+ struct GNUNET_MessageHeader header;
+
/**
- * radiotap header length
+ * Information about which of the fields below are actually valid.
+ * 0 for none. FIXME: not properly initialized so far (always zero).
*/
- uint16_t length GNUNET_PACKED;
-
+ uint32_t ri_present GNUNET_PACKED;
+
/**
- * bitmap
+ * IEEE80211_RADIOTAP_TSFT, 0 if unknown.
*/
- uint32_t bitmap GNUNET_PACKED;
-
+ uint64_t ri_mactime GNUNET_PACKED;
+
/**
- * timestamp
+ * from radiotap
+ * either IEEE80211_RADIOTAP_DBM_ANTSIGNAL
+ * or IEEE80211_RADIOTAP_DB_ANTSIGNAL, 0 if unknown.
*/
- uint64_t timestamp GNUNET_PACKED;
-
+ int32_t ri_power GNUNET_PACKED;
+
/**
- * radiotap flags
+ * either IEEE80211_RADIOTAP_DBM_ANTNOISE
+ * or IEEE80211_RADIOTAP_DB_ANTNOISE, 0 if unknown.
*/
- uint8_t flags;
-
+ int32_t ri_noise GNUNET_PACKED;
+
/**
- * wlan send rate
+ * IEEE80211_RADIOTAP_CHANNEL, 0 if unknown.
*/
- uint8_t rate;
-
- // FIXME: unaligned here, is this OK?
+ uint32_t ri_channel GNUNET_PACKED;
+
/**
- * Wlan channel
+ * Frequency we use. 0 if unknown.
*/
- uint32_t channel GNUNET_PACKED;
-
+ uint32_t ri_freq GNUNET_PACKED;
+
/**
- * antsignal
+ * IEEE80211_RADIOTAP_RATE * 50000, 0 if unknown.
*/
- uint8_t antsignal;
-
+ uint32_t ri_rate GNUNET_PACKED;
+
/**
- * antnoise
+ * IEEE80211_RADIOTAP_ANTENNA, 0 if unknown.
*/
- uint8_t antnoise;
-
+ uint32_t ri_antenna GNUNET_PACKED;
+
/**
- * antenna
+ * IEEE Frame.
*/
- uint8_t antenna;
+ struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame frame;
+
+ /* followed by payload */
+};
+
+GNUNET_NETWORK_STRUCT_END
+
+/**
+ * GNUnet bssid
+ */
+static const struct GNUNET_TRANSPORT_WLAN_MacAddress mac_bssid_gnunet = {
+ {0x13, 0x22, 0x33, 0x44, 0x55, 0x66}
+};
+
+
+/**
+ * Broadcast MAC
+ */
+static const struct GNUNET_TRANSPORT_WLAN_MacAddress bc_all_mac = {
+ {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}
};
#endif