Add a timeline view for packets, with the timing data used to generate the display

taken from the timing analysis done in the wlan_radio dissector. QT only.

The timeline background is light gray, white for packets displayed in the packetlist,
and blue for the currently selected packet. Packets are coloured according to the
colouring rules foreground colour. The timeline can be zoomed with controls on the
toolbar.

At higher zoom levels the duration (NAV) field is plotted as a horizontal line to the
right of a packet.

The height of a packet in the timeline is proportional to the RSSI.

The bottom half of the packet is only shown if it matches the display filter.

Todo:
Auto detect TSF timing reference point (start/end of packet)
Add a scrollbar
Add a ruler showing time
Improve handling of focus.
Do not display NAV for packets with bad FCS.
Show related packets graphically
Different Y axis modes
- bandwidth/channel use display
- different transmitters per line
- background color from coloring rules
Live capture support

Change-Id: Ic31fffb0d6854966361ade7abb5c0be50db9a247
Reviewed-on: https://code.wireshark.org/review/20043
Petri-Dish: Michael Mann <mmann78@netscape.net>
Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org>
Reviewed-by: Michael Mann <mmann78@netscape.net>

1 files changed, 57 insertions, 0 deletions

diff --git a/epan/dissectors/packet-ieee80211-radio.h b/epan/dissectors/packet-ieee80211-radio.h
new file mode 100644
index 0000000000..83c0e23147
--- /dev/null
+++ b/epan/dissectors/packet-ieee80211-radio.h
@@ -0,0 +1,57 @@
+/* packet-ieee80211-radio.h
+ * Routines for pseudo 802.11 header dissection and radio packet timing calculation
+ *
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
+ * Copyright 1998 Gerald Combs
+ *
+ * Copyright 2012 Parc Inc and Samsung Electronics
+ * Copyright 2015, 2016 & 2017 Cisco Inc
+ *
+ * This program 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 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#ifndef __WLAN_RADIO_H__
+#define __WLAN_RADIO_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+struct aggregate {
+  guint phy;
+  union ieee_802_11_phy_info phy_info;
+  gint8 rssi; /* sometimes only available on the last frame */
+  guint duration; /* total duration of data in microseconds (without preamble) */
+};
+
+struct wlan_radio {
+  struct aggregate *aggregate; /* if this frame is part of an aggregate, point to it, otherwise NULL */
+  guint prior_aggregate_data; /* length of all prior data in this aggregate
+                                 used for calculating duration of this subframe */
+  guint64 start_tsf;
+  guint64 end_tsf;
+
+  gint64 ifs; /* inter frame space in microseconds */
+
+  guint16 nav;
+  gint8 rssi;
+};
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* __WLAN_RADIO_H__ */