2020-07-15 18:53:16 +00:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <sys/types.h>
|
|
|
|
#include <stdbool.h>
|
|
|
|
|
|
|
|
#include <osmocom/core/linuxlist.h>
|
|
|
|
#include <osmocom/core/msgb.h>
|
|
|
|
#include <osmocom/core/bitvec.h>
|
|
|
|
#include <osmocom/gsm/tlv.h>
|
|
|
|
#include <osmocom/gsm/bts_features.h>
|
|
|
|
|
|
|
|
#include <osmocom/abis/e1_input.h>
|
|
|
|
|
2022-04-07 22:22:37 +00:00
|
|
|
#include "osmocom/bsc/power_control.h"
|
2020-07-15 18:53:16 +00:00
|
|
|
#include "osmocom/bsc/gsm_data.h"
|
2020-07-16 12:49:36 +00:00
|
|
|
#include "osmocom/bsc/bts_trx.h"
|
2020-12-01 16:25:28 +00:00
|
|
|
#include "osmocom/bsc/bts_sm.h"
|
2021-03-10 23:33:46 +00:00
|
|
|
#include "osmocom/bsc/abis_om2000.h"
|
2022-04-21 12:14:15 +00:00
|
|
|
#include "osmocom/bsc/paging.h"
|
2022-10-10 02:54:49 +00:00
|
|
|
#include "osmocom/bsc/bts_setup_ramp.h"
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
enum bts_counter_id {
|
|
|
|
BTS_CTR_CHREQ_TOTAL,
|
2021-01-11 17:06:11 +00:00
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_EMERG,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_CALL,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_LOCATION_UPD,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_PAG,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_PDCH,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_OTHER,
|
|
|
|
BTS_CTR_CHREQ_ATTEMPTED_UNKNOWN,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL,
|
2021-11-01 18:08:16 +00:00
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_EMERG,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_CALL,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_LOCATION_UPD,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_PAG,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_PDCH,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_OTHER,
|
|
|
|
BTS_CTR_CHREQ_SUCCESSFUL_UNKNOWN,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_CHREQ_NO_CHANNEL,
|
2021-04-01 07:37:24 +00:00
|
|
|
BTS_CTR_CHREQ_MAX_DELAY_EXCEEDED,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_CHAN_RF_FAIL,
|
2021-01-28 18:45:01 +00:00
|
|
|
BTS_CTR_CHAN_RF_FAIL_TCH,
|
|
|
|
BTS_CTR_CHAN_RF_FAIL_SDCCH,
|
2020-07-15 18:53:16 +00:00
|
|
|
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_PAGING_NO_ACTIVE_PAGING,
|
|
|
|
BTS_CTR_PAGING_MSC_FLUSH,
|
2022-05-06 13:41:51 +00:00
|
|
|
BTS_CTR_PAGING_OVERLOAD,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_CHAN_ACT_TOTAL,
|
2021-01-11 17:06:11 +00:00
|
|
|
BTS_CTR_CHAN_ACT_SDCCH,
|
|
|
|
BTS_CTR_CHAN_ACT_TCH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_CHAN_ACT_NACK,
|
2022-05-19 18:00:14 +00:00
|
|
|
BTS_CTR_CHAN_TCH_ACTIVE_MILLISECONDS_TOTAL,
|
|
|
|
BTS_CTR_CHAN_SDCCH_ACTIVE_MILLISECONDS_TOTAL,
|
2022-06-15 19:45:34 +00:00
|
|
|
BTS_CTR_CHAN_TCH_FULLY_ESTABLISHED,
|
|
|
|
BTS_CTR_CHAN_SDCCH_FULLY_ESTABLISHED,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_RSL_UNKNOWN,
|
|
|
|
BTS_CTR_RSL_IPA_NACK,
|
|
|
|
BTS_CTR_RSL_DELETE_IND,
|
|
|
|
BTS_CTR_MODE_MODIFY_NACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_UNUSED,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_WAIT_ACTIV_ACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_WAIT_RF_RELEASE_ACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_BORKEN,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_UNKNOWN,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_CHAN_ACTIV_ACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_CHAN_ACTIV_NACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_RF_CHAN_REL_ACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_VTY,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_TEARDOWN,
|
2020-06-06 09:52:34 +00:00
|
|
|
BTS_CTR_LCHAN_BORKEN_EV_TS_ERROR,
|
2020-08-21 18:47:49 +00:00
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_WAIT_RR_CHAN_MODE_MODIFY_ACK,
|
|
|
|
BTS_CTR_LCHAN_BORKEN_FROM_WAIT_RSL_CHAN_MODE_MODIFY_ACK,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_TS_BORKEN_FROM_NOT_INITIALIZED,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_UNUSED,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_WAIT_PDCH_ACT,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_PDCH,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_WAIT_PDCH_DEACT,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_IN_USE,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_BORKEN,
|
|
|
|
BTS_CTR_TS_BORKEN_FROM_UNKNOWN,
|
|
|
|
BTS_CTR_TS_BORKEN_EV_PDCH_ACT_ACK_NACK,
|
|
|
|
BTS_CTR_TS_BORKEN_EV_PDCH_DEACT_ACK_NACK,
|
|
|
|
BTS_CTR_TS_BORKEN_EV_TEARDOWN,
|
|
|
|
BTS_CTR_ASSIGNMENT_ATTEMPTED,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_ATTEMPTED_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_ATTEMPTED_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_COMPLETED,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_COMPLETED_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_COMPLETED_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_STOPPED,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_STOPPED_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_STOPPED_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_NO_CHANNEL,
|
2021-01-11 17:06:11 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_NO_CHANNEL_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_NO_CHANNEL_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_TIMEOUT,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_TIMEOUT_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_TIMEOUT_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_FAILED,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_FAILED_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_FAILED_SPEECH,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_ERROR,
|
2021-02-17 12:04:29 +00:00
|
|
|
BTS_CTR_ASSIGNMENT_ERROR_SIGN,
|
|
|
|
BTS_CTR_ASSIGNMENT_ERROR_SPEECH,
|
2021-01-11 17:06:11 +00:00
|
|
|
BTS_CTR_LOCATION_UPDATE_ACCEPT,
|
|
|
|
BTS_CTR_LOCATION_UPDATE_REJECT,
|
|
|
|
BTS_CTR_LOCATION_UPDATE_DETACH,
|
|
|
|
BTS_CTR_LOCATION_UPDATE_UNKNOWN,
|
2020-08-17 15:09:41 +00:00
|
|
|
BTS_CTR_HANDOVER_ATTEMPTED,
|
|
|
|
BTS_CTR_HANDOVER_COMPLETED,
|
|
|
|
BTS_CTR_HANDOVER_STOPPED,
|
|
|
|
BTS_CTR_HANDOVER_NO_CHANNEL,
|
|
|
|
BTS_CTR_HANDOVER_TIMEOUT,
|
|
|
|
BTS_CTR_HANDOVER_FAILED,
|
|
|
|
BTS_CTR_HANDOVER_ERROR,
|
2020-08-20 13:25:37 +00:00
|
|
|
BTS_CTR_INTRA_CELL_HO_ATTEMPTED,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_COMPLETED,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_STOPPED,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_NO_CHANNEL,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_TIMEOUT,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_FAILED,
|
|
|
|
BTS_CTR_INTRA_CELL_HO_ERROR,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_ATTEMPTED,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_COMPLETED,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_STOPPED,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_NO_CHANNEL,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_TIMEOUT,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_FAILED,
|
|
|
|
BTS_CTR_INTRA_BSC_HO_ERROR,
|
2021-11-02 12:25:48 +00:00
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_ATTEMPTED,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_COMPLETED,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_STOPPED,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_NO_CHANNEL,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_TIMEOUT,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_FAILED,
|
|
|
|
BTS_CTR_INCOMING_INTRA_BSC_HO_ERROR,
|
2020-08-17 15:09:41 +00:00
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_ATTEMPTED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_COMPLETED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_STOPPED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_TIMEOUT,
|
2020-08-29 03:23:31 +00:00
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_FAILED,
|
2020-08-17 15:09:41 +00:00
|
|
|
BTS_CTR_INTER_BSC_HO_OUT_ERROR,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_ATTEMPTED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_COMPLETED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_STOPPED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_NO_CHANNEL,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_FAILED,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_TIMEOUT,
|
|
|
|
BTS_CTR_INTER_BSC_HO_IN_ERROR,
|
2021-06-15 15:06:19 +00:00
|
|
|
BTS_CTR_SRVCC_ATTEMPTED,
|
|
|
|
BTS_CTR_SRVCC_COMPLETED,
|
|
|
|
BTS_CTR_SRVCC_STOPPED,
|
|
|
|
BTS_CTR_SRVCC_NO_CHANNEL,
|
|
|
|
BTS_CTR_SRVCC_TIMEOUT,
|
|
|
|
BTS_CTR_SRVCC_FAILED,
|
|
|
|
BTS_CTR_SRVCC_ERROR,
|
2021-09-27 06:56:20 +00:00
|
|
|
BTS_CTR_ALL_ALLOCATED_SDCCH,
|
2021-09-27 06:56:20 +00:00
|
|
|
BTS_CTR_ALL_ALLOCATED_STATIC_SDCCH,
|
2021-09-27 06:56:20 +00:00
|
|
|
BTS_CTR_ALL_ALLOCATED_TCH,
|
2021-09-27 06:56:20 +00:00
|
|
|
BTS_CTR_ALL_ALLOCATED_STATIC_TCH,
|
2021-11-07 13:05:02 +00:00
|
|
|
BTS_CTR_CM_SERV_REJ,
|
|
|
|
BTS_CTR_CM_SERV_REJ_IMSI_UNKNOWN_IN_HLR,
|
|
|
|
BTS_CTR_CM_SERV_REJ_ILLEGAL_MS,
|
|
|
|
BTS_CTR_CM_SERV_REJ_IMSI_UNKNOWN_IN_VLR,
|
|
|
|
BTS_CTR_CM_SERV_REJ_IMEI_NOT_ACCEPTED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_ILLEGAL_ME,
|
|
|
|
BTS_CTR_CM_SERV_REJ_PLMN_NOT_ALLOWED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_LOC_NOT_ALLOWED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_ROAMING_NOT_ALLOWED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_NETWORK_FAILURE,
|
|
|
|
BTS_CTR_CM_SERV_REJ_SYNCH_FAILURE,
|
|
|
|
BTS_CTR_CM_SERV_REJ_CONGESTION,
|
|
|
|
BTS_CTR_CM_SERV_REJ_SRV_OPT_NOT_SUPPORTED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_RQD_SRV_OPT_NOT_SUPPORTED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_SRV_OPT_TMP_OUT_OF_ORDER,
|
|
|
|
BTS_CTR_CM_SERV_REJ_CALL_CAN_NOT_BE_IDENTIFIED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_INCORRECT_MESSAGE,
|
|
|
|
BTS_CTR_CM_SERV_REJ_INVALID_MANDANTORY_INF,
|
|
|
|
BTS_CTR_CM_SERV_REJ_MSG_TYPE_NOT_IMPLEMENTED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_MSG_TYPE_NOT_COMPATIBLE,
|
|
|
|
BTS_CTR_CM_SERV_REJ_INF_ELEME_NOT_IMPLEMENTED,
|
|
|
|
BTS_CTR_CM_SERV_REJ_CONDTIONAL_IE_ERROR,
|
|
|
|
BTS_CTR_CM_SERV_REJ_MSG_NOT_COMPATIBLE,
|
|
|
|
BTS_CTR_CM_SERV_REJ_PROTOCOL_ERROR,
|
|
|
|
BTS_CTR_CM_SERV_REJ_RETRY_IN_NEW_CELL,
|
2020-07-15 18:53:16 +00:00
|
|
|
};
|
|
|
|
|
2020-10-18 17:54:35 +00:00
|
|
|
extern const struct rate_ctr_desc bts_ctr_description[];
|
|
|
|
extern const struct rate_ctr_group_desc bts_ctrg_desc;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
enum {
|
2021-03-04 13:14:10 +00:00
|
|
|
BTS_STAT_UPTIME_SECONDS,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_STAT_CHAN_LOAD_AVERAGE,
|
|
|
|
BTS_STAT_CHAN_CCCH_SDCCH4_USED,
|
|
|
|
BTS_STAT_CHAN_CCCH_SDCCH4_TOTAL,
|
|
|
|
BTS_STAT_CHAN_TCH_F_USED,
|
|
|
|
BTS_STAT_CHAN_TCH_F_TOTAL,
|
|
|
|
BTS_STAT_CHAN_TCH_H_USED,
|
|
|
|
BTS_STAT_CHAN_TCH_H_TOTAL,
|
|
|
|
BTS_STAT_CHAN_SDCCH8_USED,
|
|
|
|
BTS_STAT_CHAN_SDCCH8_TOTAL,
|
|
|
|
BTS_STAT_CHAN_TCH_F_PDCH_USED,
|
|
|
|
BTS_STAT_CHAN_TCH_F_PDCH_TOTAL,
|
|
|
|
BTS_STAT_CHAN_CCCH_SDCCH4_CBCH_USED,
|
|
|
|
BTS_STAT_CHAN_CCCH_SDCCH4_CBCH_TOTAL,
|
|
|
|
BTS_STAT_CHAN_SDCCH8_CBCH_USED,
|
|
|
|
BTS_STAT_CHAN_SDCCH8_CBCH_TOTAL,
|
2021-06-28 10:19:13 +00:00
|
|
|
BTS_STAT_CHAN_OSMO_DYN_USED,
|
|
|
|
BTS_STAT_CHAN_OSMO_DYN_TOTAL,
|
2020-07-15 18:53:16 +00:00
|
|
|
BTS_STAT_T3122,
|
|
|
|
BTS_STAT_RACH_BUSY,
|
|
|
|
BTS_STAT_RACH_ACCESS,
|
|
|
|
BTS_STAT_OML_CONNECTED,
|
|
|
|
BTS_STAT_RSL_CONNECTED,
|
|
|
|
BTS_STAT_LCHAN_BORKEN,
|
|
|
|
BTS_STAT_TS_BORKEN,
|
2021-09-19 11:14:10 +00:00
|
|
|
BTS_STAT_NUM_TRX_RSL_CONNECTED,
|
2021-09-19 11:13:45 +00:00
|
|
|
BTS_STAT_NUM_TRX_TOTAL,
|
2022-11-22 16:02:27 +00:00
|
|
|
BTS_STAT_PAGING_REQ_QUEUE_LENGTH,
|
2022-11-22 17:25:17 +00:00
|
|
|
BTS_STAT_PAGING_AVAILABLE_SLOTS,
|
2022-11-22 16:00:04 +00:00
|
|
|
BTS_STAT_PAGING_T3113,
|
2020-07-15 18:53:16 +00:00
|
|
|
};
|
|
|
|
|
2020-10-18 17:54:35 +00:00
|
|
|
extern const struct osmo_stat_item_desc bts_stat_desc[];
|
|
|
|
extern const struct osmo_stat_item_group_desc bts_statg_desc;
|
2020-08-20 13:25:37 +00:00
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
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
|
|
|
|
};
|
|
|
|
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];
|
|
|
|
|
|
|
|
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,
|
|
|
|
};
|
|
|
|
|
2022-06-14 11:53:23 +00:00
|
|
|
enum bts_tch_signalling_policy {
|
|
|
|
BTS_TCH_SIGNALLING_NEVER,
|
|
|
|
BTS_TCH_SIGNALLING_EMERG,
|
|
|
|
BTS_TCH_SIGNALLING_VOICE,
|
|
|
|
BTS_TCH_SIGNALLING_ALWAYS,
|
|
|
|
};
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
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;
|
2020-12-21 12:14:54 +00:00
|
|
|
/* start the model itself */
|
2020-07-15 18:53:16 +00:00
|
|
|
int (*start)(struct gsm_network *net);
|
2020-12-21 12:14:54 +00:00
|
|
|
|
|
|
|
/* initialize a single BTS for this model */
|
|
|
|
int (*bts_init)(struct gsm_bts *bts);
|
|
|
|
|
|
|
|
/* initialize a single TRX for this model */
|
|
|
|
int (*trx_init)(struct gsm_bts_trx *trx);
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
int (*oml_rcvmsg)(struct msgb *msg);
|
|
|
|
char * (*oml_status)(const struct gsm_bts *bts);
|
|
|
|
|
|
|
|
void (*e1line_bind_ops)(struct e1inp_line *line);
|
|
|
|
|
2020-12-18 20:51:13 +00:00
|
|
|
/* (Optional) function for encoding MS/BS Power Control paramaters */
|
|
|
|
int (*power_ctrl_enc_rsl_params)(struct msgb *msg, const struct gsm_power_ctrl_params *cp);
|
|
|
|
/* (Optional) function for sending default MS/BS Power Control paramaters */
|
|
|
|
int (*power_ctrl_send_def_params)(const struct gsm_bts_trx *trx);
|
power_control: implement BCCH carrier power reduction operation
The BCCH carrier (sometimes called C0) of a BTS shall maintain
discontinuous Downlink transmission at full power in order to
stay 'visible' to the mobile stations. Because of that, early
versions of 3GPP TS 45.008 prohibited BS power reduction on C0.
However, starting from version 13.0.0 (2015-11) there is a feature
called 'BCCH carrier power reduction operation'. This is a special
mode of operation, where the variation of RF level for some
timeslots is relaxed for the purpose of energy saving.
In BCCH carrier power reduction operation, for timeslots on the
C0 carrier, except timeslots carrying BCCH/CCCH, the output power
may be lower than the output power used for timeslots carrying
BCCH/CCCH. In this case the maximum allowed difference in output
power actually transmitted by the BTS is 6 dB.
Introduce a VTY command to turn on and off the BCCH carrier power
reduction operation. Also introduce a CTRL command. On the
A-bis/RSL, abuse the BS POWER CONTROL message by setting
the Channel Number IE to 0x80 (RSL_CHAN_BCCH).
Currently, only osmo-bts-trx is supported. A value greater than
zero makes it reduce the power on *inactive* timeslots of the
BCCH carrier. Sending zero disables the BCCH power reduction
mode completely.
For more details, see 3GPP TS 45.008, section 7.1, and 3GPP TR 45.926.
Change-Id: I047fce33d4d3e4c569dd006ba17858467a2f4783
Related: SYS#4919
2021-06-21 19:55:46 +00:00
|
|
|
/* (Optional) function for toggling BCCH carrier power reduction operation */
|
|
|
|
int (*power_ctrl_set_c0_power_red)(const struct gsm_bts *bts, const uint8_t red);
|
2020-12-18 20:51:13 +00:00
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
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;
|
|
|
|
|
2022-04-26 14:53:14 +00:00
|
|
|
/* features of a given BTS model set via gsm_bts_model_register()
|
|
|
|
* locally, see doc/bts-features.txt */
|
2020-07-15 18:53:16 +00:00
|
|
|
struct bitvec features;
|
|
|
|
uint8_t _features_data[MAX_BTS_FEATURES/8];
|
2022-04-26 14:53:14 +00:00
|
|
|
/* BTS reports features during OML bring up */
|
|
|
|
bool features_get_reported;
|
2020-07-15 18:53:16 +00:00
|
|
|
};
|
|
|
|
|
2020-12-01 16:25:28 +00:00
|
|
|
struct gsm_gprs_cell {
|
2020-09-30 10:52:04 +00:00
|
|
|
struct gsm_abis_mo mo;
|
2020-12-01 16:25:28 +00:00
|
|
|
uint16_t bvci;
|
|
|
|
uint8_t timer[11];
|
|
|
|
struct gprs_rlc_cfg rlc_cfg;
|
2020-09-30 10:52:04 +00:00
|
|
|
};
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
/* 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];
|
|
|
|
|
2022-04-26 14:53:14 +00:00
|
|
|
/* features of a given BTS either hardcoded or set/reported via OML,
|
|
|
|
* see doc/bts-features.txt */
|
2020-07-15 18:53:16 +00:00
|
|
|
struct bitvec features;
|
|
|
|
uint8_t _features_data[MAX_BTS_FEATURES/8];
|
2022-04-26 14:53:14 +00:00
|
|
|
/* Features have been reported by the BTS or were copied from the BTS
|
|
|
|
* model */
|
|
|
|
bool features_known;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* Connected PCU version (if any) */
|
|
|
|
char pcu_version[MAX_VERSION_LENGTH];
|
2021-06-23 12:15:20 +00:00
|
|
|
/* PCU sign_link, over OML line: */
|
|
|
|
struct e1inp_sign_link *osmo_link;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* 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;
|
|
|
|
|
2020-12-01 16:25:28 +00:00
|
|
|
struct gsm_bts_sm *site_mgr; /* backpointer */
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* 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 {
|
2020-12-20 22:53:24 +00:00
|
|
|
struct osmo_fsm_inst *bts_fi;
|
2020-07-15 18:53:16 +00:00
|
|
|
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];
|
2021-03-10 23:33:46 +00:00
|
|
|
enum om2k_sync_src sync_src;
|
2020-07-15 18:53:16 +00:00
|
|
|
} 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;
|
2020-12-01 16:25:28 +00:00
|
|
|
struct gsm_gprs_cell cell;
|
2020-07-15 18:53:16 +00:00
|
|
|
uint8_t rac;
|
|
|
|
uint8_t net_ctrl_ord;
|
|
|
|
bool ctrl_ack_type_use_block;
|
|
|
|
bool egprs_pkt_chan_request;
|
2020-12-14 17:15:01 +00:00
|
|
|
struct {
|
|
|
|
bool active; /* CCN_ACTIVE */
|
|
|
|
bool forced_vty; /* set by VTY ? */
|
|
|
|
} ccn; /* TS 44.060 sec 8.8.2 */
|
2021-02-09 11:41:42 +00:00
|
|
|
struct {
|
|
|
|
uint8_t alpha; /* ALPHA*10, units of 0.1, range <0-10> */
|
|
|
|
} pwr_ctrl; /* TS 44.060 Table 12.9.1 */
|
2020-07-15 18:53:16 +00:00
|
|
|
} gprs;
|
|
|
|
|
2022-04-25 15:18:48 +00:00
|
|
|
/* CCCH Load Threshold: threshold (in percent) when BTS shall send CCCH LOAD IND */
|
2022-04-25 15:08:24 +00:00
|
|
|
uint8_t ccch_load_ind_thresh;
|
2022-04-25 15:18:48 +00:00
|
|
|
/* CCCH Load Indication Period: how often (secs) to send CCCH LOAD IND when over CCCH Load Threshold. */
|
|
|
|
uint8_t ccch_load_ind_period;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* 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? */
|
2022-06-05 19:43:28 +00:00
|
|
|
bool chan_alloc_chan_req_reverse;
|
|
|
|
bool chan_alloc_assignment_reverse;
|
|
|
|
bool chan_alloc_handover_reverse;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
2022-06-15 19:10:16 +00:00
|
|
|
/* Whether to use dynamic allocation mode for assignment */
|
|
|
|
bool chan_alloc_assignment_dynamic;
|
|
|
|
/* Parameters used for dynamic mode of allocation */
|
|
|
|
struct {
|
|
|
|
bool sort_by_trx_power;
|
|
|
|
uint8_t ul_rxlev_thresh;
|
|
|
|
uint8_t ul_rxlev_avg_num;
|
|
|
|
uint8_t c0_chan_load_thresh;
|
|
|
|
} chan_alloc_dyn_params;
|
|
|
|
|
2021-07-08 15:46:40 +00:00
|
|
|
/* When true, interference measurements from the BTS are used in the channel allocator to favor lchans with less
|
|
|
|
* interference reported in RSL Resource Indication. */
|
|
|
|
bool chan_alloc_avoid_interf;
|
|
|
|
|
2022-06-14 11:53:23 +00:00
|
|
|
/* If SDCCHs are exhausted, when can we use TCH for signalling purposes. */
|
|
|
|
enum bts_tch_signalling_policy chan_alloc_tch_signalling_policy;
|
Introduce VTY option to forbid use of TCH for non-voicecall signalling
Usual allocation mechansim, when some signalling channel is needed,
first tries to reserve an SDCCH, and if all of them are exhausted, then
attempts to reserve a TCH as a last resort.
This, however, may cause TCH starvation under certain situations, for
instance if there high load on other services (LU, SMS, etc.).
Hence, it may be desirable for the operator to forbid reservation
of TCH slots once SDCCH become exhausted. This commit is thus adding a
VTY command which allows forbidding it. The default behavior (allow using
TCH timeslots when SDCCHs are exhausted) is kept as before.
The above mentioned prohibition is applied only to non-voicecall related
signalling services. That's because voicecall services will end up
requiring a TCH anyway, and forbidding reservation of TCH straighaway
when SDCCHs are exhausted would mean no voice calls could be initiated
while still TCHs would be available.
Related: SYS#5548
Change-Id: Ib08027125145df26602069bfb51847063b0ccc0c
2021-07-22 11:25:05 +00:00
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
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;
|
2020-12-14 15:27:17 +00:00
|
|
|
struct osmo_gsm48_si_selection_params cell_ro_sel_par; /* rest octet */
|
2020-07-15 18:53:16 +00:00
|
|
|
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 */
|
2021-04-06 02:01:50 +00:00
|
|
|
size_t cell_chan_num; /* number of channels in Cell Allocation */
|
2020-07-15 18:53:16 +00:00
|
|
|
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 */
|
2020-07-16 18:53:21 +00:00
|
|
|
struct acc_mgr acc_mgr;
|
2020-07-15 18:53:16 +00:00
|
|
|
struct acc_ramp acc_ramp;
|
|
|
|
|
|
|
|
/* exclude the BTS from the global RF Lock handling */
|
|
|
|
int excl_from_rf_lock;
|
|
|
|
|
2022-10-13 16:21:50 +00:00
|
|
|
/* MGW specificities for this BTS: */
|
|
|
|
int mgw_pool_target; /* Pin to specific MGW. -1 = wildcard */
|
|
|
|
bool mgw_pool_target_strict; /* Only allow pinned MGW */
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
/* 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;
|
|
|
|
|
2022-08-08 11:50:39 +00:00
|
|
|
/* osmux config: */
|
|
|
|
enum osmux_usage use_osmux;
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
/* 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;
|
|
|
|
|
2021-03-09 16:11:45 +00:00
|
|
|
/* Local and remote neighbor configuration: a list of neighbors as written in the VTY config, not resolved to
|
|
|
|
* actual cells. Entries may point at non-existing BTS numbers, or yet unconfigured ARFCN+BSIC. The point of
|
|
|
|
* this list is to keep the config as the user entered it: a) to write it back exactly as entered, and b) to
|
|
|
|
* allow adding neighbor cells that will only be configured further down in the config file.
|
|
|
|
* An actual neighbor cell object (local or remote-BSS) is resolved "at runtime" whenever a neighbor is being
|
|
|
|
* looked up. */
|
|
|
|
struct llist_head neighbors;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* 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;
|
2022-04-25 08:53:41 +00:00
|
|
|
struct bts_etws_state etws;
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
struct llist_head oml_fail_rep;
|
2020-08-21 20:40:23 +00:00
|
|
|
struct llist_head chan_rqd_queue;
|
2020-11-14 20:54:53 +00:00
|
|
|
|
2021-11-14 17:43:40 +00:00
|
|
|
/* ACCH Repetition capabilities */
|
2021-11-14 17:59:21 +00:00
|
|
|
struct abis_rsl_osmo_rep_acch_cap rep_acch_cap;
|
2020-12-16 22:20:34 +00:00
|
|
|
|
2021-11-14 17:43:40 +00:00
|
|
|
/* ACCH Temporary overpower capabilities */
|
2021-11-14 18:05:16 +00:00
|
|
|
struct abis_rsl_osmo_temp_ovp_acch_cap top_acch_cap;
|
2021-11-14 21:51:28 +00:00
|
|
|
/* Channel mode(s) for which to allow TOP */
|
|
|
|
enum {
|
|
|
|
TOP_ACCH_CHAN_MODE_ANY = 0, /* Any kind of channel mode */
|
|
|
|
TOP_ACCH_CHAN_MODE_SPEECH_V3, /* Speech channels using AMR codec */
|
|
|
|
} top_acch_chan_mode;
|
2021-08-30 08:53:58 +00:00
|
|
|
|
2020-12-16 22:20:34 +00:00
|
|
|
/* MS/BS Power Control parameters */
|
|
|
|
struct gsm_power_ctrl_params ms_power_ctrl;
|
|
|
|
struct gsm_power_ctrl_params bs_power_ctrl;
|
2021-04-01 07:37:24 +00:00
|
|
|
|
power_control: implement BCCH carrier power reduction operation
The BCCH carrier (sometimes called C0) of a BTS shall maintain
discontinuous Downlink transmission at full power in order to
stay 'visible' to the mobile stations. Because of that, early
versions of 3GPP TS 45.008 prohibited BS power reduction on C0.
However, starting from version 13.0.0 (2015-11) there is a feature
called 'BCCH carrier power reduction operation'. This is a special
mode of operation, where the variation of RF level for some
timeslots is relaxed for the purpose of energy saving.
In BCCH carrier power reduction operation, for timeslots on the
C0 carrier, except timeslots carrying BCCH/CCCH, the output power
may be lower than the output power used for timeslots carrying
BCCH/CCCH. In this case the maximum allowed difference in output
power actually transmitted by the BTS is 6 dB.
Introduce a VTY command to turn on and off the BCCH carrier power
reduction operation. Also introduce a CTRL command. On the
A-bis/RSL, abuse the BS POWER CONTROL message by setting
the Channel Number IE to 0x80 (RSL_CHAN_BCCH).
Currently, only osmo-bts-trx is supported. A value greater than
zero makes it reduce the power on *inactive* timeslots of the
BCCH carrier. Sending zero disables the BCCH power reduction
mode completely.
For more details, see 3GPP TS 45.008, section 7.1, and 3GPP TR 45.926.
Change-Id: I047fce33d4d3e4c569dd006ba17858467a2f4783
Related: SYS#4919
2021-06-21 19:55:46 +00:00
|
|
|
/* Maximum BCCH carrier power reduction */
|
|
|
|
uint8_t c0_max_power_red_db;
|
|
|
|
|
2021-07-08 04:20:46 +00:00
|
|
|
/* Interference Measurement Parameters, as read from VTY */
|
|
|
|
struct gsm_interf_meas_params interf_meas_params_cfg;
|
|
|
|
/* Interference Measurement Parameters, as last sent via OML */
|
|
|
|
struct gsm_interf_meas_params interf_meas_params_used;
|
2021-06-03 20:27:51 +00:00
|
|
|
|
2021-04-01 07:37:24 +00:00
|
|
|
/* We will ignore CHAN RQD with access delay greater than rach_max_delay */
|
|
|
|
uint8_t rach_max_delay;
|
2021-06-15 12:14:21 +00:00
|
|
|
|
|
|
|
/* Is Fast return to LTE allowed during Chan Release in this BTS? */
|
|
|
|
bool srvcc_fast_return_allowed;
|
2021-08-06 17:31:40 +00:00
|
|
|
|
|
|
|
/* At what point in the channel allocation sequence to dispatch the Immediate Assignment (Abis optimization) */
|
|
|
|
enum imm_ass_time imm_ass_time;
|
2021-09-27 06:56:20 +00:00
|
|
|
|
fix performance for chan_counts and all_allocated stats
The all_allocated_update_bsc() does inefficient iterating to count
active/inactive lchans, which scales badly for high numbers of TRX
managed by osmo-bsc.
We need to update the all_allocated flags immediately (periodic counting
alone would suffer from undersampling), so, until now, we are calling
this inefficient function every time a channel state changes.
Instead of iterating all channels for any chan state changes anywhere,
keep global state of the current channel counts, and on channel state
change only update those ts, trx, bts counts that actually change.
A desirable side effect: for connection stats and handover decision 2,
we can now also use the globally updated channel counts and save a bunch
of inefficient iterations.
To get accurate channel counts at all times, spread around some
chan_counts_ts_update() calls in pivotal places. It re-counts the given
timeslot and cascades counter changes, iff required.
Just in case I missed some channel accounting, still run an inefficient
iterating count regularly that detects errors, logs them and fixes them.
No real harm done if such error appears. None show in ttcn3 BSC_Tests.
It is fine to do the inefficient iteration once per second; channel
state changes can realistically happen hundreds of times per second.
Related: SYS#5976
Change-Id: I580bfae329aac8d4552723164741536af6512011
2022-05-30 00:39:17 +00:00
|
|
|
struct chan_counts chan_counts;
|
2022-05-29 21:57:59 +00:00
|
|
|
struct all_allocated all_allocated;
|
2022-10-10 02:54:49 +00:00
|
|
|
|
|
|
|
struct bts_setup_ramp bts_setup_ramp;
|
2020-07-15 18:53:16 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#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])
|
|
|
|
|
|
|
|
/* this actually refers to the IPA transport, not the BTS model */
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_ipaccess_bts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_NANOBTS:
|
|
|
|
case GSM_BTS_TYPE_OSMOBTS:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_osmobts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_OSMOBTS:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_siemens_bts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_BS11:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_nokia_bts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_NOKIA_SITE:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_ericsson_bts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_RBS2000:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
static inline bool is_e1_bts(const struct gsm_bts *bts)
|
2020-07-15 18:53:16 +00:00
|
|
|
{
|
|
|
|
switch (bts->type) {
|
|
|
|
case GSM_BTS_TYPE_BS11:
|
|
|
|
case GSM_BTS_TYPE_RBS2000:
|
|
|
|
case GSM_BTS_TYPE_NOKIA_SITE:
|
2023-03-10 09:07:36 +00:00
|
|
|
return true;
|
2020-07-15 18:53:16 +00:00
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2023-03-10 09:07:36 +00:00
|
|
|
return false;
|
2020-07-15 18:53:16 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
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;
|
|
|
|
}
|
|
|
|
|
2020-12-01 16:25:28 +00:00
|
|
|
struct gsm_bts *gsm_bts_alloc(struct gsm_network *net, struct gsm_bts_sm *bts_sm, uint8_t bts_num);
|
2021-11-09 15:21:34 +00:00
|
|
|
int gsm_bts_check_cfg(struct gsm_bts *bts);
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
char *gsm_bts_name(const struct gsm_bts *bts);
|
|
|
|
|
|
|
|
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);
|
2021-03-09 16:10:18 +00:00
|
|
|
void gsm_bts_cell_id(struct gsm0808_cell_id *cell_id, const struct gsm_bts *bts);
|
|
|
|
void gsm_bts_cell_id_list(struct gsm0808_cell_id_list2 *cell_id_list, const struct gsm_bts *bts);
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
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);
|
|
|
|
|
|
|
|
/* return the gsm_lchan for the CBCH (if it exists at all) */
|
|
|
|
struct gsm_lchan *gsm_bts_get_cbch(struct gsm_bts *bts);
|
|
|
|
|
2022-04-25 10:20:21 +00:00
|
|
|
int gsm_set_bts_model(struct gsm_bts *bts, struct gsm_bts_model *model);
|
2020-07-15 18:53:16 +00:00
|
|
|
int gsm_set_bts_type(struct gsm_bts *bts, enum gsm_bts_type type);
|
|
|
|
|
2020-07-16 12:20:32 +00:00
|
|
|
struct gsm_bts_trx *gsm_bts_trx_num(const struct gsm_bts *bts, int num);
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
int bts_gprs_mode_is_compat(struct gsm_bts *bts, enum bts_gprs_mode mode);
|
|
|
|
|
2021-03-04 13:14:10 +00:00
|
|
|
#define BTS_STORE_UPTIME_INTERVAL 10 /* in seconds */
|
|
|
|
void bts_store_uptime(struct gsm_bts *bts);
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
unsigned long long bts_uptime(const struct gsm_bts *bts);
|
|
|
|
|
2022-05-19 18:00:14 +00:00
|
|
|
#define BTS_STORE_LCHAN_DURATIONS_INTERVAL 1 /* in seconds */
|
|
|
|
void bts_store_lchan_durations(struct gsm_bts *bts);
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
char *get_model_oml_status(const struct gsm_bts *bts);
|
|
|
|
/* reset the state of all MO in the BTS */
|
|
|
|
void gsm_bts_mo_reset(struct gsm_bts *bts);
|
2020-12-04 13:22:18 +00:00
|
|
|
|
|
|
|
static inline bool gsm_bts_features_negotiated(struct gsm_bts *bts)
|
|
|
|
{
|
|
|
|
return bts->mo.get_attr_rep_received || bts->mo.nm_state.operational == NM_OPSTATE_ENABLED;
|
|
|
|
}
|
2020-07-15 18:53:16 +00:00
|
|
|
|
|
|
|
/* 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);
|
|
|
|
|
|
|
|
void gsm_bts_all_ts_dispatch(struct gsm_bts *bts, uint32_t ts_ev, void *data);
|
|
|
|
|
2020-07-16 13:17:20 +00:00
|
|
|
int gsm_bts_set_system_infos(struct gsm_bts *bts);
|
|
|
|
|
power_control: implement BCCH carrier power reduction operation
The BCCH carrier (sometimes called C0) of a BTS shall maintain
discontinuous Downlink transmission at full power in order to
stay 'visible' to the mobile stations. Because of that, early
versions of 3GPP TS 45.008 prohibited BS power reduction on C0.
However, starting from version 13.0.0 (2015-11) there is a feature
called 'BCCH carrier power reduction operation'. This is a special
mode of operation, where the variation of RF level for some
timeslots is relaxed for the purpose of energy saving.
In BCCH carrier power reduction operation, for timeslots on the
C0 carrier, except timeslots carrying BCCH/CCCH, the output power
may be lower than the output power used for timeslots carrying
BCCH/CCCH. In this case the maximum allowed difference in output
power actually transmitted by the BTS is 6 dB.
Introduce a VTY command to turn on and off the BCCH carrier power
reduction operation. Also introduce a CTRL command. On the
A-bis/RSL, abuse the BS POWER CONTROL message by setting
the Channel Number IE to 0x80 (RSL_CHAN_BCCH).
Currently, only osmo-bts-trx is supported. A value greater than
zero makes it reduce the power on *inactive* timeslots of the
BCCH carrier. Sending zero disables the BCCH power reduction
mode completely.
For more details, see 3GPP TS 45.008, section 7.1, and 3GPP TR 45.926.
Change-Id: I047fce33d4d3e4c569dd006ba17858467a2f4783
Related: SYS#4919
2021-06-21 19:55:46 +00:00
|
|
|
int gsm_bts_set_c0_power_red(struct gsm_bts *bts, const uint8_t red);
|
|
|
|
|
2021-07-21 12:26:26 +00:00
|
|
|
void gsm_bts_stats_reset(struct gsm_bts *bts);
|
|
|
|
|
2020-07-15 18:53:16 +00:00
|
|
|
int gsm_bts_model_register(struct gsm_bts_model *model);
|
|
|
|
struct gsm_bts_model *bts_model_find(enum gsm_bts_type type);
|
|
|
|
|
|
|
|
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);
|
2022-12-16 22:28:41 +00:00
|
|
|
|
|
|
|
bool gsm_bts_check_ny1(const struct gsm_bts *bts);
|