osmith has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/42720?usp=email )
Change subject: Cosmetic: bts_nokia_site: fix comment formatting ......................................................................
Cosmetic: bts_nokia_site: fix comment formatting
Ensure each line of a multiline comment starts with " * ".
Related: https://gerrit.osmocom.org/c/osmo-bsc/+/42712/comment/6aa80188_f56f2265/ Change-Id: I83ed16ec09fb66076dc2ba6a49ef272657b09407 --- M src/osmo-bsc/bts_nokia_site.c 1 file changed, 47 insertions(+), 61 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/20/42720/1
diff --git a/src/osmo-bsc/bts_nokia_site.c b/src/osmo-bsc/bts_nokia_site.c index e5f2c9d..f365278 100644 --- a/src/osmo-bsc/bts_nokia_site.c +++ b/src/osmo-bsc/bts_nokia_site.c @@ -19,12 +19,11 @@ * */
-/* - TODO: Attention: There are some static variables used for states during - configuration. Those variables have to be moved to a BTS specific context, - otherwise there will most certainly be problems if more than one Nokia BTS - is used. -*/ +/* TODO: Attention: There are some static variables used for states during + * configuration. Those variables have to be moved to a BTS specific context, + * otherwise there will most certainly be problems if more than one Nokia BTS + * is used. + */
#include <time.h>
@@ -88,14 +87,11 @@ #define SAPI_OML 62 #define SAPI_RSL 0
-/* - - Tell LAPD to start start the SAP (send SABM requests) for all signalling - timeslots in this line - - Attention: this has to be adapted for mISDN -*/ - +/* Tell LAPD to start start the SAP (send SABM requests) for all signalling + * timeslots in this line + * + * Attention: this has to be adapted for mISDN + */ static void start_sabm_in_line(struct e1inp_line *line, int start, int sapi) { struct e1inp_sign_link *link; @@ -851,10 +847,7 @@
/* TODO: put in a separate file ? */
-/* - build the configuration for each TRX -*/ - +/* build the configuration for each TRX */ static int make_fu_config(struct gsm_bts_trx *trx, uint8_t id, uint8_t * fu_config, int *hopping) { @@ -900,11 +893,10 @@
/* set BSIC */
- /* - Attention: all TRX except the first one seem to get the TSC - from the CHANNEL ACTIVATION command (in CHANNEL IDENTIFICATION, - GSM 04.08 CHANNEL DESCRIPTION). - There was a bug in rsl_chan_activate_lchan() setting this parameter. + /* Attention: all TRX except the first one seem to get the TSC + * from the CHANNEL ACTIVATION command (in CHANNEL IDENTIFICATION, + * GSM 04.08 CHANNEL DESCRIPTION). + * There was a bug in rsl_chan_activate_lchan() setting this parameter. */
uint8_t bsic = trx->bts->bsic; @@ -924,19 +916,18 @@ struct gsm_bts_trx_ts *ts = &trx->ts[i]; uint8_t chan_config;
- /* - 0 = FCCH + SCH + BCCH + CCCH - 1 = FCCH + SCH + BCCH + CCCH + SDCCH/4 + SACCH/4 - 2 = BCCH + CCCH (This combination is not used in any BTS) - 3 = FCCH + SCH + BCCH + CCCH + SDCCH/4 with SDCCH2 used as CBCH - 4 = SDCCH/8 + SACCH/8 - 5 = SDCCH/8 with SDCCH2 used as CBCH - 6 = TCH/F + FACCH/F + SACCH/F - 7 = E-RACH (Talk family) - 9 = Dual rate (capability for TCH/F and TCH/H) - 10 = reserved for BTS internal use - 11 = PBCCH + PCCCH + PDTCH + PACCH + PTCCH (can be used in GPRS release 2). - 0xFF = spare TS + /* 0 = FCCH + SCH + BCCH + CCCH + * 1 = FCCH + SCH + BCCH + CCCH + SDCCH/4 + SACCH/4 + * 2 = BCCH + CCCH (This combination is not used in any BTS) + * 3 = FCCH + SCH + BCCH + CCCH + SDCCH/4 with SDCCH2 used as CBCH + * 4 = SDCCH/8 + SACCH/8 + * 5 = SDCCH/8 with SDCCH2 used as CBCH + * 6 = TCH/F + FACCH/F + SACCH/F + * 7 = E-RACH (Talk family) + * 9 = Dual rate (capability for TCH/F and TCH/H) + * 10 = reserved for BTS internal use + * 11 = PBCCH + PCCCH + PDTCH + PACCH + PTCCH (can be used in GPRS release 2). + * 0xFF = spare TS */
switch (ts->pchan_from_config) { @@ -1153,10 +1144,7 @@
/* TODO: put in a separate file ? */
-/* - build the configuration data -*/ - +/* build the configuration data */ static int make_bts_config(struct gsm_bts *bts, uint8_t bts_type, int n_trx, uint8_t * fu_config, int need_hopping, int hopping_type) { @@ -1749,19 +1737,18 @@
/* TODO: put in a separate file ? */
-/* - This is how the configuration is done: - - start OML link - - reset BTS - - receive ACK, wait some time and restart OML link - - receive OMU STARTED message, send START DOWNLOAD REQ - - receive CNF REQ message, send CONF DATA - - receive ACK, start RSL link(s) - ACK some other messages received from the BTS. - - Probably its also possible to configure the BTS without a reset, this - has not been tested yet. -*/ +/* This is how the configuration is done: + * - start OML link + * - reset BTS + * - receive ACK, wait some time and restart OML link + * - receive OMU STARTED message, send START DOWNLOAD REQ + * - receive CNF REQ message, send CONF DATA + * - receive ACK, start RSL link(s) + * ACK some other messages received from the BTS. + * + * Probably its also possible to configure the BTS without a reset, this + * has not been tested yet. + */
#define FIND_ELEM(data, data_len, ei, var, len) (find_element(data, data_len, ei, var, len) == len) static int abis_nm_rcvmsg_fom(struct msgb *mb) @@ -1846,14 +1833,13 @@ if (!bts->nokia.did_reset) { bts->nokia.did_reset = 1;
- /* - TODO: For the InSite processing the received data is - blocked in the driver during reset. - Otherwise the LAPD module might assert because the InSite - sends garbage on the E1 line during reset. - This is done by looking at "wait_reset" in the driver - (function handle_ts1_read()) and ignoring the received data. - It seems to be necessary for the MetroSite too. + /* TODO: For the InSite processing the received data is + * blocked in the driver during reset. + * Otherwise the LAPD module might assert because the InSite + * sends garbage on the E1 line during reset. + * This is done by looking at "wait_reset" in the driver + * (function handle_ts1_read()) and ignoring the received data. + * It seems to be necessary for the MetroSite too. */
/* we cannot delete / stop the OML LAPD SAP right here, as we are in