blob: 0182d8d9911b274a9ea010a01fe12838c1295111 [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 *
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 *
22 */
23
Neels Hofmeyr17518fe2017-06-20 04:35:06 +020024#pragma once
25
Harald Welteec8b4502010-02-20 20:34:29 +010026#include <stdint.h>
27
Pau Espin Pedrol42908032018-10-10 17:04:28 +020028#include <osmocom/core/endian.h>
29
Harald Welte8f2c7e52011-08-17 18:52:03 +020030/*! \addtogroup rsl
31 * @{
Neels Hofmeyr17518fe2017-06-20 04:35:06 +020032 * \file gsm_08_58.h */
Harald Welte8f2c7e52011-08-17 18:52:03 +020033
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020034/* Channel Number 9.3.1 */
35union abis_rsl_chan_nr {
36#if OSMO_IS_BIG_ENDIAN
37 uint8_t cbits:5,
38 tn:3;
39#elif OSMO_IS_LITTLE_ENDIAN
40 uint8_t tn:3,
41 cbits:5;
42#endif
43 uint8_t chan_nr;
44} __attribute__ ((packed));
45#define ABIS_RSL_CHAN_NR_CBITS_Bm_ACCHs 0x01
46#define ABIS_RSL_CHAN_NR_CBITS_Lm_ACCHs(ss) (0x02 + (ss))
47#define ABIS_RSL_CHAN_NR_CBITS_SDCCH4_ACCH(ss) (0x04 + (ss))
48#define ABIS_RSL_CHAN_NR_CBITS_SDCCH8_ACCH(ss) (0x08 + (ss))
49#define ABIS_RSL_CHAN_NR_CBITS_BCCH 0x10
50#define ABIS_RSL_CHAN_NR_CBITS_RACH 0x11
51#define ABIS_RSL_CHAN_NR_CBITS_PCH_AGCH 0x12
52#define ABIS_RSL_CHAN_NR_CBITS_OSMO_PDCH 0x18 /*< non-standard, for dyn TS */
Harald Weltea8d7ebb2019-05-27 16:51:23 +020053#define ABIS_RSL_CHAN_NR_CBITS_OSMO_CBCH4 0x19 /*< non-standard, for CBCH/SDCCH4 */
54#define ABIS_RSL_CHAN_NR_CBITS_OSMO_CBCH8 0x1a /*< non-standard, for CBCH/SDCCH8 */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020055
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +020056/* non-standard, Osmocom specific Bm/Lm equivalents for VAMOS */
57#define ABIS_RSL_CHAN_NR_CBITS_OSMO_VAMOS_Bm_ACCHs 0x1d /*< VAMOS TCH/F */
58#define ABIS_RSL_CHAN_NR_CBITS_OSMO_VAMOS_Lm_ACCHs(ss) (0x1e + (ss)) /*< VAMOS TCH/H */
59
Pau Espin Pedrol42908032018-10-10 17:04:28 +020060/* Link Identifier 9.3.2 */
61union abis_rsl_link_id {
62#if OSMO_IS_BIG_ENDIAN
63 uint8_t cbits:2,
64 na:1,
Martin Haukee63b8872018-11-15 14:53:13 +010065 reserved:2,
Pau Espin Pedrol42908032018-10-10 17:04:28 +020066 sapi:3;
67#elif OSMO_IS_LITTLE_ENDIAN
68 uint8_t sapi:3,
69 reserved:2,
70 na:1,
71 cbits:2;
72#endif
73 uint8_t link_id;
74} __attribute__ ((packed));
75#define ABIS_RSL_LINK_ID_CBITS_FACCH_SDCCH 0x00
76#define ABIS_RSL_LINK_ID_CBITS_SACCH 0x01
77
Neels Hofmeyr87e45502017-06-20 00:17:59 +020078/*! RSL common header */
Harald Welteec8b4502010-02-20 20:34:29 +010079struct abis_rsl_common_hdr {
Neels Hofmeyr87e45502017-06-20 00:17:59 +020080 uint8_t msg_discr; /*!< message discriminator (ABIS_RSL_MDISC_*) */
81 uint8_t msg_type; /*!< message type (\ref abis_rsl_msgtype) */
82 uint8_t data[0]; /*!< actual payload data */
Harald Welteec8b4502010-02-20 20:34:29 +010083} __attribute__ ((packed));
84
Neels Hofmeyr87e45502017-06-20 00:17:59 +020085/* RSL RLL header (Chapter 8.3) */
Harald Welteec8b4502010-02-20 20:34:29 +010086struct abis_rsl_rll_hdr {
87 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +020088 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +020089 union {
90 uint8_t chan_nr; /* API backward compat */
91 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
92 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +020093 uint8_t ie_link_id; /*!< \ref RSL_IE_LINK_IDENT (tag) */
Pau Espin Pedrol42908032018-10-10 17:04:28 +020094 union {
95 uint8_t link_id; /* API backward compat */
96 union abis_rsl_link_id link_id_fields; /*!< RSL link identifier (value) */
97 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +020098 uint8_t data[0]; /*!< message payload data */
Harald Welteec8b4502010-02-20 20:34:29 +010099} __attribute__ ((packed));
100
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200101/* RSL Dedicated Channel header (Chapter 8.3 and 8.4) */
Harald Welteec8b4502010-02-20 20:34:29 +0100102struct abis_rsl_dchan_hdr {
103 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200104 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +0200105 union {
106 uint8_t chan_nr; /* API backward compat */
107 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
108 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200109 uint8_t data[0]; /*!< message payload data */
Harald Welteec8b4502010-02-20 20:34:29 +0100110} __attribute__ ((packed));
111
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200112/* RSL Common Channel header (Chapter 8.5) */
Harald Welte6eb7d6c2010-07-13 13:48:13 +0200113struct abis_rsl_cchan_hdr {
114 struct abis_rsl_common_hdr c;
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200115 uint8_t ie_chan; /*!< \ref RSL_IE_CHAN_NR (tag) */
Pau Espin Pedrolfb97e722018-10-10 20:41:40 +0200116 union {
117 uint8_t chan_nr; /* API backward compat */
118 union abis_rsl_chan_nr chan_nr_fields; /*!< RSL channel number (value) */
119 };
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200120 uint8_t data[0]; /*!< message payload data */
Harald Welte6eb7d6c2010-07-13 13:48:13 +0200121} __attribute__ ((packed));
122
Philipp Maier439ddbe2020-11-16 17:49:34 +0100123/* Osmocom specific IE to negotiate repeated ACCH capabilities */
124struct abis_rsl_osmo_rep_acch_cap {
125#if OSMO_IS_BIG_ENDIAN
Philipp Maier595908a2020-11-20 16:13:07 +0100126 uint8_t reserved:1,
127 rxqual:3,
Philipp Maier439ddbe2020-11-16 17:49:34 +0100128 ul_sacch:1,
129 dl_sacch:1,
130 dl_facch_all:1,
131 dl_facch_cmd:1;
132#elif OSMO_IS_LITTLE_ENDIAN
133 uint8_t dl_facch_cmd:1,
134 dl_facch_all:1,
135 dl_sacch:1,
136 ul_sacch:1,
Philipp Maier595908a2020-11-20 16:13:07 +0100137 rxqual:3,
138 reserved:1;
Philipp Maier439ddbe2020-11-16 17:49:34 +0100139#endif
140} __attribute__ ((packed));
Harald Welteec8b4502010-02-20 20:34:29 +0100141
Philipp Maier0e44a722021-08-30 10:51:52 +0200142/* Osmocom specific IE to negotiate temporary overpower of ACCH channels */
143struct abis_rsl_osmo_temp_ovp_acch_cap {
144 uint8_t overpower_db;
145} __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 */
368 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,
Philipp Maiera15967b2020-11-06 21:37:16 +0100371
Harald Welteec8b4502010-02-20 20:34:29 +0100372 /* ip.access */
373 RSL_IE_IPAC_SRTP_CONFIG = 0xe0,
374 RSL_IE_IPAC_PROXY_UDP = 0xe1,
375 RSL_IE_IPAC_BSCMPL_TOUT = 0xe2,
376 RSL_IE_IPAC_REMOTE_IP = 0xf0,
377 RSL_IE_IPAC_REMOTE_PORT = 0xf1,
378 RSL_IE_IPAC_RTP_PAYLOAD = 0xf2,
379 RSL_IE_IPAC_LOCAL_PORT = 0xf3,
380 RSL_IE_IPAC_SPEECH_MODE = 0xf4,
381 RSL_IE_IPAC_LOCAL_IP = 0xf5,
382 RSL_IE_IPAC_CONN_STAT = 0xf6,
383 RSL_IE_IPAC_HO_C_PARMS = 0xf7,
384 RSL_IE_IPAC_CONN_ID = 0xf8,
385 RSL_IE_IPAC_RTP_CSD_FMT = 0xf9,
386 RSL_IE_IPAC_RTP_JIT_BUF = 0xfa,
387 RSL_IE_IPAC_RTP_COMPR = 0xfb,
388 RSL_IE_IPAC_RTP_PAYLOAD2= 0xfc,
389 RSL_IE_IPAC_RTP_MPLEX = 0xfd,
390 RSL_IE_IPAC_RTP_MPLEX_ID= 0xfe,
391};
392
Harald Welte6e363e72016-11-16 16:58:52 +0100393/* Ericsson specific IEs, clash with above partially, so they're not
394 * part of the enum */
Alexander Couzens9f39d892018-04-21 21:20:25 +0200395#define RSL_IE_ERIC_PAGING_GROUP 0x0e
Harald Welte6e363e72016-11-16 16:58:52 +0100396#define RSL_IE_ERIC_INST_NR 0x48
397#define RSL_IE_ERIC_PGSL_TIMERS 0x49
398#define RSL_IE_ERIC_REPEAT_DL_FACCH 0x4a
399#define RSL_IE_ERIC_POWER_INFO 0xf0
400#define RSL_IE_ERIC_MOBILE_ID 0xf1
401#define RSL_IE_ERIC_BCCH_MAPPING 0xf2
402#define RSL_IE_ERIC_PACKET_PAG_IND 0xf3
403#define RSL_IE_ERIC_CNTR_CTRL 0xf4
404#define RSL_IE_ERIC_CNTR_CTRL_ACK 0xf5
405#define RSL_IE_ERIC_CNTR_REPORT 0xf6
406#define RSL_IE_ERIC_ICP_CONN 0xf7
407#define RSL_IE_ERIC_EMR_SUPPORT 0xf8
408#define RSL_IE_ERIC_EGPRS_REQ_REF 0xf9
409#define RSL_IE_ERIC_VGCS_REL 0xfa
410#define RSL_IE_ERIC_REP_PER_NCH 0xfb
411#define RSL_IE_ERIC_NY2 0xfc
412#define RSL_IE_ERIC_T3115 0xfd
413#define RSL_IE_ERIC_ACTIVATE_FLAG 0xfe
414#define RSL_IE_ERIC_FULL_NCH_INFO 0xff
415
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400416/* IPAC MEAS_PREPROC AVERAGING METHOD */
417enum {
418 IPAC_UNWEIGHTED_AVE = 0,
419 IPAC_WEIGHTED_AVE,
Vadim Yanitskiyc8158ec2020-12-15 08:04:30 +0100420 IPAC_MEDIAN_AVE,
421 /* EWMA is an Osmocom specific extension */
422 IPAC_OSMO_EWMA_AVE,
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400423};
424
Pau Espin Pedrol9da16b52021-08-26 15:25:16 +0200425/* IPAC MEAS_PREPROC AVERAGING PARAM ID */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400426enum {
427 IPAC_RXLEV_AVE = 0,
428 IPAC_RXQUAL_AVE,
429 IPAC_MS_BTS_DIS_AVE
430};
431
432/* IPAC MEAS_PREPROC HO CAUSES */
433enum {
434 IPAC_HO_RQD_CAUSE_L_RXLEV_UL_H = 0x01,
435 IPAC_HO_RQD_CAUSE_L_RXLEV_DL_H,
436 IPAC_HO_RQD_CAUSE_L_RXQUAL_UL_H,
437 IPAC_HO_RQD_CAUSE_L_RXQUAL_DL_H,
438 IPAC_HO_RQD_CAUSE_RXLEV_UL_IH,
439 IPAC_HO_RQD_CAUSE_RXLEV_DL_IH,
440 IPAC_HO_RQD_CAUSE_MAX_MS_RANGE,
441 IPAC_HO_RQD_CAUSE_POWER_BUDGET,
442 IPAC_HO_RQD_CAUSE_ENQUIRY,
443 IPAC_HO_RQD_CAUSE_ENQUIRY_FAILED,
444 IPAC_HO_RQD_CAUSE_NORMAL3G,
445 IPAC_HO_RQD_CAUSE_EMERGENCY3G,
446 IPAC_HO_RQD_CAUSE_SERVICE_PREFERRED3G,
447 IPAC_HO_RQD_CAUSE_O_M_SHUTDOWN,
448 IPAC_HO_RQD_CAUSE_QUALITY_PROMOTION,
449 IPAC_HO_RQD_CAUSE_LOAD_PROMOTION,
450 IPAC_HO_RQD_CAUSE_LOAD_DEMOTION,
451 IPAC_HO_RQD_CAUSE_MAX,
452};
453
Harald Welteec8b4502010-02-20 20:34:29 +0100454/* Chapter 9.3.1 */
455#define RSL_CHAN_NR_MASK 0xf8
Neels Hofmeyr15b96ff2016-07-18 23:33:48 +0200456#define RSL_CHAN_NR_1 0x08 /*< bit to add for 2nd,... lchan */
Harald Welteec8b4502010-02-20 20:34:29 +0100457#define RSL_CHAN_Bm_ACCHs 0x08
458#define RSL_CHAN_Lm_ACCHs 0x10 /* .. 0x18 */
459#define RSL_CHAN_SDCCH4_ACCH 0x20 /* .. 0x38 */
460#define RSL_CHAN_SDCCH8_ACCH 0x40 /* ...0x78 */
461#define RSL_CHAN_BCCH 0x80
462#define RSL_CHAN_RACH 0x88
463#define RSL_CHAN_PCH_AGCH 0x90
Neels Hofmeyrfd80f5a2016-07-14 03:21:05 +0200464#define RSL_CHAN_OSMO_PDCH 0xc0 /*< non-standard, for dyn TS */
Harald Weltea8d7ebb2019-05-27 16:51:23 +0200465#define RSL_CHAN_OSMO_CBCH4 0xc8 /*< non-standard, for CBCH/SDCCH4 */
466#define RSL_CHAN_OSMO_CBCH8 0xd0 /*< non-standard, for CBCH/SDCCH8 */
Harald Welteec8b4502010-02-20 20:34:29 +0100467
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +0200468/* non-standard, Osmocom specific Bm/Lm equivalents for VAMOS */
469#define RSL_CHAN_OSMO_VAMOS_Bm_ACCHs 0xe8 /* VAMOS TCH/F */
470#define RSL_CHAN_OSMO_VAMOS_Lm_ACCHs 0xf0 /* VAMOS TCH/H */
Vadim Yanitskiy442ff642021-06-01 19:55:43 +0200471#define RSL_CHAN_OSMO_VAMOS_MASK 0xe0 /* VAMOS TCH/{F,H} */
Vadim Yanitskiyfc02ff42021-05-26 18:19:03 +0200472
Harald Welteec8b4502010-02-20 20:34:29 +0100473/* Chapter 9.3.3 */
474#define RSL_ACT_TYPE_INITIAL 0x00
475#define RSL_ACT_TYPE_REACT 0x80
476#define RSL_ACT_INTRA_IMM_ASS 0x00
477#define RSL_ACT_INTRA_NORM_ASS 0x01
478#define RSL_ACT_INTER_ASYNC 0x02
479#define RSL_ACT_INTER_SYNC 0x03
480#define RSL_ACT_SECOND_ADD 0x04
481#define RSL_ACT_SECOND_MULTI 0x05
Neels Hofmeyrfd80f5a2016-07-14 03:21:05 +0200482#define RSL_ACT_OSMO_PDCH 0x0f /*< non-standard, for dyn TS */
Harald Welteec8b4502010-02-20 20:34:29 +0100483
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200484/*! RSL Channel Mode IF (Chapter 9.3.6) */
Harald Welteec8b4502010-02-20 20:34:29 +0100485struct rsl_ie_chan_mode {
486 uint8_t dtx_dtu;
487 uint8_t spd_ind;
488 uint8_t chan_rt;
489 uint8_t chan_rate;
490} __attribute__ ((packed));
491#define RSL_CMOD_DTXu 0x01 /* uplink */
492#define RSL_CMOD_DTXd 0x02 /* downlink */
493enum rsl_cmod_spd {
494 RSL_CMOD_SPD_SPEECH = 0x01,
495 RSL_CMOD_SPD_DATA = 0x02,
496 RSL_CMOD_SPD_SIGN = 0x03,
497};
Vadim Yanitskiy307b2012021-04-19 04:42:34 +0200498#define RSL_CMOD_CRT_SDCCH 0x01
499#define RSL_CMOD_CRT_TCH_Bm 0x08 /* full-rate */
500#define RSL_CMOD_CRT_TCH_Lm 0x09 /* half-rate */
501#define RSL_CMOD_CRT_TCH_BI_Bm 0x0a /* full-rate: bi-directional (multislot) */
502#define RSL_CMOD_CRT_TCH_UNI_Bm 0x1a /* full-rate: uni-directional (multislot) */
503#define RSL_CMOD_CRT_TCH_GROUP_Bm 0x18 /* full-rate: group call channel */
504#define RSL_CMOD_CRT_TCH_GROUP_Lm 0x19 /* half-rate: group call channel */
505#define RSL_CMOD_CRT_TCH_BCAST_Bm 0x28 /* full-rate: broadcast call channel */
506#define RSL_CMOD_CRT_TCH_BCAST_Lm 0x29 /* half-rate: broadcast call channel */
Neels Hofmeyrfef61cd2021-04-22 21:54:31 +0200507#define RSL_CMOD_CRT_OSMO_TCH_VAMOS_Bm 0x88 /* full-rate in VAMOS mode */
508#define RSL_CMOD_CRT_OSMO_TCH_VAMOS_Lm 0x89 /* half-rate in VAMOS mode */
Harald Welteec8b4502010-02-20 20:34:29 +0100509/* Speech */
510#define RSL_CMOD_SP_GSM1 0x01
511#define RSL_CMOD_SP_GSM2 0x11
512#define RSL_CMOD_SP_GSM3 0x21
Vadim Yanitskiy99f6cd52021-04-19 04:26:10 +0200513#define RSL_CMOD_SP_GSM4 0x31
514#define RSL_CMOD_SP_GSM5 0x09
515#define RSL_CMOD_SP_GSM6 0x0d
Vadim Yanitskiye731a7d2021-04-19 04:59:51 +0200516/* non-transparent data (asymmetric) */
517#define RSL_CMOD_CSD_NTA_43k5_14k5 0x61 /* asymmetric 43.5 kbit/s (DL) + 14.5 kbit/s (UL) */
518#define RSL_CMOD_CSD_NTA_29k0_14k5 0x62 /* asymmetric 29.0 kbit/s (DL) + 14.5 kbit/s (UL) */
519#define RSL_CMOD_CSD_NTA_43k5_29k0 0x63 /* asymmetric 43.5 kbit/s (DL) + 29.0 kbit/s (UL) */
520#define RSL_CMOD_CSD_NTA_14k5_43k5 0x69 /* asymmetric 14.5 kbit/s (DL) + 43.5 kbit/s (UL) */
521#define RSL_CMOD_CSD_NTA_14k5_29k0 0x6a /* asymmetric 14.5 kbit/s (DL) + 29.0 kbit/s (UL) */
522#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 +0200523/* non-transparent data */
524#define RSL_CMOD_CSD_NT_43k5 0x74
525#define RSL_CMOD_CSD_NT_28k8 0x71
526#define RSL_CMOD_CSD_NT_14k5 0x58
527#define RSL_CMOD_CSD_NT_12k0 0x50
528#define RSL_CMOD_CSD_NT_6k0 0x51
529/* legacy #defines with wrong name */
530#define RSL_CMOD_SP_NT_14k5 RSL_CMOD_CSD_NT_14k5
531#define RSL_CMOD_SP_NT_12k0 RSL_CMOD_CSD_NT_12k0
532#define RSL_CMOD_SP_NT_6k0 RSL_CMOD_CSD_NT_6k0
533/* transparent data */
534#define RSL_CMOD_CSD_T_32000 0x38
535#define RSL_CMOD_CSD_T_29000 0x39
536#define RSL_CMOD_CSD_T_14400 0x18
537#define RSL_CMOD_CSD_T_9600 0x10
538#define RSL_CMOD_CSD_T_4800 0x11
539#define RSL_CMOD_CSD_T_2400 0x12
540#define RSL_CMOD_CSD_T_1200 0x13
541#define RSL_CMOD_CSD_T_600 0x14
542#define RSL_CMOD_CSD_T_1200_75 0x15
Harald Welteec8b4502010-02-20 20:34:29 +0100543
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200544/*! RSL Channel Identification IE (Chapter 9.3.5) */
Harald Welteec8b4502010-02-20 20:34:29 +0100545struct rsl_ie_chan_ident {
546 /* GSM 04.08 10.5.2.5 */
547 struct {
548 uint8_t iei;
549 uint8_t chan_nr; /* enc_chan_nr */
550 uint8_t oct3;
551 uint8_t oct4;
552 } chan_desc;
553#if 0 /* spec says we need this but Abissim doesn't use it */
554 struct {
555 uint8_t tag;
556 uint8_t len;
557 } mobile_alloc;
558#endif
559} __attribute__ ((packed));
560
561/* Chapter 9.3.22 */
562#define RLL_CAUSE_T200_EXPIRED 0x01
563#define RLL_CAUSE_REEST_REQ 0x02
564#define RLL_CAUSE_UNSOL_UA_RESP 0x03
565#define RLL_CAUSE_UNSOL_DM_RESP 0x04
566#define RLL_CAUSE_UNSOL_DM_RESP_MF 0x05
567#define RLL_CAUSE_UNSOL_SPRV_RESP 0x06
568#define RLL_CAUSE_SEQ_ERR 0x07
569#define RLL_CAUSE_UFRM_INC_PARAM 0x08
570#define RLL_CAUSE_SFRM_INC_PARAM 0x09
571#define RLL_CAUSE_IFRM_INC_MBITS 0x0a
572#define RLL_CAUSE_IFRM_INC_LEN 0x0b
573#define RLL_CAUSE_FRM_UNIMPL 0x0c
574#define RLL_CAUSE_SABM_MF 0x0d
575#define RLL_CAUSE_SABM_INFO_NOTALL 0x0e
576
577/* Chapter 9.3.26 */
578#define RSL_ERRCLS_NORMAL 0x00
579#define RSL_ERRCLS_RESOURCE_UNAVAIL 0x20
580#define RSL_ERRCLS_SERVICE_UNAVAIL 0x30
581#define RSL_ERRCLS_SERVICE_UNIMPL 0x40
582#define RSL_ERRCLS_INVAL_MSG 0x50
583#define RSL_ERRCLS_PROTO_ERROR 0x60
584#define RSL_ERRCLS_INTERWORKING 0x70
585
586/* normal event */
587#define RSL_ERR_RADIO_IF_FAIL 0x00
588#define RSL_ERR_RADIO_LINK_FAIL 0x01
589#define RSL_ERR_HANDOVER_ACC_FAIL 0x02
590#define RSL_ERR_TALKER_ACC_FAIL 0x03
591#define RSL_ERR_OM_INTERVENTION 0x07
592#define RSL_ERR_NORMAL_UNSPEC 0x0f
593#define RSL_ERR_T_MSRFPCI_EXP 0x18
594/* resource unavailable */
595#define RSL_ERR_EQUIPMENT_FAIL 0x20
596#define RSL_ERR_RR_UNAVAIL 0x21
597#define RSL_ERR_TERR_CH_FAIL 0x22
598#define RSL_ERR_CCCH_OVERLOAD 0x23
599#define RSL_ERR_ACCH_OVERLOAD 0x24
600#define RSL_ERR_PROCESSOR_OVERLOAD 0x25
Philipp Maier6d214482020-07-28 16:53:27 +0200601#define RSL_ERR_BTS_NOT_EQUIPPED 0x27
602#define RSL_ERR_REMOTE_TRANSC_FAIL 0x28
603#define RSL_ERR_NOTIFICATION_OVERFL 0x29
Harald Welteec8b4502010-02-20 20:34:29 +0100604#define RSL_ERR_RES_UNAVAIL 0x2f
605/* service or option not available */
606#define RSL_ERR_TRANSC_UNAVAIL 0x30
607#define RSL_ERR_SERV_OPT_UNAVAIL 0x3f
608/* service or option not implemented */
609#define RSL_ERR_ENCR_UNIMPL 0x40
610#define RSL_ERR_SERV_OPT_UNIMPL 0x4f
611/* invalid message */
612#define RSL_ERR_RCH_ALR_ACTV_ALLOC 0x50
613#define RSL_ERR_INVALID_MESSAGE 0x5f
614/* protocol error */
615#define RSL_ERR_MSG_DISCR 0x60
616#define RSL_ERR_MSG_TYPE 0x61
617#define RSL_ERR_MSG_SEQ 0x62
618#define RSL_ERR_IE_ERROR 0x63
619#define RSL_ERR_MAND_IE_ERROR 0x64
620#define RSL_ERR_OPT_IE_ERROR 0x65
621#define RSL_ERR_IE_NONEXIST 0x66
622#define RSL_ERR_IE_LENGTH 0x67
623#define RSL_ERR_IE_CONTENT 0x68
624#define RSL_ERR_PROTO 0x6f
625/* interworking */
626#define RSL_ERR_INTERWORKING 0x7f
627
628/* Chapter 9.3.30 */
629#define RSL_SYSTEM_INFO_8 0x00
630#define RSL_SYSTEM_INFO_1 0x01
631#define RSL_SYSTEM_INFO_2 0x02
632#define RSL_SYSTEM_INFO_3 0x03
633#define RSL_SYSTEM_INFO_4 0x04
634#define RSL_SYSTEM_INFO_5 0x05
635#define RSL_SYSTEM_INFO_6 0x06
636#define RSL_SYSTEM_INFO_7 0x07
637#define RSL_SYSTEM_INFO_16 0x08
638#define RSL_SYSTEM_INFO_17 0x09
639#define RSL_SYSTEM_INFO_2bis 0x0a
640#define RSL_SYSTEM_INFO_2ter 0x0b
641#define RSL_SYSTEM_INFO_5bis 0x0d
642#define RSL_SYSTEM_INFO_5ter 0x0e
643#define RSL_SYSTEM_INFO_10 0x0f
Harald Welte3d732272011-06-25 21:39:01 +0200644#define RSL_EXT_MEAS_ORDER 0x47
Harald Welteec8b4502010-02-20 20:34:29 +0100645#define RSL_MEAS_INFO 0x48
646#define RSL_SYSTEM_INFO_13 0x28
Philipp00b15392016-11-14 12:34:15 +0100647#define RSL_ERIC_SYSTEM_INFO_13 0x0C
Harald Welteec8b4502010-02-20 20:34:29 +0100648#define RSL_SYSTEM_INFO_2quater 0x29
649#define RSL_SYSTEM_INFO_9 0x2a
650#define RSL_SYSTEM_INFO_18 0x2b
651#define RSL_SYSTEM_INFO_19 0x2c
652#define RSL_SYSTEM_INFO_20 0x2d
653
654/* Chapter 9.3.40 */
655#define RSL_CHANNEED_ANY 0x00
656#define RSL_CHANNEED_SDCCH 0x01
657#define RSL_CHANNEED_TCH_F 0x02
658#define RSL_CHANNEED_TCH_ForH 0x03
659
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200660/*! RSL Cell Broadcast Command (Chapter 9.3.45) */
Alex Badea84930182010-11-27 23:34:46 +0200661struct rsl_ie_cb_cmd_type {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100662#if OSMO_IS_LITTLE_ENDIAN
Alex Badea84930182010-11-27 23:34:46 +0200663 uint8_t last_block:2;
664 uint8_t spare:1;
665 uint8_t def_bcast:1;
666 uint8_t command:4;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100667#elif OSMO_IS_BIG_ENDIAN
668/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
669 uint8_t command:4, def_bcast:1, spare:1, last_block:2;
670#endif
Alex Badea84930182010-11-27 23:34:46 +0200671} __attribute__ ((packed));
672/* ->command */
673#define RSL_CB_CMD_TYPE_NORMAL 0x00
674#define RSL_CB_CMD_TYPE_SCHEDULE 0x08
675#define RSL_CB_CMD_TYPE_DEFAULT 0x0e
676#define RSL_CB_CMD_TYPE_NULL 0x0f
677/* ->def_bcast */
678#define RSL_CB_CMD_DEFBCAST_NORMAL 0
679#define RSL_CB_CMD_DEFBCAST_NULL 1
680/* ->last_block */
681#define RSL_CB_CMD_LASTBLOCK_4 0
682#define RSL_CB_CMD_LASTBLOCK_1 1
683#define RSL_CB_CMD_LASTBLOCK_2 2
684#define RSL_CB_CMD_LASTBLOCK_3 3
685
Harald Welteec8b4502010-02-20 20:34:29 +0100686/* Chapter 3.3.2.3 Brocast control channel */
687/* CCCH-CONF, NC is not combined */
688#define RSL_BCCH_CCCH_CONF_1_NC 0x00
689#define RSL_BCCH_CCCH_CONF_1_C 0x01
690#define RSL_BCCH_CCCH_CONF_2_NC 0x02
691#define RSL_BCCH_CCCH_CONF_3_NC 0x04
692#define RSL_BCCH_CCCH_CONF_4_NC 0x06
693
694/* BS-PA-MFRMS */
695#define RSL_BS_PA_MFRMS_2 0x00
696#define RSL_BS_PA_MFRMS_3 0x01
697#define RSL_BS_PA_MFRMS_4 0x02
698#define RSL_BS_PA_MFRMS_5 0x03
699#define RSL_BS_PA_MFRMS_6 0x04
700#define RSL_BS_PA_MFRMS_7 0x05
701#define RSL_BS_PA_MFRMS_8 0x06
702#define RSL_BS_PA_MFRMS_9 0x07
703
704/* RSL_IE_IPAC_RTP_PAYLOAD[2] */
705enum rsl_ipac_rtp_payload {
706 RSL_IPAC_RTP_GSM = 1,
707 RSL_IPAC_RTP_EFR,
708 RSL_IPAC_RTP_AMR,
709 RSL_IPAC_RTP_CSD,
710 RSL_IPAC_RTP_MUX,
711};
712
713/* RSL_IE_IPAC_SPEECH_MODE, lower four bits */
714enum rsl_ipac_speech_mode_s {
715 RSL_IPAC_SPEECH_GSM_FR = 0, /* GSM FR (Type 1, FS) */
716 RSL_IPAC_SPEECH_GSM_EFR = 1, /* GSM EFR (Type 2, FS) */
717 RSL_IPAC_SPEECH_GSM_AMR_FR = 2, /* GSM AMR/FR (Type 3, FS) */
718 RSL_IPAC_SPEECH_GSM_HR = 3, /* GSM HR (Type 1, HS) */
719 RSL_IPAC_SPEECH_GSM_AMR_HR = 5, /* GSM AMR/hr (Type 3, HS) */
720 RSL_IPAC_SPEECH_AS_RTP = 0xf, /* As specified by RTP Payload IE */
721};
722/* RSL_IE_IPAC_SPEECH_MODE, upper four bits */
723enum rsl_ipac_speech_mode_m {
724 RSL_IPAC_SPEECH_M_RXTX = 0, /* Send and Receive */
725 RSL_IPAC_SPEECH_M_RX = 1, /* Receive only */
726 RSL_IPAC_SPEECH_M_TX = 2, /* Send only */
727};
728
729/* RSL_IE_IPAC_RTP_CSD_FMT, lower four bits */
730enum rsl_ipac_rtp_csd_format_d {
731 RSL_IPAC_RTP_CSD_EXT_TRAU = 0,
732 RSL_IPAC_RTP_CSD_NON_TRAU = 1,
733 RSL_IPAC_RTP_CSD_TRAU_BTS = 2,
734 RSL_IPAC_RTP_CSD_IWF_FREE = 3,
735};
736/* RSL_IE_IPAC_RTP_CSD_FMT, upper four bits */
737enum rsl_ipac_rtp_csd_format_ir {
738 RSL_IPAC_RTP_CSD_IR_8k = 0,
739 RSL_IPAC_RTP_CSD_IR_16k = 1,
740 RSL_IPAC_RTP_CSD_IR_32k = 2,
741 RSL_IPAC_RTP_CSD_IR_64k = 3,
742};
743
744/* Siemens vendor-specific RSL extensions */
745struct rsl_mrpci {
746 uint8_t power_class:3,
747 vgcs_capable:1,
748 vbs_capable:1,
749 gsm_phase:2;
750} __attribute__ ((packed));
751
752enum rsl_mrpci_pwrclass {
753 RSL_MRPCI_PWRC_1 = 0,
754 RSL_MRPCI_PWRC_2 = 1,
755 RSL_MRPCI_PWRC_3 = 2,
756 RSL_MRPCI_PWRC_4 = 3,
757 RSL_MRPCI_PWRC_5 = 4,
758};
759enum rsl_mrpci_phase {
760 RSL_MRPCI_PHASE_1 = 0,
761 /* reserved */
762 RSL_MRPCI_PHASE_2 = 2,
763 RSL_MRPCI_PHASE_2PLUS = 3,
764};
765
Holger Hans Peter Freyther0357e9b2012-12-06 11:57:31 +0100766/* 9.3.20 Release Mode */
767enum rsl_rel_mode {
768 RSL_REL_NORMAL = 0,
769 RSL_REL_LOCAL_END = 1,
770};
771
Neels Hofmeyr87e45502017-06-20 00:17:59 +0200772/*! ip.access specific embedded information elements */
Harald Weltefad57522015-12-13 11:56:36 +0100773enum rsl_ipac_embedded_ie {
774 RSL_IPAC_EIE_RXLEV = 0x00,
775 RSL_IPAC_EIE_RXQUAL = 0x01,
776 RSL_IPAC_EIE_FREQ_ERR = 0x02,
777 RSL_IPAC_EIE_TIMING_ERR = 0x03,
778 RSL_IPAC_EIE_MEAS_AVG_CFG = 0x04,
779 RSL_IPAC_EIE_BS_PWR_CTL = 0x05,
780 RSL_IPAC_EIE_MS_PWR_CTL = 0x06,
781 RSL_IPAC_EIE_HANDO_THRESH = 0x07,
782 RSL_IPAC_EIE_NCELL_DEFAULTS = 0x08,
783 RSL_IPAC_EIE_NCELL_LIST = 0x09,
784 RSL_IPAC_EIE_PC_THRESH_COMP = 0x0a,
785 RSL_IPAC_EIE_HO_THRESH_COMP = 0x0b,
786 RSL_IPAC_EIE_HO_CAUSE = 0x0c,
787 RSL_IPAC_EIE_HO_CANDIDATES = 0x0d,
788 RSL_IPAC_EIE_NCELL_BA_CHG_LIST = 0x0e,
789 RSL_IPAC_EIE_NUM_OF_MS = 0x10,
790 RSL_IPAC_EIE_HO_CAND_EXT = 0x11,
791 RSL_IPAC_EIE_NCELL_DEF_EXT = 0x12,
792 RSL_IPAC_EIE_NCELL_LIST_EXT = 0x13,
793 RSL_IPAC_EIE_MASTER_KEY = 0x14,
794 RSL_IPAC_EIE_MASTER_SALT = 0x15,
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400795 /* additional IPAC measurement pre-processing related IEI */
796 RSL_IPAC_EIE_MEAS_TRANS_RES = 0x16,
797 RSL_IPAC_EIE_3G_HO_PARAM = 0x17,
798 RSL_IPAC_EIE_3G_NCELL_LIST = 0x18,
799 RSL_IPAC_EIE_SDCCH_CTL_PARAM = 0x1a,
800 RSL_IPAC_EIE_AMR_CONV_THRESH = 0x1b,
801
802};
803
804struct ipac_preproc_ave_cfg {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100805#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400806 uint8_t h_reqave:5,
807 param_id:2,
808 reserved:1;
809 uint8_t h_reqt:5,
810 ave_method:3;
Vadim Yanitskiy8f5844e2020-12-25 00:19:45 +0100811 uint8_t params[0];
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100812#elif OSMO_IS_BIG_ENDIAN
813/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
814 uint8_t reserved:1, param_id:2, h_reqave:5;
815 uint8_t ave_method:3, h_reqt:5;
Vadim Yanitskiy8f5844e2020-12-25 00:19:45 +0100816 uint8_t params[0];
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100817#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400818}__attribute__ ((packed));
819
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100820/*! MS/BS Power Control Thresholds */
821struct ipac_preproc_pc_thresh {
822#if OSMO_IS_LITTLE_ENDIAN
823 uint8_t l_rxlev:6, reserved_l_rxlev:2;
824 uint8_t u_rxlev:6, reserved_u_rxlev:2;
Vadim Yanitskiy2060bbb2020-12-19 17:33:41 +0100825 uint8_t u_rxqual:3, reserved_u_rxqual:1,
826 l_rxqual:3, reserved_l_rxqual:1;
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100827#elif OSMO_IS_BIG_ENDIAN
828 uint8_t reserved_l_rxlev:2, l_rxlev:6;
829 uint8_t reserved_u_rxlev:2, u_rxlev:6;
830 uint8_t reserved_l_rxqual:1, l_rxqual:3,
831 reserved_u_rxqual:1, u_rxqual:3;
832#endif
833}__attribute__ ((packed));
834
835/*! Handover Thresholds */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400836struct ipac_preproc_ho_thresh {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100837#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400838 uint8_t l_rxlev_ul_h:6,
839 reserved_l_rxlev_ul:2;
840 uint8_t l_rxlev_dl_h:6,
841 reserved_l_rxlev_dl:2;
842 uint8_t rxlev_ul_ih:6,
843 reserved_rxlev_ul:2;
844 uint8_t rxlev_dl_ih:6,
845 reserved_rxlev_dl:2;
846 uint8_t l_rxqual_ul_h:3,
847 reserved_rxlqual_ul:1,
848 l_rxqual_dl_h:3,
849 reserved_rxqual_dl:1;
850 uint8_t ms_range_max:6,
851 reserved_ms_range:2;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100852#elif OSMO_IS_BIG_ENDIAN
853/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
854 uint8_t reserved_l_rxlev_ul:2, l_rxlev_ul_h:6;
855 uint8_t reserved_l_rxlev_dl:2, l_rxlev_dl_h:6;
856 uint8_t reserved_rxlev_ul:2, rxlev_ul_ih:6;
857 uint8_t reserved_rxlev_dl:2, rxlev_dl_ih:6;
858 uint8_t reserved_rxqual_dl:1, l_rxqual_dl_h:3, reserved_rxlqual_ul:1, l_rxqual_ul_h:3;
859 uint8_t reserved_ms_range:2, ms_range_max:6;
860#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400861}__attribute__ ((packed));
862
Vadim Yanitskiya346c452020-12-15 07:48:58 +0100863/*! PC Threshold Comparators */
864struct ipac_preproc_pc_comp {
865#if OSMO_IS_LITTLE_ENDIAN
866 uint8_t p1:5, reserved_p1:3;
867 uint8_t n1:5, reserved_n1:3;
868 uint8_t p2:5, reserved_p2:3;
869 uint8_t n2:5, reserved_n2:3;
870 uint8_t p3:5, reserved_p3:3;
871 uint8_t n3:5, reserved_n3:3;
872 uint8_t p4:5, reserved_p4:3;
873 uint8_t n4:5, reserved_n4:3;
874 uint8_t pc_interval:5, reserved_pc:3;
875 uint8_t red_step_size:4, inc_step_size:4;
876#elif OSMO_IS_BIG_ENDIAN
877 uint8_t reserved_p1:3, p1:5;
878 uint8_t reserved_n1:3, n1:5;
879 uint8_t reserved_p2:3, p2:5;
880 uint8_t reserved_n2:3, n2:5;
881 uint8_t reserved_p3:3, p3:5;
882 uint8_t reserved_n3:3, n3:5;
883 uint8_t reserved_p4:3, p4:5;
884 uint8_t reserved_n4:3, n4:5;
885 uint8_t reserved_pc:3, pc_interval:5;
886 uint8_t inc_step_size:4, red_step_size:4;
887#endif
888}__attribute__ ((packed));
889
890/*! HO Threshold Comparators */
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400891struct ipac_preproc_ho_comp {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100892#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400893 uint8_t p5:5,
894 reserved_p5:3;
895 uint8_t n5:5,
896 reserved_n5:3;
897 uint8_t p6:5,
898 reserved_p6:3;
899 uint8_t n6:5,
900 reserved_n6:3;
901 uint8_t p7:5,
902 reserved_p7:3;
903 uint8_t n7:5,
904 reserved_n7:3;
905 uint8_t p8:5,
906 reserved_p8:3;
907 uint8_t n8:5,
908 reserved_n8:3;
909 uint8_t ho_interval:5,
910 reserved_ho:3;
911 uint8_t reserved;
912
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100913#elif OSMO_IS_BIG_ENDIAN
914/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
915 uint8_t reserved_p5:3, p5:5;
916 uint8_t reserved_n5:3, n5:5;
917 uint8_t reserved_p6:3, p6:5;
918 uint8_t reserved_n6:3, n6:5;
919 uint8_t reserved_p7:3, p7:5;
920 uint8_t reserved_n7:3, n7:5;
921 uint8_t reserved_p8:3, p8:5;
922 uint8_t reserved_n8:3, n8:5;
923 uint8_t reserved_ho:3, ho_interval:5;
924 uint8_t reserved;
925#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400926}__attribute__ ((packed));
927
928struct ipac_preproc_ho_candidates {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100929#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400930 uint8_t bsic:6,
931 reserved0:2;
932 uint8_t bcch_freq:5,
933 ba_used:1,
934 s:1,
935 reserved1:1;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100936#elif OSMO_IS_BIG_ENDIAN
937/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
938 uint8_t reserved0:2, bsic:6;
939 uint8_t reserved1:1, s:1, ba_used:1, bcch_freq:5;
940#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400941}__attribute__ ((packed));
942
943struct ipac_preproc_ncell_dflts {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100944#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400945 uint8_t rxlev_min_def:6,
946 reserved_rxlev_min_def:2;
947 uint8_t ho_margin_def:5,
948 reserved_ho_margin_def:3;
949 uint8_t ms_txpwr_max_def:5,
950 reserved_ms_txpwr_max_def:3;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100951#elif OSMO_IS_BIG_ENDIAN
952/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
953 uint8_t reserved_rxlev_min_def:2, rxlev_min_def:6;
954 uint8_t reserved_ho_margin_def:3, ho_margin_def:5;
955 uint8_t reserved_ms_txpwr_max_def:3, ms_txpwr_max_def:5;
956#endif
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400957}__attribute__ ((packed));
958
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -0500959struct ipac_preproc_ho_ctl_param {
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100960#if OSMO_IS_LITTLE_ENDIAN
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -0500961 uint8_t sdcch_ho_gsm:1,
962 sdcch_ho_umts:1,
963 reserved:6;
Neels Hofmeyrb2600392018-11-16 00:20:39 +0100964#elif OSMO_IS_BIG_ENDIAN
965/* auto-generated from the little endian part above (libosmocore/contrib/struct_endianess.py) */
966 uint8_t reserved:6, sdcch_ho_umts:1, sdcch_ho_gsm:1;
967#endif
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -0500968}__attribute__ ((packed));
969
Minh-Quang Nguyen17a87482016-09-02 11:28:31 -0400970struct ipac_preproc_cfg {
971 uint8_t meas_rep_mode;
972 uint32_t meas_mode_flags;
973 struct ipac_preproc_ave_cfg ms_ave_cfg[3];
974 struct ipac_preproc_ave_cfg ave_cfg;
975 struct ipac_preproc_ho_thresh ho_thresh;
976 struct ipac_preproc_ho_comp ho_comp;
977 struct ipac_preproc_ncell_dflts ncell_dflts;
Minh-Quang Nguyenadc28dc2017-02-06 11:13:31 -0500978 struct ipac_preproc_ho_ctl_param ho_ctl_param;
Harald Weltefad57522015-12-13 11:56:36 +0100979};
980
Philipp Maierca770ae2021-02-16 17:31:22 +0100981struct rsl_l1_info {
982#if OSMO_IS_BIG_ENDIAN
983 uint8_t ms_pwr:5,
984 fpc_epc:1,
985 srr_sro:1,
986 reserved:1;
987 uint8_t ta;
988#elif OSMO_IS_LITTLE_ENDIAN
989 uint8_t reserved:1,
990 srr_sro:1,
991 fpc_epc:1,
992 ms_pwr:5;
993 uint8_t ta;
994#endif
995} __attribute__ ((packed));
996
Sylvain Munautdca7d2c2012-04-18 21:53:23 +0200997/*! @} */