blob: bae1ea5f1e9720140d02f0c237b4b3bbcd530fec [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>
Jacob Erlbecke2e004e2015-06-18 17:16:26 +020026#include <gprs_ms.h>
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020027
28#include <errno.h>
29
30/* 3GPP TS 05.02 Annex B.1 */
31
32#define MS_NA 255 /* N/A */
33#define MS_A 254 /* 1 with hopping, 0 without */
34#define MS_B 253 /* 1 with hopping, 0 without (change Rx to Tx)*/
35#define MS_C 252 /* 1 with hopping, 0 without (change Tx to Rx)*/
36
37struct gprs_ms_multislot_class {
38 uint8_t rx, tx, sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
39 uint8_t ta, tb, ra, rb; /* Minimum Number of Slots */
40 uint8_t type; /* Type of Mobile */
41};
42
43static const struct gprs_ms_multislot_class gprs_ms_multislot_class[32] = {
44/* M-S Class Rx Tx Sum Tta Ttb Tra Trb Type */
45/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
46/* 1 */ { 1, 1, 2, 3, 2, 4, 2, 1 },
47/* 2 */ { 2, 1, 3, 3, 2, 3, 1, 1 },
48/* 3 */ { 2, 2, 3, 3, 2, 3, 1, 1 },
49/* 4 */ { 3, 1, 4, 3, 1, 3, 1, 1 },
50/* 5 */ { 2, 2, 4, 3, 1, 3, 1, 1 },
51/* 6 */ { 3, 2, 4, 3, 1, 3, 1, 1 },
52/* 7 */ { 3, 3, 4, 3, 1, 3, 1, 1 },
53/* 8 */ { 4, 1, 5, 3, 1, 2, 1, 1 },
54/* 9 */ { 3, 2, 5, 3, 1, 2, 1, 1 },
55/* 10 */ { 4, 2, 5, 3, 1, 2, 1, 1 },
56/* 11 */ { 4, 3, 5, 3, 1, 2, 1, 1 },
57/* 12 */ { 4, 4, 5, 2, 1, 2, 1, 1 },
58/* 13 */ { 3, 3, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
59/* 14 */ { 4, 4, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
60/* 15 */ { 5, 5, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
61/* 16 */ { 6, 6, MS_NA, MS_NA, MS_A, 2, MS_A, 2 },
62/* 17 */ { 7, 7, MS_NA, MS_NA, MS_A, 1, 0, 2 },
63/* 18 */ { 8, 8, MS_NA, MS_NA, 0, 0, 0, 2 },
64/* 19 */ { 6, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
65/* 20 */ { 6, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
66/* 21 */ { 6, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
67/* 22 */ { 6, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
68/* 23 */ { 6, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
69/* 24 */ { 8, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
70/* 25 */ { 8, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
71/* 26 */ { 8, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
72/* 27 */ { 8, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
73/* 28 */ { 8, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
74/* 29 */ { 8, 8, MS_NA, 2, MS_B, 2, MS_C, 1 },
75/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
76/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
77};
78
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +020079static inline int8_t find_free_usf(struct gprs_rlcmac_pdch *pdch)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020080{
Daniel Willmanncd44ec42014-08-07 15:04:57 +020081 struct gprs_rlcmac_ul_tbf *tbf;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020082 uint8_t usf_map = 0;
83 uint8_t tfi, usf;
84
85 /* make map of used USF */
86 for (tfi = 0; tfi < 32; tfi++) {
Daniel Willmann17a1d5e2014-05-30 20:21:30 +020087 tbf = pdch->ul_tbf_by_tfi(tfi);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020088 if (!tbf)
89 continue;
Daniel Willmann7e994e32014-08-07 15:49:21 +020090 usf_map |= (1 << tbf->m_usf[pdch->ts_no]);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020091 }
92
93 /* look for USF, don't use USF=7 */
94 for (usf = 0; usf < 7; usf++) {
95 if (!(usf_map & (1 << usf)))
96 return usf;
97 }
98
99 return -1;
100}
101
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200102static int find_enabled_pdch(struct gprs_rlcmac_trx *trx, const uint8_t start_ts)
103{
104 int ts;
105 for (ts = start_ts; ts < 8; ts++) {
106 struct gprs_rlcmac_pdch *pdch;
107
108 pdch = &trx->pdch[ts];
Holger Hans Peter Freyther17b0d832013-10-19 17:37:48 +0200109 if (!pdch->is_enabled()) {
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200110 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because "
111 "not enabled\n", ts);
112 continue;
113 }
114 return ts;
115 }
116
117 return 8;
118}
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200119
Holger Hans Peter Freyther743bafa2013-09-29 07:50:50 +0200120static void assign_uplink_tbf_usf(
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200121 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200122 struct gprs_rlcmac_ul_tbf *tbf, int8_t usf)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200123{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100124 tbf->trx->ul_tbf[tbf->tfi()] = tbf;
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200125 tbf->pdch[pdch->ts_no] = pdch;
Daniel Willmann7e994e32014-08-07 15:49:21 +0200126 tbf->m_usf[pdch->ts_no] = usf;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200127}
128
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200129static void assign_dlink_tbf(
130 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200131 struct gprs_rlcmac_dl_tbf *tbf)
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200132{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100133 tbf->trx->dl_tbf[tbf->tfi()] = tbf;
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200134 tbf->pdch[pdch->ts_no] = pdch;
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200135}
136
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200137
138/* Slot Allocation: Algorithm A
139 *
140 * Assign single slot for uplink and downlink
141 */
142int alloc_algorithm_a(struct gprs_rlcmac_bts *bts,
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200143 GprsMs *ms,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200144 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
145{
146 struct gprs_rlcmac_pdch *pdch;
147 uint8_t ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200148
149 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm A) for class "
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200150 "%d\n", tbf->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200151
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200152 ts = find_enabled_pdch(tbf->trx, 0);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200153 if (ts == 8)
154 return -EINVAL;
155
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200156 pdch = &tbf->trx->pdch[ts];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200157 if (tbf->direction == GPRS_RLCMAC_UL_TBF) {
Holger Hans Peter Freyther948a3d62013-09-30 14:10:23 +0200158 int8_t usf; /* must be signed */
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200159 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Holger Hans Peter Freyther948a3d62013-09-30 14:10:23 +0200160
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200161 /* if USF available */
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200162 usf = find_free_usf(pdch);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200163 if (usf < 0) {
164 LOGP(DRLCMAC, LOGL_NOTICE, "- Failed "
165 "allocating TS=%d, no USF available\n", ts);
166 return -EBUSY;
167 }
168 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign uplink "
169 "TS=%d USF=%d\n", ts, usf);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200170 assign_uplink_tbf_usf(pdch, ul_tbf, usf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200171 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200172 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200173 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign downlink TS=%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200174 assign_dlink_tbf(pdch, dl_tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200175 }
176 /* the only one TS is the common TS */
177 tbf->first_ts = tbf->first_common_ts = ts;
178
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200179 tbf->upgrade_to_multislot = 0;
180
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200181 return 0;
182}
183
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100184/*
185 * Select a window of Rx slots if available.
186 * The maximum allowed slots depend on RX or the window of available
187 * slots. This must be done for uplink TBF also, because it is the basis
188 * for calculating control slot and uplink slot(s).
189 */
190static uint8_t select_dl_slots(struct gprs_rlcmac_trx *trx,
191 const int ms_type, const int ms_max_rxslots,
192 uint8_t *out_rx_win_min, uint8_t *out_rx_win_max)
193
194{
195 uint8_t rx_window = 0;
196 int rx_window_size = 0;
197 int8_t last_tsc = -1; /* must be signed */
198 uint8_t rx_win_min = 0, rx_win_max = 0;
199
200 for (int ts_no = 0; ts_no < 8; ts_no++) {
201 struct gprs_rlcmac_pdch *pdch;
202 pdch = &trx->pdch[ts_no];
203
204 /* check if enabled */
205 if (!pdch->is_enabled()) {
206 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because "
207 "not enabled\n", ts_no);
208 if (ms_type == 1 && rx_window)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100209 goto inc_window;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100210 continue;
211 }
212 /* check if TSC changes */
213 if (last_tsc < 0)
214 last_tsc = pdch->tsc;
215 else if (last_tsc != pdch->tsc) {
216 LOGP(DRLCMAC, LOGL_ERROR, "Skipping TS %d of TRX=%d, "
217 "because it has different TSC than lower TS "
218 "of TRX. In order to allow multislot, all "
219 "slots must be configured with the same "
220 "TSC!\n", ts_no, trx->trx_no);
221 if (ms_type == 1 && rx_window)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100222 goto inc_window;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100223 continue;
224 }
225
226 if (!rx_window)
227 rx_win_min = ts_no;
228
229 rx_window |= (1 << ts_no);
230 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected DL TS %d\n", ts_no);
231
232 /* range of window (required for Type 1) */
233 rx_win_max = ts_no;
234
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100235inc_window:
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100236 if (++rx_window_size == ms_max_rxslots) {
237 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because slots / "
238 "window reached maximum alowed Rx size\n");
239 break;
240 }
Andreas Eversbergccde4c42014-01-04 15:17:22 +0100241 if (ms_type == 1 && rx_window_size == 5) {
242 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because slots / "
243 "window reached maximum supported Rx size of "
244 "this algorithm\n");
245 break;
246 }
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100247 }
248
249 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected slots for RX: "
250 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
251 ((rx_window & 0x01)) ? 'D' : '.',
252 ((rx_window & 0x02)) ? 'D' : '.',
253 ((rx_window & 0x04)) ? 'D' : '.',
254 ((rx_window & 0x08)) ? 'D' : '.',
255 ((rx_window & 0x10)) ? 'D' : '.',
256 ((rx_window & 0x20)) ? 'D' : '.',
257 ((rx_window & 0x40)) ? 'D' : '.',
258 ((rx_window & 0x80)) ? 'D' : '.');
259
260 *out_rx_win_min = rx_win_min;
261 *out_rx_win_max = rx_win_max;
262 return rx_window;
263}
264
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200265static int reduce_rx_window(const int ms_type, const GprsMs *ms,
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100266 const int Tt, const int Tr,
267 int *rx_window,
268 uint8_t *rx_win_min, uint8_t *rx_win_max)
269{
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200270 gprs_rlcmac_ul_tbf *ul_tbf;
271
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100272 if (ms_type != 1)
273 return 0;
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200274 if (!ms)
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100275 return 0;
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200276
277 ul_tbf = ms->ul_tbf();
278
279 if (!ul_tbf)
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100280 return 0;
281
282 uint8_t collide = 0, ul_usage = 0;
283
284 /* calculate mask of colliding slots */
285 for (uint8_t ts_no = 0; ts_no < 8; ts_no++) {
286 int j;
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200287 if (!ul_tbf->pdch[ts_no])
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100288 continue;
289
290 ul_usage |= (1 << ts_no);
291 /* mark bits from TS-t .. TS+r */
Andreas Eversberg91670552014-05-29 11:08:58 +0200292 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 +0100293 collide |= (1 << j);
294 }
295
296 LOGP(DRLCMAC, LOGL_DEBUG, "- Not allowed slots due to existing "
297 "UL allocation: (TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7) "
298 " D=downlink x=not usable\n",
299 ((ul_usage & 0x01)) ? 'D' : ((collide & 0x01))?'x':'.',
300 ((ul_usage & 0x02)) ? 'D' : ((collide & 0x02))?'x':'.',
301 ((ul_usage & 0x04)) ? 'D' : ((collide & 0x04))?'x':'.',
302 ((ul_usage & 0x08)) ? 'D' : ((collide & 0x08))?'x':'.',
303 ((ul_usage & 0x10)) ? 'D' : ((collide & 0x10))?'x':'.',
304 ((ul_usage & 0x20)) ? 'D' : ((collide & 0x20))?'x':'.',
305 ((ul_usage & 0x40)) ? 'D' : ((collide & 0x40))?'x':'.',
306 ((ul_usage & 0x80)) ? 'D' : ((collide & 0x80))?'x':'.');
307
308 /*
309 * Uplink/Downlink in GSM is shifted by three timeslots. Make
310 * sure they don't collide.
311 */
312 *rx_window &= ~(collide << 3);
313 *rx_window &= ~(collide >> 5);
314 LOGP(DRLCMAC, LOGL_DEBUG, "- Remaining slots for RX: "
315 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
316 ((*rx_window & 0x01)) ? 'D' : '.',
317 ((*rx_window & 0x02)) ? 'D' : '.',
318 ((*rx_window & 0x04)) ? 'D' : '.',
319 ((*rx_window & 0x08)) ? 'D' : '.',
320 ((*rx_window & 0x10)) ? 'D' : '.',
321 ((*rx_window & 0x20)) ? 'D' : '.',
322 ((*rx_window & 0x40)) ? 'D' : '.',
323 ((*rx_window & 0x80)) ? 'D' : '.');
324
325 if (!*rx_window) {
326 LOGP(DRLCMAC, LOGL_NOTICE, "No suitable downlink slots "
327 "available with current uplink assignment\n");
328 return -EBUSY;
329 }
330
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100331 return 0;
332}
333
334/* shrink range of rx_win_min and rx_win_max */
335static void shrink_rx_window(uint8_t *rx_win_min, uint8_t *rx_win_max, int rx_window)
336{
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100337 /* calculate new min/max */
338 for (uint8_t ts_no = *rx_win_min; ts_no <= *rx_win_max; ts_no++) {
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100339 if ((rx_window & (1 << ts_no)))
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100340 break;
341 *rx_win_min = ts_no + 1;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100342 LOGP(DRLCMAC, LOGL_DEBUG, "- TS is unused, so "
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100343 "raising start of DL window to %d\n",
344 *rx_win_min);
345 }
346 for (uint8_t ts_no = *rx_win_max; ts_no >= *rx_win_min; ts_no--) {
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100347 if ((rx_window & (1 << ts_no)))
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100348 break;
349 *rx_win_max = ts_no - 1;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100350 LOGP(DRLCMAC, LOGL_DEBUG, "- TS is unused, so "
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100351 "lowering end of DL window to %d\n",
352 *rx_win_max);
353 }
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100354}
355
Holger Hans Peter Freytherdd4af802013-12-25 21:03:42 +0100356/*
357 * reduce window, to allow at least one uplink TX slot
358 * this is only required for Type 1
359 */
360static uint8_t update_rx_win_max(const int ms_type, const int Tt,
361 const int Tr, uint8_t rx_win_min, uint8_t rx_win_max)
362{
363 if (ms_type != 1)
364 return rx_win_max;
365
366 if (rx_win_max - rx_win_min + 1 + Tt + 1 + Tr > 8) {
367 rx_win_max = rx_win_min + 7 - Tt - 1 - Tr;
368 LOGP(DRLCMAC, LOGL_DEBUG, "- Reduce RX window due to time "
369 "contraints to %d slots\n", rx_win_max - rx_win_min + 1);
370 }
371
372 return rx_win_max;
373}
374
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100375static void tx_win_from_rx(const int ms_type,
376 uint8_t rx_win_min, uint8_t rx_win_max,
377 int Tt, int Tr,
378 uint8_t *tx_win_min, uint8_t *tx_win_max,
379 uint8_t *tx_range)
380{
381 if (ms_type == 1) {
382 /* calculate TX window (shifted by 3 timeslots)
383 * it uses the space between tx_win_max and tx_win_min */
384 *tx_win_min = (rx_win_max - 2 + Tt) & 7;
385 *tx_win_max = (rx_win_min + 4 - Tr) & 7;
386 } else {
387 /* TX and RX simultaniously */
388 *tx_win_min = rx_win_min;
389 *tx_win_max = 7;
390 }
391
392 *tx_range = (*tx_win_max - *tx_win_min + 1) & 7;
Andreas Eversberg7a16d462014-01-04 15:25:18 +0100393 /* if TX window fills complete range */
394 if (*tx_range == 0)
395 *tx_range = 8;
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100396 LOGP(DRLCMAC, LOGL_DEBUG, "- TX-Window is: %d..%d\n", *tx_win_min,
397 *tx_win_max);
398}
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100399
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100400/*
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100401 * Select a window of Tx slots if available.
402 * The maximum allowed slots depend on TX or the window of available
403 * slots.
404 */
405static int select_ul_slots(gprs_rlcmac_trx *trx,
406 const int ms_type, const int ms_max_txslots,
407 uint8_t tx_win_min, uint8_t tx_range,
Andreas Eversberg765736d2014-01-04 15:27:31 +0100408 int8_t *usf, int8_t *first_common_ts, uint8_t rx_window)
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100409{
410 int tsc = -1;
411 uint8_t tx_window = 0;
412 int i;
413 uint8_t ts_no;
414
Andreas Eversbergfe2dcc82014-01-04 15:39:54 +0100415 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 +0100416 gprs_rlcmac_pdch *pdch = &trx->pdch[ts_no];
417
418 /* check if enabled */
419 if (!pdch->is_enabled()) {
420 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
421 "because not enabled\n", ts_no);
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100422 if (ms_type == 1 && tx_window)
423 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100424 continue;
425 }
Andreas Eversberg765736d2014-01-04 15:27:31 +0100426 /* check if used as downlink */
427 if (!(rx_window & (1 << ts_no))) {
428 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
429 "because not a downlink slot\n", ts_no);
430 if (ms_type == 1 && tx_window)
431 goto inc_window;
432 continue;
433 }
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100434 /* check if TSC changes */
435 if (tsc < 0)
436 tsc = pdch->tsc;
437 else if (tsc != pdch->tsc) {
438 LOGP(DRLCMAC, LOGL_ERROR, "Skipping TS %d of "
439 "TRX=%d, because it has different TSC "
440 "than lower TS of TRX. In order to "
441 "allow multislot, all slots must be "
442 "configured with the same TSC!\n",
443 ts_no, trx->trx_no);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100444 if (ms_type == 1)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100445 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100446 continue;
447 }
448 /* check for free usf */
449 usf[ts_no] = find_free_usf(pdch);
450 if (usf[ts_no] < 0) {
451 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
452 "because no USF available\n", ts_no);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100453 if (ms_type == 1)
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100454 goto inc_window;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100455 continue;
456 }
457
458 if (!tx_window)
459 *first_common_ts = ts_no;
460
461 tx_window |= (1 << ts_no);
462 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected UL TS %d\n", ts_no);
463
Andreas Eversbergb03d4272014-01-04 15:14:19 +0100464inc_window:
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100465 if (1 && ms_type == 1) { /* FIXME: multislot UL assignment */
466 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because "
467 "1 slot assigned\n");
468 break;
469 }
Andreas Eversberg0a940082014-01-15 13:53:43 +0100470 if (i+1 == ms_max_txslots) {
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100471 LOGP(DRLCMAC, LOGL_DEBUG, "- Done, because "
472 "slots / window reached maximum "
473 "allowed Tx size\n");
474 break;
475 }
476 }
477
478 LOGP(DRLCMAC, LOGL_DEBUG, "- Selected TX window: "
479 "(TS=0)\"%c%c%c%c%c%c%c%c\"(TS=7)\n",
480 ((tx_window & 0x01)) ? 'U' : '.',
481 ((tx_window & 0x02)) ? 'U' : '.',
482 ((tx_window & 0x04)) ? 'U' : '.',
483 ((tx_window & 0x08)) ? 'U' : '.',
484 ((tx_window & 0x10)) ? 'U' : '.',
485 ((tx_window & 0x20)) ? 'U' : '.',
486 ((tx_window & 0x40)) ? 'U' : '.',
487 ((tx_window & 0x80)) ? 'U' : '.');
488
489 if (!tx_window) {
490 LOGP(DRLCMAC, LOGL_NOTICE, "No suitable uplink slots "
491 "available\n");
492 return -EBUSY;
493 }
494
495 return tx_window;
496}
497
498/*
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100499 * Assign the first common ts, which is used for control or
500 * single slot.
501 */
Andreas Eversberg765736d2014-01-04 15:27:31 +0100502static int select_first_ts(gprs_rlcmac_trx *trx, uint8_t tx_win_min,
503 uint8_t tx_range, uint8_t rx_window)
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100504{
505 uint8_t ts_no;
506 int i;
Andreas Eversbergfe2dcc82014-01-04 15:39:54 +0100507 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 +0100508 gprs_rlcmac_pdch *pdch = &trx->pdch[ts_no];
509 /* check if enabled */
510 if (!pdch->is_enabled()) {
511 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
512 "because not enabled\n", ts_no);
513 continue;
514 }
Andreas Eversberg765736d2014-01-04 15:27:31 +0100515 /* check if used as downlink */
516 if (!(rx_window & (1 << ts_no))) {
517 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, "
518 "because not a downlink slot\n", ts_no);
519 continue;
520 }
Holger Hans Peter Freyther1fe69322013-12-26 09:31:31 +0100521 return ts_no;
522 }
523
524 return -1;
525}
526
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200527/* Slot Allocation: Algorithm B
528 *
529 * Assign as many downlink slots as possible.
530 * Assign one uplink slot. (With free USF)
531 *
532 */
533int alloc_algorithm_b(struct gprs_rlcmac_bts *bts,
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200534 GprsMs *ms,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200535 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
536{
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200537 const struct gprs_ms_multislot_class *ms_class;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100538 uint8_t Tx, Sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200539 uint8_t Tta, Ttb, Tra, Trb, Tt, Tr; /* Minimum Number of Slots */
540 uint8_t Type; /* Type of Mobile */
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100541 int rx_window;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200542 static const char *digit[10] = { "0","1","2","3","4","5","6","7","8","9" };
543 int8_t usf[8] = { -1, -1, -1, -1, -1, -1, -1, -1 }; /* must be signed */
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200544 int8_t first_common_ts = -1;
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100545 uint8_t ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200546 uint8_t slotcount = 0;
547
548
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200549 if (tbf->ms_class() >= 32) {
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200550 LOGP(DRLCMAC, LOGL_ERROR, "Multislot class %d out of range.\n",
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200551 tbf->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200552 return -EINVAL;
553 }
554
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200555 if (tbf->ms_class()) {
556 ms_class = &gprs_ms_multislot_class[tbf->ms_class()];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200557 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200558 "class %d\n", tbf->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200559 } else {
560 ms_class = &gprs_ms_multislot_class[12];
561 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
562 "unknow class (assuming 12)\n");
563 }
564
565 if (ms_class->tx == MS_NA) {
566 LOGP(DRLCMAC, LOGL_NOTICE, "Multislot class %d not "
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200567 "applicable.\n", tbf->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200568 return -EINVAL;
569 }
570
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200571 Tx = ms_class->tx;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200572 Sum = ms_class->sum;
573 Tta = ms_class->ta;
574 Ttb = ms_class->tb;
575 Tra = ms_class->ra;
576 Trb = ms_class->rb;
577 Type = ms_class->type;
578
579 /* Tta and Ttb may depend on hopping or frequency change */
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100580 if (Ttb == MS_A || Ttb == MS_B)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200581 Ttb = 0;
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100582 if (Trb == MS_A || Trb == MS_C)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200583 Trb = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200584
585 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 +0100586 " Tra=%d Trb=%d Type=%d\n", ms_class->rx, Tx,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200587 (Sum == MS_NA) ? "N/A" : digit[Sum],
588 (Tta == MS_NA) ? "N/A" : digit[Tta], Ttb, Tra, Trb, Type);
589
590 /* select the values for time contraints */
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200591 /* applicable to type 1 and type 2 */
592 Tt = Ttb;
593 Tr = Trb;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200594
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100595 uint8_t rx_win_min, rx_win_max;
596 rx_window = select_dl_slots(tbf->trx, ms_class->type, ms_class->rx,
597 &rx_win_min, &rx_win_max);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200598
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200599
600 /* reduce window, if existing uplink slots collide RX window */
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200601 int rc = reduce_rx_window(ms_class->type, ms, Tt, Tr,
Holger Hans Peter Freythere45c19b2013-12-25 20:53:53 +0100602 &rx_window, &rx_win_min, &rx_win_max);
603 if (rc < 0)
604 return rc;
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100605 shrink_rx_window(&rx_win_min, &rx_win_max, rx_window);
Holger Hans Peter Freytherdd4af802013-12-25 21:03:42 +0100606 rx_win_max = update_rx_win_max(ms_class->type, Tt, Tr,
607 rx_win_min, rx_win_max);
Andreas Eversberg1cd9d882014-01-04 15:42:38 +0100608 shrink_rx_window(&rx_win_min, &rx_win_max, rx_window);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200609 LOGP(DRLCMAC, LOGL_DEBUG, "- RX-Window is: %d..%d\n", rx_win_min,
610 rx_win_max);
611
612 /* calculate TX window */
Holger Hans Peter Freyther3fd2ddf2013-12-25 21:11:20 +0100613 uint8_t tx_win_min, tx_win_max, tx_range;
614 tx_win_from_rx(ms_class->type, rx_win_min, rx_win_max, Tt, Tr,
615 &tx_win_min, &tx_win_max, &tx_range);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200616
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100617 /* select UL slots but in both cases assign first_common_ts */
618 uint8_t tx_window = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200619 if (tbf->direction == GPRS_RLCMAC_UL_TBF) {
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100620 rc = select_ul_slots(tbf->trx, ms_class->type, ms_class->tx,
Andreas Eversberg765736d2014-01-04 15:27:31 +0100621 tx_win_min, tx_range, usf,
622 &first_common_ts, rx_window);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100623 if (rc < 0)
624 return rc;
625 tx_window = rc;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200626 } else {
Andreas Eversberg765736d2014-01-04 15:27:31 +0100627 first_common_ts = select_first_ts(tbf->trx, tx_win_min,
628 tx_range, rx_window);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200629 }
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100630 #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 +0200631
632 if (first_common_ts < 0) {
633 LOGP(DRLCMAC, LOGL_NOTICE, "No first common slots available\n");
634 return -EINVAL;
635 }
636
637 if (tbf->direction == GPRS_RLCMAC_DL_TBF) {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200638 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200639 /* assign downlink */
640 if (rx_window == 0) {
641 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots "
642 "available\n");
643 return -EINVAL;
644 }
645 for (ts = 0; ts < 8; ts++) {
646 if ((rx_window & (1 << ts))) {
647 /* be sure to select a single downlink slots
648 * that can be used for uplink, if multiple
649 * slots are assigned later. */
650 if (single && first_common_ts != ts)
651 continue;
652 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning DL TS "
653 "%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200654 assign_dlink_tbf(&tbf->trx->pdch[ts], dl_tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200655 slotcount++;
656 if (slotcount == 1)
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200657 dl_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200658 if (single)
659 break;
660 }
661 }
662 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200663 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200664 for (ts = 0; ts < 8; ts++) {
665 if ((tx_window & (1 << ts))) {
666 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning UL TS "
667 "%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200668 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, usf[ts]);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200669 slotcount++;
670 if (slotcount == 1)
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200671 ul_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200672 if (single)
673 break;
674 }
675 }
676 }
677 if (single && slotcount) {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200678 uint8_t ts_count = 0;
679 for (ts = 0; ts < 8; ts++)
680 if ((tx_window & (1 << ts)))
681 ts_count++;
682
683 tbf->upgrade_to_multislot = (ts_count > 1);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200684 LOGP(DRLCMAC, LOGL_INFO, "Using single slot at TS %d for %s\n",
685 tbf->first_ts,
686 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
687 } else {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200688 tbf->upgrade_to_multislot = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200689 LOGP(DRLCMAC, LOGL_INFO, "Using %d slots for %s\n", slotcount,
690 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
691 }
692 if (slotcount == 0)
693 return -EBUSY;
694
695 tbf->first_common_ts = first_common_ts;
696
697 return 0;
698}