1 | /* |
---|
2 | * This file is part of libtrace |
---|
3 | * |
---|
4 | * Copyright (c) 2004 The University of Waikato, Hamilton, New Zealand. |
---|
5 | * Authors: Daniel Lawson |
---|
6 | * Perry Lorier |
---|
7 | * |
---|
8 | * All rights reserved. |
---|
9 | * |
---|
10 | * This code has been developed by the University of Waikato WAND |
---|
11 | * research group. For further information please see http://www.wand.net.nz/ |
---|
12 | * |
---|
13 | * libtrace is free software; you can redistribute it and/or modify |
---|
14 | * it under the terms of the GNU General Public License as published by |
---|
15 | * the Free Software Foundation; either version 2 of the License, or |
---|
16 | * (at your option) any later version. |
---|
17 | * |
---|
18 | * libtrace is distributed in the hope that it will be useful, |
---|
19 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
20 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
21 | * GNU General Public License for more details. |
---|
22 | * |
---|
23 | * You should have received a copy of the GNU General Public License |
---|
24 | * along with libtrace; if not, write to the Free Software |
---|
25 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
---|
26 | * |
---|
27 | * $Id$ |
---|
28 | * |
---|
29 | */ |
---|
30 | |
---|
31 | #ifndef _WAG_H |
---|
32 | #define _WAG_H |
---|
33 | |
---|
34 | /* This is the WAG magic number - used to delimit frames */ |
---|
35 | #define WAG_MAGIC (0xdaa1) |
---|
36 | |
---|
37 | /* Define frame types */ |
---|
38 | #define FRAME_TYPE_DATA (0x0000) |
---|
39 | #define FRAME_TYPE_UNDEFINED (0xffff) |
---|
40 | |
---|
41 | /* Define frame subtypes */ |
---|
42 | #define FRAME_SUBTYPE_DATA_RX (0x0000) |
---|
43 | #define FRAME_SUBTYPE_DATA_TX (0x0001) |
---|
44 | |
---|
45 | /** This is the common part of the frame header. |
---|
46 | * We synchronise by scanning a stream to look for the magic number |
---|
47 | * (WAG_MAGIC). We can then tell the size and type of this frame, and pass |
---|
48 | * over it if necessary. |
---|
49 | */ |
---|
50 | struct frame_t { |
---|
51 | uint16_t magic; /**< magic number (0xdaa1) */ |
---|
52 | uint16_t size; /**< total frame size in bytes */ |
---|
53 | uint16_t type; /**< frame type */ |
---|
54 | uint16_t subtype; /**< frame subtype */ |
---|
55 | }; |
---|
56 | |
---|
57 | /*///////////////////////////////////////////////////////////////////////////////// |
---|
58 | // |
---|
59 | // Frames that the radio part of the WAG framework understands |
---|
60 | // |
---|
61 | /////////////////////////////////////////////////////////////////////////////////// |
---|
62 | // Common subfields... |
---|
63 | */ |
---|
64 | |
---|
65 | /** timestamp */ |
---|
66 | struct timestamp_t { |
---|
67 | uint32_t secs; /**< seconds since start of 01-01-1970 */ |
---|
68 | uint32_t subsecs; /**< (1/(2^32))ths of a second */ |
---|
69 | }; |
---|
70 | |
---|
71 | /** frame stream information */ |
---|
72 | struct strinfo_t { |
---|
73 | uint16_t unused_1; |
---|
74 | uint16_t unused_2; |
---|
75 | uint16_t unused_3; |
---|
76 | uint16_t packets_lost; /**< Number of packets lost */ |
---|
77 | }; |
---|
78 | |
---|
79 | /** Type: DATA, Subtype: RX */ |
---|
80 | struct frame_data_rx_t { |
---|
81 | struct frame_t hdr; /**< common frame header */ |
---|
82 | struct strinfo_t strinfo; /**< stream status */ |
---|
83 | struct timestamp_t ts; /**< timestamp of reception of this frame */ |
---|
84 | struct { |
---|
85 | uint8_t rssi; /**< receive signal strength of this frame */ |
---|
86 | uint8_t rxstatus; /**< rx status bits from the modem */ |
---|
87 | uint16_t length; /**< length in bytes of the frame payload */ |
---|
88 | struct { |
---|
89 | uint8_t signal; /**< 802.11PLCP signal field */ |
---|
90 | uint8_t service; /**< 802.11PLCP service field */ |
---|
91 | uint16_t length; /**< 802.11PLCP length field (uS) */ |
---|
92 | } plcp; |
---|
93 | } rxinfo; |
---|
94 | }; |
---|
95 | |
---|
96 | /** Type: DATA, Subtype: TX */ |
---|
97 | struct frame_data_tx_t { |
---|
98 | struct frame_t hdr; /**< common frame header */ |
---|
99 | uint64_t unused_1; |
---|
100 | uint64_t unused_2; |
---|
101 | struct { |
---|
102 | uint8_t gain; /**< tx gain with which to send this packet */ |
---|
103 | uint8_t mode; /**< tx mode with which to send this packet */ |
---|
104 | uint16_t length; /**< length in bytes of the frame payload */ |
---|
105 | uint32_t unused_1; |
---|
106 | } txinfo; |
---|
107 | }; |
---|
108 | |
---|
109 | /** 802.11 payload */ |
---|
110 | struct ieee_802_11_payload { |
---|
111 | uint16_t type; /**< ether type of this packet */ |
---|
112 | }; |
---|
113 | |
---|
114 | |
---|
115 | #endif |
---|