blob: 17b6a3a02fa7a4829a366d250bad6bb65121ccc2 [file] [log] [blame]
Daniel Willmannca102af2014-08-08 12:14:12 +02001/* Copied from tbf.cpp
2 *
3 * Copyright (C) 2012 Ivan Klyuchnikov
4 * Copyright (C) 2012 Andreas Eversberg <jolly@eversberg.eu>
5 * Copyright (C) 2013 by Holger Hans Peter Freyther
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
Daniel Willmannca102af2014-08-08 12:14:12 +020016 */
17
18#include <bts.h>
19#include <tbf.h>
Pau Espin Pedrol9d1cdb12019-09-25 17:47:02 +020020#include <tbf_dl.h>
21#include <tbf_ul.h>
Daniel Willmannca102af2014-08-08 12:14:12 +020022#include <rlc.h>
23#include <gprs_rlcmac.h>
24#include <gprs_debug.h>
25#include <gprs_bssgp_pcu.h>
Jacob Erlbeckd4ad7312015-07-17 16:39:09 +020026#include <gprs_codel.h>
Daniel Willmannca102af2014-08-08 12:14:12 +020027#include <decoding.h>
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +010028#include <encoding.h>
Max1187a772018-01-26 13:31:42 +010029#include <gprs_ms.h>
Max1187a772018-01-26 13:31:42 +010030#include <llc.h>
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +010031#include "pcu_utils.h"
32
Daniel Willmannca102af2014-08-08 12:14:12 +020033extern "C" {
34#include <osmocom/core/msgb.h>
35#include <osmocom/core/talloc.h>
Alexander Couzens95e37922016-05-21 22:33:27 +020036#include <osmocom/gprs/gprs_bssgp_bss.h>
Max1187a772018-01-26 13:31:42 +010037 #include <osmocom/core/bitvec.h>
38 #include <osmocom/core/linuxlist.h>
39 #include <osmocom/core/logging.h>
40 #include <osmocom/core/rate_ctr.h>
Pau Espin Pedrolb3859692020-10-23 22:37:52 +020041 #include <osmocom/core/stats.h>
Max1187a772018-01-26 13:31:42 +010042 #include <osmocom/core/timer.h>
43 #include <osmocom/core/utils.h>
44 #include <osmocom/gsm/gsm_utils.h>
45 #include <osmocom/gsm/protocol/gsm_04_08.h>
Max136ebcc2019-03-05 14:59:03 +010046 #include "coding_scheme.h"
Daniel Willmannca102af2014-08-08 12:14:12 +020047}
48
49#include <errno.h>
50#include <string.h>
51
52/* After sending these frames, we poll for ack/nack. */
53#define POLL_ACK_AFTER_FRAMES 20
54
Pau Espin Pedrolb3859692020-10-23 22:37:52 +020055extern void *tall_pcu_ctx;
56
57static const struct rate_ctr_desc tbf_dl_gprs_ctr_description[] = {
58 { "gprs:downlink:cs1", "CS1 " },
59 { "gprs:downlink:cs2", "CS2 " },
60 { "gprs:downlink:cs3", "CS3 " },
61 { "gprs:downlink:cs4", "CS4 " },
62};
63
64static const struct rate_ctr_desc tbf_dl_egprs_ctr_description[] = {
65 { "egprs:downlink:mcs1", "MCS1 " },
66 { "egprs:downlink:mcs2", "MCS2 " },
67 { "egprs:downlink:mcs3", "MCS3 " },
68 { "egprs:downlink:mcs4", "MCS4 " },
69 { "egprs:downlink:mcs5", "MCS5 " },
70 { "egprs:downlink:mcs6", "MCS6 " },
71 { "egprs:downlink:mcs7", "MCS7 " },
72 { "egprs:downlink:mcs8", "MCS8 " },
73 { "egprs:downlink:mcs9", "MCS9 " },
74};
75
76static const struct rate_ctr_group_desc tbf_dl_gprs_ctrg_desc = {
77 "tbf:gprs",
78 "Data Blocks",
79 OSMO_STATS_CLASS_SUBSCRIBER,
80 ARRAY_SIZE(tbf_dl_gprs_ctr_description),
81 tbf_dl_gprs_ctr_description,
82};
83
84static const struct rate_ctr_group_desc tbf_dl_egprs_ctrg_desc = {
85 "tbf:egprs",
86 "Data Blocks",
87 OSMO_STATS_CLASS_SUBSCRIBER,
88 ARRAY_SIZE(tbf_dl_egprs_ctr_description),
89 tbf_dl_egprs_ctr_description,
90};
91
Pau Espin Pedrol834cbab2020-10-23 22:17:01 +020092gprs_rlcmac_dl_tbf::BandWidth::BandWidth() :
93 dl_bw_octets(0),
94 dl_throughput(0),
95 dl_loss_lost(0),
96 dl_loss_received(0)
97{
98 timespecclear(&dl_bw_tv);
99 timespecclear(&dl_loss_tv);
100}
101
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200102static int dl_tbf_dtor(struct gprs_rlcmac_dl_tbf *tbf)
103{
104 tbf->~gprs_rlcmac_dl_tbf();
105 return 0;
106}
107
Pau Espin Pedrol29b9f942022-10-27 14:53:16 +0200108struct gprs_rlcmac_dl_tbf *dl_tbf_alloc(struct gprs_rlcmac_bts *bts, struct GprsMs *ms, int8_t use_trx, bool single_slot)
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200109{
110 struct gprs_rlcmac_dl_tbf *tbf;
111 int rc;
112
113 OSMO_ASSERT(ms != NULL);
114
Pau Espin Pedrol36177c62021-02-25 17:57:37 +0100115 LOGPMS(ms, DTBF, LOGL_DEBUG, "********** DL-TBF starts here **********\n");
116 LOGPMS(ms, DTBF, LOGL_INFO, "Allocating DL TBF\n");
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200117
118 tbf = talloc(tall_pcu_ctx, struct gprs_rlcmac_dl_tbf);
119
120 if (!tbf)
121 return NULL;
122
123 talloc_set_destructor(tbf, dl_tbf_dtor);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100124 new (tbf) gprs_rlcmac_dl_tbf(bts, ms);
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200125
126 rc = tbf->setup(use_trx, single_slot);
127 /* if no resource */
128 if (rc < 0) {
129 talloc_free(tbf);
130 return NULL;
131 }
132
133 if (tbf->is_egprs_enabled()) {
134 tbf->set_window_size();
135 tbf->m_dl_egprs_ctrs = rate_ctr_group_alloc(tbf,
136 &tbf_dl_egprs_ctrg_desc,
137 tbf->m_ctrs->idx);
138 if (!tbf->m_dl_egprs_ctrs) {
139 LOGPTBF(tbf, LOGL_ERROR, "Couldn't allocate EGPRS DL counters\n");
140 talloc_free(tbf);
141 return NULL;
142 }
143 } else {
144 tbf->m_dl_gprs_ctrs = rate_ctr_group_alloc(tbf,
145 &tbf_dl_gprs_ctrg_desc,
146 tbf->m_ctrs->idx);
147 if (!tbf->m_dl_gprs_ctrs) {
148 LOGPTBF(tbf, LOGL_ERROR, "Couldn't allocate GPRS DL counters\n");
149 talloc_free(tbf);
150 return NULL;
151 }
152 }
153
Pau Espin Pedrol1a1557a2021-05-13 18:39:36 +0200154 llist_add(tbf_trx_list((struct gprs_rlcmac_tbf *)tbf), &tbf->trx->dl_tbfs);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100155 bts_do_rate_ctr_inc(tbf->bts, CTR_TBF_DL_ALLOCATED);
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200156
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200157 osmo_clock_gettime(CLOCK_MONOTONIC, &tbf->m_bw.dl_bw_tv);
158 osmo_clock_gettime(CLOCK_MONOTONIC, &tbf->m_bw.dl_loss_tv);
159
160 return tbf;
161}
162
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200163gprs_rlcmac_dl_tbf::~gprs_rlcmac_dl_tbf()
164{
Pau Espin Pedrol131deb02021-07-26 18:24:14 +0200165 if (is_egprs_enabled()) {
166 rate_ctr_group_free(m_dl_egprs_ctrs);
167 } else {
168 rate_ctr_group_free(m_dl_gprs_ctrs);
169 }
170 /* ~gprs_rlcmac_tbf() is called automatically upon return */
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200171}
172
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100173gprs_rlcmac_dl_tbf::gprs_rlcmac_dl_tbf(struct gprs_rlcmac_bts *bts_, GprsMs *ms) :
Pau Espin Pedrole9f77d32020-10-23 18:41:40 +0200174 gprs_rlcmac_tbf(bts_, ms, GPRS_RLCMAC_DL_TBF),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200175 m_tx_counter(0),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200176 m_dl_ack_requested(false),
Pau Espin Pedrola89008b2021-03-02 13:07:05 +0100177 m_last_dl_poll_fn(-1),
178 m_last_dl_drained_fn(-1),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200179 m_dl_gprs_ctrs(NULL),
180 m_dl_egprs_ctrs(NULL)
181{
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100182 memset(&state_fsm, 0, sizeof(state_fsm));
Pau Espin Pedrol83a08922022-12-12 19:46:01 +0100183 state_fsm.dl_tbf = this;
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100184 state_fi = osmo_fsm_inst_alloc(&tbf_dl_fsm, this, &state_fsm, LOGL_INFO, NULL);
185 OSMO_ASSERT(state_fi);
Pau Espin Pedrol759724c2023-04-19 18:36:40 +0200186
187 /* This has to be called in child constructor because enable_egprs()
188 * uses the window() virtual function which is dependent on subclass. */
189 if (ms_mode(m_ms) != GPRS)
190 enable_egprs();
Daniel Willmannca102af2014-08-08 12:14:12 +0200191}
192
Daniel Willmannca102af2014-08-08 12:14:12 +0200193/**
194 * TODO: split into unit test-able parts...
195 */
Pau Espin Pedrol8a35e642021-01-18 17:14:14 +0100196int dl_tbf_handle(struct gprs_rlcmac_bts *bts,
197 const uint32_t tlli, const uint32_t tlli_old, const char *imsi,
198 uint8_t ms_class, uint8_t egprs_ms_class,
199 const uint16_t delay_csec,
200 const uint8_t *data, const uint16_t len)
Daniel Willmannca102af2014-08-08 12:14:12 +0200201{
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200202 int rc;
Jacob Erlbeckac289052015-08-14 12:50:54 +0200203 GprsMs *ms, *ms_old;
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200204 bool ms_allocated = false;
Daniel Willmannca102af2014-08-08 12:14:12 +0200205
206 /* check for existing TBF */
Pau Espin Pedroleb0a0522023-04-17 16:33:35 +0200207 ms = bts_get_ms(bts, tlli, tlli_old, imsi);
Jacob Erlbecka47aaa42016-01-07 16:47:34 +0100208
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100209 /* If we got MS by TLLI above let's see if we already have another MS
210 * object identified by IMSI and merge them */
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200211 if (ms) {
212 if (!ms_imsi_is_valid(ms) && imsi) {
213 ms_old = bts_get_ms_by_imsi(bts, imsi);
214 if (ms_old && ms_old != ms) {
215 /* The TLLI has changed (RAU), so there are two MS
216 * objects for the same MS */
217 LOGP(DTBF, LOGL_NOTICE,
218 "There is a new MS object for the same MS: (0x%08x, '%s') -> (0x%08x, '%s')\n",
219 ms_tlli(ms_old), ms_imsi(ms_old), ms_tlli(ms), ms_imsi(ms));
220 ms_merge_and_clear_ms(ms, ms_old);
221 /* old_ms may no longer be available here */
222 }
Jacob Erlbeckac289052015-08-14 12:50:54 +0200223 }
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200224 } else {
225 ms = ms_alloc(bts, __func__);
226 /* Remember we have to unref the alloc reference at the end: */
227 ms_allocated = true;
Jacob Erlbeckac289052015-08-14 12:50:54 +0200228 }
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100229 if (imsi)
230 ms_set_imsi(ms, imsi);
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100231 ms_confirm_tlli(ms, tlli);
232 if (!ms_ms_class(ms) && ms_class) {
233 ms_set_ms_class(ms, ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100234 }
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100235 if (!ms_egprs_ms_class(ms) && egprs_ms_class) {
236 ms_set_egprs_ms_class(ms, egprs_ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100237 }
Pau Espin Pedrol528820d2020-10-26 12:40:11 +0100238
Pau Espin Pedrol14beef62022-10-26 19:44:07 +0200239 rc = ms_append_llc_dl_data(ms, delay_csec, data, len);
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200240 if (ms_allocated) {
241 ms_unref(ms, __func__);
242 /* Here "ms" may be freed if ms_append_llc_dl_data() failed to
243 * allocate a DL TBF and it has no more TBFs attached */
244 }
245 return rc;
Daniel Willmannca102af2014-08-08 12:14:12 +0200246}
247
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100248bool gprs_rlcmac_dl_tbf::restart_bsn_cycle()
Daniel Willmannca102af2014-08-08 12:14:12 +0200249{
Jacob Erlbeck95340242015-03-19 13:22:07 +0100250 /* If V(S) == V(A) and finished state, we would have received
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100251 * acknowledgement of all transmitted block. In this case we would
252 * have transmitted the final block, and received ack from MS. But in
253 * this case we did not receive the final ack indication from MS. This
254 * should never happen if MS works correctly.
255 */
Jacob Erlbeck95340242015-03-19 13:22:07 +0100256 if (m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +0100257 LOGPTBFDL(this, LOGL_DEBUG, "MS acked all blocks\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100258 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100259 }
260
261 /* cycle through all unacked blocks */
262 int resend = m_window.mark_for_resend();
263
264 /* At this point there should be at least one unacked block
265 * to be resent. If not, this is an software error. */
266 if (resend == 0) {
Max0524e382018-01-19 18:22:25 +0100267 LOGPTBFDL(this, LOGL_ERROR,
268 "FIXME: Software error: There are no unacknowledged blocks, but V(A) != V(S). PLEASE FIX!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100269 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100270 }
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100271
272 return true;
273}
274
275int gprs_rlcmac_dl_tbf::take_next_bsn(uint32_t fn,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100276 int previous_bsn, enum mcs_kind req_mcs_kind, bool *may_combine)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100277{
278 int bsn;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100279 int data_len2, force_data_len = -1;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100280 enum CodingScheme tx_cs;
281
282 /* Scheduler may be fine with sending any kind of data, but if
283 the selected TBF is GPRS-only, then let's filter out EGPRS
284 here */
285 if (!is_egprs_enabled())
286 req_mcs_kind = GPRS;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100287
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200288 /* search for a nacked or resend marked bsn */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100289 bsn = m_window.resend_needed();
290
291 if (previous_bsn >= 0) {
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100292 tx_cs = m_rlc.block(previous_bsn)->cs_current_trans;
293 if (!mcs_is_edge(tx_cs))
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100294 return -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100295 force_data_len = m_rlc.block(previous_bsn)->len;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100296 } else {
297 tx_cs = ms_current_cs_dl(ms(), req_mcs_kind);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100298 }
299
300 if (bsn >= 0) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200301 /* resend an unacked bsn or resend bsn. */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100302 if (previous_bsn == bsn)
303 return -1;
304
305 if (previous_bsn >= 0 &&
306 m_window.mod_sns(bsn - previous_bsn) > RLC_EGPRS_MAX_BSN_DELTA)
307 return -1;
308
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530309 if (is_egprs_enabled()) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530310 /* Table 8.1.1.2 and Table 8.1.1.1 of 44.060 */
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100311 m_rlc.block(bsn)->cs_current_trans = get_retx_mcs(m_rlc.block(bsn)->cs_init, tx_cs,
Pau Espin Pedrol97296b22021-01-14 13:08:02 +0100312 bts->pcu->vty.dl_arq_type == EGPRS_ARQ1);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530313
Max0524e382018-01-19 18:22:25 +0100314 LOGPTBFDL(this, LOGL_DEBUG,
Maxa0353542019-03-06 18:03:58 +0100315 "initial_cs_dl(%s) last_mcs(%s) demanded_mcs(%s) cs_trans(%s) arq_type(%d) bsn(%d)\n",
316 mcs_name(m_rlc.block(bsn)->cs_init),
317 mcs_name(m_rlc.block(bsn)->cs_last),
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100318 mcs_name(tx_cs),
Maxa0353542019-03-06 18:03:58 +0100319 mcs_name(m_rlc.block(bsn)->cs_current_trans),
Pau Espin Pedrol97296b22021-01-14 13:08:02 +0100320 the_pcu->vty.dl_arq_type, bsn);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530321
322 /* TODO: Need to remove this check when MCS-8 -> MCS-6
323 * transistion is handled.
324 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
325 */
Maxbea2edb2019-03-06 17:04:59 +0100326 if (m_rlc.block(bsn)->cs_init == MCS8)
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530327 m_rlc.block(bsn)->cs_current_trans =
Maxbea2edb2019-03-06 17:04:59 +0100328 MCS8;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200329 } else {
330 /* gprs */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530331 m_rlc.block(bsn)->cs_current_trans =
332 m_rlc.block(bsn)->cs_last;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200333 }
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530334
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100335 data_len2 = m_rlc.block(bsn)->len;
336 if (force_data_len > 0 && force_data_len != data_len2)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100337 return -1;
Max0524e382018-01-19 18:22:25 +0100338 LOGPTBFDL(this, LOGL_DEBUG, "Resending BSN %d\n", bsn);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100339 /* re-send block with negative aknowlegement */
340 m_window.m_v_b.mark_unacked(bsn);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100341 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +0200342 } else if (state_is(TBF_ST_FINISHED)) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200343 /* If the TBF is in finished, we already sent all packages at least once.
344 * If any packages could have been sent (because of unacked) it should have
345 * been catched up by the upper if(bsn >= 0) */
Max0524e382018-01-19 18:22:25 +0100346 LOGPTBFDL(this, LOGL_DEBUG,
347 "Restarting at BSN %d, because all blocks have been transmitted.\n",
348 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100349 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100350 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100351 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100352 } else if (dl_window_stalled()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200353 /* There are no more packages to send, but the window is stalled.
354 * Restart the bsn_cycle to resend all unacked messages */
Max0524e382018-01-19 18:22:25 +0100355 LOGPTBFDL(this, LOGL_NOTICE,
356 "Restarting at BSN %d, because the window is stalled.\n",
357 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100358 bts_do_rate_ctr_inc(bts, CTR_RLC_STALLED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100359 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100360 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100361 } else if (have_data()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200362 /* The window has space left, generate new bsn */
Max0524e382018-01-19 18:22:25 +0100363 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100364 "Sending new block at BSN %d, CS=%s%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100365 m_window.v_s(), mcs_name(tx_cs),
366 force_data_len != -1 ? " (forced)" : "");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100367
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100368 bsn = create_new_bsn(fn, tx_cs);
Pau Espin Pedrol05f9f592021-01-14 12:56:58 +0100369 } else if (bts->pcu->vty.dl_tbf_preemptive_retransmission && !m_window.window_empty()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200370 /* The window contains unacked packages, but not acked.
371 * Mark unacked bsns as RESEND */
Max0524e382018-01-19 18:22:25 +0100372 LOGPTBFDL(this, LOGL_DEBUG,
373 "Restarting at BSN %d, because all blocks have been transmitted (FLOW).\n",
374 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100375 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100376 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100377 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100378 } else {
379 /* Nothing left to send, create dummy LLC commands */
Max0524e382018-01-19 18:22:25 +0100380 LOGPTBFDL(this, LOGL_DEBUG,
381 "Sending new dummy block at BSN %d, CS=%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100382 m_window.v_s(), mcs_name(tx_cs));
383 bsn = create_new_bsn(fn, tx_cs);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530384 /* Don't send a second block, so don't set cs_current_trans */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100385 }
386
387 if (bsn < 0) {
388 /* we just send final block again */
Max0524e382018-01-19 18:22:25 +0100389 LOGPTBFDL(this, LOGL_DEBUG,
390 "Nothing else to send, Re-transmit final block!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100391 bsn = m_window.v_s_mod(-1);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100392 bts_do_rate_ctr_inc(bts, CTR_RLC_FINAL_BLOCK_RESENT);
393 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100394 }
395
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200396 *may_combine = num_data_blocks(mcs_header_type(m_rlc.block(bsn)->cs_current_trans)) > 1;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100397
398 return bsn;
399}
400
401/*
402 * Create DL data block
403 * The messages are fragmented and forwarded as data blocks.
404 */
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100405struct msgb *gprs_rlcmac_dl_tbf::create_dl_acked_block(uint32_t fn, const struct gprs_rlcmac_pdch *pdch, enum mcs_kind req_mcs_kind)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100406{
407 int bsn, bsn2 = -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100408 bool may_combine;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100409
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100410 LOGPTBFDL(this, LOGL_DEBUG, "downlink (V(A)==%d .. V(S)==%d) mcs_mode_restrict=%s\n",
411 m_window.v_a(), m_window.v_s(), mode_name(req_mcs_kind));
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100412
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100413 bsn = take_next_bsn(fn, -1, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100414 if (bsn < 0)
415 return NULL;
416
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100417 if (may_combine)
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100418 bsn2 = take_next_bsn(fn, bsn, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100419
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100420 return create_dl_acked_block(fn, pdch, bsn, bsn2);
Daniel Willmannca102af2014-08-08 12:14:12 +0200421}
422
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200423/* old_tbf (UL TBF or DL TBF) will send a Pkt Dl Ass on PACCH to assign tbf.
424 * Note: It is possible that "tbf == old_tbf" if the TBF is being updated. This can
425 * happen when we first assign over PCH (only single slot is possible) and we want
426 * to upgrade the DL-TBF to be multislot. See code calling tbf_update() for more
427 * information.
428 */
429void dl_tbf_trigger_ass_on_pacch(struct gprs_rlcmac_dl_tbf *tbf, struct gprs_rlcmac_tbf *old_tbf)
430{
431 OSMO_ASSERT(tbf);
432 OSMO_ASSERT(old_tbf);
433 /* stop pending timer */
434 tbf_stop_timers(tbf, "DL assignment (PACCH)");
435
436 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PACCH, because %s exists\n", old_tbf->name());
437 osmo_fsm_inst_dispatch(old_tbf->dl_ass_fsm.fi, TBF_DL_ASS_EV_SCHED_ASS, NULL);
438
439 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100440 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_PACCH, NULL);
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200441
442}
443
444void dl_tbf_trigger_ass_on_pch(struct gprs_rlcmac_dl_tbf *tbf)
Maxa10c3982017-07-07 18:25:41 +0200445{
446 /* stop pending timer */
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200447 struct GprsMs *ms = tbf_ms(tbf);
Maxa10c3982017-07-07 18:25:41 +0200448
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200449 tbf_stop_timers(tbf, "DL assignment (PCH)");
Maxa10c3982017-07-07 18:25:41 +0200450
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200451 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PCH, no TBF exist (IMSI=%s)\n", ms_imsi(ms));
Maxa10c3982017-07-07 18:25:41 +0200452
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200453 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100454 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_CCCH, NULL);
Maxa10c3982017-07-07 18:25:41 +0200455
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200456 /* send immediate assignment */
457 bts_snd_dl_ass(ms->bts, tbf);
Maxa10c3982017-07-07 18:25:41 +0200458}
459
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100460int dl_tbf_upgrade_to_multislot(struct gprs_rlcmac_dl_tbf *tbf)
461{
462 int rc;
463 struct gprs_rlcmac_trx *trx = tbf_get_trx(tbf);
464 struct gprs_rlcmac_bts *bts = trx->bts;
465
466 LOGPTBFDL(tbf, LOGL_DEBUG, "Upgrade to multislot\n");
467
468 tbf_unlink_pdch(tbf);
469 rc = the_pcu->alloc_algorithm(bts, dl_tbf_as_tbf(tbf), false, -1);
470 /* if no resource */
471 if (rc < 0) {
472 LOGPTBFDL(tbf, LOGL_ERROR, "No resources allocated during upgrade to multislot!\n");
473 bts_do_rate_ctr_inc(bts, CTR_TBF_ALLOC_FAIL);
474 return rc;
475 }
476
477 if (tbf_is_egprs_enabled(dl_tbf_as_tbf(tbf)))
478 tbf->set_window_size();
479 tbf_update_state_fsm_name(tbf);
480
Pau Espin Pedrol4a090542022-12-13 14:48:31 +0100481 /* Now trigger the assignment using the pre-existing TBF: */
482 dl_tbf_trigger_ass_on_pacch(tbf, dl_tbf_as_tbf(tbf));
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100483 return 0;
484}
485
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200486void gprs_rlcmac_dl_tbf::schedule_next_frame()
487{
488 struct msgb *msg;
489
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100490 if (llc_frame_length(&m_llc) != 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200491 return;
492
493 /* dequeue next LLC frame, if any */
Pau Espin Pedrol6b1e9512022-04-04 13:45:56 +0200494 msg = llc_queue_dequeue(llc_queue());
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200495 if (!msg)
496 return;
497
Max0fdaa9d2018-01-30 16:03:10 +0100498 LOGPTBFDL(this, LOGL_DEBUG, "Dequeue next LLC (len=%d)\n", msg->len);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200499
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200500 llc_put_frame(&m_llc, msg->data, msg->len);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100501 bts_do_rate_ctr_inc(bts, CTR_LLC_FRAME_SCHED);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200502 msgb_free(msg);
503 m_last_dl_drained_fn = -1;
504}
505
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200506int gprs_rlcmac_dl_tbf::create_new_bsn(const uint32_t fn, enum CodingScheme cs)
Daniel Willmannca102af2014-08-08 12:14:12 +0200507{
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100508 uint8_t *data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200509 gprs_rlc_data *rlc_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200510 const uint16_t bsn = m_window.v_s();
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100511 gprs_rlc_data_block_info *rdbi;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100512 int num_chunks = 0;
513 int write_offset = 0;
514 Encoding::AppendResult ar;
Daniel Willmannca102af2014-08-08 12:14:12 +0200515
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100516 if (llc_frame_length(&m_llc) == 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200517 schedule_next_frame();
518
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200519 OSMO_ASSERT(mcs_is_valid(cs));
Jacob Erlbecka700dd92015-06-02 16:00:41 +0200520
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100521 /* length of usable data block (single data unit w/o header) */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200522 const uint8_t block_data_len = mcs_max_data_block_bytes(cs);
Daniel Willmannca102af2014-08-08 12:14:12 +0200523
524 /* now we still have untransmitted LLC data, so we fill mac block */
525 rlc_data = m_rlc.block(bsn);
Pau Espin Pedrol5bb87b82020-05-18 11:02:39 +0200526 data = prepare(rlc_data, block_data_len);
Aravind Sirsikar91495522016-07-12 14:17:12 +0530527 rlc_data->cs_last = cs;
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530528 rlc_data->cs_current_trans = cs;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530529
530 /* Initialise the variable related to DL SPB */
531 rlc_data->spb_status.block_status_dl = EGPRS_RESEG_DL_DEFAULT;
532 rlc_data->cs_init = cs;
533
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100534 rlc_data->len = block_data_len;
Daniel Willmannca102af2014-08-08 12:14:12 +0200535
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100536 rdbi = &(rlc_data->block_info);
537 memset(rdbi, 0, sizeof(*rdbi));
538 rdbi->data_len = block_data_len;
539
540 rdbi->cv = 15; /* Final Block Indicator, set late, if true */
541 rdbi->bsn = bsn; /* Block Sequence Number */
542 rdbi->e = 1; /* Extension bit, maybe set later (1: no extension) */
543
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100544 do {
545 bool is_final;
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200546 int payload_written = 0;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100547
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100548 if (llc_frame_length(&m_llc) == 0) {
Pau Espin Pedrol8afc6ba2021-03-02 13:19:39 +0100549 /* The data just drained, store the current fn */
550 if (m_last_dl_drained_fn < 0)
551 m_last_dl_drained_fn = fn;
552
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100553 /* It is not clear, when the next real data will
554 * arrive, so request a DL ack/nack now */
555 request_dl_ack();
Alexander Couzens1a506612016-05-24 16:55:30 +0200556
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100557 int space = block_data_len - write_offset;
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100558
559 if (num_chunks != 0) {
560 /* Nothing to send, and we already put some data in
561 * rlcmac data block, we are done */
562 LOGPTBFDL(this, LOGL_DEBUG,
563 "LLC queue completely drained and there's "
564 "still %d free bytes in rlcmac data block\n", space);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100565
566 /* We may need to update fbi in header here
567 * since m_last_dl_drained_fn was updated above
568 * Specially important when X2031 is 0. */
569 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
570 if (is_final) {
571 rdbi->cv = 0;
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100572 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100573 }
574
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100575 if (mcs_is_edge(cs)) {
576 /* in EGPRS there's no M bit, so we need
577 * to flag padding with LI=127 */
578 Encoding::rlc_data_to_dl_append_egprs_li_padding(rdbi,
579 &write_offset,
580 &num_chunks,
581 data);
582 }
583 break;
584 }
585
586 /* Nothing to send from upper layers (LLC), but still
587 * requested to send something to MS to delay the
588 * release of the TBF. See 3GPP TS 44.060 9.3.1a
589 * "Delayed release of downlink Temporary Block Flow" */
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100590 /* A header will need to by added, so we just need
591 * space-1 octets */
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200592 llc_put_dummy_frame(&m_llc, space - 1);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100593
Max0524e382018-01-19 18:22:25 +0100594 LOGPTBFDL(this, LOGL_DEBUG,
595 "Empty chunk, added LLC dummy command of size %d, drained_since=%d\n",
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100596 llc_frame_length(&m_llc), frames_since_last_drain(fn));
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100597 }
598
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100599 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100600
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100601 ar = Encoding::rlc_data_to_dl_append(rdbi, cs,
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200602 &m_llc, &write_offset, &num_chunks, data, is_final, &payload_written);
603
604 if (payload_written > 0)
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100605 bts_do_rate_ctr_add(bts, CTR_RLC_DL_PAYLOAD_BYTES, payload_written);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100606
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100607 if (ar == Encoding::AR_NEED_MORE_BLOCKS)
608 break;
609
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100610 LOGPTBFDL(this, LOGL_DEBUG, "Complete DL frame, len=%d\n", llc_frame_length(&m_llc));
611 gprs_rlcmac_dl_bw(this, llc_frame_length(&m_llc));
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100612 bts_do_rate_ctr_add(bts, CTR_LLC_DL_BYTES, llc_frame_length(&m_llc));
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200613 llc_reset(&m_llc);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100614
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100615 if (is_final) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100616 request_dl_ack();
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100617 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Daniel Willmannca102af2014-08-08 12:14:12 +0200618 }
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100619
620 /* dequeue next LLC frame, if any */
621 schedule_next_frame();
622 } while (ar == Encoding::AR_COMPLETED_SPACE_LEFT);
623
Max0524e382018-01-19 18:22:25 +0100624 LOGPTBFDL(this, LOGL_DEBUG, "data block (BSN %d, %s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100625 bsn, mcs_name(rlc_data->cs_last),
Max0524e382018-01-19 18:22:25 +0100626 osmo_hexdump(rlc_data->block, block_data_len));
Daniel Willmannca102af2014-08-08 12:14:12 +0200627 /* raise send state and set ack state array */
628 m_window.m_v_b.mark_unacked(bsn);
629 m_window.increment_send();
630
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100631 return bsn;
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100632}
633
Daniel Willmannca102af2014-08-08 12:14:12 +0200634struct msgb *gprs_rlcmac_dl_tbf::create_dl_acked_block(
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100635 const uint32_t fn, const struct gprs_rlcmac_pdch *pdch,
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100636 int index, int index2)
Daniel Willmannca102af2014-08-08 12:14:12 +0200637{
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100638 uint8_t *msg_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200639 struct msgb *dl_msg;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100640 unsigned msg_len;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100641 /* TODO: support MCS-7 - MCS-9, where data_block_idx can be 1 */
Maxb3a17d62017-12-21 12:11:33 +0100642 uint8_t data_block_idx = 0;
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100643 unsigned int rrbp;
644 uint32_t new_poll_fn;
645 int rc;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100646 bool is_final = false;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100647 gprs_rlc_data_info rlc;
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200648 enum CodingScheme cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100649 int bsns[ARRAY_SIZE(rlc.block_info)];
650 unsigned num_bsns;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100651 bool need_padding = false;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530652 enum egprs_rlcmac_dl_spb spb = EGPRS_RLCMAC_DL_NO_RETX;
653 unsigned int spb_status = get_egprs_dl_spb_status(index);
Neels Hofmeyrb6091902017-02-08 16:49:20 +0100654
655 enum egprs_puncturing_values punct[2] = {
656 EGPRS_PS_INVALID, EGPRS_PS_INVALID
657 };
658 osmo_static_assert(ARRAY_SIZE(rlc.block_info) == 2,
659 rlc_block_info_size_is_two);
660
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100661 /*
662 * TODO: This is an experimental work-around to put 2 BSN into
663 * MSC-7 to MCS-9 encoded messages. It just sends the same BSN
664 * twice in the block. The cs should be derived from the TBF's
665 * current CS such that both BSNs (that must be compatible) can
666 * be put into the data area, even if the resulting CS is higher than
667 * the current limit.
668 */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530669 cs = m_rlc.block(index)->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +0100670 enum CodingScheme cs_init = m_rlc.block(index)->cs_init;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100671 bsns[0] = index;
672 num_bsns = 1;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100673
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100674 if (index2 >= 0) {
675 bsns[num_bsns] = index2;
676 num_bsns += 1;
677 }
678
Mrinal Mishraf86307e2016-11-10 18:16:30 +0530679 update_coding_scheme_counter_dl(cs);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530680 /*
681 * if the intial mcs is 8 and retransmission mcs is either 6 or 3
682 * we have to include the padding of 6 octets in first segment
683 */
Maxd4a39292019-03-13 18:44:20 +0100684 if ((cs_init == MCS8) &&
685 (cs == MCS6 || cs == MCS3)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530686 if (spb_status == EGPRS_RESEG_DL_DEFAULT ||
Maxd4a39292019-03-13 18:44:20 +0100687 spb_status == EGPRS_RESEG_SECOND_SEG_SENT)
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530688 need_padding = true;
689 } else if (num_bsns == 1) {
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100690 /* TODO: remove the conditional when MCS-6 padding isn't
691 * failing to be decoded by MEs anymore */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530692 /* TODO: support of MCS-8 -> MCS-6 transition should be
693 * handled
694 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
695 * dated 2016-02-07 23:45:40 (UTC)
696 */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200697 if (cs != MCS8)
698 mcs_dec_to_single_block(&cs, &need_padding);
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100699 }
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100700
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530701 spb = get_egprs_dl_spb(index);
702
Max0524e382018-01-19 18:22:25 +0100703 LOGPTBFDL(this, LOGL_DEBUG, "need_padding %d spb_status %d spb %d (BSN1 %d BSN2 %d)\n",
704 need_padding, spb_status, spb, index, index2);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530705
706 gprs_rlc_data_info_init_dl(&rlc, cs, need_padding, spb);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100707
708 rlc.usf = 7; /* will be set at scheduler */
709 rlc.pr = 0; /* FIXME: power reduction */
710 rlc.tfi = m_tfi; /* TFI */
711
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100712 /* return data block(s) as message */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200713 msg_len = mcs_size_dl(cs);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100714 dl_msg = msgb_alloc(msg_len, "rlcmac_dl_data");
715 if (!dl_msg)
716 return NULL;
717
718 msg_data = msgb_put(dl_msg, msg_len);
719
Aravind Sirsikarb1191982016-08-26 18:13:10 +0530720 OSMO_ASSERT(rlc.num_data_blocks <= ARRAY_SIZE(rlc.block_info));
721 OSMO_ASSERT(rlc.num_data_blocks > 0);
722
Max0524e382018-01-19 18:22:25 +0100723 LOGPTBFDL(this, LOGL_DEBUG, "Copying %u RLC blocks, %u BSNs\n", rlc.num_data_blocks, num_bsns);
Max5759a192017-09-08 12:23:12 +0200724
Maxb3a17d62017-12-21 12:11:33 +0100725 /* Copy block(s) to RLC message: the num_data_blocks cannot be more than 2 - see assert above */
726 for (data_block_idx = 0; data_block_idx < OSMO_MIN(rlc.num_data_blocks, 2);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100727 data_block_idx++)
728 {
729 int bsn;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100730 uint8_t *block_data;
731 gprs_rlc_data_block_info *rdbi, *block_info;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530732 enum egprs_rlc_dl_reseg_bsn_state reseg_status;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100733
734 /* Check if there are more blocks than BSNs */
735 if (data_block_idx < num_bsns)
736 bsn = bsns[data_block_idx];
737 else
738 bsn = bsns[0];
739
Aravind Sirsikar79522822016-03-23 18:29:47 +0530740 /* Get current puncturing scheme from block */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530741
742 m_rlc.block(bsn)->next_ps = gprs_get_punct_scheme(
Aravind Sirsikar79522822016-03-23 18:29:47 +0530743 m_rlc.block(bsn)->next_ps,
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530744 m_rlc.block(bsn)->cs_last, cs, spb);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530745
Max8a8e0fb2019-03-25 16:32:50 +0100746 if (mcs_is_edge(cs)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530747 OSMO_ASSERT(m_rlc.block(bsn)->next_ps >= EGPRS_PS_1);
748 OSMO_ASSERT(m_rlc.block(bsn)->next_ps <= EGPRS_PS_3);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530749 }
Maxb3a17d62017-12-21 12:11:33 +0100750
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530751 punct[data_block_idx] = m_rlc.block(bsn)->next_ps;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100752
753 rdbi = &rlc.block_info[data_block_idx];
754 block_info = &m_rlc.block(bsn)->block_info;
755
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530756 /*
757 * get data and header from current block
758 * function returns the reseg status
Aravind Sirsikar79522822016-03-23 18:29:47 +0530759 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530760 reseg_status = egprs_dl_get_data(bsn, &block_data);
761 m_rlc.block(bsn)->spb_status.block_status_dl = reseg_status;
762
763 /*
764 * If it is first segment of the split block set the state of
765 * bsn to nacked. If it is the first segment dont update the
766 * next ps value of bsn. since next segment also needs same cps
767 */
768 if (spb == EGPRS_RLCMAC_DL_FIRST_SEG)
769 m_window.m_v_b.mark_nacked(bsn);
770 else {
771 /*
772 * TODO: Need to handle 2 same bsns
773 * in header type 1
774 */
775 gprs_update_punct_scheme(&m_rlc.block(bsn)->next_ps,
776 cs);
777 }
Aravind Sirsikar79522822016-03-23 18:29:47 +0530778
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530779 m_rlc.block(bsn)->cs_last = cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100780 rdbi->e = block_info->e;
781 rdbi->cv = block_info->cv;
782 rdbi->bsn = bsn;
783 is_final = is_final || rdbi->cv == 0;
784
Max0524e382018-01-19 18:22:25 +0100785 LOGPTBFDL(this, LOGL_DEBUG, "Copying data unit %d (BSN %d)\n",
786 data_block_idx, bsn);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100787
788 Encoding::rlc_copy_from_aligned_buffer(&rlc, data_block_idx,
789 msg_data, block_data);
790 }
791
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100792 /* Calculate CPS only for EGPRS case */
Max8a8e0fb2019-03-25 16:32:50 +0100793 if (mcs_is_edge(cs))
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100794 rlc.cps = gprs_rlc_mcs_cps(cs, punct[0], punct[1], need_padding);
Daniel Willmannca102af2014-08-08 12:14:12 +0200795
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100796 /* If the TBF has just started, relate frames_since_last_poll to the
797 * current fn */
798 if (m_last_dl_poll_fn < 0)
799 m_last_dl_poll_fn = fn;
800
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200801 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
Pau Espin Pedrol6d8315f2023-04-19 20:05:01 +0200802 * when last polled DL ACK/NACK was lost. Always do so in the control TS. */
803 if (tbf_is_control_ts(dl_tbf_as_tbf(this), pdch) &&
804 need_poll_for_dl_ack_nack()) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100805 if (m_dl_ack_requested) {
Max0524e382018-01-19 18:22:25 +0100806 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol30f66172019-12-04 18:07:49 +0100807 "Scheduling Ack/Nack polling, because it was requested explicitly "
Max0524e382018-01-19 18:22:25 +0100808 "(e.g. first final block sent).\n");
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200809 } else if (state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK)) {
Max0524e382018-01-19 18:22:25 +0100810 LOGPTBFDL(this, LOGL_DEBUG,
811 "Scheduling Ack/Nack polling, because polling timed out.\n");
Daniel Willmannca102af2014-08-08 12:14:12 +0200812 } else {
Max0524e382018-01-19 18:22:25 +0100813 LOGPTBFDL(this, LOGL_DEBUG,
814 "Scheduling Ack/Nack polling, because %d blocks sent.\n",
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200815 POLL_ACK_AFTER_FRAMES);
Daniel Willmannca102af2014-08-08 12:14:12 +0200816 }
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100817
Pau Espin Pedrolfd74e792022-12-15 18:23:12 +0100818 rc = tbf_check_polling(this, pdch, fn, &new_poll_fn, &rrbp);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100819 if (rc >= 0) {
Pau Espin Pedrol5b7eeec2022-12-15 19:08:13 +0100820 tbf_set_polling(this, pdch, new_poll_fn, PDCH_ULC_POLL_DL_ACK);
Pau Espin Pedrola161bf42021-07-30 13:42:06 +0200821 LOGPTBFDL(this, LOGL_DEBUG,
822 "Scheduled DL Acknowledgement polling on PACCH (FN=%d, TS=%d)\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100823 new_poll_fn, pdch->ts_no);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100824
Daniel Willmannca102af2014-08-08 12:14:12 +0200825 m_tx_counter = 0;
826 /* start timer whenever we send the final block */
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100827 if (is_final)
Pau Espin Pedrol28f160e2019-09-05 14:48:35 +0200828 T_START(this, T3191, 3191, "final block (DL-TBF)", true);
Daniel Willmannca102af2014-08-08 12:14:12 +0200829
Pau Espin Pedrol33e80072021-07-22 19:20:50 +0200830 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK); /* clear poll timeout flag */
Daniel Willmannefd5dbb2014-08-25 16:20:23 +0200831
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100832 /* Clear request flag */
833 m_dl_ack_requested = false;
834
Daniel Willmannca102af2014-08-08 12:14:12 +0200835 /* set polling in header */
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100836 rlc.rrbp = rrbp;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100837 rlc.es_p = 1; /* Polling */
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100838
Pau Espin Pedrol58046e42021-03-29 19:01:13 +0200839 m_last_dl_poll_fn = new_poll_fn;
Jacob Erlbeck16d29c72015-08-24 13:30:39 +0200840
Max0524e382018-01-19 18:22:25 +0100841 LOGPTBFDL(this, LOGL_INFO,
842 "Scheduled Ack/Nack polling on FN=%d, TS=%d\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100843 new_poll_fn, pdch->ts_no);
Daniel Willmannca102af2014-08-08 12:14:12 +0200844 }
845 }
846
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100847 Encoding::rlc_write_dl_data_header(&rlc, msg_data);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100848
Max0524e382018-01-19 18:22:25 +0100849 LOGPTBFDL(this, LOGL_DEBUG, "msg block (BSN %d, %s%s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100850 index, mcs_name(cs),
Max0524e382018-01-19 18:22:25 +0100851 need_padding ? ", padded" : "",
852 msgb_hexdump(dl_msg));
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100853
Daniel Willmannca102af2014-08-08 12:14:12 +0200854 /* Increment TX-counter */
855 m_tx_counter++;
856
Daniel Willmannca102af2014-08-08 12:14:12 +0200857 return dl_msg;
858}
859
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100860static uint16_t bitnum_to_bsn(int bitnum, uint16_t ssn)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200861{
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100862 return ssn - 1 - bitnum;
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200863}
864
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200865int gprs_rlcmac_dl_tbf::analyse_errors(char *show_rbb, uint8_t ssn,
866 ana_result *res)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200867{
868 gprs_rlc_data *rlc_data;
869 uint16_t lost = 0, received = 0, skipped = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100870 char info[RLC_MAX_WS + 1];
871 memset(info, '.', m_window.ws());
872 info[m_window.ws()] = 0;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200873 uint16_t bsn = 0;
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200874 unsigned received_bytes = 0, lost_bytes = 0;
875 unsigned received_packets = 0, lost_packets = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100876 unsigned num_blocks = strlen(show_rbb);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200877
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530878 unsigned distance = m_window.distance();
879
880 num_blocks = num_blocks > distance
881 ? distance : num_blocks;
882
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200883 /* SSN - 1 is in range V(A)..V(S)-1 */
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100884 for (unsigned int bitpos = 0; bitpos < num_blocks; bitpos++) {
885 bool is_received;
886 int index = num_blocks - 1 - bitpos;
887
888 is_received = (index >= 0 && show_rbb[index] == 'R');
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200889
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100890 bsn = m_window.mod_sns(bitnum_to_bsn(bitpos, ssn));
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200891
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100892 if (bsn == m_window.mod_sns(m_window.v_a() - 1)) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200893 info[bitpos] = '$';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200894 break;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200895 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200896
897 rlc_data = m_rlc.block(bsn);
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200898 if (!rlc_data) {
899 info[bitpos] = '0';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200900 continue;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200901 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200902
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200903 /* Get general statistics */
904 if (is_received && !m_window.m_v_b.is_acked(bsn)) {
905 received_packets += 1;
906 received_bytes += rlc_data->len;
907 } else if (!is_received && !m_window.m_v_b.is_nacked(bsn)) {
908 lost_packets += 1;
909 lost_bytes += rlc_data->len;
910 }
911
912 /* Get statistics for current CS */
913
Aravind Sirsikar91495522016-07-12 14:17:12 +0530914 if (rlc_data->cs_last != current_cs()) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200915 /* This block has already been encoded with a different
916 * CS, so it doesn't help us to decide, whether the
917 * current CS is ok. Ignore it. */
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200918 info[bitpos] = 'x';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200919 skipped += 1;
920 continue;
921 }
922
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200923 if (is_received) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200924 if (!m_window.m_v_b.is_acked(bsn)) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200925 received += 1;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200926 info[bitpos] = 'R';
927 } else {
928 info[bitpos] = 'r';
929 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200930 } else {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200931 info[bitpos] = 'L';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200932 lost += 1;
933 }
934 }
935
Max0524e382018-01-19 18:22:25 +0100936 LOGPTBFDL(this, LOGL_DEBUG,
937 "DL analysis, range=%d:%d, lost=%d, recv=%d, skipped=%d, bsn=%d, info='%s'\n",
938 m_window.v_a(), m_window.v_s(), lost, received, skipped, bsn, info);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200939
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200940 res->received_packets = received_packets;
941 res->lost_packets = lost_packets;
942 res->received_bytes = received_bytes;
943 res->lost_bytes = lost_bytes;
944
Jacob Erlbeck144a1d02015-06-04 16:51:44 +0200945 if (lost + received <= 1)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200946 return -1;
947
948 return lost * 100 / (lost + received);
949}
950
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +0200951gprs_rlc_window *gprs_rlcmac_dl_tbf::window()
Maxea98b7d2018-01-04 15:13:27 +0100952{
953 return &m_window;
954}
955
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100956int gprs_rlcmac_dl_tbf::update_window(unsigned first_bsn,
957 const struct bitvec *rbb)
958{
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530959 unsigned dist;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100960 uint16_t lost = 0, received = 0;
961 char show_v_b[RLC_MAX_SNS + 1];
962 char show_rbb[RLC_MAX_SNS + 1];
963 int error_rate;
964 struct ana_result ana_res;
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530965 dist = m_window.distance();
966 unsigned num_blocks = rbb->cur_bit > dist
967 ? dist : rbb->cur_bit;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100968 unsigned behind_last_bsn = m_window.mod_sns(first_bsn + num_blocks);
969
970 Decoding::extract_rbb(rbb, show_rbb);
971 /* show received array in debug */
Max0524e382018-01-19 18:22:25 +0100972 LOGPTBFDL(this, LOGL_DEBUG,
973 "ack: (BSN=%d)\"%s\"(BSN=%d) R=ACK I=NACK\n",
974 first_bsn, show_rbb, m_window.mod_sns(behind_last_bsn - 1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100975
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100976 error_rate = analyse_errors(show_rbb, behind_last_bsn, &ana_res);
977
Pau Espin Pedrole8dcf642021-01-14 13:17:01 +0100978 if (the_pcu->vty.cs_adj_enabled && ms())
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100979 ms_update_error_rate(ms(), this, error_rate);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100980
981 m_window.update(bts, rbb, first_bsn, &lost, &received);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +0200982 rate_ctr_add(rate_ctr_group_get_ctr(m_ctrs, TBF_CTR_RLC_NACKED), lost);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100983
984 /* report lost and received packets */
985 gprs_rlcmac_received_lost(this, received, lost);
986
987 /* Used to measure the leak rate */
988 gprs_bssgp_update_bytes_received(ana_res.received_bytes,
989 ana_res.received_packets + ana_res.lost_packets);
990
991 /* raise V(A), if possible */
992 m_window.raise(m_window.move_window());
993
994 /* show receive state array in debug (V(A)..V(S)-1) */
995 m_window.show_state(show_v_b);
Max0524e382018-01-19 18:22:25 +0100996 LOGPTBFDL(this, LOGL_DEBUG,
997 "V(B): (V(A)=%d)\"%s\"(V(S)-1=%d) A=Acked N=Nacked U=Unacked X=Resend-Unacked I=Invalid\n",
998 m_window.v_a(), show_v_b, m_window.v_s_mod(-1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100999 return 0;
1000}
Jacob Erlbeck1751c622015-06-04 12:12:32 +02001001
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +02001002int gprs_rlcmac_dl_tbf::rcvd_dl_final_ack()
Daniel Willmannca102af2014-08-08 12:14:12 +02001003{
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001004 uint16_t received;
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001005 int rc = 0;
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001006
Pau Espin Pedrolf197f152022-11-17 20:18:46 +01001007 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_FINAL_ACK_RECVD, NULL);
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001008
1009 /* range V(A)..V(S)-1 */
1010 received = m_window.count_unacked();
1011 /* report all outstanding packets as received */
1012 gprs_rlcmac_received_lost(this, received, 0);
1013 m_tx_counter = 0;
1014 m_window.reset();
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001015
1016 /* check for LLC PDU in the LLC Queue */
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001017 if (llc_queue_size(llc_queue()) > 0)
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001018 /* we have more data so we will re-use this tbf */
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001019 rc = ms_new_dl_tbf_assigned_on_pacch(ms(), dl_tbf_as_tbf(this));
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001020
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001021 return rc;
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001022}
1023
Max7df82d42017-12-15 11:14:30 +01001024int gprs_rlcmac_dl_tbf::rcvd_dl_ack(bool final_ack, unsigned first_bsn,
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001025 struct bitvec *rbb)
1026{
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001027 int rc;
Maxc21f0072017-12-15 17:36:45 +01001028 LOGPTBFDL(this, LOGL_DEBUG, "downlink acknowledge\n");
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001029
Pau Espin Pedrolfbc1baa2021-07-28 21:59:00 +02001030 state_fsm.state_flags |= (1 << GPRS_RLCMAC_FLAG_DL_ACK);
1031 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK);
1032
1033 /* reset N3105 */
1034 n_reset(N3105);
1035 t_stop(T3191, "ACK/NACK received");
1036
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001037 rc = update_window(first_bsn, rbb);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001038
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001039 if (final_ack) {
Max0524e382018-01-19 18:22:25 +01001040 LOGPTBFDL(this, LOGL_DEBUG, "Final ACK received.\n");
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +02001041 rc = rcvd_dl_final_ack();
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +02001042 } else if (state_is(TBF_ST_FINISHED) && m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +01001043 LOGPTBFDL(this, LOGL_NOTICE,
1044 "Received acknowledge of all blocks, but without final ack indication (don't worry)\n");
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001045 }
1046
1047 return rc;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001048}
1049
Daniel Willmannca102af2014-08-08 12:14:12 +02001050bool gprs_rlcmac_dl_tbf::dl_window_stalled() const
1051{
1052 return m_window.window_stalled();
1053}
1054
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001055void gprs_rlcmac_dl_tbf::request_dl_ack()
1056{
1057 m_dl_ack_requested = true;
1058}
1059
Pau Espin Pedrol8fa3e062022-10-28 17:38:52 +02001060void dl_tbf_request_dl_ack(struct gprs_rlcmac_dl_tbf *dl_tbf) {
Pau Espin Pedrol14beef62022-10-26 19:44:07 +02001061 dl_tbf->request_dl_ack();
1062}
1063
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001064/* Does this DL TBF require to poll the MS for DL ACK/NACK? */
1065bool gprs_rlcmac_dl_tbf::need_poll_for_dl_ack_nack() const
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001066{
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001067 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
1068 * when last polled DL ACK/NACK was lost. */
Pau Espin Pedrol33e80072021-07-22 19:20:50 +02001069 return state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK) ||
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001070 m_tx_counter >= POLL_ACK_AFTER_FRAMES ||
1071 m_dl_ack_requested;
1072}
1073
1074bool gprs_rlcmac_dl_tbf::have_data() const
1075{
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001076 return llc_chunk_size(&m_llc) > 0 ||
1077 (llc_queue_size(llc_queue()) > 0);
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001078}
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001079
Max9dabfa22017-05-16 16:10:45 +02001080static inline int frames_since_last(int32_t last, unsigned fn)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001081{
Max9dabfa22017-05-16 16:10:45 +02001082 unsigned wrapped = (fn + GSM_MAX_FN - last) % GSM_MAX_FN;
1083
1084 if (last < 0)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001085 return -1;
1086
Max9dabfa22017-05-16 16:10:45 +02001087 if (wrapped < GSM_MAX_FN/2)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001088 return wrapped;
Max9dabfa22017-05-16 16:10:45 +02001089
1090 return wrapped - GSM_MAX_FN;
1091}
1092
1093int gprs_rlcmac_dl_tbf::frames_since_last_poll(unsigned fn) const
1094{
1095 return frames_since_last(m_last_dl_poll_fn, fn);
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001096}
1097
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001098int gprs_rlcmac_dl_tbf::frames_since_last_drain(unsigned fn) const
1099{
Max9dabfa22017-05-16 16:10:45 +02001100 return frames_since_last(m_last_dl_drained_fn, fn);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001101}
1102
1103bool gprs_rlcmac_dl_tbf::keep_open(unsigned fn) const
1104{
1105 int keep_time_frames;
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001106 unsigned long dl_tbf_idle_msec;
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001107 int since_last_drain;
1108 bool keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001109
Pau Espin Pedrol924aaad2021-01-14 12:01:42 +01001110 dl_tbf_idle_msec = osmo_tdef_get(the_pcu->T_defs, -2031, OSMO_TDEF_MS, -1);
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001111 if (dl_tbf_idle_msec == 0)
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001112 return false;
1113
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001114 keep_time_frames = msecs_to_frames(dl_tbf_idle_msec);
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001115 since_last_drain = frames_since_last_drain(fn);
1116 keep = since_last_drain <= keep_time_frames;
1117
1118 if (since_last_drain >= 0)
1119 LOGPTBFDL(this, LOGL_DEBUG, "Keep idle TBF open: %d/%d -> %s\n",
1120 since_last_drain, keep_time_frames, keep ? "yes" : "no");
1121 return keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001122}
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301123
1124/*
1125 * This function returns the pointer to data which needs
1126 * to be copied. Also updates the status of the block related to
1127 * Split block handling in the RLC/MAC block.
1128 */
1129enum egprs_rlc_dl_reseg_bsn_state
1130 gprs_rlcmac_dl_tbf::egprs_dl_get_data(int bsn, uint8_t **block_data)
1131{
1132 gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1133 egprs_rlc_dl_reseg_bsn_state *block_status_dl =
1134 &rlc_data->spb_status.block_status_dl;
1135
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001136 enum CodingScheme cs_init = rlc_data->cs_init;
1137 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001138
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001139 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1140 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Maxd4a39292019-03-13 18:44:20 +01001141
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301142 *block_data = &rlc_data->block[0];
1143
1144 /*
1145 * Table 10.3a.0.1 of 44.060
1146 * MCS6,9: second segment starts at 74/2 = 37
1147 * MCS5,7: second segment starts at 56/2 = 28
1148 * MCS8: second segment starts at 31
1149 * MCS4: second segment starts at 44/2 = 22
1150 */
Maxd4a39292019-03-13 18:44:20 +01001151 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301152 if (*block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
Maxd4a39292019-03-13 18:44:20 +01001153 switch (cs_init) {
Maxbea2edb2019-03-06 17:04:59 +01001154 case MCS6 :
1155 case MCS9 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301156 *block_data = &rlc_data->block[37];
1157 break;
Maxbea2edb2019-03-06 17:04:59 +01001158 case MCS7 :
1159 case MCS5 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301160 *block_data = &rlc_data->block[28];
1161 break;
Maxbea2edb2019-03-06 17:04:59 +01001162 case MCS8 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301163 *block_data = &rlc_data->block[31];
1164 break;
Maxbea2edb2019-03-06 17:04:59 +01001165 case MCS4 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301166 *block_data = &rlc_data->block[22];
1167 break;
1168 default:
Max0524e382018-01-19 18:22:25 +01001169 LOGPTBFDL(this, LOGL_ERROR,
1170 "FIXME: Software error: hit invalid condition. "
1171 "headerType(%d) blockstatus(%d) cs(%s) PLEASE FIX!\n",
Maxd4a39292019-03-13 18:44:20 +01001172 ht_cs_current_trans,
Max136ebcc2019-03-05 14:59:03 +01001173 *block_status_dl, mcs_name(cs_init));
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301174 break;
1175
1176 }
1177 return EGPRS_RESEG_SECOND_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001178 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1179 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301180 return EGPRS_RESEG_FIRST_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001181 } else if ((cs_init == MCS4) &&
1182 (cs_current_trans == MCS1)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301183 return EGPRS_RESEG_FIRST_SEG_SENT;
1184 }
1185 }
1186 return EGPRS_RESEG_DL_DEFAULT;
1187}
1188
1189/*
1190 * This function returns the status of split block
1191 * for RLC/MAC block.
1192 */
1193unsigned int gprs_rlcmac_dl_tbf::get_egprs_dl_spb_status(const int bsn)
1194{
1195 const gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1196
1197 return rlc_data->spb_status.block_status_dl;
1198}
1199
1200/*
1201 * This function returns the spb value to be sent OTA
1202 * for RLC/MAC block.
1203 */
1204enum egprs_rlcmac_dl_spb gprs_rlcmac_dl_tbf::get_egprs_dl_spb(const int bsn)
1205{
1206 struct gprs_rlc_data *rlc_data = m_rlc.block(bsn);
Maxd4a39292019-03-13 18:44:20 +01001207 egprs_rlc_dl_reseg_bsn_state block_status_dl = rlc_data->spb_status.block_status_dl;
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301208
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001209 enum CodingScheme cs_init = rlc_data->cs_init;
1210 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001211
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001212 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1213 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301214
1215 /* Table 10.4.8b.1 of 44.060 */
Maxd4a39292019-03-13 18:44:20 +01001216 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
1217 /*
1218 * if we are sending the second segment the spb should be 3
1219 * otherwise it should be 2
1220 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301221 if (block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
sivasankarida7250a2016-12-16 12:57:18 +05301222 /* statistics */
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001223 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_SECOND_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301224 return EGPRS_RLCMAC_DL_SEC_SEG;
Maxd4a39292019-03-13 18:44:20 +01001225 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1226 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001227 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301228 return EGPRS_RLCMAC_DL_FIRST_SEG;
Maxd4a39292019-03-13 18:44:20 +01001229 } else if ((cs_init == MCS4) &&
1230 (cs_current_trans == MCS1)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001231 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301232 return EGPRS_RLCMAC_DL_FIRST_SEG;
1233 }
1234 }
1235 /* Non SPB cases 0 is reurned */
1236 return EGPRS_RLCMAC_DL_NO_RETX;
1237}
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301238
Max9d7357e2017-12-14 15:02:33 +01001239void gprs_rlcmac_dl_tbf::set_window_size()
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301240{
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001241 const struct gprs_rlcmac_bts *b = bts;
Max34513fe2018-12-11 16:47:30 +01001242 uint16_t ws = egprs_window_size(b, dl_slots());
1243
Max0524e382018-01-19 18:22:25 +01001244 LOGPTBFDL(this, LOGL_INFO, "setting EGPRS DL window size to %u, base(%u) slots(%u) ws_pdch(%u)\n",
Pau Espin Pedrol519d0712021-01-14 14:30:03 +01001245 ws, bts->pcu->vty.ws_base, pcu_bitcount(dl_slots()), bts->pcu->vty.ws_pdch);
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301246 m_window.set_ws(ws);
1247}
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301248
Maxfb59a932019-03-13 18:40:19 +01001249void gprs_rlcmac_dl_tbf::update_coding_scheme_counter_dl(enum CodingScheme cs)
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301250{
Maxfb59a932019-03-13 18:40:19 +01001251 switch (cs) {
1252 case CS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001253 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001254 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS1));
Maxfb59a932019-03-13 18:40:19 +01001255 break;
1256 case CS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001257 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001258 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS2));
Maxfb59a932019-03-13 18:40:19 +01001259 break;
1260 case CS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001261 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001262 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS3));
Maxfb59a932019-03-13 18:40:19 +01001263 break;
1264 case CS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001265 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS4);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001266 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS4));
Maxfb59a932019-03-13 18:40:19 +01001267 break;
1268 case MCS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001269 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001270 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS1));
Maxfb59a932019-03-13 18:40:19 +01001271 break;
1272 case MCS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001273 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001274 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS2));
Maxfb59a932019-03-13 18:40:19 +01001275 break;
1276 case MCS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001277 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001278 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS3));
Maxfb59a932019-03-13 18:40:19 +01001279 break;
1280 case MCS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001281 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS4);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001282 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS4));
Maxfb59a932019-03-13 18:40:19 +01001283 break;
1284 case MCS5:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001285 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS5);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001286 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS5));
Maxfb59a932019-03-13 18:40:19 +01001287 break;
1288 case MCS6:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001289 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS6);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001290 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS6));
Maxfb59a932019-03-13 18:40:19 +01001291 break;
1292 case MCS7:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001293 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS7);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001294 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS7));
Maxfb59a932019-03-13 18:40:19 +01001295 break;
1296 case MCS8:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001297 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS8);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001298 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS8));
Maxfb59a932019-03-13 18:40:19 +01001299 break;
1300 case MCS9:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001301 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS9);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001302 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS9));
Maxfb59a932019-03-13 18:40:19 +01001303 break;
1304 default:
1305 LOGPTBFDL(this, LOGL_ERROR, "attempting to update rate counters for unsupported (M)CS %s\n",
1306 mcs_name(cs));
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301307 }
1308}
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001309
Pau Espin Pedrolcc30b052022-10-27 15:25:55 +02001310struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf(struct gprs_rlcmac_tbf *tbf)
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001311{
1312 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1313 return static_cast<gprs_rlcmac_dl_tbf *>(tbf);
1314 else
1315 return NULL;
1316}
Pau Espin Pedrol1e1275f2022-11-17 20:57:34 +01001317
1318const struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf_const(const struct gprs_rlcmac_tbf *tbf)
1319{
1320 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1321 return static_cast<const gprs_rlcmac_dl_tbf *>(tbf);
1322 else
1323 return NULL;
1324}