X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;ds=sidebyside;f=src%2Ftransport%2Fplugin_transport_wlan.h;h=bcbaa6371fd882bd0711dd717779c094eb55483b;hb=3685629253bb94994449f56871252af24a91b6e7;hp=3baa4d79d032c7d891e98a314f37d584c60866f6;hpb=64e50b6dfbf852eb19d1b5d55ca8709422199a44;p=oweals%2Fgnunet.git diff --git a/src/transport/plugin_transport_wlan.h b/src/transport/plugin_transport_wlan.h index 3baa4d79d..bcbaa6371 100644 --- a/src/transport/plugin_transport_wlan.h +++ b/src/transport/plugin_transport_wlan.h @@ -1,235 +1,287 @@ /* - This file is part of GNUnet - (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors) - - 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 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. - - 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. -*/ + 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 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. + + 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., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. + */ /** * @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 +#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 { - u_int8_t 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; }; /** - * Header for messages which need fragmentation + * generic definitions for IEEE 802.3 frames */ -struct FragmentationHeader +struct GNUNET_TRANSPORT_WLAN_Ieee8023Frame { - struct GNUNET_MessageHeader header; - /** - * ID of message, to distinguish between the messages, picked randomly. + * Address 1: destination address in ad-hoc mode or AP, BSSID if station, */ - uint32_t message_id GNUNET_PACKED; + struct GNUNET_TRANSPORT_WLAN_MacAddress dst; /** - * Offset or number of this fragment, for fragmentation/segmentation (design choice, TBD) + * Address 2: source address if in ad-hoc-mode or station, BSSID if AP */ - uint16_t fragment_off_or_num GNUNET_PACKED; + struct GNUNET_TRANSPORT_WLAN_MacAddress src; /** - * CRC of fragment (for error checking) + * Packet type ID. */ - uint16_t message_crc GNUNET_PACKED; - -// followed by payload + uint16_t type; }; + /** - * Header for messages which need fragmentation + * generic definitions for IEEE 802.11 frames */ -struct WlanHeader +struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame { - - struct GNUNET_MessageHeader header; - /** - * checksum/error correction + * 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. */ - uint32_t crc GNUNET_PACKED; + uint16_t frame_control GNUNET_PACKED; /** - * To whom are we talking to (set to our identity - * if we are still waiting for the welcome message) + * Microseconds to reserve link (duration), 0 by default */ - struct GNUNET_PeerIdentity target; + uint16_t duration GNUNET_PACKED; -// followed by payload + /** + * Address 1: destination address in ad-hoc mode or AP, BSSID if station, + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr1; -}; + /** + * Address 2: source address if in ad-hoc-mode or station, BSSID if AP + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr2; -/* 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 sender - 0x13, 0x22, 0x33, 0x44, 0x55, 0x66, // mac3 - in this case bssid - 0x10, 0x86, //Sequence Control - }; - -// gnunet bssid -static const struct MacAddress mac_bssid = - { { 0x13, 0x22, 0x33, 0x44, 0x55, 0x66 } } ; - -// broadcast mac -static const struct MacAddress bc_all_mac = - { { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF } }; - - -/* 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 -}; + /** + * Address 3: BSSID in ad-hoc mode, Destination if station, source if AP + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr3; -struct Radiotap_Send -{ /** - * wlan send rate - */ - uint8_t rate; + * 802.11 sequence control field; contains fragment number an sequence + * number (we set this to all zeros). + */ + uint16_t sequence_control GNUNET_PACKED; - /** - * antenna - */ - uint8_t antenna; + /** + * Link layer control (LLC). Set to a GNUnet-specific value. + */ + u_int8_t llc[4]; - /** - * Transmit power expressed as unitless distance from max power set at factory calibration. - * 0 is max power. Monotonically nondecreasing with lower power levels. - */ + /* payload */ - uint16_t tx_power; -}; +} GNUNET_PACKED; -// bit field defines for ri_present -#define has_noise 1 -#define has_power 2 -#define has_channel 4 /** - * struct to represent infos gathered form the radiotap fields + * 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; -struct Radiotap_rx { - uint32_t ri_present; - uint64_t ri_mactime; - int32_t ri_power; - int32_t ri_noise; - uint32_t ri_channel; - uint32_t ri_freq; - uint32_t ri_rate; - uint32_t ri_antenna; + /* actual payload follows */ }; + /** - * Radiotap Header + * Message from the WLAN helper to the plugin: we have received the given message with the + * given performance characteristics. */ -struct RadiotapHeader +/** + * struct to represent infos gathered form the radiotap fields, see RadiotapHeader for more Infos + */ +struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage { + /** - * radiotap version + * Type is 'GNUNET_MESSAGE_TYPE_WLAN_DATA_FROM_HELPER'. */ - u_int8_t version; + struct GNUNET_MessageHeader header; - u_int8_t pad_version; - /** - * 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, fields present + * 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