Harald Welte | c436245 | 2010-03-22 22:25:13 +0800 | [diff] [blame] | 1 | #ifndef _GSMTAP_H |
| 2 | #define _GSMTAP_H |
| 3 | |
| 4 | /* gsmtap header, pseudo-header in front of the actua GSM payload */ |
| 5 | |
| 6 | /* GSMTAP is a generic header format for GSM protocol captures, |
| 7 | * it uses the IANA-assigned UDP port number 4729 and carries |
| 8 | * payload in various formats of GSM interfaces such as Um MAC |
| 9 | * blocks or Um bursts. |
| 10 | * |
| 11 | * Example programs generating GSMTAP data are airprobe |
| 12 | * (http://airprobe.org/) or OsmocomBB (http://bb.osmocom.org/) |
| 13 | */ |
| 14 | |
| 15 | #include <stdint.h> |
| 16 | |
| 17 | #define GSMTAP_VERSION 0x02 |
| 18 | |
| 19 | #define GSMTAP_TYPE_UM 0x01 |
| 20 | #define GSMTAP_TYPE_ABIS 0x02 |
| 21 | #define GSMTAP_TYPE_UM_BURST 0x03 /* raw burst bits */ |
| 22 | |
| 23 | #define GSMTAP_BURST_UNKNOWN 0x00 |
| 24 | #define GSMTAP_BURST_FCCH 0x01 |
| 25 | #define GSMTAP_BURST_PARTIAL_SCH 0x02 |
| 26 | #define GSMTAP_BURST_SCH 0x03 |
| 27 | #define GSMTAP_BURST_CTS_SCH 0x04 |
| 28 | #define GSMTAP_BURST_COMPACT_SCH 0x05 |
| 29 | #define GSMTAP_BURST_NORMAL 0x06 |
| 30 | #define GSMTAP_BURST_DUMMY 0x07 |
| 31 | #define GSMTAP_BURST_ACCESS 0x08 |
| 32 | #define GSMTAP_BURST_NONE 0x09 |
| 33 | |
| 34 | #define GSMTAP_CHANNEL_UNKNOWN 0x00 |
| 35 | #define GSMTAP_CHANNEL_BCCH 0x01 |
| 36 | #define GSMTAP_CHANNEL_CCCH 0x02 |
| 37 | #define GSMTAP_CHANNEL_RACH 0x03 |
| 38 | #define GSMTAP_CHANNEL_AGCH 0x04 |
| 39 | #define GSMTAP_CHANNEL_PCH 0x05 |
| 40 | #define GSMTAP_CHANNEL_SDCCH 0x06 |
| 41 | #define GSMTAP_CHANNEL_SDCCH4 0x07 |
| 42 | #define GSMTAP_CHANNEL_SDCCH8 0x08 |
| 43 | #define GSMTAP_CHANNEL_TCH_F 0x09 |
| 44 | #define GSMTAP_CHANNEL_TCH_H 0x0a |
| 45 | #define GSMTAP_CHANNEL_ACCH 0x80 |
| 46 | |
| 47 | #define GSMTAP_ARFCN_F_PCS 0x8000 |
| 48 | #define GSMTAP_ARFCN_F_UPLINK 0x4000 |
| 49 | #define GSMTAP_ARFCN_MASK 0x3fff |
| 50 | |
| 51 | #define GSMTAP_UDP_PORT 4729 |
| 52 | |
| 53 | struct gsmtap_hdr { |
| 54 | uint8_t version; /* version, set to 0x01 currently */ |
| 55 | uint8_t hdr_len; /* length in number of 32bit words */ |
| 56 | uint8_t type; /* see GSMTAP_TYPE_* */ |
| 57 | uint8_t timeslot; /* timeslot (0..7 on Um) */ |
| 58 | |
| 59 | uint16_t arfcn; /* ARFCN (frequency) */ |
| 60 | int8_t signal_dbm; /* signal level in dBm */ |
| 61 | int8_t snr_db; /* signal/noise ratio in dB */ |
| 62 | |
| 63 | uint32_t frame_number; /* GSM Frame Number (FN) */ |
| 64 | |
| 65 | uint8_t sub_type; /* Type of burst/channel, see above */ |
| 66 | uint8_t antenna_nr; /* Antenna Number */ |
| 67 | uint8_t sub_slot; /* sub-slot within timeslot */ |
| 68 | uint8_t res; /* reserved for future use (RFU) */ |
| 69 | |
| 70 | } __attribute__((packed)); |
| 71 | |
| 72 | #endif /* _GSMTAP_H */ |