blob: cbf42a2da50b2d619065a58faeafe5fed864bc4d [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{
Pau Espin Pedrol8456a362023-04-19 20:24:25 +020098 osmo_clock_gettime(CLOCK_MONOTONIC, &dl_bw_tv);
99 osmo_clock_gettime(CLOCK_MONOTONIC, &dl_loss_tv);
Pau Espin Pedrol834cbab2020-10-23 22:17:01 +0200100}
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 return tbf;
158}
159
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200160gprs_rlcmac_dl_tbf::~gprs_rlcmac_dl_tbf()
161{
Pau Espin Pedrol131deb02021-07-26 18:24:14 +0200162 if (is_egprs_enabled()) {
163 rate_ctr_group_free(m_dl_egprs_ctrs);
164 } else {
165 rate_ctr_group_free(m_dl_gprs_ctrs);
166 }
167 /* ~gprs_rlcmac_tbf() is called automatically upon return */
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200168}
169
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100170gprs_rlcmac_dl_tbf::gprs_rlcmac_dl_tbf(struct gprs_rlcmac_bts *bts_, GprsMs *ms) :
Pau Espin Pedrole9f77d32020-10-23 18:41:40 +0200171 gprs_rlcmac_tbf(bts_, ms, GPRS_RLCMAC_DL_TBF),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200172 m_tx_counter(0),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200173 m_dl_ack_requested(false),
Pau Espin Pedrola89008b2021-03-02 13:07:05 +0100174 m_last_dl_poll_fn(-1),
175 m_last_dl_drained_fn(-1),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200176 m_dl_gprs_ctrs(NULL),
177 m_dl_egprs_ctrs(NULL)
178{
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100179 memset(&state_fsm, 0, sizeof(state_fsm));
Pau Espin Pedrol83a08922022-12-12 19:46:01 +0100180 state_fsm.dl_tbf = this;
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100181 state_fi = osmo_fsm_inst_alloc(&tbf_dl_fsm, this, &state_fsm, LOGL_INFO, NULL);
182 OSMO_ASSERT(state_fi);
Pau Espin Pedrol759724c2023-04-19 18:36:40 +0200183
184 /* This has to be called in child constructor because enable_egprs()
185 * uses the window() virtual function which is dependent on subclass. */
186 if (ms_mode(m_ms) != GPRS)
187 enable_egprs();
Daniel Willmannca102af2014-08-08 12:14:12 +0200188}
189
Daniel Willmannca102af2014-08-08 12:14:12 +0200190/**
191 * TODO: split into unit test-able parts...
192 */
Pau Espin Pedrol8a35e642021-01-18 17:14:14 +0100193int dl_tbf_handle(struct gprs_rlcmac_bts *bts,
194 const uint32_t tlli, const uint32_t tlli_old, const char *imsi,
195 uint8_t ms_class, uint8_t egprs_ms_class,
196 const uint16_t delay_csec,
197 const uint8_t *data, const uint16_t len)
Daniel Willmannca102af2014-08-08 12:14:12 +0200198{
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200199 int rc;
Jacob Erlbeckac289052015-08-14 12:50:54 +0200200 GprsMs *ms, *ms_old;
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200201 bool ms_allocated = false;
Daniel Willmannca102af2014-08-08 12:14:12 +0200202
203 /* check for existing TBF */
Pau Espin Pedroleb0a0522023-04-17 16:33:35 +0200204 ms = bts_get_ms(bts, tlli, tlli_old, imsi);
Jacob Erlbecka47aaa42016-01-07 16:47:34 +0100205
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100206 /* If we got MS by TLLI above let's see if we already have another MS
207 * object identified by IMSI and merge them */
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200208 if (ms) {
209 if (!ms_imsi_is_valid(ms) && imsi) {
210 ms_old = bts_get_ms_by_imsi(bts, imsi);
211 if (ms_old && ms_old != ms) {
212 /* The TLLI has changed (RAU), so there are two MS
213 * objects for the same MS */
214 LOGP(DTBF, LOGL_NOTICE,
215 "There is a new MS object for the same MS: (0x%08x, '%s') -> (0x%08x, '%s')\n",
216 ms_tlli(ms_old), ms_imsi(ms_old), ms_tlli(ms), ms_imsi(ms));
217 ms_merge_and_clear_ms(ms, ms_old);
218 /* old_ms may no longer be available here */
219 }
Jacob Erlbeckac289052015-08-14 12:50:54 +0200220 }
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200221 } else {
222 ms = ms_alloc(bts, __func__);
223 /* Remember we have to unref the alloc reference at the end: */
224 ms_allocated = true;
Jacob Erlbeckac289052015-08-14 12:50:54 +0200225 }
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100226 if (imsi)
227 ms_set_imsi(ms, imsi);
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100228 ms_confirm_tlli(ms, tlli);
229 if (!ms_ms_class(ms) && ms_class) {
230 ms_set_ms_class(ms, ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100231 }
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100232 if (!ms_egprs_ms_class(ms) && egprs_ms_class) {
233 ms_set_egprs_ms_class(ms, egprs_ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100234 }
Pau Espin Pedrol528820d2020-10-26 12:40:11 +0100235
Pau Espin Pedrol14beef62022-10-26 19:44:07 +0200236 rc = ms_append_llc_dl_data(ms, delay_csec, data, len);
Pau Espin Pedroleae91472023-04-19 19:42:05 +0200237 if (ms_allocated) {
238 ms_unref(ms, __func__);
239 /* Here "ms" may be freed if ms_append_llc_dl_data() failed to
240 * allocate a DL TBF and it has no more TBFs attached */
241 }
242 return rc;
Daniel Willmannca102af2014-08-08 12:14:12 +0200243}
244
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100245bool gprs_rlcmac_dl_tbf::restart_bsn_cycle()
Daniel Willmannca102af2014-08-08 12:14:12 +0200246{
Jacob Erlbeck95340242015-03-19 13:22:07 +0100247 /* If V(S) == V(A) and finished state, we would have received
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100248 * acknowledgement of all transmitted block. In this case we would
249 * have transmitted the final block, and received ack from MS. But in
250 * this case we did not receive the final ack indication from MS. This
251 * should never happen if MS works correctly.
252 */
Jacob Erlbeck95340242015-03-19 13:22:07 +0100253 if (m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +0100254 LOGPTBFDL(this, LOGL_DEBUG, "MS acked all blocks\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100255 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100256 }
257
258 /* cycle through all unacked blocks */
259 int resend = m_window.mark_for_resend();
260
261 /* At this point there should be at least one unacked block
262 * to be resent. If not, this is an software error. */
263 if (resend == 0) {
Max0524e382018-01-19 18:22:25 +0100264 LOGPTBFDL(this, LOGL_ERROR,
265 "FIXME: Software error: There are no unacknowledged blocks, but V(A) != V(S). PLEASE FIX!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100266 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100267 }
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100268
269 return true;
270}
271
272int gprs_rlcmac_dl_tbf::take_next_bsn(uint32_t fn,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100273 int previous_bsn, enum mcs_kind req_mcs_kind, bool *may_combine)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100274{
275 int bsn;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100276 int data_len2, force_data_len = -1;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100277 enum CodingScheme tx_cs;
278
279 /* Scheduler may be fine with sending any kind of data, but if
280 the selected TBF is GPRS-only, then let's filter out EGPRS
281 here */
282 if (!is_egprs_enabled())
283 req_mcs_kind = GPRS;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100284
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200285 /* search for a nacked or resend marked bsn */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100286 bsn = m_window.resend_needed();
287
288 if (previous_bsn >= 0) {
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100289 tx_cs = m_rlc.block(previous_bsn)->cs_current_trans;
290 if (!mcs_is_edge(tx_cs))
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100291 return -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100292 force_data_len = m_rlc.block(previous_bsn)->len;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100293 } else {
294 tx_cs = ms_current_cs_dl(ms(), req_mcs_kind);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100295 }
296
297 if (bsn >= 0) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200298 /* resend an unacked bsn or resend bsn. */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100299 if (previous_bsn == bsn)
300 return -1;
301
302 if (previous_bsn >= 0 &&
303 m_window.mod_sns(bsn - previous_bsn) > RLC_EGPRS_MAX_BSN_DELTA)
304 return -1;
305
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530306 if (is_egprs_enabled()) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530307 /* Table 8.1.1.2 and Table 8.1.1.1 of 44.060 */
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100308 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 +0100309 bts->pcu->vty.dl_arq_type == EGPRS_ARQ1);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530310
Max0524e382018-01-19 18:22:25 +0100311 LOGPTBFDL(this, LOGL_DEBUG,
Maxa0353542019-03-06 18:03:58 +0100312 "initial_cs_dl(%s) last_mcs(%s) demanded_mcs(%s) cs_trans(%s) arq_type(%d) bsn(%d)\n",
313 mcs_name(m_rlc.block(bsn)->cs_init),
314 mcs_name(m_rlc.block(bsn)->cs_last),
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100315 mcs_name(tx_cs),
Maxa0353542019-03-06 18:03:58 +0100316 mcs_name(m_rlc.block(bsn)->cs_current_trans),
Pau Espin Pedrol97296b22021-01-14 13:08:02 +0100317 the_pcu->vty.dl_arq_type, bsn);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530318
319 /* TODO: Need to remove this check when MCS-8 -> MCS-6
320 * transistion is handled.
321 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
322 */
Maxbea2edb2019-03-06 17:04:59 +0100323 if (m_rlc.block(bsn)->cs_init == MCS8)
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530324 m_rlc.block(bsn)->cs_current_trans =
Maxbea2edb2019-03-06 17:04:59 +0100325 MCS8;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200326 } else {
327 /* gprs */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530328 m_rlc.block(bsn)->cs_current_trans =
329 m_rlc.block(bsn)->cs_last;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200330 }
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530331
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100332 data_len2 = m_rlc.block(bsn)->len;
333 if (force_data_len > 0 && force_data_len != data_len2)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100334 return -1;
Max0524e382018-01-19 18:22:25 +0100335 LOGPTBFDL(this, LOGL_DEBUG, "Resending BSN %d\n", bsn);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100336 /* re-send block with negative aknowlegement */
337 m_window.m_v_b.mark_unacked(bsn);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100338 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +0200339 } else if (state_is(TBF_ST_FINISHED)) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200340 /* If the TBF is in finished, we already sent all packages at least once.
341 * If any packages could have been sent (because of unacked) it should have
342 * been catched up by the upper if(bsn >= 0) */
Max0524e382018-01-19 18:22:25 +0100343 LOGPTBFDL(this, LOGL_DEBUG,
344 "Restarting at BSN %d, because all blocks have been transmitted.\n",
345 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100346 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100347 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100348 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100349 } else if (dl_window_stalled()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200350 /* There are no more packages to send, but the window is stalled.
351 * Restart the bsn_cycle to resend all unacked messages */
Max0524e382018-01-19 18:22:25 +0100352 LOGPTBFDL(this, LOGL_NOTICE,
353 "Restarting at BSN %d, because the window is stalled.\n",
354 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100355 bts_do_rate_ctr_inc(bts, CTR_RLC_STALLED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100356 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100357 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100358 } else if (have_data()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200359 /* The window has space left, generate new bsn */
Max0524e382018-01-19 18:22:25 +0100360 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100361 "Sending new block at BSN %d, CS=%s%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100362 m_window.v_s(), mcs_name(tx_cs),
363 force_data_len != -1 ? " (forced)" : "");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100364
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100365 bsn = create_new_bsn(fn, tx_cs);
Pau Espin Pedrol05f9f592021-01-14 12:56:58 +0100366 } else if (bts->pcu->vty.dl_tbf_preemptive_retransmission && !m_window.window_empty()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200367 /* The window contains unacked packages, but not acked.
368 * Mark unacked bsns as RESEND */
Max0524e382018-01-19 18:22:25 +0100369 LOGPTBFDL(this, LOGL_DEBUG,
370 "Restarting at BSN %d, because all blocks have been transmitted (FLOW).\n",
371 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100372 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100373 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100374 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100375 } else {
376 /* Nothing left to send, create dummy LLC commands */
Max0524e382018-01-19 18:22:25 +0100377 LOGPTBFDL(this, LOGL_DEBUG,
378 "Sending new dummy block at BSN %d, CS=%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100379 m_window.v_s(), mcs_name(tx_cs));
380 bsn = create_new_bsn(fn, tx_cs);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530381 /* Don't send a second block, so don't set cs_current_trans */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100382 }
383
384 if (bsn < 0) {
385 /* we just send final block again */
Max0524e382018-01-19 18:22:25 +0100386 LOGPTBFDL(this, LOGL_DEBUG,
387 "Nothing else to send, Re-transmit final block!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100388 bsn = m_window.v_s_mod(-1);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100389 bts_do_rate_ctr_inc(bts, CTR_RLC_FINAL_BLOCK_RESENT);
390 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100391 }
392
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200393 *may_combine = num_data_blocks(mcs_header_type(m_rlc.block(bsn)->cs_current_trans)) > 1;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100394
395 return bsn;
396}
397
398/*
399 * Create DL data block
400 * The messages are fragmented and forwarded as data blocks.
401 */
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100402struct 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 +0100403{
404 int bsn, bsn2 = -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100405 bool may_combine;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100406
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100407 LOGPTBFDL(this, LOGL_DEBUG, "downlink (V(A)==%d .. V(S)==%d) mcs_mode_restrict=%s\n",
408 m_window.v_a(), m_window.v_s(), mode_name(req_mcs_kind));
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100409
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100410 bsn = take_next_bsn(fn, -1, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100411 if (bsn < 0)
412 return NULL;
413
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100414 if (may_combine)
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100415 bsn2 = take_next_bsn(fn, bsn, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100416
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100417 return create_dl_acked_block(fn, pdch, bsn, bsn2);
Daniel Willmannca102af2014-08-08 12:14:12 +0200418}
419
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200420/* old_tbf (UL TBF or DL TBF) will send a Pkt Dl Ass on PACCH to assign tbf.
421 * Note: It is possible that "tbf == old_tbf" if the TBF is being updated. This can
422 * happen when we first assign over PCH (only single slot is possible) and we want
423 * to upgrade the DL-TBF to be multislot. See code calling tbf_update() for more
424 * information.
425 */
426void dl_tbf_trigger_ass_on_pacch(struct gprs_rlcmac_dl_tbf *tbf, struct gprs_rlcmac_tbf *old_tbf)
427{
428 OSMO_ASSERT(tbf);
429 OSMO_ASSERT(old_tbf);
430 /* stop pending timer */
431 tbf_stop_timers(tbf, "DL assignment (PACCH)");
432
433 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PACCH, because %s exists\n", old_tbf->name());
434 osmo_fsm_inst_dispatch(old_tbf->dl_ass_fsm.fi, TBF_DL_ASS_EV_SCHED_ASS, NULL);
435
436 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100437 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_PACCH, NULL);
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200438
439}
440
441void dl_tbf_trigger_ass_on_pch(struct gprs_rlcmac_dl_tbf *tbf)
Maxa10c3982017-07-07 18:25:41 +0200442{
443 /* stop pending timer */
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200444 struct GprsMs *ms = tbf_ms(tbf);
Maxa10c3982017-07-07 18:25:41 +0200445
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200446 tbf_stop_timers(tbf, "DL assignment (PCH)");
Maxa10c3982017-07-07 18:25:41 +0200447
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200448 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PCH, no TBF exist (IMSI=%s)\n", ms_imsi(ms));
Maxa10c3982017-07-07 18:25:41 +0200449
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200450 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100451 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_CCCH, NULL);
Maxa10c3982017-07-07 18:25:41 +0200452
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200453 /* send immediate assignment */
454 bts_snd_dl_ass(ms->bts, tbf);
Maxa10c3982017-07-07 18:25:41 +0200455}
456
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100457int dl_tbf_upgrade_to_multislot(struct gprs_rlcmac_dl_tbf *tbf)
458{
459 int rc;
460 struct gprs_rlcmac_trx *trx = tbf_get_trx(tbf);
461 struct gprs_rlcmac_bts *bts = trx->bts;
462
463 LOGPTBFDL(tbf, LOGL_DEBUG, "Upgrade to multislot\n");
464
465 tbf_unlink_pdch(tbf);
466 rc = the_pcu->alloc_algorithm(bts, dl_tbf_as_tbf(tbf), false, -1);
467 /* if no resource */
468 if (rc < 0) {
469 LOGPTBFDL(tbf, LOGL_ERROR, "No resources allocated during upgrade to multislot!\n");
470 bts_do_rate_ctr_inc(bts, CTR_TBF_ALLOC_FAIL);
471 return rc;
472 }
473
474 if (tbf_is_egprs_enabled(dl_tbf_as_tbf(tbf)))
475 tbf->set_window_size();
476 tbf_update_state_fsm_name(tbf);
477
Pau Espin Pedrol4a090542022-12-13 14:48:31 +0100478 /* Now trigger the assignment using the pre-existing TBF: */
479 dl_tbf_trigger_ass_on_pacch(tbf, dl_tbf_as_tbf(tbf));
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100480 return 0;
481}
482
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200483void gprs_rlcmac_dl_tbf::schedule_next_frame()
484{
485 struct msgb *msg;
486
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100487 if (llc_frame_length(&m_llc) != 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200488 return;
489
490 /* dequeue next LLC frame, if any */
Pau Espin Pedrol6b1e9512022-04-04 13:45:56 +0200491 msg = llc_queue_dequeue(llc_queue());
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200492 if (!msg)
493 return;
494
Max0fdaa9d2018-01-30 16:03:10 +0100495 LOGPTBFDL(this, LOGL_DEBUG, "Dequeue next LLC (len=%d)\n", msg->len);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200496
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200497 llc_put_frame(&m_llc, msg->data, msg->len);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100498 bts_do_rate_ctr_inc(bts, CTR_LLC_FRAME_SCHED);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200499 msgb_free(msg);
500 m_last_dl_drained_fn = -1;
501}
502
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200503int gprs_rlcmac_dl_tbf::create_new_bsn(const uint32_t fn, enum CodingScheme cs)
Daniel Willmannca102af2014-08-08 12:14:12 +0200504{
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100505 uint8_t *data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200506 gprs_rlc_data *rlc_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200507 const uint16_t bsn = m_window.v_s();
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100508 gprs_rlc_data_block_info *rdbi;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100509 int num_chunks = 0;
510 int write_offset = 0;
511 Encoding::AppendResult ar;
Daniel Willmannca102af2014-08-08 12:14:12 +0200512
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100513 if (llc_frame_length(&m_llc) == 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200514 schedule_next_frame();
515
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200516 OSMO_ASSERT(mcs_is_valid(cs));
Jacob Erlbecka700dd92015-06-02 16:00:41 +0200517
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100518 /* length of usable data block (single data unit w/o header) */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200519 const uint8_t block_data_len = mcs_max_data_block_bytes(cs);
Daniel Willmannca102af2014-08-08 12:14:12 +0200520
521 /* now we still have untransmitted LLC data, so we fill mac block */
522 rlc_data = m_rlc.block(bsn);
Pau Espin Pedrol5bb87b82020-05-18 11:02:39 +0200523 data = prepare(rlc_data, block_data_len);
Aravind Sirsikar91495522016-07-12 14:17:12 +0530524 rlc_data->cs_last = cs;
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530525 rlc_data->cs_current_trans = cs;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530526
527 /* Initialise the variable related to DL SPB */
528 rlc_data->spb_status.block_status_dl = EGPRS_RESEG_DL_DEFAULT;
529 rlc_data->cs_init = cs;
530
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100531 rlc_data->len = block_data_len;
Daniel Willmannca102af2014-08-08 12:14:12 +0200532
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100533 rdbi = &(rlc_data->block_info);
534 memset(rdbi, 0, sizeof(*rdbi));
535 rdbi->data_len = block_data_len;
536
537 rdbi->cv = 15; /* Final Block Indicator, set late, if true */
538 rdbi->bsn = bsn; /* Block Sequence Number */
539 rdbi->e = 1; /* Extension bit, maybe set later (1: no extension) */
540
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100541 do {
542 bool is_final;
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200543 int payload_written = 0;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100544
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100545 if (llc_frame_length(&m_llc) == 0) {
Pau Espin Pedrol8afc6ba2021-03-02 13:19:39 +0100546 /* The data just drained, store the current fn */
547 if (m_last_dl_drained_fn < 0)
548 m_last_dl_drained_fn = fn;
549
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100550 /* It is not clear, when the next real data will
551 * arrive, so request a DL ack/nack now */
552 request_dl_ack();
Alexander Couzens1a506612016-05-24 16:55:30 +0200553
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100554 int space = block_data_len - write_offset;
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100555
556 if (num_chunks != 0) {
557 /* Nothing to send, and we already put some data in
558 * rlcmac data block, we are done */
559 LOGPTBFDL(this, LOGL_DEBUG,
560 "LLC queue completely drained and there's "
561 "still %d free bytes in rlcmac data block\n", space);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100562
563 /* We may need to update fbi in header here
564 * since m_last_dl_drained_fn was updated above
565 * Specially important when X2031 is 0. */
566 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
567 if (is_final) {
568 rdbi->cv = 0;
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100569 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100570 }
571
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100572 if (mcs_is_edge(cs)) {
573 /* in EGPRS there's no M bit, so we need
574 * to flag padding with LI=127 */
575 Encoding::rlc_data_to_dl_append_egprs_li_padding(rdbi,
576 &write_offset,
577 &num_chunks,
578 data);
579 }
580 break;
581 }
582
583 /* Nothing to send from upper layers (LLC), but still
584 * requested to send something to MS to delay the
585 * release of the TBF. See 3GPP TS 44.060 9.3.1a
586 * "Delayed release of downlink Temporary Block Flow" */
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100587 /* A header will need to by added, so we just need
588 * space-1 octets */
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200589 llc_put_dummy_frame(&m_llc, space - 1);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100590
Max0524e382018-01-19 18:22:25 +0100591 LOGPTBFDL(this, LOGL_DEBUG,
592 "Empty chunk, added LLC dummy command of size %d, drained_since=%d\n",
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100593 llc_frame_length(&m_llc), frames_since_last_drain(fn));
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100594 }
595
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100596 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100597
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100598 ar = Encoding::rlc_data_to_dl_append(rdbi, cs,
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200599 &m_llc, &write_offset, &num_chunks, data, is_final, &payload_written);
600
601 if (payload_written > 0)
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100602 bts_do_rate_ctr_add(bts, CTR_RLC_DL_PAYLOAD_BYTES, payload_written);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100603
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100604 if (ar == Encoding::AR_NEED_MORE_BLOCKS)
605 break;
606
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100607 LOGPTBFDL(this, LOGL_DEBUG, "Complete DL frame, len=%d\n", llc_frame_length(&m_llc));
608 gprs_rlcmac_dl_bw(this, llc_frame_length(&m_llc));
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100609 bts_do_rate_ctr_add(bts, CTR_LLC_DL_BYTES, llc_frame_length(&m_llc));
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200610 llc_reset(&m_llc);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100611
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100612 if (is_final) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100613 request_dl_ack();
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100614 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Daniel Willmannca102af2014-08-08 12:14:12 +0200615 }
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100616
617 /* dequeue next LLC frame, if any */
618 schedule_next_frame();
619 } while (ar == Encoding::AR_COMPLETED_SPACE_LEFT);
620
Max0524e382018-01-19 18:22:25 +0100621 LOGPTBFDL(this, LOGL_DEBUG, "data block (BSN %d, %s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100622 bsn, mcs_name(rlc_data->cs_last),
Max0524e382018-01-19 18:22:25 +0100623 osmo_hexdump(rlc_data->block, block_data_len));
Daniel Willmannca102af2014-08-08 12:14:12 +0200624 /* raise send state and set ack state array */
625 m_window.m_v_b.mark_unacked(bsn);
626 m_window.increment_send();
627
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100628 return bsn;
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100629}
630
Daniel Willmannca102af2014-08-08 12:14:12 +0200631struct msgb *gprs_rlcmac_dl_tbf::create_dl_acked_block(
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100632 const uint32_t fn, const struct gprs_rlcmac_pdch *pdch,
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100633 int index, int index2)
Daniel Willmannca102af2014-08-08 12:14:12 +0200634{
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100635 uint8_t *msg_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200636 struct msgb *dl_msg;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100637 unsigned msg_len;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100638 /* TODO: support MCS-7 - MCS-9, where data_block_idx can be 1 */
Maxb3a17d62017-12-21 12:11:33 +0100639 uint8_t data_block_idx = 0;
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100640 unsigned int rrbp;
641 uint32_t new_poll_fn;
642 int rc;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100643 bool is_final = false;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100644 gprs_rlc_data_info rlc;
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200645 enum CodingScheme cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100646 int bsns[ARRAY_SIZE(rlc.block_info)];
647 unsigned num_bsns;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100648 bool need_padding = false;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530649 enum egprs_rlcmac_dl_spb spb = EGPRS_RLCMAC_DL_NO_RETX;
650 unsigned int spb_status = get_egprs_dl_spb_status(index);
Neels Hofmeyrb6091902017-02-08 16:49:20 +0100651
652 enum egprs_puncturing_values punct[2] = {
653 EGPRS_PS_INVALID, EGPRS_PS_INVALID
654 };
655 osmo_static_assert(ARRAY_SIZE(rlc.block_info) == 2,
656 rlc_block_info_size_is_two);
657
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100658 /*
659 * TODO: This is an experimental work-around to put 2 BSN into
660 * MSC-7 to MCS-9 encoded messages. It just sends the same BSN
661 * twice in the block. The cs should be derived from the TBF's
662 * current CS such that both BSNs (that must be compatible) can
663 * be put into the data area, even if the resulting CS is higher than
664 * the current limit.
665 */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530666 cs = m_rlc.block(index)->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +0100667 enum CodingScheme cs_init = m_rlc.block(index)->cs_init;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100668 bsns[0] = index;
669 num_bsns = 1;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100670
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100671 if (index2 >= 0) {
672 bsns[num_bsns] = index2;
673 num_bsns += 1;
674 }
675
Mrinal Mishraf86307e2016-11-10 18:16:30 +0530676 update_coding_scheme_counter_dl(cs);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530677 /*
678 * if the intial mcs is 8 and retransmission mcs is either 6 or 3
679 * we have to include the padding of 6 octets in first segment
680 */
Maxd4a39292019-03-13 18:44:20 +0100681 if ((cs_init == MCS8) &&
682 (cs == MCS6 || cs == MCS3)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530683 if (spb_status == EGPRS_RESEG_DL_DEFAULT ||
Maxd4a39292019-03-13 18:44:20 +0100684 spb_status == EGPRS_RESEG_SECOND_SEG_SENT)
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530685 need_padding = true;
686 } else if (num_bsns == 1) {
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100687 /* TODO: remove the conditional when MCS-6 padding isn't
688 * failing to be decoded by MEs anymore */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530689 /* TODO: support of MCS-8 -> MCS-6 transition should be
690 * handled
691 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
692 * dated 2016-02-07 23:45:40 (UTC)
693 */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200694 if (cs != MCS8)
695 mcs_dec_to_single_block(&cs, &need_padding);
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100696 }
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100697
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530698 spb = get_egprs_dl_spb(index);
699
Max0524e382018-01-19 18:22:25 +0100700 LOGPTBFDL(this, LOGL_DEBUG, "need_padding %d spb_status %d spb %d (BSN1 %d BSN2 %d)\n",
701 need_padding, spb_status, spb, index, index2);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530702
703 gprs_rlc_data_info_init_dl(&rlc, cs, need_padding, spb);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100704
705 rlc.usf = 7; /* will be set at scheduler */
706 rlc.pr = 0; /* FIXME: power reduction */
707 rlc.tfi = m_tfi; /* TFI */
708
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100709 /* return data block(s) as message */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200710 msg_len = mcs_size_dl(cs);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100711 dl_msg = msgb_alloc(msg_len, "rlcmac_dl_data");
712 if (!dl_msg)
713 return NULL;
714
715 msg_data = msgb_put(dl_msg, msg_len);
716
Aravind Sirsikarb1191982016-08-26 18:13:10 +0530717 OSMO_ASSERT(rlc.num_data_blocks <= ARRAY_SIZE(rlc.block_info));
718 OSMO_ASSERT(rlc.num_data_blocks > 0);
719
Max0524e382018-01-19 18:22:25 +0100720 LOGPTBFDL(this, LOGL_DEBUG, "Copying %u RLC blocks, %u BSNs\n", rlc.num_data_blocks, num_bsns);
Max5759a192017-09-08 12:23:12 +0200721
Maxb3a17d62017-12-21 12:11:33 +0100722 /* Copy block(s) to RLC message: the num_data_blocks cannot be more than 2 - see assert above */
723 for (data_block_idx = 0; data_block_idx < OSMO_MIN(rlc.num_data_blocks, 2);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100724 data_block_idx++)
725 {
726 int bsn;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100727 uint8_t *block_data;
728 gprs_rlc_data_block_info *rdbi, *block_info;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530729 enum egprs_rlc_dl_reseg_bsn_state reseg_status;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100730
731 /* Check if there are more blocks than BSNs */
732 if (data_block_idx < num_bsns)
733 bsn = bsns[data_block_idx];
734 else
735 bsn = bsns[0];
736
Aravind Sirsikar79522822016-03-23 18:29:47 +0530737 /* Get current puncturing scheme from block */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530738
739 m_rlc.block(bsn)->next_ps = gprs_get_punct_scheme(
Aravind Sirsikar79522822016-03-23 18:29:47 +0530740 m_rlc.block(bsn)->next_ps,
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530741 m_rlc.block(bsn)->cs_last, cs, spb);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530742
Max8a8e0fb2019-03-25 16:32:50 +0100743 if (mcs_is_edge(cs)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530744 OSMO_ASSERT(m_rlc.block(bsn)->next_ps >= EGPRS_PS_1);
745 OSMO_ASSERT(m_rlc.block(bsn)->next_ps <= EGPRS_PS_3);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530746 }
Maxb3a17d62017-12-21 12:11:33 +0100747
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530748 punct[data_block_idx] = m_rlc.block(bsn)->next_ps;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100749
750 rdbi = &rlc.block_info[data_block_idx];
751 block_info = &m_rlc.block(bsn)->block_info;
752
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530753 /*
754 * get data and header from current block
755 * function returns the reseg status
Aravind Sirsikar79522822016-03-23 18:29:47 +0530756 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530757 reseg_status = egprs_dl_get_data(bsn, &block_data);
758 m_rlc.block(bsn)->spb_status.block_status_dl = reseg_status;
759
760 /*
761 * If it is first segment of the split block set the state of
762 * bsn to nacked. If it is the first segment dont update the
763 * next ps value of bsn. since next segment also needs same cps
764 */
765 if (spb == EGPRS_RLCMAC_DL_FIRST_SEG)
766 m_window.m_v_b.mark_nacked(bsn);
767 else {
768 /*
769 * TODO: Need to handle 2 same bsns
770 * in header type 1
771 */
772 gprs_update_punct_scheme(&m_rlc.block(bsn)->next_ps,
773 cs);
774 }
Aravind Sirsikar79522822016-03-23 18:29:47 +0530775
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530776 m_rlc.block(bsn)->cs_last = cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100777 rdbi->e = block_info->e;
778 rdbi->cv = block_info->cv;
779 rdbi->bsn = bsn;
780 is_final = is_final || rdbi->cv == 0;
781
Max0524e382018-01-19 18:22:25 +0100782 LOGPTBFDL(this, LOGL_DEBUG, "Copying data unit %d (BSN %d)\n",
783 data_block_idx, bsn);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100784
785 Encoding::rlc_copy_from_aligned_buffer(&rlc, data_block_idx,
786 msg_data, block_data);
787 }
788
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100789 /* Calculate CPS only for EGPRS case */
Max8a8e0fb2019-03-25 16:32:50 +0100790 if (mcs_is_edge(cs))
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100791 rlc.cps = gprs_rlc_mcs_cps(cs, punct[0], punct[1], need_padding);
Daniel Willmannca102af2014-08-08 12:14:12 +0200792
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100793 /* If the TBF has just started, relate frames_since_last_poll to the
794 * current fn */
795 if (m_last_dl_poll_fn < 0)
796 m_last_dl_poll_fn = fn;
797
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200798 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
Pau Espin Pedrol6d8315f2023-04-19 20:05:01 +0200799 * when last polled DL ACK/NACK was lost. Always do so in the control TS. */
800 if (tbf_is_control_ts(dl_tbf_as_tbf(this), pdch) &&
801 need_poll_for_dl_ack_nack()) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100802 if (m_dl_ack_requested) {
Max0524e382018-01-19 18:22:25 +0100803 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol30f66172019-12-04 18:07:49 +0100804 "Scheduling Ack/Nack polling, because it was requested explicitly "
Max0524e382018-01-19 18:22:25 +0100805 "(e.g. first final block sent).\n");
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200806 } else if (state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK)) {
Max0524e382018-01-19 18:22:25 +0100807 LOGPTBFDL(this, LOGL_DEBUG,
808 "Scheduling Ack/Nack polling, because polling timed out.\n");
Daniel Willmannca102af2014-08-08 12:14:12 +0200809 } else {
Max0524e382018-01-19 18:22:25 +0100810 LOGPTBFDL(this, LOGL_DEBUG,
811 "Scheduling Ack/Nack polling, because %d blocks sent.\n",
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200812 POLL_ACK_AFTER_FRAMES);
Daniel Willmannca102af2014-08-08 12:14:12 +0200813 }
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100814
Pau Espin Pedrolfd74e792022-12-15 18:23:12 +0100815 rc = tbf_check_polling(this, pdch, fn, &new_poll_fn, &rrbp);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100816 if (rc >= 0) {
Pau Espin Pedrol5b7eeec2022-12-15 19:08:13 +0100817 tbf_set_polling(this, pdch, new_poll_fn, PDCH_ULC_POLL_DL_ACK);
Pau Espin Pedrola161bf42021-07-30 13:42:06 +0200818 LOGPTBFDL(this, LOGL_DEBUG,
819 "Scheduled DL Acknowledgement polling on PACCH (FN=%d, TS=%d)\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100820 new_poll_fn, pdch->ts_no);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100821
Daniel Willmannca102af2014-08-08 12:14:12 +0200822 m_tx_counter = 0;
823 /* start timer whenever we send the final block */
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100824 if (is_final)
Pau Espin Pedrol28f160e2019-09-05 14:48:35 +0200825 T_START(this, T3191, 3191, "final block (DL-TBF)", true);
Daniel Willmannca102af2014-08-08 12:14:12 +0200826
Pau Espin Pedrol33e80072021-07-22 19:20:50 +0200827 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK); /* clear poll timeout flag */
Daniel Willmannefd5dbb2014-08-25 16:20:23 +0200828
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100829 /* Clear request flag */
830 m_dl_ack_requested = false;
831
Daniel Willmannca102af2014-08-08 12:14:12 +0200832 /* set polling in header */
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100833 rlc.rrbp = rrbp;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100834 rlc.es_p = 1; /* Polling */
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100835
Pau Espin Pedrol58046e42021-03-29 19:01:13 +0200836 m_last_dl_poll_fn = new_poll_fn;
Jacob Erlbeck16d29c72015-08-24 13:30:39 +0200837
Max0524e382018-01-19 18:22:25 +0100838 LOGPTBFDL(this, LOGL_INFO,
839 "Scheduled Ack/Nack polling on FN=%d, TS=%d\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100840 new_poll_fn, pdch->ts_no);
Daniel Willmannca102af2014-08-08 12:14:12 +0200841 }
842 }
843
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100844 Encoding::rlc_write_dl_data_header(&rlc, msg_data);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100845
Max0524e382018-01-19 18:22:25 +0100846 LOGPTBFDL(this, LOGL_DEBUG, "msg block (BSN %d, %s%s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100847 index, mcs_name(cs),
Max0524e382018-01-19 18:22:25 +0100848 need_padding ? ", padded" : "",
849 msgb_hexdump(dl_msg));
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100850
Daniel Willmannca102af2014-08-08 12:14:12 +0200851 /* Increment TX-counter */
852 m_tx_counter++;
853
Daniel Willmannca102af2014-08-08 12:14:12 +0200854 return dl_msg;
855}
856
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100857static uint16_t bitnum_to_bsn(int bitnum, uint16_t ssn)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200858{
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100859 return ssn - 1 - bitnum;
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200860}
861
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200862int gprs_rlcmac_dl_tbf::analyse_errors(char *show_rbb, uint8_t ssn,
863 ana_result *res)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200864{
865 gprs_rlc_data *rlc_data;
866 uint16_t lost = 0, received = 0, skipped = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100867 char info[RLC_MAX_WS + 1];
868 memset(info, '.', m_window.ws());
869 info[m_window.ws()] = 0;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200870 uint16_t bsn = 0;
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200871 unsigned received_bytes = 0, lost_bytes = 0;
872 unsigned received_packets = 0, lost_packets = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100873 unsigned num_blocks = strlen(show_rbb);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200874
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530875 unsigned distance = m_window.distance();
876
877 num_blocks = num_blocks > distance
878 ? distance : num_blocks;
879
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200880 /* SSN - 1 is in range V(A)..V(S)-1 */
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100881 for (unsigned int bitpos = 0; bitpos < num_blocks; bitpos++) {
882 bool is_received;
883 int index = num_blocks - 1 - bitpos;
884
885 is_received = (index >= 0 && show_rbb[index] == 'R');
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200886
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100887 bsn = m_window.mod_sns(bitnum_to_bsn(bitpos, ssn));
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200888
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100889 if (bsn == m_window.mod_sns(m_window.v_a() - 1)) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200890 info[bitpos] = '$';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200891 break;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200892 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200893
894 rlc_data = m_rlc.block(bsn);
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200895 if (!rlc_data) {
896 info[bitpos] = '0';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200897 continue;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200898 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200899
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200900 /* Get general statistics */
901 if (is_received && !m_window.m_v_b.is_acked(bsn)) {
902 received_packets += 1;
903 received_bytes += rlc_data->len;
904 } else if (!is_received && !m_window.m_v_b.is_nacked(bsn)) {
905 lost_packets += 1;
906 lost_bytes += rlc_data->len;
907 }
908
909 /* Get statistics for current CS */
910
Aravind Sirsikar91495522016-07-12 14:17:12 +0530911 if (rlc_data->cs_last != current_cs()) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200912 /* This block has already been encoded with a different
913 * CS, so it doesn't help us to decide, whether the
914 * current CS is ok. Ignore it. */
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200915 info[bitpos] = 'x';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200916 skipped += 1;
917 continue;
918 }
919
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200920 if (is_received) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200921 if (!m_window.m_v_b.is_acked(bsn)) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200922 received += 1;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200923 info[bitpos] = 'R';
924 } else {
925 info[bitpos] = 'r';
926 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200927 } else {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200928 info[bitpos] = 'L';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200929 lost += 1;
930 }
931 }
932
Max0524e382018-01-19 18:22:25 +0100933 LOGPTBFDL(this, LOGL_DEBUG,
934 "DL analysis, range=%d:%d, lost=%d, recv=%d, skipped=%d, bsn=%d, info='%s'\n",
935 m_window.v_a(), m_window.v_s(), lost, received, skipped, bsn, info);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200936
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200937 res->received_packets = received_packets;
938 res->lost_packets = lost_packets;
939 res->received_bytes = received_bytes;
940 res->lost_bytes = lost_bytes;
941
Jacob Erlbeck144a1d02015-06-04 16:51:44 +0200942 if (lost + received <= 1)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200943 return -1;
944
945 return lost * 100 / (lost + received);
946}
947
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +0200948gprs_rlc_window *gprs_rlcmac_dl_tbf::window()
Maxea98b7d2018-01-04 15:13:27 +0100949{
950 return &m_window;
951}
952
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100953int gprs_rlcmac_dl_tbf::update_window(unsigned first_bsn,
954 const struct bitvec *rbb)
955{
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530956 unsigned dist;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100957 uint16_t lost = 0, received = 0;
958 char show_v_b[RLC_MAX_SNS + 1];
959 char show_rbb[RLC_MAX_SNS + 1];
960 int error_rate;
961 struct ana_result ana_res;
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530962 dist = m_window.distance();
963 unsigned num_blocks = rbb->cur_bit > dist
964 ? dist : rbb->cur_bit;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100965 unsigned behind_last_bsn = m_window.mod_sns(first_bsn + num_blocks);
966
967 Decoding::extract_rbb(rbb, show_rbb);
968 /* show received array in debug */
Max0524e382018-01-19 18:22:25 +0100969 LOGPTBFDL(this, LOGL_DEBUG,
970 "ack: (BSN=%d)\"%s\"(BSN=%d) R=ACK I=NACK\n",
971 first_bsn, show_rbb, m_window.mod_sns(behind_last_bsn - 1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100972
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100973 error_rate = analyse_errors(show_rbb, behind_last_bsn, &ana_res);
974
Pau Espin Pedrole8dcf642021-01-14 13:17:01 +0100975 if (the_pcu->vty.cs_adj_enabled && ms())
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100976 ms_update_error_rate(ms(), this, error_rate);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100977
978 m_window.update(bts, rbb, first_bsn, &lost, &received);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +0200979 rate_ctr_add(rate_ctr_group_get_ctr(m_ctrs, TBF_CTR_RLC_NACKED), lost);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100980
981 /* report lost and received packets */
982 gprs_rlcmac_received_lost(this, received, lost);
983
984 /* Used to measure the leak rate */
985 gprs_bssgp_update_bytes_received(ana_res.received_bytes,
986 ana_res.received_packets + ana_res.lost_packets);
987
988 /* raise V(A), if possible */
989 m_window.raise(m_window.move_window());
990
991 /* show receive state array in debug (V(A)..V(S)-1) */
992 m_window.show_state(show_v_b);
Max0524e382018-01-19 18:22:25 +0100993 LOGPTBFDL(this, LOGL_DEBUG,
994 "V(B): (V(A)=%d)\"%s\"(V(S)-1=%d) A=Acked N=Nacked U=Unacked X=Resend-Unacked I=Invalid\n",
995 m_window.v_a(), show_v_b, m_window.v_s_mod(-1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100996 return 0;
997}
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200998
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +0200999int gprs_rlcmac_dl_tbf::rcvd_dl_final_ack()
Daniel Willmannca102af2014-08-08 12:14:12 +02001000{
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001001 uint16_t received;
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001002 int rc = 0;
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001003
Pau Espin Pedrolf197f152022-11-17 20:18:46 +01001004 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_FINAL_ACK_RECVD, NULL);
Pau Espin Pedrolf48de622021-07-30 14:48:06 +02001005
1006 /* range V(A)..V(S)-1 */
1007 received = m_window.count_unacked();
1008 /* report all outstanding packets as received */
1009 gprs_rlcmac_received_lost(this, received, 0);
1010 m_tx_counter = 0;
1011 m_window.reset();
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001012
1013 /* check for LLC PDU in the LLC Queue */
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001014 if (llc_queue_size(llc_queue()) > 0)
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001015 /* we have more data so we will re-use this tbf */
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001016 rc = ms_new_dl_tbf_assigned_on_pacch(ms(), dl_tbf_as_tbf(this));
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001017
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001018 return rc;
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001019}
1020
Max7df82d42017-12-15 11:14:30 +01001021int gprs_rlcmac_dl_tbf::rcvd_dl_ack(bool final_ack, unsigned first_bsn,
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001022 struct bitvec *rbb)
1023{
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001024 int rc;
Maxc21f0072017-12-15 17:36:45 +01001025 LOGPTBFDL(this, LOGL_DEBUG, "downlink acknowledge\n");
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001026
Pau Espin Pedrolfbc1baa2021-07-28 21:59:00 +02001027 state_fsm.state_flags |= (1 << GPRS_RLCMAC_FLAG_DL_ACK);
1028 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK);
1029
1030 /* reset N3105 */
1031 n_reset(N3105);
1032 t_stop(T3191, "ACK/NACK received");
1033
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001034 rc = update_window(first_bsn, rbb);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001035
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001036 if (final_ack) {
Max0524e382018-01-19 18:22:25 +01001037 LOGPTBFDL(this, LOGL_DEBUG, "Final ACK received.\n");
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +02001038 rc = rcvd_dl_final_ack();
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +02001039 } else if (state_is(TBF_ST_FINISHED) && m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +01001040 LOGPTBFDL(this, LOGL_NOTICE,
1041 "Received acknowledge of all blocks, but without final ack indication (don't worry)\n");
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001042 }
1043
1044 return rc;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001045}
1046
Daniel Willmannca102af2014-08-08 12:14:12 +02001047bool gprs_rlcmac_dl_tbf::dl_window_stalled() const
1048{
1049 return m_window.window_stalled();
1050}
1051
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001052void gprs_rlcmac_dl_tbf::request_dl_ack()
1053{
1054 m_dl_ack_requested = true;
1055}
1056
Pau Espin Pedrol8fa3e062022-10-28 17:38:52 +02001057void dl_tbf_request_dl_ack(struct gprs_rlcmac_dl_tbf *dl_tbf) {
Pau Espin Pedrol14beef62022-10-26 19:44:07 +02001058 dl_tbf->request_dl_ack();
1059}
1060
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001061/* Does this DL TBF require to poll the MS for DL ACK/NACK? */
1062bool gprs_rlcmac_dl_tbf::need_poll_for_dl_ack_nack() const
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001063{
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001064 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
1065 * when last polled DL ACK/NACK was lost. */
Pau Espin Pedrol33e80072021-07-22 19:20:50 +02001066 return state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK) ||
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001067 m_tx_counter >= POLL_ACK_AFTER_FRAMES ||
1068 m_dl_ack_requested;
1069}
1070
1071bool gprs_rlcmac_dl_tbf::have_data() const
1072{
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001073 return llc_chunk_size(&m_llc) > 0 ||
1074 (llc_queue_size(llc_queue()) > 0);
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001075}
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001076
Max9dabfa22017-05-16 16:10:45 +02001077static inline int frames_since_last(int32_t last, unsigned fn)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001078{
Max9dabfa22017-05-16 16:10:45 +02001079 unsigned wrapped = (fn + GSM_MAX_FN - last) % GSM_MAX_FN;
1080
1081 if (last < 0)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001082 return -1;
1083
Max9dabfa22017-05-16 16:10:45 +02001084 if (wrapped < GSM_MAX_FN/2)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001085 return wrapped;
Max9dabfa22017-05-16 16:10:45 +02001086
1087 return wrapped - GSM_MAX_FN;
1088}
1089
1090int gprs_rlcmac_dl_tbf::frames_since_last_poll(unsigned fn) const
1091{
1092 return frames_since_last(m_last_dl_poll_fn, fn);
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001093}
1094
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001095int gprs_rlcmac_dl_tbf::frames_since_last_drain(unsigned fn) const
1096{
Max9dabfa22017-05-16 16:10:45 +02001097 return frames_since_last(m_last_dl_drained_fn, fn);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001098}
1099
1100bool gprs_rlcmac_dl_tbf::keep_open(unsigned fn) const
1101{
1102 int keep_time_frames;
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001103 unsigned long dl_tbf_idle_msec;
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001104 int since_last_drain;
1105 bool keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001106
Pau Espin Pedrol924aaad2021-01-14 12:01:42 +01001107 dl_tbf_idle_msec = osmo_tdef_get(the_pcu->T_defs, -2031, OSMO_TDEF_MS, -1);
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001108 if (dl_tbf_idle_msec == 0)
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001109 return false;
1110
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001111 keep_time_frames = msecs_to_frames(dl_tbf_idle_msec);
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001112 since_last_drain = frames_since_last_drain(fn);
1113 keep = since_last_drain <= keep_time_frames;
1114
1115 if (since_last_drain >= 0)
1116 LOGPTBFDL(this, LOGL_DEBUG, "Keep idle TBF open: %d/%d -> %s\n",
1117 since_last_drain, keep_time_frames, keep ? "yes" : "no");
1118 return keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001119}
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301120
1121/*
1122 * This function returns the pointer to data which needs
1123 * to be copied. Also updates the status of the block related to
1124 * Split block handling in the RLC/MAC block.
1125 */
1126enum egprs_rlc_dl_reseg_bsn_state
1127 gprs_rlcmac_dl_tbf::egprs_dl_get_data(int bsn, uint8_t **block_data)
1128{
1129 gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1130 egprs_rlc_dl_reseg_bsn_state *block_status_dl =
1131 &rlc_data->spb_status.block_status_dl;
1132
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001133 enum CodingScheme cs_init = rlc_data->cs_init;
1134 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001135
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001136 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1137 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Maxd4a39292019-03-13 18:44:20 +01001138
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301139 *block_data = &rlc_data->block[0];
1140
1141 /*
1142 * Table 10.3a.0.1 of 44.060
1143 * MCS6,9: second segment starts at 74/2 = 37
1144 * MCS5,7: second segment starts at 56/2 = 28
1145 * MCS8: second segment starts at 31
1146 * MCS4: second segment starts at 44/2 = 22
1147 */
Maxd4a39292019-03-13 18:44:20 +01001148 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301149 if (*block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
Maxd4a39292019-03-13 18:44:20 +01001150 switch (cs_init) {
Maxbea2edb2019-03-06 17:04:59 +01001151 case MCS6 :
1152 case MCS9 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301153 *block_data = &rlc_data->block[37];
1154 break;
Maxbea2edb2019-03-06 17:04:59 +01001155 case MCS7 :
1156 case MCS5 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301157 *block_data = &rlc_data->block[28];
1158 break;
Maxbea2edb2019-03-06 17:04:59 +01001159 case MCS8 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301160 *block_data = &rlc_data->block[31];
1161 break;
Maxbea2edb2019-03-06 17:04:59 +01001162 case MCS4 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301163 *block_data = &rlc_data->block[22];
1164 break;
1165 default:
Max0524e382018-01-19 18:22:25 +01001166 LOGPTBFDL(this, LOGL_ERROR,
1167 "FIXME: Software error: hit invalid condition. "
1168 "headerType(%d) blockstatus(%d) cs(%s) PLEASE FIX!\n",
Maxd4a39292019-03-13 18:44:20 +01001169 ht_cs_current_trans,
Max136ebcc2019-03-05 14:59:03 +01001170 *block_status_dl, mcs_name(cs_init));
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301171 break;
1172
1173 }
1174 return EGPRS_RESEG_SECOND_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001175 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1176 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301177 return EGPRS_RESEG_FIRST_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001178 } else if ((cs_init == MCS4) &&
1179 (cs_current_trans == MCS1)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301180 return EGPRS_RESEG_FIRST_SEG_SENT;
1181 }
1182 }
1183 return EGPRS_RESEG_DL_DEFAULT;
1184}
1185
1186/*
1187 * This function returns the status of split block
1188 * for RLC/MAC block.
1189 */
1190unsigned int gprs_rlcmac_dl_tbf::get_egprs_dl_spb_status(const int bsn)
1191{
1192 const gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1193
1194 return rlc_data->spb_status.block_status_dl;
1195}
1196
1197/*
1198 * This function returns the spb value to be sent OTA
1199 * for RLC/MAC block.
1200 */
1201enum egprs_rlcmac_dl_spb gprs_rlcmac_dl_tbf::get_egprs_dl_spb(const int bsn)
1202{
1203 struct gprs_rlc_data *rlc_data = m_rlc.block(bsn);
Maxd4a39292019-03-13 18:44:20 +01001204 egprs_rlc_dl_reseg_bsn_state block_status_dl = rlc_data->spb_status.block_status_dl;
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301205
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001206 enum CodingScheme cs_init = rlc_data->cs_init;
1207 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001208
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001209 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1210 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301211
1212 /* Table 10.4.8b.1 of 44.060 */
Maxd4a39292019-03-13 18:44:20 +01001213 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
1214 /*
1215 * if we are sending the second segment the spb should be 3
1216 * otherwise it should be 2
1217 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301218 if (block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
sivasankarida7250a2016-12-16 12:57:18 +05301219 /* statistics */
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001220 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_SECOND_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301221 return EGPRS_RLCMAC_DL_SEC_SEG;
Maxd4a39292019-03-13 18:44:20 +01001222 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1223 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001224 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301225 return EGPRS_RLCMAC_DL_FIRST_SEG;
Maxd4a39292019-03-13 18:44:20 +01001226 } else if ((cs_init == MCS4) &&
1227 (cs_current_trans == MCS1)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001228 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301229 return EGPRS_RLCMAC_DL_FIRST_SEG;
1230 }
1231 }
1232 /* Non SPB cases 0 is reurned */
1233 return EGPRS_RLCMAC_DL_NO_RETX;
1234}
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301235
Max9d7357e2017-12-14 15:02:33 +01001236void gprs_rlcmac_dl_tbf::set_window_size()
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301237{
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001238 const struct gprs_rlcmac_bts *b = bts;
Max34513fe2018-12-11 16:47:30 +01001239 uint16_t ws = egprs_window_size(b, dl_slots());
1240
Max0524e382018-01-19 18:22:25 +01001241 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 +01001242 ws, bts->pcu->vty.ws_base, pcu_bitcount(dl_slots()), bts->pcu->vty.ws_pdch);
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301243 m_window.set_ws(ws);
1244}
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301245
Maxfb59a932019-03-13 18:40:19 +01001246void gprs_rlcmac_dl_tbf::update_coding_scheme_counter_dl(enum CodingScheme cs)
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301247{
Maxfb59a932019-03-13 18:40:19 +01001248 switch (cs) {
1249 case CS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001250 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001251 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS1));
Maxfb59a932019-03-13 18:40:19 +01001252 break;
1253 case CS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001254 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001255 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS2));
Maxfb59a932019-03-13 18:40:19 +01001256 break;
1257 case CS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001258 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001259 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS3));
Maxfb59a932019-03-13 18:40:19 +01001260 break;
1261 case CS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001262 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS4);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001263 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS4));
Maxfb59a932019-03-13 18:40:19 +01001264 break;
1265 case MCS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001266 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001267 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS1));
Maxfb59a932019-03-13 18:40:19 +01001268 break;
1269 case MCS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001270 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001271 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS2));
Maxfb59a932019-03-13 18:40:19 +01001272 break;
1273 case MCS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001274 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001275 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS3));
Maxfb59a932019-03-13 18:40:19 +01001276 break;
1277 case MCS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001278 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS4);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001279 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS4));
Maxfb59a932019-03-13 18:40:19 +01001280 break;
1281 case MCS5:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001282 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS5);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001283 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS5));
Maxfb59a932019-03-13 18:40:19 +01001284 break;
1285 case MCS6:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001286 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS6);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001287 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS6));
Maxfb59a932019-03-13 18:40:19 +01001288 break;
1289 case MCS7:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001290 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS7);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001291 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS7));
Maxfb59a932019-03-13 18:40:19 +01001292 break;
1293 case MCS8:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001294 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS8);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001295 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS8));
Maxfb59a932019-03-13 18:40:19 +01001296 break;
1297 case MCS9:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001298 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS9);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001299 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS9));
Maxfb59a932019-03-13 18:40:19 +01001300 break;
1301 default:
1302 LOGPTBFDL(this, LOGL_ERROR, "attempting to update rate counters for unsupported (M)CS %s\n",
1303 mcs_name(cs));
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301304 }
1305}
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001306
Pau Espin Pedrolcc30b052022-10-27 15:25:55 +02001307struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf(struct gprs_rlcmac_tbf *tbf)
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001308{
1309 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1310 return static_cast<gprs_rlcmac_dl_tbf *>(tbf);
1311 else
1312 return NULL;
1313}
Pau Espin Pedrol1e1275f2022-11-17 20:57:34 +01001314
1315const struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf_const(const struct gprs_rlcmac_tbf *tbf)
1316{
1317 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1318 return static_cast<const gprs_rlcmac_dl_tbf *>(tbf);
1319 else
1320 return NULL;
1321}