blob: 27b01d793234ab01ba663ab4fb192192853b4811 [file] [log] [blame]
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +02001/* gprs_rlcmac.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.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 */
21
22#include <gprs_rlcmac.h>
23#include <gprs_debug.h>
Holger Hans Peter Freyther34bd8bd2013-10-19 21:10:38 +020024#include <bts.h>
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020025#include <tbf.h>
26
27#include <errno.h>
28
29/* 3GPP TS 05.02 Annex B.1 */
30
31#define MS_NA 255 /* N/A */
32#define MS_A 254 /* 1 with hopping, 0 without */
33#define MS_B 253 /* 1 with hopping, 0 without (change Rx to Tx)*/
34#define MS_C 252 /* 1 with hopping, 0 without (change Tx to Rx)*/
35
36struct gprs_ms_multislot_class {
37 uint8_t rx, tx, sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
38 uint8_t ta, tb, ra, rb; /* Minimum Number of Slots */
39 uint8_t type; /* Type of Mobile */
40};
41
42static const struct gprs_ms_multislot_class gprs_ms_multislot_class[32] = {
43/* M-S Class Rx Tx Sum Tta Ttb Tra Trb Type */
44/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
45/* 1 */ { 1, 1, 2, 3, 2, 4, 2, 1 },
46/* 2 */ { 2, 1, 3, 3, 2, 3, 1, 1 },
47/* 3 */ { 2, 2, 3, 3, 2, 3, 1, 1 },
48/* 4 */ { 3, 1, 4, 3, 1, 3, 1, 1 },
49/* 5 */ { 2, 2, 4, 3, 1, 3, 1, 1 },
50/* 6 */ { 3, 2, 4, 3, 1, 3, 1, 1 },
51/* 7 */ { 3, 3, 4, 3, 1, 3, 1, 1 },
52/* 8 */ { 4, 1, 5, 3, 1, 2, 1, 1 },
53/* 9 */ { 3, 2, 5, 3, 1, 2, 1, 1 },
54/* 10 */ { 4, 2, 5, 3, 1, 2, 1, 1 },
55/* 11 */ { 4, 3, 5, 3, 1, 2, 1, 1 },
56/* 12 */ { 4, 4, 5, 2, 1, 2, 1, 1 },
57/* 13 */ { 3, 3, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
58/* 14 */ { 4, 4, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
59/* 15 */ { 5, 5, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
60/* 16 */ { 6, 6, MS_NA, MS_NA, MS_A, 2, MS_A, 2 },
61/* 17 */ { 7, 7, MS_NA, MS_NA, MS_A, 1, 0, 2 },
62/* 18 */ { 8, 8, MS_NA, MS_NA, 0, 0, 0, 2 },
63/* 19 */ { 6, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
64/* 20 */ { 6, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
65/* 21 */ { 6, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
66/* 22 */ { 6, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
67/* 23 */ { 6, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
68/* 24 */ { 8, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
69/* 25 */ { 8, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
70/* 26 */ { 8, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
71/* 27 */ { 8, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
72/* 28 */ { 8, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
73/* 29 */ { 8, 8, MS_NA, 2, MS_B, 2, MS_C, 1 },
74/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
75/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
76};
77
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +020078static inline int8_t find_free_usf(struct gprs_rlcmac_pdch *pdch)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020079{
Daniel Willmanncd44ec42014-08-07 15:04:57 +020080 struct gprs_rlcmac_ul_tbf *tbf;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020081 uint8_t usf_map = 0;
82 uint8_t tfi, usf;
83
84 /* make map of used USF */
85 for (tfi = 0; tfi < 32; tfi++) {
Daniel Willmann17a1d5e2014-05-30 20:21:30 +020086 tbf = pdch->ul_tbf_by_tfi(tfi);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020087 if (!tbf)
88 continue;
Daniel Willmann7e994e32014-08-07 15:49:21 +020089 usf_map |= (1 << tbf->m_usf[pdch->ts_no]);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020090 }
91
92 /* look for USF, don't use USF=7 */
93 for (usf = 0; usf < 7; usf++) {
94 if (!(usf_map & (1 << usf)))
95 return usf;
96 }
97
98 return -1;
99}
100
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200101static int find_enabled_pdch(struct gprs_rlcmac_trx *trx, const uint8_t start_ts)
102{
103 int ts;
104 for (ts = start_ts; ts < 8; ts++) {
105 struct gprs_rlcmac_pdch *pdch;
106
107 pdch = &trx->pdch[ts];
Holger Hans Peter Freyther17b0d832013-10-19 17:37:48 +0200108 if (!pdch->is_enabled()) {
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200109 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because "
110 "not enabled\n", ts);
111 continue;
112 }
113 return ts;
114 }
115
116 return 8;
117}
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200118
Holger Hans Peter Freyther743bafa2013-09-29 07:50:50 +0200119static void assign_uplink_tbf_usf(
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200120 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200121 struct gprs_rlcmac_ul_tbf *tbf, int8_t usf)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200122{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100123 tbf->trx->ul_tbf[tbf->tfi()] = tbf;
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200124 tbf->pdch[pdch->ts_no] = pdch;
Daniel Willmann7e994e32014-08-07 15:49:21 +0200125 tbf->m_usf[pdch->ts_no] = usf;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200126}
127
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200128static void assign_dlink_tbf(
129 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200130 struct gprs_rlcmac_dl_tbf *tbf)
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200131{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100132 tbf->trx->dl_tbf[tbf->tfi()] = tbf;
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200133 tbf->pdch[pdch->ts_no] = pdch;
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200134}
135
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200136
137/* Slot Allocation: Algorithm A
138 *
139 * Assign single slot for uplink and downlink
140 */
141int alloc_algorithm_a(struct gprs_rlcmac_bts *bts,
142 struct gprs_rlcmac_tbf *old_tbf,
143 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
144{
145 struct gprs_rlcmac_pdch *pdch;
146 uint8_t ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200147
148 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm A) for class "
149 "%d\n", tbf->ms_class);
150
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200151 ts = find_enabled_pdch(tbf->trx, 0);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200152 if (ts == 8)
153 return -EINVAL;
154
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200155 pdch = &tbf->trx->pdch[ts];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200156 if (tbf->direction == GPRS_RLCMAC_UL_TBF) {
Holger Hans Peter Freyther948a3d62013-09-30 14:10:23 +0200157 int8_t usf; /* must be signed */
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200158 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Holger Hans Peter Freyther948a3d62013-09-30 14:10:23 +0200159
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200160 /* if USF available */
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200161 usf = find_free_usf(pdch);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200162 if (usf < 0) {
163 LOGP(DRLCMAC, LOGL_NOTICE, "- Failed "
164 "allocating TS=%d, no USF available\n", ts);
165 return -EBUSY;
166 }
167 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign uplink "
168 "TS=%d USF=%d\n", ts, usf);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200169 assign_uplink_tbf_usf(pdch, ul_tbf, usf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200170 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200171 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200172 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign downlink TS=%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200173 assign_dlink_tbf(pdch, dl_tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200174 }
175 /* the only one TS is the common TS */
176 tbf->first_ts = tbf->first_common_ts = ts;
177
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200178 tbf->upgrade_to_multislot = 0;
179
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200180 return 0;
181}
182
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100183/*
184 * Select a window of Rx slots if available.
185 * The maximum allowed slots depend on RX or the window of available
186 * slots. This must be done for uplink TBF also, because it is the basis
187 * for calculating control slot and uplink slot(s).
188 */
189static uint8_t select_dl_slots(struct gprs_rlcmac_trx *trx,
190 const int ms_type, const int ms_max_rxslots,
191 uint8_t *out_rx_win_min, uint8_t *out_rx_win_max)
192
193{
194 uint8_t rx_window = 0;
195 int rx_window_size = 0;
196 int8_t last_tsc = -1; /* must be signed */
197 uint8_t rx_win_min = 0, rx_win_max = 0;
198
199 for (int ts_no = 0; ts_no < 8; ts_no++) {
200 struct gprs_rlcmac_pdch *pdch;
201 pdch = &trx->pdch[ts_no];
202
203 /* check if enabled */
204 if (!pdch->is_enabled()) {
205 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because "
206 "not enabled\n", ts_no);
207 if (ms_type == 1 && rx_window)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100208 goto inc_window;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100209 continue;
210 }
211 /* check if TSC changes */
212 if (last_tsc < 0)
213 last_tsc = pdch->tsc;
214 else if (last_tsc != pdch->tsc) {
215 LOGP(DRLCMAC, LOGL_ERROR, "Skipping TS %d of TRX=%d, "
216 "because it has different TSC than lower TS "
217 "of TRX. In order to allow multislot, all "
218 "slots must be configured with the same "
219 "TSC!\n", ts_no, trx->trx_no);
220 if (ms_type == 1 && rx_window)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100221 goto inc_window;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100222 continue;
223 }
224
225 if (!rx_window)
226 rx_win_min = ts_no;
227
228 rx_window |= (1 << ts_no);
229 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected DL TS %d\n", ts_no);
230
231 /* range of window (required for Type 1) */
232 rx_win_max = ts_no;
233
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100234inc_window:
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100235 if (++rx_window_size == ms_max_rxslots) {
236 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because slots / "
237 "window reached maximum alowed Rx size\n");
238 break;
239 }
Andreas Eversbergccde4c42014-01-04 15:17:22 +0100240 if (ms_type == 1 && rx_window_size == 5) {
241 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because slots / "
242 "window reached maximum supported Rx size of "
243 "this algorithm\n");
244 break;
245 }
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100246 }
247
248 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected slots for RX: "
249 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
250 ((rx_window & 0x01)) ? 'D' : '.',
251 ((rx_window & 0x02)) ? 'D' : '.',
252 ((rx_window & 0x04)) ? 'D' : '.',
253 ((rx_window & 0x08)) ? 'D' : '.',
254 ((rx_window & 0x10)) ? 'D' : '.',
255 ((rx_window & 0x20)) ? 'D' : '.',
256 ((rx_window & 0x40)) ? 'D' : '.',
257 ((rx_window & 0x80)) ? 'D' : '.');
258
259 *out_rx_win_min = rx_win_min;
260 *out_rx_win_max = rx_win_max;
261 return rx_window;
262}
263
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100264static int reduce_rx_window(const int ms_type, const struct gprs_rlcmac_tbf *old_tbf,
265 const int Tt, const int Tr,
266 int *rx_window,
267 uint8_t *rx_win_min, uint8_t *rx_win_max)
268{
269 if (ms_type != 1)
270 return 0;
271 if (!old_tbf)
272 return 0;
273 if (old_tbf->direction != GPRS_RLCMAC_UL_TBF)
274 return 0;
275
276 uint8_t collide = 0, ul_usage = 0;
277
278 /* calculate mask of colliding slots */
279 for (uint8_t ts_no = 0; ts_no < 8; ts_no++) {
280 int j;
281 if (!old_tbf->pdch[ts_no])
282 continue;
283
284 ul_usage |= (1 << ts_no);
285 /* mark bits from TS-t .. TS+r */
Andreas Eversberg91670552014-05-29 11:08:58 +0200286 for (j = (ts_no - Tt) & 7; j != ((ts_no + Tr + 1) & 7); j = (j + 1) & 7)
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100287 collide |= (1 << j);
288 }
289
290 LOGP(DRLCMAC, LOGL_DEBUG, "- Not allowed slots due to existing "
291 "UL allocation: (TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7) "
292 " D=downlink x=not usable\n",
293 ((ul_usage & 0x01)) ? 'D' : ((collide & 0x01))?'x':'.',
294 ((ul_usage & 0x02)) ? 'D' : ((collide & 0x02))?'x':'.',
295 ((ul_usage & 0x04)) ? 'D' : ((collide & 0x04))?'x':'.',
296 ((ul_usage & 0x08)) ? 'D' : ((collide & 0x08))?'x':'.',
297 ((ul_usage & 0x10)) ? 'D' : ((collide & 0x10))?'x':'.',
298 ((ul_usage & 0x20)) ? 'D' : ((collide & 0x20))?'x':'.',
299 ((ul_usage & 0x40)) ? 'D' : ((collide & 0x40))?'x':'.',
300 ((ul_usage & 0x80)) ? 'D' : ((collide & 0x80))?'x':'.');
301
302 /*
303 * Uplink/Downlink in GSM is shifted by three timeslots. Make
304 * sure they don't collide.
305 */
306 *rx_window &= ~(collide << 3);
307 *rx_window &= ~(collide >> 5);
308 LOGP(DRLCMAC, LOGL_DEBUG, "- Remaining slots for RX: "
309 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
310 ((*rx_window & 0x01)) ? 'D' : '.',
311 ((*rx_window & 0x02)) ? 'D' : '.',
312 ((*rx_window & 0x04)) ? 'D' : '.',
313 ((*rx_window & 0x08)) ? 'D' : '.',
314 ((*rx_window & 0x10)) ? 'D' : '.',
315 ((*rx_window & 0x20)) ? 'D' : '.',
316 ((*rx_window & 0x40)) ? 'D' : '.',
317 ((*rx_window & 0x80)) ? 'D' : '.');
318
319 if (!*rx_window) {
320 LOGP(DRLCMAC, LOGL_NOTICE, "No suitable downlink slots "
321 "available with current uplink assignment\n");
322 return -EBUSY;
323 }
324
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100325 return 0;
326}
327
328/* shrink range of rx_win_min and rx_win_max */
329static void shrink_rx_window(uint8_t *rx_win_min, uint8_t *rx_win_max, int rx_window)
330{
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100331 /* calculate new min/max */
332 for (uint8_t ts_no = *rx_win_min; ts_no <= *rx_win_max; ts_no++) {
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100333 if ((rx_window & (1 << ts_no)))
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100334 break;
335 *rx_win_min = ts_no + 1;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100336 LOGP(DRLCMAC, LOGL_DEBUG, "- TS is unused, so "
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100337 "raising start of DL window to %d\n",
338 *rx_win_min);
339 }
340 for (uint8_t ts_no = *rx_win_max; ts_no >= *rx_win_min; ts_no--) {
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100341 if ((rx_window & (1 << ts_no)))
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100342 break;
343 *rx_win_max = ts_no - 1;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100344 LOGP(DRLCMAC, LOGL_DEBUG, "- TS is unused, so "
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100345 "lowering end of DL window to %d\n",
346 *rx_win_max);
347 }
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100348}
349
Holger Hans Peter Freytherdd4af802013-12-25 21:03:42 +0100350/*
351 * reduce window, to allow at least one uplink TX slot
352 * this is only required for Type 1
353 */
354static uint8_t update_rx_win_max(const int ms_type, const int Tt,
355 const int Tr, uint8_t rx_win_min, uint8_t rx_win_max)
356{
357 if (ms_type != 1)
358 return rx_win_max;
359
360 if (rx_win_max - rx_win_min + 1 + Tt + 1 + Tr > 8) {
361 rx_win_max = rx_win_min + 7 - Tt - 1 - Tr;
362 LOGP(DRLCMAC, LOGL_DEBUG, "- Reduce RX window due to time "
363 "contraints to %d slots\n", rx_win_max - rx_win_min + 1);
364 }
365
366 return rx_win_max;
367}
368
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100369static void tx_win_from_rx(const int ms_type,
370 uint8_t rx_win_min, uint8_t rx_win_max,
371 int Tt, int Tr,
372 uint8_t *tx_win_min, uint8_t *tx_win_max,
373 uint8_t *tx_range)
374{
375 if (ms_type == 1) {
376 /* calculate TX window (shifted by 3 timeslots)
377 * it uses the space between tx_win_max and tx_win_min */
378 *tx_win_min = (rx_win_max - 2 + Tt) & 7;
379 *tx_win_max = (rx_win_min + 4 - Tr) & 7;
380 } else {
381 /* TX and RX simultaniously */
382 *tx_win_min = rx_win_min;
383 *tx_win_max = 7;
384 }
385
386 *tx_range = (*tx_win_max - *tx_win_min + 1) & 7;
Andreas Eversberg7a16d462014-01-04 15:25:18 +0100387 /* if TX window fills complete range */
388 if (*tx_range == 0)
389 *tx_range = 8;
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100390 LOGP(DRLCMAC, LOGL_DEBUG, "- TX-Window is: %d..%d\n", *tx_win_min,
391 *tx_win_max);
392}
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100393
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100394/*
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100395 * Select a window of Tx slots if available.
396 * The maximum allowed slots depend on TX or the window of available
397 * slots.
398 */
399static int select_ul_slots(gprs_rlcmac_trx *trx,
400 const int ms_type, const int ms_max_txslots,
401 uint8_t tx_win_min, uint8_t tx_range,
Andreas Eversberg765736d2014-01-04 15:27:31 +0100402 int8_t *usf, int8_t *first_common_ts, uint8_t rx_window)
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100403{
404 int tsc = -1;
405 uint8_t tx_window = 0;
406 int i;
407 uint8_t ts_no;
408
Andreas Eversbergfe2dcc82014-01-04 15:39:54 +0100409 for (ts_no = tx_win_min, i = 0; i < tx_range; ts_no = (ts_no + 1) & 7, i++) {
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100410 gprs_rlcmac_pdch *pdch = &trx->pdch[ts_no];
411
412 /* check if enabled */
413 if (!pdch->is_enabled()) {
414 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
415 "because not enabled\n", ts_no);
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100416 if (ms_type == 1 && tx_window)
417 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100418 continue;
419 }
Andreas Eversberg765736d2014-01-04 15:27:31 +0100420 /* check if used as downlink */
421 if (!(rx_window & (1 << ts_no))) {
422 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
423 "because not a downlink slot\n", ts_no);
424 if (ms_type == 1 && tx_window)
425 goto inc_window;
426 continue;
427 }
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100428 /* check if TSC changes */
429 if (tsc < 0)
430 tsc = pdch->tsc;
431 else if (tsc != pdch->tsc) {
432 LOGP(DRLCMAC, LOGL_ERROR, "Skipping TS %d of "
433 "TRX=%d, because it has different TSC "
434 "than lower TS of TRX. In order to "
435 "allow multislot, all slots must be "
436 "configured with the same TSC!\n",
437 ts_no, trx->trx_no);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100438 if (ms_type == 1)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100439 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100440 continue;
441 }
442 /* check for free usf */
443 usf[ts_no] = find_free_usf(pdch);
444 if (usf[ts_no] < 0) {
445 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
446 "because no USF available\n", ts_no);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100447 if (ms_type == 1)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100448 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100449 continue;
450 }
451
452 if (!tx_window)
453 *first_common_ts = ts_no;
454
455 tx_window |= (1 << ts_no);
456 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected UL TS %d\n", ts_no);
457
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100458inc_window:
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100459 if (1 && ms_type == 1) { /* FIXME: multislot UL assignment */
460 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because "
461 "1 slot assigned\n");
462 break;
463 }
Andreas Eversberg0a940082014-01-15 13:53:43 +0100464 if (i+1 == ms_max_txslots) {
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100465 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because "
466 "slots / window reached maximum "
467 "allowed Tx size\n");
468 break;
469 }
470 }
471
472 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected TX window: "
473 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
474 ((tx_window & 0x01)) ? 'U' : '.',
475 ((tx_window & 0x02)) ? 'U' : '.',
476 ((tx_window & 0x04)) ? 'U' : '.',
477 ((tx_window & 0x08)) ? 'U' : '.',
478 ((tx_window & 0x10)) ? 'U' : '.',
479 ((tx_window & 0x20)) ? 'U' : '.',
480 ((tx_window & 0x40)) ? 'U' : '.',
481 ((tx_window & 0x80)) ? 'U' : '.');
482
483 if (!tx_window) {
484 LOGP(DRLCMAC, LOGL_NOTICE, "No suitable uplink slots "
485 "available\n");
486 return -EBUSY;
487 }
488
489 return tx_window;
490}
491
492/*
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100493 * Assign the first common ts, which is used for control or
494 * single slot.
495 */
Andreas Eversberg765736d2014-01-04 15:27:31 +0100496static int select_first_ts(gprs_rlcmac_trx *trx, uint8_t tx_win_min,
497 uint8_t tx_range, uint8_t rx_window)
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100498{
499 uint8_t ts_no;
500 int i;
Andreas Eversbergfe2dcc82014-01-04 15:39:54 +0100501 for (ts_no = tx_win_min, i = 0; i < tx_range; ts_no = (ts_no + 1) & 7, i++) {
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100502 gprs_rlcmac_pdch *pdch = &trx->pdch[ts_no];
503 /* check if enabled */
504 if (!pdch->is_enabled()) {
505 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
506 "because not enabled\n", ts_no);
507 continue;
508 }
Andreas Eversberg765736d2014-01-04 15:27:31 +0100509 /* check if used as downlink */
510 if (!(rx_window & (1 << ts_no))) {
511 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
512 "because not a downlink slot\n", ts_no);
513 continue;
514 }
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100515 return ts_no;
516 }
517
518 return -1;
519}
520
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200521/* Slot Allocation: Algorithm B
522 *
523 * Assign as many downlink slots as possible.
524 * Assign one uplink slot. (With free USF)
525 *
526 */
527int alloc_algorithm_b(struct gprs_rlcmac_bts *bts,
528 struct gprs_rlcmac_tbf *old_tbf,
529 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
530{
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200531 const struct gprs_ms_multislot_class *ms_class;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100532 uint8_t Tx, Sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200533 uint8_t Tta, Ttb, Tra, Trb, Tt, Tr; /* Minimum Number of Slots */
534 uint8_t Type; /* Type of Mobile */
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100535 int rx_window;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200536 static const char *digit[10] = { "0","1","2","3","4","5","6","7","8","9" };
537 int8_t usf[8] = { -1, -1, -1, -1, -1, -1, -1, -1 }; /* must be signed */
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200538 int8_t first_common_ts = -1;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100539 uint8_t ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200540 uint8_t slotcount = 0;
541
542
543 if (tbf->ms_class >= 32) {
544 LOGP(DRLCMAC, LOGL_ERROR, "Multislot class %d out of range.\n",
545 tbf->ms_class);
546 return -EINVAL;
547 }
548
549 if (tbf->ms_class) {
550 ms_class = &gprs_ms_multislot_class[tbf->ms_class];
551 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
552 "class %d\n", tbf->ms_class);
553 } else {
554 ms_class = &gprs_ms_multislot_class[12];
555 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
556 "unknow class (assuming 12)\n");
557 }
558
559 if (ms_class->tx == MS_NA) {
560 LOGP(DRLCMAC, LOGL_NOTICE, "Multislot class %d not "
561 "applicable.\n", tbf->ms_class);
562 return -EINVAL;
563 }
564
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200565 Tx = ms_class->tx;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200566 Sum = ms_class->sum;
567 Tta = ms_class->ta;
568 Ttb = ms_class->tb;
569 Tra = ms_class->ra;
570 Trb = ms_class->rb;
571 Type = ms_class->type;
572
573 /* Tta and Ttb may depend on hopping or frequency change */
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100574 if (Ttb == MS_A || Ttb == MS_B)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200575 Ttb = 0;
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100576 if (Trb == MS_A || Trb == MS_C)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200577 Trb = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200578
579 LOGP(DRLCMAC, LOGL_DEBUG, "- Rx=%d Tx=%d Sum Rx+Tx=%s Tta=%s Ttb=%d "
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100580 " Tra=%d Trb=%d Type=%d\n", ms_class->rx, Tx,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200581 (Sum == MS_NA) ? "N/A" : digit[Sum],
582 (Tta == MS_NA) ? "N/A" : digit[Tta], Ttb, Tra, Trb, Type);
583
584 /* select the values for time contraints */
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200585 /* applicable to type 1 and type 2 */
586 Tt = Ttb;
587 Tr = Trb;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200588
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100589 uint8_t rx_win_min, rx_win_max;
590 rx_window = select_dl_slots(tbf->trx, ms_class->type, ms_class->rx,
591 &rx_win_min, &rx_win_max);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200592
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200593
594 /* reduce window, if existing uplink slots collide RX window */
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100595 int rc = reduce_rx_window(ms_class->type, old_tbf, Tt, Tr,
596 &rx_window, &rx_win_min, &rx_win_max);
597 if (rc < 0)
598 return rc;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100599 shrink_rx_window(&rx_win_min, &rx_win_max, rx_window);
Holger Hans Peter Freytherdd4af802013-12-25 21:03:42 +0100600 rx_win_max = update_rx_win_max(ms_class->type, Tt, Tr,
601 rx_win_min, rx_win_max);
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100602 shrink_rx_window(&rx_win_min, &rx_win_max, rx_window);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200603 LOGP(DRLCMAC, LOGL_DEBUG, "- RX-Window is: %d..%d\n", rx_win_min,
604 rx_win_max);
605
606 /* calculate TX window */
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100607 uint8_t tx_win_min, tx_win_max, tx_range;
608 tx_win_from_rx(ms_class->type, rx_win_min, rx_win_max, Tt, Tr,
609 &tx_win_min, &tx_win_max, &tx_range);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200610
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100611 /* select UL slots but in both cases assign first_common_ts */
612 uint8_t tx_window = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200613 if (tbf->direction == GPRS_RLCMAC_UL_TBF) {
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100614 rc = select_ul_slots(tbf->trx, ms_class->type, ms_class->tx,
Andreas Eversberg765736d2014-01-04 15:27:31 +0100615 tx_win_min, tx_range, usf,
616 &first_common_ts, rx_window);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100617 if (rc < 0)
618 return rc;
619 tx_window = rc;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200620 } else {
Andreas Eversberg765736d2014-01-04 15:27:31 +0100621 first_common_ts = select_first_ts(tbf->trx, tx_win_min,
622 tx_range, rx_window);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200623 }
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100624 #warning "first_common_ts might be different if there was no free USF for the new uplink assignment"
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200625
626 if (first_common_ts < 0) {
627 LOGP(DRLCMAC, LOGL_NOTICE, "No first common slots available\n");
628 return -EINVAL;
629 }
630
631 if (tbf->direction == GPRS_RLCMAC_DL_TBF) {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200632 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200633 /* assign downlink */
634 if (rx_window == 0) {
635 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots "
636 "available\n");
637 return -EINVAL;
638 }
639 for (ts = 0; ts < 8; ts++) {
640 if ((rx_window & (1 << ts))) {
641 /* be sure to select a single downlink slots
642 * that can be used for uplink, if multiple
643 * slots are assigned later. */
644 if (single && first_common_ts != ts)
645 continue;
646 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning DL TS "
647 "%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200648 assign_dlink_tbf(&tbf->trx->pdch[ts], dl_tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200649 slotcount++;
650 if (slotcount == 1)
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200651 dl_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200652 if (single)
653 break;
654 }
655 }
656 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200657 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200658 for (ts = 0; ts < 8; ts++) {
659 if ((tx_window & (1 << ts))) {
660 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning UL TS "
661 "%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200662 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, usf[ts]);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200663 slotcount++;
664 if (slotcount == 1)
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200665 ul_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200666 if (single)
667 break;
668 }
669 }
670 }
671 if (single && slotcount) {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200672 uint8_t ts_count = 0;
673 for (ts = 0; ts < 8; ts++)
674 if ((tx_window & (1 << ts)))
675 ts_count++;
676
677 tbf->upgrade_to_multislot = (ts_count > 1);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200678 LOGP(DRLCMAC, LOGL_INFO, "Using single slot at TS %d for %s\n",
679 tbf->first_ts,
680 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
681 } else {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200682 tbf->upgrade_to_multislot = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200683 LOGP(DRLCMAC, LOGL_INFO, "Using %d slots for %s\n", slotcount,
684 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
685 }
686 if (slotcount == 0)
687 return -EBUSY;
688
689 tbf->first_common_ts = first_common_ts;
690
691 return 0;
692}