blob: 7ccd918a97901471a579413a9d6b554c3434f75a [file] [log] [blame]
Neels Hofmeyr17518fe2017-06-20 04:35:06 +02001/*! \file gsm_08_58.h
2 * GSM Radio Signalling Link messages on the A-bis interface.
Harald Welteec8b4502010-02-20 20:34:29 +01003 * 3GPP TS 08.58 version 8.6.0 Release 1999 / ETSI TS 100 596 V8.6.0 */
Neels Hofmeyr17518fe2017-06-20 04:35:06 +02004/*
5 * (C) 2008 by Harald Welte <laforge@gnumonks.org>
Harald Welteec8b4502010-02-20 20:34:29 +01006 * 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 *
Harald Welteec8b4502010-02-20 20:34:29 +010018 */
19
Neels Hofmeyr17518fe2017-06-20 04:35:06 +020020#pragma once
21
Harald Welteec8b4502010-02-20 20:34:29 +010022#include <stdint.h>
23
Pau Espin Pedrol42908032018-10-10 17:04:28 +020024#include <osmocom/core/endian.h>
25
Harald Welte8f2c7e52011-08-17 18:52:03 +020026/*! \addtogroup rsl
27 * @{
Neels Hofmeyr17518fe2017-06-20 04:35:06 +020028 * \file gsm_08_58.h */
Harald Welte8f2c7e52011-08-17 18:52:03 +020029
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020030/* Channel Number 9.3.1 */
31union abis_rsl_chan_nr {
32#if OSMO_IS_BIG_ENDIAN
33 uint8_t cbits:5,
34 tn:3;
35#elif OSMO_IS_LITTLE_ENDIAN
36 uint8_t tn:3,
37 cbits:5;
38#endif
39 uint8_t chan_nr;
40} __attribute__ ((packed));
41#define ABIS_RSL_CHAN_NR_CBITS_Bm_ACCHs 0x01
42#define ABIS_RSL_CHAN_NR_CBITS_Lm_ACCHs(ss) (0x02 + (ss))
43#define ABIS_RSL_CHAN_NR_CBITS_SDCCH4_ACCH(ss) (0x04 + (ss))
44#define ABIS_RSL_CHAN_NR_CBITS_SDCCH8_ACCH(ss) (0x08 + (ss))
45#define ABIS_RSL_CHAN_NR_CBITS_BCCH 0x10
46#define ABIS_RSL_CHAN_NR_CBITS_RACH 0x11
47#define ABIS_RSL_CHAN_NR_CBITS_PCH_AGCH 0x12
48#define ABIS_RSL_CHAN_NR_CBITS_OSMO_PDCH 0x18 /*< non-standard, for dyn TS */
Harald Weltea8d7ebb2019-05-27 16:51:23 +020049#define ABIS_RSL_CHAN_NR_CBITS_OSMO_CBCH4 0x19 /*< non-standard, for CBCH/SDCCH4 */
50#define ABIS_RSL_CHAN_NR_CBITS_OSMO_CBCH8 0x1a /*< non-standard, for CBCH/SDCCH8 */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020051
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +020052/* non-standard, Osmocom specific Bm/Lm equivalents for VAMOS */
53#define ABIS_RSL_CHAN_NR_CBITS_OSMO_VAMOS_Bm_ACCHs 0x1d /*< VAMOS TCH/F */
54#define ABIS_RSL_CHAN_NR_CBITS_OSMO_VAMOS_Lm_ACCHs(ss) (0x1e + (ss)) /*< VAMOS TCH/H */
55
Pau Espin Pedrol42908032018-10-10 17:04:28 +020056/* Link Identifier 9.3.2 */
57union abis_rsl_link_id {
58#if OSMO_IS_BIG_ENDIAN
59 uint8_t cbits:2,
60 na:1,
Martin Haukee63b8872018-11-15 14:53:13 +010061 reserved:2,
Pau Espin Pedrol42908032018-10-10 17:04:28 +020062 sapi:3;
63#elif OSMO_IS_LITTLE_ENDIAN
64 uint8_t sapi:3,
65 reserved:2,
66 na:1,
67 cbits:2;
68#endif
69 uint8_t link_id;
70} __attribute__ ((packed));
71#define ABIS_RSL_LINK_ID_CBITS_FACCH_SDCCH 0x00
72#define ABIS_RSL_LINK_ID_CBITS_SACCH 0x01
73
Neels Hofmeyr87e45502017-06-20 00:17:59 +020074/*! RSL common header */
Harald Welteec8b4502010-02-20 20:34:29 +010075struct abis_rsl_common_hdr {
Neels Hofmeyr87e45502017-06-20 00:17:59 +020076 uint8_t msg_discr; /*!< message discriminator (ABIS_RSL_MDISC_*) */
77 uint8_t msg_type; /*!< message type (\ref abis_rsl_msgtype) */
78 uint8_t data[0]; /*!< actual payload data */
Harald Welteec8b4502010-02-20 20:34:29 +010079} __attribute__ ((packed));
80
Neels Hofmeyr87e45502017-06-20 00:17:59 +020081/* RSL RLL header (Chapter 8.3) */
Harald Welteec8b4502010-02-20 20:34:29 +010082struct abis_rsl_rll_hdr {
83 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +020084 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020085 union {
86 uint8_t chan_nr; /* API backward compat */
87 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
88 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +020089 uint8_t ie_link_id; /*!< \ref RSL_IE_LINK_IDENT (tag) */
Pau Espin Pedrol42908032018-10-10 17:04:28 +020090 union {
91 uint8_t link_id; /* API backward compat */
92 union abis_rsl_link_id link_id_fields; /*!< RSL link identifier (value) */
93 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +020094 uint8_t data[0]; /*!< message payload data */
Harald Welteec8b4502010-02-20 20:34:29 +010095} __attribute__ ((packed));
96
Neels Hofmeyr87e45502017-06-20 00:17:59 +020097/* RSL Dedicated Channel header (Chapter 8.3 and 8.4) */
Harald Welteec8b4502010-02-20 20:34:29 +010098struct abis_rsl_dchan_hdr {
99 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200100 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +0200101 union {
102 uint8_t chan_nr; /* API backward compat */
103 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
104 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200105 uint8_t data[0]; /*!< message payload data */
Harald Welteec8b4502010-02-20 20:34:29 +0100106} __attribute__ ((packed));
107
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200108/* RSL Common Channel header (Chapter 8.5) */
Harald Welte6eb7d6c2010-07-13 13:48:13 +0200109struct abis_rsl_cchan_hdr {
110 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200111 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +0200112 union {
113 uint8_t chan_nr; /* API backward compat */
114 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
115 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200116 uint8_t data[0]; /*!< message payload data */
Harald Welte6eb7d6c2010-07-13 13:48:13 +0200117} __attribute__ ((packed));
118
Philipp Maier439ddbe2020-11-16 17:49:34 +0100119/* Osmocom specific IE to negotiate repeated ACCH capabilities */
120struct abis_rsl_osmo_rep_acch_cap {
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100121#if OSMO_IS_LITTLE_ENDIAN
Philipp Maier55ce87d2021-08-31 09:24:37 +0200122 uint8_t dl_facch_cmd:1,
123 dl_facch_all:1,
124 dl_sacch:1,
125 ul_sacch:1,
126 rxqual:3,
127 reserved:1;
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100128#elif OSMO_IS_BIG_ENDIAN
129/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
130 uint8_t reserved:1, rxqual:3, ul_sacch:1, dl_sacch:1, dl_facch_all:1, dl_facch_cmd:1;
Philipp Maier439ddbe2020-11-16 17:49:34 +0100131#endif
132} __attribute__ ((packed));
Harald Welteec8b4502010-02-20 20:34:29 +0100133
Philipp Maier0e44a722021-08-30 10:51:52 +0200134/* Osmocom specific IE to negotiate temporary overpower of ACCH channels */
135struct abis_rsl_osmo_temp_ovp_acch_cap {
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100136#if OSMO_IS_LITTLE_ENDIAN
Vadim Yanitskiy8db64ee2021-10-20 14:36:18 +0300137 uint8_t overpower_db:3,
138 rxqual:3,
139 facch_enable:1,
140 sacch_enable:1;
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100141#elif OSMO_IS_BIG_ENDIAN
142/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
143 uint8_t sacch_enable:1, facch_enable:1, rxqual:3, overpower_db:3;
Vadim Yanitskiy8db64ee2021-10-20 14:36:18 +0300144#endif
Philipp Maier0e44a722021-08-30 10:51:52 +0200145} __attribute__ ((packed));
146
Harald Welteec8b4502010-02-20 20:34:29 +0100147/* Chapter 9.1 */
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200148/* RSL Message Discriminator: RLL */
Harald Welteec8b4502010-02-20 20:34:29 +0100149#define ABIS_RSL_MDISC_RLL 0x02
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200150/* RSL Message Discriminator: Dedicated Channel */
Harald Welteec8b4502010-02-20 20:34:29 +0100151#define ABIS_RSL_MDISC_DED_CHAN 0x08
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200152/* RSL Message Discriminator: Common Channel */
Harald Welteec8b4502010-02-20 20:34:29 +0100153#define ABIS_RSL_MDISC_COM_CHAN 0x0c
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200154/* RSL Message Discriminator: TRX Management */
Harald Welteec8b4502010-02-20 20:34:29 +0100155#define ABIS_RSL_MDISC_TRX 0x10
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200156/* RSL Message Discriminator: Location Service */
Harald Welteec8b4502010-02-20 20:34:29 +0100157#define ABIS_RSL_MDISC_LOC 0x20
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200158/* RSL Message Discriminator: ip.access */
Harald Welteec8b4502010-02-20 20:34:29 +0100159#define ABIS_RSL_MDISC_IPACCESS 0x7e
160#define ABIS_RSL_MDISC_TRANSP 0x01
161
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200162/* Check if given RSL message discriminator is transparent */
Harald Welteec8b4502010-02-20 20:34:29 +0100163#define ABIS_RSL_MDISC_IS_TRANSP(x) (x & 0x01)
164
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200165/* RSL Message Type (Chapter 9.1) */
Harald Welteec8b4502010-02-20 20:34:29 +0100166enum abis_rsl_msgtype {
167 /* Radio Link Layer Management */
168 RSL_MT_DATA_REQ = 0x01,
169 RSL_MT_DATA_IND,
170 RSL_MT_ERROR_IND,
171 RSL_MT_EST_REQ,
172 RSL_MT_EST_CONF,
173 RSL_MT_EST_IND,
174 RSL_MT_REL_REQ,
175 RSL_MT_REL_CONF,
176 RSL_MT_REL_IND,
177 RSL_MT_UNIT_DATA_REQ,
178 RSL_MT_UNIT_DATA_IND, /* 0x0b */
Andreas Eversberg816e24c2010-06-25 02:50:56 +0200179 RSL_MT_SUSP_REQ, /* non-standard elements */
180 RSL_MT_SUSP_CONF,
181 RSL_MT_RES_REQ,
182 RSL_MT_RECON_REQ, /* 0x0f */
Harald Welteec8b4502010-02-20 20:34:29 +0100183
184 /* Common Channel Management / TRX Management */
185 RSL_MT_BCCH_INFO = 0x11,
186 RSL_MT_CCCH_LOAD_IND,
187 RSL_MT_CHAN_RQD,
188 RSL_MT_DELETE_IND,
189 RSL_MT_PAGING_CMD,
190 RSL_MT_IMMEDIATE_ASSIGN_CMD,
191 RSL_MT_SMS_BC_REQ,
Harald Welte6eb7d6c2010-07-13 13:48:13 +0200192 RSL_MT_CHAN_CONF, /* non-standard element */
Harald Welteec8b4502010-02-20 20:34:29 +0100193 /* empty */
194 RSL_MT_RF_RES_IND = 0x19,
195 RSL_MT_SACCH_FILL,
196 RSL_MT_OVERLOAD,
197 RSL_MT_ERROR_REPORT,
198 RSL_MT_SMS_BC_CMD,
199 RSL_MT_CBCH_LOAD_IND,
200 RSL_MT_NOT_CMD, /* 0x1f */
201
202 /* Dedicate Channel Management */
203 RSL_MT_CHAN_ACTIV = 0x21,
204 RSL_MT_CHAN_ACTIV_ACK,
205 RSL_MT_CHAN_ACTIV_NACK,
206 RSL_MT_CONN_FAIL,
207 RSL_MT_DEACTIVATE_SACCH,
208 RSL_MT_ENCR_CMD,
209 RSL_MT_HANDO_DET,
210 RSL_MT_MEAS_RES,
211 RSL_MT_MODE_MODIFY_REQ,
212 RSL_MT_MODE_MODIFY_ACK,
213 RSL_MT_MODE_MODIFY_NACK,
214 RSL_MT_PHY_CONTEXT_REQ,
215 RSL_MT_PHY_CONTEXT_CONF,
216 RSL_MT_RF_CHAN_REL,
217 RSL_MT_MS_POWER_CONTROL,
218 RSL_MT_BS_POWER_CONTROL, /* 0x30 */
219 RSL_MT_PREPROC_CONFIG,
220 RSL_MT_PREPROC_MEAS_RES,
221 RSL_MT_RF_CHAN_REL_ACK,
222 RSL_MT_SACCH_INFO_MODIFY,
223 RSL_MT_TALKER_DET,
224 RSL_MT_LISTENER_DET,
225 RSL_MT_REMOTE_CODEC_CONF_REP,
226 RSL_MT_RTD_REP,
227 RSL_MT_PRE_HANDO_NOTIF,
228 RSL_MT_MR_CODEC_MOD_REQ,
229 RSL_MT_MR_CODEC_MOD_ACK,
230 RSL_MT_MR_CODEC_MOD_NACK,
231 RSL_MT_MR_CODEC_MOD_PER,
232 RSL_MT_TFO_REP,
233 RSL_MT_TFO_MOD_REQ, /* 0x3f */
234 RSL_MT_LOCATION_INFO = 0x41,
235
236 /* ip.access specific RSL message types */
237 RSL_MT_IPAC_DIR_RETR_ENQ = 0x40,
238 RSL_MT_IPAC_PDCH_ACT = 0x48,
239 RSL_MT_IPAC_PDCH_ACT_ACK,
240 RSL_MT_IPAC_PDCH_ACT_NACK,
241 RSL_MT_IPAC_PDCH_DEACT = 0x4b,
242 RSL_MT_IPAC_PDCH_DEACT_ACK,
243 RSL_MT_IPAC_PDCH_DEACT_NACK,
244 RSL_MT_IPAC_CONNECT_MUX = 0x50,
245 RSL_MT_IPAC_CONNECT_MUX_ACK,
246 RSL_MT_IPAC_CONNECT_MUX_NACK,
247 RSL_MT_IPAC_BIND_MUX = 0x53,
248 RSL_MT_IPAC_BIND_MUX_ACK,
249 RSL_MT_IPAC_BIND_MUX_NACK,
250 RSL_MT_IPAC_DISC_MUX = 0x56,
251 RSL_MT_IPAC_DISC_MUX_ACK,
252 RSL_MT_IPAC_DISC_MUX_NACK,
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400253 RSL_MT_IPAC_MEAS_PREPROC_DFT = 0x60, /*Extented Common Channel Management */
254 RSL_MT_IPAC_HO_CAN_ENQ = 0x61,
255 RSL_MT_IPAC_HO_CAN_RES = 0x62,
Harald Welteec8b4502010-02-20 20:34:29 +0100256 RSL_MT_IPAC_CRCX = 0x70, /* Bind to local BTS RTP port */
257 RSL_MT_IPAC_CRCX_ACK,
258 RSL_MT_IPAC_CRCX_NACK,
259 RSL_MT_IPAC_MDCX = 0x73,
260 RSL_MT_IPAC_MDCX_ACK,
261 RSL_MT_IPAC_MDCX_NACK,
262 RSL_MT_IPAC_DLCX_IND = 0x76,
263 RSL_MT_IPAC_DLCX = 0x77,
264 RSL_MT_IPAC_DLCX_ACK,
265 RSL_MT_IPAC_DLCX_NACK,
Harald Weltef9456892019-09-03 13:56:00 +0200266
267 RSL_MT_OSMO_ETWS_CMD = 0x7f,
Harald Welteec8b4502010-02-20 20:34:29 +0100268};
269
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200270/*! Siemens vendor-specific RSL message types */
Harald Welteec8b4502010-02-20 20:34:29 +0100271enum abis_rsl_msgtype_siemens {
272 RSL_MT_SIEMENS_MRPCI = 0x41,
273 RSL_MT_SIEMENS_INTRAC_HO_COND_IND = 0x42,
274 RSL_MT_SIEMENS_INTERC_HO_COND_IND = 0x43,
275 RSL_MT_SIEMENS_FORCED_HO_REQ = 0x44,
276 RSL_MT_SIEMENS_PREF_AREA_REQ = 0x45,
277 RSL_MT_SIEMENS_PREF_AREA = 0x46,
278 RSL_MT_SIEMENS_START_TRACE = 0x47,
279 RSL_MT_SIEMENS_START_TRACE_ACK = 0x48,
280 RSL_MT_SIEMENS_STOP_TRACE = 0x49,
281 RSL_MT_SIEMENS_TRMR = 0x4a,
282 RSL_MT_SIEMENS_HO_FAIL_IND = 0x4b,
283 RSL_MT_SIEMENS_STOP_TRACE_ACK = 0x4c,
284 RSL_MT_SIEMENS_UPLF = 0x4d,
285 RSL_MT_SIEMENS_UPLB = 0x4e,
286 RSL_MT_SIEMENS_SET_SYS_INFO_10 = 0x4f,
287 RSL_MT_SIEMENS_MODIF_COND_IND = 0x50,
288};
289
Pau Espin Pedrol95959a82018-04-21 22:47:54 +0200290/*! Ericsson vendor-specific RSL message types */
291enum abis_rsl_msgtype_ericsson {
292 RSL_MT_ERICSSON_IMM_ASS_SENT = 0x10,
293};
294
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200295/*! RSL Information Element Identifiers (Chapter 9.3) */
Harald Welteec8b4502010-02-20 20:34:29 +0100296enum abis_rsl_ie {
297 RSL_IE_CHAN_NR = 0x01,
298 RSL_IE_LINK_IDENT,
299 RSL_IE_ACT_TYPE,
300 RSL_IE_BS_POWER,
301 RSL_IE_CHAN_IDENT,
302 RSL_IE_CHAN_MODE,
303 RSL_IE_ENCR_INFO,
304 RSL_IE_FRAME_NUMBER,
305 RSL_IE_HANDO_REF,
306 RSL_IE_L1_INFO,
307 RSL_IE_L3_INFO,
308 RSL_IE_MS_IDENTITY,
309 RSL_IE_MS_POWER,
310 RSL_IE_PAGING_GROUP,
311 RSL_IE_PAGING_LOAD,
312 RSL_IE_PYHS_CONTEXT = 0x10,
313 RSL_IE_ACCESS_DELAY,
314 RSL_IE_RACH_LOAD,
315 RSL_IE_REQ_REFERENCE,
316 RSL_IE_RELEASE_MODE,
317 RSL_IE_RESOURCE_INFO,
318 RSL_IE_RLM_CAUSE,
319 RSL_IE_STARTNG_TIME,
320 RSL_IE_TIMING_ADVANCE,
321 RSL_IE_UPLINK_MEAS,
322 RSL_IE_CAUSE,
323 RSL_IE_MEAS_RES_NR,
324 RSL_IE_MSG_ID,
325 /* reserved */
326 RSL_IE_SYSINFO_TYPE = 0x1e,
327 RSL_IE_MS_POWER_PARAM,
328 RSL_IE_BS_POWER_PARAM,
329 RSL_IE_PREPROC_PARAM,
330 RSL_IE_PREPROC_MEAS,
331 RSL_IE_IMM_ASS_INFO, /* Phase 1 (3.6.0), later Full below */
332 RSL_IE_SMSCB_INFO = 0x24,
333 RSL_IE_MS_TIMING_OFFSET,
334 RSL_IE_ERR_MSG,
335 RSL_IE_FULL_BCCH_INFO,
336 RSL_IE_CHAN_NEEDED,
337 RSL_IE_CB_CMD_TYPE,
338 RSL_IE_SMSCB_MSG,
339 RSL_IE_FULL_IMM_ASS_INFO,
340 RSL_IE_SACCH_INFO,
341 RSL_IE_CBCH_LOAD_INFO,
342 RSL_IE_SMSCB_CHAN_INDICATOR,
343 RSL_IE_GROUP_CALL_REF,
344 RSL_IE_CHAN_DESC = 0x30,
345 RSL_IE_NCH_DRX_INFO,
346 RSL_IE_CMD_INDICATOR,
347 RSL_IE_EMLPP_PRIO,
348 RSL_IE_UIC,
349 RSL_IE_MAIN_CHAN_REF,
350 RSL_IE_MR_CONFIG,
351 RSL_IE_MR_CONTROL,
352 RSL_IE_SUP_CODEC_TYPES,
353 RSL_IE_CODEC_CONFIG,
354 RSL_IE_RTD,
355 RSL_IE_TFO_STATUS,
356 RSL_IE_LLP_APDU,
357 /* Siemens vendor-specific */
358 RSL_IE_SIEMENS_MRPCI = 0x40,
359 RSL_IE_SIEMENS_PREF_AREA_TYPE = 0x43,
360 RSL_IE_SIEMENS_ININ_CELL_HO_PAR = 0x45,
361 RSL_IE_SIEMENS_TRACE_REF_NR = 0x46,
362 RSL_IE_SIEMENS_INT_TRACE_IDX = 0x47,
363 RSL_IE_SIEMENS_L2_HDR_INFO = 0x48,
364 RSL_IE_SIEMENS_HIGHEST_RATE = 0x4e,
365 RSL_IE_SIEMENS_SUGGESTED_RATE = 0x4f,
366
Philipp Maiera15967b2020-11-06 21:37:16 +0100367 /* Osmocom specific */
Philipp Maiere67edfd2021-08-31 09:46:35 +0200368 RSL_IE_OSMO_REP_ACCH_CAP = 0x60,
Neels Hofmeyrdd6f1362021-04-20 23:02:59 +0200369 RSL_IE_OSMO_TRAINING_SEQUENCE = 0x61,
Philipp Maier0e44a722021-08-30 10:51:52 +0200370 RSL_IE_OSMO_TEMP_OVP_ACCH_CAP = 0x62,
Pau Espin Pedrol83287ba2022-08-08 17:07:18 +0200371 RSL_IE_OSMO_OSMUX_CID = 0x63,
Philipp Maiera15967b2020-11-06 21:37:16 +0100372
Harald Welteec8b4502010-02-20 20:34:29 +0100373 /* ip.access */
374 RSL_IE_IPAC_SRTP_CONFIG = 0xe0,
375 RSL_IE_IPAC_PROXY_UDP = 0xe1,
376 RSL_IE_IPAC_BSCMPL_TOUT = 0xe2,
377 RSL_IE_IPAC_REMOTE_IP = 0xf0,
378 RSL_IE_IPAC_REMOTE_PORT = 0xf1,
379 RSL_IE_IPAC_RTP_PAYLOAD = 0xf2,
380 RSL_IE_IPAC_LOCAL_PORT = 0xf3,
381 RSL_IE_IPAC_SPEECH_MODE = 0xf4,
382 RSL_IE_IPAC_LOCAL_IP = 0xf5,
383 RSL_IE_IPAC_CONN_STAT = 0xf6,
384 RSL_IE_IPAC_HO_C_PARMS = 0xf7,
385 RSL_IE_IPAC_CONN_ID = 0xf8,
386 RSL_IE_IPAC_RTP_CSD_FMT = 0xf9,
387 RSL_IE_IPAC_RTP_JIT_BUF = 0xfa,
388 RSL_IE_IPAC_RTP_COMPR = 0xfb,
Pau Espin Pedrolb0c2f752022-04-04 19:37:19 +0200389 RSL_IE_IPAC_RTP_PAYLOAD2 = 0xfc,
Harald Welteec8b4502010-02-20 20:34:29 +0100390 RSL_IE_IPAC_RTP_MPLEX = 0xfd,
Pau Espin Pedrolb0c2f752022-04-04 19:37:19 +0200391 RSL_IE_IPAC_RTP_MPLEX_ID = 0xfe,
Harald Welteec8b4502010-02-20 20:34:29 +0100392};
393
Harald Welte6e363e72016-11-16 16:58:52 +0100394/* Ericsson specific IEs, clash with above partially, so they're not
395 * part of the enum */
Alexander Couzens9f39d892018-04-21 21:20:25 +0200396#define RSL_IE_ERIC_PAGING_GROUP 0x0e
Harald Welte6e363e72016-11-16 16:58:52 +0100397#define RSL_IE_ERIC_INST_NR 0x48
398#define RSL_IE_ERIC_PGSL_TIMERS 0x49
399#define RSL_IE_ERIC_REPEAT_DL_FACCH 0x4a
400#define RSL_IE_ERIC_POWER_INFO 0xf0
401#define RSL_IE_ERIC_MOBILE_ID 0xf1
402#define RSL_IE_ERIC_BCCH_MAPPING 0xf2
403#define RSL_IE_ERIC_PACKET_PAG_IND 0xf3
404#define RSL_IE_ERIC_CNTR_CTRL 0xf4
405#define RSL_IE_ERIC_CNTR_CTRL_ACK 0xf5
406#define RSL_IE_ERIC_CNTR_REPORT 0xf6
407#define RSL_IE_ERIC_ICP_CONN 0xf7
408#define RSL_IE_ERIC_EMR_SUPPORT 0xf8
409#define RSL_IE_ERIC_EGPRS_REQ_REF 0xf9
410#define RSL_IE_ERIC_VGCS_REL 0xfa
411#define RSL_IE_ERIC_REP_PER_NCH 0xfb
412#define RSL_IE_ERIC_NY2 0xfc
413#define RSL_IE_ERIC_T3115 0xfd
414#define RSL_IE_ERIC_ACTIVATE_FLAG 0xfe
415#define RSL_IE_ERIC_FULL_NCH_INFO 0xff
416
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400417/* IPAC MEAS_PREPROC AVERAGING METHOD */
418enum {
419 IPAC_UNWEIGHTED_AVE = 0,
420 IPAC_WEIGHTED_AVE,
Vadim Yanitskiyc8158ec2020-12-15 08:04:30 +0100421 IPAC_MEDIAN_AVE,
422 /* EWMA is an Osmocom specific extension */
423 IPAC_OSMO_EWMA_AVE,
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400424};
425
Pau Espin Pedrol9da16b52021-08-26 15:25:16 +0200426/* IPAC MEAS_PREPROC AVERAGING PARAM ID */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400427enum {
428 IPAC_RXLEV_AVE = 0,
429 IPAC_RXQUAL_AVE,
430 IPAC_MS_BTS_DIS_AVE
431};
432
433/* IPAC MEAS_PREPROC HO CAUSES */
434enum {
435 IPAC_HO_RQD_CAUSE_L_RXLEV_UL_H = 0x01,
436 IPAC_HO_RQD_CAUSE_L_RXLEV_DL_H,
437 IPAC_HO_RQD_CAUSE_L_RXQUAL_UL_H,
438 IPAC_HO_RQD_CAUSE_L_RXQUAL_DL_H,
439 IPAC_HO_RQD_CAUSE_RXLEV_UL_IH,
440 IPAC_HO_RQD_CAUSE_RXLEV_DL_IH,
441 IPAC_HO_RQD_CAUSE_MAX_MS_RANGE,
442 IPAC_HO_RQD_CAUSE_POWER_BUDGET,
443 IPAC_HO_RQD_CAUSE_ENQUIRY,
444 IPAC_HO_RQD_CAUSE_ENQUIRY_FAILED,
445 IPAC_HO_RQD_CAUSE_NORMAL3G,
446 IPAC_HO_RQD_CAUSE_EMERGENCY3G,
447 IPAC_HO_RQD_CAUSE_SERVICE_PREFERRED3G,
448 IPAC_HO_RQD_CAUSE_O_M_SHUTDOWN,
449 IPAC_HO_RQD_CAUSE_QUALITY_PROMOTION,
450 IPAC_HO_RQD_CAUSE_LOAD_PROMOTION,
451 IPAC_HO_RQD_CAUSE_LOAD_DEMOTION,
452 IPAC_HO_RQD_CAUSE_MAX,
453};
454
Harald Welteec8b4502010-02-20 20:34:29 +0100455/* Chapter 9.3.1 */
456#define RSL_CHAN_NR_MASK 0xf8
Neels Hofmeyr15b96ff2016-07-18 23:33:48 +0200457#define RSL_CHAN_NR_1 0x08 /*< bit to add for 2nd,... lchan */
Harald Welteec8b4502010-02-20 20:34:29 +0100458#define RSL_CHAN_Bm_ACCHs 0x08
459#define RSL_CHAN_Lm_ACCHs 0x10 /* .. 0x18 */
460#define RSL_CHAN_SDCCH4_ACCH 0x20 /* .. 0x38 */
461#define RSL_CHAN_SDCCH8_ACCH 0x40 /* ...0x78 */
462#define RSL_CHAN_BCCH 0x80
463#define RSL_CHAN_RACH 0x88
464#define RSL_CHAN_PCH_AGCH 0x90
Neels Hofmeyrfd80f5a2016-07-14 03:21:05 +0200465#define RSL_CHAN_OSMO_PDCH 0xc0 /*< non-standard, for dyn TS */
Harald Weltea8d7ebb2019-05-27 16:51:23 +0200466#define RSL_CHAN_OSMO_CBCH4 0xc8 /*< non-standard, for CBCH/SDCCH4 */
467#define RSL_CHAN_OSMO_CBCH8 0xd0 /*< non-standard, for CBCH/SDCCH8 */
Harald Welteec8b4502010-02-20 20:34:29 +0100468
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +0200469/* non-standard, Osmocom specific Bm/Lm equivalents for VAMOS */
470#define RSL_CHAN_OSMO_VAMOS_Bm_ACCHs 0xe8 /* VAMOS TCH/F */
471#define RSL_CHAN_OSMO_VAMOS_Lm_ACCHs 0xf0 /* VAMOS TCH/H */
Vadim Yanitskiy442ff642021-06-01 19:55:43 +0200472#define RSL_CHAN_OSMO_VAMOS_MASK 0xe0 /* VAMOS TCH/{F,H} */
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +0200473
Harald Welteec8b4502010-02-20 20:34:29 +0100474/* Chapter 9.3.3 */
475#define RSL_ACT_TYPE_INITIAL 0x00
476#define RSL_ACT_TYPE_REACT 0x80
477#define RSL_ACT_INTRA_IMM_ASS 0x00
478#define RSL_ACT_INTRA_NORM_ASS 0x01
479#define RSL_ACT_INTER_ASYNC 0x02
480#define RSL_ACT_INTER_SYNC 0x03
481#define RSL_ACT_SECOND_ADD 0x04
482#define RSL_ACT_SECOND_MULTI 0x05
Neels Hofmeyrfd80f5a2016-07-14 03:21:05 +0200483#define RSL_ACT_OSMO_PDCH 0x0f /*< non-standard, for dyn TS */
Harald Welteec8b4502010-02-20 20:34:29 +0100484
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200485/*! RSL Channel Mode IF (Chapter 9.3.6) */
Harald Welteec8b4502010-02-20 20:34:29 +0100486struct rsl_ie_chan_mode {
487 uint8_t dtx_dtu;
488 uint8_t spd_ind;
489 uint8_t chan_rt;
490 uint8_t chan_rate;
491} __attribute__ ((packed));
492#define RSL_CMOD_DTXu 0x01 /* uplink */
493#define RSL_CMOD_DTXd 0x02 /* downlink */
494enum rsl_cmod_spd {
495 RSL_CMOD_SPD_SPEECH = 0x01,
496 RSL_CMOD_SPD_DATA = 0x02,
497 RSL_CMOD_SPD_SIGN = 0x03,
498};
Vadim Yanitskiy307b2012021-04-19 04:42:34 +0200499#define RSL_CMOD_CRT_SDCCH 0x01
500#define RSL_CMOD_CRT_TCH_Bm 0x08 /* full-rate */
501#define RSL_CMOD_CRT_TCH_Lm 0x09 /* half-rate */
502#define RSL_CMOD_CRT_TCH_BI_Bm 0x0a /* full-rate: bi-directional (multislot) */
503#define RSL_CMOD_CRT_TCH_UNI_Bm 0x1a /* full-rate: uni-directional (multislot) */
504#define RSL_CMOD_CRT_TCH_GROUP_Bm 0x18 /* full-rate: group call channel */
505#define RSL_CMOD_CRT_TCH_GROUP_Lm 0x19 /* half-rate: group call channel */
506#define RSL_CMOD_CRT_TCH_BCAST_Bm 0x28 /* full-rate: broadcast call channel */
507#define RSL_CMOD_CRT_TCH_BCAST_Lm 0x29 /* half-rate: broadcast call channel */
Neels Hofmeyrfef61cd2021-04-22 21:54:31 +0200508#define RSL_CMOD_CRT_OSMO_TCH_VAMOS_Bm 0x88 /* full-rate in VAMOS mode */
509#define RSL_CMOD_CRT_OSMO_TCH_VAMOS_Lm 0x89 /* half-rate in VAMOS mode */
Harald Welteec8b4502010-02-20 20:34:29 +0100510/* Speech */
511#define RSL_CMOD_SP_GSM1 0x01
512#define RSL_CMOD_SP_GSM2 0x11
513#define RSL_CMOD_SP_GSM3 0x21
Vadim Yanitskiy99f6cd52021-04-19 04:26:10 +0200514#define RSL_CMOD_SP_GSM4 0x31
515#define RSL_CMOD_SP_GSM5 0x09
516#define RSL_CMOD_SP_GSM6 0x0d
Vadim Yanitskiye731a7d2021-04-19 04:59:51 +0200517/* non-transparent data (asymmetric) */
518#define RSL_CMOD_CSD_NTA_43k5_14k5 0x61 /* asymmetric 43.5 kbit/s (DL) + 14.5 kbit/s (UL) */
519#define RSL_CMOD_CSD_NTA_29k0_14k5 0x62 /* asymmetric 29.0 kbit/s (DL) + 14.5 kbit/s (UL) */
520#define RSL_CMOD_CSD_NTA_43k5_29k0 0x63 /* asymmetric 43.5 kbit/s (DL) + 29.0 kbit/s (UL) */
521#define RSL_CMOD_CSD_NTA_14k5_43k5 0x69 /* asymmetric 14.5 kbit/s (DL) + 43.5 kbit/s (UL) */
522#define RSL_CMOD_CSD_NTA_14k5_29k0 0x6a /* asymmetric 14.5 kbit/s (DL) + 29.0 kbit/s (UL) */
523#define RSL_CMOD_CSD_NTA_29k0_43k5 0x6b /* asymmetric 29.0 kbit/s (DL) + 43.5 kbit/s (UL) */
Harald Welteeed26112012-08-24 15:35:34 +0200524/* non-transparent data */
525#define RSL_CMOD_CSD_NT_43k5 0x74
526#define RSL_CMOD_CSD_NT_28k8 0x71
527#define RSL_CMOD_CSD_NT_14k5 0x58
528#define RSL_CMOD_CSD_NT_12k0 0x50
529#define RSL_CMOD_CSD_NT_6k0 0x51
530/* legacy #defines with wrong name */
531#define RSL_CMOD_SP_NT_14k5 RSL_CMOD_CSD_NT_14k5
532#define RSL_CMOD_SP_NT_12k0 RSL_CMOD_CSD_NT_12k0
533#define RSL_CMOD_SP_NT_6k0 RSL_CMOD_CSD_NT_6k0
534/* transparent data */
535#define RSL_CMOD_CSD_T_32000 0x38
536#define RSL_CMOD_CSD_T_29000 0x39
537#define RSL_CMOD_CSD_T_14400 0x18
538#define RSL_CMOD_CSD_T_9600 0x10
539#define RSL_CMOD_CSD_T_4800 0x11
540#define RSL_CMOD_CSD_T_2400 0x12
541#define RSL_CMOD_CSD_T_1200 0x13
542#define RSL_CMOD_CSD_T_600 0x14
543#define RSL_CMOD_CSD_T_1200_75 0x15
Harald Welteec8b4502010-02-20 20:34:29 +0100544
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200545/*! RSL Channel Identification IE (Chapter 9.3.5) */
Harald Welteec8b4502010-02-20 20:34:29 +0100546struct rsl_ie_chan_ident {
547 /* GSM 04.08 10.5.2.5 */
548 struct {
549 uint8_t iei;
550 uint8_t chan_nr; /* enc_chan_nr */
551 uint8_t oct3;
552 uint8_t oct4;
553 } chan_desc;
554#if 0 /* spec says we need this but Abissim doesn't use it */
555 struct {
556 uint8_t tag;
557 uint8_t len;
558 } mobile_alloc;
559#endif
560} __attribute__ ((packed));
561
562/* Chapter 9.3.22 */
563#define RLL_CAUSE_T200_EXPIRED 0x01
564#define RLL_CAUSE_REEST_REQ 0x02
565#define RLL_CAUSE_UNSOL_UA_RESP 0x03
566#define RLL_CAUSE_UNSOL_DM_RESP 0x04
567#define RLL_CAUSE_UNSOL_DM_RESP_MF 0x05
568#define RLL_CAUSE_UNSOL_SPRV_RESP 0x06
569#define RLL_CAUSE_SEQ_ERR 0x07
570#define RLL_CAUSE_UFRM_INC_PARAM 0x08
571#define RLL_CAUSE_SFRM_INC_PARAM 0x09
572#define RLL_CAUSE_IFRM_INC_MBITS 0x0a
573#define RLL_CAUSE_IFRM_INC_LEN 0x0b
574#define RLL_CAUSE_FRM_UNIMPL 0x0c
575#define RLL_CAUSE_SABM_MF 0x0d
576#define RLL_CAUSE_SABM_INFO_NOTALL 0x0e
577
578/* Chapter 9.3.26 */
579#define RSL_ERRCLS_NORMAL 0x00
580#define RSL_ERRCLS_RESOURCE_UNAVAIL 0x20
581#define RSL_ERRCLS_SERVICE_UNAVAIL 0x30
582#define RSL_ERRCLS_SERVICE_UNIMPL 0x40
583#define RSL_ERRCLS_INVAL_MSG 0x50
584#define RSL_ERRCLS_PROTO_ERROR 0x60
585#define RSL_ERRCLS_INTERWORKING 0x70
586
587/* normal event */
588#define RSL_ERR_RADIO_IF_FAIL 0x00
589#define RSL_ERR_RADIO_LINK_FAIL 0x01
590#define RSL_ERR_HANDOVER_ACC_FAIL 0x02
591#define RSL_ERR_TALKER_ACC_FAIL 0x03
592#define RSL_ERR_OM_INTERVENTION 0x07
593#define RSL_ERR_NORMAL_UNSPEC 0x0f
594#define RSL_ERR_T_MSRFPCI_EXP 0x18
595/* resource unavailable */
596#define RSL_ERR_EQUIPMENT_FAIL 0x20
597#define RSL_ERR_RR_UNAVAIL 0x21
598#define RSL_ERR_TERR_CH_FAIL 0x22
599#define RSL_ERR_CCCH_OVERLOAD 0x23
600#define RSL_ERR_ACCH_OVERLOAD 0x24
601#define RSL_ERR_PROCESSOR_OVERLOAD 0x25
Philipp Maier6d214482020-07-28 16:53:27 +0200602#define RSL_ERR_BTS_NOT_EQUIPPED 0x27
603#define RSL_ERR_REMOTE_TRANSC_FAIL 0x28
604#define RSL_ERR_NOTIFICATION_OVERFL 0x29
Harald Welteec8b4502010-02-20 20:34:29 +0100605#define RSL_ERR_RES_UNAVAIL 0x2f
606/* service or option not available */
607#define RSL_ERR_TRANSC_UNAVAIL 0x30
608#define RSL_ERR_SERV_OPT_UNAVAIL 0x3f
609/* service or option not implemented */
610#define RSL_ERR_ENCR_UNIMPL 0x40
611#define RSL_ERR_SERV_OPT_UNIMPL 0x4f
612/* invalid message */
613#define RSL_ERR_RCH_ALR_ACTV_ALLOC 0x50
614#define RSL_ERR_INVALID_MESSAGE 0x5f
615/* protocol error */
616#define RSL_ERR_MSG_DISCR 0x60
617#define RSL_ERR_MSG_TYPE 0x61
618#define RSL_ERR_MSG_SEQ 0x62
619#define RSL_ERR_IE_ERROR 0x63
620#define RSL_ERR_MAND_IE_ERROR 0x64
621#define RSL_ERR_OPT_IE_ERROR 0x65
622#define RSL_ERR_IE_NONEXIST 0x66
623#define RSL_ERR_IE_LENGTH 0x67
624#define RSL_ERR_IE_CONTENT 0x68
625#define RSL_ERR_PROTO 0x6f
626/* interworking */
627#define RSL_ERR_INTERWORKING 0x7f
628
629/* Chapter 9.3.30 */
630#define RSL_SYSTEM_INFO_8 0x00
631#define RSL_SYSTEM_INFO_1 0x01
632#define RSL_SYSTEM_INFO_2 0x02
633#define RSL_SYSTEM_INFO_3 0x03
634#define RSL_SYSTEM_INFO_4 0x04
635#define RSL_SYSTEM_INFO_5 0x05
636#define RSL_SYSTEM_INFO_6 0x06
637#define RSL_SYSTEM_INFO_7 0x07
638#define RSL_SYSTEM_INFO_16 0x08
639#define RSL_SYSTEM_INFO_17 0x09
640#define RSL_SYSTEM_INFO_2bis 0x0a
641#define RSL_SYSTEM_INFO_2ter 0x0b
642#define RSL_SYSTEM_INFO_5bis 0x0d
643#define RSL_SYSTEM_INFO_5ter 0x0e
644#define RSL_SYSTEM_INFO_10 0x0f
Harald Welte3d732272011-06-25 21:39:01 +0200645#define RSL_EXT_MEAS_ORDER 0x47
Harald Welteec8b4502010-02-20 20:34:29 +0100646#define RSL_MEAS_INFO 0x48
647#define RSL_SYSTEM_INFO_13 0x28
Philipp00b15392016-11-14 12:34:15 +0100648#define RSL_ERIC_SYSTEM_INFO_13 0x0C
Harald Welteec8b4502010-02-20 20:34:29 +0100649#define RSL_SYSTEM_INFO_2quater 0x29
650#define RSL_SYSTEM_INFO_9 0x2a
651#define RSL_SYSTEM_INFO_18 0x2b
652#define RSL_SYSTEM_INFO_19 0x2c
653#define RSL_SYSTEM_INFO_20 0x2d
654
655/* Chapter 9.3.40 */
656#define RSL_CHANNEED_ANY 0x00
657#define RSL_CHANNEED_SDCCH 0x01
658#define RSL_CHANNEED_TCH_F 0x02
659#define RSL_CHANNEED_TCH_ForH 0x03
660
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200661/*! RSL Cell Broadcast Command (Chapter 9.3.45) */
Alex Badea84930182010-11-27 23:34:46 +0200662struct rsl_ie_cb_cmd_type {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100663#if OSMO_IS_LITTLE_ENDIAN
Alex Badea84930182010-11-27 23:34:46 +0200664 uint8_t last_block:2;
665 uint8_t spare:1;
666 uint8_t def_bcast:1;
667 uint8_t command:4;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100668#elif OSMO_IS_BIG_ENDIAN
669/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
670 uint8_t command:4, def_bcast:1, spare:1, last_block:2;
671#endif
Alex Badea84930182010-11-27 23:34:46 +0200672} __attribute__ ((packed));
673/* ->command */
674#define RSL_CB_CMD_TYPE_NORMAL 0x00
675#define RSL_CB_CMD_TYPE_SCHEDULE 0x08
676#define RSL_CB_CMD_TYPE_DEFAULT 0x0e
677#define RSL_CB_CMD_TYPE_NULL 0x0f
678/* ->def_bcast */
679#define RSL_CB_CMD_DEFBCAST_NORMAL 0
680#define RSL_CB_CMD_DEFBCAST_NULL 1
681/* ->last_block */
682#define RSL_CB_CMD_LASTBLOCK_4 0
683#define RSL_CB_CMD_LASTBLOCK_1 1
684#define RSL_CB_CMD_LASTBLOCK_2 2
685#define RSL_CB_CMD_LASTBLOCK_3 3
686
Harald Welteec8b4502010-02-20 20:34:29 +0100687/* Chapter 3.3.2.3 Brocast control channel */
688/* CCCH-CONF, NC is not combined */
689#define RSL_BCCH_CCCH_CONF_1_NC 0x00
690#define RSL_BCCH_CCCH_CONF_1_C 0x01
691#define RSL_BCCH_CCCH_CONF_2_NC 0x02
692#define RSL_BCCH_CCCH_CONF_3_NC 0x04
693#define RSL_BCCH_CCCH_CONF_4_NC 0x06
694
695/* BS-PA-MFRMS */
696#define RSL_BS_PA_MFRMS_2 0x00
697#define RSL_BS_PA_MFRMS_3 0x01
698#define RSL_BS_PA_MFRMS_4 0x02
699#define RSL_BS_PA_MFRMS_5 0x03
700#define RSL_BS_PA_MFRMS_6 0x04
701#define RSL_BS_PA_MFRMS_7 0x05
702#define RSL_BS_PA_MFRMS_8 0x06
703#define RSL_BS_PA_MFRMS_9 0x07
704
705/* RSL_IE_IPAC_RTP_PAYLOAD[2] */
706enum rsl_ipac_rtp_payload {
707 RSL_IPAC_RTP_GSM = 1,
708 RSL_IPAC_RTP_EFR,
709 RSL_IPAC_RTP_AMR,
710 RSL_IPAC_RTP_CSD,
711 RSL_IPAC_RTP_MUX,
712};
713
714/* RSL_IE_IPAC_SPEECH_MODE, lower four bits */
715enum rsl_ipac_speech_mode_s {
716 RSL_IPAC_SPEECH_GSM_FR = 0, /* GSM FR (Type 1, FS) */
717 RSL_IPAC_SPEECH_GSM_EFR = 1, /* GSM EFR (Type 2, FS) */
718 RSL_IPAC_SPEECH_GSM_AMR_FR = 2, /* GSM AMR/FR (Type 3, FS) */
719 RSL_IPAC_SPEECH_GSM_HR = 3, /* GSM HR (Type 1, HS) */
720 RSL_IPAC_SPEECH_GSM_AMR_HR = 5, /* GSM AMR/hr (Type 3, HS) */
721 RSL_IPAC_SPEECH_AS_RTP = 0xf, /* As specified by RTP Payload IE */
722};
723/* RSL_IE_IPAC_SPEECH_MODE, upper four bits */
724enum rsl_ipac_speech_mode_m {
725 RSL_IPAC_SPEECH_M_RXTX = 0, /* Send and Receive */
726 RSL_IPAC_SPEECH_M_RX = 1, /* Receive only */
727 RSL_IPAC_SPEECH_M_TX = 2, /* Send only */
728};
729
730/* RSL_IE_IPAC_RTP_CSD_FMT, lower four bits */
731enum rsl_ipac_rtp_csd_format_d {
732 RSL_IPAC_RTP_CSD_EXT_TRAU = 0,
733 RSL_IPAC_RTP_CSD_NON_TRAU = 1,
734 RSL_IPAC_RTP_CSD_TRAU_BTS = 2,
735 RSL_IPAC_RTP_CSD_IWF_FREE = 3,
736};
737/* RSL_IE_IPAC_RTP_CSD_FMT, upper four bits */
738enum rsl_ipac_rtp_csd_format_ir {
739 RSL_IPAC_RTP_CSD_IR_8k = 0,
740 RSL_IPAC_RTP_CSD_IR_16k = 1,
741 RSL_IPAC_RTP_CSD_IR_32k = 2,
742 RSL_IPAC_RTP_CSD_IR_64k = 3,
743};
744
745/* Siemens vendor-specific RSL extensions */
746struct rsl_mrpci {
747 uint8_t power_class:3,
748 vgcs_capable:1,
749 vbs_capable:1,
750 gsm_phase:2;
751} __attribute__ ((packed));
752
753enum rsl_mrpci_pwrclass {
754 RSL_MRPCI_PWRC_1 = 0,
755 RSL_MRPCI_PWRC_2 = 1,
756 RSL_MRPCI_PWRC_3 = 2,
757 RSL_MRPCI_PWRC_4 = 3,
758 RSL_MRPCI_PWRC_5 = 4,
759};
760enum rsl_mrpci_phase {
761 RSL_MRPCI_PHASE_1 = 0,
762 /* reserved */
763 RSL_MRPCI_PHASE_2 = 2,
764 RSL_MRPCI_PHASE_2PLUS = 3,
765};
766
Holger Hans Peter Freyther0357e9b2012-12-06 11:57:31 +0100767/* 9.3.20 Release Mode */
768enum rsl_rel_mode {
769 RSL_REL_NORMAL = 0,
770 RSL_REL_LOCAL_END = 1,
771};
772
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200773/*! ip.access specific embedded information elements */
Harald Weltefad57522015-12-13 11:56:36 +0100774enum rsl_ipac_embedded_ie {
775 RSL_IPAC_EIE_RXLEV = 0x00,
776 RSL_IPAC_EIE_RXQUAL = 0x01,
777 RSL_IPAC_EIE_FREQ_ERR = 0x02,
778 RSL_IPAC_EIE_TIMING_ERR = 0x03,
779 RSL_IPAC_EIE_MEAS_AVG_CFG = 0x04,
780 RSL_IPAC_EIE_BS_PWR_CTL = 0x05,
781 RSL_IPAC_EIE_MS_PWR_CTL = 0x06,
782 RSL_IPAC_EIE_HANDO_THRESH = 0x07,
783 RSL_IPAC_EIE_NCELL_DEFAULTS = 0x08,
784 RSL_IPAC_EIE_NCELL_LIST = 0x09,
785 RSL_IPAC_EIE_PC_THRESH_COMP = 0x0a,
786 RSL_IPAC_EIE_HO_THRESH_COMP = 0x0b,
787 RSL_IPAC_EIE_HO_CAUSE = 0x0c,
788 RSL_IPAC_EIE_HO_CANDIDATES = 0x0d,
789 RSL_IPAC_EIE_NCELL_BA_CHG_LIST = 0x0e,
790 RSL_IPAC_EIE_NUM_OF_MS = 0x10,
791 RSL_IPAC_EIE_HO_CAND_EXT = 0x11,
792 RSL_IPAC_EIE_NCELL_DEF_EXT = 0x12,
793 RSL_IPAC_EIE_NCELL_LIST_EXT = 0x13,
794 RSL_IPAC_EIE_MASTER_KEY = 0x14,
795 RSL_IPAC_EIE_MASTER_SALT = 0x15,
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400796 /* additional IPAC measurement pre-processing related IEI */
797 RSL_IPAC_EIE_MEAS_TRANS_RES = 0x16,
798 RSL_IPAC_EIE_3G_HO_PARAM = 0x17,
799 RSL_IPAC_EIE_3G_NCELL_LIST = 0x18,
800 RSL_IPAC_EIE_SDCCH_CTL_PARAM = 0x1a,
801 RSL_IPAC_EIE_AMR_CONV_THRESH = 0x1b,
802
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200803 /* Osmocom specific extensions: */
804 RSL_IPAC_EIE_OSMO_MEAS_AVG_CFG = 0xf0,
805 RSL_IPAC_EIE_OSMO_MS_PWR_CTL = 0xf1,
806 RSL_IPAC_EIE_OSMO_PC_THRESH_COMP = 0xf2,
807
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400808};
809
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200810/* Value of TLV IE RSL_IPAC_EIE_MEAS_AVG_CFG */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400811struct ipac_preproc_ave_cfg {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100812#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400813 uint8_t h_reqave:5,
814 param_id:2,
815 reserved:1;
816 uint8_t h_reqt:5,
817 ave_method:3;
Vadim Yanitskiy8f5844e2020-12-25 00:19:45 +0100818 uint8_t params[0];
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100819#elif OSMO_IS_BIG_ENDIAN
820/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
821 uint8_t reserved:1, param_id:2, h_reqave:5;
822 uint8_t ave_method:3, h_reqt:5;
Vadim Yanitskiy8f5844e2020-12-25 00:19:45 +0100823 uint8_t params[0];
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100824#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400825}__attribute__ ((packed));
826
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200827
828struct osmo_preproc_ave_cfg_field {
829#if OSMO_IS_LITTLE_ENDIAN
830 uint8_t h_reqave:5,
831 ave_enabled:1,
832 reserved:2;
833 uint8_t h_reqt:5,
834 ave_method:3;
835#elif OSMO_IS_BIG_ENDIAN
836/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
837 uint8_t reserved:2, ave_enabled:1, h_reqave:5;
838 uint8_t ave_method:3, h_reqt:5;
839#endif
840}__attribute__ ((packed));
841/* Value of TLV IE RSL_IPAC_EIE_OSMO_MEAS_AVG_CFG: */
842struct osmo_preproc_ave_cfg {
843 struct osmo_preproc_ave_cfg_field ci_fr;
844 struct osmo_preproc_ave_cfg_field ci_hr;
845 struct osmo_preproc_ave_cfg_field ci_amr_fr;
846 struct osmo_preproc_ave_cfg_field ci_amr_hr;
847 struct osmo_preproc_ave_cfg_field ci_sdcch;
848 struct osmo_preproc_ave_cfg_field ci_gprs;
849 uint8_t params[0]; /* Contains params for each above, appended one after the other */
850}__attribute__ ((packed));
851
852/*! MS/BS Power Control Thresholds (RSL_IPAC_EIE_MS_PWR_CTL) */
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100853struct ipac_preproc_pc_thresh {
854#if OSMO_IS_LITTLE_ENDIAN
855 uint8_t l_rxlev:6, reserved_l_rxlev:2;
856 uint8_t u_rxlev:6, reserved_u_rxlev:2;
Vadim Yanitskiy2060bbb2020-12-19 17:33:41 +0100857 uint8_t u_rxqual:3, reserved_u_rxqual:1,
858 l_rxqual:3, reserved_l_rxqual:1;
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100859#elif OSMO_IS_BIG_ENDIAN
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100860/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100861 uint8_t reserved_l_rxlev:2, l_rxlev:6;
862 uint8_t reserved_u_rxlev:2, u_rxlev:6;
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100863 uint8_t reserved_l_rxqual:1, l_rxqual:3, reserved_u_rxqual:1, u_rxqual:3;
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100864#endif
865}__attribute__ ((packed));
866
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200867/*! Osmocom extension for: MS/BS Power Control Thresholds (RSL_IPAC_EIE_OSMO_MS_PWR_CTL) */
868struct osmo_preproc_pc_thresh {
869 /* Carrier-to-Interference (C/I), in dB: */
870 int8_t l_ci_fr; int8_t u_ci_fr; /* FR/EFR */
871 int8_t l_ci_hr; int8_t u_ci_hr; /* HR */
872 int8_t l_ci_amr_fr; int8_t u_ci_amr_fr; /* AMR FR */
873 int8_t l_ci_amr_hr; int8_t u_ci_amr_hr; /* AMR HR */
874 int8_t l_ci_sdcch; int8_t u_ci_sdcch; /* SDCCH */
875 int8_t l_ci_gprs; int8_t u_ci_gprs; /* GPRS */
876}__attribute__ ((packed));
877
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100878/*! Handover Thresholds */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400879struct ipac_preproc_ho_thresh {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100880#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400881 uint8_t l_rxlev_ul_h:6,
882 reserved_l_rxlev_ul:2;
883 uint8_t l_rxlev_dl_h:6,
884 reserved_l_rxlev_dl:2;
885 uint8_t rxlev_ul_ih:6,
886 reserved_rxlev_ul:2;
887 uint8_t rxlev_dl_ih:6,
888 reserved_rxlev_dl:2;
889 uint8_t l_rxqual_ul_h:3,
890 reserved_rxlqual_ul:1,
891 l_rxqual_dl_h:3,
892 reserved_rxqual_dl:1;
893 uint8_t ms_range_max:6,
894 reserved_ms_range:2;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100895#elif OSMO_IS_BIG_ENDIAN
896/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
897 uint8_t reserved_l_rxlev_ul:2, l_rxlev_ul_h:6;
898 uint8_t reserved_l_rxlev_dl:2, l_rxlev_dl_h:6;
899 uint8_t reserved_rxlev_ul:2, rxlev_ul_ih:6;
900 uint8_t reserved_rxlev_dl:2, rxlev_dl_ih:6;
901 uint8_t reserved_rxqual_dl:1, l_rxqual_dl_h:3, reserved_rxlqual_ul:1, l_rxqual_ul_h:3;
902 uint8_t reserved_ms_range:2, ms_range_max:6;
903#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400904}__attribute__ ((packed));
905
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200906/*! PC Threshold Comparators (RSL_IPAC_EIE_PC_THRESH_COMP) */
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100907struct ipac_preproc_pc_comp {
908#if OSMO_IS_LITTLE_ENDIAN
909 uint8_t p1:5, reserved_p1:3;
910 uint8_t n1:5, reserved_n1:3;
911 uint8_t p2:5, reserved_p2:3;
912 uint8_t n2:5, reserved_n2:3;
913 uint8_t p3:5, reserved_p3:3;
914 uint8_t n3:5, reserved_n3:3;
915 uint8_t p4:5, reserved_p4:3;
916 uint8_t n4:5, reserved_n4:3;
917 uint8_t pc_interval:5, reserved_pc:3;
918 uint8_t red_step_size:4, inc_step_size:4;
919#elif OSMO_IS_BIG_ENDIAN
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100920/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100921 uint8_t reserved_p1:3, p1:5;
922 uint8_t reserved_n1:3, n1:5;
923 uint8_t reserved_p2:3, p2:5;
924 uint8_t reserved_n2:3, n2:5;
925 uint8_t reserved_p3:3, p3:5;
926 uint8_t reserved_n3:3, n3:5;
927 uint8_t reserved_p4:3, p4:5;
928 uint8_t reserved_n4:3, n4:5;
929 uint8_t reserved_pc:3, pc_interval:5;
930 uint8_t inc_step_size:4, red_step_size:4;
931#endif
932}__attribute__ ((packed));
933
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200934/*! Osmocom extension for: PC Threshold Comparators (RSL_IPAC_EIE_OSMO_PC_THRESH_COMP) */
935struct ipac_preproc_pc_comp_field {
936#if OSMO_IS_LITTLE_ENDIAN
937 uint8_t lower_p:5, reserved_lower_p:3;
938 uint8_t lower_n:5, reserved_lower_n:3;
939 uint8_t upper_p:5, reserved_upper_p:3;
940 uint8_t upper_n:5, reserved_upper_n:3;
941#elif OSMO_IS_BIG_ENDIAN
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100942/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200943 uint8_t reserved_lower_p:3, lower_p:5;
944 uint8_t reserved_lower_n:3, lower_n:5;
945 uint8_t reserved_upper_p:3, upper_p:5;
946 uint8_t reserved_upper_n:3, upper_n:5;
Pau Espin Pedrol28c43882021-12-22 13:56:42 +0100947#endif
Pau Espin Pedrol51933842021-08-30 13:50:56 +0200948}__attribute__ ((packed));
949struct osmo_preproc_pc_comp {
950 /* Used for Carrier-to-Interference (C/I), in dB: */
951 struct ipac_preproc_pc_comp_field ci_fr;
952 struct ipac_preproc_pc_comp_field ci_hr;
953 struct ipac_preproc_pc_comp_field ci_amr_fr;
954 struct ipac_preproc_pc_comp_field ci_amr_hr;
955 struct ipac_preproc_pc_comp_field ci_sdcch;
956 struct ipac_preproc_pc_comp_field ci_gprs;
957}__attribute__ ((packed));
958
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100959/*! HO Threshold Comparators */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400960struct ipac_preproc_ho_comp {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100961#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400962 uint8_t p5:5,
963 reserved_p5:3;
964 uint8_t n5:5,
965 reserved_n5:3;
966 uint8_t p6:5,
967 reserved_p6:3;
968 uint8_t n6:5,
969 reserved_n6:3;
970 uint8_t p7:5,
971 reserved_p7:3;
972 uint8_t n7:5,
973 reserved_n7:3;
974 uint8_t p8:5,
975 reserved_p8:3;
976 uint8_t n8:5,
977 reserved_n8:3;
978 uint8_t ho_interval:5,
979 reserved_ho:3;
980 uint8_t reserved;
981
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100982#elif OSMO_IS_BIG_ENDIAN
983/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
984 uint8_t reserved_p5:3, p5:5;
985 uint8_t reserved_n5:3, n5:5;
986 uint8_t reserved_p6:3, p6:5;
987 uint8_t reserved_n6:3, n6:5;
988 uint8_t reserved_p7:3, p7:5;
989 uint8_t reserved_n7:3, n7:5;
990 uint8_t reserved_p8:3, p8:5;
991 uint8_t reserved_n8:3, n8:5;
992 uint8_t reserved_ho:3, ho_interval:5;
993 uint8_t reserved;
994#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400995}__attribute__ ((packed));
996
997struct ipac_preproc_ho_candidates {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100998#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400999 uint8_t bsic:6,
1000 reserved0:2;
1001 uint8_t bcch_freq:5,
1002 ba_used:1,
1003 s:1,
1004 reserved1:1;
Neels Hofmeyrb2600392018-11-16 00:20:39 +01001005#elif OSMO_IS_BIG_ENDIAN
1006/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
1007 uint8_t reserved0:2, bsic:6;
1008 uint8_t reserved1:1, s:1, ba_used:1, bcch_freq:5;
1009#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -04001010}__attribute__ ((packed));
1011
1012struct ipac_preproc_ncell_dflts {
Neels Hofmeyrb2600392018-11-16 00:20:39 +01001013#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -04001014 uint8_t rxlev_min_def:6,
1015 reserved_rxlev_min_def:2;
1016 uint8_t ho_margin_def:5,
1017 reserved_ho_margin_def:3;
1018 uint8_t ms_txpwr_max_def:5,
1019 reserved_ms_txpwr_max_def:3;
Neels Hofmeyrb2600392018-11-16 00:20:39 +01001020#elif OSMO_IS_BIG_ENDIAN
1021/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
1022 uint8_t reserved_rxlev_min_def:2, rxlev_min_def:6;
1023 uint8_t reserved_ho_margin_def:3, ho_margin_def:5;
1024 uint8_t reserved_ms_txpwr_max_def:3, ms_txpwr_max_def:5;
1025#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -04001026}__attribute__ ((packed));
1027
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -05001028struct ipac_preproc_ho_ctl_param {
Neels Hofmeyrb2600392018-11-16 00:20:39 +01001029#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -05001030 uint8_t sdcch_ho_gsm:1,
1031 sdcch_ho_umts:1,
1032 reserved:6;
Neels Hofmeyrb2600392018-11-16 00:20:39 +01001033#elif OSMO_IS_BIG_ENDIAN
1034/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
1035 uint8_t reserved:6, sdcch_ho_umts:1, sdcch_ho_gsm:1;
1036#endif
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -05001037}__attribute__ ((packed));
1038
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -04001039struct ipac_preproc_cfg {
1040 uint8_t meas_rep_mode;
1041 uint32_t meas_mode_flags;
1042 struct ipac_preproc_ave_cfg ms_ave_cfg[3];
1043 struct ipac_preproc_ave_cfg ave_cfg;
1044 struct ipac_preproc_ho_thresh ho_thresh;
1045 struct ipac_preproc_ho_comp ho_comp;
1046 struct ipac_preproc_ncell_dflts ncell_dflts;
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -05001047 struct ipac_preproc_ho_ctl_param ho_ctl_param;
Harald Weltefad57522015-12-13 11:56:36 +01001048};
1049
Philipp Maierca770ae2021-02-16 17:31:22 +01001050struct rsl_l1_info {
Pau Espin Pedrol28c43882021-12-22 13:56:42 +01001051#if OSMO_IS_LITTLE_ENDIAN
Philipp Maierca770ae2021-02-16 17:31:22 +01001052 uint8_t reserved:1,
1053 srr_sro:1,
1054 fpc_epc:1,
1055 ms_pwr:5;
1056 uint8_t ta;
Pau Espin Pedrol28c43882021-12-22 13:56:42 +01001057#elif OSMO_IS_BIG_ENDIAN
1058/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
1059 uint8_t ms_pwr:5, fpc_epc:1, srr_sro:1, reserved:1;
1060 uint8_t ta;
Philipp Maierca770ae2021-02-16 17:31:22 +01001061#endif
1062} __attribute__ ((packed));
1063
Sylvain Munautdca7d2c2012-04-18 21:53:23 +02001064/*! @} */