Instead of converting between 802.11 frequencies and channels umpteen
[obnox/wireshark/wip.git] / epan / dissectors / packet-ppi.c
1 /*
2  * packet-ppi.c
3  * Routines for PPI Packet Header dissection
4  *
5  * Wireshark - Network traffic analyzer
6  * By Gerald Combs <gerald@wireshark.org>
7  * Copyright 2007 Gerald Combs
8  *
9  * Copied from README.developer
10  *
11  * $Id$
12  *
13  * Copyright (c) 2006 CACE Technologies, Davis (California)
14  * All rights reserved.
15  *
16  * Redistribution and use in source and binary forms, with or without
17  * modification, are permitted provided that the following conditions
18  * are met:
19  * 1. Redistributions of source code must retain the above copyright
20  *    notice, this list of conditions and the following disclaimer.
21  * 2. Redistributions in binary form must reproduce the above copyright
22  *    notice, this list of conditions and the following disclaimer in the
23  *    documentation and/or other materials provided with the distribution.
24  * 3. Neither the name of the project nor the names of its contributors
25  *    may be used to endorse or promote products derived from this software
26  *    without specific prior written permission.
27  *
28  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
29  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
32  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
34  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
35  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38  * SUCH DAMAGE.
39  */
40
41 #ifdef HAVE_CONFIG_H
42 # include "config.h"
43 #endif
44
45 #include <glib.h>
46 #include <string.h>
47
48 #include <epan/packet.h>
49 #include <epan/ptvcursor.h>
50 #include <epan/prefs.h>
51 #include <epan/reassemble.h>
52 #include <epan/range.h>
53 #include <epan/frequency-utils.h>
54
55 /* Needed for wtap_pcap_encap_to_wtap_encap().  Should we move it somewhere
56  * else? */
57 #ifdef HAVE_LIBPCAP
58 #include <pcap.h>
59 #endif
60 #include <wiretap/wtap-capture.h>
61
62 #include "packet-frame.h"
63 #include "packet-eth.h"
64 #include "packet-ieee80211.h"
65
66 /*
67  * Per-Packet Information (PPI) header.
68  * See the PPI Packet Header documentation at
69  * www.cacetech.com/documents/PPI_Header_format_1.0.pdf
70  * for details.
71  */
72
73 /*
74  * PPI headers have the following format:
75  *
76  * ,---------------------------------------------------------.
77  * | PPH | PFH 1 | Field data 1 | PFH 2 | Field data 2 | ... |
78  * `---------------------------------------------------------'
79  *
80  * The PPH struct has the following format:
81  *
82  * typedef struct ppi_packetheader {
83  *     guint8  pph_version;     // Version.  Currently 0
84  *     guint8  pph_flags;       // Flags.
85  *     guint16 pph_len; // Length of entire message, including this header and TLV payload.
86  *     guint32 pph_dlt; // libpcap Data Link Type of the captured packet data.
87  * } ppi_packetheader_t;
88  *
89  * The PFH struct has the following format:
90  *
91  * typedef struct ppi_fieldheader {
92  *     guint16 pfh_type;        // Type
93  *     guint16 pfh_datalen;     // Length of data
94  * } ppi_fieldheader_t;
95  */
96
97 #define PPI_PADDED (1 << 0)
98
99 #define PPI_V0_HEADER_LEN 8
100 #define PPI_80211_COMMON_LEN 20
101 #define PPI_80211N_MAC_LEN 12
102 #define PPI_80211N_MAC_PHY_OFF 9
103 #define PPI_80211N_MAC_PHY_LEN 48
104
105 #define PPI_FLAG_ALIGN 0x01
106 #define IS_PPI_FLAG_ALIGN(x) ((x) & PPI_FLAG_ALIGN)
107
108 #define DOT11_FLAG_HAVE_FCS 0x0001
109
110 #define DOT11N_FLAG_IS_AGGREGATE 0x0010
111 #define DOT11N_FLAG_MORE_AGGREGATES 0x0020
112 #define DOT11N_FLAG_AGG_CRC_ERROR 0x0040
113
114 #define DOT11N_IS_AGGREGATE(flags)      (flags & DOT11N_FLAG_IS_AGGREGATE)
115 #define DOT11N_MORE_AGGREGATES(flags)   ( \
116     (flags & DOT11N_FLAG_MORE_AGGREGATES) && \
117     !(flags & DOT11N_FLAG_AGG_CRC_ERROR))
118 #define AGGREGATE_MAX 65535
119 #define AMPDU_MAX 16383
120
121 /* XXX - Start - Copied from packet-radiotap.c */
122 /* Channel flags. */
123 #define IEEE80211_CHAN_TURBO    0x0010  /* Turbo channel */
124 #define IEEE80211_CHAN_CCK      0x0020  /* CCK channel */
125 #define IEEE80211_CHAN_OFDM     0x0040  /* OFDM channel */
126 #define IEEE80211_CHAN_2GHZ     0x0080  /* 2 GHz spectrum channel. */
127 #define IEEE80211_CHAN_5GHZ     0x0100  /* 5 GHz spectrum channel */
128 #define IEEE80211_CHAN_PASSIVE  0x0200  /* Only passive scan allowed */
129 #define IEEE80211_CHAN_DYN      0x0400  /* Dynamic CCK-OFDM channel */
130 #define IEEE80211_CHAN_GFSK     0x0800  /* GFSK channel (FHSS PHY) */
131
132 /*
133  * Useful combinations of channel characteristics.
134  */
135 #define IEEE80211_CHAN_FHSS \
136         (IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_GFSK)
137 #define IEEE80211_CHAN_A \
138         (IEEE80211_CHAN_5GHZ | IEEE80211_CHAN_OFDM)
139 #define IEEE80211_CHAN_B \
140         (IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_CCK)
141 #define IEEE80211_CHAN_PUREG \
142         (IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_OFDM)
143 #define IEEE80211_CHAN_G \
144         (IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_DYN)
145 #define IEEE80211_CHAN_T \
146         (IEEE80211_CHAN_5GHZ | IEEE80211_CHAN_OFDM | IEEE80211_CHAN_TURBO)
147 #define IEEE80211_CHAN_108G \
148         (IEEE80211_CHAN_G | IEEE80211_CHAN_TURBO)
149 #define IEEE80211_CHAN_108PUREG \
150         (IEEE80211_CHAN_PUREG | IEEE80211_CHAN_TURBO)
151 /* XXX - End - Copied from packet-radiotap.c */
152
153 typedef enum {
154     /* 0 - 29999: Public types */
155     PPI_80211_COMMON        =  2,
156     PPI_80211N_MAC          =  3,
157     PPI_80211N_MAC_PHY      =  4,
158     PPI_SPECTRUM_MAP        =  5,
159     PPI_PROCESS_INFO        =  6,
160     PPI_CAPTURE_INFO        =  7,
161     /* 11 - 29999: RESERVED */
162
163     /* 30000 - 65535: Private types */
164     CACE_PRIVATE                = 0xCACE
165     /* All others RESERVED.  Contact the WinPcap team for an assignment */
166 } ppi_field_type;
167
168 /* Protocol */
169 static int proto_ppi = -1;
170
171 /* Packet header */
172 static int hf_ppi_head_version = -1;
173 static int hf_ppi_head_flags = -1;
174 static int hf_ppi_head_flag_alignment = -1;
175 static int hf_ppi_head_flag_reserved = -1;
176 static int hf_ppi_head_len = -1;
177 static int hf_ppi_head_dlt = -1;
178
179 /* Field header */
180 static int hf_ppi_field_type = -1;
181 static int hf_ppi_field_len = -1;
182
183 /* 802.11 Common */
184 static int hf_80211_common_tsft = -1;
185 static int hf_80211_common_flags = -1;
186 static int hf_80211_common_flags_fcs = -1;
187 static int hf_80211_common_flags_tsft = -1;
188 static int hf_80211_common_flags_fcs_valid = -1;
189 static int hf_80211_common_flags_phy_err = -1;
190 static int hf_80211_common_rate = -1;
191 static int hf_80211_common_chan_freq = -1;
192 static int hf_80211_common_chan_flags = -1;
193
194 static int hf_80211_common_chan_flags_turbo = -1;
195 static int hf_80211_common_chan_flags_cck = -1;
196 static int hf_80211_common_chan_flags_ofdm = -1;
197 static int hf_80211_common_chan_flags_2ghz = -1;
198 static int hf_80211_common_chan_flags_5ghz = -1;
199 static int hf_80211_common_chan_flags_passive = -1;
200 static int hf_80211_common_chan_flags_dynamic = -1;
201 static int hf_80211_common_chan_flags_gfsk = -1;
202
203 static int hf_80211_common_fhss_hopset = -1;
204 static int hf_80211_common_fhss_pattern = -1;
205 static int hf_80211_common_dbm_antsignal = -1;
206 static int hf_80211_common_dbm_antnoise = -1;
207
208 /* 802.11n MAC */
209 static int hf_80211n_mac_flags = -1;
210 static int hf_80211n_mac_flags_greenfield = -1;
211 static int hf_80211n_mac_flags_ht20_40 = -1;
212 static int hf_80211n_mac_flags_rx_guard_interval = -1;
213 static int hf_80211n_mac_flags_duplicate_rx = -1;
214 static int hf_80211n_mac_flags_more_aggregates = -1;
215 static int hf_80211n_mac_flags_aggregate = -1;
216 static int hf_80211n_mac_flags_delimiter_crc_after = -1;
217 static int hf_80211n_mac_flags_undocumented_debug_alpha = -1;
218 static int hf_80211n_mac_ampdu_id = -1;
219 static int hf_80211n_mac_num_delimiters = -1;
220 static int hf_80211n_mac_reserved = -1;
221
222 /* 802.11n MAC+PHY */
223 static int hf_80211n_mac_phy_mcs = -1;
224 static int hf_80211n_mac_phy_num_streams = -1;
225 static int hf_80211n_mac_phy_rssi_combined = -1;
226 static int hf_80211n_mac_phy_rssi_ant0_ctl = -1;
227 static int hf_80211n_mac_phy_rssi_ant1_ctl = -1;
228 static int hf_80211n_mac_phy_rssi_ant2_ctl = -1;
229 static int hf_80211n_mac_phy_rssi_ant3_ctl = -1;
230 static int hf_80211n_mac_phy_rssi_ant0_ext = -1;
231 static int hf_80211n_mac_phy_rssi_ant1_ext = -1;
232 static int hf_80211n_mac_phy_rssi_ant2_ext = -1;
233 static int hf_80211n_mac_phy_rssi_ant3_ext = -1;
234 static int hf_80211n_mac_phy_ext_chan_freq = -1;
235 static int hf_80211n_mac_phy_ext_chan_flags = -1;
236 static int hf_80211n_mac_phy_ext_chan_flags_turbo = -1;
237 static int hhf_80211n_mac_phy_ext_chan_flags_cck = -1;
238 static int hf_80211n_mac_phy_ext_chan_flags_ofdm = -1;
239 static int hhf_80211n_mac_phy_ext_chan_flags_2ghz = -1;
240 static int hf_80211n_mac_phy_ext_chan_flags_5ghz = -1;
241 static int hf_80211n_mac_phy_ext_chan_flags_passive = -1;
242 static int hf_80211n_mac_phy_ext_chan_flags_dynamic = -1;
243 static int hf_80211n_mac_phy_ext_chan_flags_gfsk = -1;
244 static int hf_80211n_mac_phy_dbm_ant0signal = -1;
245 static int hf_80211n_mac_phy_dbm_ant0noise = -1;
246 static int hf_80211n_mac_phy_dbm_ant1signal = -1;
247 static int hf_80211n_mac_phy_dbm_ant1noise = -1;
248 static int hf_80211n_mac_phy_dbm_ant2signal = -1;
249 static int hf_80211n_mac_phy_dbm_ant2noise = -1;
250 static int hf_80211n_mac_phy_dbm_ant3signal = -1;
251 static int hf_80211n_mac_phy_dbm_ant3noise = -1;
252 static int hf_80211n_mac_phy_evm0 = -1;
253 static int hf_80211n_mac_phy_evm1 = -1;
254 static int hf_80211n_mac_phy_evm2 = -1;
255 static int hf_80211n_mac_phy_evm3 = -1;
256
257 /* 802.11n-Extensions A-MPDU fragments */
258 static int hf_ampdu_reassembled_in = -1;
259 static int hf_ampdu_segments = -1;
260 static int hf_ampdu_segment = -1;
261 static int hf_ampdu_count  = -1;
262
263 /* Spectrum-Map */
264 static int hf_spectrum_map = -1;
265
266 /* Process-Info */
267 static int hf_process_info = -1;
268
269 /* Capture-Info */
270 static int hf_capture_info = -1;
271
272 static gint ett_ppi_pph = -1;
273 static gint ett_ppi_flags = -1;
274 static gint ett_dot11_common = -1;
275 static gint ett_dot11_common_flags = -1;
276 static gint ett_dot11_common_channel_flags = -1;
277 static gint ett_dot11n_mac = -1;
278 static gint ett_dot11n_mac_flags = -1;
279 static gint ett_dot11n_mac_phy = -1;
280 static gint ett_dot11n_mac_phy_ext_channel_flags = -1;
281 static gint ett_ampdu_segments = -1;
282 static gint ett_ampdu = -1;
283 static gint ett_ampdu_segment  = -1;
284
285 static dissector_handle_t data_handle;
286 static dissector_handle_t ieee80211_ht_handle;
287
288 static const true_false_string tfs_ppi_head_flag_alignment = { "32-bit aligned", "Not aligned" };
289 static const true_false_string tfs_tsft_ms = { "milliseconds", "microseconds" };
290 static const true_false_string tfs_ht20_40 = { "HT40", "HT20" };
291 static const true_false_string tfs_invalid_valid = { "Invalid", "Valid" };
292 static const true_false_string tfs_phy_error = { "PHY error", "No errors"};
293
294 static const value_string vs_ppi_field_type[] = {
295     {PPI_80211_COMMON, "802.11-Common"},
296     {PPI_80211N_MAC, "802.11n MAC Extensions"},
297     {PPI_80211N_MAC_PHY, "802.11n MAC+PHY Extensions"},
298     {PPI_SPECTRUM_MAP, "Spectrum-Map"},
299     {PPI_PROCESS_INFO, "Process-Info"},
300     {PPI_CAPTURE_INFO, "Capture-Info"},
301     {0, NULL}
302 };
303
304 /* XXX - Start - Copied from packet-radiotap.c */
305 static const value_string vs_80211_common_phy_type[] = {
306     { 0, "Unknown" },
307     { IEEE80211_CHAN_A,         "802.11a" },
308     { IEEE80211_CHAN_B,         "802.11b" },
309     { IEEE80211_CHAN_PUREG,     "802.11g (pure-g)" },
310     { IEEE80211_CHAN_G,         "802.11g" },
311     { IEEE80211_CHAN_T,         "802.11a (turbo)" },
312     { IEEE80211_CHAN_108PUREG,  "802.11g (pure-g, turbo)" },
313     { IEEE80211_CHAN_108G,      "802.11g (turbo)" },
314     { IEEE80211_CHAN_FHSS,      "FHSS" },
315     { 0, NULL },
316 };
317 /* XXX - End - Copied from packet-radiotap.c */
318
319 /* Tables for A-MPDU reassembly */
320 static GHashTable *ampdu_fragment_table = NULL;
321 static GHashTable *ampdu_reassembled_table = NULL;
322
323 /* Reassemble A-MPDUs? */
324 static gboolean ppi_ampdu_reassemble = TRUE;
325
326
327 static void
328 dissect_ppi(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
329
330 void
331 capture_ppi(const guchar *pd, int len, packet_counts *ld)
332 {
333     guint32 dlt;
334     guint ppi_len, data_type, data_len;
335     guint offset = PPI_V0_HEADER_LEN;
336     gboolean is_htc = FALSE;
337
338     ppi_len = pletohs(pd+2);
339     if(ppi_len < PPI_V0_HEADER_LEN || !BYTES_ARE_IN_FRAME(0, len, ppi_len)) {
340         ld->other++;
341         return;
342     }
343
344     dlt = pletohl(pd+4);
345
346     /* Figure out if we're +HTC */
347     while (offset < ppi_len) {
348         data_type = pletohs(pd+offset);
349         data_len = pletohs(pd+offset+2) + 4;
350         offset += data_len;
351
352         if (data_type == PPI_80211N_MAC || data_type == PPI_80211N_MAC_PHY) {
353             is_htc = TRUE;
354             break;
355         }
356     }
357
358     /* XXX - We should probably combine this with capture_info.c:capture_info_packet() */
359     switch(dlt) {
360         case 1: /* DLT_EN10MB */
361             capture_eth(pd, ppi_len, len, ld);
362             return;
363             break;
364         case 105: /* DLT_DLT_IEEE802_11 */
365             if (is_htc)
366                 capture_ieee80211_ht(pd, ppi_len, len, ld);
367             else
368                 capture_ieee80211(pd, ppi_len, len, ld);
369             return;
370             break;
371         default:
372             break;
373     }
374
375     ld->other++;
376 }
377
378 static void ptvcursor_add_invalid_check(ptvcursor_t *csr, int hf, gint len, guint64 invalid_val) {
379     proto_item *ti;
380     guint64 val = invalid_val;
381
382     switch (len) {
383         case 8:
384             val = tvb_get_letoh64(ptvcursor_tvbuff(csr),
385                 ptvcursor_current_offset(csr));
386             break;
387         case 4:
388             val = tvb_get_letohl(ptvcursor_tvbuff(csr),
389                 ptvcursor_current_offset(csr));
390             break;
391         case 2:
392             val = tvb_get_letohs(ptvcursor_tvbuff(csr),
393                 ptvcursor_current_offset(csr));
394             break;
395         case 1:
396             val = tvb_get_guint8(ptvcursor_tvbuff(csr),
397                 ptvcursor_current_offset(csr));
398             break;
399         default:
400             DISSECTOR_ASSERT_NOT_REACHED();
401     }
402
403     ti = ptvcursor_add(csr, hf, len, TRUE);
404     if (val == invalid_val)
405         proto_item_append_text(ti, " [invalid]");
406 }
407
408 static void
409 add_ppi_field_header(tvbuff_t *tvb, proto_tree *tree, int *offset)
410 {
411     ptvcursor_t *csr = NULL;
412
413     csr = ptvcursor_new(tree, tvb, *offset);
414     ptvcursor_add(csr, hf_ppi_field_type, 2, TRUE);
415     ptvcursor_add(csr, hf_ppi_field_len, 2, TRUE);
416     ptvcursor_free(csr);
417     *offset=ptvcursor_current_offset(csr);
418 }
419
420 /* XXX - The main dissection function in the 802.11 dissector has the same name. */
421 static void
422 dissect_80211_common(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, int offset, int data_len)
423 {
424     proto_tree *ftree = NULL;
425     proto_item *ti = NULL;
426     ptvcursor_t *csr = NULL;
427     gint rate_kbps;
428     guint32 common_flags;
429     guint16 common_frequency;
430     gchar *chan_str;
431
432     if (!tree)
433         return;
434     ti = proto_tree_add_text(tree, tvb, offset, data_len, "802.11-Common");
435     ftree = proto_item_add_subtree(ti, ett_dot11_common);
436     add_ppi_field_header(tvb, ftree, &offset);
437     data_len -= 4; /* Subtract field header length */
438
439     if (data_len != PPI_80211_COMMON_LEN) {
440         proto_tree_add_text(ftree, tvb, offset, data_len, "Invalid length: %u", data_len);
441         THROW(ReportedBoundsError);
442     }
443
444     common_flags = tvb_get_letohs(tvb, offset + 8);
445     if (common_flags & DOT11_FLAG_HAVE_FCS)
446         pinfo->pseudo_header->ieee_802_11.fcs_len = 4;
447     else
448         pinfo->pseudo_header->ieee_802_11.fcs_len = 0;
449
450     csr = ptvcursor_new(ftree, tvb, offset);
451
452     ptvcursor_add_invalid_check(csr, hf_80211_common_tsft, 8, 0);
453
454     ptvcursor_add_with_subtree(csr, hf_80211_common_flags, 2, TRUE,
455         ett_dot11_common_flags);
456     ptvcursor_add_no_advance(csr, hf_80211_common_flags_fcs, 2, TRUE);
457     ptvcursor_add_no_advance(csr, hf_80211_common_flags_tsft, 2, TRUE);
458     ptvcursor_add_no_advance(csr, hf_80211_common_flags_fcs_valid, 2, TRUE);
459     ptvcursor_add(csr, hf_80211_common_flags_phy_err, 2, TRUE);
460     ptvcursor_pop_subtree(csr);
461
462     rate_kbps = tvb_get_letohs(tvb, ptvcursor_current_offset(csr)) * 500;
463     ti = proto_tree_add_uint_format(ftree, hf_80211_common_rate, tvb,
464         ptvcursor_current_offset(csr), 2, rate_kbps, "Rate: %.1f Mbps",
465         rate_kbps / 1000.0);
466     if (rate_kbps == 0)
467         proto_item_append_text(ti, " [invalid]");
468     if (check_col(pinfo->cinfo, COL_TX_RATE)) {
469         col_add_fstr(pinfo->cinfo, COL_TX_RATE, "%.1f Mbps", rate_kbps / 1000.0);
470     }
471     ptvcursor_advance(csr, 2);
472
473     common_frequency = tvb_get_letohs(ptvcursor_tvbuff(csr), ptvcursor_current_offset(csr));
474     chan_str = ieee80211_mhz_to_str(common_frequency);
475     proto_tree_add_uint_format(ptvcursor_tree(csr), hf_80211_common_chan_freq, ptvcursor_tvbuff(csr),
476         ptvcursor_current_offset(csr), 2, common_frequency, "Channel frequency: %s", chan_str);
477     if (check_col(pinfo->cinfo, COL_FREQ_CHAN)) {
478         col_add_fstr(pinfo->cinfo, COL_FREQ_CHAN, "%s", chan_str);
479     }
480     g_free(chan_str);
481     ptvcursor_advance(csr, 2);
482
483     ptvcursor_add_with_subtree(csr, hf_80211_common_chan_flags, 2, TRUE,
484         ett_dot11_common_channel_flags);
485     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_turbo, 2, TRUE);
486     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_cck, 2, TRUE);
487     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_ofdm, 2, TRUE);
488     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_2ghz, 2, TRUE);
489     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_5ghz, 2, TRUE);
490     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_passive, 2, TRUE);
491     ptvcursor_add_no_advance(csr, hf_80211_common_chan_flags_dynamic, 2, TRUE);
492     ptvcursor_add(csr, hf_80211_common_chan_flags_gfsk, 2, TRUE);
493     ptvcursor_pop_subtree(csr);
494
495
496     ptvcursor_add(csr, hf_80211_common_fhss_hopset, 1, TRUE);
497     ptvcursor_add(csr, hf_80211_common_fhss_pattern, 1, TRUE);
498
499     if (check_col(pinfo->cinfo, COL_RSSI)) {
500         col_add_fstr(pinfo->cinfo, COL_RSSI, "%d",
501             (gint8) tvb_get_guint8(tvb, ptvcursor_current_offset(csr)));
502     }
503     ptvcursor_add_invalid_check(csr, hf_80211_common_dbm_antsignal, 1, 0x80); /* -128 */
504     ptvcursor_add_invalid_check(csr, hf_80211_common_dbm_antnoise, 1, 0x80);
505
506     ptvcursor_free(csr);
507 }
508
509 static void
510 dissect_80211n_mac(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree, int offset, int data_len, gboolean add_subtree, guint32 *n_mac_flags, guint32 *ampdu_id)
511 {
512     proto_tree *ftree = tree;
513     proto_item *ti = NULL;
514     ptvcursor_t *csr = NULL;
515     int subtree_off = add_subtree ? 4 : 0;
516
517     *n_mac_flags = tvb_get_letohl(tvb, offset + subtree_off);
518     *ampdu_id = tvb_get_letohl(tvb, offset + 4 + subtree_off);
519
520     if (!tree)
521         return;
522
523     if (add_subtree) {
524         ti = proto_tree_add_text(tree, tvb, offset, data_len, "802.11n MAC");
525         ftree = proto_item_add_subtree(ti, ett_dot11n_mac);
526         add_ppi_field_header(tvb, ftree, &offset);
527         data_len -= 4; /* Subtract field header length */
528     }
529
530     if (data_len != PPI_80211N_MAC_LEN) {
531         proto_tree_add_text(ftree, tvb, offset, data_len, "Invalid length: %u", data_len);
532         THROW(ReportedBoundsError);
533     }
534
535     csr = ptvcursor_new(ftree, tvb, offset);
536
537     ptvcursor_add_with_subtree(csr, hf_80211n_mac_flags, 4, TRUE,
538         ett_dot11n_mac_flags);
539     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_greenfield, 4, TRUE);
540     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_ht20_40, 4, TRUE);
541     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_rx_guard_interval, 4, TRUE);
542     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_duplicate_rx, 4, TRUE);
543     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_aggregate, 4, TRUE);
544     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_more_aggregates, 4, TRUE);
545     ptvcursor_add_no_advance(csr, hf_80211n_mac_flags_delimiter_crc_after, 4, TRUE); /* Last */
546     ptvcursor_add(csr, hf_80211n_mac_flags_undocumented_debug_alpha, 4, TRUE);
547     ptvcursor_pop_subtree(csr);
548
549     ptvcursor_add(csr, hf_80211n_mac_ampdu_id, 4, TRUE);
550     ptvcursor_add(csr, hf_80211n_mac_num_delimiters, 1, TRUE);
551
552     if (add_subtree) {
553         ptvcursor_add(csr, hf_80211n_mac_reserved, 3, TRUE);
554     }
555
556     ptvcursor_free(csr);
557 }
558
559 static void dissect_80211n_mac_phy(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, int offset, int data_len, guint32 *n_mac_flags, guint32 *ampdu_id)
560 {
561     proto_tree *ftree = NULL;
562     proto_item *ti = NULL;
563     ptvcursor_t *csr = NULL;
564     guint16 ext_frequency;
565
566     if (!tree)
567         return;
568
569     ti = proto_tree_add_text(tree, tvb, offset, data_len, "802.11n MAC+PHY");
570     ftree = proto_item_add_subtree(ti, ett_dot11n_mac_phy);
571     add_ppi_field_header(tvb, ftree, &offset);
572     data_len -= 4; /* Subtract field header length */
573
574     if (data_len != PPI_80211N_MAC_PHY_LEN) {
575         proto_tree_add_text(ftree, tvb, offset, data_len, "Invalid length: %u", data_len);
576         THROW(ReportedBoundsError);
577     }
578
579     dissect_80211n_mac(tvb, pinfo, ftree, offset, PPI_80211N_MAC_LEN,
580         FALSE, n_mac_flags, ampdu_id);
581     offset += PPI_80211N_MAC_PHY_OFF;
582
583     csr = ptvcursor_new(ftree, tvb, offset);
584
585     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_mcs, 1, 255);
586     ti = ptvcursor_add(csr, hf_80211n_mac_phy_num_streams, 1, TRUE);
587     if (tvb_get_guint8(tvb, ptvcursor_current_offset(csr) - 1) == 0)
588         proto_item_append_text(ti, " (unknown)");
589     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_combined, 1, 255);
590     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant0_ctl, 1, 255);
591     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant1_ctl, 1, 255);
592     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant2_ctl, 1, 255);
593     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant3_ctl, 1, 255);
594     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant0_ext, 1, 255);
595     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant1_ext, 1, 255);
596     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant2_ext, 1, 255);
597     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_rssi_ant3_ext, 1, 255);
598
599     ext_frequency = tvb_get_letohs(ptvcursor_tvbuff(csr), ptvcursor_current_offset(csr));
600     proto_tree_add_uint_format(ptvcursor_tree(csr), hf_80211n_mac_phy_ext_chan_freq, ptvcursor_tvbuff(csr),
601         ptvcursor_current_offset(csr), 2, ext_frequency, "Ext. Channel frequency: %s", ieee80211_mhz_to_str(ext_frequency));
602     ptvcursor_advance(csr, 2);
603
604     ptvcursor_add_with_subtree(csr, hf_80211n_mac_phy_ext_chan_flags, 2, TRUE,
605         ett_dot11n_mac_phy_ext_channel_flags);
606     ptvcursor_add_no_advance(csr, hf_80211n_mac_phy_ext_chan_flags_turbo, 2, TRUE);
607     ptvcursor_add_no_advance(csr, hhf_80211n_mac_phy_ext_chan_flags_cck, 2, TRUE);
608     ptvcursor_add_no_advance(csr, hf_80211n_mac_phy_ext_chan_flags_ofdm, 2, TRUE);
609     ptvcursor_add_no_advance(csr, hhf_80211n_mac_phy_ext_chan_flags_2ghz, 2, TRUE);
610     ptvcursor_add_no_advance(csr, hf_80211n_mac_phy_ext_chan_flags_5ghz, 2, TRUE);
611     ptvcursor_add_no_advance(csr, hf_80211n_mac_phy_ext_chan_flags_passive, 2, TRUE);
612     ptvcursor_add_no_advance(csr, hf_80211n_mac_phy_ext_chan_flags_dynamic, 2, TRUE);
613     ptvcursor_add(csr, hf_80211n_mac_phy_ext_chan_flags_gfsk, 2, TRUE);
614     ptvcursor_pop_subtree(csr);
615
616     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant0signal, 1, 0x80); /* -128 */
617     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant0noise, 1, 0x80);
618     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant1signal, 1, 0x80);
619     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant1noise, 1, 0x80);
620     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant2signal, 1, 0x80);
621     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant2noise, 1, 0x80);
622     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant3signal, 1, 0x80);
623     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_dbm_ant3noise, 1, 0x80);
624     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_evm0, 4, 0);
625     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_evm1, 4, 0);
626     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_evm2, 4, 0);
627     ptvcursor_add_invalid_check(csr, hf_80211n_mac_phy_evm3, 4, 0);
628
629     ptvcursor_free(csr);
630 }
631
632 #define PADDING4(x) ((((x + 3) >> 2) << 2) - x)
633 #define ADD_BASIC_TAG(hf_tag) \
634     if (tree)   \
635         proto_tree_add_item(ppi_tree, hf_tag, tvb, offset, data_len, FALSE)
636
637 static void
638 dissect_ppi(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
639 {
640     proto_tree *ppi_tree = NULL, *ppi_flags_tree = NULL, *seg_tree = NULL, *ampdu_tree = NULL;
641     proto_tree *agg_tree = NULL;
642     proto_item *ti = NULL;
643     tvbuff_t *next_tvb;
644     int offset = 0;
645     guint version, flags;
646     gint tot_len, data_len;
647     guint data_type;
648     guint32 dlt;
649     guint32 n_ext_flags = 0;
650     guint32 ampdu_id = 0;
651     fragment_data *fd_head = NULL, *ft_fdh = NULL;
652     gint len_remain, pad_len = 0, ampdu_len = 0;
653     gint mpdu_count = 0;
654     gchar mpdu_str[12]; /* "MPDU #xxxxx" */
655     gboolean first_mpdu = TRUE;
656     guint last_frame = 0;
657     gboolean is_ht = FALSE;
658
659     if(check_col(pinfo->cinfo, COL_PROTOCOL))
660         col_set_str(pinfo->cinfo, COL_PROTOCOL, "PPI");
661     if(check_col(pinfo->cinfo, COL_INFO))
662         col_clear(pinfo->cinfo, COL_INFO);
663
664     version = tvb_get_guint8(tvb, offset);
665     flags = tvb_get_guint8(tvb, offset + 1);
666
667     tot_len = tvb_get_letohs(tvb, offset+2);
668     dlt = tvb_get_letohl(tvb, offset+4);
669
670     if(check_col(pinfo->cinfo, COL_INFO))
671         col_add_fstr(pinfo->cinfo, COL_INFO, "PPI version %u, %u bytes",
672                 version, tot_len);
673
674     /* Dissect the packet */
675     if (tree) {
676         ti = proto_tree_add_protocol_format(tree, proto_ppi,
677             tvb, 0, tot_len, "PPI version %u, %u bytes", version, tot_len);
678         ppi_tree = proto_item_add_subtree(ti, ett_ppi_pph);
679         proto_tree_add_item(ppi_tree, hf_ppi_head_version,
680             tvb, offset, 1, TRUE);
681
682         ti = proto_tree_add_item(ppi_tree, hf_ppi_head_flags,
683             tvb, offset + 1, 1, TRUE);
684         ppi_flags_tree = proto_item_add_subtree(ti, ett_ppi_flags);
685         proto_tree_add_item(ppi_flags_tree, hf_ppi_head_flag_alignment,
686             tvb, offset + 1, 1, TRUE);
687         proto_tree_add_item(ppi_flags_tree, hf_ppi_head_flag_reserved,
688             tvb, offset + 1, 1, TRUE);
689
690         ti = proto_tree_add_item(ppi_tree, hf_ppi_head_len,
691             tvb, offset + 2, 2, TRUE);
692         ti = proto_tree_add_item(ppi_tree, hf_ppi_head_dlt,
693             tvb, offset + 4, 4, TRUE);
694     }
695
696     tot_len -= PPI_V0_HEADER_LEN;
697     offset += 8;
698
699     while (tot_len > 0) {
700         data_type = tvb_get_letohs(tvb, offset);
701         data_len = tvb_get_letohs(tvb, offset + 2) + 4;
702         tot_len -= data_len;
703
704         switch (data_type) {
705             case PPI_80211_COMMON:
706                 dissect_80211_common(tvb, pinfo, ppi_tree, offset, data_len);
707                 break;
708
709             case PPI_80211N_MAC:
710                 dissect_80211n_mac(tvb, pinfo, ppi_tree, offset, data_len,
711                     TRUE, &n_ext_flags, &ampdu_id);
712                 is_ht = TRUE;
713                 break;
714
715             case PPI_80211N_MAC_PHY:
716                 dissect_80211n_mac_phy(tvb, pinfo, ppi_tree, offset,
717                     data_len, &n_ext_flags, &ampdu_id);
718                 is_ht = TRUE;
719                 break;
720
721             case PPI_SPECTRUM_MAP:
722                 ADD_BASIC_TAG(hf_spectrum_map);
723                 break;
724
725             case PPI_PROCESS_INFO:
726                 ADD_BASIC_TAG(hf_process_info);
727                 break;
728
729             case PPI_CAPTURE_INFO:
730                 ADD_BASIC_TAG(hf_capture_info);
731                 break;
732
733             default:
734                 if (tree)
735                     proto_tree_add_text(ppi_tree, tvb, offset, data_len,
736                         "%s (%u bytes)", val_to_str(data_type, (value_string *)&vs_ppi_field_type, "Reserved"), data_len);
737         }
738
739         offset += data_len;
740         if (IS_PPI_FLAG_ALIGN(flags)){
741             offset += PADDING4(offset);
742         }
743     }
744
745     if (ppi_ampdu_reassemble && DOT11N_IS_AGGREGATE(n_ext_flags)) {
746         len_remain = tvb_length_remaining(tvb, offset);
747         if (DOT11N_MORE_AGGREGATES(n_ext_flags)) {
748             pad_len = PADDING4(len_remain);
749         }
750         pinfo->fragmented = TRUE;
751
752         /* Make sure we aren't going to go past AGGREGATE_MAX
753          * and caclulate our full A-MPDU length */
754         fd_head = fragment_get(pinfo, ampdu_id, ampdu_fragment_table);
755         while (fd_head) {
756             ampdu_len += fd_head->len + PADDING4(fd_head->len) + 4;
757             fd_head = fd_head->next;
758         }
759         if (ampdu_len > AGGREGATE_MAX) {
760             if (tree) {
761                 proto_tree_add_text(ppi_tree, tvb, offset, -1,
762                     "[Aggregate length greater than maximum (%u)]", AGGREGATE_MAX);
763                 THROW(ReportedBoundsError);
764             } else {
765                 return;
766             }
767         }
768
769         /*
770          * Note that we never actually reassemble our A-MPDUs.  Doing
771          * so would require prepending each MPDU with an A-MPDU delimiter
772          * and appending it with padding, only to hand it off to some
773          * routine which would un-do the work we just did.  We're using
774          * the reassembly code to track MPDU sizes and frame numbers.
775          */
776         fd_head = fragment_add_seq_next(tvb, offset, pinfo, ampdu_id,
777             ampdu_fragment_table, ampdu_reassembled_table,
778             len_remain, TRUE);
779         pinfo->fragmented = TRUE;
780
781         /* Do reassembly? */
782         fd_head = fragment_get(pinfo, ampdu_id, ampdu_fragment_table);
783
784         /* Show our fragments */
785         if (fd_head && tree) {
786             ft_fdh = fd_head;
787             /* List our fragments */
788             ti = proto_tree_add_text(ppi_tree, tvb, offset, -1, "A-MPDU (%u bytes w/hdrs):", ampdu_len);
789             PROTO_ITEM_SET_GENERATED(ti);
790             seg_tree = proto_item_add_subtree(ti, ett_ampdu_segments);
791
792             while (ft_fdh) {
793                 if (ft_fdh->data && ft_fdh->len) {
794                     last_frame = ft_fdh->frame;
795                     if (!first_mpdu)
796                         proto_item_append_text(ti, ",");
797                     first_mpdu = FALSE;
798                     proto_item_append_text(ti, " #%u(%u)",
799                         ft_fdh->frame, ft_fdh->len);
800                     proto_tree_add_uint_format(seg_tree, hf_ampdu_segment,
801                         tvb, 0, 0, last_frame,
802                         "Frame: %u (%u byte%s)",
803                         last_frame,
804                         ft_fdh->len,
805                         plurality(ft_fdh->len, "", "s"));
806                 }
807                 ft_fdh = ft_fdh->next;
808             }
809             if (last_frame && last_frame != pinfo->fd->num)
810                 proto_tree_add_uint(seg_tree, hf_ampdu_reassembled_in,
811                     tvb, 0, 0, last_frame);
812         }
813
814         if (fd_head && !DOT11N_MORE_AGGREGATES(n_ext_flags)) {
815             if (tree) {
816                 ti = proto_tree_add_protocol_format(tree,
817                     proto_get_id_by_filter_name("wlan_aggregate"),
818                     tvb, 0, tot_len, "IEEE 802.11 Aggregate MPDU");
819                 agg_tree = proto_item_add_subtree(ti, ett_ampdu);
820             }
821
822             while (fd_head) {
823                 if (fd_head->data && fd_head->len) {
824                     mpdu_count++;
825                     g_snprintf(mpdu_str, 12, "MPDU #%d", mpdu_count);
826
827                     next_tvb = tvb_new_real_data(fd_head->data,
828                         fd_head->len, fd_head->len);
829                     tvb_set_child_real_data_tvbuff(tvb, next_tvb);
830                     add_new_data_source(pinfo, next_tvb, mpdu_str);
831
832                     if (agg_tree) {
833                         ti = proto_tree_add_text(agg_tree, next_tvb, 0, -1, mpdu_str);
834                         ampdu_tree = proto_item_add_subtree(ti, ett_ampdu_segment);
835                     }
836                     call_dissector(ieee80211_ht_handle, next_tvb, pinfo, ampdu_tree);
837                 }
838                 fd_head = fd_head->next;
839             }
840             proto_tree_add_uint(seg_tree, hf_ampdu_count, tvb, 0, 0, mpdu_count);
841             pinfo->fragmented=FALSE;
842         } else {
843             next_tvb = tvb_new_subset(tvb, offset, -1, -1);
844             if(check_col(pinfo->cinfo, COL_PROTOCOL))
845                 col_set_str(pinfo->cinfo, COL_PROTOCOL, "IEEE 802.11n");
846             if(check_col(pinfo->cinfo, COL_INFO))
847                 col_set_str(pinfo->cinfo, COL_INFO, "Unreassembled A-MPDU data");
848             call_dissector(data_handle, next_tvb, pinfo, tree);
849         }
850         return;
851     }
852
853     next_tvb = tvb_new_subset(tvb, offset, -1, -1);
854     if (is_ht) { /* We didn't hit the reassembly code */
855         call_dissector(ieee80211_ht_handle, next_tvb, pinfo, tree);
856     } else {
857         dissector_try_port(wtap_encap_dissector_table,
858             wtap_pcap_encap_to_wtap_encap(dlt), next_tvb, pinfo, tree);
859     }
860 }
861
862 /* Establish our beachead */
863
864 static void
865 ampdu_reassemble_init(void)
866 {
867     fragment_table_init(&ampdu_fragment_table);
868     reassembled_table_init(&ampdu_reassembled_table);
869 }
870
871 void
872 proto_register_ppi(void)
873 {
874     static hf_register_info hf[] = {
875     { &hf_ppi_head_version,
876       { "Version", "ppi.version",
877         FT_UINT8, BASE_DEC, NULL, 0x0,
878         "PPI header format version", HFILL } },
879     { &hf_ppi_head_flags,
880       { "Flags", "ppi.flags",
881         FT_UINT8, BASE_HEX, NULL, 0x0,
882         "PPI header flags", HFILL } },
883     { &hf_ppi_head_flag_alignment,
884       { "Alignment", "ppi.flags.alignment",
885         FT_BOOLEAN, 8, TFS(&tfs_ppi_head_flag_alignment), 0x01,
886         "PPI header flags - 32bit Alignment", HFILL } },
887     { &hf_ppi_head_flag_reserved,
888       { "Reserved", "ppi.flags.reserved",
889         FT_UINT8, BASE_HEX, NULL, 0xFE,
890         "PPI header flags - Reserved Flags", HFILL } },
891     { &hf_ppi_head_len,
892        { "Header length", "ppi.length",
893          FT_UINT16, BASE_DEC, NULL, 0x0,
894          "Length of header including payload", HFILL } },
895     { &hf_ppi_head_dlt,
896        { "DLT", "ppi.dlt",
897          FT_UINT32, BASE_DEC, NULL, 0x0, "libpcap Data Link Type (DLT) of the payload", HFILL } },
898
899     { &hf_ppi_field_type,
900        { "Field type", "ppi.field_type",
901          FT_UINT16, BASE_DEC, VALS(&vs_ppi_field_type), 0x0, "PPI data field type", HFILL } },
902     { &hf_ppi_field_len,
903        { "Field length", "ppi.field_len",
904          FT_UINT16, BASE_DEC, NULL, 0x0, "PPI data field length", HFILL } },
905
906     { &hf_80211_common_tsft,
907        { "TSFT", "ppi.80211-common.tsft",
908          FT_UINT64, BASE_DEC, NULL, 0x0, "PPI 802.11-Common Timing Synchronization Function Timer (TSFT)", HFILL } },
909     { &hf_80211_common_flags,
910        { "Flags", "ppi.80211-common.flags",
911          FT_UINT16, BASE_HEX, NULL, 0x0, "PPI 802.11-Common Flags", HFILL } },
912     { &hf_80211_common_flags_fcs,
913        { "FCS present flag", "ppi.80211-common.flags.fcs",
914          FT_BOOLEAN, 16, TFS(&tfs_present_absent), 0x0001, "PPI 802.11-Common Frame Check Sequence (FCS) Present Flag", HFILL } },
915     { &hf_80211_common_flags_tsft,
916        { "TSFT flag", "ppi.80211-common.flags.tsft",
917          FT_BOOLEAN, 16, TFS(&tfs_tsft_ms), 0x0002, "PPI 802.11-Common Timing Synchronization Function Timer (TSFT) msec/usec flag", HFILL } },
918     { &hf_80211_common_flags_fcs_valid,
919        { "FCS validity", "ppi.80211-common.flags.fcs-invalid",
920          FT_BOOLEAN, 16, TFS(&tfs_invalid_valid), 0x0004, "PPI 802.11-Common Frame Check Sequence (FCS) Validity flag", HFILL } },
921     { &hf_80211_common_flags_phy_err,
922        { "PHY error flag", "ppi.80211-common.flags.phy-err",
923          FT_BOOLEAN, 16, TFS(&tfs_phy_error), 0x0008, "PPI 802.11-Common Physical level (PHY) Error", HFILL } },
924     { &hf_80211_common_rate,
925        { "Data rate", "ppi.80211-common.rate",
926          FT_UINT16, BASE_DEC, NULL, 0x0, "PPI 802.11-Common Data Rate (x 500 Kbps)", HFILL } },
927     { &hf_80211_common_chan_freq,
928        { "Channel frequency", "ppi.80211-common.chan.freq",
929          FT_UINT16, BASE_DEC, NULL, 0x0,
930         "PPI 802.11-Common Channel Frequency", HFILL } },
931     { &hf_80211_common_chan_flags,
932        { "Channel type", "ppi.80211-common.chan.type",
933          FT_UINT16, BASE_HEX, VALS(&vs_80211_common_phy_type), 0x0, "PPI 802.11-Common Channel Type", HFILL } },
934
935     { &hf_80211_common_chan_flags_turbo,
936        { "Turbo", "ppi.80211-common.chan.type.turbo",
937          FT_BOOLEAN, 16, NULL, 0x0010, "PPI 802.11-Common Channel Type Turbo", HFILL } },
938     { &hf_80211_common_chan_flags_cck,
939        { "Complementary Code Keying (CCK)", "ppi.80211-common.chan.type.cck",
940          FT_BOOLEAN, 16, NULL, 0x0020, "PPI 802.11-Common Channel Type Complementary Code Keying (CCK) Modulation", HFILL } },
941     { &hf_80211_common_chan_flags_ofdm,
942        { "Orthogonal Frequency-Division Multiplexing (OFDM)", "ppi.80211-common.chan.type.ofdm",
943          FT_BOOLEAN, 16, NULL, 0x0040, "PPI 802.11-Common Channel Type Orthogonal Frequency-Division Multiplexing (OFDM)", HFILL } },
944     { &hf_80211_common_chan_flags_2ghz,
945        { "2 GHz spectrum", "ppi.80211-common.chan.type.2ghz",
946          FT_BOOLEAN, 16, NULL, 0x0080, "PPI 802.11-Common Channel Type 2 GHz spectrum", HFILL } },
947     { &hf_80211_common_chan_flags_5ghz,
948        { "5 GHz spectrum", "ppi.80211-common.chan.type.5ghz",
949          FT_BOOLEAN, 16, NULL, 0x0100, "PPI 802.11-Common Channel Type 5 GHz spectrum", HFILL } },
950     { &hf_80211_common_chan_flags_passive,
951        { "Passive", "ppi.80211-common.chan.type.passive",
952          FT_BOOLEAN, 16, NULL, 0x0200, "PPI 802.11-Common Channel Type Passive", HFILL } },
953     { &hf_80211_common_chan_flags_dynamic,
954        { "Dynamic CCK-OFDM", "ppi.80211-common.chan.type.dynamic",
955          FT_BOOLEAN, 16, NULL, 0x0400, "PPI 802.11-Common Channel Type Dynamic CCK-OFDM Channel", HFILL } },
956     { &hf_80211_common_chan_flags_gfsk,
957        { "Gaussian Frequency Shift Keying (GFSK)", "ppi.80211-common.chan.type.gfsk",
958          FT_BOOLEAN, 16, NULL, 0x0800, "PPI 802.11-Common Channel Type Gaussian Frequency Shift Keying (GFSK) Modulation", HFILL } },
959
960     { &hf_80211_common_fhss_hopset,
961        { "FHSS hopset", "ppi.80211-common.fhss.hopset",
962          FT_UINT8, BASE_HEX, NULL, 0x0, "PPI 802.11-Common Frequency-Hopping Spread Spectrum (FHSS) Hopset", HFILL } },
963     { &hf_80211_common_fhss_pattern,
964        { "FHSS pattern", "ppi.80211-common.fhss.pattern",
965          FT_UINT8, BASE_HEX, NULL, 0x0, "PPI 802.11-Common Frequency-Hopping Spread Spectrum (FHSS) Pattern", HFILL } },
966     { &hf_80211_common_dbm_antsignal,
967        { "dBm antenna signal", "ppi.80211-common.dbm.antsignal",
968          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11-Common dBm Antenna Signal", HFILL } },
969     { &hf_80211_common_dbm_antnoise,
970        { "dBm antenna noise", "ppi.80211-common.dbm.antnoise",
971          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11-Common dBm Antenna Noise", HFILL } },
972
973     /* 802.11n MAC */
974     { &hf_80211n_mac_flags,
975        { "MAC flags", "ppi.80211n-mac.flags",
976          FT_UINT32, BASE_HEX, NULL, 0x0, "PPI 802.11n MAC flags", HFILL } },
977     { &hf_80211n_mac_flags_greenfield,
978        { "Greenfield flag", "ppi.80211n-mac.flags.greenfield",
979          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0001, "PPI 802.11n MAC Greenfield Flag", HFILL } },
980     { &hf_80211n_mac_flags_ht20_40,
981        { "HT20/HT40 flag", "ppi.80211n-mac.flags.ht20_40",
982          FT_BOOLEAN, 32, TFS(&tfs_ht20_40), 0x0002, "PPI 802.11n MAC HT20/HT40 Flag", HFILL } },
983     { &hf_80211n_mac_flags_rx_guard_interval,
984        { "RX Short Guard Interval (SGI) flag", "ppi.80211n-mac.flags.rx.short_guard_interval",
985          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0004, "PPI 802.11n MAC RX Short Guard Interval (SGI) Flag", HFILL } },
986     { &hf_80211n_mac_flags_duplicate_rx,
987        { "Duplicate RX flag", "ppi.80211n-mac.flags.rx.duplicate",
988          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0008, "PPI 802.11n MAC Duplicate RX Flag", HFILL } },
989     { &hf_80211n_mac_flags_aggregate,
990        { "Aggregate flag", "ppi.80211n-mac.flags.agg",
991          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0010, "PPI 802.11 MAC Aggregate Flag", HFILL } },
992     { &hf_80211n_mac_flags_more_aggregates,
993        { "More aggregates flag", "ppi.80211n-mac.flags.more_agg",
994          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0020, "PPI 802.11n MAC More Aggregates Flag", HFILL } },
995     { &hf_80211n_mac_flags_delimiter_crc_after,
996        { "A-MPDU Delimiter CRC error after this frame flag", "ppi.80211n-mac.flags.delim_crc_error_after",
997          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x0040, "PPI 802.11n MAC A-MPDU Delimiter CRC Error After This Frame Flag", HFILL } },
998     /* XXX - This should NOT be in the mainline trunk. */
999     { &hf_80211n_mac_flags_undocumented_debug_alpha,
1000        { "Debug Flag (more desc)", "ppi.80211n-mac.flags.more_desc",
1001          FT_BOOLEAN, 32, TFS(&tfs_true_false), 0x80000000, "PPI 802.11n MAC Debug Flag (more desc)", HFILL } },
1002     { &hf_80211n_mac_ampdu_id,
1003        { "AMPDU-ID", "ppi.80211n-mac.ampdu_id",
1004          FT_UINT32, BASE_HEX, NULL, 0x0, "PPI 802.11n MAC AMPDU-ID", HFILL } },
1005     { &hf_80211n_mac_num_delimiters,
1006        { "Num-Delimiters", "ppi.80211n-mac.num_delimiters",
1007          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC number of zero-length pad delimiters", HFILL } },
1008     { &hf_80211n_mac_reserved,
1009        { "Reserved", "ppi.80211n-mac.reserved",
1010          FT_UINT24, BASE_HEX, NULL, 0x0, "PPI 802.11n MAC Reserved", HFILL } },
1011
1012
1013     /* 802.11n MAC+PHY */
1014     { &hf_80211n_mac_phy_mcs,
1015        { "MCS", "ppi.80211n-mac-phy.mcs",
1016          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Modulation Coding Scheme (MCS)", HFILL } },
1017     { &hf_80211n_mac_phy_num_streams,
1018        { "Number of spatial streams", "ppi.80211n-mac-phy.num_streams",
1019          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY number of spatial streams", HFILL } },
1020     { &hf_80211n_mac_phy_rssi_combined,
1021        { "RSSI combined", "ppi.80211n-mac-phy.rssi.combined",
1022          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Received Signal Strength Indication (RSSI) Combined", HFILL } },
1023     { &hf_80211n_mac_phy_rssi_ant0_ctl,
1024        { "Antenna 0 control RSSI", "ppi.80211n-mac-phy.rssi.ant0ctl",
1025          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 0 Control Channel Received Signal Strength Indication (RSSI)", HFILL } },
1026     { &hf_80211n_mac_phy_rssi_ant1_ctl,
1027        { "Antenna 1 control RSSI", "ppi.80211n-mac-phy.rssi.ant1ctl",
1028          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 1 Control Channel Received Signal Strength Indication (RSSI)", HFILL } },
1029     { &hf_80211n_mac_phy_rssi_ant2_ctl,
1030        { "Antenna 2 control RSSI", "ppi.80211n-mac-phy.rssi.ant2ctl",
1031          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 2 Control Channel Received Signal Strength Indication (RSSI)", HFILL } },
1032     { &hf_80211n_mac_phy_rssi_ant3_ctl,
1033        { "Antenna 3 control RSSI", "ppi.80211n-mac-phy.rssi.ant3ctl",
1034          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 3 Control Channel Received Signal Strength Indication (RSSI)", HFILL } },
1035     { &hf_80211n_mac_phy_rssi_ant0_ext,
1036        { "Antenna 0 extension RSSI", "ppi.80211n-mac-phy.rssi.ant0ext",
1037          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 0 Extension Channel Received Signal Strength Indication (RSSI)", HFILL } },
1038     { &hf_80211n_mac_phy_rssi_ant1_ext,
1039        { "Antenna 1 extension RSSI", "ppi.80211n-mac-phy.rssi.ant1ext",
1040          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 1 Extension Channel Received Signal Strength Indication (RSSI)", HFILL } },
1041     { &hf_80211n_mac_phy_rssi_ant2_ext,
1042        { "Antenna 2 extension RSSI", "ppi.80211n-mac-phy.rssi.ant2ext",
1043          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 2 Extension Channel Received Signal Strength Indication (RSSI)", HFILL } },
1044     { &hf_80211n_mac_phy_rssi_ant3_ext,
1045        { "Antenna 3 extension RSSI", "ppi.80211n-mac-phy.rssi.ant3ext",
1046          FT_UINT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Antenna 3 Extension Channel Received Signal Strength Indication (RSSI)", HFILL } },
1047     { &hf_80211n_mac_phy_ext_chan_freq,
1048        { "Extended channel frequency", "ppi.80211-mac-phy.ext-chan.freq",
1049          FT_UINT16, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Extended Channel Frequency", HFILL } },
1050     { &hf_80211n_mac_phy_ext_chan_flags,
1051        { "Channel type", "ppi.80211-mac-phy.ext-chan.type",
1052          FT_UINT16, BASE_HEX, VALS(&vs_80211_common_phy_type), 0x0, "PPI 802.11n MAC+PHY Channel Type", HFILL } },
1053     { &hf_80211n_mac_phy_ext_chan_flags_turbo,
1054        { "Turbo", "ppi.80211-mac-phy.ext-chan.type.turbo",
1055          FT_BOOLEAN, 16, NULL, 0x0010, "PPI 802.11n MAC+PHY Channel Type Turbo", HFILL } },
1056     { &hhf_80211n_mac_phy_ext_chan_flags_cck,
1057        { "Complementary Code Keying (CCK)", "ppi.80211-mac-phy.ext-chan.type.cck",
1058          FT_BOOLEAN, 16, NULL, 0x0020, "PPI 802.11n MAC+PHY Channel Type Complementary Code Keying (CCK) Modulation", HFILL } },
1059     { &hf_80211n_mac_phy_ext_chan_flags_ofdm,
1060        { "Orthogonal Frequency-Division Multiplexing (OFDM)", "ppi.80211-mac-phy.ext-chan.type.ofdm",
1061          FT_BOOLEAN, 16, NULL, 0x0040, "PPI 802.11n MAC+PHY Channel Type Orthogonal Frequency-Division Multiplexing (OFDM)", HFILL } },
1062     { &hhf_80211n_mac_phy_ext_chan_flags_2ghz,
1063        { "2 GHz spectrum", "ppi.80211-mac-phy.ext-chan.type.2ghz",
1064          FT_BOOLEAN, 16, NULL, 0x0080, "PPI 802.11n MAC+PHY Channel Type 2 GHz spectrum", HFILL } },
1065     { &hf_80211n_mac_phy_ext_chan_flags_5ghz,
1066        { "5 GHz spectrum", "ppi.80211-mac-phy.ext-chan.type.5ghz",
1067          FT_BOOLEAN, 16, NULL, 0x0100, "PPI 802.11n MAC+PHY Channel Type 5 GHz spectrum", HFILL } },
1068     { &hf_80211n_mac_phy_ext_chan_flags_passive,
1069        { "Passive", "ppi.80211-mac-phy.ext-chan.type.passive",
1070          FT_BOOLEAN, 16, NULL, 0x0200, "PPI 802.11n MAC+PHY Channel Type Passive", HFILL } },
1071     { &hf_80211n_mac_phy_ext_chan_flags_dynamic,
1072        { "Dynamic CCK-OFDM", "ppi.80211-mac-phy.ext-chan.type.dynamic",
1073          FT_BOOLEAN, 16, NULL, 0x0400, "PPI 802.11n MAC+PHY Channel Type Dynamic CCK-OFDM Channel", HFILL } },
1074     { &hf_80211n_mac_phy_ext_chan_flags_gfsk,
1075        { "Gaussian Frequency Shift Keying (GFSK)", "ppi.80211-mac-phy.ext-chan.type.gfsk",
1076          FT_BOOLEAN, 16, NULL, 0x0800, "PPI 802.11n MAC+PHY Channel Type Gaussian Frequency Shift Keying (GFSK) Modulation", HFILL } },
1077     { &hf_80211n_mac_phy_dbm_ant0signal,
1078        { "dBm antenna 0 signal", "ppi.80211n-mac-phy.dbmant0.signal",
1079          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 0 Signal", HFILL } },
1080     { &hf_80211n_mac_phy_dbm_ant0noise,
1081        { "dBm antenna 0 noise", "ppi.80211n-mac-phy.dbmant0.noise",
1082          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 0 Noise", HFILL } },
1083     { &hf_80211n_mac_phy_dbm_ant1signal,
1084        { "dBm antenna 1 signal", "ppi.80211n-mac-phy.dbmant1.signal",
1085          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 1 Signal", HFILL } },
1086     { &hf_80211n_mac_phy_dbm_ant1noise,
1087        { "dBm antenna 1 noise", "ppi.80211n-mac-phy.dbmant1.noise",
1088          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 1 Noise", HFILL } },
1089     { &hf_80211n_mac_phy_dbm_ant2signal,
1090        { "dBm antenna 2 signal", "ppi.80211n-mac-phy.dbmant2.signal",
1091          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 2 Signal", HFILL } },
1092     { &hf_80211n_mac_phy_dbm_ant2noise,
1093        { "dBm antenna 2 noise", "ppi.80211n-mac-phy.dbmant2.noise",
1094          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 2 Noise", HFILL } },
1095     { &hf_80211n_mac_phy_dbm_ant3signal,
1096        { "dBm antenna 3 signal", "ppi.80211n-mac-phy.dbmant3.signal",
1097          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 3 Signal", HFILL } },
1098     { &hf_80211n_mac_phy_dbm_ant3noise,
1099        { "dBm antenna 3 noise", "ppi.80211n-mac-phy.dbmant3.noise",
1100          FT_INT8, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY dBm Antenna 3 Noise", HFILL } },
1101     { &hf_80211n_mac_phy_evm0,
1102        { "EVM-0", "ppi.80211n-mac-phy.emv0",
1103          FT_UINT32, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Error Vector Magnitude (EVM) for chain 0", HFILL } },
1104     { &hf_80211n_mac_phy_evm1,
1105        { "EVM-1", "ppi.80211n-mac-phy.emv1",
1106          FT_UINT32, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Error Vector Magnitude (EVM) for chain 1", HFILL } },
1107     { &hf_80211n_mac_phy_evm2,
1108        { "EVM-2", "ppi.80211n-mac-phy.emv2",
1109          FT_UINT32, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Error Vector Magnitude (EVM) for chain 2", HFILL } },
1110     { &hf_80211n_mac_phy_evm3,
1111        { "EVM-3", "ppi.80211n-mac-phy.emv3",
1112          FT_UINT32, BASE_DEC, NULL, 0x0, "PPI 802.11n MAC+PHY Error Vector Magnitude (EVM) for chain 3", HFILL } },
1113
1114     { &hf_ampdu_segment,
1115         { "A-MPDU", "ppi.80211n-mac.ampdu",
1116             FT_FRAMENUM, BASE_NONE, NULL, 0x0, "802.11n Aggregated MAC Protocol Data Unit (A-MPDU)", HFILL }},
1117     { &hf_ampdu_segments,
1118         { "Reassembled A-MPDU", "ppi.80211n-mac.ampdu.reassembled",
1119             FT_NONE, BASE_NONE, NULL, 0x0, "Reassembled Aggregated MAC Protocol Data Unit (A-MPDU)", HFILL }},
1120     { &hf_ampdu_reassembled_in,
1121         { "Reassembled A-MPDU in frame", "ppi.80211n-mac.ampdu.reassembled_in",
1122             FT_FRAMENUM, BASE_NONE, NULL, 0x0,
1123             "The A-MPDU that doesn't end in this segment is reassembled in this frame",
1124             HFILL }},
1125     { &hf_ampdu_count,
1126         { "MPDU count", "ppi.80211n-mac.ampdu.count",
1127             FT_UINT16, BASE_DEC, NULL, 0x0, "The number of aggregated MAC Protocol Data Units (MPDUs)", HFILL }},
1128
1129     { &hf_spectrum_map,
1130        { "Radio spectrum map", "ppi.spectrum-map",
1131          FT_BYTES, 0, NULL, 0x0, "PPI Radio spectrum map", HFILL } },
1132     { &hf_process_info,
1133        { "Process information", "ppi.proc-info",
1134          FT_BYTES, 0, NULL, 0x0, "PPI Process information", HFILL } },
1135     { &hf_capture_info,
1136        { "Capture information", "ppi.cap-info",
1137          FT_BYTES, 0, NULL, 0x0, "PPI Capture information", HFILL } },
1138     };
1139
1140     static gint *ett[] = {
1141         &ett_ppi_pph,
1142         &ett_ppi_flags,
1143         &ett_dot11_common,
1144         &ett_dot11_common_flags,
1145         &ett_dot11_common_channel_flags,
1146         &ett_dot11n_mac,
1147         &ett_dot11n_mac_flags,
1148         &ett_dot11n_mac_phy,
1149         &ett_dot11n_mac_phy_ext_channel_flags,
1150         &ett_ampdu_segments,
1151         &ett_ampdu,
1152         &ett_ampdu_segment
1153     };
1154
1155     module_t *ppi_module;
1156
1157     proto_ppi = proto_register_protocol("PPI Packet Header", "PPI", "ppi");
1158     proto_register_field_array(proto_ppi, hf, array_length(hf));
1159     proto_register_subtree_array(ett, array_length(ett));
1160     register_dissector("ppi", dissect_ppi, proto_ppi);
1161
1162     register_init_routine(ampdu_reassemble_init);
1163
1164     /* Configuration options */
1165     ppi_module = prefs_register_protocol(proto_ppi, NULL);
1166     prefs_register_bool_preference(ppi_module, "reassemble",
1167         "Reassemble fragmented 802.11 A-MPDUs",
1168         "Whether fragmented 802.11 aggregated MPDUs should be reassembled",
1169         &ppi_ampdu_reassemble);
1170 }
1171
1172 void
1173 proto_reg_handoff_ppi(void)
1174 {
1175     dissector_handle_t ppi_handle;
1176
1177     ppi_handle = create_dissector_handle(dissect_ppi, proto_ppi);
1178     data_handle = find_dissector("data");
1179     ieee80211_ht_handle = find_dissector("wlan_ht");
1180
1181     dissector_add("wtap_encap", WTAP_ENCAP_PPI, ppi_handle);
1182 }
1183
1184 /*
1185  * Editor modelines
1186  *
1187  * Local Variables:
1188  * c-basic-offset: 4
1189  * tab-width: 8
1190  * indent-tabs-mode: nil
1191  * End:
1192  *
1193  * ex: set shiftwidth=4 tabstop=8 expandtab
1194  * :indentSize=4:tabSize=8:noTabs=true:
1195  */