This wiki has been migrated to https://gitlab.com/wireshark/wireshark/-/wikis/home and is now deprecated. Please use that site instead.
Differences between revisions 19 and 21 (spanning 2 versions)
Revision 19 as of 2012-04-06 19:13:48
Size: 4543
Comment:
Revision 21 as of 2015-11-26 14:50:17
Size: 4791
Comment:
Deletions are marked like this. Additions are marked like this.
Line 38: Line 38:
 * Try Heuristic LTE-MAC framing over UDP. Default is FALSE.  * Try Heuristic LTE-MAC framing over UDP. Default is FALSE. Starting from Wireshark 2.0, heuristic activation is moved to Enabled Protocols window.
Line 68: Line 68:
 * [[http://www.wireshark.org/~martinm/mac_pcap_sample_code.c|Example program]] that writes to a PCAP file in a format that may be read by the mac-lte-framed dissector.
Line 71: Line 72:
It is recommended that you use current sources or a recent automated build for this dissector - the 1.4 branch is not up-to-date. It is recommended that you use current sources or a recent automated build for this dissector and other LTE dissectors.

Medium Access Control (MAC) for LTE

This protocol is layer 2 of the LTE air interface (connecting an LTE UE with an eNodeB).

Protocol dependencies

  • MAC-LTE runs over the PHY layer
  • A UDP framing format for MAC-LTE has been defined (described in packet-mac-lte.h, purely for use with Wireshark)

  • Can call RLC dissector for its SDUs (see Preference Settings below)
  • BCH, PCH and CCCH payloads can be decoded by the LTE RRC dissector
  • RAR UL Grant field can be broken down according to 3GPP TS 36.213

Example traffic

mac-lte1.png

Wireshark

The MAC-LTE dissector is fully functional. There is support for reading MAC-LTE frames from:

  • DCT2000 log files OR

  • using the UDP format defined in packet-mac-lte.h. This (BSD-licensed) program gives an example of how you might send MAC-LTE frames in this format OR

  • the compact format decoded by the mac-lte-framed dissector. This shares the same framing format as the UDP format described above. This (BSD-licensed) program gives an example of how you might write MAC-LTE frames directly in a file of this format. Currently, this does not have its own registered DLT, so if (as the same program does) you use DLT 147 you will need to edit the preferences of the DLT_USER dissector (add an entry with DLT=147, Payload Protocol=mac-lte-framed) OR

  • your own framing protocol. The functions get_mac_lte_proto_data() and set_mac_lte_proto_data() are available for querying and setting the necessary context information associated with a frame.

MAC-LTE statistics can be viewed in a window (see Telephony | LTE | MAC ...).

The same statistics can be viewed in tshark using the -zmac-lte,stats option.

mac-lte-stats.png

Preference Settings

  • Number of Re-Transmits before expert warning triggered. Default is 3.
  • Attempt to decode BCH, PCH and CCCH data using LTE RRC dissector. Default is TRUE.
  • Dissect frames that have failed CRC check. Default is FALSE.
  • Try Heuristic LTE-MAC framing over UDP. Default is FALSE. Starting from Wireshark 2.0, heuristic activation is moved to Enabled Protocols window.
  • Attempt to dissect LCID 1&2 as srb 1&2. Default is FALSE.

  • LCID -> DRB Mappings Table. Can configure data channel ID and RLC mode so that RLC-LTE dissector can be called for these SDUs.

  • Attempt to track UL HARQ resends. When frame marked as reTx, looks for link back to original tx. Default is TRUE.
  • BSR size when warning should be issued. Default is 50 (19325 < BS <= 22624)

  • Track status of SRs within UEs. Looks for and shows links between SR request and resulting grant or failure indication. Default is TRUE.
  • Which layer info to show in Info column. Choices are PHY, MAC or RLC info. Default is MAC-info.

Example capture file

XXX - Add a simple example capture file to the SampleCaptures page and link from here (see below). Keep this file short, it's also a good idea to gzip it to make it even smaller, as Wireshark can open gzipped files automatically.

Display Filter

A complete list of MAC-LTE display filter fields can be found in the display filter reference

  • Show only the MAC-LTE based traffic:

     mac-lte 

Capture Filter

You cannot directly filter MAC-LTE protocol frames while capturing. But, if you are using the supported UDP framing format, you may be able to filter on the UDP port you know that you are using, e.g.

  udp port 9999 

  • 3GPP TS 36.321 Evolved Universal Terrestrial Radio Access (E-UTRA); Medium Access Control (MAC) protocol specification

  • 3GPP TS 36.213 Evolved Universal Terrestrial Radio Access (E-UTRA); Physical layer procedures

  • Example program that generates and sends frames using the supported UDP framing format

  • Example program that writes to a PCAP file in a format that may be read by the mac-lte-framed dissector.

Discussion

It is recommended that you use current sources or a recent automated build for this dissector and other LTE dissectors.

MAC-LTE (last edited 2015-11-26 14:50:17 by PascalQuantin)