2008-12-25 23:28:35 +00:00
|
|
|
/* GSM Channel allocation routines
|
|
|
|
|
*
|
|
|
|
|
* (C) 2008 by Harald Welte <laforge@gnumonks.org>
|
2009-02-06 21:55:37 +00:00
|
|
|
* (C) 2008, 2009 by Holger Hans Peter Freyther <zecke@selfish.org>
|
2008-12-25 23:28:35 +00:00
|
|
|
*
|
|
|
|
|
* All Rights Reserved
|
|
|
|
|
*
|
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
2011-01-01 14:25:50 +00:00
|
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
|
|
|
* the Free Software Foundation; either version 3 of the License, or
|
2008-12-25 23:28:35 +00:00
|
|
|
* (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
2011-01-01 14:25:50 +00:00
|
|
|
* GNU Affero General Public License for more details.
|
2008-12-25 23:28:35 +00:00
|
|
|
*
|
2011-01-01 14:25:50 +00:00
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2008-12-25 23:28:35 +00:00
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
|
#include <string.h>
|
|
|
|
|
#include <errno.h>
|
2018-04-09 11:31:51 +00:00
|
|
|
#include <inttypes.h>
|
2008-12-25 23:28:35 +00:00
|
|
|
|
2017-09-04 13:15:32 +00:00
|
|
|
#include <osmocom/bsc/chan_alloc.h>
|
|
|
|
|
#include <osmocom/bsc/abis_nm.h>
|
|
|
|
|
#include <osmocom/bsc/abis_rsl.h>
|
|
|
|
|
#include <osmocom/bsc/debug.h>
|
|
|
|
|
#include <osmocom/bsc/signal.h>
|
large refactoring: use FSMs for lchans; add inter-BSC HO
Add FSMs:
- timeslot_fsm: handle dynamic timeslots and OML+RSL availability.
- lchan_fsm: handle an individual lchan activation, RTP stream and release,
signal the appropriate calling FSMs on success, failure, release.
- mgw_endpoint_fsm: handle one entire endpoint with several CI.
- assignment_fsm: BSSMAP Assignment Request.
- handover_fsm: all of intra, inter-MO and inter-MT handover.
Above FSMs absorb large parts of the gscon FSM. The gscon FSM was surpassing
the maximum amount events (32), and it is more logical to treat assignment,
handover and MGW procedures in separate FSMs.
- Add logging macros for each FSM type:
- LOG_TS()
- LOG_LCHAN()
- LOG_MGWEP(), LOG_CI()
- LOG_ASSIGNMENT()
- LOG_HO()
These log with the osmo_fsm_inst where present.
New style decision: logging without a final newline char is awkward,
especially for gsmtap logging and when other logs interleave LOGPC() calls;
we have various cases where the final \n goes missing, and also this invokes
the log category checking N times instead of once.
So I decided to make these macros *always* append a newline, but only if
there is no final newline yet. I hope that the compiler optimizes the
strlen() of the constant format strings away. Thus I can log with or without
typing "\n" and always get an \n termination anyway.
General:
- replace osmo_timers, state enums and program-wide osmo_signal_dispatch()
with dedicated FSM timeouts, states and events.
- introduce a common way to handle Tnnn timers: gsm_timers.h/.c: struct T_def.
These can be used (with some macro magic) to define a state's timeout once,
and not make mistakes for each osmo_fsm_inst_state_chg().
Details:
bsc_subscr_conn_fsm.c:
- move most states of this FSM to lchan_fsm, assignment_fsm, handover_fsm and
mgw_endpoint_fsm.
- There is exactly one state for an ongoing Assignment, with all details
handled in conn->assignment.fi. The state relies on the assignment_fsm's
timeout.
- There is one state for an ongoing Handover; except for an incoming Handover
from a remote BSS, the gscon remains in ST_INIT until the new lchan and conn
are both established.
- move bssmap_add_lcls_status() to osmo_bsc_lcls.c
abis_rsl.c:
- move all dynamic timeslot logic away into timeslot_fsm. Only keep plain send/receive functions in
abis_rsl.c
- reduce some rsl functions to merely send a message, rename to "_tx_".
- rsl_ipacc_mdcx(): add '_tx_' in the name; move parts that change the lchan state out into the
lchan_fsm, the lchan->abis_ip.* are now set there prior to invoking this function.
- move all timers and error/release handling away into various FSMs.
- tweak ipa_smod_s_for_lchan() and ipa_rtp_pt_for_lchan() to not require an
lchan passed, but just mode,type that they require. Rename to
ipacc_speech_mode*() and ipacc_payload_type().
- add rsl_forward_layer3_info, used for inter-BSC HO MO, to just send the RR
message received during BSSMAP Handover Command.
- move various logging to LOG_LCHAN() in order to log with the lchan FSM instance.
One drawback is that the lchan FSM is limited to one logging category, i.e. this moves some logging
from DRR to DRSL. It might actually make sense to combine those categories.
- lose LOGP...LOGPC logging cascades: they are bad for gsmtap logging and for performance.
- handle_classmark_chg(): change logging, move cm2 len check out of the cm3 condition (I hope that's
correct).
- gsm48_send_ho_cmd(): split off gsm48_make_ho_cmd() which doesn't send right away, so that during
inter-bsc HO we can make an RR Handover Command to send via the MSC to the remote BSS.
assignment_fsm.c:
- the Chan Mode Modify in case of re-using the same lchan is not implemented
yet, because this was also missing in the previous implementation (OS#3357).
osmo_bsc_api.c:
- simplify bsc_mr_config() and move to lchan_fsm.c, the only caller; rename to
lchan_mr_config(). (bsc_mr_config() used to copy the values to mr_bts_lv
twice, once by member assignment and then again with a memcpy.)
- During handover, we used to copy the MR config from the old lchan. Since we
may handover between FR and HR, rather set the MR Config anew every time, so
that FR rates are always available on FR lchans, and never on HR lchans.
Depends: I03ee7ce840ecfa0b6a33358e7385528aabd4873f (libosmocore),
I1f2918418c38918c5ac70acaa51a47adfca12b5e (libosmocore)
Change-Id: I82e3f918295daa83274a4cf803f046979f284366
2018-05-14 16:14:15 +00:00
|
|
|
#include <osmocom/bsc/timeslot_fsm.h>
|
|
|
|
|
#include <osmocom/bsc/lchan_fsm.h>
|
2018-07-24 14:18:15 +00:00
|
|
|
#include <osmocom/bsc/gsm_04_08_rr.h>
|
2020-07-15 18:53:16 +00:00
|
|
|
#include <osmocom/bsc/bts.h>
|
2008-12-30 19:18:21 +00:00
|
|
|
|
2011-03-22 15:47:59 +00:00
|
|
|
#include <osmocom/core/talloc.h>
|
2010-06-22 04:11:59 +00:00
|
|
|
|
2020-05-07 12:32:52 +00:00
|
|
|
/* Update channel load calculation for the given BTS */
|
2016-09-25 15:01:20 +00:00
|
|
|
void bts_chan_load(struct pchan_load *cl, const struct gsm_bts *bts)
|
2009-12-22 12:09:29 +00:00
|
|
|
{
|
|
|
|
|
struct gsm_bts_trx *trx;
|
|
|
|
|
|
|
|
|
|
llist_for_each_entry(trx, &bts->trx_list, list) {
|
2022-06-16 11:08:11 +00:00
|
|
|
struct load_counter *ll = &trx->lchan_load;
|
2009-12-22 12:09:29 +00:00
|
|
|
int i;
|
|
|
|
|
|
2022-06-16 11:08:11 +00:00
|
|
|
/* init per-TRX load counters */
|
|
|
|
|
memset(ll, 0, sizeof(*ll));
|
|
|
|
|
|
2020-06-05 21:40:56 +00:00
|
|
|
/* skip administratively deactivated transceivers */
|
2020-05-08 07:57:16 +00:00
|
|
|
if (!trx_is_usable(trx))
|
2009-12-22 12:09:29 +00:00
|
|
|
continue;
|
|
|
|
|
|
|
|
|
|
for (i = 0; i < ARRAY_SIZE(trx->ts); i++) {
|
|
|
|
|
struct gsm_bts_trx_ts *ts = &trx->ts[i];
|
large refactoring: use FSMs for lchans; add inter-BSC HO
Add FSMs:
- timeslot_fsm: handle dynamic timeslots and OML+RSL availability.
- lchan_fsm: handle an individual lchan activation, RTP stream and release,
signal the appropriate calling FSMs on success, failure, release.
- mgw_endpoint_fsm: handle one entire endpoint with several CI.
- assignment_fsm: BSSMAP Assignment Request.
- handover_fsm: all of intra, inter-MO and inter-MT handover.
Above FSMs absorb large parts of the gscon FSM. The gscon FSM was surpassing
the maximum amount events (32), and it is more logical to treat assignment,
handover and MGW procedures in separate FSMs.
- Add logging macros for each FSM type:
- LOG_TS()
- LOG_LCHAN()
- LOG_MGWEP(), LOG_CI()
- LOG_ASSIGNMENT()
- LOG_HO()
These log with the osmo_fsm_inst where present.
New style decision: logging without a final newline char is awkward,
especially for gsmtap logging and when other logs interleave LOGPC() calls;
we have various cases where the final \n goes missing, and also this invokes
the log category checking N times instead of once.
So I decided to make these macros *always* append a newline, but only if
there is no final newline yet. I hope that the compiler optimizes the
strlen() of the constant format strings away. Thus I can log with or without
typing "\n" and always get an \n termination anyway.
General:
- replace osmo_timers, state enums and program-wide osmo_signal_dispatch()
with dedicated FSM timeouts, states and events.
- introduce a common way to handle Tnnn timers: gsm_timers.h/.c: struct T_def.
These can be used (with some macro magic) to define a state's timeout once,
and not make mistakes for each osmo_fsm_inst_state_chg().
Details:
bsc_subscr_conn_fsm.c:
- move most states of this FSM to lchan_fsm, assignment_fsm, handover_fsm and
mgw_endpoint_fsm.
- There is exactly one state for an ongoing Assignment, with all details
handled in conn->assignment.fi. The state relies on the assignment_fsm's
timeout.
- There is one state for an ongoing Handover; except for an incoming Handover
from a remote BSS, the gscon remains in ST_INIT until the new lchan and conn
are both established.
- move bssmap_add_lcls_status() to osmo_bsc_lcls.c
abis_rsl.c:
- move all dynamic timeslot logic away into timeslot_fsm. Only keep plain send/receive functions in
abis_rsl.c
- reduce some rsl functions to merely send a message, rename to "_tx_".
- rsl_ipacc_mdcx(): add '_tx_' in the name; move parts that change the lchan state out into the
lchan_fsm, the lchan->abis_ip.* are now set there prior to invoking this function.
- move all timers and error/release handling away into various FSMs.
- tweak ipa_smod_s_for_lchan() and ipa_rtp_pt_for_lchan() to not require an
lchan passed, but just mode,type that they require. Rename to
ipacc_speech_mode*() and ipacc_payload_type().
- add rsl_forward_layer3_info, used for inter-BSC HO MO, to just send the RR
message received during BSSMAP Handover Command.
- move various logging to LOG_LCHAN() in order to log with the lchan FSM instance.
One drawback is that the lchan FSM is limited to one logging category, i.e. this moves some logging
from DRR to DRSL. It might actually make sense to combine those categories.
- lose LOGP...LOGPC logging cascades: they are bad for gsmtap logging and for performance.
- handle_classmark_chg(): change logging, move cm2 len check out of the cm3 condition (I hope that's
correct).
- gsm48_send_ho_cmd(): split off gsm48_make_ho_cmd() which doesn't send right away, so that during
inter-bsc HO we can make an RR Handover Command to send via the MSC to the remote BSS.
assignment_fsm.c:
- the Chan Mode Modify in case of re-using the same lchan is not implemented
yet, because this was also missing in the previous implementation (OS#3357).
osmo_bsc_api.c:
- simplify bsc_mr_config() and move to lchan_fsm.c, the only caller; rename to
lchan_mr_config(). (bsc_mr_config() used to copy the values to mr_bts_lv
twice, once by member assignment and then again with a memcpy.)
- During handover, we used to copy the MR config from the old lchan. Since we
may handover between FR and HR, rather set the MR Config anew every time, so
that FR rates are always available on FR lchans, and never on HR lchans.
Depends: I03ee7ce840ecfa0b6a33358e7385528aabd4873f (libosmocore),
I1f2918418c38918c5ac70acaa51a47adfca12b5e (libosmocore)
Change-Id: I82e3f918295daa83274a4cf803f046979f284366
2018-05-14 16:14:15 +00:00
|
|
|
struct load_counter *pl = &cl->pchan[ts->pchan_on_init];
|
|
|
|
|
struct gsm_lchan *lchan;
|
2009-12-22 12:09:29 +00:00
|
|
|
|
|
|
|
|
/* skip administratively deactivated timeslots */
|
2011-05-30 10:07:53 +00:00
|
|
|
if (!nm_is_running(&ts->mo.nm_state))
|
2009-12-22 12:09:29 +00:00
|
|
|
continue;
|
|
|
|
|
|
2021-06-28 10:19:13 +00:00
|
|
|
/* A dynamic timeslot currently in PDCH mode are available as TCH or SDCCH8, beause they can be switched
|
|
|
|
|
* to TCH or SDCCH mode at any moment. Count TCH/F_TCH/H_SDCCH8_PDCH as one total timeslot, even though it may
|
2021-05-19 00:54:59 +00:00
|
|
|
* be switched to TCH/H and would then count as two -- hence opt for pessimistic load. */
|
2021-06-28 10:19:13 +00:00
|
|
|
if ((ts->pchan_on_init == GSM_PCHAN_OSMO_DYN ||
|
2020-05-05 23:25:21 +00:00
|
|
|
ts->pchan_on_init == GSM_PCHAN_TCH_F_PDCH) &&
|
|
|
|
|
(ts->pchan_is == GSM_PCHAN_NONE ||
|
|
|
|
|
ts->pchan_is == GSM_PCHAN_PDCH)) {
|
2022-06-16 11:08:11 +00:00
|
|
|
ll->total++;
|
2020-05-05 23:25:21 +00:00
|
|
|
pl->total++;
|
2021-05-19 00:54:59 +00:00
|
|
|
/* Below loop would not count this timeslot, since in PDCH mode it has no usable
|
|
|
|
|
* timeslots. But let's make it clear that the timeslot must not be counted again: */
|
|
|
|
|
continue;
|
2020-05-05 23:25:21 +00:00
|
|
|
}
|
|
|
|
|
|
2021-05-19 00:28:26 +00:00
|
|
|
ts_for_n_lchans(lchan, ts, ts->max_primary_lchans) {
|
2019-05-23 19:58:21 +00:00
|
|
|
/* don't even count CBCH slots in total */
|
|
|
|
|
if (lchan->type == GSM_LCHAN_CBCH)
|
|
|
|
|
continue;
|
|
|
|
|
|
2022-06-16 11:08:11 +00:00
|
|
|
ll->total++;
|
2009-12-22 12:09:29 +00:00
|
|
|
pl->total++;
|
|
|
|
|
|
2020-05-16 21:55:01 +00:00
|
|
|
/* lchans under a BORKEN TS should be counted
|
|
|
|
|
* as used just as BORKEN lchans under a normal TS */
|
|
|
|
|
if (ts->fi->state == TS_ST_BORKEN) {
|
2022-06-16 11:08:11 +00:00
|
|
|
ll->used++;
|
2020-05-16 21:55:01 +00:00
|
|
|
pl->used++;
|
|
|
|
|
continue;
|
|
|
|
|
}
|
|
|
|
|
|
large refactoring: use FSMs for lchans; add inter-BSC HO
Add FSMs:
- timeslot_fsm: handle dynamic timeslots and OML+RSL availability.
- lchan_fsm: handle an individual lchan activation, RTP stream and release,
signal the appropriate calling FSMs on success, failure, release.
- mgw_endpoint_fsm: handle one entire endpoint with several CI.
- assignment_fsm: BSSMAP Assignment Request.
- handover_fsm: all of intra, inter-MO and inter-MT handover.
Above FSMs absorb large parts of the gscon FSM. The gscon FSM was surpassing
the maximum amount events (32), and it is more logical to treat assignment,
handover and MGW procedures in separate FSMs.
- Add logging macros for each FSM type:
- LOG_TS()
- LOG_LCHAN()
- LOG_MGWEP(), LOG_CI()
- LOG_ASSIGNMENT()
- LOG_HO()
These log with the osmo_fsm_inst where present.
New style decision: logging without a final newline char is awkward,
especially for gsmtap logging and when other logs interleave LOGPC() calls;
we have various cases where the final \n goes missing, and also this invokes
the log category checking N times instead of once.
So I decided to make these macros *always* append a newline, but only if
there is no final newline yet. I hope that the compiler optimizes the
strlen() of the constant format strings away. Thus I can log with or without
typing "\n" and always get an \n termination anyway.
General:
- replace osmo_timers, state enums and program-wide osmo_signal_dispatch()
with dedicated FSM timeouts, states and events.
- introduce a common way to handle Tnnn timers: gsm_timers.h/.c: struct T_def.
These can be used (with some macro magic) to define a state's timeout once,
and not make mistakes for each osmo_fsm_inst_state_chg().
Details:
bsc_subscr_conn_fsm.c:
- move most states of this FSM to lchan_fsm, assignment_fsm, handover_fsm and
mgw_endpoint_fsm.
- There is exactly one state for an ongoing Assignment, with all details
handled in conn->assignment.fi. The state relies on the assignment_fsm's
timeout.
- There is one state for an ongoing Handover; except for an incoming Handover
from a remote BSS, the gscon remains in ST_INIT until the new lchan and conn
are both established.
- move bssmap_add_lcls_status() to osmo_bsc_lcls.c
abis_rsl.c:
- move all dynamic timeslot logic away into timeslot_fsm. Only keep plain send/receive functions in
abis_rsl.c
- reduce some rsl functions to merely send a message, rename to "_tx_".
- rsl_ipacc_mdcx(): add '_tx_' in the name; move parts that change the lchan state out into the
lchan_fsm, the lchan->abis_ip.* are now set there prior to invoking this function.
- move all timers and error/release handling away into various FSMs.
- tweak ipa_smod_s_for_lchan() and ipa_rtp_pt_for_lchan() to not require an
lchan passed, but just mode,type that they require. Rename to
ipacc_speech_mode*() and ipacc_payload_type().
- add rsl_forward_layer3_info, used for inter-BSC HO MO, to just send the RR
message received during BSSMAP Handover Command.
- move various logging to LOG_LCHAN() in order to log with the lchan FSM instance.
One drawback is that the lchan FSM is limited to one logging category, i.e. this moves some logging
from DRR to DRSL. It might actually make sense to combine those categories.
- lose LOGP...LOGPC logging cascades: they are bad for gsmtap logging and for performance.
- handle_classmark_chg(): change logging, move cm2 len check out of the cm3 condition (I hope that's
correct).
- gsm48_send_ho_cmd(): split off gsm48_make_ho_cmd() which doesn't send right away, so that during
inter-bsc HO we can make an RR Handover Command to send via the MSC to the remote BSS.
assignment_fsm.c:
- the Chan Mode Modify in case of re-using the same lchan is not implemented
yet, because this was also missing in the previous implementation (OS#3357).
osmo_bsc_api.c:
- simplify bsc_mr_config() and move to lchan_fsm.c, the only caller; rename to
lchan_mr_config(). (bsc_mr_config() used to copy the values to mr_bts_lv
twice, once by member assignment and then again with a memcpy.)
- During handover, we used to copy the MR config from the old lchan. Since we
may handover between FR and HR, rather set the MR Config anew every time, so
that FR rates are always available on FR lchans, and never on HR lchans.
Depends: I03ee7ce840ecfa0b6a33358e7385528aabd4873f (libosmocore),
I1f2918418c38918c5ac70acaa51a47adfca12b5e (libosmocore)
Change-Id: I82e3f918295daa83274a4cf803f046979f284366
2018-05-14 16:14:15 +00:00
|
|
|
switch (lchan->fi->state) {
|
|
|
|
|
case LCHAN_ST_UNUSED:
|
2009-12-22 12:09:29 +00:00
|
|
|
break;
|
|
|
|
|
default:
|
2022-06-16 11:08:11 +00:00
|
|
|
ll->used++;
|
2009-12-22 12:09:29 +00:00
|
|
|
pl->used++;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2020-05-07 12:32:52 +00:00
|
|
|
/* Update channel load calculation for all BTS in the BSC */
|
2009-12-22 12:09:29 +00:00
|
|
|
void network_chan_load(struct pchan_load *pl, struct gsm_network *net)
|
|
|
|
|
{
|
|
|
|
|
struct gsm_bts *bts;
|
|
|
|
|
|
|
|
|
|
memset(pl, 0, sizeof(*pl));
|
|
|
|
|
|
|
|
|
|
llist_for_each_entry(bts, &net->bts_list, list)
|
2016-09-25 15:01:20 +00:00
|
|
|
bts_chan_load(pl, bts);
|
2009-12-22 12:09:29 +00:00
|
|
|
}
|
2016-09-25 15:01:20 +00:00
|
|
|
|
2020-05-06 20:17:49 +00:00
|
|
|
static void chan_load_stat_set(enum gsm_phys_chan_config pchan,
|
|
|
|
|
struct gsm_bts *bts,
|
|
|
|
|
struct load_counter *lc)
|
|
|
|
|
{
|
|
|
|
|
switch (pchan) {
|
|
|
|
|
case GSM_PCHAN_NONE:
|
|
|
|
|
case GSM_PCHAN_CCCH:
|
|
|
|
|
case GSM_PCHAN_PDCH:
|
|
|
|
|
case GSM_PCHAN_UNKNOWN:
|
|
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_CCCH_SDCCH4:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_CCCH_SDCCH4_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_CCCH_SDCCH4_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_TCH_F:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_F_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_F_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_TCH_H:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_H_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_H_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_SDCCH8_SACCH8C:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_SDCCH8_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_SDCCH8_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_TCH_F_PDCH:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_F_PDCH_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_TCH_F_PDCH_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_CCCH_SDCCH4_CBCH:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_CCCH_SDCCH4_CBCH_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_CCCH_SDCCH4_CBCH_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
case GSM_PCHAN_SDCCH8_SACCH8C_CBCH:
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_SDCCH8_CBCH_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_SDCCH8_CBCH_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
2021-06-28 10:19:13 +00:00
|
|
|
case GSM_PCHAN_OSMO_DYN:
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_OSMO_DYN_USED), lc->used);
|
|
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_OSMO_DYN_TOTAL), lc->total);
|
2020-05-06 20:17:49 +00:00
|
|
|
break;
|
|
|
|
|
default:
|
|
|
|
|
LOG_BTS(bts, DRLL, LOGL_NOTICE, "Unknown channel type %d\n", pchan);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2018-01-30 17:14:22 +00:00
|
|
|
/* Update T3122 wait indicator based on samples of BTS channel load. */
|
|
|
|
|
void
|
|
|
|
|
bts_update_t3122_chan_load(struct gsm_bts *bts)
|
|
|
|
|
{
|
|
|
|
|
struct pchan_load pl;
|
|
|
|
|
uint64_t used = 0;
|
|
|
|
|
uint32_t total = 0;
|
|
|
|
|
uint64_t load;
|
|
|
|
|
uint64_t wait_ind;
|
|
|
|
|
static const uint8_t min_wait_ind = GSM_T3122_DEFAULT;
|
|
|
|
|
static const uint8_t max_wait_ind = 128; /* max wait ~2 minutes */
|
|
|
|
|
int i;
|
|
|
|
|
|
2018-02-15 17:46:39 +00:00
|
|
|
/* Ignore BTS that are not in operation, in order to not flood the log with "bogus channel load"
|
|
|
|
|
* messages */
|
|
|
|
|
if (!trx_is_usable(bts->c0))
|
|
|
|
|
return;
|
|
|
|
|
|
2018-01-30 17:14:22 +00:00
|
|
|
/* Sum up current load across all channels. */
|
|
|
|
|
memset(&pl, 0, sizeof(pl));
|
|
|
|
|
bts_chan_load(&pl, bts);
|
|
|
|
|
for (i = 0; i < ARRAY_SIZE(pl.pchan); i++) {
|
|
|
|
|
struct load_counter *lc = &pl.pchan[i];
|
|
|
|
|
|
2020-05-06 20:17:49 +00:00
|
|
|
/* Export channel load to stats gauges */
|
|
|
|
|
chan_load_stat_set(i, bts, lc);
|
|
|
|
|
|
2018-01-30 17:14:22 +00:00
|
|
|
/* Ignore samples too large for fixed-point calculations (shouldn't happen). */
|
|
|
|
|
if (lc->used > UINT16_MAX || lc->total > UINT16_MAX) {
|
2019-06-13 14:37:24 +00:00
|
|
|
LOG_BTS(bts, DRLL, LOGL_NOTICE, "numbers in channel load sample "
|
|
|
|
|
"too large (used=%u / total=%u)\n", lc->used, lc->total);
|
2018-01-30 17:14:22 +00:00
|
|
|
continue;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
used += lc->used;
|
|
|
|
|
total += lc->total;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/* Check for invalid samples (shouldn't happen). */
|
2020-07-04 09:35:16 +00:00
|
|
|
if (used > total) {
|
2019-06-13 14:37:24 +00:00
|
|
|
LOG_BTS(bts, DRLL, LOGL_NOTICE, "bogus channel load sample (used=%"PRIu64" / total=%"PRIu32")\n",
|
|
|
|
|
used, total);
|
2020-07-04 09:35:16 +00:00
|
|
|
}
|
|
|
|
|
if (total == 0 || used > total) {
|
2018-01-30 17:14:22 +00:00
|
|
|
bts->T3122 = 0; /* disable override of network-wide default value */
|
|
|
|
|
bts->chan_load_samples_idx = 0; /* invalidate other samples collected so far */
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/* If we haven't got enough samples yet, store measurement for later use. */
|
|
|
|
|
if (bts->chan_load_samples_idx < ARRAY_SIZE(bts->chan_load_samples)) {
|
|
|
|
|
struct load_counter *sample = &bts->chan_load_samples[bts->chan_load_samples_idx++];
|
|
|
|
|
sample->total = (unsigned int)total;
|
|
|
|
|
sample->used = (unsigned int)used;
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/* We have enough samples and will overwrite our current samples later. */
|
|
|
|
|
bts->chan_load_samples_idx = 0;
|
|
|
|
|
|
|
|
|
|
/* Add all previous samples to the current sample. */
|
|
|
|
|
for (i = 0; i < ARRAY_SIZE(bts->chan_load_samples); i++) {
|
|
|
|
|
struct load_counter *sample = &bts->chan_load_samples[i];
|
|
|
|
|
total += sample->total;
|
|
|
|
|
used += sample->used;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
used <<= 8; /* convert to fixed-point */
|
|
|
|
|
|
|
|
|
|
/* Log channel load average. */
|
|
|
|
|
load = ((used / total) * 100);
|
2019-06-13 14:37:24 +00:00
|
|
|
LOG_BTS(bts, DRLL, LOGL_DEBUG, "channel load average is %"PRIu64".%.2"PRIu64"%%\n",
|
|
|
|
|
(load & 0xffffff00) >> 8, (load & 0xff) / 10);
|
Add support for Access Control Class ramping.
Access Control Class (ACC) ramping is used to slowly make the cell
available to an increasing number of MS. This avoids overload at
startup time in cases where a lot of MS would discover the new
cell and try to connect to it all at once.
Ramping behaviour can be configured with new VTY commands:
[no] access-control-class-ramping
access-control-class-ramping-step-interval (<30-600>|dynamic)
access-control-class-ramping-step-size (<1-10>)
(The minimum and maximum values for these parameters are hard-coded,
but could be changed if they are found to be inadequate.)
The VTY command 'show bts' has been extended to display the
current ACC ramping configuration.
By default, ACC ramping is disabled.
When enabled, the default behaviour is to enable one ACC per
ramping step with a 'dynamic' step interval. This means the
ramping interval (time between steps) is scaled to the channel
load average of the BTS, i.e. the number of used vs. available
channels measured over a certain amount of time.
Below is an example of debug log output with ACC ramping enabled,
while many 'mobile' programs are concurrently trying to connect
to the network via an osmo-bts-virtual BTS. Initially, all ACCs
are barred, and then only one class is allowed. Then the current
BTS channel load average is consulted for scheduling the next
ramping step. While the channel load average is low, ramping
proceeds faster, and while it is is high, ramping proceeds slower:
(bts=0) ACC RAMP: barring Access Control Class 0
(bts=0) ACC RAMP: barring Access Control Class 1
(bts=0) ACC RAMP: barring Access Control Class 2
(bts=0) ACC RAMP: barring Access Control Class 3
(bts=0) ACC RAMP: barring Access Control Class 4
(bts=0) ACC RAMP: barring Access Control Class 5
(bts=0) ACC RAMP: barring Access Control Class 6
(bts=0) ACC RAMP: barring Access Control Class 7
(bts=0) ACC RAMP: barring Access Control Class 8
(bts=0) ACC RAMP: barring Access Control Class 9
(bts=0) ACC RAMP: allowing Access Control Class 0
(bts=0) ACC RAMP: step interval set to 30 seconds based on 0% channel load average
(bts=0) ACC RAMP: allowing Access Control Class 1
(bts=0) ACC RAMP: step interval set to 354 seconds based on 59% channel load average
(bts=0) ACC RAMP: allowing Access Control Class 2
(bts=0) ACC RAMP: step interval set to 30 seconds based on 0% channel load average
(bts=0) ACC RAMP: allowing Access Control Class 3
(bts=0) ACC RAMP: step interval set to 30 seconds based on 0% channel load average
Change-Id: I0a5ac3a08f992f326435944f17e0a9171911afb0
Related: OS#2591
2018-02-06 13:44:54 +00:00
|
|
|
bts->chan_load_avg = ((load & 0xffffff00) >> 8);
|
|
|
|
|
OSMO_ASSERT(bts->chan_load_avg <= 100);
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_CHAN_LOAD_AVERAGE), bts->chan_load_avg);
|
2018-01-30 17:14:22 +00:00
|
|
|
|
|
|
|
|
/* Calculate new T3122 wait indicator. */
|
|
|
|
|
wait_ind = ((used / total) * max_wait_ind);
|
|
|
|
|
wait_ind >>= 8; /* convert from fixed-point to integer */
|
|
|
|
|
if (wait_ind < min_wait_ind)
|
|
|
|
|
wait_ind = min_wait_ind;
|
|
|
|
|
else if (wait_ind > max_wait_ind)
|
|
|
|
|
wait_ind = max_wait_ind;
|
|
|
|
|
|
2019-06-13 14:37:24 +00:00
|
|
|
LOG_BTS(bts, DRLL, LOGL_DEBUG, "T3122 wait indicator set to %"PRIu64" seconds\n", wait_ind);
|
2018-01-30 17:14:22 +00:00
|
|
|
bts->T3122 = (uint8_t)wait_ind;
|
2021-06-04 15:30:21 +00:00
|
|
|
osmo_stat_item_set(osmo_stat_item_group_get_item(bts->bts_statg, BTS_STAT_T3122), wait_ind);
|
2018-01-30 17:14:22 +00:00
|
|
|
}
|
