blob: 790dd7acd32d11eb5e30456e2bd5a542499b0309 [file] [log] [blame]
Harald Welte714ded92017-12-08 14:00:22 +01001module RSL_Emulation {
2
Harald Welte35bb7162018-01-03 21:07:52 +01003/* RSL Emulation, runs on top of IPA_Emulation. It multiplexes/demultiplexes
4 * the individual connections (logical channels), so there can be separate TTCN-3 components
5 * handling each of the connections.
6 *
7 * The RSL_Emulation.main() function processes RSL messages from the IPA demultiplex
8 * stack via the IPA_RSL_PT, and dispatches them to the per-connection components.
9 *
10 * Outbound RSL connections are initiated by sending a RSLDC_ChanRqd primitive
11 * to the component running the RSL_Emulation.main() function.
12 *
Harald Weltead2647b2018-03-22 19:53:55 +010013 * in case we're emulating the BTS-side of RSL: We have no clue as to which particular logical
14 * channel the BSC may decide to activate at which point, so we have to blindly acknowledge all
15 * channel activations. Still, a test case might be interested in the exact assignment message to
16 * determine the type of activation, encryption, codec flags etc. at some later point, when it's
17 * clear for which transaction this activation happened. We keep this in the LastChanAct table.
18 *
19 * (C) 2017-2018 by Harald Welte <laforge@gnumonks.org>
Harald Welte35bb7162018-01-03 21:07:52 +010020 * All rights reserved.
21 *
22 * Released under the terms of GNU General Public License, Version 2 or
23 * (at your option) any later version.
Harald Welte34b5a952019-05-27 11:54:11 +020024 *
25 * SPDX-License-Identifier: GPL-2.0-or-later
Harald Welte35bb7162018-01-03 21:07:52 +010026 */
27
Pau Espin Pedrola07cfd92018-10-22 15:54:41 +020028import from Misc_Helpers all;
Harald Welte714ded92017-12-08 14:00:22 +010029import from General_Types all;
30import from Osmocom_Types all;
31import from GSM_Types all;
32import from GSM_RR_Types all;
33import from RSL_Types all;
34import from IPA_Types all;
35import from IPA_Emulation all;
36
37
38/* General "base class" component definition, of which specific implementations
39 * derive themselves by means of the "extends" feature */
40type component RSL_DchanHdlr {
41 /* port facing up towards dedicated channel handler */
42 port RSL_DCHAN_PT RSL;
Harald Weltef70df652018-01-29 22:00:23 +010043 port RSLEM_PROC_PT RSL_PROC;
Harald Welte714ded92017-12-08 14:00:22 +010044 var RslChannelNr g_chan_nr;
Harald Welte421e4d42018-02-12 20:04:50 +010045 /* second BTS / DChan during hand-over */
46 port RSL_DCHAN_PT RSL1;
47 port RSLEM_PROC_PT RSL1_PROC;
Harald Welte714ded92017-12-08 14:00:22 +010048};
49
50type record RSLDC_ChanRqd {
51 OCT1 ra,
Pau Espin Pedrol6451b042018-10-24 20:36:16 +020052 GsmFrameNumber fn optional
Harald Welte714ded92017-12-08 14:00:22 +010053};
54
Pau Espin Pedrol6451b042018-10-24 20:36:16 +020055template (value) RSLDC_ChanRqd ts_RSLDC_ChanRqd(OCT1 ra, GsmFrameNumber fn) := {
Harald Welte714ded92017-12-08 14:00:22 +010056 ra := ra,
57 fn := fn
58}
59
Pau Espin Pedrol6451b042018-10-24 20:36:16 +020060template (value) RSLDC_ChanRqd ts_RSLDC_ChanRqd_anyFN(OCT1 ra) := {
61 ra := ra,
62 fn := omit
63}
64
Harald Welte714ded92017-12-08 14:00:22 +010065type port RSL_DCHAN_PT message {
66 inout RSLDC_ChanRqd, RSL_Message;
67} with { extension "internal" };
68
Harald Welte1c02fd12018-02-19 19:20:47 +010069type port RSL_CCHAN_PT message {
Harald Weltebb6aed32018-02-21 12:19:18 +010070 inout ASP_RSL_Unitdata, ASP_IPA_Event;
Harald Welte1c02fd12018-02-19 19:20:47 +010071} with { extension "internal" };
72
73
Harald Weltef70df652018-01-29 22:00:23 +010074signature RSLEM_register(uint8_t trx_nr, RslChannelNr chan_nr, RSL_DchanHdlr hdlr);
Harald Welte1909f462018-01-29 22:29:29 +010075signature RSLEM_unregister(uint8_t trx_nr, RslChannelNr chan_nr, RSL_DchanHdlr hdlr);
Harald Welte70b52c92018-02-12 20:47:31 +010076signature RSLEM_suspend(boolean suspend);
Harald Weltead2647b2018-03-22 19:53:55 +010077signature RSLEM_get_last_act(in uint8_t trx_nr, in RslChannelNr chan_nr, out RSL_Message chan_act);
Harald Weltef70df652018-01-29 22:00:23 +010078
79type port RSLEM_PROC_PT procedure {
Harald Weltead2647b2018-03-22 19:53:55 +010080 inout RSLEM_register, RSLEM_unregister, RSLEM_suspend, RSLEM_get_last_act;
Harald Weltef70df652018-01-29 22:00:23 +010081} with { extension "internal" };
82
Harald Welte714ded92017-12-08 14:00:22 +010083/***********************************************************************
84 * Client Component for a single dedicated channel
85 ***********************************************************************/
86
87private function f_rx_or_fail(template RSL_Message exp_rx) runs on RSL_DchanHdlr return RSL_Message
88{
89 var RSL_Message rx_rsl;
90 timer T := 10.0;
91
92 /* request a channel to be established */
93 T.start;
94 alt {
95 [] RSL.receive(exp_rx) -> value rx_rsl {
96 T.stop;
97 return rx_rsl;
98 }
99 [] RSL.receive {
100 setverdict(fail, "Unexpected RSL message on DCHAN");
Daniel Willmanne4ff5372018-07-05 17:35:03 +0200101 mtc.stop;
Harald Welte714ded92017-12-08 14:00:22 +0100102 }
103 [] T.timeout {
104 setverdict(fail, "Timeout waiting for RSL on DCHAN");
Daniel Willmanne4ff5372018-07-05 17:35:03 +0200105 mtc.stop;
Harald Welte714ded92017-12-08 14:00:22 +0100106 }
107 }
108 /* never reached */
109 return rx_rsl;
110}
111
112/* establish a dedicated channel using 'ra' */
113function f_chan_est(OCT1 ra, octetstring est_l3, template RslLinkId link_id, GsmFrameNumber fn := 23)
114runs on RSL_DchanHdlr {
115 var RSL_Message rx_rsl;
116 var GsmRrMessage rr;
117
118 /* request a channel to be established */
119 RSL.send(ts_RSLDC_ChanRqd(ra, fn));
120 /* expect immediate assignment */
121 rx_rsl := f_rx_or_fail(tr_RSL_IMM_ASSIGN);
122 rr := dec_GsmRrMessage(rx_rsl.ies[1].body.full_imm_ass_info.payload);
123 g_chan_nr := rr.payload.imm_ass.chan_desc.chan_nr;
124 RSL.send(ts_RSL_EST_IND(g_chan_nr, valueof(link_id), est_l3));
125}
126
127function f_deact_chan(RSL_Cause cause) runs on RSL_DchanHdlr
128{
129 var RSL_Message rx_rsl;
130
131 RSL.send(ts_RSL_CONN_FAIL_IND(g_chan_nr, cause));
132 rx_rsl := f_rx_or_fail(tr_RSL_MsgTypeD(RSL_MT_RF_CHAN_REL));
133 /* FIXME RSL.send(ts_RSL_RF_CHAN_REL_ACK()) */
134}
135
136
137
138/***********************************************************************
139 * Main Component
140 ***********************************************************************/
141
142private type record ConnectionData {
143 /* component reference to the client component */
144 RSL_DchanHdlr comp_ref,
145 /* RSL (dedicated) Channel number we're handling */
146 uint8_t trx_nr optional,
147 IpaStreamId stream_id optional,
148 RslChannelNr chan_nr optional,
149 /* Random Reference */
150 OCT1 ra optional,
151 GsmFrameNumber ra_fn optional
152};
153
154private function f_cid_by_comp_ref(RSL_DchanHdlr comp_ref)
155runs on RSL_Emulation_CT return integer {
156 var integer i;
157 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
158 if (ispresent(ConnectionTable[i].comp_ref) and
159 ConnectionTable[i].comp_ref == comp_ref) {
160 return i;
161 }
162 }
163 log("No Dchan handler for ", comp_ref);
164 return -1;
165}
166
167private function f_cid_by_chan_nr(uint8_t trx_nr, RslChannelNr chan_nr)
168runs on RSL_Emulation_CT return integer {
169 var integer i;
170 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
171 if (ispresent(ConnectionTable[i].chan_nr) and
172 ConnectionTable[i].chan_nr == chan_nr and ConnectionTable[i].trx_nr == trx_nr) {
173 return i;
174 }
175 }
176 log("No Dchan handler for ", trx_nr, chan_nr);
177 return -1;
178}
179
180private function f_cid_by_ra_fn(OCT1 ra, GsmFrameNumber fn)
181runs on RSL_Emulation_CT return integer {
182 var integer i;
183 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
184 if (ispresent(ConnectionTable[i].ra) and
185 ConnectionTable[i].ra == ra and ConnectionTable[i].ra_fn == fn) {
186 return i;
187 }
188 }
189 log("No Dchan handler for ", ra, fn);
190 return -1;
191}
192
Pau Espin Pedrol6451b042018-10-24 20:36:16 +0200193/* Matches by only RA if FN is ommited in one of the connections allocated */
194private function f_cid_by_ra_fn2(OCT1 ra, RSL_IE_FrameNumber fn)
195runs on RSL_Emulation_CT return integer {
196 var integer i;
197 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
198 if (ispresent(ConnectionTable[i].ra) and
199 ConnectionTable[i].ra == ra) {
200 if (not ispresent(ConnectionTable[i].ra_fn) or
201 fn == valueof(ts_RSL_IE_FrameNumber(ConnectionTable[i].ra_fn))) {
202 return i;
203 }
204 }
205 }
206 log("No Dchan handler for ", ra, fn);
207 return -1;
208}
209
Harald Welte714ded92017-12-08 14:00:22 +0100210/* create an ew client with given RA and FN */
Pau Espin Pedrol6451b042018-10-24 20:36:16 +0200211private function f_cid_create(OCT1 ra, template (omit) GsmFrameNumber fn, RSL_DchanHdlr comp_ref)
Harald Welte930d0a72018-03-22 22:08:40 +0100212runs on RSL_Emulation_CT {
Harald Welte714ded92017-12-08 14:00:22 +0100213 var integer i;
214 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
Harald Weltef70df652018-01-29 22:00:23 +0100215 if (not ispresent(ConnectionTable[i].ra) and
216 not ispresent(ConnectionTable[i].trx_nr)) {
Harald Welte714ded92017-12-08 14:00:22 +0100217 ConnectionTable[i].ra := ra;
Pau Espin Pedrol6451b042018-10-24 20:36:16 +0200218 if (ispresent(fn)) {
219 ConnectionTable[i].ra_fn := valueof(fn);
220 } else {
221 ConnectionTable[i].ra_fn := omit;
222 }
Harald Welte714ded92017-12-08 14:00:22 +0100223 ConnectionTable[i].comp_ref := comp_ref;
Harald Welte930d0a72018-03-22 22:08:40 +0100224 return;
Harald Welte714ded92017-12-08 14:00:22 +0100225 }
226 }
Daniel Willmann8273fb92018-07-05 17:31:20 +0200227 testcase.stop("No free entry in conn table for ", ra, fn);
Harald Welte714ded92017-12-08 14:00:22 +0100228}
229
Harald Weltef70df652018-01-29 22:00:23 +0100230/* create an ew client with given RA and FN */
231private function f_cid_create_cnr(uint8_t trx_nr, RslChannelNr chan_nr, RSL_DchanHdlr comp_ref)
Harald Welte930d0a72018-03-22 22:08:40 +0100232runs on RSL_Emulation_CT {
Harald Weltef70df652018-01-29 22:00:23 +0100233 var integer i;
234 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
235 if (not ispresent(ConnectionTable[i].ra) and
236 not ispresent(ConnectionTable[i].trx_nr)) {
237 ConnectionTable[i].stream_id := f_streamId_by_trx(trx_nr);
238 ConnectionTable[i].trx_nr := trx_nr;
239 ConnectionTable[i].chan_nr := chan_nr;
240 ConnectionTable[i].comp_ref := comp_ref;
Harald Welte930d0a72018-03-22 22:08:40 +0100241 return;
Harald Weltef70df652018-01-29 22:00:23 +0100242 }
243 }
Daniel Willmann8273fb92018-07-05 17:31:20 +0200244 testcase.stop("No free entry in conn table for ", trx_nr, chan_nr, comp_ref);
Harald Weltef70df652018-01-29 22:00:23 +0100245}
246
247
248/* create an ew client with given RA and FN */
249private function f_cid_delete_cnr(IpaStreamId stream_id, RslChannelNr chan_nr, RSL_DchanHdlr comp_ref)
250runs on RSL_Emulation_CT return integer {
251 var integer i;
252 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
253 if (ConnectionTable[i].comp_ref == null) {
254 continue;
255 }
256 if (ConnectionTable[i].stream_id == stream_id and
257 ConnectionTable[i].chan_nr == chan_nr and
258 ConnectionTable[i].comp_ref == comp_ref) {
259 f_cid_clear(i);
260 }
261 }
262 log("Unable to find entry to delete for ", stream_id, chan_nr, comp_ref);
263 return -1;
264}
265
266
Harald Welte714ded92017-12-08 14:00:22 +0100267private function f_cid_clear(integer cid)
268runs on RSL_Emulation_CT {
269 ConnectionTable[cid].ra := omit;
270 ConnectionTable[cid].ra_fn := omit;
Harald Welte714ded92017-12-08 14:00:22 +0100271 ConnectionTable[cid].trx_nr := omit;
272 ConnectionTable[cid].stream_id := omit;
273 ConnectionTable[cid].chan_nr := omit;
Harald Weltef70df652018-01-29 22:00:23 +0100274 ConnectionTable[cid].comp_ref := null;
Harald Welte714ded92017-12-08 14:00:22 +0100275}
276
Harald Weltead2647b2018-03-22 19:53:55 +0100277/* last activation for a given channel number */
278type record LastActData {
279 uint8_t trx_nr optional,
280 RslChannelNr chan_nr optional,
281 RSL_Message chan_act optional
282}
283
284private function f_store_last_act_data(uint8_t trx_nr, RslChannelNr chan_nr, RSL_Message chan_act)
285runs on RSL_Emulation_CT {
286 for (var integer i := 0; i < sizeof(LastActTable); i := i+1) {
287 if (not ispresent(LastActTable[i].chan_nr) or
288 (LastActTable[i].chan_nr == chan_nr and LastActTable[i].trx_nr == trx_nr)) {
289 LastActTable[i].trx_nr := trx_nr;
290 LastActTable[i].chan_nr := chan_nr;
291 LastActTable[i].chan_act := chan_act;
292 return;
293 }
294 }
Daniel Willmann8273fb92018-07-05 17:31:20 +0200295 testcase.stop("No space left in LastActTable to store chan_act for ", chan_nr);
Harald Weltead2647b2018-03-22 19:53:55 +0100296}
297
298private function f_lookup_last_act(uint8_t trx_nr, RslChannelNr chan_nr)
299runs on RSL_Emulation_CT return RSL_Message {
300 for (var integer i := 0; i < sizeof(LastActTable); i := i+1) {
301 if (ispresent(LastActTable[i].chan_nr) and LastActTable[i].chan_nr == chan_nr
302 and LastActTable[i].trx_nr == trx_nr) {
303 return LastActTable[i].chan_act;
304 }
305 }
Daniel Willmann8273fb92018-07-05 17:31:20 +0200306 testcase.stop("No LastActTable entry found for TRX ", trx_nr, " ", chan_nr);
Harald Weltead2647b2018-03-22 19:53:55 +0100307}
308
309private function f_last_act_table_init() runs on RSL_Emulation_CT {
310 for (var integer i := 0; i < sizeof(LastActTable); i := i+1) {
311 LastActTable[i] := { omit, omit, omit };
312 }
313}
314
Harald Welte714ded92017-12-08 14:00:22 +0100315type component RSL_Emulation_CT {
316 /* port facing down towards IPA emulation */
317 port IPA_RSL_PT IPA_PT;
318 /* port facing up towards dedicated channel handler */
319 port RSL_DCHAN_PT CLIENT_PT;
Harald Weltef70df652018-01-29 22:00:23 +0100320 port RSLEM_PROC_PT RSL_PROC;
Harald Welte714ded92017-12-08 14:00:22 +0100321
Harald Welte1c02fd12018-02-19 19:20:47 +0100322 /* port for Common Channel / TRX Management */
323 port RSL_CCHAN_PT CCHAN_PT;
324
Harald Welte714ded92017-12-08 14:00:22 +0100325 /* state of all concurrent connections / dedicated channels */
326 var ConnectionData ConnectionTable[64];
Harald Weltead2647b2018-03-22 19:53:55 +0100327
328 /* last RSL CHAN ACT for each chan_nr */
329 var LastActData LastActTable[64];
Harald Welte714ded92017-12-08 14:00:22 +0100330}
331
332
333/* template for an ASP_RSL_Unitdata as we receive it from the IPA_Emulateion component */
334private template ASP_RSL_Unitdata tr_RSL(template RSL_Message rsl, template IpaStreamId sid := ?) := {
335 streamId := sid,
336 rsl := rsl
337}
338
Harald Welte714ded92017-12-08 14:00:22 +0100339private function f_trx_by_streamId(IpaStreamId id) return integer {
340 return enum2int(id);
341}
342
Harald Weltef70df652018-01-29 22:00:23 +0100343private function f_streamId_by_trx(uint8_t trx_nr) return IpaStreamId {
344 select (trx_nr) {
345 case (0) { return IPAC_PROTO_RSL_TRX0; }
346 case (1) { return IPAC_PROTO_RSL_TRX1; }
347 case (2) { return IPAC_PROTO_RSL_TRX2; }
348 case (3) { return IPAC_PROTO_RSL_TRX3; }
349 }
Daniel Willmanna6ea2ef2018-07-24 09:55:52 +0200350 setverdict(fail, "Unknown stream ID ", trx_nr);
351 mtc.stop;
Harald Weltef70df652018-01-29 22:00:23 +0100352}
353
Harald Welte714ded92017-12-08 14:00:22 +0100354
Harald Welte1c02fd12018-02-19 19:20:47 +0100355function main(boolean bts_role := true) runs on RSL_Emulation_CT {
Harald Weltebb6aed32018-02-21 12:19:18 +0100356 var ASP_IPA_Event evt;
Harald Welte714ded92017-12-08 14:00:22 +0100357 var ASP_RSL_Unitdata rx_rsl;
358 var RSL_Message rx_rsl_msg;
359 var RSLDC_ChanRqd chan_rqd;
360 var RSL_DchanHdlr vc_conn;
Harald Weltef70df652018-01-29 22:00:23 +0100361 var RslChannelNr chan_nr;
362 var uint8_t trx_nr;
Harald Welte714ded92017-12-08 14:00:22 +0100363 var integer cid;
364 var integer i;
Harald Welte70b52c92018-02-12 20:47:31 +0100365 /* special synchronization handling during hand-over */
366 var boolean dchan_suspended := false;
Harald Welte714ded92017-12-08 14:00:22 +0100367
Daniel Willmann17f970f2018-01-17 12:03:19 +0100368 f_conn_table_init();
Harald Weltead2647b2018-03-22 19:53:55 +0100369 f_last_act_table_init();
Daniel Willmann17f970f2018-01-17 12:03:19 +0100370
Harald Welte714ded92017-12-08 14:00:22 +0100371 while (true) {
372 alt {
Harald Weltebb6aed32018-02-21 12:19:18 +0100373 [bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_UP}) {
374 }
375 [not bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_UP}) -> value evt {
376 CCHAN_PT.send(evt);
Harald Welte624f9632017-12-16 19:26:04 +0100377 }
Pau Espin Pedrola07cfd92018-10-22 15:54:41 +0200378 [bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_DOWN}) {
379 Misc_Helpers.f_shutdown(__BFILE__, __LINE__, fail, "Lost IPA connection!");
380
381 }
382 [not bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_DOWN}) {
383 Misc_Helpers.f_shutdown(__BFILE__, __LINE__, fail, "Lost IPA connection!");
384 }
Harald Welte1c02fd12018-02-19 19:20:47 +0100385 [bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_ID_ACK}) {
Harald Welte7ae019e2017-12-09 00:54:15 +0100386 IPA_PT.send(ts_ASP_RSL_UD(IPAC_PROTO_RSL_TRX0,ts_RSL_PAGING_LOAD_IND(23)));
Harald Welte714ded92017-12-08 14:00:22 +0100387 }
Harald Welted879e2f2018-05-27 20:22:13 +0200388 [not bts_role] IPA_PT.receive(ASP_IPA_Event:{up_down := ASP_IPA_EVENT_ID_ACK}) { }
Harald Welte1c02fd12018-02-19 19:20:47 +0100389 [bts_role] IPA_PT.receive(tr_RSL(tr_RSL_IMM_ASSIGN)) -> value rx_rsl {
Harald Welte714ded92017-12-08 14:00:22 +0100390 var GsmRrMessage rr;
391 var OCT1 ra;
392 var GsmFrameNumber fn;
Harald Welte714ded92017-12-08 14:00:22 +0100393 rr := dec_GsmRrMessage(rx_rsl.rsl.ies[1].body.full_imm_ass_info.payload);
394 if (ischosen(rr.payload.imm_ass)) {
395 ra := bit2oct(rr.payload.imm_ass.req_ref.ra);
396 fn := 23; //FIXME(rr.payload.imm_ass);
397 /* lookup client based on RA+time, deliver to client */
398 cid := f_cid_by_ra_fn(ra, fn);
399 if (cid == -1) {
400 setverdict(fail, "IMM ASS for unknown DChan");
Daniel Willmanne4ff5372018-07-05 17:35:03 +0200401 mtc.stop;
Harald Welte714ded92017-12-08 14:00:22 +0100402 }
403 /* update client with trx_nr */
404 ConnectionTable[cid].trx_nr := f_trx_by_streamId(rx_rsl.streamId);
405 ConnectionTable[cid].stream_id := rx_rsl.streamId;
406 /* update client with chan_nr */
407 ConnectionTable[cid].chan_nr := rr.payload.imm_ass.chan_desc.chan_nr;
408 /* TODO: add timer to time-out ConnectionTable entries which
409 * never get followed-up to */
410 CLIENT_PT.send(rx_rsl.rsl) to ConnectionTable[cid].comp_ref;
411 } else if (ischosen(rr.payload.imm_ass_rej)) {
412 for (i := 0; i < sizeof(rr.payload.imm_ass_rej.payload); i := i + 1) {
413 ra := bit2oct(rr.payload.imm_ass_rej.payload[i].req_ref.ra);
414 fn := 23; //FIXME();
415 /* lookup client based on RA+time, deliver to client */
416 cid := f_cid_by_ra_fn(ra, fn);
417 if (cid != -1) {
418 CLIENT_PT.send(rx_rsl.rsl) to ConnectionTable[cid].comp_ref;
419 /* delete ClientTable entry, as it failed */
420 f_cid_clear(cid);
421 }
422 }
423 }
424 }
Pau Espin Pedrol6451b042018-10-24 20:36:16 +0200425 [not bts_role] IPA_PT.receive(tr_RSL(tr_RSL_CHAN_RQD(?))) -> value rx_rsl {
426 var RSL_IE_RequestRef req_ref;
427 req_ref := rx_rsl.rsl.ies[1].body.req_ref;
428 cid := f_cid_by_ra_fn2(req_ref.ra, req_ref.frame_nr);
429 if (cid != -1) {
430 CLIENT_PT.send(rx_rsl.rsl) to ConnectionTable[cid].comp_ref;
431 f_cid_clear(cid);
432 } else {
433 CCHAN_PT.send(rx_rsl);
434 }
435 }
Harald Welte714ded92017-12-08 14:00:22 +0100436
Harald Welte1c02fd12018-02-19 19:20:47 +0100437 [bts_role] IPA_PT.receive(tr_RSL(tr_RSL_PAGING_CMD(?, ?))) -> value rx_rsl {
Harald Welte714ded92017-12-08 14:00:22 +0100438 /* broadcast to all clients? */
439 for (i := 0; i < sizeof(ConnectionTable); i := i + 1) {
440 if (ispresent(ConnectionTable[i].comp_ref)) {
441 CLIENT_PT.send(rx_rsl.rsl) to ConnectionTable[i].comp_ref;
442 }
443 }
444 }
445
Harald Welte1c02fd12018-02-19 19:20:47 +0100446 /* Forward common channel management to the special port for it */
Harald Welte714ded92017-12-08 14:00:22 +0100447 [] IPA_PT.receive(tr_RSL(tr_RSL_MsgTypeT(?))) -> value rx_rsl {
Harald Welte1c02fd12018-02-19 19:20:47 +0100448 CCHAN_PT.send(rx_rsl);
Harald Welte714ded92017-12-08 14:00:22 +0100449 }
450
Harald Welte1c02fd12018-02-19 19:20:47 +0100451 /* Forward common channel management to the special port for it */
Harald Welte714ded92017-12-08 14:00:22 +0100452 [] IPA_PT.receive(tr_RSL(tr_RSL_MsgTypeC(?))) -> value rx_rsl {
Harald Welte1c02fd12018-02-19 19:20:47 +0100453 CCHAN_PT.send(rx_rsl);
Harald Welte714ded92017-12-08 14:00:22 +0100454 }
455
456 /* blindly acknowledge all channel activations */
Harald Welte1c02fd12018-02-19 19:20:47 +0100457 [bts_role] IPA_PT.receive(tr_RSL(tr_RSL_MsgTypeD(RSL_MT_CHAN_ACTIV))) -> value rx_rsl {
Harald Weltef70df652018-01-29 22:00:23 +0100458 chan_nr := rx_rsl.rsl.ies[0].body.chan_nr;
Harald Weltead2647b2018-03-22 19:53:55 +0100459 trx_nr := f_trx_by_streamId(rx_rsl.streamId);
460 f_store_last_act_data(trx_nr, chan_nr, rx_rsl.rsl);
Harald Welte7ae019e2017-12-09 00:54:15 +0100461 IPA_PT.send(ts_ASP_RSL_UD(rx_rsl.streamId, ts_RSL_CHAN_ACT_ACK(chan_nr, 23)));
Harald Welte714ded92017-12-08 14:00:22 +0100462 }
463
Harald Welte70b52c92018-02-12 20:47:31 +0100464 [not dchan_suspended] IPA_PT.receive(tr_RSL(tr_RSL_MsgTypeDR(?))) -> value rx_rsl {
Harald Welte714ded92017-12-08 14:00:22 +0100465 /* dispatch to channel based on ChanId */
466 cid := f_cid_by_chan_nr(f_trx_by_streamId(rx_rsl.streamId),
467 rx_rsl.rsl.ies[0].body.chan_nr);
468 if (cid != -1) {
469 CLIENT_PT.send(rx_rsl.rsl) to ConnectionTable[cid].comp_ref;
470 } else {
471 setverdict(fail, "RSL for unknown Dchan");
Daniel Willmanne4ff5372018-07-05 17:35:03 +0200472 mtc.stop;
Harald Welte714ded92017-12-08 14:00:22 +0100473 }
474 }
475
Harald Welte70b52c92018-02-12 20:47:31 +0100476 [not dchan_suspended] IPA_PT.receive {
Harald Welte714ded92017-12-08 14:00:22 +0100477 setverdict(fail, "Received unknown primitive from IPA");
Daniel Willmanne4ff5372018-07-05 17:35:03 +0200478 mtc.stop;
Harald Welte714ded92017-12-08 14:00:22 +0100479 }
480
Harald Welte1c02fd12018-02-19 19:20:47 +0100481 [bts_role] CLIENT_PT.receive(RSLDC_ChanRqd:?) -> value chan_rqd sender vc_conn {
Harald Welte714ded92017-12-08 14:00:22 +0100482 /* Store the knowledge that this sender has requested a certain RQ+time */
483 f_cid_create(chan_rqd.ra, chan_rqd.fn, vc_conn);
Harald Welte7ae019e2017-12-09 00:54:15 +0100484 IPA_PT.send(ts_ASP_RSL_UD(IPAC_PROTO_RSL_TRX0,
Harald Welte714ded92017-12-08 14:00:22 +0100485 ts_RSL_CHAN_RQD(chan_rqd.ra, chan_rqd.fn)));
486 }
487
Pau Espin Pedrol6451b042018-10-24 20:36:16 +0200488 [not bts_role] CLIENT_PT.receive(RSLDC_ChanRqd:?) -> value chan_rqd sender vc_conn {
489 /* Store the knowledge that this sender has requested a certain RQ+time */
490 f_cid_create(chan_rqd.ra, chan_rqd.fn, vc_conn);
491 }
492
Harald Welte714ded92017-12-08 14:00:22 +0100493 [] CLIENT_PT.receive(tr_RSL_MsgType(?)) -> value rx_rsl_msg sender vc_conn {
494 /* forward to BSC */
495 cid := f_cid_by_comp_ref(vc_conn);
Harald Welte7ae019e2017-12-09 00:54:15 +0100496 IPA_PT.send(ts_ASP_RSL_UD(ConnectionTable[cid].stream_id, rx_rsl_msg));
Harald Welte714ded92017-12-08 14:00:22 +0100497 }
498
Harald Welte34252c52018-02-24 04:51:50 +0100499 [] CCHAN_PT.receive(tr_RSL(?)) -> value rx_rsl {
500 IPA_PT.send(ts_ASP_RSL_UD(rx_rsl.streamId, rx_rsl.rsl));
501 }
502
Harald Weltef70df652018-01-29 22:00:23 +0100503 /* explicit registration, e.g. in (non-immediate) assignment case */
504 [] RSL_PROC.getcall(RSLEM_register:{?,?,?}) -> param(trx_nr, chan_nr, vc_conn) {
505 f_cid_create_cnr(trx_nr, chan_nr, vc_conn);
Harald Weltee32ad992018-05-31 22:17:46 +0200506 RSL_PROC.reply(RSLEM_register:{trx_nr, chan_nr, vc_conn}) to vc_conn;
Harald Weltef70df652018-01-29 22:00:23 +0100507 }
508
Harald Welte1909f462018-01-29 22:29:29 +0100509 [] RSL_PROC.getcall(RSLEM_unregister:{?,?,?}) -> param(trx_nr, chan_nr, vc_conn) {
510 cid := f_cid_by_chan_nr(trx_nr, chan_nr);
511 f_cid_clear(cid);
Harald Weltee32ad992018-05-31 22:17:46 +0200512 RSL_PROC.reply(RSLEM_unregister:{trx_nr, chan_nr, vc_conn}) to vc_conn;
Harald Welte1909f462018-01-29 22:29:29 +0100513 }
514
Harald Weltee32ad992018-05-31 22:17:46 +0200515 [] RSL_PROC.getcall(RSLEM_suspend:{true}) -> sender vc_conn {
Harald Welte70b52c92018-02-12 20:47:31 +0100516 log("Suspending DChan");
517 dchan_suspended := true;
Harald Weltee32ad992018-05-31 22:17:46 +0200518 RSL_PROC.reply(RSLEM_suspend:{true}) to vc_conn;
Harald Welte70b52c92018-02-12 20:47:31 +0100519 }
520
Harald Weltee32ad992018-05-31 22:17:46 +0200521 [] RSL_PROC.getcall(RSLEM_suspend:{false}) -> sender vc_conn {
Harald Welte70b52c92018-02-12 20:47:31 +0100522 log("Resuming DChan");
523 dchan_suspended := false;
Harald Weltee32ad992018-05-31 22:17:46 +0200524 RSL_PROC.reply(RSLEM_suspend:{false}) to vc_conn;
Harald Welte70b52c92018-02-12 20:47:31 +0100525 }
Harald Welte1909f462018-01-29 22:29:29 +0100526
Harald Weltee32ad992018-05-31 22:17:46 +0200527 [] RSL_PROC.getcall(RSLEM_get_last_act:{?,?,?}) -> param(trx_nr, chan_nr) sender vc_conn {
Harald Weltead2647b2018-03-22 19:53:55 +0100528 var RSL_Message last_chan_act := f_lookup_last_act(trx_nr, chan_nr);
Harald Weltee32ad992018-05-31 22:17:46 +0200529 RSL_PROC.reply(RSLEM_get_last_act:{trx_nr, chan_nr, last_chan_act}) to vc_conn;
Harald Weltead2647b2018-03-22 19:53:55 +0100530 }
Harald Welte714ded92017-12-08 14:00:22 +0100531 }
532 }
533}
534
Daniel Willmann17f970f2018-01-17 12:03:19 +0100535private function f_conn_table_init()
536runs on RSL_Emulation_CT {
537 var integer i;
538
539 /* Initialize the ConnectionTable */
540 for (i := 0; i < sizeof(ConnectionTable); i := i+1) {
541 f_cid_clear(i);
542 }
543}
Harald Welte714ded92017-12-08 14:00:22 +0100544
Harald Weltef70df652018-01-29 22:00:23 +0100545/* client/conn_hdlr side function to use procedure port to register stream_id/chan_nr */
Harald Welte421e4d42018-02-12 20:04:50 +0100546function f_rslem_register(uint8_t trx_nr, RslChannelNr chan_nr, RSLEM_PROC_PT PT := RSL_PROC)
547runs on RSL_DchanHdlr {
548 PT.call(RSLEM_register:{trx_nr, chan_nr, self}) {
549 [] PT.getreply(RSLEM_register:{?,?,?}) {};
Harald Weltef70df652018-01-29 22:00:23 +0100550 }
551}
552
Harald Welte1909f462018-01-29 22:29:29 +0100553/* client/conn_hdlr side function to use procedure port to unregister stream_id/chan_nr */
Harald Welte421e4d42018-02-12 20:04:50 +0100554function f_rslem_unregister(uint8_t trx_nr, RslChannelNr chan_nr, RSLEM_PROC_PT PT := RSL_PROC)
555runs on RSL_DchanHdlr {
556 PT.call(RSLEM_unregister:{trx_nr, chan_nr, self}) {
557 [] PT.getreply(RSLEM_unregister:{?,?,?}) {};
Harald Welte1909f462018-01-29 22:29:29 +0100558 }
559}
560
Harald Welte70b52c92018-02-12 20:47:31 +0100561/* resume handling of RSL DChan messages from IPA until f_rslem_resume() is called */
562function f_rslem_suspend(RSLEM_PROC_PT PT)
563runs on RSL_DchanHdlr {
564 PT.call(RSLEM_suspend:{true}) {
565 [] PT.getreply(RSLEM_suspend:{true}) {};
566 }
567}
568
569/* resume handling of RSL DChan messages after f_rslem_suspend() is called */
570function f_rslem_resume(RSLEM_PROC_PT PT)
571runs on RSL_DchanHdlr {
572 PT.call(RSLEM_suspend:{false}) {
573 [] PT.getreply(RSLEM_suspend:{false}) {};
574 }
575}
576
Harald Weltead2647b2018-03-22 19:53:55 +0100577/* obtain the last RSL_CHAN_ACT message for the given chan_nr */
578function f_rslem_get_last_act(RSLEM_PROC_PT PT, uint8_t trx_nr, RslChannelNr chan_nr)
579runs on RSL_DchanHdlr return RSL_Message {
580 var RSL_Message chan_act;
581 PT.call(RSLEM_get_last_act:{trx_nr, chan_nr, -}) {
582 [] PT.getreply(RSLEM_get_last_act:{trx_nr, chan_nr, ?}) -> param(chan_act) {};
583 }
584 return chan_act;
585}
586
587
Harald Welte70b52c92018-02-12 20:47:31 +0100588
Harald Welte1909f462018-01-29 22:29:29 +0100589
Harald Welte714ded92017-12-08 14:00:22 +0100590}