/* * This file is part of the rtap localisation project. */ #ifndef _LIBOWLPS_H_ #define _LIBOWLPS_H_ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include // Port on which the positioning request is sent by the mobile: #define LOC_REQUEST_DEFAULT_PORT 9900 // Port on which listeners and aggregator communicate: #define AGGREGATE_DEFAULT_PORT 9901 // Port on which aggregator and positioning server communicate: #define POSITIONER_DEFAULT_PORT 9902 // Port on which autocalibration requests are sent by the listeners: #define DEFAULT_AUTOCALIBRATION_REQUEST_PORT 9903 // Port on which the aggregator listens for hello messages from the // listeners, and the listeners listen for orders from the aggregator: #define DEFAULT_AUTOCALIBRATION_PORT 9904 // Port on which the mobile listens for its position: #define MOBILE_DEFAULT_PORT 9910 /* Boolean type */ typedef enum {FALSE, TRUE} BOOL ; #define BOOL_TO_STRING(B) ((B) ? "true" : "false") /* Direction type */ typedef enum {NORTH = 1, EAST, SOUTH, WEST} DIRECTION ; /* Message sent by the listener to the aggregator */ typedef struct _couple_message { unsigned char ap_mac_addr_bytes[6] ; // MAC of the listener unsigned char mobile_mac_addr_bytes[6] ; // MAC of the mobile involved unsigned char mobile_ip_addr_bytes[4] ; // IP of the mobile struct timeval request_time ; // Request ID (timestamp on the mobile) struct timeval start_time ; // Timestamp of arrival on the listener unsigned char antenna_signal_dbm ; // Signal strength measured by the listener /* Calibration data */ float x_position ; float y_position ; float z_position ; DIRECTION direction ; } couple_message ; typedef struct _couple_info { unsigned char ap_mac_addr_bytes[6] ; // MAC of the listener unsigned char antenna_signal_dbm ; // Signal strength measured by the listener } couple_info ; typedef struct _request { unsigned char mobile_mac_addr_bytes[6]; // MAC of the mobile struct timeval request_time; // Request ID (timestamp on the mobile) int nb_couples; // Number of (listener MAC;signal strength) couples } request; /* Hello message sent by the listener to the aggregator */ typedef struct _autocalibration_hello { unsigned char ap_mac_addr_bytes[6]; } autocalibration_hello ; /* Message sent to the listener to order an emission */ typedef struct _autocalibration_order { enum {AUTOCALIBRATION_ORDER_SEND = 1} order ; } autocalibration_order ; /* Positioning request types */ #define PACKET_TYPE_NORMAL 0 #define PACKET_TYPE_CALIBRATION 1 #define PACKET_TYPE_AUTOCALIBRATION 2 /* Wi-Fi channel frequencies in Hz */ #define CHANNEL_1 2412 #define CHANNEL_2 2417 #define CHANNEL_3 2422 #define CHANNEL_4 2427 #define CHANNEL_5 2432 #define CHANNEL_6 2437 #define CHANNEL_7 2442 #define CHANNEL_8 2447 #define CHANNEL_9 2452 #define CHANNEL_10 2457 #define CHANNEL_11 2462 #define CHANNEL_12 2467 #define CHANNEL_13 2472 #define CHANNEL_14 2477 /* Packet header sizes (in bytes) */ #define IEEE80211_HEADER_SIZE_DATA 24 // Header size for a Data frame #define LLC_HEADER_SIZE 8 /* IEEE 802.11 frame types */ // Beacon (TODO: convert to mask) #define RAW_PACKET_TYPE_BEACON 0x80 // Data frame #define FRAME_TYPE_DATA_MASK 0x08 #define IS_DATA_FRAME(FC1) \ (((FC1) & FRAME_TYPE_DATA_MASK) == FRAME_TYPE_DATA_MASK) // QoS Data frame #define FRAME_SUBTYPE_QOS_MASK 0x80 #define DATA_FRAME_IS_QOS(FC1) \ (((FC1) & FRAME_SUBTYPE_QOS_MASK) == FRAME_SUBTYPE_QOS_MASK) // To/From DS #define FRAME_FROM_STA_MASK 0x02 #define IS_FRAME_FROM_STA(FC2) \ (((FC2) & FRAME_FROM_STA_MASK) != FRAME_FROM_STA_MASK) /* Positions of the radiotap header fixed fields (in bytes) */ #define RTAP_P_HREVISION 0 // Header revision #define RTAP_P_HPAD 1 // Header pad #define RTAP_P_HLENGTH 2 // Header length #define RTAP_P_PRESENTFLAGS 4 // Present flags /* Radiotap field lengths (in bytes) */ #define RTAP_L_HREVISION 1 // Header revision #define RTAP_L_HPAD 1 // Header pad #define RTAP_L_HLENGTH 2 // Header length #define RTAP_L_PRESENTFLAGS 4 // Present flags #define RTAP_L_MACTS 8 // MAC timestamp (Time Synchronization Function Timer) #define RTAP_L_FLAGS 1 // autre champ de flags #define RTAP_L_RATE 1 // Data rate #define RTAP_L_CHANNEL 2 // Channel frequency #define RTAP_L_CHANNELTYPE 2 // Channel type #define RTAP_L_ANTENNASIGNALDBM 1 // SSI signal (dBm) #define RTAP_L_ANTENNANOISEDBM 1 // SSI noise (dBm) #define RTAP_L_ANTENNA 1 // Antenna number #define RTAP_L_FHSS 2 // Hop set and pattern for Frequency-Hopping Spread Spectrum #define RTAP_L_LOCKQUALITY 2 // Signal quality #define RTAP_L_TXATTENUATION 2 // Transmit power from max power #define RTAP_L_TXATTENUATIONDB 2 // Idem (dB) #define RTAP_L_TXATTENUATIONDBM 1 // Idem (dBm) #define RTAP_L_ANTENNASIGNALDB 1 // SSI signal (dB) #define RTAP_L_ANTENNANOISEDB 1 // SSI noise (dB) #define RTAP_L_FCS 4 // Frame Check Sequence //#define RTAP_L_CHANNELP // Extended channel info (not implemented) //#define RTAP_L_EXT // Extension aux Present flags (not emplemented) /* Positions in 'Present flags' (and present fields 'check' array) */ #define RTAP_MACTS 0 #define RTAP_FLAGS 1 #define RTAP_RATE 2 #define RTAP_CHANNEL 3 // and RTAP_CHANNELTYPE #define RTAP_FHSS 4 #define RTAP_ANTENNASIGNALDBM 5 #define RTAP_ANTENNANOISEDBM 6 #define RTAP_LOCKQUALITY 7 #define RTAP_TXATTENUATION 8 #define RTAP_TXATTENUATIONDB 9 #define RTAP_TXATTENUATIONDBM 10 #define RTAP_ANTENNA 11 #define RTAP_ANTENNASIGNALDB 12 #define RTAP_ANTENNANOISEDB 13 #define RTAP_FCS 14 //#define RTAP_CHANNELP 18 //#define RTAP_EXT 31 /* Global variables */ BOOL run ; /* Function error codes */ #define ERR_SETTING_MODE 101 #define ERR_SETTING_CHANNEL 102 #define ERR_READING_CHANNEL 103 #define ERR_READING_MODE 104 #define ERR_BAD_SIGNAL 111 /* Function headers */ // Tool functions char* mac_bytes_to_string(unsigned char *mac_binary) ; char frequency_to_channel(unsigned short channel) ; unsigned long long timeval_to_ms(struct timeval date) ; unsigned long sub_date(struct timeval sup, struct timeval inf) ; BOOL mac_cmp(unsigned char *mac1, unsigned char *mac2) ; // Network int create_udp_sending_socket(char *server_address, int server_port, struct sockaddr_in *server_description, struct sockaddr_in * client_description) ; int create_udp_listening_socket(int port) ; int iface_mode_monitor(char *iface) ; int iface_set_channel(char *iface, int channel) ; int iface_channel_hop(char *iface) ; // Signals void sigint_handler(int num) ; void sigterm_handler(int num) ; /* Macros */ /* * Test if a IEEE 802.11 frame is a retry. * Input: IEEE 802.11 header flags. * Returns 0 if the Retry bit is absent, a positive value if present. */ #define IS_RETRY(IEEE80211_FLAGS) ((IEEE80211_FLAGS) & 0x08) #endif // _LIBOWLPS_H_