Project

General

Profile

gsmtap.h

current version of the GSMTAP header file - laforge, 08/04/2010 05:51 PM

 
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 */
Add picture from clipboard (Maximum size: 48.8 MB)