blob: 2c23a6484b9a464cfc06eecb4867cef91623b7bd [file] [log] [blame]
Harald Weltef7a1bcc2011-05-22 22:45:16 +02001/* GSM Network Management (OML) messages on the A-bis interface
2 * 3GPP TS 12.21 version 8.0.0 Release 1999 / ETSI TS 100 623 V8.0.0 */
3
4/* (C) 2008-2011 by Harald Welte <laforge@gnumonks.org>
5 *
6 * 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
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 *
21 */
22
Harald Welte4e777c32011-08-17 19:15:24 +020023/*! \addtogroup oml
24 * @{
25 */
26
27/*! \file abis_nm.c */
28
Harald Weltef7a1bcc2011-05-22 22:45:16 +020029#include <stdint.h>
Harald Welte11c71932011-05-24 17:15:12 +020030#include <errno.h>
31
Harald Weltef7a1bcc2011-05-22 22:45:16 +020032#include <osmocom/core/utils.h>
33#include <osmocom/core/logging.h>
34#include <osmocom/gsm/tlv.h>
Harald Welte11c71932011-05-24 17:15:12 +020035#include <osmocom/gsm/gsm_utils.h>
Harald Weltef7a1bcc2011-05-22 22:45:16 +020036#include <osmocom/gsm/protocol/gsm_12_21.h>
37#include <osmocom/gsm/abis_nm.h>
38
Harald Welte4e777c32011-08-17 19:15:24 +020039/*! \brief unidirectional messages from BTS to BSC */
Harald Weltef7a1bcc2011-05-22 22:45:16 +020040const enum abis_nm_msgtype abis_nm_reports[4] = {
41 NM_MT_SW_ACTIVATED_REP,
42 NM_MT_TEST_REP,
43 NM_MT_STATECHG_EVENT_REP,
44 NM_MT_FAILURE_EVENT_REP,
45};
46
Harald Welte4e777c32011-08-17 19:15:24 +020047/*! \brief messages without ACK/NACK */
Harald Weltef7a1bcc2011-05-22 22:45:16 +020048const enum abis_nm_msgtype abis_nm_no_ack_nack[3] = {
49 NM_MT_MEAS_RES_REQ,
50 NM_MT_STOP_MEAS,
51 NM_MT_START_MEAS,
52};
53
Harald Welte4e777c32011-08-17 19:15:24 +020054/*! \brief messages related to software load */
Harald Weltef7a1bcc2011-05-22 22:45:16 +020055const enum abis_nm_msgtype abis_nm_sw_load_msgs[9] = {
56 NM_MT_LOAD_INIT_ACK,
57 NM_MT_LOAD_INIT_NACK,
58 NM_MT_LOAD_SEG_ACK,
59 NM_MT_LOAD_ABORT,
60 NM_MT_LOAD_END_ACK,
61 NM_MT_LOAD_END_NACK,
62 //NM_MT_SW_ACT_REQ,
63 NM_MT_ACTIVATE_SW_ACK,
64 NM_MT_ACTIVATE_SW_NACK,
65 NM_MT_SW_ACTIVATED_REP,
66};
67
Harald Welte4e777c32011-08-17 19:15:24 +020068/*! \brief All NACKs (negative acknowledgements */
Harald Weltef7a1bcc2011-05-22 22:45:16 +020069const enum abis_nm_msgtype abis_nm_nacks[33] = {
70 NM_MT_LOAD_INIT_NACK,
71 NM_MT_LOAD_END_NACK,
72 NM_MT_SW_ACT_REQ_NACK,
73 NM_MT_ACTIVATE_SW_NACK,
74 NM_MT_ESTABLISH_TEI_NACK,
75 NM_MT_CONN_TERR_SIGN_NACK,
76 NM_MT_DISC_TERR_SIGN_NACK,
77 NM_MT_CONN_TERR_TRAF_NACK,
78 NM_MT_DISC_TERR_TRAF_NACK,
79 NM_MT_CONN_MDROP_LINK_NACK,
80 NM_MT_DISC_MDROP_LINK_NACK,
81 NM_MT_SET_BTS_ATTR_NACK,
82 NM_MT_SET_RADIO_ATTR_NACK,
83 NM_MT_SET_CHAN_ATTR_NACK,
84 NM_MT_PERF_TEST_NACK,
85 NM_MT_SEND_TEST_REP_NACK,
86 NM_MT_STOP_TEST_NACK,
87 NM_MT_STOP_EVENT_REP_NACK,
88 NM_MT_REST_EVENT_REP_NACK,
89 NM_MT_CHG_ADM_STATE_NACK,
90 NM_MT_CHG_ADM_STATE_REQ_NACK,
91 NM_MT_REP_OUTST_ALARMS_NACK,
92 NM_MT_CHANGEOVER_NACK,
93 NM_MT_OPSTART_NACK,
94 NM_MT_REINIT_NACK,
95 NM_MT_SET_SITE_OUT_NACK,
96 NM_MT_CHG_HW_CONF_NACK,
97 NM_MT_GET_ATTR_NACK,
98 NM_MT_SET_ALARM_THRES_NACK,
99 NM_MT_BS11_BEGIN_DB_TX_NACK,
100 NM_MT_BS11_END_DB_TX_NACK,
101 NM_MT_BS11_CREATE_OBJ_NACK,
102 NM_MT_BS11_DELETE_OBJ_NACK,
103};
104
105static const struct value_string nack_names[] = {
106 { NM_MT_LOAD_INIT_NACK, "SOFTWARE LOAD INIT" },
107 { NM_MT_LOAD_END_NACK, "SOFTWARE LOAD END" },
108 { NM_MT_SW_ACT_REQ_NACK, "SOFTWARE ACTIVATE REQUEST" },
109 { NM_MT_ACTIVATE_SW_NACK, "ACTIVATE SOFTWARE" },
110 { NM_MT_ESTABLISH_TEI_NACK, "ESTABLISH TEI" },
111 { NM_MT_CONN_TERR_SIGN_NACK, "CONNECT TERRESTRIAL SIGNALLING" },
112 { NM_MT_DISC_TERR_SIGN_NACK, "DISCONNECT TERRESTRIAL SIGNALLING" },
113 { NM_MT_CONN_TERR_TRAF_NACK, "CONNECT TERRESTRIAL TRAFFIC" },
114 { NM_MT_DISC_TERR_TRAF_NACK, "DISCONNECT TERRESTRIAL TRAFFIC" },
115 { NM_MT_CONN_MDROP_LINK_NACK, "CONNECT MULTI-DROP LINK" },
116 { NM_MT_DISC_MDROP_LINK_NACK, "DISCONNECT MULTI-DROP LINK" },
117 { NM_MT_SET_BTS_ATTR_NACK, "SET BTS ATTRIBUTE" },
118 { NM_MT_SET_RADIO_ATTR_NACK, "SET RADIO ATTRIBUTE" },
119 { NM_MT_SET_CHAN_ATTR_NACK, "SET CHANNEL ATTRIBUTE" },
120 { NM_MT_PERF_TEST_NACK, "PERFORM TEST" },
121 { NM_MT_SEND_TEST_REP_NACK, "SEND TEST REPORT" },
122 { NM_MT_STOP_TEST_NACK, "STOP TEST" },
123 { NM_MT_STOP_EVENT_REP_NACK, "STOP EVENT REPORT" },
124 { NM_MT_REST_EVENT_REP_NACK, "RESET EVENT REPORT" },
125 { NM_MT_CHG_ADM_STATE_NACK, "CHANGE ADMINISTRATIVE STATE" },
126 { NM_MT_CHG_ADM_STATE_REQ_NACK,
127 "CHANGE ADMINISTRATIVE STATE REQUEST" },
128 { NM_MT_REP_OUTST_ALARMS_NACK, "REPORT OUTSTANDING ALARMS" },
129 { NM_MT_CHANGEOVER_NACK, "CHANGEOVER" },
130 { NM_MT_OPSTART_NACK, "OPSTART" },
131 { NM_MT_REINIT_NACK, "REINIT" },
132 { NM_MT_SET_SITE_OUT_NACK, "SET SITE OUTPUT" },
133 { NM_MT_CHG_HW_CONF_NACK, "CHANGE HARDWARE CONFIGURATION" },
134 { NM_MT_GET_ATTR_NACK, "GET ATTRIBUTE" },
135 { NM_MT_SET_ALARM_THRES_NACK, "SET ALARM THRESHOLD" },
136 { NM_MT_BS11_BEGIN_DB_TX_NACK, "BS11 BEGIN DATABASE TRANSMISSION" },
137 { NM_MT_BS11_END_DB_TX_NACK, "BS11 END DATABASE TRANSMISSION" },
138 { NM_MT_BS11_CREATE_OBJ_NACK, "BS11 CREATE OBJECT" },
139 { NM_MT_BS11_DELETE_OBJ_NACK, "BS11 DELETE OBJECT" },
140 { 0, NULL }
141};
142
Harald Welte4e777c32011-08-17 19:15:24 +0200143/*! \brief Get human-readable string for OML NACK message type */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200144const char *abis_nm_nack_name(uint8_t nack)
145{
146 return get_value_string(nack_names, nack);
147}
148
149/* Chapter 9.4.36 */
150static const struct value_string nack_cause_names[] = {
151 /* General Nack Causes */
152 { NM_NACK_INCORR_STRUCT, "Incorrect message structure" },
153 { NM_NACK_MSGTYPE_INVAL, "Invalid message type value" },
154 { NM_NACK_OBJCLASS_INVAL, "Invalid Object class value" },
155 { NM_NACK_OBJCLASS_NOTSUPP, "Object class not supported" },
156 { NM_NACK_BTSNR_UNKN, "BTS no. unknown" },
157 { NM_NACK_TRXNR_UNKN, "Baseband Transceiver no. unknown" },
158 { NM_NACK_OBJINST_UNKN, "Object Instance unknown" },
159 { NM_NACK_ATTRID_INVAL, "Invalid attribute identifier value" },
160 { NM_NACK_ATTRID_NOTSUPP, "Attribute identifier not supported" },
161 { NM_NACK_PARAM_RANGE, "Parameter value outside permitted range" },
162 { NM_NACK_ATTRLIST_INCONSISTENT,"Inconsistency in attribute list" },
163 { NM_NACK_SPEC_IMPL_NOTSUPP, "Specified implementation not supported" },
164 { NM_NACK_CANT_PERFORM, "Message cannot be performed" },
165 /* Specific Nack Causes */
166 { NM_NACK_RES_NOTIMPL, "Resource not implemented" },
167 { NM_NACK_RES_NOTAVAIL, "Resource not available" },
168 { NM_NACK_FREQ_NOTAVAIL, "Frequency not available" },
169 { NM_NACK_TEST_NOTSUPP, "Test not supported" },
170 { NM_NACK_CAPACITY_RESTR, "Capacity restrictions" },
171 { NM_NACK_PHYSCFG_NOTPERFORM, "Physical configuration cannot be performed" },
172 { NM_NACK_TEST_NOTINIT, "Test not initiated" },
173 { NM_NACK_PHYSCFG_NOTRESTORE, "Physical configuration cannot be restored" },
174 { NM_NACK_TEST_NOSUCH, "No such test" },
175 { NM_NACK_TEST_NOSTOP, "Test cannot be stopped" },
176 { NM_NACK_MSGINCONSIST_PHYSCFG, "Message inconsistent with physical configuration" },
177 { NM_NACK_FILE_INCOMPLETE, "Complete file notreceived" },
178 { NM_NACK_FILE_NOTAVAIL, "File not available at destination" },
179 { NM_NACK_FILE_NOTACTIVATE, "File cannot be activate" },
180 { NM_NACK_REQ_NOT_GRANT, "Request not granted" },
181 { NM_NACK_WAIT, "Wait" },
182 { NM_NACK_NOTH_REPORT_EXIST, "Nothing reportable existing" },
183 { NM_NACK_MEAS_NOTSUPP, "Measurement not supported" },
184 { NM_NACK_MEAS_NOTSTART, "Measurement not started" },
185 { 0, NULL }
186};
187
Harald Welte4e777c32011-08-17 19:15:24 +0200188/*! \brief Get human-readable string for NACK cause */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200189const char *abis_nm_nack_cause_name(uint8_t cause)
190{
191 return get_value_string(nack_cause_names, cause);
192}
193
194/* Chapter 9.4.16: Event Type */
195static const struct value_string event_type_names[] = {
196 { NM_EVT_COMM_FAIL, "communication failure" },
197 { NM_EVT_QOS_FAIL, "quality of service failure" },
198 { NM_EVT_PROC_FAIL, "processing failure" },
199 { NM_EVT_EQUIP_FAIL, "equipment failure" },
200 { NM_EVT_ENV_FAIL, "environment failure" },
201 { 0, NULL }
202};
203
Harald Welte4e777c32011-08-17 19:15:24 +0200204/*! \brief Get human-readable string for OML event type */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200205const char *abis_nm_event_type_name(uint8_t cause)
206{
207 return get_value_string(event_type_names, cause);
208}
209
210/* Chapter 9.4.63: Perceived Severity */
211static const struct value_string severity_names[] = {
212 { NM_SEVER_CEASED, "failure ceased" },
213 { NM_SEVER_CRITICAL, "critical failure" },
214 { NM_SEVER_MAJOR, "major failure" },
215 { NM_SEVER_MINOR, "minor failure" },
216 { NM_SEVER_WARNING, "warning level failure" },
217 { NM_SEVER_INDETERMINATE, "indeterminate failure" },
218 { 0, NULL }
219};
220
Harald Welte4e777c32011-08-17 19:15:24 +0200221/*! \brief Get human-readable string for perceived OML severity */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200222const char *abis_nm_severity_name(uint8_t cause)
223{
224 return get_value_string(severity_names, cause);
225}
226
Harald Welte4e777c32011-08-17 19:15:24 +0200227/*! \brief Attributes that the BSC can set, not only get, according to Section 9.4 */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200228const enum abis_nm_attr abis_nm_att_settable[] = {
229 NM_ATT_ADD_INFO,
230 NM_ATT_ADD_TEXT,
231 NM_ATT_DEST,
232 NM_ATT_EVENT_TYPE,
233 NM_ATT_FILE_DATA,
234 NM_ATT_GET_ARI,
235 NM_ATT_HW_CONF_CHG,
236 NM_ATT_LIST_REQ_ATTR,
237 NM_ATT_MDROP_LINK,
238 NM_ATT_MDROP_NEXT,
239 NM_ATT_NACK_CAUSES,
240 NM_ATT_OUTST_ALARM,
241 NM_ATT_PHYS_CONF,
242 NM_ATT_PROB_CAUSE,
243 NM_ATT_RAD_SUBC,
244 NM_ATT_SOURCE,
245 NM_ATT_SPEC_PROB,
246 NM_ATT_START_TIME,
247 NM_ATT_TEST_DUR,
248 NM_ATT_TEST_NO,
249 NM_ATT_TEST_REPORT,
250 NM_ATT_WINDOW_SIZE,
251 NM_ATT_SEVERITY,
252 NM_ATT_MEAS_RES,
253 NM_ATT_MEAS_TYPE,
254};
255
Harald Welte4e777c32011-08-17 19:15:24 +0200256/*! \brief GSM A-bis OML TLV parser definition */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200257const struct tlv_definition abis_nm_att_tlvdef = {
258 .def = {
259 [NM_ATT_ABIS_CHANNEL] = { TLV_TYPE_FIXED, 3 },
260 [NM_ATT_ADD_INFO] = { TLV_TYPE_TL16V },
261 [NM_ATT_ADD_TEXT] = { TLV_TYPE_TL16V },
262 [NM_ATT_ADM_STATE] = { TLV_TYPE_TV },
263 [NM_ATT_ARFCN_LIST]= { TLV_TYPE_TL16V },
264 [NM_ATT_AUTON_REPORT] = { TLV_TYPE_TV },
265 [NM_ATT_AVAIL_STATUS] = { TLV_TYPE_TL16V },
266 [NM_ATT_BCCH_ARFCN] = { TLV_TYPE_FIXED, 2 },
267 [NM_ATT_BSIC] = { TLV_TYPE_TV },
268 [NM_ATT_BTS_AIR_TIMER] = { TLV_TYPE_TV },
269 [NM_ATT_CCCH_L_I_P] = { TLV_TYPE_TV },
270 [NM_ATT_CCCH_L_T] = { TLV_TYPE_TV },
271 [NM_ATT_CHAN_COMB] = { TLV_TYPE_TV },
272 [NM_ATT_CONN_FAIL_CRIT] = { TLV_TYPE_TL16V },
273 [NM_ATT_DEST] = { TLV_TYPE_TL16V },
274 [NM_ATT_EVENT_TYPE] = { TLV_TYPE_TV },
275 [NM_ATT_FILE_DATA] = { TLV_TYPE_TL16V },
276 [NM_ATT_FILE_ID] = { TLV_TYPE_TL16V },
277 [NM_ATT_FILE_VERSION] = { TLV_TYPE_TL16V },
278 [NM_ATT_GSM_TIME] = { TLV_TYPE_FIXED, 2 },
279 [NM_ATT_HSN] = { TLV_TYPE_TV },
280 [NM_ATT_HW_CONFIG] = { TLV_TYPE_TL16V },
281 [NM_ATT_HW_DESC] = { TLV_TYPE_TL16V },
282 [NM_ATT_INTAVE_PARAM] = { TLV_TYPE_TV },
283 [NM_ATT_INTERF_BOUND] = { TLV_TYPE_FIXED, 6 },
284 [NM_ATT_LIST_REQ_ATTR] = { TLV_TYPE_TL16V },
285 [NM_ATT_MAIO] = { TLV_TYPE_TV },
286 [NM_ATT_MANUF_STATE] = { TLV_TYPE_TV },
287 [NM_ATT_MANUF_THRESH] = { TLV_TYPE_TL16V },
288 [NM_ATT_MANUF_ID] = { TLV_TYPE_TL16V },
289 [NM_ATT_MAX_TA] = { TLV_TYPE_TV },
290 [NM_ATT_MDROP_LINK] = { TLV_TYPE_FIXED, 2 },
291 [NM_ATT_MDROP_NEXT] = { TLV_TYPE_FIXED, 2 },
292 [NM_ATT_NACK_CAUSES] = { TLV_TYPE_TV },
293 [NM_ATT_NY1] = { TLV_TYPE_TV },
294 [NM_ATT_OPER_STATE] = { TLV_TYPE_TV },
295 [NM_ATT_OVERL_PERIOD] = { TLV_TYPE_TL16V },
296 [NM_ATT_PHYS_CONF] = { TLV_TYPE_TL16V },
297 [NM_ATT_POWER_CLASS] = { TLV_TYPE_TV },
298 [NM_ATT_POWER_THRESH] = { TLV_TYPE_FIXED, 3 },
299 [NM_ATT_PROB_CAUSE] = { TLV_TYPE_FIXED, 3 },
300 [NM_ATT_RACH_B_THRESH] = { TLV_TYPE_TV },
301 [NM_ATT_LDAVG_SLOTS] = { TLV_TYPE_FIXED, 2 },
302 [NM_ATT_RAD_SUBC] = { TLV_TYPE_TV },
303 [NM_ATT_RF_MAXPOWR_R] = { TLV_TYPE_TV },
304 [NM_ATT_SITE_INPUTS] = { TLV_TYPE_TL16V },
305 [NM_ATT_SITE_OUTPUTS] = { TLV_TYPE_TL16V },
306 [NM_ATT_SOURCE] = { TLV_TYPE_TL16V },
307 [NM_ATT_SPEC_PROB] = { TLV_TYPE_TV },
308 [NM_ATT_START_TIME] = { TLV_TYPE_FIXED, 2 },
309 [NM_ATT_T200] = { TLV_TYPE_FIXED, 7 },
310 [NM_ATT_TEI] = { TLV_TYPE_TV },
311 [NM_ATT_TEST_DUR] = { TLV_TYPE_FIXED, 2 },
312 [NM_ATT_TEST_NO] = { TLV_TYPE_TV },
313 [NM_ATT_TEST_REPORT] = { TLV_TYPE_TL16V },
314 [NM_ATT_VSWR_THRESH] = { TLV_TYPE_FIXED, 2 },
315 [NM_ATT_WINDOW_SIZE] = { TLV_TYPE_TV },
316 [NM_ATT_TSC] = { TLV_TYPE_TV },
317 [NM_ATT_SW_CONFIG] = { TLV_TYPE_TL16V },
318 [NM_ATT_SEVERITY] = { TLV_TYPE_TV },
319 [NM_ATT_GET_ARI] = { TLV_TYPE_TL16V },
320 [NM_ATT_HW_CONF_CHG] = { TLV_TYPE_TL16V },
321 [NM_ATT_OUTST_ALARM] = { TLV_TYPE_TV },
322 [NM_ATT_MEAS_RES] = { TLV_TYPE_TL16V },
323 },
324};
325
Harald Welte4e777c32011-08-17 19:15:24 +0200326/*! \brief Human-readable strings for A-bis OML Object Class */
Harald Welteea4b12a2011-05-23 20:41:31 +0200327const struct value_string abis_nm_obj_class_names[] = {
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200328 { NM_OC_SITE_MANAGER, "SITE-MANAGER" },
329 { NM_OC_BTS, "BTS" },
330 { NM_OC_RADIO_CARRIER, "RADIO-CARRIER" },
331 { NM_OC_BASEB_TRANSC, "BASEBAND-TRANSCEIVER" },
332 { NM_OC_CHANNEL, "CHANNEL" },
333 { NM_OC_BS11_ADJC, "ADJC" },
334 { NM_OC_BS11_HANDOVER, "HANDOVER" },
335 { NM_OC_BS11_PWR_CTRL, "POWER-CONTROL" },
336 { NM_OC_BS11_BTSE, "BTSE" },
337 { NM_OC_BS11_RACK, "RACK" },
338 { NM_OC_BS11_TEST, "TEST" },
339 { NM_OC_BS11_ENVABTSE, "ENVABTSE" },
340 { NM_OC_BS11_BPORT, "BPORT" },
341 { NM_OC_GPRS_NSE, "GPRS-NSE" },
342 { NM_OC_GPRS_CELL, "GPRS-CELL" },
343 { NM_OC_GPRS_NSVC, "GPRS-NSVC" },
344 { NM_OC_BS11, "SIEMENSHW" },
345 { 0, NULL }
346};
347
Harald Welte4e777c32011-08-17 19:15:24 +0200348/*! \brief Get human-readable string for OML Operational State */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200349const char *abis_nm_opstate_name(uint8_t os)
350{
351 switch (os) {
352 case NM_OPSTATE_DISABLED:
353 return "Disabled";
354 case NM_OPSTATE_ENABLED:
355 return "Enabled";
356 case NM_OPSTATE_NULL:
357 return "NULL";
358 default:
359 return "RFU";
360 }
361}
362
363/* Chapter 9.4.7 */
364static const struct value_string avail_names[] = {
365 { 0, "In test" },
366 { 1, "Failed" },
367 { 2, "Power off" },
368 { 3, "Off line" },
369 /* Not used */
370 { 5, "Dependency" },
371 { 6, "Degraded" },
372 { 7, "Not installed" },
373 { 0xff, "OK" },
374 { 0, NULL }
375};
376
Harald Welte4e777c32011-08-17 19:15:24 +0200377/*! \brief Get human-readable string for OML Availability State */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200378const char *abis_nm_avail_name(uint8_t avail)
379{
380 return get_value_string(avail_names, avail);
381}
382
Holger Hans Peter Freyther579fb092012-11-22 10:54:23 +0100383static const struct value_string test_names[] = {
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200384 /* FIXME: standard test names */
385 { NM_IPACC_TESTNO_CHAN_USAGE, "Channel Usage" },
386 { NM_IPACC_TESTNO_BCCH_CHAN_USAGE, "BCCH Channel Usage" },
387 { NM_IPACC_TESTNO_FREQ_SYNC, "Frequency Synchronization" },
388 { NM_IPACC_TESTNO_BCCH_INFO, "BCCH Info" },
389 { NM_IPACC_TESTNO_TX_BEACON, "Transmit Beacon" },
390 { NM_IPACC_TESTNO_SYSINFO_MONITOR, "System Info Monitor" },
391 { NM_IPACC_TESTNO_BCCCH_MONITOR, "BCCH Monitor" },
392 { 0, NULL }
393};
394
Harald Welte4e777c32011-08-17 19:15:24 +0200395/*! \brief Get human-readable string for OML test */
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200396const char *abis_nm_test_name(uint8_t test)
397{
398 return get_value_string(test_names, test);
399}
400
Harald Welte4e777c32011-08-17 19:15:24 +0200401/*! \brief Human-readable names for OML administrative state */
Harald Welteea4b12a2011-05-23 20:41:31 +0200402const struct value_string abis_nm_adm_state_names[] = {
Harald Weltef7a1bcc2011-05-22 22:45:16 +0200403 { NM_STATE_LOCKED, "Locked" },
404 { NM_STATE_UNLOCKED, "Unlocked" },
405 { NM_STATE_SHUTDOWN, "Shutdown" },
406 { NM_STATE_NULL, "NULL" },
407 { 0, NULL }
408};
409
Harald Welte11c71932011-05-24 17:15:12 +0200410static const enum abis_nm_chan_comb chcomb4pchan[] = {
Harald Welte7721a772011-06-29 18:44:06 +0200411 [GSM_PCHAN_NONE] = 0xff,
Harald Welte11c71932011-05-24 17:15:12 +0200412 [GSM_PCHAN_CCCH] = NM_CHANC_mainBCCH,
413 [GSM_PCHAN_CCCH_SDCCH4] = NM_CHANC_BCCHComb,
414 [GSM_PCHAN_TCH_F] = NM_CHANC_TCHFull,
415 [GSM_PCHAN_TCH_H] = NM_CHANC_TCHHalf,
416 [GSM_PCHAN_SDCCH8_SACCH8C] = NM_CHANC_SDCCH,
417 [GSM_PCHAN_PDCH] = NM_CHANC_IPAC_PDCH,
418 [GSM_PCHAN_TCH_F_PDCH] = NM_CHANC_IPAC_TCHFull_PDCH,
Harald Welte7721a772011-06-29 18:44:06 +0200419 [GSM_PCHAN_UNKNOWN] = 0xff,
Harald Welte11c71932011-05-24 17:15:12 +0200420 /* FIXME: bounds check */
421};
422
Harald Welte4e777c32011-08-17 19:15:24 +0200423/*! \brief Obtain OML Channel Combination for phnsical channel config */
Harald Welte11c71932011-05-24 17:15:12 +0200424int abis_nm_chcomb4pchan(enum gsm_phys_chan_config pchan)
425{
426 if (pchan < ARRAY_SIZE(chcomb4pchan))
427 return chcomb4pchan[pchan];
428
429 return -EINVAL;
430}
431
Harald Welte4e777c32011-08-17 19:15:24 +0200432/*! \brief Obtain physical channel config for OML Channel Combination */
Holger Hans Peter Freytherd4d87c52014-01-02 14:10:25 +0100433enum gsm_phys_chan_config abis_nm_pchan4chcomb(uint8_t chcomb)
Harald Welte11c71932011-05-24 17:15:12 +0200434{
435 int i;
436 for (i = 0; i < ARRAY_SIZE(chcomb4pchan); i++) {
437 if (chcomb4pchan[i] == chcomb)
438 return i;
439 }
440 return GSM_PCHAN_NONE;
441}
Harald Welte4e777c32011-08-17 19:15:24 +0200442
Harald Welte868a5c42013-02-10 09:29:27 +0100443/* this is just for compatibility reasons, it is now a macro */
444#undef abis_nm_debugp_foh
445void abis_nm_debugp_foh(int ss, struct abis_om_fom_hdr *foh)
446{
447 DEBUGP(ss, "OC=%s(%02x) INST=(%02x,%02x,%02x) ",
448 get_value_string(abis_nm_obj_class_names, foh->obj_class),
449 foh->obj_class, foh->obj_inst.bts_nr, foh->obj_inst.trx_nr,
450 foh->obj_inst.ts_nr);
451}
452
Sylvain Munautdca7d2c2012-04-18 21:53:23 +0200453/*! @} */