blob: b427a541e1920a6d4140fed4e68168c7a3dfe223 [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>
Jacob Erlbeckec478752015-06-19 16:35:38 +020029#include <values.h>
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +020030
31/* 3GPP TS 05.02 Annex B.1 */
32
33#define MS_NA 255 /* N/A */
34#define MS_A 254 /* 1 with hopping, 0 without */
35#define MS_B 253 /* 1 with hopping, 0 without (change Rx to Tx)*/
36#define MS_C 252 /* 1 with hopping, 0 without (change Tx to Rx)*/
37
38struct gprs_ms_multislot_class {
39 uint8_t rx, tx, sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
40 uint8_t ta, tb, ra, rb; /* Minimum Number of Slots */
41 uint8_t type; /* Type of Mobile */
42};
43
44static const struct gprs_ms_multislot_class gprs_ms_multislot_class[32] = {
45/* M-S Class Rx Tx Sum Tta Ttb Tra Trb Type */
46/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
47/* 1 */ { 1, 1, 2, 3, 2, 4, 2, 1 },
48/* 2 */ { 2, 1, 3, 3, 2, 3, 1, 1 },
49/* 3 */ { 2, 2, 3, 3, 2, 3, 1, 1 },
50/* 4 */ { 3, 1, 4, 3, 1, 3, 1, 1 },
51/* 5 */ { 2, 2, 4, 3, 1, 3, 1, 1 },
52/* 6 */ { 3, 2, 4, 3, 1, 3, 1, 1 },
53/* 7 */ { 3, 3, 4, 3, 1, 3, 1, 1 },
54/* 8 */ { 4, 1, 5, 3, 1, 2, 1, 1 },
55/* 9 */ { 3, 2, 5, 3, 1, 2, 1, 1 },
56/* 10 */ { 4, 2, 5, 3, 1, 2, 1, 1 },
57/* 11 */ { 4, 3, 5, 3, 1, 2, 1, 1 },
58/* 12 */ { 4, 4, 5, 2, 1, 2, 1, 1 },
59/* 13 */ { 3, 3, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
60/* 14 */ { 4, 4, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
61/* 15 */ { 5, 5, MS_NA, MS_NA, MS_A, 3, MS_A, 2 },
62/* 16 */ { 6, 6, MS_NA, MS_NA, MS_A, 2, MS_A, 2 },
63/* 17 */ { 7, 7, MS_NA, MS_NA, MS_A, 1, 0, 2 },
64/* 18 */ { 8, 8, MS_NA, MS_NA, 0, 0, 0, 2 },
65/* 19 */ { 6, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
66/* 20 */ { 6, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
67/* 21 */ { 6, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
68/* 22 */ { 6, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
69/* 23 */ { 6, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
70/* 24 */ { 8, 2, MS_NA, 3, MS_B, 2, MS_C, 1 },
71/* 25 */ { 8, 3, MS_NA, 3, MS_B, 2, MS_C, 1 },
72/* 26 */ { 8, 4, MS_NA, 3, MS_B, 2, MS_C, 1 },
73/* 27 */ { 8, 4, MS_NA, 2, MS_B, 2, MS_C, 1 },
74/* 28 */ { 8, 6, MS_NA, 2, MS_B, 2, MS_C, 1 },
75/* 29 */ { 8, 8, MS_NA, 2, MS_B, 2, MS_C, 1 },
76/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
77/* N/A */ { MS_NA,MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA, MS_NA },
78};
79
Jacob Erlbeckea65c722015-06-22 16:14:23 +020080static unsigned lsb(unsigned x)
81{
82 return x & -x;
83}
84
85static unsigned bitcount(unsigned x)
86{
87 unsigned count = 0;
88 for (count = 0; x; count += 1)
89 x &= x - 1;
90
91 return count;
92}
93
94static char *set_flag_chars(char *buf, uint8_t val, char set_char, char unset_char = 0)
95{
96 int i;
97
98 for (i = 0; i < 8; i += 1, val = val >> 1) {
99 if (val & 1)
100 buf[i] = set_char;
101 else if (unset_char)
102 buf[i] = unset_char;
103 }
104
105 return buf;
106}
107
108static bool test_and_set_bit(uint32_t *bits, size_t elem)
109{
110 bool was_set = bits[elem/32] & (1 << (elem % 32));
111 bits[elem/32] |= (1 << (elem % 32));
112
113 return was_set;
114}
115
Holger Hans Peter Freyther6796ed22013-10-20 16:45:10 +0200116static inline int8_t find_free_usf(struct gprs_rlcmac_pdch *pdch)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200117{
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200118 uint8_t usf_map = 0;
Jacob Erlbeck20b7ba72015-06-30 14:34:24 +0200119 uint8_t usf;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200120
Jacob Erlbeck20b7ba72015-06-30 14:34:24 +0200121 usf_map = pdch->assigned_usf();
122 if (usf_map == (1 << 7) - 1)
123 return -1;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200124
125 /* look for USF, don't use USF=7 */
126 for (usf = 0; usf < 7; usf++) {
127 if (!(usf_map & (1 << usf)))
128 return usf;
129 }
130
131 return -1;
132}
133
Jacob Erlbeckec478752015-06-19 16:35:38 +0200134static int find_possible_pdchs(struct gprs_rlcmac_trx *trx,
Jacob Erlbeck83426b22015-06-30 09:44:05 +0200135 size_t max_slots,
Jacob Erlbeckec478752015-06-19 16:35:38 +0200136 uint8_t mask, const char *mask_reason = NULL)
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200137{
Jacob Erlbeckec478752015-06-19 16:35:38 +0200138 unsigned ts;
139 int valid_ts_set = 0;
Jacob Erlbeck83426b22015-06-30 09:44:05 +0200140 int8_t last_tsc = -1; /* must be signed */
Jacob Erlbeckec478752015-06-19 16:35:38 +0200141
142 for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) {
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200143 struct gprs_rlcmac_pdch *pdch;
144
145 pdch = &trx->pdch[ts];
Holger Hans Peter Freyther17b0d832013-10-19 17:37:48 +0200146 if (!pdch->is_enabled()) {
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200147 LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because "
148 "not enabled\n", ts);
149 continue;
150 }
Jacob Erlbeckec478752015-06-19 16:35:38 +0200151
152 if (((1 << ts) & mask) == 0) {
153 if (mask_reason)
154 LOGP(DRLCMAC, LOGL_DEBUG,
155 "- Skipping TS %d, because %s\n",
156 ts, mask_reason);
157 continue;
158 }
159
Jacob Erlbeck83426b22015-06-30 09:44:05 +0200160 if (max_slots > 1) {
161 /* check if TSC changes, see TS 45.002, 6.4.2 */
162 if (last_tsc < 0)
163 last_tsc = pdch->tsc;
164 else if (last_tsc != pdch->tsc) {
165 LOGP(DRLCMAC, LOGL_ERROR,
166 "Skipping TS %d of TRX=%d, because it "
167 "has different TSC than lower TS of TRX. "
168 "In order to allow multislot, all "
169 "slots must be configured with the same "
170 "TSC!\n", ts, trx->trx_no);
171 continue;
172 }
173 }
174
Jacob Erlbeckec478752015-06-19 16:35:38 +0200175 valid_ts_set |= 1 << ts;
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200176 }
177
Jacob Erlbeckec478752015-06-19 16:35:38 +0200178 return valid_ts_set;
179}
180
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200181static int compute_usage_by_num_tbfs(struct gprs_rlcmac_pdch *pdch,
182 enum gprs_rlcmac_tbf_direction dir)
183{
184 return pdch->num_tbfs(dir);
185}
186
187static int compute_usage_by_reservation(struct gprs_rlcmac_pdch *pdch,
188 enum gprs_rlcmac_tbf_direction)
189{
190 return
191 pdch->num_reserved(GPRS_RLCMAC_DL_TBF) +
192 pdch->num_reserved(GPRS_RLCMAC_UL_TBF);
193}
194
Jacob Erlbeckec478752015-06-19 16:35:38 +0200195static int find_least_busy_pdch(struct gprs_rlcmac_trx *trx,
196 enum gprs_rlcmac_tbf_direction dir,
197 uint8_t mask,
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200198 int (*fn)(struct gprs_rlcmac_pdch *, enum gprs_rlcmac_tbf_direction dir),
Jacob Erlbeckec478752015-06-19 16:35:38 +0200199 int *free_usf = 0)
200{
201 unsigned ts;
202 int min_used = INT_MAX;
203 int min_ts = -1;
204 int min_usf = -1;
205
206 for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) {
207 struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts];
208 int num_tbfs;
209 int usf = -1; /* must be signed */
210
211 if (((1 << ts) & mask) == 0)
212 continue;
213
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200214 num_tbfs = fn(pdch, dir);
Jacob Erlbeckefe62a72015-07-02 15:48:25 +0200215
216 if (num_tbfs < min_used) {
217 /* We have found a candidate */
218 /* Make sure that an USF is available */
219 if (dir == GPRS_RLCMAC_UL_TBF) {
220 usf = find_free_usf(pdch);
221 if (usf < 0) {
222 LOGP(DRLCMAC, LOGL_DEBUG,
223 "- Skipping TS %d, because "
224 "no USF available\n", ts);
225 continue;
226 }
227 }
228 if (min_ts >= 0)
229 LOGP(DRLCMAC, LOGL_DEBUG,
230 "- Skipping TS %d, because "
231 "num TBFs %d > %d\n",
232 min_ts, min_used, num_tbfs);
233 min_used = num_tbfs;
234 min_ts = ts;
235 min_usf = usf;
236 } else {
237 LOGP(DRLCMAC, LOGL_DEBUG,
238 "- Skipping TS %d, because "
239 "num TBFs %d >= %d\n",
240 ts, num_tbfs, min_used);
241 }
242 }
243
244 if (min_ts < 0)
245 return -1;
246
247 if (free_usf)
248 *free_usf = min_usf;
249
250 return min_ts;
251}
252
Jacob Erlbeckccc34e42015-06-29 13:45:05 +0200253static void attach_tbf_to_pdch(struct gprs_rlcmac_pdch *pdch,
254 struct gprs_rlcmac_tbf *tbf)
255{
256 if (tbf->pdch[pdch->ts_no])
257 tbf->pdch[pdch->ts_no]->detach_tbf(tbf);
258
259 tbf->pdch[pdch->ts_no] = pdch;
260 pdch->attach_tbf(tbf);
261}
262
Holger Hans Peter Freyther743bafa2013-09-29 07:50:50 +0200263static void assign_uplink_tbf_usf(
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200264 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200265 struct gprs_rlcmac_ul_tbf *tbf, int8_t usf)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200266{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100267 tbf->trx->ul_tbf[tbf->tfi()] = tbf;
Daniel Willmann7e994e32014-08-07 15:49:21 +0200268 tbf->m_usf[pdch->ts_no] = usf;
Jacob Erlbeckccc34e42015-06-29 13:45:05 +0200269 attach_tbf_to_pdch(pdch, tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200270}
271
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200272static void assign_dlink_tbf(
273 struct gprs_rlcmac_pdch *pdch,
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200274 struct gprs_rlcmac_dl_tbf *tbf)
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200275{
Holger Hans Peter Freyther34f6e5e2013-10-27 20:31:47 +0100276 tbf->trx->dl_tbf[tbf->tfi()] = tbf;
Jacob Erlbeckccc34e42015-06-29 13:45:05 +0200277 attach_tbf_to_pdch(pdch, tbf);
Holger Hans Peter Freyther8481a052013-09-29 08:08:28 +0200278}
279
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200280
281/* Slot Allocation: Algorithm A
282 *
283 * Assign single slot for uplink and downlink
284 */
285int alloc_algorithm_a(struct gprs_rlcmac_bts *bts,
Jacob Erlbecke2e004e2015-06-18 17:16:26 +0200286 GprsMs *ms,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200287 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
288{
289 struct gprs_rlcmac_pdch *pdch;
Jacob Erlbeckec478752015-06-19 16:35:38 +0200290 int ts = -1;
Jacob Erlbeck5cd496d2015-06-30 10:24:37 +0200291 uint8_t ul_slots, dl_slots;
Jacob Erlbeckec478752015-06-19 16:35:38 +0200292 int usf = -1;
293 int mask = 0xff;
294 const char *mask_reason = NULL;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200295
296 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm A) for class "
Jacob Erlbeckbefc7602015-06-02 12:33:30 +0200297 "%d\n", tbf->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200298
Jacob Erlbeck5cd496d2015-06-30 10:24:37 +0200299 dl_slots = ms->reserved_dl_slots();
300 ul_slots = ms->reserved_ul_slots();
301
302 ts = ms->first_common_ts();
303
304 if (ts >= 0) {
Jacob Erlbeckec478752015-06-19 16:35:38 +0200305 mask_reason = "need to reuse TS";
Jacob Erlbeckec478752015-06-19 16:35:38 +0200306 mask = 1 << ts;
Jacob Erlbeck5cd496d2015-06-30 10:24:37 +0200307 } else if (dl_slots || ul_slots) {
308 mask_reason = "need to use a reserved common TS";
309 mask = dl_slots & ul_slots;
310 }
Jacob Erlbeckec478752015-06-19 16:35:38 +0200311
Jacob Erlbeck83426b22015-06-30 09:44:05 +0200312 mask = find_possible_pdchs(tbf->trx, 1, mask, mask_reason);
Jacob Erlbeckec478752015-06-19 16:35:38 +0200313 if (!mask)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200314 return -EINVAL;
315
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200316 ts = find_least_busy_pdch(tbf->trx, tbf->direction, mask,
317 compute_usage_by_reservation, &usf);
Jacob Erlbeckec478752015-06-19 16:35:38 +0200318
319 if (ts < 0) {
320 LOGP(DRLCMAC, LOGL_NOTICE, "- Failed "
321 "to allocate a TS, no USF available\n");
322 return -EBUSY;
323 }
324
Holger Hans Peter Freytherb0a00752013-09-29 08:18:17 +0200325 pdch = &tbf->trx->pdch[ts];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200326 if (tbf->direction == GPRS_RLCMAC_UL_TBF) {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200327 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Holger Hans Peter Freyther948a3d62013-09-30 14:10:23 +0200328
Jacob Erlbeckec478752015-06-19 16:35:38 +0200329 if (usf < 0)
330 usf = find_free_usf(pdch);
331
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200332 if (usf < 0) {
333 LOGP(DRLCMAC, LOGL_NOTICE, "- Failed "
334 "allocating TS=%d, no USF available\n", ts);
335 return -EBUSY;
336 }
Jacob Erlbeckec478752015-06-19 16:35:38 +0200337
338 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign uplink TS=%d USF=%d\n",
339 ts, usf);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200340 assign_uplink_tbf_usf(pdch, ul_tbf, usf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200341 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200342 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200343 LOGP(DRLCMAC, LOGL_DEBUG, "- Assign downlink TS=%d\n", ts);
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200344 assign_dlink_tbf(pdch, dl_tbf);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200345 }
346 /* the only one TS is the common TS */
347 tbf->first_ts = tbf->first_common_ts = ts;
Jacob Erlbeck5cd496d2015-06-30 10:24:37 +0200348 ms->set_reserved_slots(tbf->trx, 1 << ts, 1 << ts);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200349
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200350 tbf->upgrade_to_multislot = 0;
351
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200352 return 0;
353}
354
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200355static int find_multi_slots(struct gprs_rlcmac_bts *bts,
356 struct gprs_rlcmac_trx *trx,
357 GprsMs *ms, uint8_t *ul_slots, uint8_t *dl_slots)
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200358{
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200359 const struct gprs_ms_multislot_class *ms_class;
Holger Hans Peter Freyther882fc9b2013-12-25 20:34:26 +0100360 uint8_t Tx, Sum; /* Maximum Number of Slots: RX, Tx, Sum Rx+Tx */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200361 uint8_t Tta, Ttb, Tra, Trb; /* Minimum Number of Slots */
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200362 uint8_t Type; /* Type of Mobile */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200363 int rx_window, tx_window, pdch_slots;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200364 static const char *digit[10] = { "0","1","2","3","4","5","6","7","8","9" };
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200365 char slot_info[9] = {0};
366 int max_capacity;
367 uint8_t max_ul_slots;
368 uint8_t max_dl_slots;
369 unsigned max_slots;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200370
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200371 unsigned ul_ts, dl_ts;
372 unsigned num_tx;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200373
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200374 uint32_t checked_tx[256/32] = {0};
375
376 if (ms->ms_class() >= 32) {
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200377 LOGP(DRLCMAC, LOGL_ERROR, "Multislot class %d out of range.\n",
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200378 ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200379 return -EINVAL;
380 }
381
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200382 if (ms->ms_class()) {
383 ms_class = &gprs_ms_multislot_class[ms->ms_class()];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200384 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200385 "class %d\n", ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200386 } else {
387 ms_class = &gprs_ms_multislot_class[12];
388 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200389 "unknown class (assuming 12)\n");
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200390 }
391
392 if (ms_class->tx == MS_NA) {
393 LOGP(DRLCMAC, LOGL_NOTICE, "Multislot class %d not "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200394 "applicable.\n", ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200395 return -EINVAL;
396 }
397
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200398 Tx = ms_class->tx;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200399 Sum = ms_class->sum;
400 Tta = ms_class->ta;
401 Ttb = ms_class->tb;
402 Tra = ms_class->ra;
403 Trb = ms_class->rb;
404 Type = ms_class->type;
405
406 /* Tta and Ttb may depend on hopping or frequency change */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200407 /* TODO: Set them to 1 */
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100408 if (Ttb == MS_A || Ttb == MS_B)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200409 Ttb = 0;
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100410 if (Trb == MS_A || Trb == MS_C)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200411 Trb = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200412
413 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 +0100414 " Tra=%d Trb=%d Type=%d\n", ms_class->rx, Tx,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200415 (Sum == MS_NA) ? "N/A" : digit[Sum],
416 (Tta == MS_NA) ? "N/A" : digit[Tta], Ttb, Tra, Trb, Type);
417
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200418 max_slots = OSMO_MAX(ms_class->rx, ms_class->tx);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200419
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200420 if (*dl_slots == 0)
421 *dl_slots = 0xff;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200422
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200423 if (*ul_slots == 0)
424 *ul_slots = 0xff;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200425
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200426 pdch_slots = find_possible_pdchs(trx, max_slots, 0xff);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200427
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200428 *dl_slots &= pdch_slots;
429 *ul_slots &= pdch_slots;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200430
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200431 LOGP(DRLCMAC, LOGL_DEBUG, "- Possible DL/UL slots: (TS=0)\"%s\"(TS=7)\n",
432 set_flag_chars(set_flag_chars(set_flag_chars(slot_info,
433 *dl_slots, 'D', '.'),
434 *ul_slots, 'U'),
435 *ul_slots & *dl_slots, 'C'));
436
437 /* Check for each UL (TX) slot */
438
439 max_capacity = -1;
440 max_ul_slots = 0;
441 max_dl_slots = 0;
442
443 /* Iterate through possible numbers of TX slots */
444 for (num_tx = 1; num_tx <= ms_class->tx; num_tx += 1) {
445 uint16_t tx_valid_win = (1 << num_tx) - 1;
446
447 uint8_t rx_mask[2]; /* 0: Tt*, 1: Tr* */
448 rx_mask[0] = (0x100 >> OSMO_MAX(Ttb, Tta)) - 1;
449 rx_mask[0] &= ~((1 << (Trb + num_tx)) - 1);
450 rx_mask[0] = rx_mask[0] << 3 | rx_mask[0] >> 5;
451 rx_mask[1] = (0x100 >> Ttb) - 1;
452 rx_mask[1] &= ~((1 << (OSMO_MAX(Trb, Tra) + num_tx)) - 1);
453 rx_mask[1] = rx_mask[1] << 3 | rx_mask[1] >> 5;
454
455 /* Rotate group of TX slots: UUU-----, -UUU----, ..., UU-----U */
456 for (ul_ts = 0; ul_ts < 8; ul_ts += 1, tx_valid_win <<= 1) {
457 unsigned tx_slot_count;
458 int max_rx;
459 uint16_t rx_valid_win;
460 uint32_t checked_rx[256/32] = {0};
461
462 /* Wrap valid window */
463 tx_valid_win = (tx_valid_win | tx_valid_win >> 8) & 0xff;
464
465 tx_window = tx_valid_win;
466
467 /* Filter out unavailable slots */
468 tx_window &= *ul_slots;
469
470 /* Avoid repeated TX combination check */
471 if (test_and_set_bit(checked_tx, tx_window))
472 continue;
473
474 if (!tx_window)
475 continue;
476
477 tx_slot_count = bitcount(tx_window);
478
479 max_rx = OSMO_MIN(ms_class->rx, ms_class->sum - num_tx);
480 rx_valid_win = (1 << max_rx) - 1;
481
482 /* Rotate group of RX slots: DDD-----, -DDD----, ..., DD-----D */
483 for (dl_ts = 0; dl_ts < 8; dl_ts += 1, rx_valid_win <<= 1) {
484 /* Wrap valid window */
485 rx_valid_win = (rx_valid_win | rx_valid_win >> 8) & 0xff;
486
487 /* Validate with both Tta/Ttb/Trb and Ttb/Tra/Trb */
488 for (unsigned m_idx = 0; m_idx < ARRAY_SIZE(rx_mask); m_idx += 1) {
489 unsigned common_slot_count;
490 unsigned req_common_slots;
491 unsigned rx_slot_count;
492 uint16_t rx_bad;
493 uint8_t rx_good;
494 unsigned ts;
495 int capacity;
496
497 /* Filter out bad slots */
498 rx_bad = (uint16_t)(0xff & ~rx_mask[m_idx]) << ul_ts;
499 rx_bad = (rx_bad | (rx_bad >> 8)) & 0xff;
500 rx_good = *dl_slots & ~rx_bad;
501
502 /* TODO: CHECK this calculation -> separate function for unit
503 * testing */
504
505 rx_window = rx_good & rx_valid_win;
506
507 /* Avoid repeated RX combination check */
508 if (test_and_set_bit(checked_rx, rx_window))
509 continue;
510
511 rx_slot_count = bitcount(rx_window);
512
513#if 0
514 LOGP(DRLCMAC, LOGL_DEBUG, "n_tx=%d, n_rx=%d, "
515 "tx=%02x, rx=%02x, mask=%02x, bad=%02x, good=%02x, ul=%02x, dl=%02x\n",
516 tx_slot_count, rx_slot_count,
517 tx_window, rx_window, rx_mask[m_idx], rx_bad, rx_good, *ul_slots, *dl_slots);
518#endif
519
520 if (!rx_good) {
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200521#ifdef ENABLE_TS_ALLOC_DEBUG
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200522 LOGP(DRLCMAC, LOGL_DEBUG,
523 "- Skipping DL/UL slots: (TS=0)\"%s\"(TS=7), "
524 "no DL slots available\n",
525 set_flag_chars(set_flag_chars(slot_info,
526 rx_bad, 'x', '.'),
527 tx_window, 'U'));
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200528#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200529 continue;
530 }
531
532 if (!rx_window)
533 continue;
534
535 /* Check number of common slots according to TS 54.002, 6.4.2.2 */
536 common_slot_count = bitcount(tx_window & rx_window);
537 req_common_slots = OSMO_MIN(tx_slot_count, rx_slot_count);
538 if (ms_class->type == 1)
539 req_common_slots = OSMO_MIN(req_common_slots, 2);
540
541 if (req_common_slots != common_slot_count) {
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200542#ifdef ENABLE_TS_ALLOC_DEBUG
543 LOGP(DRLCMAC, LOGL_DEBUG,
544 "- Skipping DL/UL slots: (TS=0)\"%s\"(TS=7), "
545 "invalid number of common TS: %d (expected %d)\n",
546 set_flag_chars(set_flag_chars(set_flag_chars(
547 slot_info,
548 rx_bad, 'x', '.'),
549 rx_window, 'D'),
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200550 tx_window, 'U'),
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200551 common_slot_count,
552 req_common_slots);
553#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200554 continue;
555 }
556
557 /* Compute capacity */
558 capacity = 0;
559
560 for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) {
561 int c;
562 struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts];
563 if (rx_window & (1 << ts)) {
564 c = 32 - pdch->num_reserved(GPRS_RLCMAC_DL_TBF);
Jacob Erlbeck9ae28232015-07-01 12:27:30 +0200565 c = OSMO_MAX(c, 1);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200566 capacity += c;
567 }
Jacob Erlbecked46afd2015-07-01 12:19:40 +0200568 /* Only consider common slots for UL */
569 if (tx_window & rx_window & (1 << ts)) {
Jacob Erlbeck16c6ecc2015-06-30 13:40:18 +0200570 if (find_free_usf(pdch) >= 0) {
571 c = 32 - pdch->num_reserved(GPRS_RLCMAC_UL_TBF);
572 c = OSMO_MAX(c, 1);
573 capacity += c;
574 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200575 }
576 }
577
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200578#ifdef ENABLE_TS_ALLOC_DEBUG
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200579 LOGP(DRLCMAC, LOGL_DEBUG,
580 "- Considering DL/UL slots: (TS=0)\"%s\"(TS=7), "
581 "capacity = %d\n",
582 set_flag_chars(set_flag_chars(set_flag_chars(set_flag_chars(
583 slot_info,
584 rx_bad, 'x', '.'),
585 rx_window, 'D'),
586 tx_window, 'U'),
587 rx_window & tx_window, 'C'),
588 capacity);
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200589#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200590
591 if (capacity <= max_capacity)
592 continue;
593
594 max_capacity = capacity;
595 max_ul_slots = tx_window;
596 max_dl_slots = rx_window;
597 }}}}
598
599 if (!max_ul_slots || !max_dl_slots) {
600 LOGP(DRLCMAC, LOGL_NOTICE,
601 "No valid UL/DL slot combination found\n");
602 return -EINVAL;
603 }
604
605 *ul_slots = max_ul_slots;
606 *dl_slots = max_dl_slots;
607
608 return 0;
609}
610
611/* Slot Allocation: Algorithm B
612 *
613 * Assign as many downlink slots as possible.
614 * Assign one uplink slot. (With free USF)
615 *
616 */
617int alloc_algorithm_b(struct gprs_rlcmac_bts *bts,
618 GprsMs *ms,
619 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
620{
621 uint8_t dl_slots = 0;
622 uint8_t ul_slots = 0;
623 int8_t first_common_ts;
624 uint8_t slotcount = 0;
625 uint8_t avail_count = 0;
626 char slot_info[9] = {0};
627 int ts;
628 int rc;
629
630 if (!ms) {
631 LOGP(DRLCMAC, LOGL_ERROR, "MS not set\n");
632 return -EINVAL;
633 }
634
635 dl_slots = ms->reserved_dl_slots();
636 ul_slots = ms->reserved_ul_slots();
637
638 if (!dl_slots || !ul_slots) {
639 rc = find_multi_slots(bts, tbf->trx, ms, &ul_slots, &dl_slots);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100640 if (rc < 0)
641 return rc;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200642
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200643 ms->set_reserved_slots(tbf->trx, ul_slots, dl_slots);
644
645 LOGP(DRLCMAC, LOGL_DEBUG,
646 "- Reserved DL/UL slots: (TS=0)\"%s\"(TS=7)\n",
647 set_flag_chars(set_flag_chars(set_flag_chars(slot_info,
648 dl_slots, 'D', '.'),
649 ul_slots, 'U'),
650 ul_slots & dl_slots, 'C'));
651 }
652
653 first_common_ts = ms->first_common_ts();
654
655 if (single) {
656 /* Make sure to consider the first common slot only */
657 ul_slots = dl_slots = dl_slots & ul_slots;
658
659 ts = first_common_ts;
660
661 if (ts < 0)
662 ts = find_least_busy_pdch(tbf->trx, tbf->direction,
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200663 dl_slots & ul_slots, compute_usage_by_num_tbfs,
664 NULL);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200665 if (ts < 0)
666 ul_slots = dl_slots = lsb(dl_slots & ul_slots);
667 else
668 ul_slots = dl_slots = (dl_slots & ul_slots) & (1<<ts);
669 } else if (first_common_ts > 0) {
670 /* Make sure to keep the common TBF */
671 uint8_t disable_dl_slots;
672
673 /* Mark all slots below the common TBF, e.g. cTS=4 -> xxx----- */
674 disable_dl_slots = (1 << (first_common_ts - 1)) - 1;
675
676 /* Only disable common slots in that set */
677 disable_dl_slots &= (dl_slots & ul_slots);
678
679 /* Remove them from the uplink set */
680 ul_slots &= ~disable_dl_slots;
681
682 /* The disabled UL slots will not be used again for subsequent
683 * TBF, do not reserve them anymore */
684 if (disable_dl_slots)
685 ms->set_reserved_slots(tbf->trx, ul_slots, dl_slots);
686 }
687
688 if (dl_slots == 0) {
689 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots available\n");
690 return -EINVAL;
691 }
692
693 if (ul_slots == 0) {
694 LOGP(DRLCMAC, LOGL_NOTICE, "No uplink slots available\n");
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200695 return -EINVAL;
696 }
697
698 if (tbf->direction == GPRS_RLCMAC_DL_TBF) {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200699 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200700
701 LOGP(DRLCMAC, LOGL_DEBUG,
702 "- Selected DL slots: (TS=0)\"%s\"(TS=7)%s\n",
703 set_flag_chars(set_flag_chars(slot_info,
704 ms->reserved_dl_slots(), 'd', '.'),
705 dl_slots, 'D'),
706 single ? ", single" : "");
707
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200708 /* assign downlink */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200709 if (dl_slots == 0) {
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200710 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots "
711 "available\n");
712 return -EINVAL;
713 }
714 for (ts = 0; ts < 8; ts++) {
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200715 if (!(dl_slots & (1 << ts)))
716 continue;
717
718 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning DL TS "
719 "%d\n", ts);
720 assign_dlink_tbf(&tbf->trx->pdch[ts], dl_tbf);
721 slotcount++;
722 if (slotcount == 1)
723 dl_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200724 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200725 avail_count = bitcount(ms->reserved_dl_slots());
726
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200727 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200728 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200729 int free_usf = -1;
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200730
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200731 if (first_common_ts >= 0)
732 ul_slots = 1 << first_common_ts;
733 else
734 ul_slots = ul_slots & dl_slots;
735
736 ts = find_least_busy_pdch(tbf->trx, GPRS_RLCMAC_UL_TBF,
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200737 ul_slots, compute_usage_by_num_tbfs,
738 &free_usf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200739
740 if (free_usf < 0) {
741 LOGP(DRLCMAC, LOGL_NOTICE, "No USF available\n");
742 return -EBUSY;
743 }
744 ul_slots = 1 << ts;
745
746 LOGP(DRLCMAC, LOGL_DEBUG,
747 "- Selected UL slots: (TS=0)\"%s\"(TS=7)%s\n",
748 set_flag_chars(set_flag_chars(slot_info,
749 ms->reserved_ul_slots(), 'u', '.'),
750 ul_slots, 'U'),
751 single ? ", single" : "");
752
753 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, free_usf);
754 slotcount++;
755 ul_tbf->first_ts = ts;
756
Jacob Erlbeck5f494b82015-07-01 13:10:41 +0200757 /* We will stick to that single UL slot, unreserve the others */
758 if (ul_slots != ms->reserved_ul_slots())
759 ms->set_reserved_slots(tbf->trx,
760 ul_slots, ms->reserved_dl_slots());
761
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200762 avail_count = bitcount(ms->reserved_ul_slots());
763#if 0 /* This code assigns multiple slots for UL (and wastes USFs that way) */
764 for (ts = 0; ts < 8; ts++) {
765 if (!(ul_slots & (1 << ts)))
766 continue;
767
768 free_usf = find_free_usf(&tbf->trx->pdch[ts]);
769 if (free_usf < 0) {
770 LOGP(DRLCMAC, LOGL_DEBUG,
771 "- Skipping TS %d, because "
772 "no USF available\n", ts);
773 continue;
774 }
775
776 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning UL TS "
777 "%d\n", ts);
778 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, free_usf);
779 slotcount++;
780 if (slotcount == 1)
781 ul_tbf->first_ts = ts;
782 }
783#endif
784 }
785
786 if (single && slotcount) {
787 tbf->upgrade_to_multislot = (avail_count > slotcount);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200788 LOGP(DRLCMAC, LOGL_INFO, "Using single slot at TS %d for %s\n",
789 tbf->first_ts,
790 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
791 } else {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200792 tbf->upgrade_to_multislot = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200793 LOGP(DRLCMAC, LOGL_INFO, "Using %d slots for %s\n", slotcount,
794 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
795 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200796
797 first_common_ts = ffs(dl_slots & ul_slots) - 1;
798
799 if (first_common_ts < 0) {
800 LOGP(DRLCMAC, LOGL_NOTICE, "No first common slots available\n");
801 return -EINVAL;
802 }
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200803
804 tbf->first_common_ts = first_common_ts;
805
806 return 0;
807}