Harald Welte | 34b5a95 | 2019-05-27 11:54:11 +0200 | [diff] [blame] | 1 | /* Osmocom utility type definitions in TTCN-3 |
| 2 | * (C) 2017-2019 Harald Welte <laforge@gnumonks.org> |
| 3 | * All rights reserved. |
| 4 | * |
| 5 | * Released under the terms of GNU General Public License, Version 2 or |
| 6 | * (at your option) any later version. |
| 7 | * |
| 8 | * SPDX-License-Identifier: GPL-2.0-or-later |
| 9 | */ |
| 10 | |
Harald Welte | 615bd54 | 2017-07-14 18:28:55 +0200 | [diff] [blame] | 11 | module Osmocom_Types { |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 12 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 13 | import from General_Types all; |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 14 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 15 | type integer uint8_t (0..255) with { variant "unsigned 8 bit" }; |
| 16 | type integer uint16_t (0..65535) with { variant "unsigned 16 bit" }; |
| 17 | type integer uint24_t (0..16777215) with { variant "unsigned 24 bit" }; |
| 18 | type integer uint32_t (0..4294967295) with { variant "unsigned 32 bit" }; |
Harald Welte | ddeaa57 | 2017-07-14 18:58:07 +0200 | [diff] [blame] | 19 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 20 | type integer int8_t (-128..127) with { variant "8 bit" }; |
| 21 | type integer int16_t (-32768..32767) with { variant "16 bit" }; |
Harald Welte | ddeaa57 | 2017-07-14 18:58:07 +0200 | [diff] [blame] | 22 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 23 | type integer uint1_t (0..1) with { variant "unsigned 1 bit" }; |
| 24 | type integer uint2_t (0..3) with { variant "unsigned 2 bit" }; |
| 25 | type integer uint3_t (0..7) with { variant "unsigned 3 bit" }; |
| 26 | type integer uint4_t (0..15) with { variant "unsigned 4 bit" }; |
| 27 | type integer uint5_t (0..31) with { variant "unsigned 5 bit" }; |
| 28 | type integer uint6_t (0..63) with { variant "unsigned 6 bit" }; |
| 29 | type integer uint7_t (0..127) with { variant "unsigned 7 bit" }; |
| 30 | type integer uint9_t (0..511) with { variant "unsigned 9 bit" }; |
| 31 | type integer uint10_t (0..1023) with { variant "unsigned 10 bit" }; |
| 32 | type integer uint11_t (0..2047) with { variant "unsigned 11 bit" }; |
| 33 | type integer uint12_t (0..4095) with { variant "unsigned 12 bit" }; |
| 34 | type integer uint13_t (0..8191) with { variant "unsigned 13 bit" }; |
| 35 | type integer uint14_t (0..16383) with { variant "unsigned 14 bit" }; |
| 36 | type integer uint15_t (0..32767) with { variant "unsigned 15 bit" }; |
| 37 | type integer uint40_t (0..1099511627776) with { variant "unsigned 40 bit" }; |
Harald Welte | ddeaa57 | 2017-07-14 18:58:07 +0200 | [diff] [blame] | 38 | |
Harald Welte | 0236980 | 2018-02-25 12:39:05 +0100 | [diff] [blame] | 39 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 40 | const uint16_t c_UINT16_MAX := 65535; |
| 41 | const uint32_t c_UINT32_MAX := 4294967295; |
Harald Welte | 0236980 | 2018-02-25 12:39:05 +0100 | [diff] [blame] | 42 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 43 | /* CSN.1 L/H placeholders */ |
| 44 | const BIT1 CSN1_L := '0'B; |
| 45 | const BIT1 CSN1_H := '1'B; |
Vadim Yanitskiy | 12cf3d9 | 2020-05-05 00:19:50 +0700 | [diff] [blame] | 46 | |
Alexander Couzens | e0f7c54 | 2020-09-13 17:25:18 +0200 | [diff] [blame] | 47 | /* based on Linux */ |
| 48 | type enumerated AddressFamily { |
| 49 | AF_UNSPEC ('00'O), |
| 50 | AF_INET ('02'O), |
| 51 | AF_INET6 ('0a'O) |
| 52 | } |
| 53 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 54 | /* return random integer 0 <= ret < max. According to ETSI ES 201 873 C.6.1, rnd() returns *less* than 1, so |
| 55 | * the returned int will always be ret < max, or ret <= (max-1). */ |
| 56 | function f_rnd_int(integer max) return integer { |
| 57 | return float2int(rnd()*int2float(max)); |
| 58 | } |
| 59 | |
| 60 | /* return hexstring composed of random digits */ |
| 61 | function f_rnd_hexstring(in integer len, in integer max := 15) return hexstring { |
| 62 | var integer i; |
| 63 | var hexstring ret := ''H; |
| 64 | for (i := 0; i < len; i := i + 1) { |
| 65 | ret := ret & int2hex(f_rnd_int(max), 1); |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 66 | } |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 67 | return ret; |
| 68 | } |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 69 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 70 | /* return octetstring composed of random bytes */ |
| 71 | function f_rnd_octstring(in integer len) return octetstring { |
| 72 | var integer i; |
| 73 | var octetstring ret := ''O; |
| 74 | for (i := 0; i < len; i := i + 1) { |
| 75 | ret := ret & int2oct(f_rnd_int(255), 1); |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 76 | } |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 77 | return ret; |
| 78 | } |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 79 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 80 | /* return bitstring composed of random bits */ |
| 81 | function f_rnd_bitstring(in integer len) return bitstring { |
| 82 | var octetstring oct := f_rnd_octstring(len / 8 + 1); |
| 83 | return substr(oct2bit(oct), 0, len); |
| 84 | } |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 85 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 86 | function f_rnd_imsi(in hexstring prefix) return hexstring { |
| 87 | return prefix & f_rnd_hexstring(15 - lengthof(prefix), 9); |
| 88 | } |
Vadim Yanitskiy | a01a055 | 2020-07-20 17:47:18 +0700 | [diff] [blame] | 89 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 90 | function f_rnd_msisdn(in octetstring prefix, integer len := 6) return octetstring { |
| 91 | return prefix & f_rnd_octstring(len - lengthof(prefix)); |
| 92 | } |
Harald Welte | 9182704 | 2018-01-25 09:20:04 +0100 | [diff] [blame] | 93 | |
Alexander Couzens | 4231de6 | 2020-09-11 19:52:15 +0200 | [diff] [blame] | 94 | function f_sleep(float seconds) { |
| 95 | timer T := seconds; |
| 96 | T.start; |
| 97 | T.timeout; |
| 98 | } |
Harald Welte | c2461d6 | 2018-01-26 18:55:00 +0100 | [diff] [blame] | 99 | |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 100 | function bool2bit(boolean inp) return BIT1 { |
| 101 | if (inp) { |
| 102 | return '1'B; |
| 103 | } else { |
| 104 | return '0'B; |
| 105 | } |
| 106 | } |
| 107 | |
| 108 | function bool2bit_tmpl(template boolean inp) return template BIT1 { |
| 109 | if (istemplatekind(inp, "omit")) { |
| 110 | return omit; |
| 111 | } else if (istemplatekind(inp, "*")) { |
| 112 | return *; |
| 113 | } else if (istemplatekind(inp, "?")) { |
Harald Welte | b596c18 | 2018-02-16 18:12:59 +0100 | [diff] [blame] | 114 | return ?; |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 115 | } else { |
| 116 | if (valueof(inp)) { |
| 117 | return '1'B; |
| 118 | } else { |
| 119 | return '0'B; |
| 120 | } |
| 121 | } |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 122 | } |
| 123 | |
Harald Welte | 262f122 | 2018-02-25 16:33:38 +0100 | [diff] [blame] | 124 | type record of integer IntegerRecord; |
| 125 | |
| 126 | function int2bool(integer int) return boolean { |
| 127 | if (int != 0) { |
| 128 | return true; |
| 129 | } else { |
| 130 | return false; |
| 131 | } |
| 132 | } |
| 133 | |
| 134 | function f_array_contains(IntegerRecord arr, integer key) return boolean { |
| 135 | for (var integer i:= 0; i< sizeof(arr); i := i + 1) { |
| 136 | if (arr[i] == key) { |
| 137 | return true; |
| 138 | } |
| 139 | } |
| 140 | return false; |
| 141 | } |
| 142 | |
Harald Welte | c3a3f45 | 2018-02-26 17:37:47 +0100 | [diff] [blame] | 143 | /* re-start given timer in a warning-safe way: Stop (only if running) + start */ |
| 144 | function f_timer_safe_restart(timer T) { |
| 145 | if (T.running) { |
| 146 | T.stop; |
| 147 | } |
| 148 | T.start; |
| 149 | } |
| 150 | |
Harald Welte | 060e27a | 2018-03-03 20:38:19 +0100 | [diff] [blame] | 151 | /* divide two integers and return rounded-up result */ |
| 152 | function f_div_round_up(integer dividend, integer divisor) return integer { |
| 153 | var integer x := dividend / divisor; |
| 154 | if (dividend rem divisor != 0) { |
| 155 | x := x+1; |
| 156 | } |
| 157 | return x; |
| 158 | } |
| 159 | |
Harald Welte | 07d99c8 | 2019-05-02 18:33:16 +0200 | [diff] [blame] | 160 | function imsi_hex2oct(hexstring imsi) return octetstring { |
| 161 | var hexstring tmp := ''H; |
| 162 | var octetstring ret; |
| 163 | var integer i; |
| 164 | |
| 165 | /* swap nibbles and pad with F if insufficient input nibbles */ |
| 166 | for (i := 0; i < lengthof(imsi); i := i+1) { |
| 167 | if (i+1 < lengthof(imsi)) { |
| 168 | tmp := tmp & imsi[i+1]; |
| 169 | } else { |
| 170 | tmp := tmp & 'F'H; |
| 171 | } |
| 172 | tmp := tmp & imsi[i]; |
| 173 | i := i+1; |
| 174 | } |
| 175 | ret := hex2oct(tmp); |
| 176 | return ret; |
| 177 | } |
| 178 | |
Harald Welte | bb9512e | 2019-05-30 15:06:12 +0200 | [diff] [blame] | 179 | function f_pad_oct(octetstring str, integer len, OCT1 pad) return octetstring { |
| 180 | var integer strlen := lengthof(str); |
| 181 | for (var integer i := 0; i < len-strlen; i := i+1) { |
| 182 | str := str & pad; |
| 183 | } |
| 184 | return str; |
| 185 | } |
| 186 | |
Vadim Yanitskiy | a01a055 | 2020-07-20 17:47:18 +0700 | [diff] [blame] | 187 | function f_pad_bit(bitstring str, integer len, BIT1 pad) return bitstring { |
| 188 | var integer strlen := lengthof(str); |
| 189 | for (var integer i := 0; i < len-strlen; i := i+1) { |
| 190 | str := str & pad; |
| 191 | } |
| 192 | return str; |
| 193 | } |
| 194 | |
Vadim Yanitskiy | a52347c | 2019-12-12 17:32:33 +0900 | [diff] [blame] | 195 | function f_pad_bcd_number(hexstring number) return hexstring { |
| 196 | if (lengthof(number) mod 2 != 0) { |
| 197 | return number & 'F'H; |
| 198 | } else { |
| 199 | return number; |
| 200 | } |
| 201 | } |
| 202 | |
Vadim Yanitskiy | 6f9f7d2 | 2020-08-26 02:53:10 +0700 | [diff] [blame] | 203 | /* like L1SAP_IS_PACKET_RACH */ |
| 204 | function ra_is_ps(OCT1 ra) return boolean { |
| 205 | if ((ra and4b 'F0'O == '70'O) and (ra and4b '0F'O != '0F'O)) { |
| 206 | return true; |
| 207 | } |
| 208 | return false; |
| 209 | } |
| 210 | |
| 211 | function ra_is_emerg(OCT1 ra) return boolean { |
| 212 | /* See also: 3GPP TS 04.08, Table 9.9, ra=101xxxxx */ |
Vadim Yanitskiy | 146efe6 | 2020-08-31 02:13:56 +0700 | [diff] [blame] | 213 | return (ra and4b 'E0'O == 'A0'O); |
Vadim Yanitskiy | 6f9f7d2 | 2020-08-26 02:53:10 +0700 | [diff] [blame] | 214 | } |
| 215 | |
| 216 | /* generate a random RACH for circuit-switched */ |
| 217 | function f_rnd_ra_cs() return OCT1 { |
| 218 | var OCT1 ra; |
| 219 | do { |
| 220 | ra := f_rnd_octstring(1); |
Vadim Yanitskiy | 27057e0 | 2020-08-29 16:16:52 +0700 | [diff] [blame] | 221 | } while (ra_is_ps(ra) or ra_is_emerg(ra)); |
Vadim Yanitskiy | 6f9f7d2 | 2020-08-26 02:53:10 +0700 | [diff] [blame] | 222 | return ra; |
| 223 | } |
| 224 | |
| 225 | /* generate a random RACH for emergency */ |
| 226 | function f_rnd_ra_emerg() return OCT1 { |
| 227 | var OCT1 ra; |
| 228 | do { |
| 229 | ra := f_rnd_octstring(1); |
| 230 | } while (not ra_is_emerg(ra)); |
| 231 | return ra; |
| 232 | } |
| 233 | |
| 234 | /* generate a random RACH for packet-switched */ |
| 235 | function f_rnd_ra_ps() return OCT1 { |
| 236 | var OCT1 ra; |
| 237 | do { |
| 238 | ra := f_rnd_octstring(1); |
| 239 | } while (not ra_is_ps(ra)); |
| 240 | return ra; |
| 241 | } |
| 242 | |
| 243 | /* generate a random 11-bit RA (packet-switched only) */ |
| 244 | function f_rnd_ra11_ps() return BIT11 { |
| 245 | var integer ra11 := f_rnd_int(bit2int('11111111111'B)); |
| 246 | return int2bit(ra11, 11); |
| 247 | } |
| 248 | |
Harald Welte | c7adaa7 | 2018-02-15 20:40:36 +0100 | [diff] [blame] | 249 | |
Harald Welte | 69b3a48 | 2020-11-12 17:25:49 +0100 | [diff] [blame] | 250 | private function f_concat_pad(integer tot_len, hexstring prefix, integer suffix) return hexstring { |
| 251 | var integer suffix_len := tot_len - lengthof(prefix); |
| 252 | var charstring suffix_ch := int2str(suffix); |
| 253 | var integer pad_len := suffix_len - lengthof(suffix_ch); |
| 254 | |
| 255 | return prefix & int2hex(0, pad_len) & str2hex(suffix_ch); |
| 256 | } |
| 257 | |
| 258 | function f_gen_imei(integer suffix) return hexstring { |
| 259 | return f_concat_pad(14, '49999'H, suffix); |
| 260 | } |
| 261 | |
| 262 | function f_gen_imsi(integer suffix) return hexstring { |
| 263 | return f_concat_pad(15, '26242'H, suffix); |
| 264 | } |
| 265 | |
| 266 | function f_gen_msisdn(integer suffix) return hexstring { |
| 267 | return f_concat_pad(12, '49123'H, suffix); |
| 268 | } |
| 269 | |
Harald Welte | bf39761 | 2021-01-14 20:39:46 +0100 | [diff] [blame] | 270 | function f_gen_tmsi(integer suffix, integer nri_v := 0, integer nri_bitlen := 10, |
| 271 | OCT4 base_tmsi := '42000023'O) return OCT4 { |
| 272 | var integer tmsi_int := oct2int(base_tmsi) + suffix; |
| 273 | var bitstring base_tmsi_bits := int2bit(tmsi_int, 32); |
| 274 | var bitstring prefix_bits := substr(base_tmsi_bits, 0, 8); |
| 275 | var bitstring suffix_bits := substr(base_tmsi_bits, 8 + nri_bitlen, 24 - nri_bitlen); |
| 276 | var bitstring total_bits := prefix_bits & int2bit(nri_v, nri_bitlen) & suffix_bits; |
| 277 | var OCT4 tmsi := bit2oct(total_bits); |
| 278 | |
| 279 | log("f_gen_tmsi(suffix:=", suffix, ", nri_v:=", nri_v, ", nri_bitlen:=", nri_bitlen, |
| 280 | ", base_tmsi:=", base_tmsi, ") -> prefix:=", prefix_bits, ", suffix:=", suffix_bits, |
| 281 | "total_bits:=", total_bits, " == ", tmsi); |
| 282 | |
| 283 | return tmsi; |
| 284 | } |
Harald Welte | 69b3a48 | 2020-11-12 17:25:49 +0100 | [diff] [blame] | 285 | |
| 286 | |
Harald Welte | 615bd54 | 2017-07-14 18:28:55 +0200 | [diff] [blame] | 287 | } with { encode "RAW"; variant "FIELDORDER(msb)" } |