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