blob: e44b061e21d735afa8eeb229c30aaf8ad3eef2c6 [file] [log] [blame]
Harald Welte52b1f982008-12-23 20:25:15 +00001#ifndef _GSM_04_08_H
2#define _GSM_04_08_H
3
4/* GSM TS 04.08 definitions */
5
6/* Chapter 10.5.2.5 */
7struct gsm48_chan_desc {
8 u_int8_t chan_nr;
9 union {
10 struct {
11 u_int8_t maio_high:4,
12 h:1,
13 tsc:3;
14 u_int8_t hsn:6,
15 maio_low:2;
16 } h1;
17 struct {
18 u_int8_t arfcn_high:2,
19 spare:2,
20 h:1,
21 tsc:3;
22 u_int8_t arfcn_low;
23 } h0;
24 };
Harald Welteb84e2f42008-12-28 23:42:04 +000025} __attribute__ ((packed));
Harald Welte52b1f982008-12-23 20:25:15 +000026
27/* Chapter 10.5.2.30 */
28struct gsm48_req_ref {
29 u_int8_t ra;
30 u_int8_t t3_high:3,
31 t1_:5;
32 u_int8_t t2:5,
33 t3_low:3;
Harald Welteb84e2f42008-12-28 23:42:04 +000034} __attribute__ ((packed));
Harald Welte52b1f982008-12-23 20:25:15 +000035
36/* Chapter 9.1.18 */
37struct gsm48_imm_ass {
38 u_int8_t l2_plen;
39 u_int8_t proto_discr;
40 u_int8_t msg_type;
41 u_int8_t page_mode;
42 struct gsm48_chan_desc chan_desc;
43 struct gsm48_req_ref req_ref;
44 u_int8_t timing_advance;
45 u_int8_t mob_alloc_len;
46 u_int8_t mob_alloc[0];
Harald Welteb84e2f42008-12-28 23:42:04 +000047} __attribute__ ((packed));
Harald Welte52b1f982008-12-23 20:25:15 +000048
Harald Welte4b634542008-12-27 01:55:51 +000049/* Chapter 10.5.1.3 */
Harald Welte52b1f982008-12-23 20:25:15 +000050struct gsm48_loc_area_id {
51 u_int8_t digits[3]; /* BCD! */
52 u_int16_t lac;
53} __attribute__ ((packed));
54
55/* Section 9.2.15 */
56struct gsm48_loc_upd_req {
57 u_int8_t type:4,
58 key_seq:4;
59 struct gsm48_loc_area_id lai;
60 u_int8_t classmark1;
Harald Welte52b1f982008-12-23 20:25:15 +000061 u_int8_t mi_len;
62 u_int8_t mi[0];
63} __attribute__ ((packed));
64
65/* Section 10.1 */
66struct gsm48_hdr {
67 u_int8_t proto_discr;
68 u_int8_t msg_type;
69 u_int8_t data[0];
70} __attribute__ ((packed));
71
Holger Freyther5e85c8e2008-12-28 16:32:39 +000072/* Section 9.1.3x System information Type header */
73struct gsm48_system_information_type_header {
74 u_int8_t l2_plen;
75 u_int8_t rr_protocol_discriminator :4,
76 skip_indicator:4;
77 u_int8_t system_information;
78} __attribute__ ((packed));
79
Harald Weltede9226d2008-12-29 02:37:23 +000080struct gsm48_rach_control {
81 u_int8_t re :1,
82 cell_bar :1,
83 tx_integer :4,
84 max_trans :2;
85 u_int8_t t2;
86 u_int8_t t3;
87} __attribute__ ((packed));
88
Harald Welteba4cf162009-01-10 01:49:35 +000089/* Section 9.2.9 CM service request */
90struct gsm48_service_request {
91 u_int8_t cm_service_type : 4,
92 cipher_key_seq : 4;
93 /* length + 3 bytes */
94 u_int32_t classmark;
95 u_int8_t mi_len;
96 u_int8_t mi[0];
97 /* optional priority level */
98} __attribute__ ((packed));
99
Holger Freyther5e85c8e2008-12-28 16:32:39 +0000100/* Section 9.1.31 System information Type 1 */
101struct gsm48_system_information_type_1 {
102 struct gsm48_system_information_type_header header;
103 u_int8_t cell_channel_description[16];
Harald Weltede9226d2008-12-29 02:37:23 +0000104 struct gsm48_rach_control rach_control;
Holger Freyther5e85c8e2008-12-28 16:32:39 +0000105 u_int8_t s1_reset;
106} __attribute__ ((packed));
107
108/* Section 9.1.32 System information Type 2 */
109struct gsm48_system_information_type_2 {
110 struct gsm48_system_information_type_header header;
111 u_int8_t bcch_frequency_list[16];
112 u_int8_t ncc_permitted;
Harald Weltede9226d2008-12-29 02:37:23 +0000113 struct gsm48_rach_control rach_control;
Holger Freyther5e85c8e2008-12-28 16:32:39 +0000114} __attribute__ ((packed));
115
116/* Section 9.1.35 System information Type 3 */
117struct gsm48_system_information_type_3 {
118 struct gsm48_system_information_type_header header;
119 u_int16_t cell_identity;
120 struct gsm48_loc_area_id lai;
121 u_int8_t control_channel_description[3];
122 u_int8_t cell_options;
123 u_int8_t cell_selection[2];
Harald Weltede9226d2008-12-29 02:37:23 +0000124 struct gsm48_rach_control rach_control;
Holger Freyther5e85c8e2008-12-28 16:32:39 +0000125 u_int8_t s3_reset_octets[4];
126} __attribute__ ((packed));
127
128/* Section 9.1.36 System information Type 4 */
129struct gsm48_system_information_type_4 {
130 struct gsm48_system_information_type_header header;
131 struct gsm48_loc_area_id lai;
132 u_int8_t cell_selection[2];
Harald Weltede9226d2008-12-29 02:37:23 +0000133 struct gsm48_rach_control rach_control;
Holger Freyther5e85c8e2008-12-28 16:32:39 +0000134 /* optional CBCH conditional CBCH... followed by
135 mandantory SI 4 Reset Octets
136 */
137 u_int8_t data[0];
138} __attribute__ ((packed));
139
140/* Section 9.1.37 System information Type 5 */
141struct gsm48_system_information_type_5 {
142 u_int8_t rr_protocol_discriminator :4,
143 skip_indicator:4;
144 u_int8_t system_information;
145 u_int8_t bcch_frequency_list[16];
146} __attribute__ ((packed));
147
148/* Section 9.1.40 System information Type 6 */
149struct gsm48_system_information_type_6 {
150 u_int8_t rr_protocol_discriminator :4,
151 skip_indicator:4;
152 u_int8_t system_information;
153 u_int8_t cell_identity[2];
154 struct gsm48_loc_area_id lai;
155 u_int8_t cell_options;
156 u_int8_t ncc_permitted;
157 u_int8_t si_6_reset[0];
158} __attribute__ ((packed));
159
Harald Weltebcae43f2008-12-27 21:45:37 +0000160/* Section 10.2 + GSM 04.07 12.2.3.1.1 */
161#define GSM48_PDISC_GROUP_CC 0x00
162#define GSM48_PDISC_BCAST_CC 0x01
163#define GSM48_PDISC_PDSS1 0x02
Harald Welte4b634542008-12-27 01:55:51 +0000164#define GSM48_PDISC_CC 0x03
Harald Weltebcae43f2008-12-27 21:45:37 +0000165#define GSM48_PDISC_PDSS2 0x04
Harald Welte52b1f982008-12-23 20:25:15 +0000166#define GSM48_PDISC_MM 0x05
167#define GSM48_PDISC_RR 0x06
168#define GSM48_PDISC_MM_GPRS 0x08
Harald Weltebcae43f2008-12-27 21:45:37 +0000169#define GSM48_PDISC_SMS 0x09
170#define GSM48_PDISC_SM_GPRS 0x0a
171#define GSM48_PDISC_NC_SS 0x0b
172#define GSM48_PDISC_LOC 0x0c
Harald Weltede9226d2008-12-29 02:37:23 +0000173#define GSM48_PDISC_MASK 0x0f
Harald Welte52b1f982008-12-23 20:25:15 +0000174
175/* Section 10.4 */
176#define GSM48_MT_RR_INIT_REQ 0x3c
177#define GSM48_MT_RR_ADD_ASS 0x3b
178#define GSM48_MT_RR_IMM_ASS 0x3f
179#define GSM48_MT_RR_IMM_ASS_EXT 0x39
180#define GSM48_MT_RR_IMM_ASS_REJ 0x3a
181
182#define GSM48_MT_RR_CIPH_M_CMD 0x35
183#define GSM48_MT_RR_CIPH_M_COMPL 0x32
184
185#define GSM48_MT_RR_CFG_CHG_CMD 0x30
186#define GSM48_MT_RR_CFG_CHG_ACK 0x31
187#define GSM48_MT_RR_CFG_CHG_REJ 0x33
188
189#define GSM48_MT_RR_ASS_CMD 0x2e
190#define GSM48_MT_RR_ASS_COMPL 0x29
191#define GSM48_MT_RR_ASS_FAIL 0x2f
192#define GSM48_MT_RR_HANDO_CMD 0x2b
193#define GSM48_MT_RR_HANDO_COMPL 0x2c
194#define GSM48_MT_RR_HANDO_FAIL 0x28
195#define GSM48_MT_RR_HANDO_INFO 0x2d
196
197#define GSM48_MT_RR_CELL_CHG_ORDER 0x08
198#define GSM48_MT_RR_PDCH_ASS_CMD 0x23
199
200#define GSM48_MT_RR_CHAN_REL 0x0d
201#define GSM48_MT_RR_PART_REL 0x0a
202#define GSM48_MT_RR_PART_REL_COMP 0x0f
203
204#define GSM48_MT_RR_PAG_REQ_1 0x21
205#define GSM48_MT_RR_PAG_REQ_2 0x22
206#define GSM48_MT_RR_PAG_REQ_3 0x24
207#define GSM48_MT_RR_PAG_RESP 0x27
208#define GSM48_MT_RR_NOTIF_NCH 0x20
209#define GSM48_MT_RR_NOTIF_FACCH 0x25
210#define GSM48_MT_RR_NOTIF_RESP 0x26
211
212#define GSM48_MT_RR_SYSINFO_8 0x18
213#define GSM48_MT_RR_SYSINFO_1 0x19
214#define GSM48_MT_RR_SYSINFO_2 0x1a
215#define GSM48_MT_RR_SYSINFO_3 0x1b
216#define GSM48_MT_RR_SYSINFO_4 0x1c
217#define GSM48_MT_RR_SYSINFO_5 0x1d
218#define GSM48_MT_RR_SYSINFO_6 0x1e
219#define GSM48_MT_RR_SYSINFO_7 0x1f
220
221#define GSM48_MT_RR_SYSINFO_2bis 0x02
222#define GSM48_MT_RR_SYSINFO_2ter 0x03
223#define GSM48_MT_RR_SYSINFO_5bis 0x05
224#define GSM48_MT_RR_SYSINFO_5ter 0x06
225#define GSM48_MT_RR_SYSINFO_9 0x04
226#define GSM48_MT_RR_SYSINFO_13 0x00
227
228#define GSM48_MT_RR_SYSINFO_16 0x3d
229#define GSM48_MT_RR_SYSINFO_17 0x3e
230
231#define GSM48_MT_RR_CHAN_MODE_MODIF 0x10
232#define GSM48_MT_RR_STATUS 0x12
233#define GSM48_MT_RR_CHAN_MODE_MODIF_ACK 0x17
234#define GSM48_MT_RR_FREQ_REDEF 0x14
235#define GSM48_MT_RR_MEAS_REP 0x15
236#define GSM48_MT_RR_CLSM_CHG 0x16
237#define GSM48_MT_RR_CLSM_ENQ 0x13
238#define GSM48_MT_RR_EXT_MEAS_REP 0x36
239#define GSM48_MT_RR_EXT_MEAS_REP_ORD 0x37
240#define GSM48_MT_RR_GPRS_SUSP_REQ 0x34
241
242#define GSM48_MT_RR_VGCS_UPL_GRANT 0x08
243#define GSM48_MT_RR_UPLINK_RELEASE 0x0e
244#define GSM48_MT_RR_UPLINK_FREE 0x0c
245#define GSM48_MT_RR_UPLINK_BUSY 0x2a
246#define GSM48_MT_RR_TALKER_IND 0x11
247
248#define GSM48_MT_RR_APP_INFO 0x38
249
250/* Table 10.2/3GPP TS 04.08 */
251#define GSM48_MT_MM_IMSI_DETACH_IND 0x01
252#define GSM48_MT_MM_LOC_UPD_ACCEPT 0x02
253#define GSM48_MT_MM_LOC_UPD_REJECT 0x04
254#define GSM48_MT_MM_LOC_UPD_REQUEST 0x08
255
256#define GSM48_MT_MM_AUTH_REJ 0x11
257#define GSM48_MT_MM_AUTH_REQ 0x12
258#define GSM48_MT_MM_AUTH_RESP 0x14
259#define GSM48_MT_MM_ID_REQ 0x18
260#define GSM48_MT_MM_ID_RESP 0x19
261#define GSM48_MT_MM_TMSI_REALL_CMD 0x1a
262#define GSM48_MT_MM_TMSI_REALL_COMPL 0x1b
263
264#define GSM48_MT_MM_CM_SERV_ACC 0x21
265#define GSM48_MT_MM_CM_SERV_REJ 0x22
266#define GSM48_MT_MM_CM_SERV_ABORT 0x23
267#define GSM48_MT_MM_CM_SERV_REQ 0x24
268#define GSM48_MT_MM_CM_SERV_PROMPT 0x25
269#define GSM48_MT_MM_CM_REEST_REQ 0x28
270#define GSM48_MT_MM_ABORT 0x29
271
272#define GSM48_MT_MM_NULL 0x30
273#define GSM48_MT_MM_STATUS 0x31
274#define GSM48_MT_MM_INFO 0x32
275
276/* Table 10.3/3GPP TS 04.08 */
277#define GSM48_MT_CC_ALERTING 0x01
278#define GSM48_MT_CC_CALL_CONF 0x08
279#define GSM48_MT_CC_CALL_PROC 0x02
280#define GSM48_MT_CC_CONNECT 0x07
281#define GSM48_MT_CC_CONNECT_ACK 0x0f
282#define GSM48_MT_CC_EMERG_SETUP 0x0e
283#define GSM48_MT_CC_PROGRESS 0x03
284#define GSM48_MT_CC_ESTAB 0x04
285#define GSM48_MT_CC_ESTAB_CONF 0x06
286#define GSM48_MT_CC_RECALL 0x0b
287#define GSM48_MT_CC_START_CC 0x09
288#define GSM48_MT_CC_SETUP 0x05
289
290#define GSM48_MT_CC_MODIFY 0x17
291#define GSM48_MT_CC_MODIFY_COMPL 0x1f
292#define GSM48_MT_CC_MODIFY_REJECT 0x13
293#define GSM48_MT_CC_USER_INFO 0x10
294#define GSM48_MT_CC_HOLD 0x18
295#define GSM48_MT_CC_HOLD_ACK 0x19
296#define GSM48_MT_CC_HOLD_REJ 0x1a
297#define GSM48_MT_CC_RETR 0x1c
298#define GSM48_MT_CC_RETR_ACK 0x1d
299#define GSM48_MT_CC_RETR_REJ 0x1e
300
301#define GSM48_MT_CC_DISCONNECT 0x25
302#define GSM48_MT_CC_RELEASE 0x2d
303#define GSM48_MT_CC_RELEASE_COMPL 0xea
304
305#define GSM48_MT_CC_CONG_CTRL 0x39
306#define GSM48_MT_CC_NOTIFY 0x3e
307#define GSM48_MT_CC_STATUS 0x3d
308#define GSM48_MT_CC_STATUS_ENQ 0x34
309#define GSM48_MT_CC_START_DTMF 0x35
310#define GSM48_MT_CC_STOP_DTMF 0x31
311#define GSM48_MT_CC_STOP_DTMF_ACK 0x32
312#define GSM48_MT_CC_START_DTMF_ACK 0x36
313#define GSM48_MT_CC_START_DTMF_REJ 0x37
314#define GSM48_MT_CC_FACILITY 0x3a
315
316/* FIXME: Table 10.4 / 10.4a (GPRS) */
317
318/* Section 10.5.2.26, Table 10.5.64 */
319#define GSM48_PM_MASK 0x03
320#define GSM48_PM_NORMAL 0x00
321#define GSM48_PM_EXTENDED 0x01
322#define GSM48_PM_REORG 0x02
323#define GSM48_PM_SAME 0x03
324
325/* Table 10.5.4 */
326#define GSM_MI_TYPE_MASK 0x07
327#define GSM_MI_TYPE_NONE 0x00
328#define GSM_MI_TYPE_IMSI 0x01
329#define GSM_MI_TYPE_IMEI 0x02
330#define GSM_MI_TYPE_IMEISV 0x03
331#define GSM_MI_TYPE_TMSI 0x04
332#define GSM_MI_ODD 0x08
333
Harald Welte4b634542008-12-27 01:55:51 +0000334#define GSM48_IE_MOBILE_ID 0x17
Harald Weltec6ba9c22008-12-30 18:01:02 +0000335#define GSM48_IE_NAME_LONG 0x43 /* 10.5.3.5a */
336#define GSM48_IE_NAME_SHORT 0x45 /* 10.5.3.5a */
337#define GSM48_IE_UTC 0x46 /* 10.5.3.8 */
338#define GSM48_IE_NET_TIME_TZ 0x47 /* 10.5.3.9 */
339#define GSM48_IE_LSA_IDENT 0x48 /* 10.5.3.11 */
Harald Welte4b634542008-12-27 01:55:51 +0000340
341/* Section 10.5.4.11 / Table 10.5.122 */
342#define GSM48_CAUSE_CS_GSM 0x60
343
344enum gsm48_cause_loc {
345 GSM48_CAUSE_LOC_USER = 0x00,
346 GSM48_CAUSE_LOC_PRN_S_LU = 0x01,
347 GSM48_CAUSE_LOC_PUN_S_LU = 0x02,
348 GSM48_CAUSE_LOC_TRANS_NET = 0x03,
349 GSM48_CAUSE_LOC_PUN_S_RU = 0x04,
350 GSM48_CAUSE_LOC_PRN_S_RU = 0x05,
351 /* not defined */
352 GSM48_CAUSE_LOC_INN_NET = 0x07,
353 GSM48_CAUSE_LOC_NET_BEYOND = 0x0a,
354};
355
Holger Freythera7677942008-12-30 16:18:16 +0000356/* Annex G, GSM specific cause values for mobility management */
357enum gsm48_reject_value {
358 GSM48_REJECT_IMSI_UNKNOWN_IN_HLR = 2,
359 GSM48_REJECT_ILLEGAL_MS = 3,
360 GSM48_REJECT_IMSI_UNKNOWN_IN_VLR = 4,
361 GSM48_REJECT_IMEI_NOT_ACCEPTED = 5,
362 GSM48_REJECT_ILLEGAL_ME = 6,
363 GSM48_REJECT_PLMN_NOT_ALLOWED = 11,
364 GSM48_REJECT_LOC_NOT_ALLOWED = 12,
365 GSM48_REJECT_ROAMING_NOT_ALLOWED = 13,
366 GSM48_REJECT_NETWORK_FAILURE = 17,
367 GSM48_REJECT_CONGESTION = 22,
368 GSM48_REJECT_SRV_OPT_NOT_SUPPORTED = 32,
369 GSM48_REJECT_RQD_SRV_OPT_NOT_SUPPORTED = 33,
370 GSM48_REJECT_SRV_OPT_TMP_OUT_OF_ORDER = 34,
371 GSM48_REJECT_CALL_CAN_NOT_BE_IDENTIFIED = 38,
372 GSM48_REJECT_INCORRECT_MESSAGE = 95,
373 GSM48_REJECT_INVALID_MANDANTORY_INF = 96,
374 GSM48_REJECT_MSG_TYPE_NOT_IMPLEMENTED = 97,
375 GSM48_REJECT_MSG_TYPE_NOT_COMPATIBLE = 98,
376 GSM48_REJECT_INF_ELEME_NOT_IMPLEMENTED = 99,
377 GSM48_REJECT_CONDTIONAL_IE_ERROR = 100,
378 GSM48_REJECT_MSG_NOT_COMPATIBLE = 101,
379 GSM48_REJECT_PROTOCOL_ERROR = 111,
380
381 /* according to G.6 Additional cause codes for GMM */
382 GSM48_REJECT_GPRS_NOT_ALLOWED = 7,
383 GSM48_REJECT_SERVICES_NOT_ALLOWED = 8,
384 GSM48_REJECT_MS_IDENTITY_NOT_DERVIVABLE = 9,
385 GSM48_REJECT_IMPLICITLY_DETACHED = 10,
386 GSM48_REJECT_GPRS_NOT_ALLOWED_IN_PLMN = 14,
387 GSM48_REJECT_MSC_TMP_NOT_REACHABLE = 16,
388};
389
390
Harald Welte8470bf22008-12-25 23:28:35 +0000391struct msgb;
392struct gsm_bts;
393
Holger Freythere97f7fb2008-12-31 18:52:11 +0000394/* config options controlling the behaviour of the lower leves */
Holger Freyther89824fc2008-12-30 16:18:18 +0000395void gsm0408_allow_everyone(int allow);
Holger Freythere97f7fb2008-12-31 18:52:11 +0000396void gsm0408_set_reject_cause(int cause);
397
Harald Welte8470bf22008-12-25 23:28:35 +0000398int gsm0408_rcvmsg(struct msgb *msg);
Holger Freyther17746612008-12-28 16:32:44 +0000399void gsm0408_generate_lai(struct gsm48_loc_area_id *lai48, u_int16_t mcc,
400 u_int16_t mnc, u_int16_t lac);
Holger Freytherabade7a2008-12-29 06:42:15 +0000401int gsm48_cc_tx_setup(struct gsm_lchan *lchan);
Harald Welte8470bf22008-12-25 23:28:35 +0000402enum gsm_chan_t get_ctype_by_chreq(struct gsm_bts *bts, u_int8_t ra);
Harald Weltee14a57c2008-12-29 04:08:28 +0000403enum gsm_chreq_reason_t get_reason_by_chreq(struct gsm_bts *bts, u_int8_t ra);
Harald Welte8470bf22008-12-25 23:28:35 +0000404
Harald Weltec6ba9c22008-12-30 18:01:02 +0000405int gsm48_tx_mm_info(struct gsm_lchan *lchan);
Holger Freyther819dd202009-01-04 03:52:50 +0000406struct msgb *gsm48_msgb_alloc(void);
Holger Freyther3e2c3232009-01-04 03:55:31 +0000407int gsm48_sendmsg(struct msgb *msg);
Holger Freytherca362a62009-01-04 21:05:01 +0000408int generate_mid_from_tmsi(u_int8_t *buf, u_int32_t tmsi);
Harald Weltec6ba9c22008-12-30 18:01:02 +0000409
Harald Welte8470bf22008-12-25 23:28:35 +0000410
Harald Welte52b1f982008-12-23 20:25:15 +0000411#endif