blob: e3099e2b68ad61d746d9ff5bd7e63f011784bbcb [file] [log] [blame]
Harald Welteed0c1562019-02-07 20:26:29 +01001module BTS_Tests_OML {
2
3/* Integration Tests for OsmoBTS A-bis OML (Organization & Maintenance Link)
4 *
5 * (C) 2019 by Harald Welte <laforge@gnumonks.org>
6 * All rights reserved.
7 *
8 * Released under the terms of GNU General Public License, Version 2 or
9 * (at your option) any later version.
10 *
11 * SPDX-License-Identifier: GPL-2.0-or-later
12 */
13
14import from General_Types all;
15import from Osmocom_Types all;
16import from AbisOML_Types all;
17import from IPA_Emulation all;
18import from IPA_Types all;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +020019import from Misc_Helpers all;
20
21import from PCUIF_Types all;
22import from PCUIF_CodecPort all;
23import from PCUIF_CodecPort all;
24
25import from BTS_Tests all;
Harald Welteed0c1562019-02-07 20:26:29 +010026
27const integer NUM_TRX := 8;
28
29type record of uint16_t ArfcnList;
30
31modulepar {
32 charstring mp_oml_ip := "127.0.0.1";
33 integer mp_oml_port := 3002;
34 ArfcnList mp_arfcn := { 100, 101, 102, 103, 104, 105, 106, 107 };
35 OML_FOM_InterfLevBoundaries mp_interf_bound := { 85, 91, 97, 103, 109, 115 };
36 OML_FOM_T200 mp_t200 := {
37 sdcch_5ms := 30,
38 facch_f_5ms := 36,
39 facch_h_5ms := 36,
40 sacch_tch_sapi0_10ms := 168,
41 sacch_sdcch_10ms := 52,
42 sdcch_sapi3_5ms := 33,
43 sacch_rch_sapi3_10ms := 168
44 };
45 uint8_t mp_max_ta := 63;
46 uint8_t mp_load_threshold := 10;
47 uint8_t mp_load_ind_period := 1;
48 uint8_t mp_rach_b_thresh := 90;
49 uint16_t mp_loadavg_slots := 1000;
50 uint8_t mp_air_timer := 100;
51 uint8_t mp_ny1 := 10;
52 uint8_t mp_bsic := 63;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +020053
54 charstring mp_pcu_socket := PCU_SOCK_DEFAULT;
Harald Welteed0c1562019-02-07 20:26:29 +010055};
56
57/* BSC side OML component */
58type component BSC_OML_CT {
59 /* IPA emulation component underneath OML */
60 var IPA_Emulation_CT vc_IPA_OML;
61 /* Port for OML */
62 port IPA_OML_PT OML;
63 var uint8_t g_bts_nr := 0;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +020064
Pau Espin Pedrol6924ef72021-06-09 16:19:26 +020065 /* Port for Abis/Osmo/PCU */
66 port IPA_OSMO_PCU_PT IPA_OSMO_PCU;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +020067 /* PCU Interface of BTS */
68 port PCUIF_CODEC_PT PCU;
69 var integer g_pcu_conn_id;
70 /* Last PCU INFO IND we received */
71 var PCUIF_Message g_pcu_last_info;
72
73 /* As rxed by Get Attributes Response NM_ATT_MANUF_ID IE, see f_oml_getattr() */
74 var bitstring g_bts_features;
Harald Welteed0c1562019-02-07 20:26:29 +010075
76 /* global test case guard timer */
77 timer T_oml_guard := 60.0;
78};
79
80private altstep as_Tguard() runs on BSC_OML_CT {
81 [] T_oml_guard.timeout {
82 setverdict(fail, "Timeout of T_guard");
83 mtc.stop;
84 }
85}
86
87private altstep as_SwAct() runs on BSC_OML_CT {
88 var OML_PDU rx;
89 [] OML.receive(tr_OML_SwActReq(?, ?, ?, ?)) -> value rx {
90 var OML_FOM_ObjectClass obj_class := rx.u.fom.hdr.obj_class;
91 var OML_FOM_ObjectInstance obj_inst := rx.u.fom.hdr.obj_inst;
92
93 /* acknowledge the activate request */
94 OML.send(f_OML_make_ack(rx));
95 var octetstring file_id := ''O;
96 var octetstring sw_desc := ''O;
97
98 /* Request activation of software and check for ACK */
99 OML.send(ts_OML_ActivateSw(obj_class, obj_inst, file_id, sw_desc));
100 interleave {
101 [] OML.receive(tr_OML_ActivateSwACK(obj_class, obj_inst, file_id, sw_desc));
102 [] OML.receive(tr_OML_SwActivatedRep(obj_class, obj_inst));
103 }
104 repeat;
105 }
106}
107
108private altstep as_IPA_evt() runs on BSC_OML_CT {
109 var ASP_IPA_Event evt;
110 [] OML.receive(ASP_IPA_Event:?) -> value evt {
111 log("Ignoring ", evt);
112 repeat;
113 }
114}
115
116function f_init_oml(charstring id) runs on BSC_OML_CT {
Pau Espin Pedrol09b730f2023-04-03 16:30:07 +0200117 vc_IPA_OML := IPA_Emulation_CT.create(id & "-OML-IPA") alive;
Harald Welteed0c1562019-02-07 20:26:29 +0100118 map(vc_IPA_OML:IPA_PORT, system:IPA_CODEC_PT);
119 connect(vc_IPA_OML:IPA_OML_PORT, self:OML);
Pau Espin Pedrol6924ef72021-06-09 16:19:26 +0200120 connect(vc_IPA_OML:IPA_OSMO_PCU_PORT, self:IPA_OSMO_PCU);
Harald Welteed0c1562019-02-07 20:26:29 +0100121 vc_IPA_OML.start(IPA_Emulation.main_server(mp_oml_ip, mp_oml_port));
122
123 T_oml_guard.start;
124 activate(as_Tguard());
125
Vadim Yanitskiy61564be2020-05-18 20:44:14 +0700126 OML.receive(tr_ASP_IPA_EV(ASP_IPA_EVENT_UP));
127 //OML.receive(tr_ASP_IPA_EV(ASP_IPA_EVENT_ID_ACK));
Harald Welteed0c1562019-02-07 20:26:29 +0100128
129 activate(as_SwAct());
130 activate(as_IPA_evt());
131}
132
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200133private function f_init_pcu(PCUIF_CODEC_PT pt, charstring id,
134 out integer pcu_conn_id, out PCUIF_Message pcu_last_info) {
135 timer T := 2.0;
136 var PCUIF_send_data sd;
137
138 if (mp_pcu_socket == "") {
139 pcu_conn_id := -1;
140 return;
141 }
142 map(self:PCU, system:PCU);
143 pcu_conn_id := f_pcuif_connect(pt, mp_pcu_socket);
144
145 T.start;
146 alt {
147 [] as_pcu_info_ind(pt, pcu_conn_id, pcu_last_info);
148 [] T.timeout {
149 Misc_Helpers.f_shutdown(__BFILE__, __LINE__, fail, "Timeout waiting for PCU INFO_IND");
150 }
151 }
152 pt.send(t_SD_PCUIF(pcu_conn_id, ts_PCUIF_TXT_IND(0, PCU_VERSION, testcasename())));
153}
Harald Welteed0c1562019-02-07 20:26:29 +0100154
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200155private function f_shutdown_helper() runs on BSC_OML_CT
156{
157 Misc_Helpers.f_shutdown(__BFILE__, __LINE__, pass);
158}
159
Harald Welteed0c1562019-02-07 20:26:29 +0100160/* Perform an "OPSTART" procedure with the speciifed MO" */
161private function f_oml_opstart(template (value) OML_FOM_ObjectClass obj_class,
162 template (value) OML_FOM_ObjectInstance obj_inst,
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200163 boolean exp_fail := false,
164 template OML_FOM_OperationalState exp_stchg := ?)
Harald Welteed0c1562019-02-07 20:26:29 +0100165runs on BSC_OML_CT {
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200166 var boolean check_stchg := not istemplatekind(exp_stchg, "?");
167 var boolean ack_received := false;
168 var boolean stchg_received := not check_stchg;
169
Harald Welteed0c1562019-02-07 20:26:29 +0100170 OML.send(ts_OML_Opstart(obj_class, obj_inst));
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200171
Harald Welteed0c1562019-02-07 20:26:29 +0100172 alt {
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200173 [check_stchg] OML.receive(tr_OML_StateChgEvtRep(obj_class, obj_inst,
174 exp_stchg, NM_AVSTATE_OK)) {
175 stchg_received := true;
176 if (not ack_received) {
177 repeat;
178 }
179 setverdict(pass);
180 }
181 [check_stchg] OML.receive(tr_OML_StateChgEvtRep(obj_class, obj_inst,
182 ?, NM_AVSTATE_OK)) {
183 setverdict(fail, "Unexpected State Change for ", obj_class, " ", obj_inst);
184 }
Harald Welteed0c1562019-02-07 20:26:29 +0100185 [not exp_fail] OML.receive(tr_OML_OpstartACK(obj_class, obj_inst)) {
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200186 ack_received := true;
187 if (not stchg_received) {
188 repeat;
189 }
Harald Welteed0c1562019-02-07 20:26:29 +0100190 setverdict(pass);
191 }
192 [not exp_fail] OML.receive(tr_OML_OpstartNACK(obj_class, obj_inst)) {
193 setverdict(fail, "Unexpected OPSTART NACK for ", obj_class, " ", obj_inst);
194 }
195 [exp_fail] OML.receive(tr_OML_OpstartACK(obj_class, obj_inst)) {
196 setverdict(fail, "Unexpected OPSTART ACK for ", obj_class, " ", obj_inst);
197 }
198 [exp_fail] OML.receive(tr_OML_OpstartNACK(obj_class, obj_inst)) {
199 setverdict(pass);
200 }
201 [] OML.receive { repeat; }
202 }
203}
204
205/* Perform a "CHANGE ADMINISTRATIVE STATE" procedure with the speciifed MO" */
206private function f_oml_chg_adm_st(template (value) OML_FOM_ObjectClass obj_class,
207 template (value) OML_FOM_ObjectInstance obj_inst,
208 template (value) OML_FOM_AdministrativeState adm_st,
209 boolean exp_fail := false)
210runs on BSC_OML_CT {
211 OML.send(ts_OML_ChangeAdmState(obj_class, obj_inst, adm_st));
212 alt {
213 [not exp_fail] OML.receive(tr_OML_ChangeAdmStateACK(obj_class, obj_inst, adm_st)) {
214 setverdict(pass);
215 }
216 [not exp_fail] OML.receive(tr_OML_ChangeAdmStateNACK(obj_class, obj_inst)) {
217 setverdict(fail, "Unexpected CHANGE ADM STATE NACK for ", obj_class, " ", obj_inst);
218 }
219 [exp_fail] OML.receive(tr_OML_ChangeAdmStateACK(obj_class, obj_inst, adm_st)) {
220 setverdict(fail, "Unexpected CHANGE ADM STATE ACK for ", obj_class, " ", obj_inst);
221 }
222 [exp_fail] OML.receive(tr_OML_ChangeAdmStateNACK(obj_class, obj_inst)) {
223 setverdict(pass);
224 }
225 [] OML.receive { repeat; }
226 }
227}
228
229/* Perform a "SET RADIO CARRIER ATTRIBUTES" procedure with the BTS */
230private function f_oml_radio_attr(uint8_t trx_nr)
231runs on BSC_OML_CT {
232 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, trx_nr, 255));
233 var OML_PDU cmd := valueof(ts_OML_SetRadioAttr(obj_inst, 0, {mp_arfcn[trx_nr]}));
234 var template OML_PDU exp_ack := f_OML_make_ack_exp(cmd);
235 var template OML_PDU exp_nack := f_OML_make_nack_exp(cmd, ?);
236 var OML_PDU rx;
237
238 OML.send(cmd);
239 alt {
240 [] OML.receive(exp_ack) -> value rx {
241 setverdict(pass);
242 }
243 [] OML.receive(exp_nack) -> value rx {
244 setverdict(fail, "SET RADIO CARRIER ATTRIBUTES NACK ", exp_nack);
245 }
246 [] OML.receive(tr_OML_MsgType(NM_MT_SET_RADIO_ATTR_ACK, NM_OC_RADIO_CARRIER, obj_inst, omit)) {
247 setverdict(fail, "SET RADIO CARRIER ATTRIBUTES ACK without IEs");
248 }
249 [] OML.receive { repeat; }
250 }
251}
252
253/* Perform a "SET CHANNEL ATTRIBUTES" procedure with the BTS */
254private function f_oml_ts_attr(uint8_t trx_nr, uint8_t ts_nr)
255runs on BSC_OML_CT {
256 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, trx_nr, ts_nr));
257 var OML_PDU cmd := valueof(ts_OML_SetChanAttr(obj_inst, NM_CHANC_TCHFull, tsc := 7));
258 var template OML_PDU exp_ack := f_OML_make_ack_exp(cmd);
259 var template OML_PDU exp_nack := f_OML_make_nack_exp(cmd, ?);
260 var OML_PDU rx;
261
262 OML.send(cmd);
263 alt {
264 [] OML.receive(exp_ack) -> value rx {
265 setverdict(pass);
266 }
267 [] OML.receive(exp_nack) -> value rx {
268 setverdict(fail, "SET CHANNEL ATTRIBUTES NACK ", exp_nack);
269 }
270 [] OML.receive(tr_OML_MsgType(NM_MT_SET_CHAN_ATTR_ACK, NM_OC_CHANNEL, obj_inst, omit)) {
271 setverdict(fail, "SET CHANNEL ATTRIBUTES ACK without IEs");
272 }
273 [] OML.receive { repeat; }
274 }
275
276}
277
278/* Perform a "SET BTS ATTRIBUTES" procedure with the BTS */
Pau Espin Pedrol6c864ec2021-06-25 13:52:23 +0200279private function f_oml_bts_setattr()
Harald Welteed0c1562019-02-07 20:26:29 +0100280runs on BSC_OML_CT {
281 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
282 var template (value) OML_FOM_IE_List ies := {
283 ts_OML_IE(NM_ATT_INTERF_BOUND, OML_FOM_IE_Body:{interf_bound:=mp_interf_bound}),
284 ts_OML_IE(NM_ATT_BCCH_ARFCN, OML_FOM_IE_Body:{bcch_arfcn:=mp_arfcn[0]}),
285 ts_OML_IE(NM_ATT_CONN_FAIL_CRIT, OML_FOM_IE_Body:{other := ts_OML_IE_L16V(2, '0120'O)}),
286 ts_OML_IE(NM_ATT_T200, OML_FOM_IE_Body:{t200 := mp_t200}),
287 ts_OML_IE(NM_ATT_MAX_TA, OML_FOM_IE_Body:{max_ta := mp_max_ta}),
288 ts_OML_IE(NM_ATT_OVERL_PERIOD, OML_FOM_IE_Body:{other := ts_OML_IE_L16V(1, '0a'O)}),
289 ts_OML_IE(NM_ATT_CCCH_L_T, OML_FOM_IE_Body:{load_threshold := mp_load_threshold}),
290 ts_OML_IE(NM_ATT_CCCH_L_I_P, OML_FOM_IE_Body:{load_ind_period := mp_load_ind_period}),
291 ts_OML_IE(NM_ATT_RACH_B_THRESH, OML_FOM_IE_Body:{rach_b_thresh := mp_rach_b_thresh}),
292 ts_OML_IE(NM_ATT_LDAVG_SLOTS, OML_FOM_IE_Body:{loadavg_slots := mp_loadavg_slots}),
293 ts_OML_IE(NM_ATT_BTS_AIR_TIMER, OML_FOM_IE_Body:{air_timer := mp_air_timer}),
294 ts_OML_IE(NM_ATT_NY1, OML_FOM_IE_Body:{ny1 := mp_ny1}),
295 ts_OML_IE(NM_ATT_BSIC, OML_FOM_IE_Body:{bsic := mp_bsic})
296 //ts_OML_IE(NM_ATT_IPACC_CGI, ...)
297 };
298 var OML_PDU cmd := valueof(ts_OML_SetBtsAttr(obj_inst, ies));
299 var template OML_PDU exp_ack := f_OML_make_ack_exp(cmd);
300 var template OML_PDU exp_nack := f_OML_make_nack_exp(cmd, ?);
301 var OML_PDU rx;
302
303 OML.send(cmd);
304 alt {
305 [] OML.receive(exp_ack) -> value rx {
306 setverdict(pass);
307 }
308 [] OML.receive(exp_nack) -> value rx {
309 setverdict(fail, "SET BTS ATTRIBUTES NACK ", exp_nack);
310 }
311
312 [] OML.receive(tr_OML_MsgType(NM_MT_SET_BTS_ATTR_ACK, NM_OC_BTS, obj_inst, omit)) {
313 setverdict(fail, "SET BTS ATTRIBUTES ACK without IEs");
314 }
315 [] OML.receive { repeat; }
316 }
317}
318
319/* Send an OML message and expect no response at all */
320private function f_oml_send_exp_no_resp(template (value) OML_PDU tx, charstring err_msg,
321 float tout := 5.0) runs on BSC_OML_CT
322{
323 timer T := 5.0;
324
325 OML.send(tx);
326 T.start;
327 alt {
328 [] OML.receive {
329 setverdict(fail, err_msg);
330 }
331 [] T.timeout {
332 setverdict(pass);
333 }
334 }
335}
336
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200337private function f_oml_exp_rx(template OML_PDU exp_rx, charstring err_msg)
338 runs on BSC_OML_CT return OML_PDU
Harald Welteed0c1562019-02-07 20:26:29 +0100339{
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200340 var OML_PDU rx;
Harald Welteed0c1562019-02-07 20:26:29 +0100341 timer T := 5.0;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200342
Harald Welteed0c1562019-02-07 20:26:29 +0100343 T.start;
344 alt {
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200345 [] OML.receive(exp_rx) -> value rx {
Harald Welteed0c1562019-02-07 20:26:29 +0100346 setverdict(pass);
347 }
348 [] OML.receive { repeat; }
349 [] T.timeout {
350 setverdict(fail, "Timeout waiting for ", err_msg);
351 }
352 }
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200353 return rx;
Harald Welteed0c1562019-02-07 20:26:29 +0100354}
355
356/* Send an OML message and expect a failure event report in response */
357private function f_oml_send_exp_fail_rep(template (value) OML_PDU tx, charstring err_msg,
358 template OML_FOM_EventType evt := ?,
359 template OML_FOM_Severity severity := ?,
360 template OML_FOM_ProbableCause cause := ?,
361 float tout := 5.0) runs on BSC_OML_CT
362{
363 var template OML_FOM_ObjectClass obj_class := ?;
364 var template OML_FOM_ObjectInstance obj_inst := ?;
365 if (ischosen(tx.u.fom)) {
366 obj_class := tx.u.fom.hdr.obj_class;
367 obj_inst := tx.u.fom.hdr.obj_inst;
368 }
369 var template OML_PDU exp_fail := tr_OML_FailureEvtRep(obj_class,obj_inst, evt, severity, cause);
370
371 OML.send(tx);
372 f_oml_exp_rx(exp_fail, "Failure Event Report");
373}
374
375/* Send an OML message and expect it to be NACKed with specified cause */
376private function f_oml_send_exp_nack(template (value) OML_PDU tx, template OML_FOM_NackCause exp_cause,
377 float tout := 5.0) runs on BSC_OML_CT
378{
379 timer T := 5.0;
380
381 var template OML_PDU exp_nack := f_OML_make_nack_exp(valueof(tx), exp_cause);
382 var template OML_PDU exp_ack := f_OML_make_ack_exp(valueof(tx));
383 var OML_PDU rx;
384
385 OML.send(tx);
386 T.start;
387 alt {
388 [] OML.receive(exp_ack) -> value rx {
389 setverdict(fail, "Unexpected ACK ", rx);
390 }
391 [] OML.receive(exp_nack) -> value rx {
392 setverdict(pass);
393 }
394 [] OML.receive { repeat; }
395 [] T.timeout {
396 setverdict(fail, "Timeout waiting for NACK ", exp_nack);
397 }
398 }
399}
400
401
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200402private function f_oml_getattr(template OML_PDU exp_rx := tr_OML_GetAttributesResponse(NM_OC_BTS, ?, ?)) runs on BSC_OML_CT
403{
404 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
405 var OML_FOM_IE_Type attr_li[2] := { NM_ATT_MANUF_ID, NM_ATT_SW_CONFIG };
406 var octetstring req_attr := ''O;
407 for (var integer i := 0; i < lengthof(attr_li); i := i + 1) {
408 req_attr := req_attr & int2oct(enum2int(attr_li[i]), 1);
409 }
410 var OML_PDU cmd := valueof(ts_OML_GetAttributes(NM_OC_BTS, obj_inst, req_attr));
Harald Welteed0c1562019-02-07 20:26:29 +0100411
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200412 OML.send(cmd);
413 var OML_PDU rx := f_oml_exp_rx(exp_rx, "BTS GetAttributes Response");
414
415 var OML_FOM_IE_Body ie_ari := f_OML_FOM_get_ie(rx.u.fom, NM_ATT_GET_ARI);
416 var OML_FOM_IE_Body manuf_id := f_OML_FOM_IE_List_get_ie(ie_ari.ari.ies, NM_ATT_MANUF_ID);
417 g_bts_features := oct2bit(manuf_id.other.payload);
418}
Harald Welteed0c1562019-02-07 20:26:29 +0100419
420
421
422testcase TC_oml_selftest() runs on BSC_OML_CT {
423 const octetstring state_chg_bts := '8080000d610100ffff'O & '2401'O & '07000107'O & '0401'O;
424 const octetstring set_attr_bts := '80800033410100ffff19555b61676d7318060e00020110331e2424a83421a81f3f2500010a0c1e0b642a0a2b03e80a80230a08007b0920'O
425 const octetstring set_attr_radio := '8080000c44020000ff2d00050002007b'O;
426 const octetstring set_attr_ts0 := '8080000947030000000d074000'O;
427 const octetstring ipa_rsl_connect := '1080000a0d636f6d2e697061636365737300e0040000ff8500810bbb'O;
428
429 log(dec_OML_PDU(state_chg_bts));
430 log(dec_OML_PDU(set_attr_bts));
431 log(dec_OML_PDU(set_attr_radio));
432 log(dec_OML_PDU(set_attr_ts0));
433 log(dec_OML_PDU(ipa_rsl_connect));
434};
435
436testcase TC_oml_nothing() runs on BSC_OML_CT {
437 f_init_oml(testcasename());
438 f_sleep(100.0);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200439 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100440}
441
442/* test behavior for unsupported message discriminator */
443testcase TC_wrong_mdisc() runs on BSC_OML_CT {
444 f_init_oml(testcasename());
445
446 var OML_PDU mmi_pdu := {
447 mdisc := ABIS_OM_MDISC_MMI,
448 placement := ABIS_OM_PLACEMENT_ONLY,
449 sequence := 0,
450 u := {
451 other := '01020304'O
452 }
453 };
454
455 f_oml_send_exp_fail_rep(mmi_pdu, "Unexpected response to MMI message");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200456 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100457}
458
459/* send a message of unknown/unsupported type */
460testcase TC_wrong_msgtype() runs on BSC_OML_CT {
461 f_init_oml(testcasename());
462 var OML_PDU tx := valueof(ts_OML_MsgType(NM_MT_ESTABLISH_TEI, NM_OC_BTS,
463 ts_OML_ObjectInstance(0, 255, 255), omit));
464 f_oml_send_exp_fail_rep(tx, "ESTABLISH_TEI");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200465 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100466}
467
468/* send message shorter than OML header length indicates */
469testcase TC_short_length() runs on BSC_OML_CT {
470 f_init_oml(testcasename());
471
472 /* Send "Change Adm State (Locked) to BTS, but with length 09 instead of 07 */
473 OML.send('80800009690100ffff0401'O);
474
475 template OML_PDU exp_fail := tr_OML_FailureEvtRep(NM_OC_BTS,
476 ts_OML_ObjectInstance(0, 255, 255),
477 ?, ?, ?);
478 f_oml_exp_rx(exp_fail, "Failure Event Report");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200479 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100480}
481
482/* send message longer than OML header length indicates */
483testcase TC_long_length() runs on BSC_OML_CT {
484 f_init_oml(testcasename());
485 /* Send "Change Adm State (Locked) to BTS, but with two extra bytes at the end */
486 OML.send('80800007690100ffff04010402'O);
487
488 template OML_PDU exp :=
489 tr_OML_ChangeAdmStateACK(NM_OC_BTS, ts_OML_ObjectInstance(0, 255, 255),
490 NM_STATE_LOCKED);
491 f_oml_exp_rx(exp, "Change ADM State ACK");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200492 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100493}
494
495/* test behavior for unsupported placement (!= ONLY) */
496testcase TC_wrong_placement() runs on BSC_OML_CT {
497 f_init_oml(testcasename());
498
499 var OML_FOM_ObjectClass obj_class := NM_OC_BTS
500 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
501
502 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
503
504 pdu.placement := ABIS_OM_PLACEMENT_FIRST;
505 f_oml_send_exp_fail_rep(pdu, "Unexpected response to PLACEMENT_FIRST");
506
507 pdu.placement := ABIS_OM_PLACEMENT_MIDDLE;
508 f_oml_send_exp_fail_rep(pdu, "Unexpected response to PLACEMENT_MIDDLE");
509
510 pdu.placement := ABIS_OM_PLACEMENT_LAST;
511 f_oml_send_exp_fail_rep(pdu, "Unexpected response to PLACEMENT_LAST");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200512 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100513}
514
515/* test behavior for sequence != 0 (invalid if mdisc == ONLY) */
516testcase TC_wrong_seq() runs on BSC_OML_CT {
517 f_init_oml(testcasename());
518
519 var OML_FOM_ObjectClass obj_class := NM_OC_BTS;
520 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
521 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
522
523 OML.clear;
524
525 pdu.sequence := 23;
526 f_oml_send_exp_fail_rep(pdu, "Unexpected response to sequence != 0");
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200527 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100528}
529
530/* test behavior for unsupported obj_class */
531testcase TC_wrong_obj_class() runs on BSC_OML_CT {
532 f_init_oml(testcasename());
533
534 var OML_FOM_ObjectClass obj_class := NM_OC_BTS;
535 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
536 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
537 pdu.u.fom.hdr.obj_class := NM_OC_NULL;
538
539 /* NM_NACK_OBJCLASS_INVAL */
540 f_oml_send_exp_nack(pdu, NM_NACK_OBJCLASS_NOTSUPP);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200541 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100542}
543
544/* test behavior for wrong BTS number in object instance */
545testcase TC_wrong_bts_nr() runs on BSC_OML_CT {
546 f_init_oml(testcasename());
547
548 var OML_FOM_ObjectClass obj_class := NM_OC_BTS;
549 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(250, 255, 255));
550 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
551
552 f_oml_send_exp_nack(pdu, NM_NACK_BTSNR_UNKN);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200553 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100554}
555
556/* test behavior for wrong TRX number in object instance */
557testcase TC_wrong_trx_nr() runs on BSC_OML_CT {
558 f_init_oml(testcasename());
559
560 var OML_FOM_ObjectClass obj_class := NM_OC_RADIO_CARRIER;
561 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 250, 255));
562 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
563
564 f_oml_send_exp_nack(pdu, NM_NACK_TRXNR_UNKN);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200565 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100566}
567
568/* test behavior for wrong TS number in object instance */
569testcase TC_wrong_ts_nr() runs on BSC_OML_CT {
570 f_init_oml(testcasename());
571
572 var OML_FOM_ObjectClass obj_class := NM_OC_RADIO_CARRIER;
573 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 0, 250));
574 var OML_PDU pdu := valueof(ts_OML_ChangeAdmState(obj_class, obj_inst, NM_STATE_LOCKED));
575
576 f_oml_send_exp_nack(pdu, NM_NACK_OBJINST_UNKN);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200577 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100578}
579
580/* RADIO CARRIER: Test OPSTART with SET BTS ATTRIBUTES; expect ACK */
581testcase TC_radio_carrier_opstart() runs on BSC_OML_CT {
582 f_init_oml(testcasename());
583
584 var OML_FOM_ObjectClass obj_class := NM_OC_RADIO_CARRIER;
585 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 0, 255));
586
587 f_oml_radio_attr(0);
588 f_oml_opstart(obj_class, obj_inst);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200589 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100590}
591
592/* RADIO CARRIER: Test OPSTART without SET BTS ATTRIBUTES; expect NACK */
593testcase TC_radio_carrier_opstart_noattr() runs on BSC_OML_CT {
594 f_init_oml(testcasename());
595
596 var OML_FOM_ObjectClass obj_class := NM_OC_RADIO_CARRIER;
597 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 0, 255));
598
599 /* we are *not* setting any attributes here */
600 f_oml_opstart(obj_class, obj_inst, exp_fail := true);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200601 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100602}
603
604
605/* BTS: Test OPSTART after SET BTS ATTRIBUTES; expect ACK */
606testcase TC_bts_opstart() runs on BSC_OML_CT {
607 f_init_oml(testcasename());
608
609 var OML_FOM_ObjectClass obj_class := NM_OC_BTS;
610 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
611
Pau Espin Pedrol006d1952020-10-16 14:18:43 +0200612 alt {
613 [] OML.receive(tr_OML_SwActivatedRep(NM_OC_BTS, ts_OML_ObjectInstance(g_bts_nr, 255, 255))) {
614 setverdict(pass);
615 }
616 [] OML.receive { repeat; }
617 }
618
Pau Espin Pedrol6c864ec2021-06-25 13:52:23 +0200619 f_oml_bts_setattr();
Pau Espin Pedrold0ec1492020-10-16 14:54:14 +0200620 f_oml_opstart(obj_class, obj_inst, false, NM_OPSTATE_ENABLED);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200621 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100622}
623
624
625/* BTS: Test OPSTART without SET BTS ATTRIBUTES; expect NACK */
626testcase TC_bts_opstart_noattr() runs on BSC_OML_CT {
627 f_init_oml(testcasename());
628
629 var OML_FOM_ObjectClass obj_class := NM_OC_BTS;
630 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 255, 255));
631
632 /* we are *not* setting any attributes here */
633 f_oml_opstart(obj_class, obj_inst, exp_fail := true);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200634 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100635}
636
637/* CHANNEL: Test OPSTART after SET CHANNEL ATTRIBUTES; expect ACK */
638testcase TC_ts_opstart() runs on BSC_OML_CT {
639 f_init_oml(testcasename());
640
641 var OML_FOM_ObjectClass obj_class := NM_OC_CHANNEL;
642 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 0, 1));
643
644 f_oml_ts_attr(trx_nr := 0, ts_nr := 1);
645 f_oml_opstart(obj_class, obj_inst);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200646 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100647}
648
649
650/* CHANNEL: Test OPSTART without SET CHANNEL ATTRIBUTES; expect NACK */
651testcase TC_ts_opstart_noattr() runs on BSC_OML_CT {
652 f_init_oml(testcasename());
653
654 var OML_FOM_ObjectClass obj_class := NM_OC_CHANNEL;
655 var OML_FOM_ObjectInstance obj_inst := valueof(ts_OML_ObjectInstance(g_bts_nr, 0, 1));
656
657 /* we are *not* setting any attributes here */
658 f_oml_opstart(obj_class, obj_inst, exp_fail := true);
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200659 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100660}
661
662/* Ensure the initial Event State Change Reports after OML connect match our expectation */
663testcase TC_initial_state_reports() runs on BSC_OML_CT {
664 f_init_oml(testcasename());
665
666 interleave {
667 [] OML.receive(tr_OML_StateChgEvtRep(NM_OC_SITE_MANAGER, ts_OML_ObjectInstance(255, 255, 255),
668 NM_OPSTATE_ENABLED, NM_AVSTATE_OK));
669 [] OML.receive(tr_OML_StateChgEvtRep(NM_OC_BTS, ts_OML_ObjectInstance(0, 255, 255),
670 NM_OPSTATE_DISABLED, NM_AVSTATE_DEPENDENCY));
671 [] OML.receive(tr_OML_StateChgEvtRep(NM_OC_BTS, ts_OML_ObjectInstance(0, 255, 255),
672 NM_OPSTATE_DISABLED, NM_AVSTATE_DEPENDENCY));
673 }
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200674 f_shutdown_helper();
Harald Welteed0c1562019-02-07 20:26:29 +0100675}
676
Vadim Yanitskiyb9a7bbf2020-12-08 19:27:51 +0100677/* Make sure that the IUT sends RSL Connect NACK when the remote is not reachable. */
678testcase TC_ipa_rsl_connect_nack() runs on BSC_OML_CT {
679 timer T := 2.0;
680
681 f_init_oml(testcasename());
682
683 /* Most likely, nobody is listening to this port */
684 OML.send(ts_OML_IPA_RslConnect(0, 65535));
685
686 T.start;
687 alt {
688 [] OML.receive(tr_OML_IPA_MsgType(NM_MT_IPACC_RSL_CONNECT_NACK)) {
689 setverdict(pass);
690 }
691 [] OML.receive(tr_OML_IPA_MsgType(NM_MT_IPACC_RSL_CONNECT_ACK)) {
692 setverdict(fail, "RSL Connect ACK is not expected");
693 }
694 [] OML.receive { repeat; }
695 [] T.timeout {
696 setverdict(fail, "Timeout waiting for RSL Connect NACK");
697 }
698 }
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200699 f_shutdown_helper();
Vadim Yanitskiyb9a7bbf2020-12-08 19:27:51 +0100700}
701
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200702/* Make sure that the IUT forwards Container PCUIF messages between BSC and PCU */
703testcase TC_ipa_osmo_pcu_anr_fwd() runs on BSC_OML_CT {
704 var PCUIF_send_data pcu_sd_msg;
705 var PCUIF_Message msg_rx;
706 timer T := 2.0;
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200707
708 f_init_oml(testcasename());
709 f_init_pcu(PCU, testcasename(), g_pcu_conn_id, g_pcu_last_info);
710 f_oml_getattr();
711
712 log("BTS Features:", g_bts_features);
713 if (lengthof(g_bts_features) < 21 or g_bts_features[20] != '1'B) {
714 setverdict(fail, "Feature ABIS_OSMO_PCU not supported!");
715 }
716
717 IPA_OSMO_PCU.receive(tr_ASP_IPA_EV(ASP_IPA_EVENT_UP));
718 IPA_OSMO_PCU.receive(tr_ASP_IPA_EV(ASP_IPA_EVENT_ID_RESP));
719 IPA_OSMO_PCU.receive(tr_ASP_IPA_EV(ASP_IPA_EVENT_ID_ACK));
720
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700721 /* Sent via A-bis/IPA, received via the PCUIF */
722 var PCUIF_neigh_addr_req naddr_req := {
723 local_lac := f_rnd_int(c_UINT16_MAX),
724 local_ci := f_rnd_int(c_UINT16_MAX),
725 tgt_arfcn := f_rnd_int(c_UINT16_MAX),
726 tgt_bsic := f_rnd_int(63)
727 };
728 template (value) PCUIF_container ts_payloadReq := {
729 msg_type := PCU_IF_MSG_NEIGH_ADDR_REQ,
730 spare := '00'O,
731 len := 0, /* overwritten */
732 u := { neigh_addr_req := naddr_req }
733 };
734 template (present) PCUIF_container tr_payloadReq := {
735 msg_type := PCU_IF_MSG_NEIGH_ADDR_REQ,
736 spare := ?,
737 len := ?,
738 u := { neigh_addr_req := naddr_req }
739 };
740
741 IPA_OSMO_PCU.send(ts_PCUIF_CONTAINER(0, ts_payloadReq))
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200742 T.start;
743 alt {
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700744 [] PCU.receive(t_SD_PCUIF(g_pcu_conn_id, tr_PCUIF_CONTAINER(0, tr_payloadReq))) {
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200745 setverdict(pass);
746 }
747 [] PCU.receive(PCUIF_send_data:?) -> value pcu_sd_msg {
748 setverdict(fail, "Unexpected message received: ", pcu_sd_msg.data, " vs exp: ",
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700749 t_SD_PCUIF(g_pcu_conn_id, tr_PCUIF_CONTAINER(0, tr_payloadReq)));
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200750 }
751 [] T.timeout { setverdict(fail, "Timeout waiting for ANR request on PCU inteface");}
752 }
753 T.stop;
754
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700755 /* Sent via the PCUIF, received via A-bis/IPA */
756 var PCUIF_neigh_addr_cnf naddr_cnf := {
757 orig_req := naddr_req,
758 error_code := 0,
759 mcc := 262,
760 mnc := 42,
761 mnc_3_digits := 0,
762 lac := f_rnd_int(c_UINT16_MAX),
763 rac := f_rnd_int(255),
764 cell_identity := f_rnd_int(c_UINT16_MAX)
765 };
766
767 template (value) PCUIF_container ts_payloadRsp := {
768 msg_type := PCU_IF_MSG_NEIGH_ADDR_CNF,
769 spare := '00'O,
770 len := 0, /* overwritten */
771 u := { neigh_addr_cnf := naddr_cnf }
772 };
773 template (present) PCUIF_container tr_payloadRsp := {
774 msg_type := PCU_IF_MSG_NEIGH_ADDR_CNF,
775 spare := ?,
776 len := ?,
777 u := { neigh_addr_cnf := naddr_cnf }
778 };
779
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200780 /* Send back the response: */
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700781 PCU.send(t_SD_PCUIF(g_pcu_conn_id, ts_PCUIF_CONTAINER(0, ts_payloadRsp)))
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200782 T.start;
783 alt {
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700784 [] IPA_OSMO_PCU.receive(tr_PCUIF_CONTAINER(0, tr_payloadRsp)) {
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200785 setverdict(pass);
786 }
787 [] IPA_OSMO_PCU.receive(PCUIF_Message:?) -> value msg_rx {
788 setverdict(fail, "Unexpected message received: ", msg_rx, " vs exp: ",
Vadim Yanitskiyb2e88432023-03-27 06:12:08 +0700789 tr_PCUIF_CONTAINER(0, tr_payloadRsp));
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200790 }
791 [] T.timeout { setverdict(fail, "Timeout waiting for ANR request on BSC inteface"); }
792 }
Pau Espin Pedrol32dfd942023-04-11 13:57:04 +0200793 f_shutdown_helper();
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200794}
795
Harald Welteed0c1562019-02-07 20:26:29 +0100796
797control {
798 execute( TC_wrong_mdisc() );
799 execute( TC_wrong_msgtype() );
800 execute( TC_short_length() );
801 execute( TC_long_length() );
802 execute( TC_wrong_placement() );
803 execute( TC_wrong_seq() );
804 execute( TC_wrong_obj_class() );
805 execute( TC_wrong_bts_nr() );
806 execute( TC_wrong_trx_nr() );
807 execute( TC_radio_carrier_opstart_noattr() );
808 execute( TC_bts_opstart() );
809 execute( TC_bts_opstart_noattr() );
810 execute( TC_ts_opstart() );
811 execute( TC_ts_opstart_noattr() );
812 execute( TC_initial_state_reports() );
Vadim Yanitskiyb9a7bbf2020-12-08 19:27:51 +0100813 execute( TC_ipa_rsl_connect_nack() );
Pau Espin Pedrol65d712e2021-06-25 13:55:38 +0200814
815 execute( TC_ipa_osmo_pcu_anr_fwd() );
Harald Welteed0c1562019-02-07 20:26:29 +0100816}
817
818/* BTS:
819 * - Evt: Disabled/Locked
820 * - SW ACT
821 * - Evt: Disabled/Dependency
822 * - SET BTS ATTR
823 * - Opstart
824 * - Chg Adm State Unlocked
825 * - Evt: Disabled/Dependency/Unlocked
826 * - Evt: Enabled/0 (after last channel unlocked?)
827 */
828
829/* Radio Carrier:
830 * - Evt: Disabled/Offline after SW ACT
831 * - Set Radio Carrier Attributes ? (->NACL)
832 * - Evt: Disabled/Dependency
833 * - Set Radio Carrier Attributes ?
834 * - Opstart
835 * - Chg Adm State Unlocked
836 * - Evt:
837 */
838
839/* Baseband Transceiver:
840 * - Evt: Disabled/Locked
841 * - SW Activation
842 * - Evt: Disabled/Dependency after SW ACT
843 * - IPA RSL Connect
844 * - Opstart
845 * - Chg Admin Unlocked
846 * - Evt: Disabled/Dependency/Unlocked
847 */
848
849/* Channel:
850 * - Evt: Not Installed/Locked
851 * - Evt: Disabled/Dependency (after SW ACT Rep on BB Transc)
852 * - Set Channel Attr
853 * - Opstart
854 * - Evt: Disabled/Offline
855 * - Chg Admin Unlocked
856 * - Evt: Disabled/OK/Unlocked
857 * - Evt: Enabled/OK (after BB TRANSC Opstart)
858 */
859
860};