blob: 58cdafe7b1407b8b1a9ec919155e862da604d39b [file] [log] [blame]
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +02001/* A hackish minimal BSC (+MSC +HLR) implementation */
2
3/* (C) 2008-2009 by Harald Welte <laforge@gnumonks.org>
4 * (C) 2009 by Holger Hans Peter Freyther <zecke@selfish.org>
5 * All Rights Reserved
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 */
22
23#include <openbsc/gsm_data.h>
24#include <openbsc/gsm_utils.h>
25#include <openbsc/gsm_04_08.h>
26#include <openbsc/abis_rsl.h>
27#include <openbsc/abis_nm.h>
28#include <openbsc/debug.h>
29#include <openbsc/misdn.h>
30#include <openbsc/telnet_interface.h>
Harald Weltea43f7892009-12-01 18:04:30 +053031#include <openbsc/system_information.h>
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +020032#include <openbsc/paging.h>
33#include <openbsc/signal.h>
34#include <openbsc/talloc.h>
35
36/* global pointer to the gsm network data structure */
37extern struct gsm_network *bsc_gsmnet;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +020038
39static void patch_nm_tables(struct gsm_bts *bts);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +020040
41/* The following definitions are for OM and NM packets that we cannot yet
42 * generate by code but we just pass on */
43
44// BTS Site Manager, SET ATTRIBUTES
45
46/*
47 Object Class: BTS Site Manager
48 Instance 1: FF
49 Instance 2: FF
50 Instance 3: FF
51SET ATTRIBUTES
52 sAbisExternalTime: 2007/09/08 14:36:11
53 omLAPDRelTimer: 30sec
54 shortLAPDIntTimer: 5sec
55 emergencyTimer1: 10 minutes
56 emergencyTimer2: 0 minutes
57*/
58
59unsigned char msg_1[] =
60{
61 NM_MT_BS11_SET_ATTR, NM_OC_SITE_MANAGER, 0xFF, 0xFF, 0xFF,
62 NM_ATT_BS11_ABIS_EXT_TIME, 0x07,
63 0xD7, 0x09, 0x08, 0x0E, 0x24, 0x0B, 0xCE,
64 0x02,
65 0x00, 0x1E,
66 NM_ATT_BS11_SH_LAPD_INT_TIMER,
67 0x01, 0x05,
68 0x42, 0x02, 0x00, 0x0A,
69 0x44, 0x02, 0x00, 0x00
70};
71
72// BTS, SET BTS ATTRIBUTES
73
74/*
75 Object Class: BTS
76 BTS relat. Number: 0
77 Instance 2: FF
78 Instance 3: FF
79SET BTS ATTRIBUTES
80 bsIdentityCode / BSIC:
81 PLMN_colour_code: 7h
82 BS_colour_code: 7h
83 BTS Air Timer T3105: 4 ,unit 10 ms
84 btsIsHopping: FALSE
85 periodCCCHLoadIndication: 1sec
86 thresholdCCCHLoadIndication: 0%
87 cellAllocationNumber: 00h = GSM 900
88 enableInterferenceClass: 00h = Disabled
89 fACCHQual: 6 (FACCH stealing flags minus 1)
90 intaveParameter: 31 SACCH multiframes
91 interferenceLevelBoundaries:
92 Interference Boundary 1: 0Ah
93 Interference Boundary 2: 0Fh
94 Interference Boundary 3: 14h
95 Interference Boundary 4: 19h
96 Interference Boundary 5: 1Eh
97 mSTxPwrMax: 11
98 GSM range: 2=39dBm, 15=13dBm, stepsize 2 dBm
99 DCS1800 range: 0=30dBm, 15=0dBm, stepsize 2 dBm
100 PCS1900 range: 0=30dBm, 15=0dBm, stepsize 2 dBm
101 30=33dBm, 31=32dBm
102 ny1:
103 Maximum number of repetitions for PHYSICAL INFORMATION message (GSM 04.08): 20
104 powerOutputThresholds:
105 Out Power Fault Threshold: -10 dB
106 Red Out Power Threshold: - 6 dB
107 Excessive Out Power Threshold: 5 dB
108 rACHBusyThreshold: -127 dBm
109 rACHLoadAveragingSlots: 250 ,number of RACH burst periods
110 rfResourceIndicationPeriod: 125 SACCH multiframes
111 T200:
112 SDCCH: 044 in 5 ms
113 FACCH/Full rate: 031 in 5 ms
114 FACCH/Half rate: 041 in 5 ms
115 SACCH with TCH SAPI0: 090 in 10 ms
116 SACCH with SDCCH: 090 in 10 ms
117 SDCCH with SAPI3: 090 in 5 ms
118 SACCH with TCH SAPI3: 135 in 10 ms
119 tSync: 9000 units of 10 msec
120 tTrau: 9000 units of 10 msec
121 enableUmLoopTest: 00h = disabled
122 enableExcessiveDistance: 00h = Disabled
123 excessiveDistance: 64km
124 hoppingMode: 00h = baseband hopping
125 cellType: 00h = Standard Cell
126 BCCH ARFCN / bCCHFrequency: 1
127*/
128
129static unsigned char bs11_attr_bts[] =
130{
131 NM_ATT_BSIC, HARDCODED_BSIC,
132 NM_ATT_BTS_AIR_TIMER, 0x04,
133 NM_ATT_BS11_BTSLS_HOPPING, 0x00,
134 NM_ATT_CCCH_L_I_P, 0x01,
135 NM_ATT_CCCH_L_T, 0x00,
136 NM_ATT_BS11_CELL_ALLOC_NR, NM_BS11_CANR_GSM,
137 NM_ATT_BS11_ENA_INTERF_CLASS, 0x01,
138 NM_ATT_BS11_FACCH_QUAL, 0x06,
139 /* interference avg. period in numbers of SACCH multifr */
140 NM_ATT_INTAVE_PARAM, 0x1F,
141 NM_ATT_INTERF_BOUND, 0x0A, 0x0F, 0x14, 0x19, 0x1E, 0x7B,
142 NM_ATT_CCCH_L_T, 0x23,
143 NM_ATT_GSM_TIME, 0x28, 0x00,
144 NM_ATT_ADM_STATE, 0x03,
145 NM_ATT_RACH_B_THRESH, 0x7F,
146 NM_ATT_LDAVG_SLOTS, 0x00, 0xFA,
147 NM_ATT_BS11_RF_RES_IND_PER, 0x7D,
148 NM_ATT_T200, 0x2C, 0x1F, 0x29, 0x5A, 0x5A, 0x5A, 0x87,
149 NM_ATT_BS11_TSYNC, 0x23, 0x28,
150 NM_ATT_BS11_TTRAU, 0x23, 0x28,
151 NM_ATT_TEST_DUR, 0x01, 0x00,
152 NM_ATT_OUTST_ALARM, 0x01, 0x00,
153 NM_ATT_BS11_EXCESSIVE_DISTANCE, 0x01, 0x40,
154 NM_ATT_BS11_HOPPING_MODE, 0x01, 0x00,
155 NM_ATT_BS11_PLL, 0x01, 0x00,
156 NM_ATT_BCCH_ARFCN, 0x00, HARDCODED_ARFCN/*0x01*/,
157};
158
159// Handover Recognition, SET ATTRIBUTES
160
161/*
162Illegal Contents GSM Formatted O&M Msg
163 Object Class: Handover Recognition
164 BTS relat. Number: 0
165 Instance 2: FF
166 Instance 3: FF
167SET ATTRIBUTES
168 enableDelayPowerBudgetHO: 00h = Disabled
169 enableDistanceHO: 00h = Disabled
170 enableInternalInterCellHandover: 00h = Disabled
171 enableInternalIntraCellHandover: 00h = Disabled
172 enablePowerBudgetHO: 00h = Disabled
173 enableRXLEVHO: 00h = Disabled
174 enableRXQUALHO: 00h = Disabled
175 hoAveragingDistance: 8 SACCH multiframes
176 hoAveragingLev:
177 A_LEV_HO: 8 SACCH multiframes
178 W_LEV_HO: 1 SACCH multiframes
179 hoAveragingPowerBudget: 16 SACCH multiframes
180 hoAveragingQual:
181 A_QUAL_HO: 8 SACCH multiframes
182 W_QUAL_HO: 2 SACCH multiframes
183 hoLowerThresholdLevDL: (10 - 110) dBm
184 hoLowerThresholdLevUL: (5 - 110) dBm
185 hoLowerThresholdQualDL: 06h = 6.4% < BER < 12.8%
186 hoLowerThresholdQualUL: 06h = 6.4% < BER < 12.8%
187 hoThresholdLevDLintra : (20 - 110) dBm
188 hoThresholdLevULintra: (20 - 110) dBm
189 hoThresholdMsRangeMax: 20 km
190 nCell: 06h
191 timerHORequest: 3 ,unit 2 SACCH multiframes
192*/
193
194unsigned char msg_3[] =
195{
196 NM_MT_BS11_SET_ATTR, NM_OC_BS11_HANDOVER, 0x00, 0xFF, 0xFF,
197 0xD0, 0x00, /* enableDelayPowerBudgetHO */
198 0x64, 0x00, /* enableDistanceHO */
199 0x67, 0x00, /* enableInternalInterCellHandover */
200 0x68, 0x00, /* enableInternalInterCellHandover */
201 0x6A, 0x00, /* enablePowerBudgetHO */
202 0x6C, 0x00, /* enableRXLEVHO */
203 0x6D, 0x00, /* enableRXQUALHO */
204 0x6F, 0x08, /* hoAveragingDistance */
205 0x70, 0x08, 0x01, /* hoAveragingLev */
206 0x71, 0x10, 0x10, 0x10,
207 0x72, 0x08, 0x02, /* hoAveragingQual */
208 0x73, 0x0A, /* hoLowerThresholdLevDL */
209 0x74, 0x05, /* hoLowerThresholdLevUL */
210 0x75, 0x06, /* hoLowerThresholdQualDL */
211 0x76, 0x06, /* hoLowerThresholdQualUL */
212 0x78, 0x14, /* hoThresholdLevDLintra */
213 0x79, 0x14, /* hoThresholdLevULintra */
214 0x7A, 0x14, /* hoThresholdMsRangeMax */
215 0x7D, 0x06, /* nCell */
216 NM_ATT_BS11_TIMER_HO_REQUEST, 0x03,
217 0x20, 0x01, 0x00,
218 0x45, 0x01, 0x00,
219 0x48, 0x01, 0x00,
220 0x5A, 0x01, 0x00,
221 0x5B, 0x01, 0x05,
222 0x5E, 0x01, 0x1A,
223 0x5F, 0x01, 0x20,
224 0x9D, 0x01, 0x00,
225 0x47, 0x01, 0x00,
226 0x5C, 0x01, 0x64,
227 0x5D, 0x01, 0x1E,
228 0x97, 0x01, 0x20,
229 0xF7, 0x01, 0x3C,
230};
231
232// Power Control, SET ATTRIBUTES
233
234/*
235 Object Class: Power Control
236 BTS relat. Number: 0
237 Instance 2: FF
238 Instance 3: FF
239SET ATTRIBUTES
240 enableMsPowerControl: 00h = Disabled
241 enablePowerControlRLFW: 00h = Disabled
242 pcAveragingLev:
243 A_LEV_PC: 4 SACCH multiframes
244 W_LEV_PC: 1 SACCH multiframes
245 pcAveragingQual:
246 A_QUAL_PC: 4 SACCH multiframes
247 W_QUAL_PC: 2 SACCH multiframes
248 pcLowerThresholdLevDL: 0Fh
249 pcLowerThresholdLevUL: 0Ah
250 pcLowerThresholdQualDL: 05h = 3.2% < BER < 6.4%
251 pcLowerThresholdQualUL: 05h = 3.2% < BER < 6.4%
252 pcRLFThreshold: 0Ch
253 pcUpperThresholdLevDL: 14h
254 pcUpperThresholdLevUL: 0Fh
255 pcUpperThresholdQualDL: 04h = 1.6% < BER < 3.2%
256 pcUpperThresholdQualUL: 04h = 1.6% < BER < 3.2%
257 powerConfirm: 2 ,unit 2 SACCH multiframes
258 powerControlInterval: 2 ,unit 2 SACCH multiframes
259 powerIncrStepSize: 02h = 4 dB
260 powerRedStepSize: 01h = 2 dB
261 radioLinkTimeoutBs: 64 SACCH multiframes
262 enableBSPowerControl: 00h = disabled
263*/
264
265unsigned char msg_4[] =
266{
267 NM_MT_BS11_SET_ATTR, NM_OC_BS11_PWR_CTRL, 0x00, 0xFF, 0xFF,
268 NM_ATT_BS11_ENA_MS_PWR_CTRL, 0x00,
269 NM_ATT_BS11_ENA_PWR_CTRL_RLFW, 0x00,
270 0x7E, 0x04, 0x01, /* pcAveragingLev */
271 0x7F, 0x04, 0x02, /* pcAveragingQual */
272 0x80, 0x0F, /* pcLowerThresholdLevDL */
273 0x81, 0x0A, /* pcLowerThresholdLevUL */
274 0x82, 0x05, /* pcLowerThresholdQualDL */
275 0x83, 0x05, /* pcLowerThresholdQualUL */
276 0x84, 0x0C, /* pcRLFThreshold */
277 0x85, 0x14, /* pcUpperThresholdLevDL */
278 0x86, 0x0F, /* pcUpperThresholdLevUL */
279 0x87, 0x04, /* pcUpperThresholdQualDL */
280 0x88, 0x04, /* pcUpperThresholdQualUL */
281 0x89, 0x02, /* powerConfirm */
282 0x8A, 0x02, /* powerConfirmInterval */
283 0x8B, 0x02, /* powerIncrStepSize */
284 0x8C, 0x01, /* powerRedStepSize */
285 0x8D, 0x40, /* radioLinkTimeoutBs */
286 0x65, 0x01, 0x00 // set to 0x01 to enable BSPowerControl
287};
288
289
290// Transceiver, SET TRX ATTRIBUTES (TRX 0)
291
292/*
293 Object Class: Transceiver
294 BTS relat. Number: 0
295 Tranceiver number: 0
296 Instance 3: FF
297SET TRX ATTRIBUTES
298 aRFCNList (HEX): 0001
299 txPwrMaxReduction: 00h = 30dB
300 radioMeasGran: 254 SACCH multiframes
301 radioMeasRep: 01h = enabled
302 memberOfEmergencyConfig: 01h = TRUE
303 trxArea: 00h = TRX doesn't belong to a concentric cell
304*/
305
306static unsigned char bs11_attr_radio[] =
307{
308 NM_ATT_ARFCN_LIST, 0x01, 0x00, HARDCODED_ARFCN /*0x01*/,
309 NM_ATT_RF_MAXPOWR_R, 0x00,
310 NM_ATT_BS11_RADIO_MEAS_GRAN, 0x01, 0x05,
311 NM_ATT_BS11_RADIO_MEAS_REP, 0x01, 0x01,
312 NM_ATT_BS11_EMRG_CFG_MEMBER, 0x01, 0x01,
313 NM_ATT_BS11_TRX_AREA, 0x01, 0x00,
314};
315
316static unsigned char nanobts_attr_bts[] = {
317 NM_ATT_INTERF_BOUND, 0x55, 0x5b, 0x61, 0x67, 0x6d, 0x73,
318 /* interference avg. period in numbers of SACCH multifr */
319 NM_ATT_INTAVE_PARAM, 0x06,
320 /* conn fail based on SACCH error rate */
321 NM_ATT_CONN_FAIL_CRIT, 0x00, 0x02, 0x01, 0x10,
322 NM_ATT_T200, 0x1e, 0x24, 0x24, 0xa8, 0x34, 0x21, 0xa8,
323 NM_ATT_MAX_TA, 0x3f,
324 NM_ATT_OVERL_PERIOD, 0x00, 0x01, 10, /* seconds */
325 NM_ATT_CCCH_L_T, 10, /* percent */
326 NM_ATT_CCCH_L_I_P, 1, /* seconds */
327 NM_ATT_RACH_B_THRESH, 10, /* busy threshold in - dBm */
328 NM_ATT_LDAVG_SLOTS, 0x03, 0xe8, /* rach load averaging 1000 slots */
329 NM_ATT_BTS_AIR_TIMER, 128, /* miliseconds */
330 NM_ATT_NY1, 10, /* 10 retransmissions of physical config */
331 NM_ATT_BCCH_ARFCN, HARDCODED_ARFCN >> 8, HARDCODED_ARFCN & 0xff,
332 NM_ATT_BSIC, HARDCODED_BSIC,
333};
334
335static unsigned char nanobts_attr_radio[] = {
336 NM_ATT_RF_MAXPOWR_R, 0x0c, /* number of -2dB reduction steps / Pn */
337 NM_ATT_ARFCN_LIST, 0x00, 0x02, HARDCODED_ARFCN >> 8, HARDCODED_ARFCN & 0xff,
338};
339
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200340/* Callback function to be called whenever we get a GSM 12.21 state change event */
341int nm_state_event(enum nm_evt evt, u_int8_t obj_class, void *obj,
342 struct gsm_nm_state *old_state, struct gsm_nm_state *new_state)
343{
344 struct gsm_bts *bts;
345 struct gsm_bts_trx *trx;
346 struct gsm_bts_trx_ts *ts;
347
Harald Welte8406ec22009-10-20 17:31:00 +0200348 /* This event-driven BTS setup is currently only required on nanoBTS */
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200349
Harald Welte8406ec22009-10-20 17:31:00 +0200350 /* EVT_STATECHG_ADM is called after we call chg_adm_state() and would create
351 * endless loop */
352 if (evt != EVT_STATECHG_OPER)
353 return 0;
354
355 switch (obj_class) {
356 case NM_OC_SITE_MANAGER:
357 bts = container_of(obj, struct gsm_bts, site_mgr);
358 if (new_state->operational == 2 &&
359 new_state->availability == NM_AVSTATE_OK)
360 abis_nm_opstart(bts, obj_class, 0xff, 0xff, 0xff);
361 break;
362 case NM_OC_BTS:
363 bts = obj;
364 if (new_state->availability == NM_AVSTATE_DEPENDENCY) {
365 patch_nm_tables(bts);
366 abis_nm_set_bts_attr(bts, nanobts_attr_bts,
367 sizeof(nanobts_attr_bts));
368 abis_nm_chg_adm_state(bts, obj_class,
369 bts->bts_nr, 0xff, 0xff,
370 NM_STATE_UNLOCKED);
371 abis_nm_opstart(bts, obj_class,
372 bts->bts_nr, 0xff, 0xff);
373 }
374 break;
375 case NM_OC_CHANNEL:
376 ts = obj;
377 trx = ts->trx;
378 if (new_state->operational == 1 &&
379 new_state->availability == NM_AVSTATE_DEPENDENCY) {
Harald Welte65bdc912009-10-26 20:14:33 +0100380 patch_nm_tables(trx->bts);
Harald Welte0f890b02009-10-24 09:09:05 +0200381 enum abis_nm_chan_comb ccomb =
382 abis_nm_chcomb4pchan(ts->pchan);
383 abis_nm_set_channel_attr(ts, ccomb);
Harald Welte8406ec22009-10-20 17:31:00 +0200384 abis_nm_chg_adm_state(trx->bts, obj_class,
385 trx->bts->bts_nr, trx->nr, ts->nr,
386 NM_STATE_UNLOCKED);
387 abis_nm_opstart(trx->bts, obj_class,
388 trx->bts->bts_nr, trx->nr, ts->nr);
389 }
390 break;
391 case NM_OC_RADIO_CARRIER:
392 trx = obj;
393 if (new_state->operational == 1 &&
Harald Welte8406ec22009-10-20 17:31:00 +0200394 new_state->availability == NM_AVSTATE_OK)
395 abis_nm_opstart(trx->bts, obj_class, trx->bts->bts_nr,
396 trx->nr, 0xff);
397 break;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200398 default:
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200399 break;
400 }
401 return 0;
402}
403
404/* Callback function to be called every time we receive a 12.21 SW activated report */
405static int sw_activ_rep(struct msgb *mb)
406{
407 struct abis_om_fom_hdr *foh = msgb_l3(mb);
Harald Welted004a642009-10-19 21:47:54 +0200408 struct gsm_bts *bts = mb->trx->bts;
409 struct gsm_bts_trx *trx = gsm_bts_trx_num(bts, foh->obj_inst.trx_nr);
410
Harald Welteb7bcb792009-12-23 18:24:31 +0100411 if (!trx)
412 return -EINVAL;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200413
414 switch (foh->obj_class) {
Holger Hans Peter Freyther1ce10f32009-11-19 19:18:29 +0100415 case NM_OC_BASEB_TRANSC:
416 abis_nm_chg_adm_state(trx->bts, foh->obj_class,
417 trx->bts->bts_nr, trx->nr, 0xff,
418 NM_STATE_UNLOCKED);
419 abis_nm_opstart(trx->bts, foh->obj_class,
420 trx->bts->bts_nr, trx->nr, 0xff);
421 /* TRX software is active, tell it to initiate RSL Link */
422 abis_nm_ipaccess_rsl_connect(trx, 0, 3003, trx->rsl_tei);
423 break;
Holger Hans Peter Freyther2d501ea2009-11-11 11:54:24 +0100424 case NM_OC_RADIO_CARRIER: {
425 /*
426 * Locking the radio carrier will make it go
427 * offline again and we would come here. The
428 * framework should determine that there was
429 * no change and avoid recursion.
430 *
431 * This code is here to make sure that on start
432 * a TRX remains locked.
433 */
434 int rc_state = trx->rf_locked ?
435 NM_STATE_LOCKED : NM_STATE_UNLOCKED;
Holger Hans Peter Freyther1ce10f32009-11-19 19:18:29 +0100436 /* Patch ARFCN into radio attribute */
437 nanobts_attr_radio[5] &= 0xf0;
438 nanobts_attr_radio[5] |= trx->arfcn >> 8;
439 nanobts_attr_radio[6] = trx->arfcn & 0xff;
440 abis_nm_set_radio_attr(trx, nanobts_attr_radio,
441 sizeof(nanobts_attr_radio));
442 abis_nm_chg_adm_state(trx->bts, foh->obj_class,
443 trx->bts->bts_nr, trx->nr, 0xff,
Holger Hans Peter Freyther2d501ea2009-11-11 11:54:24 +0100444 rc_state);
Holger Hans Peter Freyther1ce10f32009-11-19 19:18:29 +0100445 abis_nm_opstart(trx->bts, foh->obj_class, trx->bts->bts_nr,
446 trx->nr, 0xff);
447 break;
Holger Hans Peter Freyther2d501ea2009-11-11 11:54:24 +0100448 }
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200449 }
450 return 0;
451}
452
453/* Callback function for NACK on the OML NM */
Harald Welted8cfc902009-11-17 06:09:56 +0100454static int oml_msg_nack(u_int8_t mt)
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200455{
456 if (mt == NM_MT_SET_BTS_ATTR_NACK) {
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100457 LOGP(DNM, LOGL_FATAL, "Failed to set BTS attributes. That is fatal. "
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200458 "Was the bts type and frequency properly specified?\n");
459 exit(-1);
460 }
461
462 return 0;
463}
464
465/* Callback function to be called every time we receive a signal from NM */
466static int nm_sig_cb(unsigned int subsys, unsigned int signal,
467 void *handler_data, void *signal_data)
468{
Harald Welted8cfc902009-11-17 06:09:56 +0100469 u_int8_t *msg_type;
470
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200471 switch (signal) {
472 case S_NM_SW_ACTIV_REP:
473 return sw_activ_rep(signal_data);
474 case S_NM_NACK:
Harald Welted8cfc902009-11-17 06:09:56 +0100475 msg_type = signal_data;
476 return oml_msg_nack(*msg_type);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200477 default:
478 break;
479 }
480 return 0;
481}
482
483static void bootstrap_om_nanobts(struct gsm_bts *bts)
484{
485 /* We don't do callback based bootstrapping, but event driven (see above) */
486}
487
488static void nm_reconfig_ts(struct gsm_bts_trx_ts *ts)
489{
490 enum abis_nm_chan_comb ccomb = abis_nm_chcomb4pchan(ts->pchan);
491 struct gsm_e1_subslot *e1l = &ts->e1_link;
492
493 abis_nm_set_channel_attr(ts, ccomb);
494
495 if (is_ipaccess_bts(ts->trx->bts))
496 return;
497
498 switch (ts->pchan) {
499 case GSM_PCHAN_TCH_F:
500 case GSM_PCHAN_TCH_H:
501 abis_nm_conn_terr_traf(ts, e1l->e1_nr, e1l->e1_ts,
502 e1l->e1_ts_ss);
503 break;
504 default:
505 break;
506 }
507}
508
509static void nm_reconfig_trx(struct gsm_bts_trx *trx)
510{
511 struct gsm_e1_subslot *e1l = &trx->rsl_e1_link;
512 int i;
513
514 patch_nm_tables(trx->bts);
515
516 switch (trx->bts->type) {
517 case GSM_BTS_TYPE_BS11:
518 /* FIXME: discover this by fetching an attribute */
519#if 0
520 trx->nominal_power = 15; /* 15dBm == 30mW PA configuration */
521#else
522 trx->nominal_power = 24; /* 24dBm == 250mW PA configuration */
523#endif
524 abis_nm_conn_terr_sign(trx, e1l->e1_nr, e1l->e1_ts,
525 e1l->e1_ts_ss);
526 abis_nm_establish_tei(trx->bts, trx->nr, e1l->e1_nr,
527 e1l->e1_ts, e1l->e1_ts_ss, trx->rsl_tei);
528
529 /* Set Radio Attributes */
530 if (trx == trx->bts->c0)
531 abis_nm_set_radio_attr(trx, bs11_attr_radio,
532 sizeof(bs11_attr_radio));
533 else {
534 u_int8_t trx1_attr_radio[sizeof(bs11_attr_radio)];
535 u_int8_t arfcn_low = trx->arfcn & 0xff;
536 u_int8_t arfcn_high = (trx->arfcn >> 8) & 0x0f;
537 memcpy(trx1_attr_radio, bs11_attr_radio,
538 sizeof(trx1_attr_radio));
539
540 /* patch ARFCN into TRX Attributes */
541 trx1_attr_radio[2] &= 0xf0;
542 trx1_attr_radio[2] |= arfcn_high;
543 trx1_attr_radio[3] = arfcn_low;
544
545 abis_nm_set_radio_attr(trx, trx1_attr_radio,
546 sizeof(trx1_attr_radio));
547 }
548 break;
Mike Habene2d82272009-10-02 12:19:34 +0100549 case GSM_BTS_TYPE_NANOBTS:
Harald Welteaf7b2fa2009-10-19 21:47:31 +0200550 switch (trx->bts->band) {
551 case GSM_BAND_850:
552 case GSM_BAND_900:
553 trx->nominal_power = 20;
554 break;
555 case GSM_BAND_1800:
556 case GSM_BAND_1900:
557 trx->nominal_power = 23;
558 break;
Holger Hans Peter Freyther555eba12009-10-22 15:46:16 +0200559 default:
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100560 LOGP(DNM, LOGL_ERROR, "Unsupported nanoBTS GSM band %s\n",
Harald Welteaf7b2fa2009-10-19 21:47:31 +0200561 gsm_band_name(trx->bts->band));
562 break;
563 }
564 break;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200565 default:
566 break;
567 }
568
569 for (i = 0; i < TRX_NR_TS; i++)
570 nm_reconfig_ts(&trx->ts[i]);
571}
572
573static void nm_reconfig_bts(struct gsm_bts *bts)
574{
575 struct gsm_bts_trx *trx;
576
577 switch (bts->type) {
578 case GSM_BTS_TYPE_BS11:
Harald Welteade7a142009-12-14 17:49:52 +0100579 patch_nm_tables(bts);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200580 abis_nm_raw_msg(bts, sizeof(msg_1), msg_1); /* set BTS SiteMgr attr*/
581 abis_nm_set_bts_attr(bts, bs11_attr_bts, sizeof(bs11_attr_bts));
582 abis_nm_raw_msg(bts, sizeof(msg_3), msg_3); /* set BTS handover attr */
583 abis_nm_raw_msg(bts, sizeof(msg_4), msg_4); /* set BTS power control attr */
584 break;
585 default:
586 break;
587 }
588
589 llist_for_each_entry(trx, &bts->trx_list, list)
590 nm_reconfig_trx(trx);
591}
592
593static void bootstrap_om_bs11(struct gsm_bts *bts)
594{
595 /* stop sending event reports */
596 abis_nm_event_reports(bts, 0);
597
598 /* begin DB transmission */
599 abis_nm_bs11_db_transmission(bts, 1);
600
601 /* end DB transmission */
602 abis_nm_bs11_db_transmission(bts, 0);
603
604 /* Reset BTS Site manager resource */
605 abis_nm_bs11_reset_resource(bts);
606
607 /* begin DB transmission */
608 abis_nm_bs11_db_transmission(bts, 1);
609
610 /* reconfigure BTS with all TRX and all TS */
611 nm_reconfig_bts(bts);
612
613 /* end DB transmission */
614 abis_nm_bs11_db_transmission(bts, 0);
615
616 /* Reset BTS Site manager resource */
617 abis_nm_bs11_reset_resource(bts);
618
619 /* restart sending event reports */
620 abis_nm_event_reports(bts, 1);
621}
622
623static void bootstrap_om(struct gsm_bts *bts)
624{
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100625 LOGP(DNM, LOGL_NOTICE, "bootstrapping OML for BTS %u\n", bts->nr);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200626
627 switch (bts->type) {
628 case GSM_BTS_TYPE_BS11:
629 bootstrap_om_bs11(bts);
630 break;
Mike Habene2d82272009-10-02 12:19:34 +0100631 case GSM_BTS_TYPE_NANOBTS:
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200632 bootstrap_om_nanobts(bts);
633 break;
634 default:
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100635 LOGP(DNM, LOGL_ERROR, "Unable to bootstrap OML: Unknown BTS type %d\n", bts->type);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200636 }
637}
638
639static int shutdown_om(struct gsm_bts *bts)
640{
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100641 LOGP(DNM, LOGL_NOTICE, "shutting down OML for BTS %u\n", bts->nr);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200642
643 /* stop sending event reports */
644 abis_nm_event_reports(bts, 0);
645
646 /* begin DB transmission */
647 abis_nm_bs11_db_transmission(bts, 1);
648
649 /* end DB transmission */
650 abis_nm_bs11_db_transmission(bts, 0);
651
652 /* Reset BTS Site manager resource */
653 abis_nm_bs11_reset_resource(bts);
654
655 return 0;
656}
657
658int bsc_shutdown_net(struct gsm_network *net)
659{
660 struct gsm_bts *bts;
661
662 llist_for_each_entry(bts, &net->bts_list, list) {
663 int rc;
664 rc = shutdown_om(bts);
665 if (rc < 0)
666 return rc;
667 }
668
669 return 0;
670}
671
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200672/* set all system information types */
673static int set_system_infos(struct gsm_bts_trx *trx)
674{
Harald Weltea43f7892009-12-01 18:04:30 +0530675 int i, rc;
676 u_int8_t si_tmp[23];
Harald Welte73d4fce2009-12-21 23:12:19 +0100677 struct gsm_bts *bts = trx->bts;
678
679 bts->si_common.cell_sel_par.ms_txpwr_max_ccch =
680 ms_pwr_ctl_lvl(bts->band, bts->ms_max_power);
681 bts->si_common.cell_sel_par.neci = bts->network->neci;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200682
683 if (trx == trx->bts->c0) {
Harald Weltea43f7892009-12-01 18:04:30 +0530684 for (i = 1; i <= 4; i++) {
685 rc = gsm_generate_si(si_tmp, trx->bts, i);
686 if (rc < 0)
687 goto err_out;
Harald Welte50e7fec2009-12-19 21:29:00 +0100688 DEBUGP(DRR, "SI%2u: %s\n", i, hexdump(si_tmp, rc));
Harald Weltea43f7892009-12-01 18:04:30 +0530689 rsl_bcch_info(trx, i, si_tmp, sizeof(si_tmp));
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200690 }
Harald Weltea43f7892009-12-01 18:04:30 +0530691#ifdef GPRS
Harald Welte9c4f6b52009-12-22 13:16:27 +0100692 i = 13;
Harald Welte6a22c012009-12-21 17:02:32 +0100693 rc = gsm_generate_si(si_tmp, trx->bts, RSL_SYSTEM_INFO_13);
694 if (rc < 0)
695 goto err_out;
696 DEBUGP(DRR, "SI%2u: %s\n", i, hexdump(si_tmp, rc));
697 rsl_bcch_info(trx, RSL_SYSTEM_INFO_13, si_tmp, rc);
Harald Weltea43f7892009-12-01 18:04:30 +0530698#endif
Harald Welte6a22c012009-12-21 17:02:32 +0100699 }
700
Harald Welte50e7fec2009-12-19 21:29:00 +0100701 i = 5;
702 rc = gsm_generate_si(si_tmp, trx->bts, RSL_SYSTEM_INFO_5);
703 if (rc < 0)
Harald Weltea43f7892009-12-01 18:04:30 +0530704 goto err_out;
Harald Welte50e7fec2009-12-19 21:29:00 +0100705 DEBUGP(DRR, "SI%2u: %s\n", i, hexdump(si_tmp, rc));
Harald Weltea43f7892009-12-01 18:04:30 +0530706 rsl_sacch_filling(trx, RSL_SYSTEM_INFO_5, si_tmp, rc);
707
Harald Welte50e7fec2009-12-19 21:29:00 +0100708 i = 6;
709 rc = gsm_generate_si(si_tmp, trx->bts, RSL_SYSTEM_INFO_6);
710 if (rc < 0)
Harald Weltea43f7892009-12-01 18:04:30 +0530711 goto err_out;
Harald Welte50e7fec2009-12-19 21:29:00 +0100712 DEBUGP(DRR, "SI%2u: %s\n", i, hexdump(si_tmp, rc));
Harald Weltea43f7892009-12-01 18:04:30 +0530713 rsl_sacch_filling(trx, RSL_SYSTEM_INFO_6, si_tmp, rc);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200714
715 return 0;
Harald Weltea43f7892009-12-01 18:04:30 +0530716err_out:
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100717 LOGP(DRR, LOGL_ERROR, "Cannot generate SI %u for BTS %u, most likely "
Harald Weltea43f7892009-12-01 18:04:30 +0530718 "a problem with neighbor cell list generation\n",
Harald Welte152b6262009-12-16 11:57:48 +0100719 i, trx->bts->nr);
Harald Weltea43f7892009-12-01 18:04:30 +0530720 return rc;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200721}
722
723/*
724 * Patch the various SYSTEM INFORMATION tables to update
725 * the LAI
726 */
727static void patch_nm_tables(struct gsm_bts *bts)
728{
729 u_int8_t arfcn_low = bts->c0->arfcn & 0xff;
730 u_int8_t arfcn_high = (bts->c0->arfcn >> 8) & 0x0f;
731
732 /* patch ARFCN into BTS Attributes */
733 bs11_attr_bts[69] &= 0xf0;
734 bs11_attr_bts[69] |= arfcn_high;
735 bs11_attr_bts[70] = arfcn_low;
736 nanobts_attr_bts[42] &= 0xf0;
737 nanobts_attr_bts[42] |= arfcn_high;
738 nanobts_attr_bts[43] = arfcn_low;
739
740 /* patch ARFCN into TRX Attributes */
741 bs11_attr_radio[2] &= 0xf0;
742 bs11_attr_radio[2] |= arfcn_high;
743 bs11_attr_radio[3] = arfcn_low;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200744
745 /* patch BSIC */
746 bs11_attr_bts[1] = bts->bsic;
747 nanobts_attr_bts[sizeof(nanobts_attr_bts)-1] = bts->bsic;
748
749 /* patch the power reduction */
750 bs11_attr_radio[5] = bts->c0->max_power_red / 2;
751 nanobts_attr_radio[1] = bts->c0->max_power_red / 2;
752}
753
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200754static void bootstrap_rsl(struct gsm_bts_trx *trx)
755{
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100756 LOGP(DRSL, LOGL_NOTICE, "bootstrapping RSL for BTS/TRX (%u/%u) "
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200757 "using MCC=%u MNC=%u BSIC=%u TSC=%u\n",
758 trx->bts->nr, trx->nr, bsc_gsmnet->country_code,
759 bsc_gsmnet->network_code, trx->bts->bsic, trx->bts->tsc);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200760 set_system_infos(trx);
761}
762
763void input_event(int event, enum e1inp_sign_type type, struct gsm_bts_trx *trx)
764{
765 switch (event) {
766 case EVT_E1_TEI_UP:
767 switch (type) {
768 case E1INP_SIGN_OML:
769 bootstrap_om(trx->bts);
770 break;
771 case E1INP_SIGN_RSL:
772 bootstrap_rsl(trx);
773 break;
774 default:
775 break;
776 }
777 break;
778 case EVT_E1_TEI_DN:
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100779 LOGP(DMI, LOGL_NOTICE, "Lost some E1 TEI link\n");
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200780 /* FIXME: deal with TEI or L1 link loss */
781 break;
782 default:
783 break;
784 }
785}
786
787static int bootstrap_bts(struct gsm_bts *bts)
788{
Mike Habene2d82272009-10-02 12:19:34 +0100789 switch (bts->band) {
790 case GSM_BAND_1800:
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200791 if (bts->c0->arfcn < 512 || bts->c0->arfcn > 885) {
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100792 LOGP(DNM, LOGL_ERROR, "GSM1800 channel must be between 512-885.\n");
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200793 return -EINVAL;
794 }
795 break;
Mike Habene2d82272009-10-02 12:19:34 +0100796 case GSM_BAND_1900:
797 if (bts->c0->arfcn < 512 || bts->c0->arfcn > 810) {
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100798 LOGP(DNM, LOGL_ERROR, "GSM1900 channel must be between 512-810.\n");
Mike Habene2d82272009-10-02 12:19:34 +0100799 return -EINVAL;
800 }
801 break;
802 case GSM_BAND_900:
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200803 if (bts->c0->arfcn < 1 || bts->c0->arfcn > 124) {
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100804 LOGP(DNM, LOGL_ERROR, "GSM900 channel must be between 1-124.\n");
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200805 return -EINVAL;
806 }
807 break;
Mike Habene2d82272009-10-02 12:19:34 +0100808 default:
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100809 LOGP(DNM, LOGL_ERROR, "Unsupported frequency band.\n");
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200810 return -EINVAL;
811 }
812
Harald Welted6aa5242009-12-12 13:44:19 +0100813 if (bts->network->auth_policy == GSM_AUTH_POLICY_ACCEPT_ALL &&
Harald Welte71355012009-12-21 23:08:18 +0100814 !bts->si_common.rach_control.cell_bar)
Harald Weltea992a362009-12-21 23:36:45 +0100815 LOGP(DNM, LOGL_ERROR, "\nWARNING: You are running an 'accept-all' "
Harald Welted6aa5242009-12-12 13:44:19 +0100816 "network on a BTS that is not barred. This "
817 "configuration is likely to interfere with production "
818 "GSM networks and should only be used in a RF "
819 "shielded environment such as a faraday cage!\n\n");
820
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200821 /* Control Channel Description */
Harald Weltea43f7892009-12-01 18:04:30 +0530822 bts->si_common.chan_desc.att = 1;
823 bts->si_common.chan_desc.ccch_conf = RSL_BCCH_CCCH_CONF_1_C;
824 bts->si_common.chan_desc.bs_pa_mfrms = RSL_BS_PA_MFRMS_5;
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200825 /* T3212 is set from vty/config */
826
Harald Weltea43f7892009-12-01 18:04:30 +0530827 /* some defaults for our system information */
Harald Weltea43f7892009-12-01 18:04:30 +0530828 bts->si_common.cell_options.radio_link_timeout = 2; /* 12 */
829 bts->si_common.cell_options.dtx = 2; /* MS shall not use upplink DTX */
830 bts->si_common.cell_options.pwrc = 0; /* PWRC not set */
831
Harald Weltea43f7892009-12-01 18:04:30 +0530832 bts->si_common.cell_sel_par.acs = 0;
Harald Weltea43f7892009-12-01 18:04:30 +0530833
834 bts->si_common.ncc_permitted = 0xff;
835
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200836 paging_init(bts);
837
838 return 0;
839}
840
841int bsc_bootstrap_network(int (*mncc_recv)(struct gsm_network *, int, void *),
842 const char *config_file)
843{
844 struct gsm_bts *bts;
845 int rc;
846
847 /* initialize our data structures */
848 bsc_gsmnet = gsm_network_init(1, 1, mncc_recv);
849 if (!bsc_gsmnet)
850 return -ENOMEM;
851
852 bsc_gsmnet->name_long = talloc_strdup(bsc_gsmnet, "OpenBSC");
853 bsc_gsmnet->name_short = talloc_strdup(bsc_gsmnet, "OpenBSC");
854
855 telnet_init(bsc_gsmnet, 4242);
856 rc = vty_read_config_file(config_file);
857 if (rc < 0) {
Harald Welteb1d4c8e2009-12-17 23:10:46 +0100858 LOGP(DNM, LOGL_FATAL, "Failed to parse the config file: '%s'\n", config_file);
Holger Hans Peter Freyther8b457fb2009-08-17 06:55:10 +0200859 return rc;
860 }
861
862 register_signal_handler(SS_NM, nm_sig_cb, NULL);
863
864 llist_for_each_entry(bts, &bsc_gsmnet->bts_list, list) {
865 bootstrap_bts(bts);
866 if (!is_ipaccess_bts(bts))
867 rc = e1_reconfig_bts(bts);
868
869 if (rc < 0)
870 exit (1);
871 }
872
873 /* initialize nanoBTS support omce */
874 rc = ipaccess_setup(bsc_gsmnet);
875
876 return 0;
877}