1780 lines
52 KiB
C
1780 lines
52 KiB
C
#ifndef _GSM_DATA_H
|
|
#define _GSM_DATA_H
|
|
|
|
#include <stdint.h>
|
|
#include <regex.h>
|
|
#include <sys/types.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
#include <osmocom/core/timer.h>
|
|
#include <osmocom/core/rate_ctr.h>
|
|
#include <osmocom/core/select.h>
|
|
#include <osmocom/core/stats.h>
|
|
#include <osmocom/core/stat_item.h>
|
|
#include <osmocom/gsm/bts_features.h>
|
|
#include <osmocom/gsm/protocol/gsm_08_08.h>
|
|
#include <osmocom/gsm/protocol/gsm_48_049.h>
|
|
#include <osmocom/gsm/gsm0808.h>
|
|
#include <osmocom/gsm/gsm48.h>
|
|
#include <osmocom/core/fsm.h>
|
|
#include <osmocom/core/tdef.h>
|
|
|
|
#include <osmocom/crypt/auth.h>
|
|
|
|
#include <osmocom/bsc/rest_octets.h>
|
|
|
|
#include <osmocom/core/bitvec.h>
|
|
#include <osmocom/gsm/gsm_utils.h>
|
|
#include <osmocom/gsm/rxlev_stat.h>
|
|
#include <osmocom/gsm/protocol/gsm_08_58.h>
|
|
#include <osmocom/gsm/protocol/gsm_12_21.h>
|
|
#include <osmocom/abis/e1_input.h>
|
|
#include <osmocom/bsc/meas_rep.h>
|
|
#include <osmocom/bsc/bsc_msg_filter.h>
|
|
#include <osmocom/bsc/acc_ramp.h>
|
|
#include <osmocom/bsc/neighbor_ident.h>
|
|
#include <osmocom/bsc/osmux.h>
|
|
|
|
#define GSM_T3122_DEFAULT 10
|
|
|
|
struct mgcp_client_conf;
|
|
struct mgcp_client;
|
|
struct gsm0808_cell_id;
|
|
struct osmo_mgcpc_ep;
|
|
|
|
/** annotations for msgb ownership */
|
|
#define __uses
|
|
|
|
#define OBSC_NM_W_ACK_CB(__msgb) (__msgb)->cb[3]
|
|
|
|
struct bsc_subscr;
|
|
struct gprs_ra_id;
|
|
struct handover;
|
|
|
|
#define OBSC_LINKID_CB(__msgb) (__msgb)->cb[3]
|
|
|
|
#define tmsi_from_string(str) strtoul(str, NULL, 10)
|
|
|
|
/* 3-bit long values */
|
|
#define EARFCN_PRIO_INVALID 8
|
|
#define EARFCN_MEAS_BW_INVALID 8
|
|
/* 5-bit long values */
|
|
#define EARFCN_QRXLV_INVALID 32
|
|
#define EARFCN_THRESH_LOW_INVALID 32
|
|
|
|
struct msgb;
|
|
typedef int gsm_cbfn(unsigned int hooknum,
|
|
unsigned int event,
|
|
struct msgb *msg,
|
|
void *data, void *param);
|
|
|
|
/* Maximum number of neighbor cells whose average we track */
|
|
#define MAX_NEIGH_MEAS 10
|
|
/* Maximum size of the averaging window for neighbor cells */
|
|
#define MAX_WIN_NEIGH_AVG 10
|
|
/* Maximum number of report history we store */
|
|
#define MAX_MEAS_REP 10
|
|
|
|
/* processed neighbor measurements for one cell */
|
|
struct neigh_meas_proc {
|
|
uint16_t arfcn;
|
|
uint8_t bsic;
|
|
uint8_t rxlev[MAX_WIN_NEIGH_AVG];
|
|
unsigned int rxlev_cnt;
|
|
uint8_t last_seen_nr;
|
|
};
|
|
|
|
struct gsm_classmark {
|
|
bool classmark1_set;
|
|
struct gsm48_classmark1 classmark1;
|
|
uint8_t classmark2_len;
|
|
uint8_t classmark2[3];
|
|
uint8_t classmark3_len;
|
|
uint8_t classmark3[14]; /* if cm3 gets extended by spec, it will be truncated */
|
|
};
|
|
|
|
enum subscr_sccp_state {
|
|
SUBSCR_SCCP_ST_NONE,
|
|
SUBSCR_SCCP_ST_WAIT_CONN_CONF,
|
|
SUBSCR_SCCP_ST_CONNECTED
|
|
};
|
|
|
|
enum channel_rate {
|
|
CH_RATE_SDCCH,
|
|
CH_RATE_HALF,
|
|
CH_RATE_FULL,
|
|
};
|
|
|
|
struct channel_mode_and_rate {
|
|
enum gsm48_chan_mode chan_mode;
|
|
enum channel_rate chan_rate;
|
|
uint16_t s15_s0;
|
|
};
|
|
|
|
/* Information retrieved during an Assignment Request from the MSC. This is storage of the Assignment instructions
|
|
* parsed from the Assignment Request message, to pass on until the gscon and assignment FSMs have decided whether an
|
|
* Assignment is actually going to be carried out. Should remain unchanged after initial decoding. */
|
|
struct assignment_request {
|
|
bool aoip;
|
|
|
|
uint16_t msc_assigned_cic;
|
|
|
|
char msc_rtp_addr[INET_ADDRSTRLEN];
|
|
uint16_t msc_rtp_port;
|
|
bool use_osmux;
|
|
uint8_t osmux_cid;
|
|
|
|
/* Rate/codec setting in preference order (need at least 1 !) */
|
|
int n_ch_mode_rate;
|
|
struct channel_mode_and_rate ch_mode_rate[3];
|
|
};
|
|
|
|
/* State of an ongoing Assignment, while the assignment_fsm is still busy. This serves as state separation to keep the
|
|
* currently used lchan and gscon unmodified until the outcome of an Assignment is known. If the Assignment fails, this
|
|
* state is simply discarded, and the gscon carries on with the original lchan remaining unchanged. */
|
|
struct assignment_fsm_data {
|
|
struct assignment_request req;
|
|
bool requires_voice_stream;
|
|
|
|
struct osmo_fsm_inst *fi;
|
|
struct gsm_lchan *new_lchan;
|
|
|
|
/* Whether this assignment triggered creation of the MGW endpoint: if the assignment
|
|
* fails, we will release that again as soon as possible. (If false, the endpoint already
|
|
* existed before or isn't needed at all.)*/
|
|
struct osmo_mgcpc_ep_ci *created_ci_for_msc;
|
|
|
|
enum gsm0808_cause failure_cause;
|
|
enum gsm48_rr_cause rr_cause;
|
|
|
|
bool result_rate_ctr_done;
|
|
};
|
|
|
|
enum hodec_id {
|
|
HODEC_NONE,
|
|
HODEC1 = 1,
|
|
HODEC2 = 2,
|
|
HODEC_USER,
|
|
HODEC_REMOTE,
|
|
};
|
|
|
|
/* For example, to count specific kinds of ongoing handovers, it is useful to be able to OR-combine
|
|
* scopes. */
|
|
enum handover_scope {
|
|
HO_NO_HANDOVER = 0,
|
|
HO_INTRA_CELL = 0x1,
|
|
HO_INTRA_BSC = 0x2,
|
|
HO_INTER_BSC_OUT = 0x4,
|
|
HO_INTER_BSC_IN = 0x8,
|
|
HO_SCOPE_ALL = 0xffff,
|
|
};
|
|
|
|
extern const struct value_string handover_scope_names[];
|
|
inline static const char *handover_scope_name(enum handover_scope val)
|
|
{ return get_value_string(handover_scope_names, val); }
|
|
|
|
struct handover_out_req {
|
|
enum hodec_id from_hodec_id;
|
|
struct gsm_lchan *old_lchan;
|
|
struct neighbor_ident_key target_nik;
|
|
enum gsm_chan_t new_lchan_type; /*< leave GSM_LCHAN_NONE to use same as old_lchan */
|
|
};
|
|
|
|
struct handover_in_req {
|
|
struct gsm0808_channel_type ct;
|
|
struct gsm0808_speech_codec_list scl;
|
|
struct gsm0808_encrypt_info ei;
|
|
struct gsm_classmark classmark;
|
|
/* chosen_encr_alg reflects the encoded value as in RSL_ENC_ALG_A5(a5_numer):
|
|
* chosen_encr_alg == 1 means A5/0 i.e. no encryption, chosen_encr_alg == 4 means A5/3.
|
|
* chosen_encr_alg == 0 means no such IE was present. */
|
|
uint8_t chosen_encr_alg;
|
|
struct gsm0808_cell_id cell_id_serving;
|
|
char cell_id_serving_name[64];
|
|
struct gsm0808_cell_id cell_id_target;
|
|
char cell_id_target_name[64];
|
|
uint16_t msc_assigned_cic;
|
|
char msc_assigned_rtp_addr[INET_ADDRSTRLEN];
|
|
uint16_t msc_assigned_rtp_port;
|
|
};
|
|
|
|
struct handover {
|
|
struct osmo_fsm_inst *fi;
|
|
|
|
enum hodec_id from_hodec_id;
|
|
enum handover_scope scope;
|
|
enum gsm_chan_t new_lchan_type;
|
|
struct neighbor_ident_key target_cell;
|
|
|
|
uint8_t ho_ref;
|
|
struct gsm_bts *new_bts;
|
|
struct gsm_lchan *new_lchan;
|
|
bool async;
|
|
struct handover_in_req inter_bsc_in;
|
|
struct osmo_mgcpc_ep_ci *created_ci_for_msc;
|
|
};
|
|
|
|
/* active radio connection of a mobile subscriber */
|
|
struct gsm_subscriber_connection {
|
|
/* global linked list of subscriber_connections */
|
|
struct llist_head entry;
|
|
|
|
/* FSM instance to control the subscriber connection state (RTP, A) */
|
|
struct osmo_fsm_inst *fi;
|
|
|
|
/* libbsc subscriber information (if available) */
|
|
struct bsc_subscr *bsub;
|
|
|
|
/* back pointers */
|
|
struct gsm_network *network;
|
|
|
|
/* the primary / currently active lchan to the BTS/subscriber. During Assignment and Handover, separate lchans
|
|
* are kept in the .assignment or .handover sub-structs, respectively, so that this lchan remains unaffected
|
|
* until Assignment or Handover have actually succeeded. */
|
|
struct gsm_lchan *lchan;
|
|
|
|
/* Only valid during an ongoing Assignment; might be overwritten at any time by a failed Assignment attempt.
|
|
* Once an Assignment was successful, all relevant state must be copied out of this sub-struct. */
|
|
struct assignment_fsm_data assignment;
|
|
|
|
/* handover information, if a handover is pending for this conn. Valid only during an ongoing Handover
|
|
* operation. If a Handover was successful, all relevant state must be copied out of this sub-struct. */
|
|
struct handover ho;
|
|
|
|
/* Queue DTAP messages during handover/assignment (msgb_enqueue()/msgb_dequeue())*/
|
|
struct llist_head dtap_queue;
|
|
unsigned int dtap_queue_len;
|
|
|
|
struct {
|
|
int failures;
|
|
struct penalty_timers *penalty_timers;
|
|
} hodec2;
|
|
|
|
/* "Codec List (MSC Preferred)" as received by the BSSAP Assignment Request. 3GPP 48.008
|
|
* 3.2.2.103 says:
|
|
* The "Codec List (MSC Preferred)" shall not include codecs
|
|
* that are not supported by the MS.
|
|
* i.e. by heeding the "Codec list (MSC Preferred)", we inherently heed the MS bearer
|
|
* capabilities, which the MSC is required to translate into the codec list. */
|
|
struct gsm0808_speech_codec_list codec_list;
|
|
|
|
/* flag to prevent multiple simultaneous ciphering commands */
|
|
int ciphering_handled;
|
|
|
|
/* state related to welcome USSD */
|
|
uint8_t new_subscriber;
|
|
|
|
/* state related to osmo_bsc_filter.c */
|
|
struct bsc_filter_state filter_state;
|
|
|
|
/* SCCP connection associatd with this subscriber_connection */
|
|
struct {
|
|
/* for advanced ping/pong */
|
|
int send_ping;
|
|
|
|
/* SCCP connection related */
|
|
struct bsc_msc_data *msc;
|
|
|
|
/* Sigtran connection ID */
|
|
int conn_id;
|
|
enum subscr_sccp_state state;
|
|
} sccp;
|
|
|
|
/* for audio handling */
|
|
struct {
|
|
uint16_t msc_assigned_cic;
|
|
|
|
/* RTP address where the MSC expects us to send the RTP stream coming from the BTS. */
|
|
char msc_assigned_rtp_addr[INET_ADDRSTRLEN];
|
|
uint16_t msc_assigned_rtp_port;
|
|
|
|
/* The endpoint at the MGW used to join both BTS and MSC side connections, e.g.
|
|
* "rtpbridge/23@mgw". */
|
|
struct osmo_mgcpc_ep *mgw_endpoint;
|
|
|
|
/* The connection identifier of the osmo_mgcpc_ep used to transceive RTP towards the MSC.
|
|
* (The BTS side CI is handled by struct gsm_lchan and the lchan_fsm.) */
|
|
struct osmo_mgcpc_ep_ci *mgw_endpoint_ci_msc;
|
|
} user_plane;
|
|
|
|
/* LCLS (local call, local switch) related state */
|
|
struct {
|
|
uint8_t global_call_ref[15];
|
|
uint8_t global_call_ref_len; /* length of global_call_ref */
|
|
enum gsm0808_lcls_config config; /* TS 48.008 3.2.2.116 */
|
|
enum gsm0808_lcls_control control; /* TS 48.008 3.2.2.117 */
|
|
/* LCLS FSM */
|
|
struct osmo_fsm_inst *fi;
|
|
/* pointer to "other" connection, if Call Leg Relocation was successful */
|
|
struct gsm_subscriber_connection *other;
|
|
} lcls;
|
|
|
|
/* MS Power Class, TS 05.05 sec 4.1.1 "Mobile station". 0 means unset. */
|
|
uint8_t ms_power_class:3;
|
|
};
|
|
|
|
|
|
/* 16 is the max. number of SI2quater messages according to 3GPP TS 44.018 Table 10.5.2.33b.1:
|
|
4-bit index is used (2#1111 = 10#15) */
|
|
#define SI2Q_MAX_NUM 16
|
|
/* length in bits (for single SI2quater message) */
|
|
#define SI2Q_MAX_LEN 160
|
|
#define SI2Q_MIN_LEN 18
|
|
|
|
struct osmo_bsc_data;
|
|
|
|
struct osmo_bsc_sccp_con;
|
|
|
|
/* Channel Request reason */
|
|
enum gsm_chreq_reason_t {
|
|
GSM_CHREQ_REASON_EMERG,
|
|
GSM_CHREQ_REASON_PAG,
|
|
GSM_CHREQ_REASON_CALL,
|
|
GSM_CHREQ_REASON_LOCATION_UPD,
|
|
GSM_CHREQ_REASON_OTHER,
|
|
GSM_CHREQ_REASON_PDCH,
|
|
};
|
|
|
|
/* lchans 0..3 are SDCCH in combined channel configuration,
|
|
use 4 as magic number for BCCH hack - see osmo-bts-../oml.c:opstart_compl() */
|
|
#define CCCH_LCHAN 4
|
|
|
|
#define TRX_NR_TS 8
|
|
#define TS_MAX_LCHAN 8
|
|
|
|
#define HARDCODED_ARFCN 123
|
|
#define HARDCODED_BSIC 0x3f /* NCC = 7 / BCC = 7 */
|
|
|
|
/* for multi-drop config */
|
|
#define HARDCODED_BTS0_TS 1
|
|
#define HARDCODED_BTS1_TS 6
|
|
#define HARDCODED_BTS2_TS 11
|
|
|
|
#define MAX_VERSION_LENGTH 64
|
|
|
|
enum gsm_hooks {
|
|
GSM_HOOK_NM_SWLOAD,
|
|
GSM_HOOK_RR_PAGING,
|
|
GSM_HOOK_RR_SECURITY,
|
|
};
|
|
|
|
enum bts_gprs_mode {
|
|
BTS_GPRS_NONE = 0,
|
|
BTS_GPRS_GPRS = 1,
|
|
BTS_GPRS_EGPRS = 2,
|
|
};
|
|
|
|
struct gsm_lchan;
|
|
struct osmo_rtp_socket;
|
|
struct rtp_socket;
|
|
|
|
/* Network Management State */
|
|
struct gsm_nm_state {
|
|
uint8_t operational;
|
|
uint8_t administrative;
|
|
uint8_t availability;
|
|
};
|
|
|
|
struct gsm_abis_mo {
|
|
uint8_t obj_class;
|
|
uint8_t procedure_pending;
|
|
struct abis_om_obj_inst obj_inst;
|
|
const char *name;
|
|
struct gsm_nm_state nm_state;
|
|
struct tlv_parsed *nm_attr;
|
|
struct gsm_bts *bts;
|
|
};
|
|
|
|
/* Ericsson OM2000 Managed Object */
|
|
struct abis_om2k_mo {
|
|
uint8_t class;
|
|
uint8_t bts;
|
|
uint8_t assoc_so;
|
|
uint8_t inst;
|
|
} __attribute__ ((packed));
|
|
|
|
struct om2k_mo {
|
|
struct abis_om2k_mo addr;
|
|
struct osmo_fsm_inst *fsm;
|
|
};
|
|
|
|
#define A38_XOR_MIN_KEY_LEN 12
|
|
#define A38_XOR_MAX_KEY_LEN 16
|
|
#define A38_COMP128_KEY_LEN 16
|
|
#define RSL_ENC_ALG_A5(x) (x+1)
|
|
#define MAX_EARFCN_LIST 32
|
|
|
|
/* is the data link established? who established it? */
|
|
#define LCHAN_SAPI_UNUSED 0
|
|
#define LCHAN_SAPI_MS 1
|
|
#define LCHAN_SAPI_NET 2
|
|
|
|
/* BTS ONLY */
|
|
#define MAX_NUM_UL_MEAS 104
|
|
#define LC_UL_M_F_L1_VALID (1 << 0)
|
|
#define LC_UL_M_F_RES_VALID (1 << 1)
|
|
|
|
struct bts_ul_meas {
|
|
/* BER in units of 0.01%: 10.000 == 100% ber, 0 == 0% ber */
|
|
uint16_t ber10k;
|
|
/* timing advance offset (in quarter bits) */
|
|
int16_t ta_offs_qbits;
|
|
/* C/I ratio in dB */
|
|
float c_i;
|
|
/* flags */
|
|
uint8_t is_sub:1;
|
|
/* RSSI in dBm * -1 */
|
|
uint8_t inv_rssi;
|
|
};
|
|
|
|
struct bts_codec_conf {
|
|
uint8_t hr;
|
|
uint8_t efr;
|
|
uint8_t amr;
|
|
};
|
|
|
|
struct amr_mode {
|
|
uint8_t mode;
|
|
uint8_t threshold;
|
|
uint8_t hysteresis;
|
|
};
|
|
|
|
struct amr_multirate_conf {
|
|
uint8_t gsm48_ie[2];
|
|
struct amr_mode ms_mode[4];
|
|
struct amr_mode bts_mode[4];
|
|
uint8_t num_modes;
|
|
};
|
|
/* /BTS ONLY */
|
|
|
|
enum lchan_csd_mode {
|
|
LCHAN_CSD_M_NT,
|
|
LCHAN_CSD_M_T_1200_75,
|
|
LCHAN_CSD_M_T_600,
|
|
LCHAN_CSD_M_T_1200,
|
|
LCHAN_CSD_M_T_2400,
|
|
LCHAN_CSD_M_T_9600,
|
|
LCHAN_CSD_M_T_14400,
|
|
LCHAN_CSD_M_T_29000,
|
|
LCHAN_CSD_M_T_32000,
|
|
};
|
|
|
|
/* State of the SAPIs in the lchan */
|
|
enum lchan_sapi_state {
|
|
LCHAN_SAPI_S_NONE,
|
|
LCHAN_SAPI_S_REQ,
|
|
LCHAN_SAPI_S_ASSIGNED,
|
|
LCHAN_SAPI_S_REL,
|
|
LCHAN_SAPI_S_ERROR,
|
|
};
|
|
|
|
#define MAX_A5_KEY_LEN (128/8)
|
|
|
|
struct gsm_encr {
|
|
uint8_t alg_id;
|
|
uint8_t key_len;
|
|
uint8_t key[MAX_A5_KEY_LEN];
|
|
};
|
|
|
|
#define LOGPLCHAN(lchan, ss, level, fmt, args...) \
|
|
LOGP(ss, level, "%s (ss=%d,%s) (%s) " fmt, \
|
|
lchan ? gsm_ts_and_pchan_name(lchan->ts) : "-", \
|
|
lchan ? lchan->nr : 0, \
|
|
lchan ? gsm_lchant_name(lchan->type) : "-", \
|
|
bsc_subscr_name(lchan && lchan->conn ? lchan->conn->bsub : NULL), \
|
|
## args)
|
|
|
|
/* Iterate lchans that have an FSM allocated based based on explicit pchan kind
|
|
* (GSM_PCHAN_* constant).
|
|
* Remark: PDCH related lchans are not handled in BSC but in PCU, so trying to
|
|
* iterate through GSM_PCHAN_PDCH is considered a void loop.
|
|
*/
|
|
#define ts_as_pchan_for_each_lchan(lchan, ts, as_pchan) \
|
|
for (lchan = (ts)->lchan; \
|
|
((lchan - (ts)->lchan) < ARRAY_SIZE((ts)->lchan)) \
|
|
&& lchan->fi \
|
|
&& lchan->nr < pchan_subslots(as_pchan); \
|
|
lchan++)
|
|
|
|
/* Iterate lchans that have an FSM allocated based on current PCHAN
|
|
* mode set in \ref ts.
|
|
* usage:
|
|
* struct gsm_lchan *lchan;
|
|
* struct gsm_bts_trx_ts *ts = get_some_timeslot();
|
|
* ts_for_each_lchan(lchan, ts) {
|
|
* LOGPLCHAN(DMAIN, LOGL_DEBUG, "hello world\n");
|
|
* }
|
|
*/
|
|
#define ts_for_each_lchan(lchan, ts) ts_as_pchan_for_each_lchan(lchan, ts, (ts)->pchan_is)
|
|
|
|
/* Iterate over all possible lchans available that have an FSM allocated based
|
|
* on PCHAN \ref ts (dynamic) configuration.
|
|
* Iterate all lchan instances set up by this \ref ts type, including those
|
|
* lchans currently disabled or in process of being enabled (e.g. due to dynamic
|
|
* timeslot in switchover). Compare ts_for_each_lchan(), which iterates only the
|
|
* enabled lchans.
|
|
* For example, it is useful in case dynamic timeslot \ref ts is in process of
|
|
* switching from configuration PDCH (no lchans) to TCH_F (1 lchan), where
|
|
* pchan_is is still set to PDCH but \ref ts may contain already an \ref lchan
|
|
* of type TCH_F which initiated the request to switch the \ts configuration.
|
|
*/
|
|
#define ts_for_each_potential_lchan(lchan, ts) ts_as_pchan_for_each_lchan(lchan, ts, (ts)->pchan_on_init)
|
|
|
|
enum lchan_activate_mode {
|
|
FOR_NONE,
|
|
FOR_MS_CHANNEL_REQUEST,
|
|
FOR_ASSIGNMENT,
|
|
FOR_HANDOVER,
|
|
FOR_VTY,
|
|
};
|
|
|
|
extern const struct value_string lchan_activate_mode_names[];
|
|
static inline const char *lchan_activate_mode_name(enum lchan_activate_mode activ_for)
|
|
{ return get_value_string(lchan_activate_mode_names, activ_for); }
|
|
|
|
struct lchan_activate_info {
|
|
enum lchan_activate_mode activ_for;
|
|
struct gsm_subscriber_connection *for_conn;
|
|
/* This always is for a specific lchan, so its lchan->type indicates full or half rate.
|
|
* When a dyn TS was selected, the lchan->type has been set to the desired rate. */
|
|
enum gsm48_chan_mode chan_mode;
|
|
struct gsm_encr encr;
|
|
/* AMR config */
|
|
uint16_t s15_s0;
|
|
bool requires_voice_stream;
|
|
bool wait_before_switching_rtp; /*< true = requires LCHAN_EV_READY_TO_SWITCH_RTP */
|
|
uint16_t msc_assigned_cic;
|
|
/* During intra-BSC handover, we keep the MGW endpoint intact and just re-route to the new lchan. This
|
|
* activate_info is for the new lchan, the re_use_mgw_endpoint_from_lchan points at the old lchan. */
|
|
struct gsm_lchan *re_use_mgw_endpoint_from_lchan;
|
|
};
|
|
|
|
struct gsm_lchan {
|
|
/* The TS that we're part of */
|
|
struct gsm_bts_trx_ts *ts;
|
|
/* The logical subslot number in the TS */
|
|
uint8_t nr;
|
|
char *name;
|
|
|
|
char *last_error;
|
|
|
|
struct osmo_fsm_inst *fi;
|
|
struct osmo_fsm_inst *fi_rtp;
|
|
struct osmo_mgcpc_ep_ci *mgw_endpoint_ci_bts;
|
|
|
|
struct {
|
|
struct lchan_activate_info info;
|
|
bool activ_ack; /*< true as soon as RSL Chan Activ Ack is received */
|
|
bool immediate_assignment_sent;
|
|
/*! This flag ensures that when an lchan activation has succeeded, and we have already
|
|
* sent ACKs like Immediate Assignment or BSSMAP Assignment Complete, and if other errors
|
|
* occur later, e.g. during release, that we don't send a NACK out of context. */
|
|
bool concluded;
|
|
enum gsm0808_cause gsm0808_error_cause;
|
|
} activate;
|
|
|
|
struct {
|
|
/* If an event to release the lchan comes in while still waiting for responses, just mark this
|
|
* flag, so that the lchan will gracefully release at the next sensible junction. */
|
|
bool requested;
|
|
bool do_rr_release;
|
|
|
|
/* There is an RSL error cause of value 0, so we need a separate flag. */
|
|
bool in_error;
|
|
/* RSL error code, RSL_ERR_* */
|
|
uint8_t rsl_error_cause;
|
|
|
|
/* If a release event is being handled, ignore other ricocheting release events until that
|
|
* release handling has concluded. */
|
|
bool in_release_handler;
|
|
|
|
/* is this release at the end of a CSFB call? */
|
|
bool is_csfb;
|
|
} release;
|
|
|
|
/* The logical channel type */
|
|
enum gsm_chan_t type;
|
|
/* RSL channel mode */
|
|
enum rsl_cmod_spd rsl_cmode;
|
|
/* If TCH, traffic channel mode */
|
|
enum gsm48_chan_mode tch_mode;
|
|
enum lchan_csd_mode csd_mode;
|
|
/* Power levels for MS and BTS */
|
|
uint8_t bs_power;
|
|
uint8_t ms_power;
|
|
/* Encryption information */
|
|
struct gsm_encr encr;
|
|
|
|
/* AMR bits */
|
|
uint8_t mr_ms_lv[7];
|
|
uint8_t mr_bts_lv[7];
|
|
/* AMR bits were based on these rate bits: */
|
|
uint16_t s15_s0;
|
|
|
|
/* Established data link layer services */
|
|
uint8_t sapis[8];
|
|
|
|
struct {
|
|
uint32_t bound_ip; /*< where the BTS receives RTP */
|
|
uint16_t bound_port;
|
|
uint32_t connect_ip; /*< where the BTS sends RTP to (MGW) */
|
|
uint16_t connect_port;
|
|
uint16_t conn_id;
|
|
uint8_t rtp_payload;
|
|
uint8_t rtp_payload2;
|
|
uint8_t speech_mode;
|
|
|
|
/* info we need to postpone the AoIP
|
|
* assignment completed message */
|
|
struct {
|
|
uint8_t rr_cause;
|
|
bool valid;
|
|
} ass_compl;
|
|
} abis_ip;
|
|
|
|
uint8_t rqd_ta;
|
|
|
|
/* table of neighbor cell measurements */
|
|
struct neigh_meas_proc neigh_meas[MAX_NEIGH_MEAS];
|
|
|
|
/* cache of last measurement reports on this lchan */
|
|
struct gsm_meas_rep meas_rep[MAX_MEAS_REP];
|
|
int meas_rep_idx;
|
|
int meas_rep_count;
|
|
uint8_t meas_rep_last_seen_nr;
|
|
|
|
/* GSM Random Access data */
|
|
/* TODO: don't allocate this, rather keep an "is_present" flag */
|
|
struct gsm48_req_ref *rqd_ref;
|
|
|
|
struct gsm_subscriber_connection *conn;
|
|
|
|
/* Depending on the preferences that where submitted together with
|
|
* the assignment and the current channel load, the BSC has to select
|
|
* one of the offered codec/rates. The final selection by the BSC is
|
|
* stored here and is used when sending the assignment complete or
|
|
* when performing a handover procedure. */
|
|
struct channel_mode_and_rate ch_mode_rate;
|
|
};
|
|
|
|
/* One Timeslot in a TRX */
|
|
struct gsm_bts_trx_ts {
|
|
struct gsm_bts_trx *trx;
|
|
/* number of this timeslot at the TRX */
|
|
uint8_t nr;
|
|
|
|
struct osmo_fsm_inst *fi;
|
|
char *last_errmsg;
|
|
|
|
/* vty phys_chan_config setting, not necessarily in effect in case it was changed in the telnet
|
|
* vty after OML activation. Gets written on vty 'write file'. */
|
|
enum gsm_phys_chan_config pchan_from_config;
|
|
/* When the timeslot OML is established, pchan_from_config is copied here. This is the pchan
|
|
* currently in effect; for dynamic ts, this is the dyn kind (GSM_PCHAN_TCH_F_TCH_H_PDCH or
|
|
* GSM_PCHAN_TCH_F_PDCH) and does not show the pchan type currently active. */
|
|
enum gsm_phys_chan_config pchan_on_init;
|
|
/* This is the *actual* pchan type currently active. For dynamic timeslots, this reflects either
|
|
* GSM_PCHAN_NONE or one of the standard GSM_PCHAN_TCH_F, GSM_PCHAN_TCH_H, GSM_PCHAN_PDCH.
|
|
* Callers can use this transparently without being aware of dyn ts. */
|
|
enum gsm_phys_chan_config pchan_is;
|
|
|
|
/* After a PDCH ACT NACK, we shall not infinitely loop to try and ACT again.
|
|
* Also marks a timeslot where PDCH was deactivated by VTY. This is cleared whenever a timeslot
|
|
* enters IN_USE state, i.e. after each TCH use we try to PDCH ACT once again. */
|
|
bool pdch_act_allowed;
|
|
|
|
/* Whether TS_EV_OML_READY was received */
|
|
bool is_oml_ready;
|
|
/* Whether TS_EV_RSL_READY was received */
|
|
bool is_rsl_ready;
|
|
|
|
struct gsm_abis_mo mo;
|
|
struct tlv_parsed nm_attr;
|
|
uint8_t nm_chan_comb;
|
|
int tsc; /* -1 == use BTS TSC */
|
|
|
|
struct {
|
|
/* Parameters below are configured by VTY */
|
|
int enabled;
|
|
uint8_t maio;
|
|
uint8_t hsn;
|
|
struct bitvec arfcns;
|
|
uint8_t arfcns_data[1024/8];
|
|
/* This is the pre-computed MA for channel assignments */
|
|
struct bitvec ma;
|
|
uint8_t ma_len; /* part of ma_data that is used */
|
|
uint8_t ma_data[8]; /* 10.5.2.21: max 8 bytes value part */
|
|
} hopping;
|
|
|
|
/* To which E1 subslot are we connected */
|
|
struct gsm_e1_subslot e1_link;
|
|
|
|
union {
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
} rbs2000;
|
|
};
|
|
|
|
struct gsm_lchan lchan[TS_MAX_LCHAN];
|
|
};
|
|
|
|
/* One TRX in a BTS */
|
|
struct gsm_bts_trx {
|
|
/* list header in bts->trx_list */
|
|
struct llist_head list;
|
|
|
|
struct gsm_bts *bts;
|
|
/* number of this TRX in the BTS */
|
|
uint8_t nr;
|
|
/* human readable name / description */
|
|
char *description;
|
|
/* how do we talk RSL with this TRX? */
|
|
struct gsm_e1_subslot rsl_e1_link;
|
|
uint8_t rsl_tei;
|
|
struct e1inp_sign_link *rsl_link;
|
|
|
|
/* Timeout for initiating the RSL connection. */
|
|
struct osmo_timer_list rsl_connect_timeout;
|
|
|
|
/* Some BTS (specifically Ericsson RBS) have a per-TRX OML Link */
|
|
struct e1inp_sign_link *oml_link;
|
|
|
|
struct gsm_abis_mo mo;
|
|
struct tlv_parsed nm_attr;
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} bb_transc;
|
|
|
|
uint16_t arfcn;
|
|
int nominal_power; /* in dBm */
|
|
unsigned int max_power_red; /* in actual dB */
|
|
|
|
union {
|
|
struct {
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} bbsig;
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} pa;
|
|
} bs11;
|
|
struct {
|
|
unsigned int test_state;
|
|
uint8_t test_nr;
|
|
struct rxlev_stats rxlev_stat;
|
|
} ipaccess;
|
|
struct {
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
} trxc;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
} rx;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
} tx;
|
|
} rbs2000;
|
|
};
|
|
struct gsm_bts_trx_ts ts[TRX_NR_TS];
|
|
};
|
|
|
|
#define GSM_BTS_SI2Q(bts, i) (struct gsm48_system_information_type_2quater *)((bts)->si_buf[SYSINFO_TYPE_2quater][i])
|
|
#define GSM_BTS_HAS_SI(bts, i) ((bts)->si_valid & (1 << i))
|
|
#define GSM_BTS_SI(bts, i) (void *)((bts)->si_buf[i][0])
|
|
#define GSM_LCHAN_SI(lchan, i) (void *)((lchan)->si.buf[i][0])
|
|
|
|
enum gsm_bts_type {
|
|
GSM_BTS_TYPE_UNKNOWN,
|
|
GSM_BTS_TYPE_BS11,
|
|
GSM_BTS_TYPE_NANOBTS,
|
|
GSM_BTS_TYPE_RBS2000,
|
|
GSM_BTS_TYPE_NOKIA_SITE,
|
|
GSM_BTS_TYPE_OSMOBTS,
|
|
_NUM_GSM_BTS_TYPE
|
|
};
|
|
|
|
enum gsm_bts_type_variant {
|
|
BTS_UNKNOWN,
|
|
BTS_OSMO_LITECELL15,
|
|
BTS_OSMO_OCTPHY,
|
|
BTS_OSMO_SYSMO,
|
|
BTS_OSMO_TRX,
|
|
_NUM_BTS_VARIANT
|
|
};
|
|
|
|
/* Used by OML layer for BTS Attribute reporting */
|
|
enum bts_attribute {
|
|
BTS_TYPE_VARIANT,
|
|
BTS_SUB_MODEL,
|
|
TRX_PHY_VERSION,
|
|
};
|
|
|
|
struct vty;
|
|
|
|
struct gsm_bts_model {
|
|
struct llist_head list;
|
|
|
|
enum gsm_bts_type type;
|
|
enum gsm_bts_type_variant variant;
|
|
const char *name;
|
|
|
|
bool started;
|
|
int (*start)(struct gsm_network *net);
|
|
int (*oml_rcvmsg)(struct msgb *msg);
|
|
char * (*oml_status)(const struct gsm_bts *bts);
|
|
|
|
void (*e1line_bind_ops)(struct e1inp_line *line);
|
|
|
|
void (*config_write_bts)(struct vty *vty, struct gsm_bts *bts);
|
|
void (*config_write_trx)(struct vty *vty, struct gsm_bts_trx *trx);
|
|
void (*config_write_ts)(struct vty *vty, struct gsm_bts_trx_ts *ts);
|
|
|
|
/* Should SI2bis and SI2ter be disabled by default on this BTS model? */
|
|
bool force_combined_si;
|
|
|
|
struct tlv_definition nm_att_tlvdef;
|
|
|
|
/* features of a given BTS model set via gsm_bts_model_register() locally */
|
|
struct bitvec features;
|
|
uint8_t _features_data[MAX_BTS_FEATURES/8];
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
* This keeps track of the paging status of one BTS. It
|
|
* includes a number of pending requests, a back pointer
|
|
* to the gsm_bts, a timer and some more state.
|
|
*/
|
|
struct gsm_bts_paging_state {
|
|
/* pending requests */
|
|
struct llist_head pending_requests;
|
|
struct gsm_bts *bts;
|
|
|
|
struct osmo_timer_list work_timer;
|
|
struct osmo_timer_list credit_timer;
|
|
|
|
/* free chans needed */
|
|
int free_chans_need;
|
|
|
|
/* load */
|
|
uint16_t available_slots;
|
|
};
|
|
|
|
struct gsm_envabtse {
|
|
struct gsm_abis_mo mo;
|
|
};
|
|
|
|
struct gsm_bts_gprs_nsvc {
|
|
struct gsm_bts *bts;
|
|
/* data read via VTY config file, to configure the BTS
|
|
* via OML from BSC */
|
|
int id;
|
|
uint16_t nsvci;
|
|
uint16_t local_port; /* on the BTS */
|
|
uint16_t remote_port; /* on the SGSN */
|
|
uint32_t remote_ip; /* on the SGSN */
|
|
|
|
struct gsm_abis_mo mo;
|
|
};
|
|
|
|
enum gprs_rlc_par {
|
|
RLC_T3142,
|
|
RLC_T3169,
|
|
RLC_T3191,
|
|
RLC_T3193,
|
|
RLC_T3195,
|
|
RLC_N3101,
|
|
RLC_N3103,
|
|
RLC_N3105,
|
|
CV_COUNTDOWN,
|
|
T_DL_TBF_EXT, /* ms */
|
|
T_UL_TBF_EXT, /* ms */
|
|
_NUM_RLC_PAR
|
|
};
|
|
|
|
enum gprs_cs {
|
|
GPRS_CS1,
|
|
GPRS_CS2,
|
|
GPRS_CS3,
|
|
GPRS_CS4,
|
|
GPRS_MCS1,
|
|
GPRS_MCS2,
|
|
GPRS_MCS3,
|
|
GPRS_MCS4,
|
|
GPRS_MCS5,
|
|
GPRS_MCS6,
|
|
GPRS_MCS7,
|
|
GPRS_MCS8,
|
|
GPRS_MCS9,
|
|
_NUM_GRPS_CS
|
|
};
|
|
|
|
struct gprs_rlc_cfg {
|
|
uint16_t parameter[_NUM_RLC_PAR];
|
|
struct {
|
|
uint16_t repeat_time; /* ms */
|
|
uint8_t repeat_count;
|
|
} paging;
|
|
uint32_t cs_mask; /* bitmask of gprs_cs */
|
|
uint8_t initial_cs;
|
|
uint8_t initial_mcs;
|
|
};
|
|
|
|
|
|
enum neigh_list_manual_mode {
|
|
NL_MODE_AUTOMATIC = 0,
|
|
NL_MODE_MANUAL = 1,
|
|
NL_MODE_MANUAL_SI5SEP = 2, /* SI2 and SI5 have separate neighbor lists */
|
|
};
|
|
|
|
enum bts_loc_fix {
|
|
BTS_LOC_FIX_INVALID = 0,
|
|
BTS_LOC_FIX_2D = 1,
|
|
BTS_LOC_FIX_3D = 2,
|
|
};
|
|
|
|
extern const struct value_string bts_loc_fix_names[];
|
|
|
|
struct bts_location {
|
|
struct llist_head list;
|
|
time_t tstamp;
|
|
enum bts_loc_fix valid;
|
|
double lat;
|
|
double lon;
|
|
double height;
|
|
};
|
|
|
|
/* Channel load counter */
|
|
struct load_counter {
|
|
unsigned int total;
|
|
unsigned int used;
|
|
};
|
|
|
|
/* Useful to track N-N relations between BTS, for example neighbors. */
|
|
struct gsm_bts_ref {
|
|
struct llist_head entry;
|
|
struct gsm_bts *bts;
|
|
};
|
|
|
|
/* A single Page of a SMSCB message */
|
|
struct bts_smscb_page {
|
|
/* SMSCB message we're part of */
|
|
struct bts_smscb_message *msg;
|
|
/* Page Number within message (1 to 15) */
|
|
uint8_t nr;
|
|
/* number of valid blocks in data (up to 4) */
|
|
uint8_t num_blocks;
|
|
/* up to four blocks of 22 bytes each */
|
|
uint8_t data[88];
|
|
};
|
|
|
|
/* A SMSCB message (received from CBSP) */
|
|
struct bts_smscb_message {
|
|
/* entry in bts_smscb_chan_state.messages */
|
|
struct llist_head list;
|
|
struct {
|
|
/* input data from CBSP (CBC) side */
|
|
uint16_t msg_id;
|
|
uint16_t serial_nr;
|
|
enum cbsp_category category;
|
|
uint16_t rep_period;
|
|
uint16_t num_bcast_req;
|
|
uint8_t dcs;
|
|
} input;
|
|
/* how often have all pages of this message been broadcast? */
|
|
uint32_t bcast_count;
|
|
/* actual page data of this message */
|
|
uint8_t num_pages; /* up to 15 */
|
|
struct bts_smscb_page page[15];
|
|
};
|
|
|
|
/* per-channel (basic/extended) CBCH state for a single BTS */
|
|
struct bts_smscb_chan_state {
|
|
/* back-pointer to BTS */
|
|
struct gsm_bts *bts;
|
|
/* list of bts_smscb_message */
|
|
struct llist_head messages;
|
|
/* scheduling array; pointer of SMSCB pages */
|
|
struct bts_smscb_page **sched_arr;
|
|
size_t sched_arr_size;
|
|
/* index of the next to be transmitted page into the scheduler array */
|
|
size_t next_idx;
|
|
/* number of messages we have to pause due to overflow */
|
|
uint8_t overflow;
|
|
};
|
|
|
|
struct bts_oml_fail_rep {
|
|
struct llist_head list;
|
|
time_t time;
|
|
struct msgb *mb;
|
|
};
|
|
|
|
/* One BTS */
|
|
struct gsm_bts {
|
|
/* list header in net->bts_list */
|
|
struct llist_head list;
|
|
|
|
/* Geographical location of the BTS */
|
|
struct llist_head loc_list;
|
|
|
|
/* number of this BTS in network */
|
|
uint8_t nr;
|
|
/* human readable name / description */
|
|
char *description;
|
|
/* Cell Identity */
|
|
uint16_t cell_identity;
|
|
/* location area code of this BTS */
|
|
uint16_t location_area_code;
|
|
/* Base Station Identification Code (BSIC), lower 3 bits is BCC,
|
|
* which is used as TSC for the CCCH */
|
|
uint8_t bsic;
|
|
/* type of BTS */
|
|
enum gsm_bts_type type;
|
|
enum gsm_bts_type_variant variant;
|
|
struct gsm_bts_model *model;
|
|
enum gsm_band band;
|
|
char version[MAX_VERSION_LENGTH];
|
|
char sub_model[MAX_VERSION_LENGTH];
|
|
|
|
/* features of a given BTS set/reported via OML */
|
|
struct bitvec features;
|
|
uint8_t _features_data[MAX_BTS_FEATURES/8];
|
|
|
|
/* Connected PCU version (if any) */
|
|
char pcu_version[MAX_VERSION_LENGTH];
|
|
|
|
/* maximum Tx power that the MS is permitted to use in this cell */
|
|
int ms_max_power;
|
|
|
|
/* how do we talk OML with this TRX? */
|
|
struct gsm_e1_subslot oml_e1_link;
|
|
uint8_t oml_tei;
|
|
struct e1inp_sign_link *oml_link;
|
|
/* Timer to use for deferred drop of OML link, see \ref ipaccess_drop_oml_deferred */
|
|
struct osmo_timer_list oml_drop_link_timer;
|
|
/* when OML link was established */
|
|
time_t uptime;
|
|
|
|
/* Abis network management O&M handle */
|
|
struct abis_nm_h *nmh;
|
|
|
|
struct gsm_abis_mo mo;
|
|
|
|
/* number of this BTS on given E1 link */
|
|
uint8_t bts_nr;
|
|
|
|
/* DTX features of this BTS */
|
|
enum gsm48_dtx_mode dtxu;
|
|
bool dtxd;
|
|
|
|
/* paging state and control */
|
|
struct gsm_bts_paging_state paging;
|
|
|
|
/* CCCH is on C0 */
|
|
struct gsm_bts_trx *c0;
|
|
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} site_mgr;
|
|
|
|
/* bitmask of all SI that are present/valid in si_buf */
|
|
uint32_t si_valid;
|
|
/* 3GPP TS 44.018 Table 10.5.2.33b.1 INDEX and COUNT for SI2quater */
|
|
uint8_t si2q_index; /* distinguish individual SI2quater messages */
|
|
uint8_t si2q_count; /* si2q_index for the last (highest indexed) individual SI2quater message */
|
|
/* buffers where we put the pre-computed SI */
|
|
sysinfo_buf_t si_buf[_MAX_SYSINFO_TYPE][SI2Q_MAX_NUM];
|
|
/* offsets used while generating SI2quater */
|
|
size_t e_offset;
|
|
size_t u_offset;
|
|
/* 3GPP TS 08.58 §8.5.1 BCCH INFORMATION. Some nanoBTS fail upon
|
|
* receival of empty SI disabling unsupported SI. see OS#3707. */
|
|
bool si_unused_send_empty;
|
|
|
|
/* ip.access Unit ID's have Site/BTS/TRX layout */
|
|
union {
|
|
struct {
|
|
uint16_t site_id;
|
|
uint16_t bts_id;
|
|
uint32_t flags;
|
|
uint32_t rsl_ip;
|
|
} ip_access;
|
|
struct {
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} cclk;
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
} rack;
|
|
struct gsm_envabtse envabtse[4];
|
|
} bs11;
|
|
struct {
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
struct llist_head conn_groups;
|
|
} cf;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
struct llist_head conn_groups;
|
|
} is;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
struct llist_head conn_groups;
|
|
} con;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
} dp;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
} tf;
|
|
struct {
|
|
struct om2k_mo om2k_mo;
|
|
struct gsm_abis_mo mo;
|
|
} mctr;
|
|
uint32_t use_superchannel:1;
|
|
struct {
|
|
uint16_t limit;
|
|
uint16_t active;
|
|
} om2k_version[16];
|
|
} rbs2000;
|
|
struct {
|
|
uint8_t bts_type;
|
|
unsigned int configured:1, /* we sent the config data request */
|
|
skip_reset:1, /* skip reset at bootstrap */
|
|
no_loc_rel_cnf:1, /* don't wait for RSL REL CONF */
|
|
bts_reset_timer_cnf, /* timer for BTS RESET */
|
|
did_reset:1, /* we received a RESET ACK */
|
|
wait_reset:2; /* we are waiting for reset to complete */
|
|
struct osmo_timer_list reset_timer;
|
|
} nokia;
|
|
};
|
|
|
|
/* Not entirely sure how ip.access specific this is */
|
|
struct {
|
|
enum bts_gprs_mode mode;
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
uint16_t nsei;
|
|
uint8_t timer[7];
|
|
} nse;
|
|
struct {
|
|
struct gsm_abis_mo mo;
|
|
uint16_t bvci;
|
|
uint8_t timer[11];
|
|
struct gprs_rlc_cfg rlc_cfg;
|
|
} cell;
|
|
struct gsm_bts_gprs_nsvc nsvc[2];
|
|
uint8_t rac;
|
|
uint8_t net_ctrl_ord;
|
|
bool ctrl_ack_type_use_block;
|
|
bool egprs_pkt_chan_request;
|
|
} gprs;
|
|
|
|
/* threshold (in percent) when BTS shall send CCCH LOAD IND */
|
|
int ccch_load_ind_thresh;
|
|
|
|
/* RACH NM values */
|
|
int rach_b_thresh;
|
|
int rach_ldavg_slots;
|
|
|
|
/* transceivers */
|
|
int num_trx;
|
|
struct llist_head trx_list;
|
|
|
|
/* SI related items */
|
|
int force_combined_si;
|
|
bool force_combined_si_set;
|
|
int bcch_change_mark;
|
|
|
|
/* Abis NM queue */
|
|
struct llist_head abis_queue;
|
|
int abis_nm_pend;
|
|
|
|
struct gsm_network *network;
|
|
|
|
/* should the channel allocator allocate channels from high TRX to TRX0,
|
|
* rather than starting from TRX0 and go upwards? */
|
|
int chan_alloc_reverse;
|
|
|
|
enum neigh_list_manual_mode neigh_list_manual_mode;
|
|
/* parameters from which we build SYSTEM INFORMATION */
|
|
struct {
|
|
struct gsm48_rach_control rach_control;
|
|
uint8_t ncc_permitted;
|
|
struct gsm48_cell_sel_par cell_sel_par;
|
|
struct gsm48_si_selection_params cell_ro_sel_par; /* rest octet */
|
|
struct gsm48_cell_options cell_options;
|
|
struct gsm48_control_channel_descr chan_desc;
|
|
struct bitvec neigh_list;
|
|
struct bitvec cell_alloc;
|
|
struct bitvec si5_neigh_list;
|
|
struct osmo_earfcn_si2q si2quater_neigh_list;
|
|
size_t uarfcn_length; /* index for uarfcn and scramble lists */
|
|
struct {
|
|
/* bitmask large enough for all possible ARFCN's */
|
|
uint8_t neigh_list[1024/8];
|
|
uint8_t cell_alloc[1024/8];
|
|
/* If the user wants a different neighbor list in SI5 than in SI2 */
|
|
uint8_t si5_neigh_list[1024/8];
|
|
uint8_t meas_bw_list[MAX_EARFCN_LIST];
|
|
uint16_t earfcn_list[MAX_EARFCN_LIST];
|
|
uint16_t uarfcn_list[MAX_EARFCN_LIST];
|
|
uint16_t scramble_list[MAX_EARFCN_LIST];
|
|
} data;
|
|
} si_common;
|
|
bool early_classmark_allowed;
|
|
bool early_classmark_allowed_3g;
|
|
/* for testing only: Have an infinitely long radio link timeout */
|
|
bool infinite_radio_link_timeout;
|
|
|
|
/* do we use static (user-defined) system information messages? (bitmask) */
|
|
uint32_t si_mode_static;
|
|
|
|
/* access control class ramping */
|
|
struct acc_ramp acc_ramp;
|
|
|
|
/* exclude the BTS from the global RF Lock handling */
|
|
int excl_from_rf_lock;
|
|
|
|
/* supported codecs beside FR */
|
|
struct bts_codec_conf codec;
|
|
|
|
/* BTS dependencies bit field */
|
|
uint32_t depends_on[256/(8*4)];
|
|
|
|
/* full and half rate multirate config */
|
|
struct amr_multirate_conf mr_full;
|
|
struct amr_multirate_conf mr_half;
|
|
|
|
/* PCU socket state */
|
|
char *pcu_sock_path;
|
|
struct pcu_sock_state *pcu_state;
|
|
|
|
struct rate_ctr_group *bts_ctrs;
|
|
struct osmo_stat_item_group *bts_statg;
|
|
|
|
struct handover_cfg *ho;
|
|
|
|
/* A list of struct gsm_bts_ref, indicating neighbors of this BTS.
|
|
* When the si_common neigh_list is in automatic mode, it is populated from this list as well as
|
|
* gsm_network->neighbor_bss_cells. */
|
|
struct llist_head local_neighbors;
|
|
|
|
/* BTS-specific overrides for timer values from struct gsm_network. */
|
|
uint8_t T3122; /* ASSIGNMENT REJECT wait indication */
|
|
bool T3113_dynamic; /* Calculate T3113 timeout dynamically based on BTS channel config and load */
|
|
|
|
/* Periodic channel load measurements are used to maintain T3122. */
|
|
struct load_counter chan_load_samples[7];
|
|
int chan_load_samples_idx;
|
|
uint8_t chan_load_avg; /* current channel load average in percent (0 - 100). */
|
|
|
|
/* cell broadcast system */
|
|
struct osmo_timer_list cbch_timer;
|
|
struct bts_smscb_chan_state cbch_basic;
|
|
struct bts_smscb_chan_state cbch_extended;
|
|
struct osmo_timer_list etws_timer; /* when to stop ETWS PN */
|
|
|
|
struct llist_head oml_fail_rep;
|
|
};
|
|
|
|
/* One rejected BTS */
|
|
struct gsm_bts_rejected {
|
|
/* list header in net->bts_rejected */
|
|
struct llist_head list;
|
|
|
|
uint16_t site_id;
|
|
uint16_t bts_id;
|
|
char ip[INET6_ADDRSTRLEN];
|
|
time_t time;
|
|
};
|
|
|
|
struct gsm_network *gsm_network_init(void *ctx);
|
|
|
|
struct gsm_bts *gsm_bts_alloc(struct gsm_network *net, uint8_t bts_num);
|
|
struct gsm_bts *gsm_bts_num(const struct gsm_network *net, int num);
|
|
bool gsm_bts_matches_lai(const struct gsm_bts *bts, const struct osmo_location_area_id *lai);
|
|
bool gsm_bts_matches_cell_id(const struct gsm_bts *bts, const struct gsm0808_cell_id *cell_id);
|
|
struct gsm_bts *gsm_bts_by_cell_id(const struct gsm_network *net,
|
|
const struct gsm0808_cell_id *cell_id,
|
|
int match_idx);
|
|
int gsm_bts_local_neighbor_add(struct gsm_bts *bts, struct gsm_bts *neighbor);
|
|
int gsm_bts_local_neighbor_del(struct gsm_bts *bts, const struct gsm_bts *neighbor);
|
|
|
|
struct gsm_bts_trx *gsm_bts_trx_alloc(struct gsm_bts *bts);
|
|
struct gsm_bts_trx *gsm_bts_trx_num(const struct gsm_bts *bts, int num);
|
|
|
|
enum gsm_bts_type str2btstype(const char *arg);
|
|
const char *btstype2str(enum gsm_bts_type type);
|
|
|
|
enum bts_attribute str2btsattr(const char *s);
|
|
const char *btsatttr2str(enum bts_attribute v);
|
|
|
|
enum gsm_bts_type_variant str2btsvariant(const char *arg);
|
|
const char *btsvariant2str(enum gsm_bts_type_variant v);
|
|
|
|
extern const struct value_string gsm_chreq_descs[];
|
|
extern const struct value_string gsm_pchant_names[];
|
|
extern const struct value_string gsm_pchant_descs[];
|
|
extern const struct value_string gsm_pchan_ids[];
|
|
const char *gsm_pchan_name(enum gsm_phys_chan_config c);
|
|
static inline const char *gsm_pchan_id(enum gsm_phys_chan_config c)
|
|
{ return get_value_string(gsm_pchan_ids, c); }
|
|
enum gsm_phys_chan_config gsm_pchan_parse(const char *name);
|
|
const char *gsm_lchant_name(enum gsm_chan_t c);
|
|
const char *gsm_chreq_name(enum gsm_chreq_reason_t c);
|
|
char *gsm_bts_name(const struct gsm_bts *bts);
|
|
char *gsm_trx_name(const struct gsm_bts_trx *trx);
|
|
char *gsm_ts_name(const struct gsm_bts_trx_ts *ts);
|
|
char *gsm_ts_and_pchan_name(const struct gsm_bts_trx_ts *ts);
|
|
char *gsm_lchan_name_compute(const struct gsm_lchan *lchan);
|
|
|
|
static inline char *gsm_lchan_name(const struct gsm_lchan *lchan)
|
|
{
|
|
return lchan->name;
|
|
}
|
|
|
|
void gsm_abis_mo_reset(struct gsm_abis_mo *mo);
|
|
|
|
struct gsm_nm_state *
|
|
gsm_objclass2nmstate(struct gsm_bts *bts, uint8_t obj_class,
|
|
const struct abis_om_obj_inst *obj_inst);
|
|
void *
|
|
gsm_objclass2obj(struct gsm_bts *bts, uint8_t obj_class,
|
|
const struct abis_om_obj_inst *obj_inst);
|
|
|
|
/* reset the state of all MO in the BTS */
|
|
void gsm_bts_mo_reset(struct gsm_bts *bts);
|
|
|
|
uint8_t gsm_pchan2chan_nr(enum gsm_phys_chan_config pchan,
|
|
uint8_t ts_nr, uint8_t lchan_nr);
|
|
uint8_t gsm_lchan2chan_nr(const struct gsm_lchan *lchan);
|
|
uint8_t gsm_lchan_as_pchan2chan_nr(const struct gsm_lchan *lchan,
|
|
enum gsm_phys_chan_config as_pchan);
|
|
|
|
void gsm48_lchan2chan_desc(struct gsm48_chan_desc *cd,
|
|
const struct gsm_lchan *lchan);
|
|
void gsm48_lchan2chan_desc_as_configured(struct gsm48_chan_desc *cd, const struct gsm_lchan *lchan);
|
|
|
|
/* return the gsm_lchan for the CBCH (if it exists at all) */
|
|
struct gsm_lchan *gsm_bts_get_cbch(struct gsm_bts *bts);
|
|
|
|
/*
|
|
* help with parsing regexps
|
|
*/
|
|
int gsm_parse_reg(void *ctx, regex_t *reg, char **str,
|
|
int argc, const char **argv) __attribute__ ((warn_unused_result));
|
|
|
|
static inline uint8_t gsm_ts_tsc(const struct gsm_bts_trx_ts *ts)
|
|
{
|
|
if (ts->tsc != -1)
|
|
return ts->tsc;
|
|
else
|
|
return ts->trx->bts->bsic & 7;
|
|
}
|
|
|
|
struct gsm_lchan *rsl_lchan_lookup(struct gsm_bts_trx *trx, uint8_t chan_nr,
|
|
int *rc);
|
|
|
|
enum gsm_phys_chan_config ts_pchan(struct gsm_bts_trx_ts *ts);
|
|
uint8_t pchan_subslots(enum gsm_phys_chan_config pchan);
|
|
bool ts_is_tch(struct gsm_bts_trx_ts *ts);
|
|
|
|
|
|
static inline struct gsm_bts *conn_get_bts(struct gsm_subscriber_connection *conn) {
|
|
OSMO_ASSERT(conn->lchan);
|
|
return conn->lchan->ts->trx->bts;
|
|
}
|
|
|
|
void conn_update_ms_power_class(struct gsm_subscriber_connection *conn, uint8_t power_class);
|
|
void lchan_update_ms_power_ctrl_level(struct gsm_lchan *lchan, int ms_power_dbm);
|
|
|
|
enum {
|
|
BTS_CTR_CHREQ_TOTAL,
|
|
BTS_CTR_CHREQ_NO_CHANNEL,
|
|
BTS_CTR_CHAN_RF_FAIL,
|
|
BTS_CTR_CHAN_RLL_ERR,
|
|
BTS_CTR_BTS_OML_FAIL,
|
|
BTS_CTR_BTS_RSL_FAIL,
|
|
BTS_CTR_CODEC_AMR_F,
|
|
BTS_CTR_CODEC_AMR_H,
|
|
BTS_CTR_CODEC_EFR,
|
|
BTS_CTR_CODEC_V1_FR,
|
|
BTS_CTR_CODEC_V1_HR,
|
|
BTS_CTR_PAGING_ATTEMPTED,
|
|
BTS_CTR_PAGING_ALREADY,
|
|
BTS_CTR_PAGING_RESPONDED,
|
|
BTS_CTR_PAGING_EXPIRED,
|
|
BTS_CTR_CHAN_ACT_TOTAL,
|
|
BTS_CTR_CHAN_ACT_NACK,
|
|
BTS_CTR_RSL_UNKNOWN,
|
|
BTS_CTR_RSL_IPA_NACK,
|
|
BTS_CTR_MODE_MODIFY_NACK,
|
|
};
|
|
|
|
static const struct rate_ctr_desc bts_ctr_description[] = {
|
|
[BTS_CTR_CHREQ_TOTAL] = {"chreq:total", "Received channel requests."},
|
|
[BTS_CTR_CHREQ_NO_CHANNEL] = {"chreq:no_channel", "Sent to MS no channel available."},
|
|
[BTS_CTR_CHAN_RF_FAIL] = {"chan:rf_fail", "Received a RF failure indication from BTS."},
|
|
[BTS_CTR_CHAN_RLL_ERR] = {"chan:rll_err", "Received a RLL failure with T200 cause from BTS."},
|
|
[BTS_CTR_BTS_OML_FAIL] = {"oml_fail", "Received a TEI down on a OML link."},
|
|
[BTS_CTR_BTS_RSL_FAIL] = {"rsl_fail", "Received a TEI down on a OML link."},
|
|
[BTS_CTR_CODEC_AMR_F] = {"codec:amr_f", "Count the usage of AMR/F codec by channel mode requested."},
|
|
[BTS_CTR_CODEC_AMR_H] = {"codec:amr_h", "Count the usage of AMR/H codec by channel mode requested."},
|
|
[BTS_CTR_CODEC_EFR] = {"codec:efr", "Count the usage of EFR codec by channel mode requested."},
|
|
[BTS_CTR_CODEC_V1_FR] = {"codec:fr", "Count the usage of FR codec by channel mode requested."},
|
|
[BTS_CTR_CODEC_V1_HR] = {"codec:hr", "Count the usage of HR codec by channel mode requested."},
|
|
|
|
[BTS_CTR_PAGING_ATTEMPTED] = {"paging:attempted", "Paging attempts for a subscriber."},
|
|
[BTS_CTR_PAGING_ALREADY] = {"paging:already", "Paging attempts ignored as subscriber was already being paged."},
|
|
[BTS_CTR_PAGING_RESPONDED] = {"paging:responded", "Paging attempts with successful paging response."},
|
|
[BTS_CTR_PAGING_EXPIRED] = {"paging:expired", "Paging Request expired because of timeout T3113."},
|
|
[BTS_CTR_CHAN_ACT_TOTAL] = {"chan_act:total", "Total number of Channel Activations."},
|
|
[BTS_CTR_CHAN_ACT_NACK] = {"chan_act:nack", "Number of Channel Activations that the BTS NACKed"},
|
|
[BTS_CTR_RSL_UNKNOWN] = {"rsl:unknown", "Number of unknown/unsupported RSL messages received from BTS"},
|
|
[BTS_CTR_RSL_IPA_NACK] = {"rsl:ipa_nack", "Number of IPA (RTP/dyn-PDCH) related NACKs received from BTS"},
|
|
[BTS_CTR_MODE_MODIFY_NACK] = {"chan:mode_modify_nack", "Number of Channel Mode Modify NACKs received from BTS"},
|
|
};
|
|
|
|
static const struct rate_ctr_group_desc bts_ctrg_desc = {
|
|
"bts",
|
|
"base transceiver station",
|
|
OSMO_STATS_CLASS_GLOBAL,
|
|
ARRAY_SIZE(bts_ctr_description),
|
|
bts_ctr_description,
|
|
};
|
|
|
|
enum {
|
|
BTS_STAT_CHAN_LOAD_AVERAGE,
|
|
BTS_STAT_T3122,
|
|
BTS_STAT_RACH_BUSY,
|
|
BTS_STAT_RACH_ACCESS,
|
|
};
|
|
|
|
enum {
|
|
BSC_CTR_ASSIGNMENT_ATTEMPTED,
|
|
BSC_CTR_ASSIGNMENT_COMPLETED,
|
|
BSC_CTR_ASSIGNMENT_STOPPED,
|
|
BSC_CTR_ASSIGNMENT_NO_CHANNEL,
|
|
BSC_CTR_ASSIGNMENT_TIMEOUT,
|
|
BSC_CTR_ASSIGNMENT_FAILED,
|
|
BSC_CTR_ASSIGNMENT_ERROR,
|
|
BSC_CTR_HANDOVER_ATTEMPTED,
|
|
BSC_CTR_HANDOVER_COMPLETED,
|
|
BSC_CTR_HANDOVER_STOPPED,
|
|
BSC_CTR_HANDOVER_NO_CHANNEL,
|
|
BSC_CTR_HANDOVER_TIMEOUT,
|
|
BSC_CTR_HANDOVER_FAILED,
|
|
BSC_CTR_HANDOVER_ERROR,
|
|
BSC_CTR_INTER_BSC_HO_OUT_ATTEMPTED,
|
|
BSC_CTR_INTER_BSC_HO_OUT_COMPLETED,
|
|
BSC_CTR_INTER_BSC_HO_OUT_STOPPED,
|
|
BSC_CTR_INTER_BSC_HO_OUT_TIMEOUT,
|
|
BSC_CTR_INTER_BSC_HO_OUT_ERROR,
|
|
BSC_CTR_INTER_BSC_HO_IN_ATTEMPTED,
|
|
BSC_CTR_INTER_BSC_HO_IN_COMPLETED,
|
|
BSC_CTR_INTER_BSC_HO_IN_STOPPED,
|
|
BSC_CTR_INTER_BSC_HO_IN_NO_CHANNEL,
|
|
BSC_CTR_INTER_BSC_HO_IN_FAILED,
|
|
BSC_CTR_INTER_BSC_HO_IN_TIMEOUT,
|
|
BSC_CTR_INTER_BSC_HO_IN_ERROR,
|
|
BSC_CTR_PAGING_ATTEMPTED,
|
|
BSC_CTR_PAGING_DETACHED,
|
|
BSC_CTR_PAGING_RESPONDED,
|
|
BSC_CTR_UNKNOWN_UNIT_ID,
|
|
};
|
|
|
|
static const struct rate_ctr_desc bsc_ctr_description[] = {
|
|
[BSC_CTR_ASSIGNMENT_ATTEMPTED] = {"assignment:attempted", "Assignment attempts."},
|
|
[BSC_CTR_ASSIGNMENT_COMPLETED] = {"assignment:completed", "Assignment completed."},
|
|
[BSC_CTR_ASSIGNMENT_STOPPED] = {"assignment:stopped", "Connection ended during Assignment."},
|
|
[BSC_CTR_ASSIGNMENT_NO_CHANNEL] = {"assignment:no_channel", "Failure to allocate lchan for Assignment."},
|
|
[BSC_CTR_ASSIGNMENT_TIMEOUT] = {"assignment:timeout", "Assignment timed out."},
|
|
[BSC_CTR_ASSIGNMENT_FAILED] = {"assignment:failed", "Received Assignment Failure message."},
|
|
[BSC_CTR_ASSIGNMENT_ERROR] = {"assignment:error", "Assignment failed for other reason."},
|
|
|
|
[BSC_CTR_HANDOVER_ATTEMPTED] = {"handover:attempted", "Intra-BSC handover attempts."},
|
|
[BSC_CTR_HANDOVER_COMPLETED] = {"handover:completed", "Intra-BSC handover completed."},
|
|
[BSC_CTR_HANDOVER_STOPPED] = {"handover:stopped", "Connection ended during HO."},
|
|
[BSC_CTR_HANDOVER_NO_CHANNEL] = {"handover:no_channel", "Failure to allocate lchan for HO."},
|
|
[BSC_CTR_HANDOVER_TIMEOUT] = {"handover:timeout", "Handover timed out."},
|
|
[BSC_CTR_HANDOVER_FAILED] = {"handover:failed", "Received Handover Fail messages."},
|
|
[BSC_CTR_HANDOVER_ERROR] = {"handover:error", "Re-assignment failed for other reason."},
|
|
|
|
[BSC_CTR_INTER_BSC_HO_OUT_ATTEMPTED] = {"interbsc_ho_out:attempted",
|
|
"Attempts to handover to remote BSS."},
|
|
[BSC_CTR_INTER_BSC_HO_OUT_COMPLETED] = {"interbsc_ho_out:completed",
|
|
"Handover to remote BSS completed."},
|
|
[BSC_CTR_INTER_BSC_HO_OUT_STOPPED] = {"interbsc_ho_out:stopped", "Connection ended during HO."},
|
|
[BSC_CTR_INTER_BSC_HO_OUT_TIMEOUT] = {"interbsc_ho_out:timeout", "Handover timed out."},
|
|
[BSC_CTR_INTER_BSC_HO_OUT_ERROR] = {"interbsc_ho_out:error",
|
|
"Handover to remote BSS failed for other reason."},
|
|
|
|
[BSC_CTR_INTER_BSC_HO_IN_ATTEMPTED] = {"interbsc_ho_in:attempted",
|
|
"Attempts to handover from remote BSS."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_COMPLETED] = {"interbsc_ho_in:completed",
|
|
"Handover from remote BSS completed."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_STOPPED] = {"interbsc_ho_in:stopped", "Connection ended during HO."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_NO_CHANNEL] = {"interbsc_ho_in:no_channel",
|
|
"Failure to allocate lchan for HO."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_TIMEOUT] = {"interbsc_ho_in:timeout", "Handover from remote BSS timed out."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_FAILED] = {"interbsc_ho_in:failed", "Received Handover Fail message."},
|
|
[BSC_CTR_INTER_BSC_HO_IN_ERROR] = {"interbsc_ho_in:error",
|
|
"Handover from remote BSS failed for other reason."},
|
|
|
|
[BSC_CTR_PAGING_ATTEMPTED] = {"paging:attempted", "Paging attempts for a subscriber."},
|
|
[BSC_CTR_PAGING_DETACHED] = {"paging:detached", "Paging request send failures because no responsible BTS was found."},
|
|
[BSC_CTR_PAGING_RESPONDED] = {"paging:responded", "Paging attempts with successful response."},
|
|
|
|
[BSC_CTR_UNKNOWN_UNIT_ID] = {"abis:unknown_unit_id", "Connection attempts from unknown IPA CCM Unit ID."},
|
|
};
|
|
|
|
|
|
|
|
static const struct rate_ctr_group_desc bsc_ctrg_desc = {
|
|
"bsc",
|
|
"base station controller",
|
|
OSMO_STATS_CLASS_GLOBAL,
|
|
ARRAY_SIZE(bsc_ctr_description),
|
|
bsc_ctr_description,
|
|
};
|
|
|
|
struct gsm_tz {
|
|
int override; /* if 0, use system's time zone instead. */
|
|
int hr; /* hour */
|
|
int mn; /* minute */
|
|
int dst; /* daylight savings */
|
|
};
|
|
|
|
struct gsm_network {
|
|
/* TODO MSCSPLIT the gsm_network struct is basically a kitchen sink for
|
|
* global settings and variables, "madly" mixing BSC and MSC stuff. Split
|
|
* this in e.g. struct osmo_bsc and struct osmo_msc, with the things
|
|
* these have in common, like country and network code, put in yet
|
|
* separate structs and placed as members in osmo_bsc and osmo_msc. */
|
|
|
|
struct osmo_plmn_id plmn;
|
|
|
|
/* bit-mask of permitted encryption algorithms. LSB=A5/0, MSB=A5/7 */
|
|
uint8_t a5_encryption_mask;
|
|
int neci;
|
|
|
|
struct handover_cfg *ho;
|
|
struct {
|
|
unsigned int congestion_check_interval_s;
|
|
struct osmo_timer_list congestion_check_timer;
|
|
} hodec2;
|
|
|
|
struct rate_ctr_group *bsc_ctrs;
|
|
|
|
unsigned int num_bts;
|
|
struct llist_head bts_list;
|
|
struct llist_head bts_rejected;
|
|
|
|
/* see gsm_network_T_defs */
|
|
struct osmo_tdef *T_defs;
|
|
|
|
enum gsm_chan_t ctype_by_chreq[_NUM_CHREQ_T];
|
|
|
|
/* Use a TCH for handling requests of type paging any */
|
|
int pag_any_tch;
|
|
|
|
/* MSC data in case we are a true BSC */
|
|
struct osmo_bsc_data *bsc_data;
|
|
|
|
/* control interface */
|
|
struct ctrl_handle *ctrl;
|
|
|
|
/* Allow or disallow TCH/F on dynamic TCH/F_TCH/H_PDCH; OS#1778 */
|
|
bool dyn_ts_allow_tch_f;
|
|
|
|
/* all active subscriber connections. */
|
|
struct llist_head subscr_conns;
|
|
|
|
/* if override is nonzero, this timezone data is used for all MM
|
|
* contexts. */
|
|
/* TODO: in OsmoNITB, tz-override used to be BTS-specific. To enable
|
|
* BTS|RNC specific timezone overrides for multi-tz networks in
|
|
* OsmoMSC, this should be tied to the location area code (LAC). */
|
|
struct gsm_tz tz;
|
|
|
|
/* List of all struct bsc_subscr used in libbsc. This llist_head is
|
|
* allocated so that the llist_head pointer itself can serve as a
|
|
* talloc context (useful to not have to pass the entire gsm_network
|
|
* struct to the bsc_subscr_* API, and for bsc_susbscr unit tests to
|
|
* not require gsm_data.h). In an MSC-without-BSC environment, this
|
|
* pointer is NULL to indicate absence of a bsc_subscribers list. */
|
|
struct llist_head *bsc_subscribers;
|
|
|
|
/* Timer for periodic channel load measurements to maintain each BTS's T3122. */
|
|
struct osmo_timer_list t3122_chan_load_timer;
|
|
|
|
struct {
|
|
struct mgcp_client_conf *conf;
|
|
struct mgcp_client *client;
|
|
struct osmo_tdef *tdefs;
|
|
} mgw;
|
|
|
|
/* Remote BSS Cell Identifier Lists */
|
|
struct neighbor_ident_list *neighbor_bss_cells;
|
|
|
|
/* Don't refuse to start with mutually exclusive codec settings */
|
|
bool allow_unusable_timeslots;
|
|
};
|
|
|
|
struct gsm_audio_support {
|
|
uint8_t hr : 1,
|
|
ver : 7;
|
|
};
|
|
|
|
static inline const struct osmo_location_area_id *bts_lai(struct gsm_bts *bts)
|
|
{
|
|
static struct osmo_location_area_id lai;
|
|
lai = (struct osmo_location_area_id){
|
|
.plmn = bts->network->plmn,
|
|
.lac = bts->location_area_code,
|
|
};
|
|
return &lai;
|
|
}
|
|
|
|
extern void talloc_ctx_init(void *ctx_root);
|
|
|
|
int gsm_set_bts_type(struct gsm_bts *bts, enum gsm_bts_type type);
|
|
|
|
enum gsm_bts_type parse_btstype(const char *arg);
|
|
const char *btstype2str(enum gsm_bts_type type);
|
|
struct gsm_bts *gsm_bts_by_lac(struct gsm_network *net, unsigned int lac,
|
|
struct gsm_bts *start_bts);
|
|
|
|
extern void *tall_bsc_ctx;
|
|
|
|
/* this actually refers to the IPA transport, not the BTS model */
|
|
static inline int is_ipaccess_bts(struct gsm_bts *bts)
|
|
{
|
|
switch (bts->type) {
|
|
case GSM_BTS_TYPE_NANOBTS:
|
|
case GSM_BTS_TYPE_OSMOBTS:
|
|
return 1;
|
|
default:
|
|
break;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static inline int is_sysmobts_v2(struct gsm_bts *bts)
|
|
{
|
|
switch (bts->type) {
|
|
case GSM_BTS_TYPE_OSMOBTS:
|
|
return 1;
|
|
default:
|
|
break;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static inline int is_siemens_bts(struct gsm_bts *bts)
|
|
{
|
|
switch (bts->type) {
|
|
case GSM_BTS_TYPE_BS11:
|
|
return 1;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
static inline int is_nokia_bts(struct gsm_bts *bts)
|
|
{
|
|
switch (bts->type) {
|
|
case GSM_BTS_TYPE_NOKIA_SITE:
|
|
return 1;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
static inline int is_e1_bts(struct gsm_bts *bts)
|
|
{
|
|
switch (bts->type) {
|
|
case GSM_BTS_TYPE_BS11:
|
|
case GSM_BTS_TYPE_RBS2000:
|
|
case GSM_BTS_TYPE_NOKIA_SITE:
|
|
return 1;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
extern struct gsm_network *bsc_gsmnet;
|
|
|
|
enum bts_gprs_mode bts_gprs_mode_parse(const char *arg, int *valid);
|
|
const char *bts_gprs_mode_name(enum bts_gprs_mode mode);
|
|
int bts_gprs_mode_is_compat(struct gsm_bts *bts, enum bts_gprs_mode mode);
|
|
|
|
void gsm48_ra_id_by_bts(struct gsm48_ra_id *buf, struct gsm_bts *bts);
|
|
void gprs_ra_id_by_bts(struct gprs_ra_id *raid, struct gsm_bts *bts);
|
|
|
|
int gsm_bts_model_register(struct gsm_bts_model *model);
|
|
|
|
struct gsm_subscriber_connection *bsc_subscr_con_allocate(struct gsm_network *network);
|
|
|
|
struct gsm_bts *gsm_bts_alloc_register(struct gsm_network *net, enum gsm_bts_type type, uint8_t bsic);
|
|
struct gsm_bts *bsc_bts_alloc_register(struct gsm_network *net, enum gsm_bts_type type, uint8_t bsic);
|
|
|
|
void set_ts_e1link(struct gsm_bts_trx_ts *ts, uint8_t e1_nr,
|
|
uint8_t e1_ts, uint8_t e1_ts_ss);
|
|
|
|
void gsm_trx_lock_rf(struct gsm_bts_trx *trx, bool locked, const char *reason);
|
|
struct gsm_bts_trx *gsm_bts_trx_by_nr(struct gsm_bts *bts, int nr);
|
|
int gsm_bts_trx_set_system_infos(struct gsm_bts_trx *trx);
|
|
int gsm_bts_set_system_infos(struct gsm_bts *bts);
|
|
|
|
/* generic E1 line operations for all ISDN-based BTS. */
|
|
extern struct e1inp_line_ops bts_isdn_e1inp_line_ops;
|
|
|
|
extern const struct value_string bts_type_names[_NUM_GSM_BTS_TYPE+1];
|
|
extern const struct value_string bts_type_descs[_NUM_GSM_BTS_TYPE+1];
|
|
|
|
char *get_model_oml_status(const struct gsm_bts *bts);
|
|
|
|
unsigned long long bts_uptime(const struct gsm_bts *bts);
|
|
|
|
/* control interface handling */
|
|
int bsc_base_ctrl_cmds_install(void);
|
|
|
|
/* dependency handling */
|
|
void bts_depend_mark(struct gsm_bts *bts, int dep);
|
|
void bts_depend_clear(struct gsm_bts *bts, int dep);
|
|
int bts_depend_check(struct gsm_bts *bts);
|
|
int bts_depend_is_depedency(struct gsm_bts *base, struct gsm_bts *other);
|
|
|
|
int gsm_bts_get_radio_link_timeout(const struct gsm_bts *bts);
|
|
void gsm_bts_set_radio_link_timeout(struct gsm_bts *bts, int value);
|
|
|
|
bool trx_is_usable(const struct gsm_bts_trx *trx);
|
|
bool ts_is_usable(const struct gsm_bts_trx_ts *ts);
|
|
|
|
int gsm_lchan_type_by_pchan(enum gsm_phys_chan_config pchan);
|
|
enum gsm_phys_chan_config gsm_pchan_by_lchan_type(enum gsm_chan_t type);
|
|
|
|
void gsm_bts_all_ts_dispatch(struct gsm_bts *bts, uint32_t ts_ev, void *data);
|
|
void gsm_trx_all_ts_dispatch(struct gsm_bts_trx *trx, uint32_t ts_ev, void *data);
|
|
|
|
int bts_count_free_ts(struct gsm_bts *bts, enum gsm_phys_chan_config pchan);
|
|
|
|
bool trx_has_valid_pchan_config(const struct gsm_bts_trx *trx);
|
|
|
|
#endif /* _GSM_DATA_H */
|