blob: 38ec5773ad3335e74fd455afb87513eb4de1351d [file] [log] [blame]
Harald Welte52b1f982008-12-23 20:25:15 +00001/* GSM Radio Signalling Link messages on the A-bis interface
2 * 3GPP TS 08.58 version 8.6.0 Release 1999 / ETSI TS 100 596 V8.6.0 */
3
4/* (C) 2008 by Harald Welte <laforge@gnumonks.org>
Harald Welte8470bf22008-12-25 23:28:35 +00005 *
Harald Welte52b1f982008-12-23 20:25:15 +00006 * All Rights Reserved
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 *
22 */
23
24#include <stdio.h>
Harald Welte8470bf22008-12-25 23:28:35 +000025#include <stdlib.h>
Harald Welte52b1f982008-12-23 20:25:15 +000026#include <errno.h>
27#include <sys/types.h>
28
Harald Welte8470bf22008-12-25 23:28:35 +000029#include <openbsc/gsm_data.h>
30#include <openbsc/gsm_04_08.h>
31#include <openbsc/abis_rsl.h>
32#include <openbsc/chan_alloc.h>
33#include <openbsc/debug.h>
34#include <openbsc/tlv.h>
Harald Welte52b1f982008-12-23 20:25:15 +000035
Harald Welte8470bf22008-12-25 23:28:35 +000036#define RSL_ALLOC_SIZE 1024
37#define RSL_ALLOC_HEADROOM 128
Harald Welte52b1f982008-12-23 20:25:15 +000038
39static u_int8_t mdisc_by_msgtype(u_int8_t msg_type)
40{
41 /* mask off the transparent bit ? */
42 msg_type &= 0xfe;
43
Harald Welte8470bf22008-12-25 23:28:35 +000044 if ((msg_type & 0xf0) == 0x00)
Harald Welte52b1f982008-12-23 20:25:15 +000045 return ABIS_RSL_MDISC_RLL;
Harald Welte8470bf22008-12-25 23:28:35 +000046 if ((msg_type & 0xf0) == 0x10) {
Harald Welte52b1f982008-12-23 20:25:15 +000047 if (msg_type >= 0x19 && msg_type <= 0x22)
48 return ABIS_RSL_MDISC_TRX;
49 else
50 return ABIS_RSL_MDISC_COM_CHAN;
51 }
Harald Welte2d5b6382008-12-27 19:46:06 +000052 if ((msg_type & 0xe0) == 0x20)
Harald Welte52b1f982008-12-23 20:25:15 +000053 return ABIS_RSL_MDISC_DED_CHAN;
54
55 return ABIS_RSL_MDISC_LOC;
56}
57
58static inline void init_dchan_hdr(struct abis_rsl_dchan_hdr *dh,
59 u_int8_t msg_type)
60{
61 dh->c.msg_discr = mdisc_by_msgtype(msg_type);
62 dh->c.msg_type = msg_type;
63 dh->ie_chan = RSL_IE_CHAN_NR;
64}
65
66static inline void init_llm_hdr(struct abis_rsl_rll_hdr *dh,
67 u_int8_t msg_type)
68{
69 /* dh->c.msg_discr = mdisc_by_msgtype(msg_type); */
70 dh->c.msg_discr = ABIS_RSL_MDISC_RLL;
71 dh->c.msg_type = msg_type;
72 dh->ie_chan = RSL_IE_CHAN_NR;
73 dh->ie_link_id = RSL_IE_LINK_IDENT;
74}
75
76
77/* encode channel number as per Section 9.3.1 */
78u_int8_t rsl_enc_chan_nr(u_int8_t type, u_int8_t subch, u_int8_t timeslot)
79{
80 u_int8_t ret;
81
82 ret = (timeslot & 0x07) | type;
83
84 switch (type) {
85 case RSL_CHAN_Lm_ACCHs:
86 subch &= 0x01;
87 break;
88 case RSL_CHAN_SDCCH4_ACCH:
89 subch &= 0x07;
90 break;
91 case RSL_CHAN_SDCCH8_ACCH:
92 subch &= 0x07;
93 break;
94 default:
95 /* no subchannels allowed */
96 subch = 0x00;
97 break;
98 }
99 ret |= (subch << 3);
100
101 return ret;
102}
103
Harald Welte8470bf22008-12-25 23:28:35 +0000104/* determine logical channel based on TRX and channel number IE */
105struct gsm_lchan *lchan_lookup(struct gsm_bts_trx *trx, u_int8_t chan_nr)
106{
107 struct gsm_lchan *lchan;
108 u_int8_t ts_nr = chan_nr & 0x07;
109 u_int8_t cbits = chan_nr >> 3;
110 u_int8_t lch_idx;
111 struct gsm_bts_trx_ts *ts = &trx->ts[ts_nr];
112
113 if (cbits == 0x01) {
114 lch_idx = 0; /* TCH/F */
115 if (ts->pchan != GSM_PCHAN_TCH_F)
116 fprintf(stderr, "chan_nr=0x%02x but pchan=%u\n",
117 chan_nr, ts->pchan);
118 } else if ((cbits & 0x1e) == 0x02) {
119 lch_idx = cbits & 0x1; /* TCH/H */
120 if (ts->pchan != GSM_PCHAN_TCH_H)
121 fprintf(stderr, "chan_nr=0x%02x but pchan=%u\n",
122 chan_nr, ts->pchan);
123 } else if ((cbits & 0x1c) == 0x04) {
124 lch_idx = cbits & 0x3; /* SDCCH/4 */
125 if (ts->pchan != GSM_PCHAN_CCCH_SDCCH4)
126 fprintf(stderr, "chan_nr=0x%02x but pchan=%u\n",
127 chan_nr, ts->pchan);
128 } else if ((cbits & 0x18) == 0x08) {
129 lch_idx = cbits & 0x7; /* SDCCH/8 */
130 if (ts->pchan != GSM_PCHAN_SDCCH8_SACCH8C)
131 fprintf(stderr, "chan_nr=0x%02x but pchan=%u\n",
132 chan_nr, ts->pchan);
133 } else if (cbits == 0x10 || cbits == 0x11 || cbits == 0x12) {
134 lch_idx = 0;
135 if (ts->pchan != GSM_PCHAN_CCCH &&
136 ts->pchan != GSM_PCHAN_CCCH_SDCCH4)
137 fprintf(stderr, "chan_nr=0x%02x but pchan=%u\n",
138 chan_nr, ts->pchan);
139 /* FIXME: we should not return first sdcch4 !!! */
140 } else {
141 fprintf(stderr, "unknown chan_nr=0x%02x\n", chan_nr);
142 return NULL;
143 }
144
145 lchan = &ts->lchan[lch_idx];
146
147 return lchan;
148}
149
150u_int8_t lchan2chan_nr(struct gsm_lchan *lchan)
151{
152 struct gsm_bts_trx_ts *ts = lchan->ts;
153 u_int8_t cbits, chan_nr;
154
155 switch (ts->pchan) {
156 case GSM_PCHAN_TCH_F:
157 cbits = 0x01;
158 break;
159 case GSM_PCHAN_TCH_H:
160 cbits = 0x02;
161 cbits += lchan->nr;
162 break;
163 case GSM_PCHAN_CCCH_SDCCH4:
164 cbits = 0x04;
165 cbits += lchan->nr;
166 break;
167 case GSM_PCHAN_SDCCH8_SACCH8C:
168 cbits = 0x08;
169 cbits += lchan->nr;
170 break;
171 default:
172 case GSM_PCHAN_CCCH:
173 cbits = 0x10;
174 break;
175 }
176
177 chan_nr = (cbits << 3) | (ts->nr & 0x7);
178
179 return chan_nr;
180}
181
Harald Welte52b1f982008-12-23 20:25:15 +0000182/* As per TS 03.03 Section 2.2, the IMSI has 'not more than 15 digits' */
183u_int64_t str_to_imsi(const char *imsi_str)
184{
185 u_int64_t ret;
186
187 ret = strtoull(imsi_str, NULL, 10);
188
189 return ret;
190}
191
192/* Table 5 Clause 7 TS 05.02 */
193unsigned int n_pag_blocks(int bs_ccch_sdcch_comb, unsigned int bs_ag_blks_res)
194{
195 if (!bs_ccch_sdcch_comb)
196 return 9 - bs_ag_blks_res;
197 else
198 return 3 - bs_ag_blks_res;
199}
200
201/* Chapter 6.5.2 of TS 05.02 */
202unsigned int get_ccch_group(u_int64_t imsi, unsigned int bs_cc_chans,
203 unsigned int n_pag_blocks)
204{
205 return (imsi % 1000) % (bs_cc_chans * n_pag_blocks) / n_pag_blocks;
206}
207
208/* Chapter 6.5.2 of TS 05.02 */
209unsigned int get_paging_group(u_int64_t imsi, unsigned int bs_cc_chans,
210 int n_pag_blocks)
211{
212 return (imsi % 1000) % (bs_cc_chans * n_pag_blocks) % n_pag_blocks;
213}
214
Harald Welte8470bf22008-12-25 23:28:35 +0000215static struct msgb *rsl_msgb_alloc(void)
216{
217 return msgb_alloc_headroom(RSL_ALLOC_SIZE, RSL_ALLOC_HEADROOM);
218}
219
Harald Welte52b1f982008-12-23 20:25:15 +0000220/* Send a BCCH_INFO message as per Chapter 8.5.1 */
221int rsl_bcch_info(struct gsm_bts *bts, u_int8_t type,
222 const u_int8_t *data, int len)
223{
224 struct abis_rsl_dchan_hdr *dh;
Harald Welte8470bf22008-12-25 23:28:35 +0000225 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000226
227 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof*dh);
228 init_dchan_hdr(dh, RSL_MT_BCCH_INFO);
229 dh->chan_nr = RSL_CHAN_BCCH;
230
231 msgb_tv_put(msg, RSL_IE_SYSINFO_TYPE, type);
232 msgb_tlv_put(msg, RSL_IE_FULL_BCCH_INFO, len, data);
233
Harald Welte8470bf22008-12-25 23:28:35 +0000234 msg->trx = bts->c0;
235
236 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000237}
238
239int rsl_sacch_filling(struct gsm_bts *bts, u_int8_t type,
240 const u_int8_t *data, int len)
241{
242 struct abis_rsl_common_hdr *ch;
Harald Welte8470bf22008-12-25 23:28:35 +0000243 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000244
245 ch = (struct abis_rsl_common_hdr *) msgb_put(msg, sizeof(*ch));
246 ch->msg_discr = ABIS_RSL_MDISC_TRX;
247 ch->msg_type = RSL_MT_SACCH_FILL;
248
249 msgb_tv_put(msg, RSL_IE_SYSINFO_TYPE, type);
Harald Welte702d8702008-12-26 20:25:35 +0000250 msgb_tl16v_put(msg, RSL_IE_L3_INFO, len, data);
Harald Welte52b1f982008-12-23 20:25:15 +0000251
Harald Welte8470bf22008-12-25 23:28:35 +0000252 msg->trx = bts->c0;
253
254 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000255}
256
257/* Chapter 8.4.1 */
258int rsl_chan_activate(struct gsm_bts *bts, u_int8_t chan_nr,
259 u_int8_t act_type,
260 struct rsl_ie_chan_mode *chan_mode,
261 struct rsl_ie_chan_ident *chan_ident,
262 u_int8_t bs_power, u_int8_t ms_power,
263 u_int8_t ta)
264{
265 struct abis_rsl_dchan_hdr *dh;
Harald Welte8470bf22008-12-25 23:28:35 +0000266 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000267 u_int8_t encr_info = 0x01;
268
269 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof(*dh));
270 init_dchan_hdr(dh, RSL_MT_CHAN_ACTIV);
271 dh->chan_nr = chan_nr;
272
273 msgb_tv_put(msg, RSL_IE_ACT_TYPE, act_type);
274 /* For compatibility with Phase 1 */
275 msgb_tlv_put(msg, RSL_IE_CHAN_MODE, sizeof(*chan_mode),
276 (u_int8_t *) chan_mode);
277 msgb_tlv_put(msg, RSL_IE_CHAN_IDENT, 4,
Harald Welte702d8702008-12-26 20:25:35 +0000278 (u_int8_t *) chan_ident);
Harald Welte52b1f982008-12-23 20:25:15 +0000279 /* FIXME: this shoould be optional */
Harald Welte702d8702008-12-26 20:25:35 +0000280#if 0
Harald Welte52b1f982008-12-23 20:25:15 +0000281 msgb_tlv_put(msg, RSL_IE_ENCR_INFO, 1,
282 (u_int8_t *) &encr_info);
283 msgb_tv_put(msg, RSL_IE_BS_POWER, bs_power);
Harald Welte702d8702008-12-26 20:25:35 +0000284#endif
Harald Welte52b1f982008-12-23 20:25:15 +0000285 msgb_tv_put(msg, RSL_IE_MS_POWER, ms_power);
286 msgb_tv_put(msg, RSL_IE_TIMING_ADVANCE, ta);
287
Harald Welte8470bf22008-12-25 23:28:35 +0000288 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000289}
290
291#define TSC 7
292
Harald Welte4b634542008-12-27 01:55:51 +0000293int rsl_chan_activate_lchan(struct gsm_lchan *lchan, u_int8_t act_type, u_int8_t ta)
294{
295 struct abis_rsl_dchan_hdr *dh;
296 struct msgb *msg = rsl_msgb_alloc();
297 /* FXIME: don't hardcode these!! */
298 u_int8_t encr_info = 0x01;
299 u_int8_t ms_power = 0x0f;
300 u_int8_t bs_power = 0x01;
301
302 u_int8_t chan_nr = lchan2chan_nr(lchan);
303 u_int16_t arfcn = lchan->ts->trx->arfcn;
304 struct rsl_ie_chan_mode cm;
305 struct rsl_ie_chan_ident ci;
306
307 /* FIXME: what to do with data calls ? */
308 cm.dtx_dtu = 0x00;
309 switch (lchan->type) {
310 case GSM_LCHAN_SDCCH:
311 cm.spd_ind = RSL_CMOD_SPD_SIGN;
312 cm.chan_rt = RSL_CMOD_CRT_SDCCH;
313 cm.chan_rate = 0x00;
314 break;
315 case GSM_LCHAN_TCH_F:
316 cm.spd_ind = RSL_CMOD_SPD_SPEECH;
317 cm.chan_rt = RSL_CMOD_CRT_TCH_Bm;
318 cm.chan_rate = 0x11; /* speech coding alg version 2*/
319 break;
320 }
321
322 ci.chan_desc.iei = 0x64;
323 ci.chan_desc.chan_nr = chan_nr;
324 ci.chan_desc.oct3 = (TSC << 5) | ((arfcn & 0x3ff) >> 8);
325 ci.chan_desc.oct4 = arfcn & 0xff;
326
327 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof(*dh));
328 init_dchan_hdr(dh, RSL_MT_CHAN_ACTIV);
329 dh->chan_nr = chan_nr;
330
331 msgb_tv_put(msg, RSL_IE_ACT_TYPE, act_type);
332 /* For compatibility with Phase 1 */
333 msgb_tlv_put(msg, RSL_IE_CHAN_MODE, sizeof(cm),
334 (u_int8_t *) &cm);
335 msgb_tlv_put(msg, RSL_IE_CHAN_IDENT, 4,
336 (u_int8_t *) &ci);
337 /* FIXME: this shoould be optional */
338#if 0
339 msgb_tlv_put(msg, RSL_IE_ENCR_INFO, 1,
340 (u_int8_t *) &encr_info);
341 msgb_tv_put(msg, RSL_IE_BS_POWER, bs_power);
342#endif
343 msgb_tv_put(msg, RSL_IE_MS_POWER, ms_power);
344 msgb_tv_put(msg, RSL_IE_TIMING_ADVANCE, ta);
345
346 return abis_rsl_sendmsg(msg);
347}
348
Harald Welte8470bf22008-12-25 23:28:35 +0000349int rsl_chan_release(struct gsm_lchan *lchan)
Harald Welte52b1f982008-12-23 20:25:15 +0000350{
351 struct abis_rsl_dchan_hdr *dh;
Harald Welte8470bf22008-12-25 23:28:35 +0000352 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000353
354 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof(*dh));
355 init_dchan_hdr(dh, RSL_MT_RF_CHAN_REL);
Harald Welte8470bf22008-12-25 23:28:35 +0000356 dh->chan_nr = lchan2chan_nr(lchan);
Harald Welte52b1f982008-12-23 20:25:15 +0000357
Harald Welte8470bf22008-12-25 23:28:35 +0000358 msg->lchan = lchan;
359 msg->trx = lchan->ts->trx;
360
Harald Welte2d5b6382008-12-27 19:46:06 +0000361 DEBUGP(DRSL, "Channel Release CMD, chan_nr=0x%02x\n", dh->chan_nr);
362
Harald Welte8470bf22008-12-25 23:28:35 +0000363 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000364}
365
366int rsl_paging_cmd(struct gsm_bts *bts, u_int8_t paging_group, u_int8_t len,
367 u_int8_t *ms_ident, u_int8_t chan_needed)
368{
369 struct abis_rsl_dchan_hdr *dh;
Harald Welte8470bf22008-12-25 23:28:35 +0000370 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000371
372 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof(*dh));
373 init_dchan_hdr(dh, RSL_MT_PAGING_CMD);
374 dh->chan_nr = RSL_CHAN_PCH_AGCH;
375
376 msgb_tv_put(msg, RSL_IE_PAGING_GROUP, paging_group);
Harald Welte255539c2008-12-28 02:26:27 +0000377 msgb_tlv_put(msg, RSL_IE_MS_IDENTITY, len-2, ms_ident+2);
Harald Welte52b1f982008-12-23 20:25:15 +0000378 msgb_tv_put(msg, RSL_IE_CHAN_NEEDED, chan_needed);
379
Harald Welte8470bf22008-12-25 23:28:35 +0000380 msg->trx = bts->c0;
381
382 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000383}
384
385int imsi_str2bcd(u_int8_t *bcd_out, const char *str_in)
386{
387 int i, len = strlen(str_in);
388
389 for (i = 0; i < len; i++) {
390 int num = str_in[i] - 0x30;
391 if (num < 0 || num > 9)
392 return -1;
393 if (i % 2 == 0)
394 bcd_out[i/2] = num;
395 else
396 bcd_out[i/2] |= (num << 4);
397 }
398
399 return 0;
400}
401
402# if 0
403int rsl_paging_cmd_imsi(struct gsm_bts *bts, u_int8_t chan_needed, const char *imsi_str)
404{
405 /* FIXME: derive the MS Identity */
406 return rsl_paging_cmd(bts, paging_group, x, y, chan_needed);
407}
408#endif
409
Harald Welte702d8702008-12-26 20:25:35 +0000410/* Chapter 8.5.6 */
Harald Welte52b1f982008-12-23 20:25:15 +0000411int rsl_imm_assign_cmd(struct gsm_bts *bts, u_int8_t len, u_int8_t *val)
412{
Harald Welte8470bf22008-12-25 23:28:35 +0000413 struct msgb *msg = rsl_msgb_alloc();
Harald Welte52b1f982008-12-23 20:25:15 +0000414 struct abis_rsl_dchan_hdr *dh;
415
416 dh = (struct abis_rsl_dchan_hdr *) msgb_put(msg, sizeof(*dh));
417 init_dchan_hdr(dh, RSL_MT_IMMEDIATE_ASSIGN_CMD);
418 dh->chan_nr = RSL_CHAN_PCH_AGCH;
419
420 /* If phase 2, FULL_IMM_ASS_INFO */
421
422 msgb_tlv_put(msg, RSL_IE_IMM_ASS_INFO, len, val);
423
Harald Welte8470bf22008-12-25 23:28:35 +0000424 msg->trx = bts->c0;
425
426 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000427}
428
Harald Welte8470bf22008-12-25 23:28:35 +0000429/* Send "DATA REQUEST" message with given L3 Info payload */
Harald Welte52b1f982008-12-23 20:25:15 +0000430/* Chapter 8.3.1 */
Harald Welte8470bf22008-12-25 23:28:35 +0000431int rsl_data_request(struct msgb *msg, u_int8_t link_id)
Harald Welte52b1f982008-12-23 20:25:15 +0000432{
Harald Welte8470bf22008-12-25 23:28:35 +0000433 u_int8_t l3_len = msg->tail - (u_int8_t *)msgb_l3(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000434 struct abis_rsl_rll_hdr *rh;
435
Harald Welte8470bf22008-12-25 23:28:35 +0000436 if (msg->lchan == NULL) {
437 fprintf(stderr, "cannot send DATA REQUEST to unknown lchan\n");
438 return -EINVAL;
439 }
Harald Welte52b1f982008-12-23 20:25:15 +0000440
Harald Welte8470bf22008-12-25 23:28:35 +0000441 /* First push the L3 IE tag and length */
Harald Welte4b634542008-12-27 01:55:51 +0000442 msgb_tv16_push(msg, RSL_IE_L3_INFO, l3_len);
Harald Welte8470bf22008-12-25 23:28:35 +0000443
444 /* Then push the RSL header */
Harald Welte52b1f982008-12-23 20:25:15 +0000445 rh = (struct abis_rsl_rll_hdr *) msgb_push(msg, sizeof(*rh));
446 init_llm_hdr(rh, RSL_MT_DATA_REQ);
Harald Welte8470bf22008-12-25 23:28:35 +0000447 rh->chan_nr = lchan2chan_nr(msg->lchan);
448 rh->link_id = link_id;
Harald Welte52b1f982008-12-23 20:25:15 +0000449
Harald Welte8470bf22008-12-25 23:28:35 +0000450 msg->trx = msg->lchan->ts->trx;
451
452 return abis_rsl_sendmsg(msg);
Harald Welte52b1f982008-12-23 20:25:15 +0000453}
454
Harald Welte702d8702008-12-26 20:25:35 +0000455/* Chapter 8.4.2: Channel Activate Acknowledge */
456static int rsl_rx_chan_act_ack(struct msgb *msg)
457{
458 struct abis_rsl_dchan_hdr *rslh = msgb_l2(msg);
459
460 /* BTS has confirmed channel activation, we now need
461 * to assign the activated channel to the MS */
Harald Welte4b634542008-12-27 01:55:51 +0000462 if (rslh->ie_chan != RSL_IE_CHAN_NR)
463 return -EINVAL;
464
465 DEBUGP(DRSL, "Channel Activate ACK Channel 0x%02x\n", rslh->chan_nr);
Harald Welte702d8702008-12-26 20:25:35 +0000466
Harald Welte4b634542008-12-27 01:55:51 +0000467 return 0;
468}
Harald Welte702d8702008-12-26 20:25:35 +0000469
Harald Welte4b634542008-12-27 01:55:51 +0000470/* Chapter 8.4.3: Channel Activate NACK */
471static int rsl_rx_chan_act_nack(struct msgb *msg)
472{
473 struct abis_rsl_dchan_hdr *rslh = msgb_l2(msg);
474
475 /* BTS has confirmed channel activation, we now need
476 * to assign the activated channel to the MS */
477 if (rslh->ie_chan != RSL_IE_CHAN_NR)
478 return -EINVAL;
479
480 DEBUGP(DRSL, "Channel Activate NACK Channel 0x%02x\n", rslh->chan_nr);
481
482 return 0;
Harald Welte702d8702008-12-26 20:25:35 +0000483}
484
Harald Welte52b1f982008-12-23 20:25:15 +0000485static int abis_rsl_rx_dchan(struct msgb *msg)
486{
Harald Welte8470bf22008-12-25 23:28:35 +0000487 struct abis_rsl_dchan_hdr *rslh = msgb_l2(msg);
488 int rc = 0;
Harald Welte52b1f982008-12-23 20:25:15 +0000489
Harald Welte8470bf22008-12-25 23:28:35 +0000490 msg->lchan = lchan_lookup(msg->trx, rslh->chan_nr);
491
492 switch (rslh->c.msg_type) {
Harald Welte52b1f982008-12-23 20:25:15 +0000493 case RSL_MT_CHAN_ACTIV_ACK:
Harald Welte4b634542008-12-27 01:55:51 +0000494 rc = rsl_rx_chan_act_ack(msg);
Harald Welte702d8702008-12-26 20:25:35 +0000495 rc = rsl_rx_chan_act_ack(msg);
Harald Welte8470bf22008-12-25 23:28:35 +0000496 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000497 case RSL_MT_CHAN_ACTIV_NACK:
Harald Welte4b634542008-12-27 01:55:51 +0000498 rc = rsl_rx_chan_act_nack(msg);
Harald Welte8470bf22008-12-25 23:28:35 +0000499 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000500 case RSL_MT_CONN_FAIL:
Harald Welte2d5b6382008-12-27 19:46:06 +0000501 DEBUGP(DRSL, "Connection Fail, release channel\n");
Harald Welte14537e52008-12-27 10:29:08 +0000502 rc = rsl_chan_release(msg->lchan);
Harald Welte2d5b6382008-12-27 19:46:06 +0000503 /* only free it after channel release ACK */
Harald Welte8470bf22008-12-25 23:28:35 +0000504 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000505 case RSL_MT_MEAS_RES:
Harald Welte2d5b6382008-12-27 19:46:06 +0000506 DEBUGP(DRSL, "Measurement Result\n");
507 break;
508 case RSL_MT_RF_CHAN_REL_ACK:
509 DEBUGP(DRSL, "RF CHANNEL RELEASE ACK chan_nr=0x%02x\n", rslh->chan_nr);
510 lchan_free(msg->lchan);
Harald Welte8470bf22008-12-25 23:28:35 +0000511 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000512 case RSL_MT_MODE_MODIFY_ACK:
513 case RSL_MT_MODE_MODIFY_NACK:
514 case RSL_MT_PHY_CONTEXT_CONF:
515 case RSL_MT_PREPROC_MEAS_RES:
Harald Welte52b1f982008-12-23 20:25:15 +0000516 case RSL_MT_TALKER_DET:
517 case RSL_MT_LISTENER_DET:
518 case RSL_MT_REMOTE_CODEC_CONF_REP:
519 case RSL_MT_MR_CODEC_MOD_ACK:
520 case RSL_MT_MR_CODEC_MOD_NACK:
521 case RSL_MT_MR_CODEC_MOD_PER:
522 fprintf(stderr, "Unimplemented Abis RSL DChan msg 0x%02x\n",
Harald Welte8470bf22008-12-25 23:28:35 +0000523 rslh->c.msg_type);
Harald Welte52b1f982008-12-23 20:25:15 +0000524 break;
525 default:
526 fprintf(stderr, "unknown Abis RSL DChan msg 0x%02x\n",
Harald Welte8470bf22008-12-25 23:28:35 +0000527 rslh->c.msg_type);
Harald Welte52b1f982008-12-23 20:25:15 +0000528 return -EINVAL;
529 }
Harald Welte8470bf22008-12-25 23:28:35 +0000530 return rc;
Harald Welte52b1f982008-12-23 20:25:15 +0000531}
532
Harald Welte702d8702008-12-26 20:25:35 +0000533static int rsl_rx_error_rep(struct msgb *msg)
534{
535 struct abis_rsl_common_hdr *rslh = msgb_l2(msg);
536 u_int8_t cause_len;
537
538 if (rslh->data[0] != RSL_IE_CAUSE)
539 return -EINVAL;
540
541 cause_len = rslh->data[1];
Harald Welte4b634542008-12-27 01:55:51 +0000542 fprintf(stdout, "RSL ERROR REPORT, Cause ");
Harald Welte702d8702008-12-26 20:25:35 +0000543 hexdump(&rslh->data[2], cause_len);
544
545 return 0;
546}
547
Harald Welte52b1f982008-12-23 20:25:15 +0000548static int abis_rsl_rx_trx(struct msgb *msg)
549{
Harald Welte702d8702008-12-26 20:25:35 +0000550 struct abis_rsl_common_hdr *rslh = msgb_l2(msg);
Harald Welte8470bf22008-12-25 23:28:35 +0000551 int rc = 0;
Harald Welte52b1f982008-12-23 20:25:15 +0000552
553 switch (rslh->msg_type) {
Harald Welte702d8702008-12-26 20:25:35 +0000554 case RSL_MT_ERROR_REPORT:
555 rc = rsl_rx_error_rep(msg);
556 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000557 case RSL_MT_RF_RES_IND:
558 /* interference on idle channels of TRX */
559 case RSL_MT_OVERLOAD:
560 /* indicate CCCH / ACCH / processor overload */
Harald Welte52b1f982008-12-23 20:25:15 +0000561 fprintf(stderr, "Unimplemented Abis RSL TRX message type 0x%02x\n",
562 rslh->msg_type);
563 break;
564 default:
565 fprintf(stderr, "Unknown Abis RSL TRX message type 0x%02x\n",
566 rslh->msg_type);
567 return -EINVAL;
568 }
Harald Welte8470bf22008-12-25 23:28:35 +0000569 return rc;
Harald Welte52b1f982008-12-23 20:25:15 +0000570}
571
Harald Welte8470bf22008-12-25 23:28:35 +0000572/* MS has requested a channel on the RACH */
Harald Welte52b1f982008-12-23 20:25:15 +0000573static int rsl_rx_chan_rqd(struct msgb *msg)
574{
Harald Welte702d8702008-12-26 20:25:35 +0000575 struct gsm_bts *bts = msg->trx->bts;
Harald Welte8470bf22008-12-25 23:28:35 +0000576 struct abis_rsl_dchan_hdr *rqd_hdr = msgb_l2(msg);
577 struct gsm48_req_ref *rqd_ref;
Harald Welte52b1f982008-12-23 20:25:15 +0000578 struct gsm48_imm_ass ia;
Harald Welte8470bf22008-12-25 23:28:35 +0000579 enum gsm_chan_t lctype;
Harald Welte2cbe0922008-12-29 04:09:31 +0000580 enum gsm_chreq_reason_t chreq_reason;
Harald Welte8470bf22008-12-25 23:28:35 +0000581 struct gsm_lchan *lchan;
582 u_int8_t rqd_ta;
583
Harald Welte52b1f982008-12-23 20:25:15 +0000584 u_int16_t arfcn;
585 u_int8_t ts_number, subch;
586
Harald Welte8470bf22008-12-25 23:28:35 +0000587 /* parse request reference to be used in immediate assign */
588 if (rqd_hdr->data[0] != RSL_IE_REQ_REFERENCE)
589 return -EINVAL;
590
591 rqd_ref = (struct gsm48_req_ref *) &rqd_hdr->data[1];
592
593 /* parse access delay and use as TA */
594 if (rqd_hdr->data[sizeof(struct gsm48_req_ref)+1] != RSL_IE_ACCESS_DELAY)
595 return -EINVAL;
596 rqd_ta = rqd_hdr->data[sizeof(struct gsm48_req_ref)+2];
597
598 /* determine channel type (SDCCH/TCH_F/TCH_H) based on
599 * request reference RA */
600 lctype = get_ctype_by_chreq(bts, rqd_ref->ra);
Harald Welte2cbe0922008-12-29 04:09:31 +0000601 chreq_reason = get_reason_by_chreq(bts, rqd_ref->ra);
602
603 if (chreq_reason == GSM_CHREQ_REASON_PAG) {
604 DEBUGP(DPAG, "CHAN RQD due PAG %d\n", lctype);
605 }
Harald Welte8470bf22008-12-25 23:28:35 +0000606
607 /* check availability / allocate channel */
608 lchan = lchan_alloc(bts, lctype);
609 if (!lchan) {
610 fprintf(stderr, "CHAN RQD: no resources\n");
611 /* FIXME: send some kind of reject ?!? */
612 return -ENOMEM;
613 }
614
615 ts_number = lchan->ts->nr;
616 arfcn = lchan->ts->trx->arfcn;
617 subch = lchan->nr;
Harald Welte52b1f982008-12-23 20:25:15 +0000618
Harald Welte4b634542008-12-27 01:55:51 +0000619 rsl_chan_activate_lchan(lchan, 0x00, rqd_ta);
Harald Welte52b1f982008-12-23 20:25:15 +0000620
621 /* create IMMEDIATE ASSIGN 04.08 messge */
622 memset(&ia, 0, sizeof(ia));
623 ia.l2_plen = 0x2d;
624 ia.proto_discr = GSM48_PDISC_RR;
625 ia.msg_type = GSM48_MT_RR_IMM_ASS;
Harald Welte2d5b6382008-12-27 19:46:06 +0000626 ia.page_mode = GSM48_PM_SAME;
Harald Welte4b634542008-12-27 01:55:51 +0000627 ia.chan_desc.chan_nr = lchan2chan_nr(lchan);
Harald Welte52b1f982008-12-23 20:25:15 +0000628 ia.chan_desc.h0.h = 0;
629 ia.chan_desc.h0.arfcn_high = arfcn >> 8;
630 ia.chan_desc.h0.arfcn_low = arfcn & 0xff;
631 ia.chan_desc.h0.tsc = 7;
Harald Welte8470bf22008-12-25 23:28:35 +0000632 /* use request reference extracted from CHAN_RQD */
633 memcpy(&ia.req_ref, rqd_ref, sizeof(ia.req_ref));
634 ia.timing_advance = rqd_ta;
Harald Welte52b1f982008-12-23 20:25:15 +0000635 ia.mob_alloc_len = 0;
636
Harald Welte2cbe0922008-12-29 04:09:31 +0000637 DEBUGP(DRSL, "Activating ARFCN(%u) TS(%u) SS(%u) lctype %u chan_nr=0x%02x r%d\n",
638 arfcn, ts_number, subch, lchan->type, ia.chan_desc.chan_nr, chreq_reason);
Harald Welte75a983f2008-12-27 21:34:06 +0000639
Harald Welte52b1f982008-12-23 20:25:15 +0000640 /* send IMMEDIATE ASSIGN CMD on RSL to BTS (to send on CCCH to MS) */
641 return rsl_imm_assign_cmd(bts, sizeof(ia), (u_int8_t *) &ia);
642}
643
644static int abis_rsl_rx_cchan(struct msgb *msg)
645{
Harald Welte8470bf22008-12-25 23:28:35 +0000646 struct abis_rsl_dchan_hdr *rslh = msgb_l2(msg) ;
647 int rc = 0;
Harald Welte52b1f982008-12-23 20:25:15 +0000648
Harald Welte8470bf22008-12-25 23:28:35 +0000649 msg->lchan = lchan_lookup(msg->trx, rslh->chan_nr);
650
651 switch (rslh->c.msg_type) {
Harald Welte52b1f982008-12-23 20:25:15 +0000652 case RSL_MT_CHAN_RQD:
653 /* MS has requested a channel on the RACH */
654 rc = rsl_rx_chan_rqd(msg);
655 break;
656 case RSL_MT_DELETE_IND:
657 /* CCCH overloaded, IMM_ASSIGN was dropped */
658 case RSL_MT_CBCH_LOAD_IND:
659 /* current load on the CBCH */
660 case RSL_MT_CCCH_LOAD_IND:
661 /* current load on the CCCH */
662 fprintf(stderr, "Unimplemented Abis RSL TRX message type 0x%02x\n",
Harald Welte8470bf22008-12-25 23:28:35 +0000663 rslh->c.msg_type);
Harald Welte52b1f982008-12-23 20:25:15 +0000664 break;
665 default:
666 fprintf(stderr, "Unknown Abis RSL TRX message type 0x%02x\n",
Harald Welte8470bf22008-12-25 23:28:35 +0000667 rslh->c.msg_type);
Harald Welte52b1f982008-12-23 20:25:15 +0000668 return -EINVAL;
669 }
Harald Welte8470bf22008-12-25 23:28:35 +0000670
671 return rc;
Harald Welte52b1f982008-12-23 20:25:15 +0000672}
673
Harald Welte4b634542008-12-27 01:55:51 +0000674static int rsl_rx_rll_err_ind(struct msgb *msg)
675{
676 struct abis_rsl_rll_hdr *rllh = msgb_l2(msg);
677 u_int8_t *rlm_cause = rllh->data;
678
679 DEBUGP(DRLL, "RLL ERROR INDICATION: chan_nr=0x%02x cause=0x%02x\n",
680 rllh->chan_nr, rlm_cause[1]);
681
682 return 0;
683}
Harald Welte52b1f982008-12-23 20:25:15 +0000684/* ESTABLISH INDICATION, LOCATION AREA UPDATE REQUEST
685 0x02, 0x06,
686 0x01, 0x20,
687 0x02, 0x00,
688 0x0b, 0x00, 0x0f, 0x05, 0x08, ... */
689
690static int abis_rsl_rx_rll(struct msgb *msg)
691{
692 struct abis_rsl_rll_hdr *rllh = msgb_l2(msg);
693 int rc;
Harald Welte8470bf22008-12-25 23:28:35 +0000694
695 msg->lchan = lchan_lookup(msg->trx, rllh->chan_nr);
Harald Welte52b1f982008-12-23 20:25:15 +0000696
697 switch (rllh->c.msg_type) {
698 case RSL_MT_DATA_IND:
Harald Welte4b634542008-12-27 01:55:51 +0000699 DEBUGP(DRLL, "DATA INDICATION chan_nr=0x%02x\n", rllh->chan_nr);
Harald Welte8470bf22008-12-25 23:28:35 +0000700 /* FIXME: Verify L3 info element */
Harald Welte702d8702008-12-26 20:25:35 +0000701 msg->l3h = &rllh->data[3];
Harald Welte52b1f982008-12-23 20:25:15 +0000702 rc = gsm0408_rcvmsg(msg);
703 break;
704 case RSL_MT_EST_IND:
Harald Welte4b634542008-12-27 01:55:51 +0000705 DEBUGP(DRLL, "ESTABLISH INDICATION chan_nr=0x%02x\n", rllh->chan_nr);
Harald Welte8470bf22008-12-25 23:28:35 +0000706 /* FIXME: Verify L3 info element */
Harald Welte702d8702008-12-26 20:25:35 +0000707 msg->l3h = &rllh->data[3];
Harald Welte52b1f982008-12-23 20:25:15 +0000708 rc = gsm0408_rcvmsg(msg);
709 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000710 case RSL_MT_REL_IND:
Harald Welte4b634542008-12-27 01:55:51 +0000711 DEBUGP(DRLL, "RELEASE INDICATION chan_nr=0x%02x\n", rllh->chan_nr);
Harald Welte2d5b6382008-12-27 19:46:06 +0000712 break;
713 case RSL_MT_REL_CONF:
714 DEBUGP(DRLL, "RELEASE CONFIRMATION chan_nr=0x%02x\n", rllh->chan_nr);
Harald Welte4b634542008-12-27 01:55:51 +0000715 break;
716 case RSL_MT_ERROR_IND:
717 rc = rsl_rx_rll_err_ind(msg);
718 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000719 case RSL_MT_UNIT_DATA_IND:
720 fprintf(stderr, "unimplemented Abis RLL message type 0x%02x\n",
721 rllh->c.msg_type);
722 break;
723 default:
724 fprintf(stderr, "unknown Abis RLL message type 0x%02x\n",
725 rllh->c.msg_type);
726 }
Harald Welte8470bf22008-12-25 23:28:35 +0000727 return rc;
Harald Welte52b1f982008-12-23 20:25:15 +0000728}
729
730/* Entry-point where L2 RSL from BTS enters */
Harald Welte8470bf22008-12-25 23:28:35 +0000731int abis_rsl_rcvmsg(struct msgb *msg)
Harald Welte52b1f982008-12-23 20:25:15 +0000732{
733 struct abis_rsl_common_hdr *rslh = msgb_l2(msg) ;
734 unsigned int l2_len = (void *)msg->tail - msgb_l2(msg);
735 int rc;
736
737 switch (rslh->msg_discr & 0xfe) {
738 case ABIS_RSL_MDISC_RLL:
739 rc = abis_rsl_rx_rll(msg);
740 break;
741 case ABIS_RSL_MDISC_DED_CHAN:
742 rc = abis_rsl_rx_dchan(msg);
743 break;
744 case ABIS_RSL_MDISC_COM_CHAN:
Harald Welte52b1f982008-12-23 20:25:15 +0000745 rc = abis_rsl_rx_cchan(msg);
746 break;
Harald Welte8470bf22008-12-25 23:28:35 +0000747 case ABIS_RSL_MDISC_TRX:
748 rc = abis_rsl_rx_trx(msg);
749 break;
Harald Welte52b1f982008-12-23 20:25:15 +0000750 case ABIS_RSL_MDISC_LOC:
751 default:
752 fprintf(stderr, "unknown RSL message discriminator 0x%02x\n",
753 rslh->msg_discr);
754 return -EINVAL;
755 }
Harald Welte4f4a3902008-12-26 00:04:49 +0000756 msgb_free(msg);
Harald Welte8470bf22008-12-25 23:28:35 +0000757 return rc;
Harald Welte52b1f982008-12-23 20:25:15 +0000758}