blob: 9214aae6370ca4890ea5c26b53cf75530dc84fed [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>
30#include <gprs_ms_storage.h>
31#include <llc.h>
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +010032#include "pcu_utils.h"
33
Daniel Willmannca102af2014-08-08 12:14:12 +020034extern "C" {
35#include <osmocom/core/msgb.h>
36#include <osmocom/core/talloc.h>
Alexander Couzens95e37922016-05-21 22:33:27 +020037#include <osmocom/gprs/gprs_bssgp_bss.h>
Max1187a772018-01-26 13:31:42 +010038 #include <osmocom/core/bitvec.h>
39 #include <osmocom/core/linuxlist.h>
40 #include <osmocom/core/logging.h>
41 #include <osmocom/core/rate_ctr.h>
Pau Espin Pedrolb3859692020-10-23 22:37:52 +020042 #include <osmocom/core/stats.h>
Max1187a772018-01-26 13:31:42 +010043 #include <osmocom/core/timer.h>
44 #include <osmocom/core/utils.h>
45 #include <osmocom/gsm/gsm_utils.h>
46 #include <osmocom/gsm/protocol/gsm_04_08.h>
Max136ebcc2019-03-05 14:59:03 +010047 #include "coding_scheme.h"
Daniel Willmannca102af2014-08-08 12:14:12 +020048}
49
50#include <errno.h>
51#include <string.h>
52
53/* After sending these frames, we poll for ack/nack. */
54#define POLL_ACK_AFTER_FRAMES 20
55
Pau Espin Pedrolb3859692020-10-23 22:37:52 +020056extern void *tall_pcu_ctx;
57
58static const struct rate_ctr_desc tbf_dl_gprs_ctr_description[] = {
59 { "gprs:downlink:cs1", "CS1 " },
60 { "gprs:downlink:cs2", "CS2 " },
61 { "gprs:downlink:cs3", "CS3 " },
62 { "gprs:downlink:cs4", "CS4 " },
63};
64
65static const struct rate_ctr_desc tbf_dl_egprs_ctr_description[] = {
66 { "egprs:downlink:mcs1", "MCS1 " },
67 { "egprs:downlink:mcs2", "MCS2 " },
68 { "egprs:downlink:mcs3", "MCS3 " },
69 { "egprs:downlink:mcs4", "MCS4 " },
70 { "egprs:downlink:mcs5", "MCS5 " },
71 { "egprs:downlink:mcs6", "MCS6 " },
72 { "egprs:downlink:mcs7", "MCS7 " },
73 { "egprs:downlink:mcs8", "MCS8 " },
74 { "egprs:downlink:mcs9", "MCS9 " },
75};
76
77static const struct rate_ctr_group_desc tbf_dl_gprs_ctrg_desc = {
78 "tbf:gprs",
79 "Data Blocks",
80 OSMO_STATS_CLASS_SUBSCRIBER,
81 ARRAY_SIZE(tbf_dl_gprs_ctr_description),
82 tbf_dl_gprs_ctr_description,
83};
84
85static const struct rate_ctr_group_desc tbf_dl_egprs_ctrg_desc = {
86 "tbf:egprs",
87 "Data Blocks",
88 OSMO_STATS_CLASS_SUBSCRIBER,
89 ARRAY_SIZE(tbf_dl_egprs_ctr_description),
90 tbf_dl_egprs_ctr_description,
91};
92
Pau Espin Pedrol834cbab2020-10-23 22:17:01 +020093gprs_rlcmac_dl_tbf::BandWidth::BandWidth() :
94 dl_bw_octets(0),
95 dl_throughput(0),
96 dl_loss_lost(0),
97 dl_loss_received(0)
98{
99 timespecclear(&dl_bw_tv);
100 timespecclear(&dl_loss_tv);
101}
102
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200103static int dl_tbf_dtor(struct gprs_rlcmac_dl_tbf *tbf)
104{
105 tbf->~gprs_rlcmac_dl_tbf();
106 return 0;
107}
108
Pau Espin Pedrol29b9f942022-10-27 14:53:16 +0200109struct 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 +0200110{
111 struct gprs_rlcmac_dl_tbf *tbf;
112 int rc;
113
114 OSMO_ASSERT(ms != NULL);
115
Pau Espin Pedrol36177c62021-02-25 17:57:37 +0100116 LOGPMS(ms, DTBF, LOGL_DEBUG, "********** DL-TBF starts here **********\n");
117 LOGPMS(ms, DTBF, LOGL_INFO, "Allocating DL TBF\n");
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200118
119 tbf = talloc(tall_pcu_ctx, struct gprs_rlcmac_dl_tbf);
120
121 if (!tbf)
122 return NULL;
123
124 talloc_set_destructor(tbf, dl_tbf_dtor);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100125 new (tbf) gprs_rlcmac_dl_tbf(bts, ms);
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200126
127 rc = tbf->setup(use_trx, single_slot);
128 /* if no resource */
129 if (rc < 0) {
130 talloc_free(tbf);
131 return NULL;
132 }
133
134 if (tbf->is_egprs_enabled()) {
135 tbf->set_window_size();
136 tbf->m_dl_egprs_ctrs = rate_ctr_group_alloc(tbf,
137 &tbf_dl_egprs_ctrg_desc,
138 tbf->m_ctrs->idx);
139 if (!tbf->m_dl_egprs_ctrs) {
140 LOGPTBF(tbf, LOGL_ERROR, "Couldn't allocate EGPRS DL counters\n");
141 talloc_free(tbf);
142 return NULL;
143 }
144 } else {
145 tbf->m_dl_gprs_ctrs = rate_ctr_group_alloc(tbf,
146 &tbf_dl_gprs_ctrg_desc,
147 tbf->m_ctrs->idx);
148 if (!tbf->m_dl_gprs_ctrs) {
149 LOGPTBF(tbf, LOGL_ERROR, "Couldn't allocate GPRS DL counters\n");
150 talloc_free(tbf);
151 return NULL;
152 }
153 }
154
Pau Espin Pedrol1a1557a2021-05-13 18:39:36 +0200155 llist_add(tbf_trx_list((struct gprs_rlcmac_tbf *)tbf), &tbf->trx->dl_tbfs);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100156 bts_do_rate_ctr_inc(tbf->bts, CTR_TBF_DL_ALLOCATED);
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200157
Pau Espin Pedrolb3859692020-10-23 22:37:52 +0200158 osmo_clock_gettime(CLOCK_MONOTONIC, &tbf->m_bw.dl_bw_tv);
159 osmo_clock_gettime(CLOCK_MONOTONIC, &tbf->m_bw.dl_loss_tv);
160
161 return tbf;
162}
163
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200164gprs_rlcmac_dl_tbf::~gprs_rlcmac_dl_tbf()
165{
Pau Espin Pedrol131deb02021-07-26 18:24:14 +0200166 if (is_egprs_enabled()) {
167 rate_ctr_group_free(m_dl_egprs_ctrs);
168 } else {
169 rate_ctr_group_free(m_dl_gprs_ctrs);
170 }
171 /* ~gprs_rlcmac_tbf() is called automatically upon return */
Pau Espin Pedrol62e06f92021-07-26 17:27:51 +0200172}
173
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100174gprs_rlcmac_dl_tbf::gprs_rlcmac_dl_tbf(struct gprs_rlcmac_bts *bts_, GprsMs *ms) :
Pau Espin Pedrole9f77d32020-10-23 18:41:40 +0200175 gprs_rlcmac_tbf(bts_, ms, GPRS_RLCMAC_DL_TBF),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200176 m_tx_counter(0),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200177 m_dl_ack_requested(false),
Pau Espin Pedrola89008b2021-03-02 13:07:05 +0100178 m_last_dl_poll_fn(-1),
179 m_last_dl_drained_fn(-1),
Pau Espin Pedrolbddf1ad2019-09-26 14:41:18 +0200180 m_dl_gprs_ctrs(NULL),
181 m_dl_egprs_ctrs(NULL)
182{
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100183 memset(&state_fsm, 0, sizeof(state_fsm));
Pau Espin Pedrol83a08922022-12-12 19:46:01 +0100184 state_fsm.dl_tbf = this;
Pau Espin Pedrol343c0ee2022-11-17 19:55:08 +0100185 state_fi = osmo_fsm_inst_alloc(&tbf_dl_fsm, this, &state_fsm, LOGL_INFO, NULL);
186 OSMO_ASSERT(state_fi);
Daniel Willmannca102af2014-08-08 12:14:12 +0200187}
188
Daniel Willmannca102af2014-08-08 12:14:12 +0200189/**
190 * TODO: split into unit test-able parts...
191 */
Pau Espin Pedrol8a35e642021-01-18 17:14:14 +0100192int dl_tbf_handle(struct gprs_rlcmac_bts *bts,
193 const uint32_t tlli, const uint32_t tlli_old, const char *imsi,
194 uint8_t ms_class, uint8_t egprs_ms_class,
195 const uint16_t delay_csec,
196 const uint8_t *data, const uint16_t len)
Daniel Willmannca102af2014-08-08 12:14:12 +0200197{
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200198 int rc;
Jacob Erlbeckac289052015-08-14 12:50:54 +0200199 GprsMs *ms, *ms_old;
Daniel Willmannca102af2014-08-08 12:14:12 +0200200
201 /* check for existing TBF */
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100202 ms = bts_ms_store(bts)->get_ms(tlli, tlli_old, imsi);
Jacob Erlbecka47aaa42016-01-07 16:47:34 +0100203
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100204 /* If we got MS by TLLI above let's see if we already have another MS
205 * object identified by IMSI and merge them */
206 if (ms && !ms_imsi_is_valid(ms) && imsi) {
Pau Espin Pedrol7f360e72022-10-21 14:30:36 +0200207 ms_old = bts_ms_store(bts)->get_ms(GSM_RESERVED_TMSI, GSM_RESERVED_TMSI, imsi);
Jacob Erlbeckac289052015-08-14 12:50:54 +0200208 if (ms_old && ms_old != ms) {
209 /* The TLLI has changed (RAU), so there are two MS
210 * objects for the same MS */
Max0524e382018-01-19 18:22:25 +0100211 LOGP(DTBF, LOGL_NOTICE,
212 "There is a new MS object for the same MS: (0x%08x, '%s') -> (0x%08x, '%s')\n",
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100213 ms_tlli(ms_old), ms_imsi(ms_old), ms_tlli(ms), ms_imsi(ms));
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100214 ms_merge_and_clear_ms(ms, ms_old);
Pau Espin Pedrol677bebb2022-10-31 13:56:33 +0100215 /* old_ms may no longer be available here */
Jacob Erlbeckac289052015-08-14 12:50:54 +0200216 }
217 }
218
Pau Espin Pedrol528820d2020-10-26 12:40:11 +0100219 if (!ms)
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100220 ms = bts_alloc_ms(bts, ms_class, egprs_ms_class);
Pau Espin Pedrol5deac142021-11-12 18:01:50 +0100221 if (imsi)
222 ms_set_imsi(ms, imsi);
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100223 ms_confirm_tlli(ms, tlli);
224 if (!ms_ms_class(ms) && ms_class) {
225 ms_set_ms_class(ms, ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100226 }
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100227 if (!ms_egprs_ms_class(ms) && egprs_ms_class) {
228 ms_set_egprs_ms_class(ms, egprs_ms_class);
Pau Espin Pedrol758ace82020-10-28 19:58:17 +0100229 }
Pau Espin Pedrol528820d2020-10-26 12:40:11 +0100230
Pau Espin Pedrol14beef62022-10-26 19:44:07 +0200231 rc = ms_append_llc_dl_data(ms, delay_csec, data, len);
232 if (rc < 0)
233 return rc;
Pau Espin Pedrol14beef62022-10-26 19:44:07 +0200234 return 0;
Daniel Willmannca102af2014-08-08 12:14:12 +0200235}
236
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100237bool gprs_rlcmac_dl_tbf::restart_bsn_cycle()
Daniel Willmannca102af2014-08-08 12:14:12 +0200238{
Jacob Erlbeck95340242015-03-19 13:22:07 +0100239 /* If V(S) == V(A) and finished state, we would have received
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100240 * acknowledgement of all transmitted block. In this case we would
241 * have transmitted the final block, and received ack from MS. But in
242 * this case we did not receive the final ack indication from MS. This
243 * should never happen if MS works correctly.
244 */
Jacob Erlbeck95340242015-03-19 13:22:07 +0100245 if (m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +0100246 LOGPTBFDL(this, LOGL_DEBUG, "MS acked all blocks\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100247 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100248 }
249
250 /* cycle through all unacked blocks */
251 int resend = m_window.mark_for_resend();
252
253 /* At this point there should be at least one unacked block
254 * to be resent. If not, this is an software error. */
255 if (resend == 0) {
Max0524e382018-01-19 18:22:25 +0100256 LOGPTBFDL(this, LOGL_ERROR,
257 "FIXME: Software error: There are no unacknowledged blocks, but V(A) != V(S). PLEASE FIX!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100258 return false;
Jacob Erlbeck95340242015-03-19 13:22:07 +0100259 }
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100260
261 return true;
262}
263
264int gprs_rlcmac_dl_tbf::take_next_bsn(uint32_t fn,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100265 int previous_bsn, enum mcs_kind req_mcs_kind, bool *may_combine)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100266{
267 int bsn;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100268 int data_len2, force_data_len = -1;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100269 enum CodingScheme tx_cs;
270
271 /* Scheduler may be fine with sending any kind of data, but if
272 the selected TBF is GPRS-only, then let's filter out EGPRS
273 here */
274 if (!is_egprs_enabled())
275 req_mcs_kind = GPRS;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100276
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200277 /* search for a nacked or resend marked bsn */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100278 bsn = m_window.resend_needed();
279
280 if (previous_bsn >= 0) {
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100281 tx_cs = m_rlc.block(previous_bsn)->cs_current_trans;
282 if (!mcs_is_edge(tx_cs))
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100283 return -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100284 force_data_len = m_rlc.block(previous_bsn)->len;
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100285 } else {
286 tx_cs = ms_current_cs_dl(ms(), req_mcs_kind);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100287 }
288
289 if (bsn >= 0) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200290 /* resend an unacked bsn or resend bsn. */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100291 if (previous_bsn == bsn)
292 return -1;
293
294 if (previous_bsn >= 0 &&
295 m_window.mod_sns(bsn - previous_bsn) > RLC_EGPRS_MAX_BSN_DELTA)
296 return -1;
297
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530298 if (is_egprs_enabled()) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530299 /* Table 8.1.1.2 and Table 8.1.1.1 of 44.060 */
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100300 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 +0100301 bts->pcu->vty.dl_arq_type == EGPRS_ARQ1);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530302
Max0524e382018-01-19 18:22:25 +0100303 LOGPTBFDL(this, LOGL_DEBUG,
Maxa0353542019-03-06 18:03:58 +0100304 "initial_cs_dl(%s) last_mcs(%s) demanded_mcs(%s) cs_trans(%s) arq_type(%d) bsn(%d)\n",
305 mcs_name(m_rlc.block(bsn)->cs_init),
306 mcs_name(m_rlc.block(bsn)->cs_last),
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100307 mcs_name(tx_cs),
Maxa0353542019-03-06 18:03:58 +0100308 mcs_name(m_rlc.block(bsn)->cs_current_trans),
Pau Espin Pedrol97296b22021-01-14 13:08:02 +0100309 the_pcu->vty.dl_arq_type, bsn);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530310
311 /* TODO: Need to remove this check when MCS-8 -> MCS-6
312 * transistion is handled.
313 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
314 */
Maxbea2edb2019-03-06 17:04:59 +0100315 if (m_rlc.block(bsn)->cs_init == MCS8)
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530316 m_rlc.block(bsn)->cs_current_trans =
Maxbea2edb2019-03-06 17:04:59 +0100317 MCS8;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200318 } else {
319 /* gprs */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530320 m_rlc.block(bsn)->cs_current_trans =
321 m_rlc.block(bsn)->cs_last;
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200322 }
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530323
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100324 data_len2 = m_rlc.block(bsn)->len;
325 if (force_data_len > 0 && force_data_len != data_len2)
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100326 return -1;
Max0524e382018-01-19 18:22:25 +0100327 LOGPTBFDL(this, LOGL_DEBUG, "Resending BSN %d\n", bsn);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100328 /* re-send block with negative aknowlegement */
329 m_window.m_v_b.mark_unacked(bsn);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100330 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +0200331 } else if (state_is(TBF_ST_FINISHED)) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200332 /* If the TBF is in finished, we already sent all packages at least once.
333 * If any packages could have been sent (because of unacked) it should have
334 * been catched up by the upper if(bsn >= 0) */
Max0524e382018-01-19 18:22:25 +0100335 LOGPTBFDL(this, LOGL_DEBUG,
336 "Restarting at BSN %d, because all blocks have been transmitted.\n",
337 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100338 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100339 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100340 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100341 } else if (dl_window_stalled()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200342 /* There are no more packages to send, but the window is stalled.
343 * Restart the bsn_cycle to resend all unacked messages */
Max0524e382018-01-19 18:22:25 +0100344 LOGPTBFDL(this, LOGL_NOTICE,
345 "Restarting at BSN %d, because the window is stalled.\n",
346 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100347 bts_do_rate_ctr_inc(bts, CTR_RLC_STALLED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100348 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100349 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100350 } else if (have_data()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200351 /* The window has space left, generate new bsn */
Max0524e382018-01-19 18:22:25 +0100352 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100353 "Sending new block at BSN %d, CS=%s%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100354 m_window.v_s(), mcs_name(tx_cs),
355 force_data_len != -1 ? " (forced)" : "");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100356
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100357 bsn = create_new_bsn(fn, tx_cs);
Pau Espin Pedrol05f9f592021-01-14 12:56:58 +0100358 } else if (bts->pcu->vty.dl_tbf_preemptive_retransmission && !m_window.window_empty()) {
Alexander Couzense46d8dc2019-09-10 15:34:49 +0200359 /* The window contains unacked packages, but not acked.
360 * Mark unacked bsns as RESEND */
Max0524e382018-01-19 18:22:25 +0100361 LOGPTBFDL(this, LOGL_DEBUG,
362 "Restarting at BSN %d, because all blocks have been transmitted (FLOW).\n",
363 m_window.v_a());
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100364 bts_do_rate_ctr_inc(bts, CTR_RLC_RESTARTED);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100365 if (restart_bsn_cycle())
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100366 return take_next_bsn(fn, previous_bsn, req_mcs_kind, may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100367 } else {
368 /* Nothing left to send, create dummy LLC commands */
Max0524e382018-01-19 18:22:25 +0100369 LOGPTBFDL(this, LOGL_DEBUG,
370 "Sending new dummy block at BSN %d, CS=%s\n",
Pau Espin Pedrolfc464932021-01-25 12:05:32 +0100371 m_window.v_s(), mcs_name(tx_cs));
372 bsn = create_new_bsn(fn, tx_cs);
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530373 /* Don't send a second block, so don't set cs_current_trans */
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100374 }
375
376 if (bsn < 0) {
377 /* we just send final block again */
Max0524e382018-01-19 18:22:25 +0100378 LOGPTBFDL(this, LOGL_DEBUG,
379 "Nothing else to send, Re-transmit final block!\n");
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100380 bsn = m_window.v_s_mod(-1);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100381 bts_do_rate_ctr_inc(bts, CTR_RLC_FINAL_BLOCK_RESENT);
382 bts_do_rate_ctr_inc(bts, CTR_RLC_RESENT);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100383 }
384
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200385 *may_combine = num_data_blocks(mcs_header_type(m_rlc.block(bsn)->cs_current_trans)) > 1;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100386
387 return bsn;
388}
389
390/*
391 * Create DL data block
392 * The messages are fragmented and forwarded as data blocks.
393 */
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100394struct 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 +0100395{
396 int bsn, bsn2 = -1;
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100397 bool may_combine;
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100398
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100399 LOGPTBFDL(this, LOGL_DEBUG, "downlink (V(A)==%d .. V(S)==%d) mcs_mode_restrict=%s\n",
400 m_window.v_a(), m_window.v_s(), mode_name(req_mcs_kind));
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100401
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100402 bsn = take_next_bsn(fn, -1, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100403 if (bsn < 0)
404 return NULL;
405
Jacob Erlbeck64e7b832016-02-04 15:16:47 +0100406 if (may_combine)
Pau Espin Pedrol022f9e52020-11-16 18:49:39 +0100407 bsn2 = take_next_bsn(fn, bsn, req_mcs_kind, &may_combine);
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100408
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100409 return create_dl_acked_block(fn, pdch, bsn, bsn2);
Daniel Willmannca102af2014-08-08 12:14:12 +0200410}
411
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200412/* old_tbf (UL TBF or DL TBF) will send a Pkt Dl Ass on PACCH to assign tbf.
413 * Note: It is possible that "tbf == old_tbf" if the TBF is being updated. This can
414 * happen when we first assign over PCH (only single slot is possible) and we want
415 * to upgrade the DL-TBF to be multislot. See code calling tbf_update() for more
416 * information.
417 */
418void dl_tbf_trigger_ass_on_pacch(struct gprs_rlcmac_dl_tbf *tbf, struct gprs_rlcmac_tbf *old_tbf)
419{
420 OSMO_ASSERT(tbf);
421 OSMO_ASSERT(old_tbf);
422 /* stop pending timer */
423 tbf_stop_timers(tbf, "DL assignment (PACCH)");
424
425 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PACCH, because %s exists\n", old_tbf->name());
426 osmo_fsm_inst_dispatch(old_tbf->dl_ass_fsm.fi, TBF_DL_ASS_EV_SCHED_ASS, NULL);
427
428 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100429 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_PACCH, NULL);
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200430
431}
432
433void dl_tbf_trigger_ass_on_pch(struct gprs_rlcmac_dl_tbf *tbf)
Maxa10c3982017-07-07 18:25:41 +0200434{
435 /* stop pending timer */
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200436 struct GprsMs *ms = tbf_ms(tbf);
Maxa10c3982017-07-07 18:25:41 +0200437
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200438 tbf_stop_timers(tbf, "DL assignment (PCH)");
Maxa10c3982017-07-07 18:25:41 +0200439
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200440 LOGPTBFDL(tbf, LOGL_DEBUG, "Send downlink assignment on PCH, no TBF exist (IMSI=%s)\n", ms_imsi(ms));
Maxa10c3982017-07-07 18:25:41 +0200441
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200442 /* change state */
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100443 osmo_fsm_inst_dispatch(tbf->state_fi, TBF_EV_ASSIGN_ADD_CCCH, NULL);
Maxa10c3982017-07-07 18:25:41 +0200444
Pau Espin Pedrolee350082022-10-28 17:35:03 +0200445 /* send immediate assignment */
446 bts_snd_dl_ass(ms->bts, tbf);
Maxa10c3982017-07-07 18:25:41 +0200447}
448
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100449int dl_tbf_upgrade_to_multislot(struct gprs_rlcmac_dl_tbf *tbf)
450{
451 int rc;
452 struct gprs_rlcmac_trx *trx = tbf_get_trx(tbf);
453 struct gprs_rlcmac_bts *bts = trx->bts;
454
455 LOGPTBFDL(tbf, LOGL_DEBUG, "Upgrade to multislot\n");
456
457 tbf_unlink_pdch(tbf);
458 rc = the_pcu->alloc_algorithm(bts, dl_tbf_as_tbf(tbf), false, -1);
459 /* if no resource */
460 if (rc < 0) {
461 LOGPTBFDL(tbf, LOGL_ERROR, "No resources allocated during upgrade to multislot!\n");
462 bts_do_rate_ctr_inc(bts, CTR_TBF_ALLOC_FAIL);
463 return rc;
464 }
465
466 if (tbf_is_egprs_enabled(dl_tbf_as_tbf(tbf)))
467 tbf->set_window_size();
468 tbf_update_state_fsm_name(tbf);
469
Pau Espin Pedrol4a090542022-12-13 14:48:31 +0100470 /* Now trigger the assignment using the pre-existing TBF: */
471 dl_tbf_trigger_ass_on_pacch(tbf, dl_tbf_as_tbf(tbf));
Pau Espin Pedrolb7a2b592022-12-13 14:43:59 +0100472 return 0;
473}
474
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200475void gprs_rlcmac_dl_tbf::schedule_next_frame()
476{
477 struct msgb *msg;
478
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100479 if (llc_frame_length(&m_llc) != 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200480 return;
481
482 /* dequeue next LLC frame, if any */
Pau Espin Pedrol6b1e9512022-04-04 13:45:56 +0200483 msg = llc_queue_dequeue(llc_queue());
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200484 if (!msg)
485 return;
486
Max0fdaa9d2018-01-30 16:03:10 +0100487 LOGPTBFDL(this, LOGL_DEBUG, "Dequeue next LLC (len=%d)\n", msg->len);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200488
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200489 llc_put_frame(&m_llc, msg->data, msg->len);
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100490 bts_do_rate_ctr_inc(bts, CTR_LLC_FRAME_SCHED);
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200491 msgb_free(msg);
492 m_last_dl_drained_fn = -1;
493}
494
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200495int gprs_rlcmac_dl_tbf::create_new_bsn(const uint32_t fn, enum CodingScheme cs)
Daniel Willmannca102af2014-08-08 12:14:12 +0200496{
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100497 uint8_t *data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200498 gprs_rlc_data *rlc_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200499 const uint16_t bsn = m_window.v_s();
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100500 gprs_rlc_data_block_info *rdbi;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100501 int num_chunks = 0;
502 int write_offset = 0;
503 Encoding::AppendResult ar;
Daniel Willmannca102af2014-08-08 12:14:12 +0200504
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100505 if (llc_frame_length(&m_llc) == 0)
Jacob Erlbeck409efa12015-06-12 14:06:09 +0200506 schedule_next_frame();
507
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200508 OSMO_ASSERT(mcs_is_valid(cs));
Jacob Erlbecka700dd92015-06-02 16:00:41 +0200509
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100510 /* length of usable data block (single data unit w/o header) */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200511 const uint8_t block_data_len = mcs_max_data_block_bytes(cs);
Daniel Willmannca102af2014-08-08 12:14:12 +0200512
513 /* now we still have untransmitted LLC data, so we fill mac block */
514 rlc_data = m_rlc.block(bsn);
Pau Espin Pedrol5bb87b82020-05-18 11:02:39 +0200515 data = prepare(rlc_data, block_data_len);
Aravind Sirsikar91495522016-07-12 14:17:12 +0530516 rlc_data->cs_last = cs;
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530517 rlc_data->cs_current_trans = cs;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530518
519 /* Initialise the variable related to DL SPB */
520 rlc_data->spb_status.block_status_dl = EGPRS_RESEG_DL_DEFAULT;
521 rlc_data->cs_init = cs;
522
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100523 rlc_data->len = block_data_len;
Daniel Willmannca102af2014-08-08 12:14:12 +0200524
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100525 rdbi = &(rlc_data->block_info);
526 memset(rdbi, 0, sizeof(*rdbi));
527 rdbi->data_len = block_data_len;
528
529 rdbi->cv = 15; /* Final Block Indicator, set late, if true */
530 rdbi->bsn = bsn; /* Block Sequence Number */
531 rdbi->e = 1; /* Extension bit, maybe set later (1: no extension) */
532
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100533 do {
534 bool is_final;
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200535 int payload_written = 0;
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100536
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100537 if (llc_frame_length(&m_llc) == 0) {
Pau Espin Pedrol8afc6ba2021-03-02 13:19:39 +0100538 /* The data just drained, store the current fn */
539 if (m_last_dl_drained_fn < 0)
540 m_last_dl_drained_fn = fn;
541
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100542 /* It is not clear, when the next real data will
543 * arrive, so request a DL ack/nack now */
544 request_dl_ack();
Alexander Couzens1a506612016-05-24 16:55:30 +0200545
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100546 int space = block_data_len - write_offset;
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100547
548 if (num_chunks != 0) {
549 /* Nothing to send, and we already put some data in
550 * rlcmac data block, we are done */
551 LOGPTBFDL(this, LOGL_DEBUG,
552 "LLC queue completely drained and there's "
553 "still %d free bytes in rlcmac data block\n", space);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100554
555 /* We may need to update fbi in header here
556 * since m_last_dl_drained_fn was updated above
557 * Specially important when X2031 is 0. */
558 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
559 if (is_final) {
560 rdbi->cv = 0;
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100561 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Pau Espin Pedrolcf6c7122021-03-02 14:15:17 +0100562 }
563
Pau Espin Pedrol7d0f9a02020-11-27 14:51:27 +0100564 if (mcs_is_edge(cs)) {
565 /* in EGPRS there's no M bit, so we need
566 * to flag padding with LI=127 */
567 Encoding::rlc_data_to_dl_append_egprs_li_padding(rdbi,
568 &write_offset,
569 &num_chunks,
570 data);
571 }
572 break;
573 }
574
575 /* Nothing to send from upper layers (LLC), but still
576 * requested to send something to MS to delay the
577 * release of the TBF. See 3GPP TS 44.060 9.3.1a
578 * "Delayed release of downlink Temporary Block Flow" */
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100579 /* A header will need to by added, so we just need
580 * space-1 octets */
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200581 llc_put_dummy_frame(&m_llc, space - 1);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100582
Max0524e382018-01-19 18:22:25 +0100583 LOGPTBFDL(this, LOGL_DEBUG,
584 "Empty chunk, added LLC dummy command of size %d, drained_since=%d\n",
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100585 llc_frame_length(&m_llc), frames_since_last_drain(fn));
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100586 }
587
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100588 is_final = llc_queue_size(llc_queue()) == 0 && !keep_open(fn);
Jacob Erlbeckcbb1e702015-03-25 12:21:55 +0100589
Jacob Erlbeck5058bd62016-01-13 10:51:25 +0100590 ar = Encoding::rlc_data_to_dl_append(rdbi, cs,
Alexander Couzens7fdbf892016-05-21 19:45:23 +0200591 &m_llc, &write_offset, &num_chunks, data, is_final, &payload_written);
592
593 if (payload_written > 0)
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100594 bts_do_rate_ctr_add(bts, CTR_RLC_DL_PAYLOAD_BYTES, payload_written);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100595
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100596 if (ar == Encoding::AR_NEED_MORE_BLOCKS)
597 break;
598
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100599 LOGPTBFDL(this, LOGL_DEBUG, "Complete DL frame, len=%d\n", llc_frame_length(&m_llc));
600 gprs_rlcmac_dl_bw(this, llc_frame_length(&m_llc));
Pau Espin Pedrol2182e622021-01-14 16:48:38 +0100601 bts_do_rate_ctr_add(bts, CTR_LLC_DL_BYTES, llc_frame_length(&m_llc));
Pau Espin Pedrol4f8384b2022-03-31 19:36:12 +0200602 llc_reset(&m_llc);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +0100603
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100604 if (is_final) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100605 request_dl_ack();
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100606 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_LAST_DL_DATA_SENT, NULL);
Daniel Willmannca102af2014-08-08 12:14:12 +0200607 }
Jacob Erlbeckfec94d12016-01-12 17:02:49 +0100608
609 /* dequeue next LLC frame, if any */
610 schedule_next_frame();
611 } while (ar == Encoding::AR_COMPLETED_SPACE_LEFT);
612
Max0524e382018-01-19 18:22:25 +0100613 LOGPTBFDL(this, LOGL_DEBUG, "data block (BSN %d, %s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100614 bsn, mcs_name(rlc_data->cs_last),
Max0524e382018-01-19 18:22:25 +0100615 osmo_hexdump(rlc_data->block, block_data_len));
Daniel Willmannca102af2014-08-08 12:14:12 +0200616 /* raise send state and set ack state array */
617 m_window.m_v_b.mark_unacked(bsn);
618 m_window.increment_send();
619
Jacob Erlbeckd6752492016-02-02 18:12:46 +0100620 return bsn;
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100621}
622
Daniel Willmannca102af2014-08-08 12:14:12 +0200623struct msgb *gprs_rlcmac_dl_tbf::create_dl_acked_block(
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100624 const uint32_t fn, const struct gprs_rlcmac_pdch *pdch,
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100625 int index, int index2)
Daniel Willmannca102af2014-08-08 12:14:12 +0200626{
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100627 uint8_t *msg_data;
Daniel Willmannca102af2014-08-08 12:14:12 +0200628 struct msgb *dl_msg;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100629 unsigned msg_len;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100630 /* TODO: support MCS-7 - MCS-9, where data_block_idx can be 1 */
Maxb3a17d62017-12-21 12:11:33 +0100631 uint8_t data_block_idx = 0;
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100632 unsigned int rrbp;
633 uint32_t new_poll_fn;
634 int rc;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100635 bool is_final = false;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100636 gprs_rlc_data_info rlc;
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200637 enum CodingScheme cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100638 int bsns[ARRAY_SIZE(rlc.block_info)];
639 unsigned num_bsns;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100640 bool need_padding = false;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530641 enum egprs_rlcmac_dl_spb spb = EGPRS_RLCMAC_DL_NO_RETX;
642 unsigned int spb_status = get_egprs_dl_spb_status(index);
Neels Hofmeyrb6091902017-02-08 16:49:20 +0100643
644 enum egprs_puncturing_values punct[2] = {
645 EGPRS_PS_INVALID, EGPRS_PS_INVALID
646 };
647 osmo_static_assert(ARRAY_SIZE(rlc.block_info) == 2,
648 rlc_block_info_size_is_two);
649
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100650 /*
651 * TODO: This is an experimental work-around to put 2 BSN into
652 * MSC-7 to MCS-9 encoded messages. It just sends the same BSN
653 * twice in the block. The cs should be derived from the TBF's
654 * current CS such that both BSNs (that must be compatible) can
655 * be put into the data area, even if the resulting CS is higher than
656 * the current limit.
657 */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530658 cs = m_rlc.block(index)->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +0100659 enum CodingScheme cs_init = m_rlc.block(index)->cs_init;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100660 bsns[0] = index;
661 num_bsns = 1;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100662
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100663 if (index2 >= 0) {
664 bsns[num_bsns] = index2;
665 num_bsns += 1;
666 }
667
Mrinal Mishraf86307e2016-11-10 18:16:30 +0530668 update_coding_scheme_counter_dl(cs);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530669 /*
670 * if the intial mcs is 8 and retransmission mcs is either 6 or 3
671 * we have to include the padding of 6 octets in first segment
672 */
Maxd4a39292019-03-13 18:44:20 +0100673 if ((cs_init == MCS8) &&
674 (cs == MCS6 || cs == MCS3)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530675 if (spb_status == EGPRS_RESEG_DL_DEFAULT ||
Maxd4a39292019-03-13 18:44:20 +0100676 spb_status == EGPRS_RESEG_SECOND_SEG_SENT)
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530677 need_padding = true;
678 } else if (num_bsns == 1) {
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100679 /* TODO: remove the conditional when MCS-6 padding isn't
680 * failing to be decoded by MEs anymore */
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530681 /* TODO: support of MCS-8 -> MCS-6 transition should be
682 * handled
683 * Refer commit be881c028fc4da00c4046ecd9296727975c206a3
684 * dated 2016-02-07 23:45:40 (UTC)
685 */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200686 if (cs != MCS8)
687 mcs_dec_to_single_block(&cs, &need_padding);
Jacob Erlbeckbe881c02016-02-03 20:44:46 +0100688 }
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100689
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530690 spb = get_egprs_dl_spb(index);
691
Max0524e382018-01-19 18:22:25 +0100692 LOGPTBFDL(this, LOGL_DEBUG, "need_padding %d spb_status %d spb %d (BSN1 %d BSN2 %d)\n",
693 need_padding, spb_status, spb, index, index2);
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530694
695 gprs_rlc_data_info_init_dl(&rlc, cs, need_padding, spb);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100696
697 rlc.usf = 7; /* will be set at scheduler */
698 rlc.pr = 0; /* FIXME: power reduction */
699 rlc.tfi = m_tfi; /* TFI */
700
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100701 /* return data block(s) as message */
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +0200702 msg_len = mcs_size_dl(cs);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100703 dl_msg = msgb_alloc(msg_len, "rlcmac_dl_data");
704 if (!dl_msg)
705 return NULL;
706
707 msg_data = msgb_put(dl_msg, msg_len);
708
Aravind Sirsikarb1191982016-08-26 18:13:10 +0530709 OSMO_ASSERT(rlc.num_data_blocks <= ARRAY_SIZE(rlc.block_info));
710 OSMO_ASSERT(rlc.num_data_blocks > 0);
711
Max0524e382018-01-19 18:22:25 +0100712 LOGPTBFDL(this, LOGL_DEBUG, "Copying %u RLC blocks, %u BSNs\n", rlc.num_data_blocks, num_bsns);
Max5759a192017-09-08 12:23:12 +0200713
Maxb3a17d62017-12-21 12:11:33 +0100714 /* Copy block(s) to RLC message: the num_data_blocks cannot be more than 2 - see assert above */
715 for (data_block_idx = 0; data_block_idx < OSMO_MIN(rlc.num_data_blocks, 2);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100716 data_block_idx++)
717 {
718 int bsn;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100719 uint8_t *block_data;
720 gprs_rlc_data_block_info *rdbi, *block_info;
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530721 enum egprs_rlc_dl_reseg_bsn_state reseg_status;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100722
723 /* Check if there are more blocks than BSNs */
724 if (data_block_idx < num_bsns)
725 bsn = bsns[data_block_idx];
726 else
727 bsn = bsns[0];
728
Aravind Sirsikar79522822016-03-23 18:29:47 +0530729 /* Get current puncturing scheme from block */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530730
731 m_rlc.block(bsn)->next_ps = gprs_get_punct_scheme(
Aravind Sirsikar79522822016-03-23 18:29:47 +0530732 m_rlc.block(bsn)->next_ps,
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530733 m_rlc.block(bsn)->cs_last, cs, spb);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530734
Max8a8e0fb2019-03-25 16:32:50 +0100735 if (mcs_is_edge(cs)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530736 OSMO_ASSERT(m_rlc.block(bsn)->next_ps >= EGPRS_PS_1);
737 OSMO_ASSERT(m_rlc.block(bsn)->next_ps <= EGPRS_PS_3);
Aravind Sirsikar79522822016-03-23 18:29:47 +0530738 }
Maxb3a17d62017-12-21 12:11:33 +0100739
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530740 punct[data_block_idx] = m_rlc.block(bsn)->next_ps;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100741
742 rdbi = &rlc.block_info[data_block_idx];
743 block_info = &m_rlc.block(bsn)->block_info;
744
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530745 /*
746 * get data and header from current block
747 * function returns the reseg status
Aravind Sirsikar79522822016-03-23 18:29:47 +0530748 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +0530749 reseg_status = egprs_dl_get_data(bsn, &block_data);
750 m_rlc.block(bsn)->spb_status.block_status_dl = reseg_status;
751
752 /*
753 * If it is first segment of the split block set the state of
754 * bsn to nacked. If it is the first segment dont update the
755 * next ps value of bsn. since next segment also needs same cps
756 */
757 if (spb == EGPRS_RLCMAC_DL_FIRST_SEG)
758 m_window.m_v_b.mark_nacked(bsn);
759 else {
760 /*
761 * TODO: Need to handle 2 same bsns
762 * in header type 1
763 */
764 gprs_update_punct_scheme(&m_rlc.block(bsn)->next_ps,
765 cs);
766 }
Aravind Sirsikar79522822016-03-23 18:29:47 +0530767
Aravind Sirsikarcf2152b2016-07-13 18:46:17 +0530768 m_rlc.block(bsn)->cs_last = cs;
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100769 rdbi->e = block_info->e;
770 rdbi->cv = block_info->cv;
771 rdbi->bsn = bsn;
772 is_final = is_final || rdbi->cv == 0;
773
Max0524e382018-01-19 18:22:25 +0100774 LOGPTBFDL(this, LOGL_DEBUG, "Copying data unit %d (BSN %d)\n",
775 data_block_idx, bsn);
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100776
777 Encoding::rlc_copy_from_aligned_buffer(&rlc, data_block_idx,
778 msg_data, block_data);
779 }
780
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100781 /* Calculate CPS only for EGPRS case */
Max8a8e0fb2019-03-25 16:32:50 +0100782 if (mcs_is_edge(cs))
Neels Hofmeyr49b83ec2017-02-08 15:47:19 +0100783 rlc.cps = gprs_rlc_mcs_cps(cs, punct[0], punct[1], need_padding);
Daniel Willmannca102af2014-08-08 12:14:12 +0200784
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100785 /* If the TBF has just started, relate frames_since_last_poll to the
786 * current fn */
787 if (m_last_dl_poll_fn < 0)
788 m_last_dl_poll_fn = fn;
789
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200790 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
791 * when last polled DL ACK/NACK was lost. */
792 if (need_poll_for_dl_ack_nack()) {
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100793 if (m_dl_ack_requested) {
Max0524e382018-01-19 18:22:25 +0100794 LOGPTBFDL(this, LOGL_DEBUG,
Pau Espin Pedrol30f66172019-12-04 18:07:49 +0100795 "Scheduling Ack/Nack polling, because it was requested explicitly "
Max0524e382018-01-19 18:22:25 +0100796 "(e.g. first final block sent).\n");
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200797 } else if (state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK)) {
Max0524e382018-01-19 18:22:25 +0100798 LOGPTBFDL(this, LOGL_DEBUG,
799 "Scheduling Ack/Nack polling, because polling timed out.\n");
Daniel Willmannca102af2014-08-08 12:14:12 +0200800 } else {
Max0524e382018-01-19 18:22:25 +0100801 LOGPTBFDL(this, LOGL_DEBUG,
802 "Scheduling Ack/Nack polling, because %d blocks sent.\n",
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +0200803 POLL_ACK_AFTER_FRAMES);
Daniel Willmannca102af2014-08-08 12:14:12 +0200804 }
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100805
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100806 rc = check_polling(fn, pdch->ts_no, &new_poll_fn, &rrbp);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100807 if (rc >= 0) {
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100808 set_polling(new_poll_fn, pdch->ts_no, PDCH_ULC_POLL_DL_ACK);
Pau Espin Pedrola161bf42021-07-30 13:42:06 +0200809 LOGPTBFDL(this, LOGL_DEBUG,
810 "Scheduled DL Acknowledgement polling on PACCH (FN=%d, TS=%d)\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100811 new_poll_fn, pdch->ts_no);
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100812
Daniel Willmannca102af2014-08-08 12:14:12 +0200813 m_tx_counter = 0;
814 /* start timer whenever we send the final block */
Jacob Erlbeckbe314d92016-02-02 15:32:10 +0100815 if (is_final)
Pau Espin Pedrol28f160e2019-09-05 14:48:35 +0200816 T_START(this, T3191, 3191, "final block (DL-TBF)", true);
Daniel Willmannca102af2014-08-08 12:14:12 +0200817
Pau Espin Pedrol33e80072021-07-22 19:20:50 +0200818 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK); /* clear poll timeout flag */
Daniel Willmannefd5dbb2014-08-25 16:20:23 +0200819
Jacob Erlbeck7c444152015-03-12 12:08:54 +0100820 /* Clear request flag */
821 m_dl_ack_requested = false;
822
Daniel Willmannca102af2014-08-08 12:14:12 +0200823 /* set polling in header */
Jacob Erlbeckf2694b72016-01-26 21:46:26 +0100824 rlc.rrbp = rrbp;
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100825 rlc.es_p = 1; /* Polling */
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +0100826
Pau Espin Pedrol58046e42021-03-29 19:01:13 +0200827 m_last_dl_poll_fn = new_poll_fn;
Jacob Erlbeck16d29c72015-08-24 13:30:39 +0200828
Max0524e382018-01-19 18:22:25 +0100829 LOGPTBFDL(this, LOGL_INFO,
830 "Scheduled Ack/Nack polling on FN=%d, TS=%d\n",
Pau Espin Pedrold29a1432022-12-15 18:57:35 +0100831 new_poll_fn, pdch->ts_no);
Daniel Willmannca102af2014-08-08 12:14:12 +0200832 }
833 }
834
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100835 Encoding::rlc_write_dl_data_header(&rlc, msg_data);
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100836
Max0524e382018-01-19 18:22:25 +0100837 LOGPTBFDL(this, LOGL_DEBUG, "msg block (BSN %d, %s%s): %s\n",
Max136ebcc2019-03-05 14:59:03 +0100838 index, mcs_name(cs),
Max0524e382018-01-19 18:22:25 +0100839 need_padding ? ", padded" : "",
840 msgb_hexdump(dl_msg));
Jacob Erlbeck3a3b6a72016-01-11 16:15:45 +0100841
Daniel Willmannca102af2014-08-08 12:14:12 +0200842 /* Increment TX-counter */
843 m_tx_counter++;
844
Daniel Willmannca102af2014-08-08 12:14:12 +0200845 return dl_msg;
846}
847
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100848static uint16_t bitnum_to_bsn(int bitnum, uint16_t ssn)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200849{
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100850 return ssn - 1 - bitnum;
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200851}
852
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200853int gprs_rlcmac_dl_tbf::analyse_errors(char *show_rbb, uint8_t ssn,
854 ana_result *res)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200855{
856 gprs_rlc_data *rlc_data;
857 uint16_t lost = 0, received = 0, skipped = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100858 char info[RLC_MAX_WS + 1];
859 memset(info, '.', m_window.ws());
860 info[m_window.ws()] = 0;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200861 uint16_t bsn = 0;
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200862 unsigned received_bytes = 0, lost_bytes = 0;
863 unsigned received_packets = 0, lost_packets = 0;
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100864 unsigned num_blocks = strlen(show_rbb);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200865
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530866 unsigned distance = m_window.distance();
867
868 num_blocks = num_blocks > distance
869 ? distance : num_blocks;
870
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200871 /* SSN - 1 is in range V(A)..V(S)-1 */
Jacob Erlbeckb41262f2016-02-05 17:13:24 +0100872 for (unsigned int bitpos = 0; bitpos < num_blocks; bitpos++) {
873 bool is_received;
874 int index = num_blocks - 1 - bitpos;
875
876 is_received = (index >= 0 && show_rbb[index] == 'R');
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200877
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100878 bsn = m_window.mod_sns(bitnum_to_bsn(bitpos, ssn));
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200879
Jacob Erlbeck93c55d02015-12-23 16:29:07 +0100880 if (bsn == m_window.mod_sns(m_window.v_a() - 1)) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200881 info[bitpos] = '$';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200882 break;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200883 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200884
885 rlc_data = m_rlc.block(bsn);
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200886 if (!rlc_data) {
887 info[bitpos] = '0';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200888 continue;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200889 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200890
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200891 /* Get general statistics */
892 if (is_received && !m_window.m_v_b.is_acked(bsn)) {
893 received_packets += 1;
894 received_bytes += rlc_data->len;
895 } else if (!is_received && !m_window.m_v_b.is_nacked(bsn)) {
896 lost_packets += 1;
897 lost_bytes += rlc_data->len;
898 }
899
900 /* Get statistics for current CS */
901
Aravind Sirsikar91495522016-07-12 14:17:12 +0530902 if (rlc_data->cs_last != current_cs()) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200903 /* This block has already been encoded with a different
904 * CS, so it doesn't help us to decide, whether the
905 * current CS is ok. Ignore it. */
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200906 info[bitpos] = 'x';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200907 skipped += 1;
908 continue;
909 }
910
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200911 if (is_received) {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200912 if (!m_window.m_v_b.is_acked(bsn)) {
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200913 received += 1;
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200914 info[bitpos] = 'R';
915 } else {
916 info[bitpos] = 'r';
917 }
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200918 } else {
Jacob Erlbecka17fccb2015-06-04 16:52:23 +0200919 info[bitpos] = 'L';
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200920 lost += 1;
921 }
922 }
923
Max0524e382018-01-19 18:22:25 +0100924 LOGPTBFDL(this, LOGL_DEBUG,
925 "DL analysis, range=%d:%d, lost=%d, recv=%d, skipped=%d, bsn=%d, info='%s'\n",
926 m_window.v_a(), m_window.v_s(), lost, received, skipped, bsn, info);
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200927
Jacob Erlbeck2db0f082015-09-07 18:49:00 +0200928 res->received_packets = received_packets;
929 res->lost_packets = lost_packets;
930 res->received_bytes = received_bytes;
931 res->lost_bytes = lost_bytes;
932
Jacob Erlbeck144a1d02015-06-04 16:51:44 +0200933 if (lost + received <= 1)
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200934 return -1;
935
936 return lost * 100 / (lost + received);
937}
938
Pau Espin Pedrolb3f23972020-10-23 21:00:23 +0200939gprs_rlc_window *gprs_rlcmac_dl_tbf::window()
Maxea98b7d2018-01-04 15:13:27 +0100940{
941 return &m_window;
942}
943
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100944int gprs_rlcmac_dl_tbf::update_window(unsigned first_bsn,
945 const struct bitvec *rbb)
946{
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530947 unsigned dist;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100948 uint16_t lost = 0, received = 0;
949 char show_v_b[RLC_MAX_SNS + 1];
950 char show_rbb[RLC_MAX_SNS + 1];
951 int error_rate;
952 struct ana_result ana_res;
aravind sirsikarfb41afa2016-11-02 15:48:00 +0530953 dist = m_window.distance();
954 unsigned num_blocks = rbb->cur_bit > dist
955 ? dist : rbb->cur_bit;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100956 unsigned behind_last_bsn = m_window.mod_sns(first_bsn + num_blocks);
957
958 Decoding::extract_rbb(rbb, show_rbb);
959 /* show received array in debug */
Max0524e382018-01-19 18:22:25 +0100960 LOGPTBFDL(this, LOGL_DEBUG,
961 "ack: (BSN=%d)\"%s\"(BSN=%d) R=ACK I=NACK\n",
962 first_bsn, show_rbb, m_window.mod_sns(behind_last_bsn - 1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100963
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100964 error_rate = analyse_errors(show_rbb, behind_last_bsn, &ana_res);
965
Pau Espin Pedrole8dcf642021-01-14 13:17:01 +0100966 if (the_pcu->vty.cs_adj_enabled && ms())
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +0100967 ms_update_error_rate(ms(), this, error_rate);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100968
969 m_window.update(bts, rbb, first_bsn, &lost, &received);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +0200970 rate_ctr_add(rate_ctr_group_get_ctr(m_ctrs, TBF_CTR_RLC_NACKED), lost);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100971
972 /* report lost and received packets */
973 gprs_rlcmac_received_lost(this, received, lost);
974
975 /* Used to measure the leak rate */
976 gprs_bssgp_update_bytes_received(ana_res.received_bytes,
977 ana_res.received_packets + ana_res.lost_packets);
978
979 /* raise V(A), if possible */
980 m_window.raise(m_window.move_window());
981
982 /* show receive state array in debug (V(A)..V(S)-1) */
983 m_window.show_state(show_v_b);
Max0524e382018-01-19 18:22:25 +0100984 LOGPTBFDL(this, LOGL_DEBUG,
985 "V(B): (V(A)=%d)\"%s\"(V(S)-1=%d) A=Acked N=Nacked U=Unacked X=Resend-Unacked I=Invalid\n",
986 m_window.v_a(), show_v_b, m_window.v_s_mod(-1));
Jacob Erlbeckeb08f862016-02-05 17:07:12 +0100987 return 0;
988}
Jacob Erlbeck1751c622015-06-04 12:12:32 +0200989
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +0200990int gprs_rlcmac_dl_tbf::rcvd_dl_final_ack()
Daniel Willmannca102af2014-08-08 12:14:12 +0200991{
Pau Espin Pedrolf48de622021-07-30 14:48:06 +0200992 uint16_t received;
Pau Espin Pedrol091642a2022-10-28 18:01:31 +0200993 int rc = 0;
Pau Espin Pedrolf48de622021-07-30 14:48:06 +0200994
Pau Espin Pedrolf197f152022-11-17 20:18:46 +0100995 osmo_fsm_inst_dispatch(this->state_fi, TBF_EV_FINAL_ACK_RECVD, NULL);
Pau Espin Pedrolf48de622021-07-30 14:48:06 +0200996
997 /* range V(A)..V(S)-1 */
998 received = m_window.count_unacked();
999 /* report all outstanding packets as received */
1000 gprs_rlcmac_received_lost(this, received, 0);
1001 m_tx_counter = 0;
1002 m_window.reset();
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001003
1004 /* check for LLC PDU in the LLC Queue */
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001005 if (llc_queue_size(llc_queue()) > 0)
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001006 /* we have more data so we will re-use this tbf */
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001007 rc = ms_new_dl_tbf_assigned_on_pacch(ms(), dl_tbf_as_tbf(this));
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001008
Pau Espin Pedrol091642a2022-10-28 18:01:31 +02001009 return rc;
Jacob Erlbeck91ff7d12015-09-01 11:20:29 +02001010}
1011
Max7df82d42017-12-15 11:14:30 +01001012int gprs_rlcmac_dl_tbf::rcvd_dl_ack(bool final_ack, unsigned first_bsn,
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001013 struct bitvec *rbb)
1014{
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001015 int rc;
Maxc21f0072017-12-15 17:36:45 +01001016 LOGPTBFDL(this, LOGL_DEBUG, "downlink acknowledge\n");
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001017
Pau Espin Pedrolfbc1baa2021-07-28 21:59:00 +02001018 state_fsm.state_flags |= (1 << GPRS_RLCMAC_FLAG_DL_ACK);
1019 state_fsm.state_flags &= ~(1 << GPRS_RLCMAC_FLAG_TO_DL_ACK);
1020
1021 /* reset N3105 */
1022 n_reset(N3105);
1023 t_stop(T3191, "ACK/NACK received");
1024
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001025 rc = update_window(first_bsn, rbb);
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001026
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001027 if (final_ack) {
Max0524e382018-01-19 18:22:25 +01001028 LOGPTBFDL(this, LOGL_DEBUG, "Final ACK received.\n");
Pau Espin Pedrolefcb0462021-07-26 12:33:39 +02001029 rc = rcvd_dl_final_ack();
Pau Espin Pedroldc2aaac2021-05-14 12:50:46 +02001030 } else if (state_is(TBF_ST_FINISHED) && m_window.window_empty()) {
Max0524e382018-01-19 18:22:25 +01001031 LOGPTBFDL(this, LOGL_NOTICE,
1032 "Received acknowledge of all blocks, but without final ack indication (don't worry)\n");
Jacob Erlbeckb4beb542016-01-15 13:38:31 +01001033 }
1034
1035 return rc;
Jacob Erlbeckeb08f862016-02-05 17:07:12 +01001036}
1037
Daniel Willmannca102af2014-08-08 12:14:12 +02001038bool gprs_rlcmac_dl_tbf::dl_window_stalled() const
1039{
1040 return m_window.window_stalled();
1041}
1042
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001043void gprs_rlcmac_dl_tbf::request_dl_ack()
1044{
1045 m_dl_ack_requested = true;
1046}
1047
Pau Espin Pedrol8fa3e062022-10-28 17:38:52 +02001048void dl_tbf_request_dl_ack(struct gprs_rlcmac_dl_tbf *dl_tbf) {
Pau Espin Pedrol14beef62022-10-26 19:44:07 +02001049 dl_tbf->request_dl_ack();
1050}
1051
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001052/* Does this DL TBF require to poll the MS for DL ACK/NACK? */
1053bool gprs_rlcmac_dl_tbf::need_poll_for_dl_ack_nack() const
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001054{
Pau Espin Pedrol405d2d12021-07-29 18:14:07 +02001055 /* poll after POLL_ACK_AFTER_FRAMES frames, or when final block is tx or
1056 * when last polled DL ACK/NACK was lost. */
Pau Espin Pedrol33e80072021-07-22 19:20:50 +02001057 return state_fsm.state_flags & (1 << GPRS_RLCMAC_FLAG_TO_DL_ACK) ||
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001058 m_tx_counter >= POLL_ACK_AFTER_FRAMES ||
1059 m_dl_ack_requested;
1060}
1061
1062bool gprs_rlcmac_dl_tbf::have_data() const
1063{
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001064 return llc_chunk_size(&m_llc) > 0 ||
1065 (llc_queue_size(llc_queue()) > 0);
Jacob Erlbeckeceb9102015-03-20 14:41:50 +01001066}
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001067
Max9dabfa22017-05-16 16:10:45 +02001068static inline int frames_since_last(int32_t last, unsigned fn)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001069{
Max9dabfa22017-05-16 16:10:45 +02001070 unsigned wrapped = (fn + GSM_MAX_FN - last) % GSM_MAX_FN;
1071
1072 if (last < 0)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001073 return -1;
1074
Max9dabfa22017-05-16 16:10:45 +02001075 if (wrapped < GSM_MAX_FN/2)
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001076 return wrapped;
Max9dabfa22017-05-16 16:10:45 +02001077
1078 return wrapped - GSM_MAX_FN;
1079}
1080
1081int gprs_rlcmac_dl_tbf::frames_since_last_poll(unsigned fn) const
1082{
1083 return frames_since_last(m_last_dl_poll_fn, fn);
Jacob Erlbeck005ee7f2015-03-20 14:53:54 +01001084}
1085
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001086int gprs_rlcmac_dl_tbf::frames_since_last_drain(unsigned fn) const
1087{
Max9dabfa22017-05-16 16:10:45 +02001088 return frames_since_last(m_last_dl_drained_fn, fn);
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001089}
1090
1091bool gprs_rlcmac_dl_tbf::keep_open(unsigned fn) const
1092{
1093 int keep_time_frames;
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001094 unsigned long dl_tbf_idle_msec;
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001095 int since_last_drain;
1096 bool keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001097
Pau Espin Pedrol924aaad2021-01-14 12:01:42 +01001098 dl_tbf_idle_msec = osmo_tdef_get(the_pcu->T_defs, -2031, OSMO_TDEF_MS, -1);
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001099 if (dl_tbf_idle_msec == 0)
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001100 return false;
1101
Pau Espin Pedrol2b5c6292019-09-09 13:41:00 +02001102 keep_time_frames = msecs_to_frames(dl_tbf_idle_msec);
Pau Espin Pedrol5b9d0bb2021-03-02 12:53:58 +01001103 since_last_drain = frames_since_last_drain(fn);
1104 keep = since_last_drain <= keep_time_frames;
1105
1106 if (since_last_drain >= 0)
1107 LOGPTBFDL(this, LOGL_DEBUG, "Keep idle TBF open: %d/%d -> %s\n",
1108 since_last_drain, keep_time_frames, keep ? "yes" : "no");
1109 return keep;
Jacob Erlbeck3bed5d12015-03-19 11:22:38 +01001110}
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301111
1112/*
1113 * This function returns the pointer to data which needs
1114 * to be copied. Also updates the status of the block related to
1115 * Split block handling in the RLC/MAC block.
1116 */
1117enum egprs_rlc_dl_reseg_bsn_state
1118 gprs_rlcmac_dl_tbf::egprs_dl_get_data(int bsn, uint8_t **block_data)
1119{
1120 gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1121 egprs_rlc_dl_reseg_bsn_state *block_status_dl =
1122 &rlc_data->spb_status.block_status_dl;
1123
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001124 enum CodingScheme cs_init = rlc_data->cs_init;
1125 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001126
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001127 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1128 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Maxd4a39292019-03-13 18:44:20 +01001129
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301130 *block_data = &rlc_data->block[0];
1131
1132 /*
1133 * Table 10.3a.0.1 of 44.060
1134 * MCS6,9: second segment starts at 74/2 = 37
1135 * MCS5,7: second segment starts at 56/2 = 28
1136 * MCS8: second segment starts at 31
1137 * MCS4: second segment starts at 44/2 = 22
1138 */
Maxd4a39292019-03-13 18:44:20 +01001139 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301140 if (*block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
Maxd4a39292019-03-13 18:44:20 +01001141 switch (cs_init) {
Maxbea2edb2019-03-06 17:04:59 +01001142 case MCS6 :
1143 case MCS9 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301144 *block_data = &rlc_data->block[37];
1145 break;
Maxbea2edb2019-03-06 17:04:59 +01001146 case MCS7 :
1147 case MCS5 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301148 *block_data = &rlc_data->block[28];
1149 break;
Maxbea2edb2019-03-06 17:04:59 +01001150 case MCS8 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301151 *block_data = &rlc_data->block[31];
1152 break;
Maxbea2edb2019-03-06 17:04:59 +01001153 case MCS4 :
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301154 *block_data = &rlc_data->block[22];
1155 break;
1156 default:
Max0524e382018-01-19 18:22:25 +01001157 LOGPTBFDL(this, LOGL_ERROR,
1158 "FIXME: Software error: hit invalid condition. "
1159 "headerType(%d) blockstatus(%d) cs(%s) PLEASE FIX!\n",
Maxd4a39292019-03-13 18:44:20 +01001160 ht_cs_current_trans,
Max136ebcc2019-03-05 14:59:03 +01001161 *block_status_dl, mcs_name(cs_init));
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301162 break;
1163
1164 }
1165 return EGPRS_RESEG_SECOND_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001166 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1167 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301168 return EGPRS_RESEG_FIRST_SEG_SENT;
Maxd4a39292019-03-13 18:44:20 +01001169 } else if ((cs_init == MCS4) &&
1170 (cs_current_trans == MCS1)) {
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301171 return EGPRS_RESEG_FIRST_SEG_SENT;
1172 }
1173 }
1174 return EGPRS_RESEG_DL_DEFAULT;
1175}
1176
1177/*
1178 * This function returns the status of split block
1179 * for RLC/MAC block.
1180 */
1181unsigned int gprs_rlcmac_dl_tbf::get_egprs_dl_spb_status(const int bsn)
1182{
1183 const gprs_rlc_data *rlc_data = m_rlc.block(bsn);
1184
1185 return rlc_data->spb_status.block_status_dl;
1186}
1187
1188/*
1189 * This function returns the spb value to be sent OTA
1190 * for RLC/MAC block.
1191 */
1192enum egprs_rlcmac_dl_spb gprs_rlcmac_dl_tbf::get_egprs_dl_spb(const int bsn)
1193{
1194 struct gprs_rlc_data *rlc_data = m_rlc.block(bsn);
Maxd4a39292019-03-13 18:44:20 +01001195 egprs_rlc_dl_reseg_bsn_state block_status_dl = rlc_data->spb_status.block_status_dl;
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301196
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001197 enum CodingScheme cs_init = rlc_data->cs_init;
1198 enum CodingScheme cs_current_trans = rlc_data->cs_current_trans;
Maxd4a39292019-03-13 18:44:20 +01001199
Pau Espin Pedrol2ae83372020-05-18 11:35:35 +02001200 enum HeaderType ht_cs_init = mcs_header_type(rlc_data->cs_init);
1201 enum HeaderType ht_cs_current_trans = mcs_header_type(rlc_data->cs_current_trans);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301202
1203 /* Table 10.4.8b.1 of 44.060 */
Maxd4a39292019-03-13 18:44:20 +01001204 if (ht_cs_current_trans == HEADER_EGPRS_DATA_TYPE_3) {
1205 /*
1206 * if we are sending the second segment the spb should be 3
1207 * otherwise it should be 2
1208 */
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301209 if (block_status_dl == EGPRS_RESEG_FIRST_SEG_SENT) {
sivasankarida7250a2016-12-16 12:57:18 +05301210 /* statistics */
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001211 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_SECOND_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301212 return EGPRS_RLCMAC_DL_SEC_SEG;
Maxd4a39292019-03-13 18:44:20 +01001213 } else if ((ht_cs_init == HEADER_EGPRS_DATA_TYPE_1) ||
1214 (ht_cs_init == HEADER_EGPRS_DATA_TYPE_2)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001215 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301216 return EGPRS_RLCMAC_DL_FIRST_SEG;
Maxd4a39292019-03-13 18:44:20 +01001217 } else if ((cs_init == MCS4) &&
1218 (cs_current_trans == MCS1)) {
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001219 bts_do_rate_ctr_inc(bts, CTR_SPB_DL_FIRST_SEGMENT);
Aravind Sirsikar50b09702016-08-22 17:21:10 +05301220 return EGPRS_RLCMAC_DL_FIRST_SEG;
1221 }
1222 }
1223 /* Non SPB cases 0 is reurned */
1224 return EGPRS_RLCMAC_DL_NO_RETX;
1225}
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301226
Max9d7357e2017-12-14 15:02:33 +01001227void gprs_rlcmac_dl_tbf::set_window_size()
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301228{
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001229 const struct gprs_rlcmac_bts *b = bts;
Max34513fe2018-12-11 16:47:30 +01001230 uint16_t ws = egprs_window_size(b, dl_slots());
1231
Max0524e382018-01-19 18:22:25 +01001232 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 +01001233 ws, bts->pcu->vty.ws_base, pcu_bitcount(dl_slots()), bts->pcu->vty.ws_pdch);
Aravind Sirsikar8e70bb52016-09-15 17:51:16 +05301234 m_window.set_ws(ws);
1235}
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301236
Maxfb59a932019-03-13 18:40:19 +01001237void gprs_rlcmac_dl_tbf::update_coding_scheme_counter_dl(enum CodingScheme cs)
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301238{
Maxfb59a932019-03-13 18:40:19 +01001239 switch (cs) {
1240 case CS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001241 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001242 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS1));
Maxfb59a932019-03-13 18:40:19 +01001243 break;
1244 case CS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001245 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001246 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS2));
Maxfb59a932019-03-13 18:40:19 +01001247 break;
1248 case CS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001249 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001250 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_gprs_ctrs, TBF_CTR_GPRS_DL_CS3));
Maxfb59a932019-03-13 18:40:19 +01001251 break;
1252 case CS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001253 bts_do_rate_ctr_inc(bts, CTR_GPRS_DL_CS4);
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_CS4));
Maxfb59a932019-03-13 18:40:19 +01001255 break;
1256 case MCS1:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001257 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS1);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001258 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS1));
Maxfb59a932019-03-13 18:40:19 +01001259 break;
1260 case MCS2:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001261 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS2);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001262 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS2));
Maxfb59a932019-03-13 18:40:19 +01001263 break;
1264 case MCS3:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001265 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS3);
Pau Espin Pedrol9c1db172021-06-04 17:05:51 +02001266 rate_ctr_inc(rate_ctr_group_get_ctr(m_dl_egprs_ctrs, TBF_CTR_EGPRS_DL_MCS3));
Maxfb59a932019-03-13 18:40:19 +01001267 break;
1268 case MCS4:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001269 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS4);
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_MCS4));
Maxfb59a932019-03-13 18:40:19 +01001271 break;
1272 case MCS5:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001273 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS5);
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_MCS5));
Maxfb59a932019-03-13 18:40:19 +01001275 break;
1276 case MCS6:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001277 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS6);
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_MCS6));
Maxfb59a932019-03-13 18:40:19 +01001279 break;
1280 case MCS7:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001281 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS7);
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_MCS7));
Maxfb59a932019-03-13 18:40:19 +01001283 break;
1284 case MCS8:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001285 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS8);
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_MCS8));
Maxfb59a932019-03-13 18:40:19 +01001287 break;
1288 case MCS9:
Pau Espin Pedrol2182e622021-01-14 16:48:38 +01001289 bts_do_rate_ctr_inc(bts, CTR_EGPRS_DL_MCS9);
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_MCS9));
Maxfb59a932019-03-13 18:40:19 +01001291 break;
1292 default:
1293 LOGPTBFDL(this, LOGL_ERROR, "attempting to update rate counters for unsupported (M)CS %s\n",
1294 mcs_name(cs));
Mrinal Mishraf86307e2016-11-10 18:16:30 +05301295 }
1296}
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001297
Pau Espin Pedrolcc30b052022-10-27 15:25:55 +02001298struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf(struct gprs_rlcmac_tbf *tbf)
Pau Espin Pedrolda971ee2020-12-16 15:59:45 +01001299{
1300 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1301 return static_cast<gprs_rlcmac_dl_tbf *>(tbf);
1302 else
1303 return NULL;
1304}
Pau Espin Pedrol1e1275f2022-11-17 20:57:34 +01001305
1306const struct gprs_rlcmac_dl_tbf *tbf_as_dl_tbf_const(const struct gprs_rlcmac_tbf *tbf)
1307{
1308 if (tbf && tbf->direction == GPRS_RLCMAC_DL_TBF)
1309 return static_cast<const gprs_rlcmac_dl_tbf *>(tbf);
1310 else
1311 return NULL;
1312}