libosmogsm  0.9.6-11.20170220git32ee5af8.fc31
Osmocom GSM library
gsm_12_21.h
Go to the documentation of this file.
1 #pragma once
2 
3 /* GSM Network Management messages on the A-bis interface
4  * 3GPP TS 12.21 version 8.0.0 Release 1999 / ETSI TS 100 623 V8.0.0 */
5 
6 /* (C) 2008-2009 by Harald Welte <laforge@gnumonks.org>
7  * All Rights Reserved
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License along
20  * with this program; if not, write to the Free Software Foundation, Inc.,
21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22  *
23  */
24 
31 #include <stdint.h>
32 #include <osmocom/gsm/tlv.h>
33 
35 struct abis_om_hdr {
37  uint8_t mdisc;
39  uint8_t placement;
41  uint8_t sequence;
43  uint8_t length;
45  uint8_t data[0];
46 } __attribute__ ((packed));
47 
48 #define ABIS_NM_MSG_SIZE 1024
49 #define ABIS_NM_MSG_HEADROOM 128
50 
52 #define ABIS_OM_MDISC_FOM 0x80
53 
54 #define ABIS_OM_MDISC_MMI 0x40
55 
56 #define ABIS_OM_MDISC_TRAU 0x20
57 
58 #define ABIS_OM_MDISC_MANUF 0x10
59 
61 #define ABIS_OM_PLACEMENT_ONLY 0x80
62 
63 #define ABIS_OM_PLACEMENT_FIRST 0x40
64 
65 #define ABIS_OM_PLACEMENT_MIDDLE 0x20
66 
67 #define ABIS_OM_PLACEMENT_LAST 0x10
68 
71  uint8_t bts_nr;
72  uint8_t trx_nr;
73  uint8_t ts_nr;
74 } __attribute__ ((packed));
75 
78  uint8_t msg_type;
79  uint8_t obj_class;
81  uint8_t data[0];
82 } __attribute__ ((packed));
83 
85 #define ABIS_OM_FOM_HDR_SIZE (sizeof(struct abis_om_hdr) + sizeof(struct abis_om_fom_hdr))
86 
89  /* SW Download Management Messages */
90  NM_MT_LOAD_INIT = 0x01,
91  NM_MT_LOAD_INIT_ACK,
92  NM_MT_LOAD_INIT_NACK,
93  NM_MT_LOAD_SEG,
94  NM_MT_LOAD_SEG_ACK,
95  NM_MT_LOAD_ABORT,
96  NM_MT_LOAD_END,
97  NM_MT_LOAD_END_ACK,
98  NM_MT_LOAD_END_NACK,
99  NM_MT_SW_ACT_REQ, /* BTS->BSC */
100  NM_MT_SW_ACT_REQ_ACK,
101  NM_MT_SW_ACT_REQ_NACK,
102  NM_MT_ACTIVATE_SW, /* BSC->BTS */
103  NM_MT_ACTIVATE_SW_ACK,
104  NM_MT_ACTIVATE_SW_NACK,
105  NM_MT_SW_ACTIVATED_REP, /* 0x10 */
106  /* A-bis Interface Management Messages */
107  NM_MT_ESTABLISH_TEI = 0x21,
108  NM_MT_ESTABLISH_TEI_ACK,
109  NM_MT_ESTABLISH_TEI_NACK,
110  NM_MT_CONN_TERR_SIGN,
111  NM_MT_CONN_TERR_SIGN_ACK,
112  NM_MT_CONN_TERR_SIGN_NACK,
113  NM_MT_DISC_TERR_SIGN,
114  NM_MT_DISC_TERR_SIGN_ACK,
115  NM_MT_DISC_TERR_SIGN_NACK,
116  NM_MT_CONN_TERR_TRAF,
117  NM_MT_CONN_TERR_TRAF_ACK,
118  NM_MT_CONN_TERR_TRAF_NACK,
119  NM_MT_DISC_TERR_TRAF,
120  NM_MT_DISC_TERR_TRAF_ACK,
121  NM_MT_DISC_TERR_TRAF_NACK,
122  /* Transmission Management Messages */
123  NM_MT_CONN_MDROP_LINK = 0x31,
124  NM_MT_CONN_MDROP_LINK_ACK,
125  NM_MT_CONN_MDROP_LINK_NACK,
126  NM_MT_DISC_MDROP_LINK,
127  NM_MT_DISC_MDROP_LINK_ACK,
128  NM_MT_DISC_MDROP_LINK_NACK,
129  /* Air Interface Management Messages */
130  NM_MT_SET_BTS_ATTR = 0x41,
131  NM_MT_SET_BTS_ATTR_ACK,
132  NM_MT_SET_BTS_ATTR_NACK,
133  NM_MT_SET_RADIO_ATTR,
134  NM_MT_SET_RADIO_ATTR_ACK,
135  NM_MT_SET_RADIO_ATTR_NACK,
136  NM_MT_SET_CHAN_ATTR,
137  NM_MT_SET_CHAN_ATTR_ACK,
138  NM_MT_SET_CHAN_ATTR_NACK,
139  /* Test Management Messages */
140  NM_MT_PERF_TEST = 0x51,
141  NM_MT_PERF_TEST_ACK,
142  NM_MT_PERF_TEST_NACK,
143  NM_MT_TEST_REP,
144  NM_MT_SEND_TEST_REP,
145  NM_MT_SEND_TEST_REP_ACK,
146  NM_MT_SEND_TEST_REP_NACK,
147  NM_MT_STOP_TEST,
148  NM_MT_STOP_TEST_ACK,
149  NM_MT_STOP_TEST_NACK,
150  /* State Management and Event Report Messages */
151  NM_MT_STATECHG_EVENT_REP = 0x61,
152  NM_MT_FAILURE_EVENT_REP,
153  NM_MT_STOP_EVENT_REP,
154  NM_MT_STOP_EVENT_REP_ACK,
155  NM_MT_STOP_EVENT_REP_NACK,
156  NM_MT_REST_EVENT_REP,
157  NM_MT_REST_EVENT_REP_ACK,
158  NM_MT_REST_EVENT_REP_NACK,
159  NM_MT_CHG_ADM_STATE,
160  NM_MT_CHG_ADM_STATE_ACK,
161  NM_MT_CHG_ADM_STATE_NACK,
162  NM_MT_CHG_ADM_STATE_REQ,
163  NM_MT_CHG_ADM_STATE_REQ_ACK,
164  NM_MT_CHG_ADM_STATE_REQ_NACK,
165  NM_MT_REP_OUTST_ALARMS = 0x93,
166  NM_MT_REP_OUTST_ALARMS_ACK,
167  NM_MT_REP_OUTST_ALARMS_NACK,
168  /* Equipment Management Messages */
169  NM_MT_CHANGEOVER = 0x71,
170  NM_MT_CHANGEOVER_ACK,
171  NM_MT_CHANGEOVER_NACK,
172  NM_MT_OPSTART,
173  NM_MT_OPSTART_ACK,
174  NM_MT_OPSTART_NACK,
175  NM_MT_REINIT,
176  NM_MT_REINIT_ACK,
177  NM_MT_REINIT_NACK,
178  NM_MT_SET_SITE_OUT, /* BS11: get alarm ?!? */
179  NM_MT_SET_SITE_OUT_ACK,
180  NM_MT_SET_SITE_OUT_NACK,
181  NM_MT_CHG_HW_CONF = 0x90,
182  NM_MT_CHG_HW_CONF_ACK,
183  NM_MT_CHG_HW_CONF_NACK,
184  /* Measurement Management Messages */
185  NM_MT_MEAS_RES_REQ = 0x8a,
186  NM_MT_MEAS_RES_RESP,
187  NM_MT_STOP_MEAS,
188  NM_MT_START_MEAS,
189  /* Other Messages */
190  NM_MT_GET_ATTR = 0x81,
191  NM_MT_GET_ATTR_RESP,
192  NM_MT_GET_ATTR_NACK,
193  NM_MT_SET_ALARM_THRES,
194  NM_MT_SET_ALARM_THRES_ACK,
195  NM_MT_SET_ALARM_THRES_NACK,
196 };
197 
200  NM_MT_BS11_RESET_RESOURCE = 0x74,
201 
202  NM_MT_BS11_BEGIN_DB_TX = 0xa3,
203  NM_MT_BS11_BEGIN_DB_TX_ACK,
204  NM_MT_BS11_BEGIN_DB_TX_NACK,
205  NM_MT_BS11_END_DB_TX = 0xa6,
206  NM_MT_BS11_END_DB_TX_ACK,
207  NM_MT_BS11_END_DB_TX_NACK,
208  NM_MT_BS11_CREATE_OBJ = 0xa9,
209  NM_MT_BS11_CREATE_OBJ_ACK,
210  NM_MT_BS11_CREATE_OBJ_NACK,
211  NM_MT_BS11_DELETE_OBJ = 0xac,
212  NM_MT_BS11_DELETE_OBJ_ACK,
213  NM_MT_BS11_DELETE_OBJ_NACK,
214 
215  NM_MT_BS11_SET_ATTR = 0xd0,
216  NM_MT_BS11_SET_ATTR_ACK,
217  NM_MT_BS11_SET_ATTR_NACK,
218  NM_MT_BS11_LMT_SESSION = 0xdc,
219 
220  NM_MT_BS11_GET_STATE = 0xe3,
221  NM_MT_BS11_GET_STATE_ACK,
222  NM_MT_BS11_LMT_LOGON = 0xe5,
223  NM_MT_BS11_LMT_LOGON_ACK,
224  NM_MT_BS11_RESTART = 0xe7,
225  NM_MT_BS11_RESTART_ACK,
226  NM_MT_BS11_DISCONNECT = 0xe9,
227  NM_MT_BS11_DISCONNECT_ACK,
228  NM_MT_BS11_LMT_LOGOFF = 0xec,
229  NM_MT_BS11_LMT_LOGOFF_ACK,
230  NM_MT_BS11_RECONNECT = 0xf1,
231  NM_MT_BS11_RECONNECT_ACK,
232 };
233 
236  NM_MT_IPACC_RESTART = 0x87,
237  NM_MT_IPACC_RESTART_ACK,
238  NM_MT_IPACC_RESTART_NACK,
239  NM_MT_IPACC_RSL_CONNECT = 0xe0,
240  NM_MT_IPACC_RSL_CONNECT_ACK,
241  NM_MT_IPACC_RSL_CONNECT_NACK,
242  NM_MT_IPACC_RSL_DISCONNECT = 0xe3,
243  NM_MT_IPACC_RSL_DISCONNECT_ACK,
244  NM_MT_IPACC_RSL_DISCONNECT_NACK,
245  NM_MT_IPACC_CONN_TRAF = 0xe6,
246  NM_MT_IPACC_CONN_TRAF_ACK,
247  NM_MT_IPACC_CONN_TRAF_NACK,
248  NM_MT_IPACC_DEF_BOOT_SW = 0xec,
249  NM_MT_IPACC_DEF_BOOT_SW_ACK,
250  MN_MT_IPACC_DEF_BOOT_SW_NACK,
251  NM_MT_IPACC_SET_NVATTR = 0xef,
252  NM_MT_IPACC_SET_NVATTR_ACK,
253  NM_MT_IPACC_SET_NVATTR_NACK,
254  NM_MT_IPACC_GET_NVATTR = 0xf2,
255  NM_MT_IPACC_GET_NVATTR_ACK,
256  NM_MT_IPACC_GET_NVATTR_NACK,
257  NM_MT_IPACC_SET_ATTR = 0xf5,
258  NM_MT_IPACC_SET_ATTR_ACK,
259  NM_MT_IPACC_SET_ATTR_NACK,
260 };
261 
264  /* Critical causes */
265  OSMO_EVT_CRIT_SW_FATAL = 0x0000,
266  OSMO_EVT_CRIT_PROC_STOP = 0x0002,
267  OSMO_EVT_CRIT_RTP_TOUT = 0x032c,
268  OSMO_EVT_CRIT_BOOT_FAIL = 0x0401,
269  /* Major causes */
270  OSMO_EVT_MAJ_UKWN_MSG = 0x0002,
271  OSMO_EVT_MAJ_RSL_FAIL = 0x0309,
272  OSMO_EVT_MAJ_UNSUP_ATTR = 0x0318,
273  OSMO_EVT_MAJ_NET_CONGEST = 0x032b,
274  /* Minor causes */
275  OSMO_EVT_MIN_PAG_TAB_FULL = 0x0401,
276  /* Warning causes */
277  OSMO_EVT_WARN_SW_WARN = 0x0001,
278  /* External causes */
279  OSMO_EVT_EXT_ALARM = 0xfeed,
280 };
281 
282 extern const struct value_string abis_mm_event_cause_names[];
283 
284 enum abis_nm_bs11_cell_alloc {
285  NM_BS11_CANR_GSM = 0x00,
286  NM_BS11_CANR_DCS1800 = 0x01,
287 };
288 
291  NM_OC_SITE_MANAGER = 0x00,
292  NM_OC_BTS,
293  NM_OC_RADIO_CARRIER,
294  NM_OC_CHANNEL,
295  NM_OC_BASEB_TRANSC,
296  /* RFU: 05-FE */
297 
298  NM_OC_IPAC_E1_TRUNK = 0x0e,
299  NM_OC_IPAC_E1_PORT = 0x0f,
300  NM_OC_IPAC_E1_CHAN = 0x10,
301  NM_OC_IPAC_CLK_MODULE = 0x22,
302 
303  NM_OC_BS11_ADJC = 0xa0,
304  NM_OC_BS11_HANDOVER = 0xa1,
305  NM_OC_BS11_PWR_CTRL = 0xa2,
306  NM_OC_BS11_BTSE = 0xa3, /* LMT? */
307  NM_OC_BS11_RACK = 0xa4,
308  NM_OC_BS11 = 0xa5, /* 01: ALCO */
309  NM_OC_BS11_TEST = 0xa6,
310  NM_OC_BS11_ENVABTSE = 0xa8,
311  NM_OC_BS11_BPORT = 0xa9,
312 
313  NM_OC_GPRS_NSE = 0xf0,
314  NM_OC_GPRS_CELL = 0xf1,
315  NM_OC_GPRS_NSVC = 0xf2,
316 
317  NM_OC_NULL = 0xff,
318 };
319 
322  NM_ATT_ABIS_CHANNEL = 0x01,
323  NM_ATT_ADD_INFO,
324  NM_ATT_ADD_TEXT,
325  NM_ATT_ADM_STATE,
326  NM_ATT_ARFCN_LIST,
327  NM_ATT_AUTON_REPORT,
328  NM_ATT_AVAIL_STATUS,
329  NM_ATT_BCCH_ARFCN,
330  NM_ATT_BSIC,
331  NM_ATT_BTS_AIR_TIMER,
332  NM_ATT_CCCH_L_I_P,
333  NM_ATT_CCCH_L_T,
334  NM_ATT_CHAN_COMB,
335  NM_ATT_CONN_FAIL_CRIT,
336  NM_ATT_DEST,
337  /* res */
338  NM_ATT_EVENT_TYPE = 0x11, /* BS11: file data ?!? */
339  NM_ATT_FILE_ID,
340  NM_ATT_FILE_VERSION,
341  NM_ATT_GSM_TIME,
342  NM_ATT_HSN,
343  NM_ATT_HW_CONFIG,
344  NM_ATT_HW_DESC,
345  NM_ATT_INTAVE_PARAM,
346  NM_ATT_INTERF_BOUND,
347  NM_ATT_LIST_REQ_ATTR,
348  NM_ATT_MAIO,
349  NM_ATT_MANUF_STATE,
350  NM_ATT_MANUF_THRESH,
351  NM_ATT_MANUF_ID,
352  NM_ATT_MAX_TA,
353  NM_ATT_MDROP_LINK, /* 0x20 */
354  NM_ATT_MDROP_NEXT,
355  NM_ATT_NACK_CAUSES,
356  NM_ATT_NY1,
357  NM_ATT_OPER_STATE,
358  NM_ATT_OVERL_PERIOD,
359  NM_ATT_PHYS_CONF,
360  NM_ATT_POWER_CLASS,
361  NM_ATT_POWER_THRESH,
362  NM_ATT_PROB_CAUSE,
363  NM_ATT_RACH_B_THRESH,
364  NM_ATT_LDAVG_SLOTS,
365  NM_ATT_RAD_SUBC,
366  NM_ATT_RF_MAXPOWR_R,
367  NM_ATT_SITE_INPUTS,
368  NM_ATT_SITE_OUTPUTS,
369  NM_ATT_SOURCE, /* 0x30 */
370  NM_ATT_SPEC_PROB,
371  NM_ATT_START_TIME,
372  NM_ATT_T200,
373  NM_ATT_TEI,
374  NM_ATT_TEST_DUR,
375  NM_ATT_TEST_NO,
376  NM_ATT_TEST_REPORT,
377  NM_ATT_VSWR_THRESH,
378  NM_ATT_WINDOW_SIZE,
379  /* Res */
380  NM_ATT_BS11_RSSI_OFFS = 0x3d,
381  NM_ATT_BS11_TXPWR = 0x3e,
382  NM_ATT_BS11_DIVERSITY = 0x3f,
383  /* Res */
384  NM_ATT_TSC = 0x40,
385  NM_ATT_SW_CONFIG,
386  NM_ATT_SW_DESCR,
387  NM_ATT_SEVERITY,
388  NM_ATT_GET_ARI,
389  NM_ATT_HW_CONF_CHG,
390  NM_ATT_OUTST_ALARM,
391  NM_ATT_FILE_DATA,
392  NM_ATT_MEAS_RES,
393  NM_ATT_MEAS_TYPE,
394 
395  NM_ATT_BS11_ESN_FW_CODE_NO = 0x4c,
396  NM_ATT_BS11_ESN_HW_CODE_NO = 0x4f,
397 
398  NM_ATT_BS11_ESN_PCB_SERIAL = 0x55,
399  NM_ATT_BS11_EXCESSIVE_DISTANCE = 0x58,
400 
401  NM_ATT_BS11_ALL_TEST_CATG = 0x60,
402  NM_ATT_BS11_BTSLS_HOPPING,
403  NM_ATT_BS11_CELL_ALLOC_NR,
404  NM_ATT_BS11_CELL_GLOBAL_ID,
405  NM_ATT_BS11_ENA_INTERF_CLASS = 0x66,
406  NM_ATT_BS11_ENA_INT_INTEC_HANDO = 0x67,
407  NM_ATT_BS11_ENA_INT_INTRC_HANDO = 0x68,
408  NM_ATT_BS11_ENA_MS_PWR_CTRL = 0x69,
409  NM_ATT_BS11_ENA_PWR_BDGT_HO = 0x6a,
410  NM_ATT_BS11_ENA_PWR_CTRL_RLFW = 0x6b,
411  NM_ATT_BS11_ENA_RXLEV_HO = 0x6c,
412  NM_ATT_BS11_ENA_RXQUAL_HO = 0x6d,
413  NM_ATT_BS11_FACCH_QUAL = 0x6e,
414 
415  NM_ATT_IPACC_DST_IP = 0x80,
416  NM_ATT_IPACC_DST_IP_PORT = 0x81,
417  NM_ATT_IPACC_SSRC = 0x82,
418  NM_ATT_IPACC_RTP_PAYLD_TYPE = 0x83,
419  NM_ATT_IPACC_BASEB_ID = 0x84,
420  NM_ATT_IPACC_STREAM_ID = 0x85,
421  NM_ATT_IPACC_NV_FLAGS = 0x86,
422  NM_ATT_IPACC_FREQ_CTRL = 0x87,
423  NM_ATT_IPACC_PRIM_OML_CFG = 0x88,
424  NM_ATT_IPACC_SEC_OML_CFG = 0x89,
425  NM_ATT_IPACC_IP_IF_CFG = 0x8a, /* IP interface */
426  NM_ATT_IPACC_IP_GW_CFG = 0x8b, /* IP gateway */
427  NM_ATT_IPACC_IN_SERV_TIME = 0x8c,
428  NM_ATT_IPACC_TRX_BTS_ASS = 0x8d,
429  NM_ATT_IPACC_LOCATION = 0x8e, /* string describing location */
430  NM_ATT_IPACC_PAGING_CFG = 0x8f,
431  NM_ATT_IPACC_FILE_DATA = 0x90,
432  NM_ATT_IPACC_UNIT_ID = 0x91, /* Site/BTS/TRX */
433  NM_ATT_IPACC_PARENT_UNIT_ID = 0x92,
434  NM_ATT_IPACC_UNIT_NAME = 0x93, /* default: nbts-<mac-as-string> */
435  NM_ATT_IPACC_SNMP_CFG = 0x94,
436  NM_ATT_IPACC_PRIM_OML_CFG_LIST = 0x95,
437  NM_ATT_IPACC_PRIM_OML_FB_TOUT = 0x96,
438  NM_ATT_IPACC_CUR_SW_CFG = 0x97,
439  NM_ATT_IPACC_TIMING_BUS = 0x98,
440  NM_ATT_IPACC_CGI = 0x99,
441  NM_ATT_IPACC_RAC = 0x9a,
442  NM_ATT_IPACC_OBJ_VERSION = 0x9b,
443  NM_ATT_IPACC_GPRS_PAGING_CFG = 0x9c,
444  NM_ATT_IPACC_NSEI = 0x9d,
445  NM_ATT_IPACC_BVCI = 0x9e,
446  NM_ATT_IPACC_NSVCI = 0x9f,
447  NM_ATT_IPACC_NS_CFG = 0xa0,
448  NM_ATT_IPACC_BSSGP_CFG = 0xa1,
449  NM_ATT_IPACC_NS_LINK_CFG = 0xa2,
450  NM_ATT_IPACC_RLC_CFG = 0xa3,
451  NM_ATT_IPACC_ALM_THRESH_LIST = 0xa4,
452  NM_ATT_IPACC_MONIT_VAL_LIST = 0xa5,
453  NM_ATT_IPACC_TIB_CONTROL = 0xa6,
454  NM_ATT_IPACC_SUPP_FEATURES = 0xa7,
455  NM_ATT_IPACC_CODING_SCHEMES = 0xa8,
456  NM_ATT_IPACC_RLC_CFG_2 = 0xa9,
457  NM_ATT_IPACC_HEARTB_TOUT = 0xaa,
458  NM_ATT_IPACC_UPTIME = 0xab,
459  NM_ATT_IPACC_RLC_CFG_3 = 0xac,
460  NM_ATT_IPACC_SSL_CFG = 0xad,
461  NM_ATT_IPACC_SEC_POSSIBLE = 0xae,
462  NM_ATT_IPACC_IML_SSL_STATE = 0xaf,
463  NM_ATT_IPACC_REVOC_DATE = 0xb0,
464 
465 
466  NM_ATT_BS11_RF_RES_IND_PER = 0x8f,
467 
468  NM_ATT_BS11_RX_LEV_MIN_CELL = 0x90,
469  NM_ATT_BS11_ABIS_EXT_TIME = 0x91,
470  NM_ATT_BS11_TIMER_HO_REQUEST = 0x92,
471  NM_ATT_BS11_TIMER_NCELL = 0x93,
472  NM_ATT_BS11_TSYNC = 0x94,
473  NM_ATT_BS11_TTRAU = 0x95,
474  NM_ATT_BS11_EMRG_CFG_MEMBER = 0x9b,
475  NM_ATT_BS11_TRX_AREA = 0x9f,
476 
477  NM_ATT_BS11_BCCH_RECONF = 0xd7,
478  NM_ATT_BS11_BIT_ERR_THESH = 0xa0,
479  NM_ATT_BS11_BOOT_SW_VERS = 0xa1,
480  NM_ATT_BS11_CCLK_ACCURACY = 0xa3,
481  NM_ATT_BS11_CCLK_TYPE = 0xa4,
482  NM_ATT_BS11_INP_IMPEDANCE = 0xaa,
483  NM_ATT_BS11_L1_PROT_TYPE = 0xab,
484  NM_ATT_BS11_LINE_CFG = 0xac,
485  NM_ATT_BS11_LI_PORT_1 = 0xad,
486  NM_ATT_BS11_LI_PORT_2 = 0xae,
487 
488  NM_ATT_BS11_L1_REM_ALM_TYPE = 0xb0,
489  NM_ATT_BS11_SW_LOAD_INTENDED = 0xbb,
490  NM_ATT_BS11_SW_LOAD_SAFETY = 0xbc,
491  NM_ATT_BS11_SW_LOAD_STORED = 0xbd,
492 
493  NM_ATT_BS11_VENDOR_NAME = 0xc1,
494  NM_ATT_BS11_HOPPING_MODE = 0xc5,
495  NM_ATT_BS11_LMT_LOGON_SESSION = 0xc6,
496  NM_ATT_BS11_LMT_LOGIN_TIME = 0xc7,
497  NM_ATT_BS11_LMT_USER_ACC_LEV = 0xc8,
498  NM_ATT_BS11_LMT_USER_NAME = 0xc9,
499 
500  NM_ATT_BS11_L1_CONTROL_TS = 0xd8,
501  NM_ATT_BS11_RADIO_MEAS_GRAN = 0xdc, /* in SACCH multiframes */
502  NM_ATT_BS11_RADIO_MEAS_REP = 0xdd,
503 
504  NM_ATT_BS11_SH_LAPD_INT_TIMER = 0xe8,
505 
506  NM_ATT_BS11_BTS_STATE = 0xf0,
507  NM_ATT_BS11_E1_STATE = 0xf1,
508  NM_ATT_BS11_PLL = 0xf2,
509  NM_ATT_BS11_RX_OFFSET = 0xf3,
510  NM_ATT_BS11_ANT_TYPE = 0xf4,
511  NM_ATT_BS11_PLL_MODE = 0xfc,
512  NM_ATT_BS11_PASSWORD = 0xfd,
513 
514  /* osmocom (osmo-bts) specific attributes, used in combination
515  * with the "org.osmocom" manufacturer identification */
516  NM_ATT_OSMO_REDUCEPOWER = 0xfe, /* TLV_TYPE_TV */
517 };
518 #define NM_ATT_BS11_FILE_DATA NM_ATT_EVENT_TYPE
519 
522  NM_STATE_LOCKED = 0x01,
523  NM_STATE_UNLOCKED = 0x02,
524  NM_STATE_SHUTDOWN = 0x03,
525  NM_STATE_NULL = 0xff,
526 };
527 
530  NM_AVSTATE_IN_TEST = 1,
531  NM_AVSTATE_POWER_OFF = 2,
532  NM_AVSTATE_OFF_LINE = 3,
533  NM_AVSTATE_DEPENDENCY = 5,
534  NM_AVSTATE_DEGRADED = 6,
535  NM_AVSTATE_NOT_INSTALLED= 7,
536  NM_AVSTATE_OK = 0xff,
537 };
538 
541  NM_OPSTATE_DISABLED = 1,
542  NM_OPSTATE_ENABLED = 2,
543  NM_OPSTATE_NULL = 0xff,
544 };
545 
546 /* \brief Channel Combination (Section 9.4.13) */
547 enum abis_nm_chan_comb {
548  NM_CHANC_TCHFull = 0x00, /* TCH/F + TCH/H + SACCH/TF */
549  NM_CHANC_TCHHalf = 0x01, /* TCH/H(0,1) + FACCH/H(0,1) +
550  SACCH/TH(0,1) */
551  NM_CHANC_TCHHalf2 = 0x02, /* TCH/H(0) + FACCH/H(0) + SACCH/TH(0) +
552  TCH/H(1) */
553  NM_CHANC_SDCCH = 0x03, /* SDCCH/8 + SACCH/8 */
554  NM_CHANC_mainBCCH = 0x04, /* FCCH + SCH + BCCH + CCCH */
555  NM_CHANC_BCCHComb = 0x05, /* FCCH + SCH + BCCH + CCCH + SDCCH/4 +
556  SACCH/C4 */
557  NM_CHANC_BCCH = 0x06, /* BCCH + CCCH */
558  NM_CHANC_BCCH_CBCH = 0x07, /* CHANC_BCCHComb + CBCH */
559  NM_CHANC_SDCCH_CBCH = 0x08, /* CHANC_SDCCH8 + CBCH */
560  /* ip.access */
561  NM_CHANC_IPAC_bPDCH = 0x0b, /* PBCCH + PCCCH + PDTCH/F + PACCH/F +
562  PTCCH/F */
563  NM_CHANC_IPAC_cPDCH = 0x0c, /* PBCCH + PDTCH/F + PACCH/F + PTCCH/F */
564  NM_CHANC_IPAC_PDCH = 0x0d, /* PDTCH/F + PACCH/F + PTCCH/F */
565  NM_CHANC_IPAC_TCHFull_PDCH = 0x80,
566  NM_CHANC_IPAC_TCHFull_TCHHalf = 0x81,
567  /* osmocom */
568  NM_CHANC_OSMO_TCHFull_TCHHalf_PDCH = 0x90,
569 };
570 
573  NM_EVT_COMM_FAIL = 0x00,
574  NM_EVT_QOS_FAIL = 0x01,
575  NM_EVT_PROC_FAIL = 0x02,
576  NM_EVT_EQUIP_FAIL = 0x03,
577  NM_EVT_ENV_FAIL = 0x04,
578 };
579 
582  NM_SEVER_CEASED = 0x00,
583  NM_SEVER_CRITICAL = 0x01,
584  NM_SEVER_MAJOR = 0x02,
585  NM_SEVER_MINOR = 0x03,
586  NM_SEVER_WARNING = 0x04,
587  NM_SEVER_INDETERMINATE = 0x05,
588 };
589 
592  NM_PCAUSE_T_X721 = 0x01,
593  NM_PCAUSE_T_GSM = 0x02,
594  NM_PCAUSE_T_MANUF = 0x03,
595 };
596 
597 extern const struct value_string abis_nm_pcause_type_names[];
598 
601  /* General Nack Causes */
602  NM_NACK_INCORR_STRUCT = 0x01,
603  NM_NACK_MSGTYPE_INVAL = 0x02,
604  NM_NACK_OBJCLASS_INVAL = 0x05,
605  NM_NACK_OBJCLASS_NOTSUPP = 0x06,
606  NM_NACK_BTSNR_UNKN = 0x07,
607  NM_NACK_TRXNR_UNKN = 0x08,
608  NM_NACK_OBJINST_UNKN = 0x09,
609  NM_NACK_ATTRID_INVAL = 0x0c,
610  NM_NACK_ATTRID_NOTSUPP = 0x0d,
611  NM_NACK_PARAM_RANGE = 0x0e,
612  NM_NACK_ATTRLIST_INCONSISTENT = 0x0f,
613  NM_NACK_SPEC_IMPL_NOTSUPP = 0x10,
614  NM_NACK_CANT_PERFORM = 0x11,
615  /* Specific Nack Causes */
616  NM_NACK_RES_NOTIMPL = 0x19,
617  NM_NACK_RES_NOTAVAIL = 0x1a,
618  NM_NACK_FREQ_NOTAVAIL = 0x1b,
619  NM_NACK_TEST_NOTSUPP = 0x1c,
620  NM_NACK_CAPACITY_RESTR = 0x1d,
621  NM_NACK_PHYSCFG_NOTPERFORM = 0x1e,
622  NM_NACK_TEST_NOTINIT = 0x1f,
623  NM_NACK_PHYSCFG_NOTRESTORE = 0x20,
624  NM_NACK_TEST_NOSUCH = 0x21,
625  NM_NACK_TEST_NOSTOP = 0x22,
626  NM_NACK_MSGINCONSIST_PHYSCFG = 0x23,
627  NM_NACK_FILE_INCOMPLETE = 0x25,
628  NM_NACK_FILE_NOTAVAIL = 0x26,
629  NM_NACK_FILE_NOTACTIVATE = 0x27,
630  NM_NACK_REQ_NOT_GRANT = 0x28,
631  NM_NACK_WAIT = 0x29,
632  NM_NACK_NOTH_REPORT_EXIST = 0x2a,
633  NM_NACK_MEAS_NOTSUPP = 0x2b,
634  NM_NACK_MEAS_NOTSTART = 0x2c,
635 };
636 
639  uint8_t attrib;
640  uint8_t bts_port;
641  uint8_t timeslot;
642  uint8_t subslot;
643 } __attribute__ ((packed));
644 
647  T200_SDCCH = 0,
648  T200_FACCH_F = 1,
649  T200_FACCH_H = 2,
650  T200_SACCH_TCH_SAPI0 = 3,
651  T200_SACCH_SDCCH = 4,
652  T200_SDCCH_SAPI3 = 5,
653  T200_SACCH_TCH_SAPI3 = 6
654 };
655 
656 extern const uint8_t abis_nm_t200_ms[];
657 
660  BS11_OBJ_ALCO = 0x01,
661  BS11_OBJ_BBSIG = 0x02, /* obj_class: 0,1 */
662  BS11_OBJ_TRX1 = 0x03, /* only DEACTIVATE TRX1 */
663  BS11_OBJ_CCLK = 0x04,
664  BS11_OBJ_GPSU = 0x06,
665  BS11_OBJ_LI = 0x07,
666  BS11_OBJ_PA = 0x09, /* obj_class: 0, 1*/
667 };
668 
671  BS11_TRX_POWER_GSM_2W = 0x06,
672  BS11_TRX_POWER_GSM_250mW= 0x07,
673  BS11_TRX_POWER_GSM_80mW = 0x08,
674  BS11_TRX_POWER_GSM_30mW = 0x09,
675  BS11_TRX_POWER_DCS_3W = 0x0a,
676  BS11_TRX_POWER_DCS_1W6 = 0x0b,
677  BS11_TRX_POWER_DCS_500mW= 0x0c,
678  BS11_TRX_POWER_DCS_160mW= 0x0d,
679 };
680 
683  BS11_LI_PLL_LOCKED = 2,
684  BS11_LI_PLL_STANDALONE = 3,
685 };
686 
689  BS11_LINE_CFG_STAR = 0x00,
690  BS11_LINE_CFG_MULTIDROP = 0x01,
691  BS11_LINE_CFG_LOOP = 0x02,
692 };
693 
696  BS11_STATE_SOFTWARE_RQD = 0x01,
697  BS11_STATE_LOAD_SMU_INTENDED = 0x11,
698  BS11_STATE_LOAD_SMU_SAFETY = 0x21,
699  BS11_STATE_LOAD_FAILED = 0x31,
700  BS11_STATE_LOAD_DIAGNOSTIC = 0x41,
701  BS11_STATE_WARM_UP = 0x51,
702  BS11_STATE_WARM_UP_2 = 0x52,
703  BS11_STATE_WAIT_MIN_CFG = 0x62,
704  BS11_STATE_MAINTENANCE = 0x72,
705  BS11_STATE_LOAD_MBCCU = 0x92,
706  BS11_STATE_WAIT_MIN_CFG_2 = 0xA2,
707  BS11_STATE_NORMAL = 0x03,
708  BS11_STATE_ABIS_LOAD = 0x13,
709 };
710 
713  NM_IPACC_TESTNO_RLOOP_ANT = 0x01,
714  NM_IPACC_TESTNO_RLOOP_XCVR = 0x02,
715  NM_IPACC_TESTNO_FUNC_OBJ = 0x03,
716  NM_IPACC_TESTNO_CHAN_USAGE = 0x40,
717  NM_IPACC_TESTNO_BCCH_CHAN_USAGE = 0x41,
718  NM_IPACC_TESTNO_FREQ_SYNC = 0x42,
719  NM_IPACC_TESTNO_BCCH_INFO = 0x43,
720  NM_IPACC_TESTNO_TX_BEACON = 0x44,
721  NM_IPACC_TESTNO_SYSINFO_MONITOR = 0x45,
722  NM_IPACC_TESTNO_BCCCH_MONITOR = 0x46,
723 };
724 
727  NM_IPACC_TESTRES_SUCCESS = 0,
728  NM_IPACC_TESTRES_TIMEOUT = 1,
729  NM_IPACC_TESTRES_NO_CHANS = 2,
730  NM_IPACC_TESTRES_PARTIAL = 3,
731  NM_IPACC_TESTRES_STOPPED = 4,
732 };
733 
736  NM_IPACC_TR_IE_FREQ_ERR_LIST = 3,
737  NM_IPACC_TR_IE_CHAN_USAGE = 4,
738  NM_IPACC_TR_IE_BCCH_INFO = 6,
739  NM_IPACC_TR_IE_RESULT_DETAILS = 8,
740  NM_IPACC_TR_IE_FREQ_ERR = 18,
741 };
742 
744 enum ipac_eie {
745  NM_IPAC_EIE_ARFCN_WHITE = 0x01,
746  NM_IPAC_EIE_ARFCH_BLACK = 0x02,
747  NM_IPAC_EIE_FREQ_ERR_LIST = 0x03,
748  NM_IPAC_EIE_CHAN_USE_LIST = 0x04,
749  NM_IPAC_EIE_BCCH_INFO_TYPE = 0x05,
750  NM_IPAC_EIE_BCCH_INFO = 0x06,
751  NM_IPAC_EIE_CONFIG = 0x07,
752  NM_IPAC_EIE_RES_DETAILS = 0x08,
753  NM_IPAC_EIE_RXLEV_THRESH = 0x09,
754  NM_IPAC_EIE_FREQ_SYNC_OPTS = 0x0a,
755  NM_IPAC_EIE_MAC_ADDR = 0x0b,
756  NM_IPAC_EIE_HW_SW_COMPAT_NR = 0x0c,
757  NM_IPAC_EIE_MANUF_SER_NR = 0x0d,
758  NM_IPAC_EIE_OEM_ID = 0x0e,
759  NM_IPAC_EIE_DATE_TIME_MANUF = 0x0f,
760  NM_IPAC_EIE_DATE_TIME_CALIB = 0x10,
761  NM_IPAC_EIE_BEACON_INFO = 0x11,
762  NM_IPAC_EIE_FREQ_ERR = 0x12,
763  /* FIXME */
764  NM_IPAC_EIE_FREQ_BANDS = 0x1c,
765  NM_IPAC_EIE_MAX_TA = 0x1d,
766  NM_IPAC_EIE_CIPH_ALGOS = 0x1e,
767  NM_IPAC_EIE_CHAN_TYPES = 0x1f,
768  NM_IPAC_EIE_CHAN_MODES = 0x20,
769  NM_IPAC_EIE_GPRS_CODING = 0x21,
770  NM_IPAC_EIE_RTP_FEATURES = 0x22,
771  NM_IPAC_EIE_RSL_FEATURES = 0x23,
772  NM_IPAC_EIE_BTS_HW_CLASS = 0x24,
773  NM_IPAC_EIE_BTS_ID = 0x25,
774 };
775 
778  IPAC_BINF_RXLEV = (1 << 8),
779  IPAC_BINF_RXQUAL = (1 << 9),
780  IPAC_BINF_FREQ_ERR_QUAL = (1 << 10),
781  IPAC_BINF_FRAME_OFFSET = (1 << 11),
782  IPAC_BINF_FRAME_NR_OFFSET = (1 << 12),
783  IPAC_BINF_BSIC = (1 << 13),
784  IPAC_BINF_CGI = (1 << 14),
785  IPAC_BINF_NEIGH_BA_SI2 = (1 << 15),
786  IPAC_BINF_NEIGH_BA_SI2bis = (1 << 0),
787  IPAC_BINF_NEIGH_BA_SI2ter = (1 << 1),
788  IPAC_BINF_CELL_ALLOC = (1 << 2),
789 };
790 
791 struct msgb *abis_nm_fail_evt_rep(enum abis_nm_event_type t,
792  enum abis_nm_severity s,
793  enum abis_nm_pcause_type ct,
794  uint16_t cause_value, const char *fmt, ...);
795 struct msgb *abis_nm_fail_evt_vrep(enum abis_nm_event_type t,
796  enum abis_nm_severity s,
797  enum abis_nm_pcause_type ct,
798  uint16_t cause_value, const char *fmt,
799  va_list ap);
abis_nm_attr
OML Attributes / IEs (Section 9.4)
Definition: gsm_12_21.h:321
abis_nm_ipacc_test_res
first byte after length inside NM_ATT_TEST_REPORT
Definition: gsm_12_21.h:726
uint8_t trx_nr
TRX Number.
Definition: gsm_12_21.h:72
ipac_eie
ip.access IEI
Definition: gsm_12_21.h:744
uint8_t data[0]
actual payload data
Definition: gsm_12_21.h:45
OML Object Instance.
Definition: gsm_12_21.h:70
struct msgb * abis_nm_fail_evt_rep(enum abis_nm_event_type t, enum abis_nm_severity s, enum abis_nm_pcause_type ct, uint16_t cause_value, const char *fmt,...)
Pack 3GPP TS 12.21 § 8.8.2 Failure Event Report into msgb.
Definition: abis_nm.c:529
uint8_t length
Length in octets.
Definition: gsm_12_21.h:43
abis_bs11_li_pll_mode
Siemens BS11 PLL mode.
Definition: gsm_12_21.h:682
abis_nm_obj_class
OML Object Class (Section 9.2)
Definition: gsm_12_21.h:290
Abis OML Channel (Section 9.4.1)
Definition: gsm_12_21.h:638
uint8_t data[0]
Data.
Definition: gsm_12_21.h:81
ipac_bcch_info_type
ip.access NWL BCCH information type
Definition: gsm_12_21.h:777
abis_bs11_phase
Siemens BS11 boot phase.
Definition: gsm_12_21.h:695
uint8_t placement
Placement (like ABIS_OM_PLACEMENT_ONLY)
Definition: gsm_12_21.h:39
abis_nm_msgtype_bs11
Siemens specific OML Message Types.
Definition: gsm_12_21.h:199
abis_nm_pcause_type
Probable Cause Type (Section 9.4.43)
Definition: gsm_12_21.h:591
uint8_t bts_nr
BTS Number.
Definition: gsm_12_21.h:71
abis_nm_avail_state
OML Availability State (Section 9.4.7)
Definition: gsm_12_21.h:529
OML Object Instance.
Definition: gsm_12_21.h:77
uint8_t sequence
Sequence Number (if ABIS_OM_PLACEMENT_MIDDLE)
Definition: gsm_12_21.h:41
const uint8_t abis_nm_t200_ms[]
3GPP TS 12.21 9.4.53 T200 values (in msec)
Definition: abis_nm.c:254
abis_nm_msgtype_ipacc
ip.access specific OML Message Types
Definition: gsm_12_21.h:235
abis_bs11_trx_power
Siemens BS11 TRX power.
Definition: gsm_12_21.h:670
uint8_t mdisc
Message Discriminator abis_oml_mdisc.
Definition: gsm_12_21.h:37
struct abis_om_obj_inst obj_inst
Object Instance.
Definition: gsm_12_21.h:80
abis_nm_ipacc_testres_ie
internal IE inside NM_ATT_TEST_REPORT
Definition: gsm_12_21.h:735
abis_nm_op_state
OML Operational State.
Definition: gsm_12_21.h:540
uint8_t bts_port
BTS port number.
Definition: gsm_12_21.h:640
uint8_t ts_nr
Timeslot Number.
Definition: gsm_12_21.h:73
abis_bs11_line_cfg
Siemens BS11 E1 line configuration.
Definition: gsm_12_21.h:688
uint8_t obj_class
Object Class (abis_nm_obj_class)
Definition: gsm_12_21.h:79
abis_nm_adm_state
OML Administrative State (Section 9.4.4)
Definition: gsm_12_21.h:521
uint8_t timeslot
E1 timeslot.
Definition: gsm_12_21.h:641
generic header in front of every OML message according to TS 08.59
Definition: gsm_12_21.h:35
abis_nm_severity
Perceived Severity (Section: 9.4.63)
Definition: gsm_12_21.h:581
abis_nm_ipacc_test_no
ip.access test number
Definition: gsm_12_21.h:712
uint8_t msg_type
Message Type (abis_nm_msgtype)
Definition: gsm_12_21.h:78
uint8_t subslot
E1 sub-slot.
Definition: gsm_12_21.h:642
abis_nm_t200_idx
3GPP TS 12.21 9.4.53 T200 index
Definition: gsm_12_21.h:646
abis_nm_nack_cause
NACK causes (Section 9.4.36)
Definition: gsm_12_21.h:600
abis_nm_msgtype
OML Message Type (Section 9.1)
Definition: gsm_12_21.h:88
abis_bs11_objtype
Siemens BS-11 specific objects in the SienemsHW (0xA5) object class.
Definition: gsm_12_21.h:659
abis_mm_event_causes
OML Probable Cause (Section 9.4.43) Manufacturer specific values.
Definition: gsm_12_21.h:263
abis_nm_event_type
Event Type (Section 9.4.16)
Definition: gsm_12_21.h:572
struct msgb * abis_nm_fail_evt_vrep(enum abis_nm_event_type t, enum abis_nm_severity s, enum abis_nm_pcause_type ct, uint16_t cause_value, const char *fmt, va_list ap)
Pack 3GPP TS 12.21 § 8.8.2 Failure Event Report into msgb.
Definition: abis_nm.c:545