2017-08-07 08:24:18 +00:00
|
|
|
/*
|
|
|
|
* OsmocomBB <-> SDR connection bridge
|
|
|
|
* TDMA scheduler: handlers for DL / UL bursts on logical channels
|
|
|
|
*
|
2022-07-06 11:06:07 +00:00
|
|
|
* (C) 2017-2022 by Vadim Yanitskiy <axilirator@gmail.com>
|
2021-06-14 21:14:34 +00:00
|
|
|
* Contributions by sysmocom - s.f.m.c. GmbH
|
2017-08-07 08:24:18 +00:00
|
|
|
*
|
|
|
|
* All Rights Reserved
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (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
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <errno.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
|
|
|
|
#include <osmocom/core/logging.h>
|
|
|
|
#include <osmocom/core/bits.h>
|
|
|
|
|
|
|
|
#include <osmocom/gsm/protocol/gsm_04_08.h>
|
|
|
|
#include <osmocom/gsm/gsm_utils.h>
|
|
|
|
|
|
|
|
#include <osmocom/coding/gsm0503_coding.h>
|
|
|
|
#include <osmocom/codec/codec.h>
|
|
|
|
|
2022-07-22 12:54:14 +00:00
|
|
|
#include <osmocom/bb/l1sched/l1sched.h>
|
2022-07-22 00:21:11 +00:00
|
|
|
#include <osmocom/bb/l1sched/logging.h>
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2022-07-06 11:06:07 +00:00
|
|
|
int rx_tchf_fn(struct l1sched_lchan_state *lchan,
|
|
|
|
uint32_t fn, uint8_t bid, const sbit_t *bits,
|
|
|
|
const struct l1sched_meas_set *meas)
|
2017-08-07 08:24:18 +00:00
|
|
|
{
|
2018-03-09 10:28:57 +00:00
|
|
|
int n_errors = -1, n_bits_total, rc;
|
2017-08-07 08:24:18 +00:00
|
|
|
sbit_t *buffer, *offset;
|
|
|
|
uint8_t l2[128], *mask;
|
|
|
|
size_t l2_len;
|
|
|
|
|
|
|
|
/* Set up pointers */
|
|
|
|
mask = &lchan->rx_burst_mask;
|
|
|
|
buffer = lchan->rx_bursts;
|
|
|
|
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_DEBUG, "Traffic received: fn=%u bid=%u\n", fn, bid);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2020-03-04 14:41:01 +00:00
|
|
|
/* Align to the first burst of a block */
|
|
|
|
if (*mask == 0x00 && bid != 0)
|
|
|
|
return 0;
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Update mask */
|
|
|
|
*mask |= (1 << bid);
|
|
|
|
|
2020-03-01 19:55:01 +00:00
|
|
|
/* Store the measurements */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_lchan_meas_push(lchan, meas);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Copy burst to end of buffer of 8 bursts */
|
|
|
|
offset = buffer + bid * 116 + 464;
|
|
|
|
memcpy(offset, bits + 3, 58);
|
|
|
|
memcpy(offset + 58, bits + 87, 58);
|
|
|
|
|
|
|
|
/* Wait until complete set of bursts */
|
|
|
|
if (bid != 3)
|
|
|
|
return 0;
|
|
|
|
|
2020-03-01 19:55:01 +00:00
|
|
|
/* Calculate AVG of the measurements */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_lchan_meas_avg(lchan, 8);
|
2020-03-01 19:55:01 +00:00
|
|
|
|
2018-03-09 10:28:57 +00:00
|
|
|
/* Check for complete set of bursts */
|
2020-03-04 15:13:36 +00:00
|
|
|
if ((*mask & 0xff) != 0xff) {
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR,
|
|
|
|
"Received incomplete (%s) traffic frame at fn=%u (%u/%u)\n",
|
|
|
|
l1sched_burst_mask2str(mask, 8), lchan->meas_avg.fn,
|
|
|
|
lchan->meas_avg.fn % lchan->ts->mf_layout->period,
|
|
|
|
lchan->ts->mf_layout->period);
|
2020-03-04 15:19:53 +00:00
|
|
|
/* NOTE: do not abort here, give it a try. Maybe we're lucky ;) */
|
2018-03-09 10:28:57 +00:00
|
|
|
|
|
|
|
}
|
|
|
|
|
2020-03-04 14:41:01 +00:00
|
|
|
/* Keep the mask updated */
|
|
|
|
*mask = *mask << 4;
|
|
|
|
|
2018-08-15 02:00:16 +00:00
|
|
|
switch (lchan->tch_mode) {
|
2017-08-07 08:24:18 +00:00
|
|
|
case GSM48_CMODE_SIGN:
|
|
|
|
case GSM48_CMODE_SPEECH_V1: /* FR */
|
|
|
|
rc = gsm0503_tch_fr_decode(l2, buffer,
|
|
|
|
1, 0, &n_errors, &n_bits_total);
|
|
|
|
break;
|
|
|
|
case GSM48_CMODE_SPEECH_EFR: /* EFR */
|
|
|
|
rc = gsm0503_tch_fr_decode(l2, buffer,
|
|
|
|
1, 1, &n_errors, &n_bits_total);
|
|
|
|
break;
|
|
|
|
case GSM48_CMODE_SPEECH_AMR: /* AMR */
|
|
|
|
/**
|
|
|
|
* TODO: AMR requires a dedicated loop,
|
|
|
|
* which will be implemented later...
|
|
|
|
*/
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR, "AMR isn't supported yet\n");
|
2017-08-07 08:24:18 +00:00
|
|
|
return -ENOTSUP;
|
|
|
|
default:
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR, "Invalid TCH mode: %u\n", lchan->tch_mode);
|
2017-08-07 08:24:18 +00:00
|
|
|
return -EINVAL;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Shift buffer by 4 bursts for interleaving */
|
|
|
|
memcpy(buffer, buffer + 464, 464);
|
|
|
|
|
|
|
|
/* Check decoding result */
|
|
|
|
if (rc < 4) {
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR,
|
|
|
|
"Received bad frame (rc=%d, ber=%d/%d) at fn=%u\n",
|
|
|
|
rc, n_errors, n_bits_total, lchan->meas_avg.fn);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2018-03-09 10:28:57 +00:00
|
|
|
/* Send BFI */
|
|
|
|
goto bfi;
|
2017-08-07 08:24:18 +00:00
|
|
|
} else if (rc == GSM_MACBLOCK_LEN) {
|
|
|
|
/* FACCH received, forward it to the higher layers */
|
2022-07-06 11:06:07 +00:00
|
|
|
l1sched_handle_data_ind(lchan, l2, GSM_MACBLOCK_LEN,
|
|
|
|
n_errors, n_bits_total,
|
|
|
|
L1SCHED_DT_SIGNALING);
|
2017-12-16 09:21:05 +00:00
|
|
|
|
2020-03-01 20:29:47 +00:00
|
|
|
/* Send BFI substituting a stolen TCH frame */
|
|
|
|
n_errors = -1; /* ensure fake measurements */
|
2018-03-09 10:28:57 +00:00
|
|
|
goto bfi;
|
2017-08-07 08:24:18 +00:00
|
|
|
} else {
|
|
|
|
/* A good TCH frame received */
|
|
|
|
l2_len = rc;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Send a traffic frame to the higher layers */
|
2022-07-06 11:06:07 +00:00
|
|
|
return l1sched_handle_data_ind(lchan, l2, l2_len, n_errors, n_bits_total, L1SCHED_DT_TRAFFIC);
|
2018-03-09 10:28:57 +00:00
|
|
|
|
|
|
|
bfi:
|
2020-03-01 19:55:01 +00:00
|
|
|
/* Didn't try to decode, fake measurements */
|
|
|
|
if (n_errors < 0) {
|
2022-07-01 18:42:26 +00:00
|
|
|
lchan->meas_avg = (struct l1sched_meas_set) {
|
2020-03-02 12:07:35 +00:00
|
|
|
.fn = lchan->meas_avg.fn,
|
2020-03-01 19:55:01 +00:00
|
|
|
.toa256 = 0,
|
|
|
|
.rssi = -110,
|
|
|
|
};
|
2020-03-04 22:01:18 +00:00
|
|
|
|
|
|
|
/* No bursts => no errors */
|
|
|
|
n_errors = 0;
|
2020-03-01 19:55:01 +00:00
|
|
|
}
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2018-08-17 01:48:29 +00:00
|
|
|
/* BFI is not applicable in signalling mode */
|
2022-07-06 11:06:07 +00:00
|
|
|
if (lchan->tch_mode == GSM48_CMODE_SIGN) {
|
|
|
|
return l1sched_handle_data_ind(lchan, NULL, 0,
|
|
|
|
n_errors, n_bits_total,
|
|
|
|
L1SCHED_DT_TRAFFIC);
|
|
|
|
}
|
2018-08-17 01:48:29 +00:00
|
|
|
|
|
|
|
/* Bad frame indication */
|
2022-07-01 18:42:26 +00:00
|
|
|
l2_len = l1sched_bad_frame_ind(l2, lchan);
|
2018-08-17 01:48:29 +00:00
|
|
|
|
2018-03-09 10:28:57 +00:00
|
|
|
/* Send a BFI frame to the higher layers */
|
2022-07-06 11:06:07 +00:00
|
|
|
return l1sched_handle_data_ind(lchan, l2, l2_len,
|
|
|
|
n_errors, n_bits_total,
|
|
|
|
L1SCHED_DT_TRAFFIC);
|
2017-08-07 08:24:18 +00:00
|
|
|
}
|
|
|
|
|
2022-07-06 11:06:07 +00:00
|
|
|
int tx_tchf_fn(struct l1sched_lchan_state *lchan,
|
2022-07-01 18:42:26 +00:00
|
|
|
struct l1sched_burst_req *br)
|
2017-08-07 08:24:18 +00:00
|
|
|
{
|
|
|
|
ubit_t *buffer, *offset;
|
|
|
|
const uint8_t *tsc;
|
2017-12-17 20:47:23 +00:00
|
|
|
uint8_t *mask;
|
2017-08-07 08:24:18 +00:00
|
|
|
size_t l2_len;
|
|
|
|
int rc;
|
|
|
|
|
|
|
|
/* Set up pointers */
|
|
|
|
mask = &lchan->tx_burst_mask;
|
|
|
|
buffer = lchan->tx_bursts;
|
|
|
|
|
|
|
|
/* If we have encoded bursts */
|
|
|
|
if (*mask)
|
|
|
|
goto send_burst;
|
|
|
|
|
|
|
|
/* Wait until a first burst in period */
|
2021-06-14 21:14:34 +00:00
|
|
|
if (br->bid > 0)
|
2017-08-07 08:24:18 +00:00
|
|
|
return 0;
|
|
|
|
|
|
|
|
/* Check the current TCH mode */
|
|
|
|
switch (lchan->tch_mode) {
|
|
|
|
case GSM48_CMODE_SIGN:
|
|
|
|
case GSM48_CMODE_SPEECH_V1: /* FR */
|
|
|
|
l2_len = GSM_FR_BYTES;
|
|
|
|
break;
|
|
|
|
case GSM48_CMODE_SPEECH_EFR: /* EFR */
|
|
|
|
l2_len = GSM_EFR_BYTES;
|
|
|
|
break;
|
|
|
|
case GSM48_CMODE_SPEECH_AMR: /* AMR */
|
|
|
|
/**
|
|
|
|
* TODO: AMR requires a dedicated loop,
|
|
|
|
* which will be implemented later...
|
|
|
|
*/
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR,
|
|
|
|
"AMR isn't supported yet, dropping frame...\n");
|
2017-12-17 20:47:23 +00:00
|
|
|
|
|
|
|
/* Forget this primitive */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_prim_drop(lchan);
|
2017-12-17 20:47:23 +00:00
|
|
|
|
2017-08-07 08:24:18 +00:00
|
|
|
return -ENOTSUP;
|
|
|
|
default:
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR,
|
|
|
|
"Invalid TCH mode: %u, dropping frame...\n",
|
|
|
|
lchan->tch_mode);
|
2017-12-17 20:47:23 +00:00
|
|
|
|
|
|
|
/* Forget this primitive */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_prim_drop(lchan);
|
2017-12-17 20:47:23 +00:00
|
|
|
|
2017-08-07 08:24:18 +00:00
|
|
|
return -EINVAL;
|
|
|
|
}
|
|
|
|
|
2018-07-24 15:24:13 +00:00
|
|
|
/* Determine and check the payload length */
|
|
|
|
if (lchan->prim->payload_len == GSM_MACBLOCK_LEN) {
|
|
|
|
l2_len = GSM_MACBLOCK_LEN; /* FACCH */
|
|
|
|
} else if (lchan->prim->payload_len != l2_len) {
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR, "Primitive has odd length %zu "
|
|
|
|
"(expected %zu for TCH or %u for FACCH), so dropping...\n",
|
|
|
|
lchan->prim->payload_len, l2_len, GSM_MACBLOCK_LEN);
|
2018-07-24 15:24:13 +00:00
|
|
|
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_prim_drop(lchan);
|
2018-07-24 15:24:13 +00:00
|
|
|
return -EINVAL;
|
|
|
|
}
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Shift buffer by 4 bursts back for interleaving */
|
|
|
|
memcpy(buffer, buffer + 464, 464);
|
|
|
|
|
|
|
|
/* Encode payload */
|
2017-12-17 20:47:23 +00:00
|
|
|
rc = gsm0503_tch_fr_encode(buffer, lchan->prim->payload, l2_len, 1);
|
2017-08-07 08:24:18 +00:00
|
|
|
if (rc) {
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_ERROR, "Failed to encode L2 payload (len=%zu): %s\n",
|
|
|
|
lchan->prim->payload_len, osmo_hexdump(lchan->prim->payload,
|
|
|
|
lchan->prim->payload_len));
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2017-12-17 20:47:23 +00:00
|
|
|
/* Forget this primitive */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_prim_drop(lchan);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
return -EINVAL;
|
|
|
|
}
|
|
|
|
|
|
|
|
send_burst:
|
|
|
|
/* Determine which burst should be sent */
|
2021-06-14 21:14:34 +00:00
|
|
|
offset = buffer + br->bid * 116;
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Update mask */
|
2021-06-14 21:14:34 +00:00
|
|
|
*mask |= (1 << br->bid);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Choose proper TSC */
|
2022-07-06 11:06:07 +00:00
|
|
|
tsc = l1sched_nb_training_bits[lchan->tsc];
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Compose a new burst */
|
2021-06-14 21:14:34 +00:00
|
|
|
memset(br->burst, 0, 3); /* TB */
|
|
|
|
memcpy(br->burst + 3, offset, 58); /* Payload 1/2 */
|
|
|
|
memcpy(br->burst + 61, tsc, 26); /* TSC */
|
|
|
|
memcpy(br->burst + 87, offset + 58, 58); /* Payload 2/2 */
|
|
|
|
memset(br->burst + 145, 0, 3); /* TB */
|
|
|
|
br->burst_len = GSM_BURST_LEN;
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2022-07-22 00:21:11 +00:00
|
|
|
LOGP_LCHAND(lchan, LOGL_DEBUG, "Scheduled fn=%u burst=%u\n", br->fn, br->bid);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* If we have sent the last (4/4) burst */
|
|
|
|
if (*mask == 0x0f) {
|
|
|
|
/* Confirm data / traffic sending */
|
2022-07-06 11:06:07 +00:00
|
|
|
enum l1sched_data_type dt = L1SCHED_PRIM_IS_TCH(lchan->prim) ?
|
|
|
|
L1SCHED_DT_TRAFFIC : L1SCHED_DT_SIGNALING;
|
|
|
|
l1sched_handle_data_cnf(lchan, br->fn, dt);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
2017-12-17 20:47:23 +00:00
|
|
|
/* Forget processed primitive */
|
2022-07-01 18:42:26 +00:00
|
|
|
l1sched_prim_drop(lchan);
|
2017-08-07 08:24:18 +00:00
|
|
|
|
|
|
|
/* Reset mask */
|
|
|
|
*mask = 0x00;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|