blob: b9d4e41a336738561d54ebd29721aa615a75c8be [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;
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200373 enum {MASK_TT, MASK_TR};
374 unsigned mask_sel;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200375
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200376 uint32_t checked_tx[256/32] = {0};
377
378 if (ms->ms_class() >= 32) {
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200379 LOGP(DRLCMAC, LOGL_ERROR, "Multislot class %d out of range.\n",
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200380 ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200381 return -EINVAL;
382 }
383
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200384 if (ms->ms_class()) {
385 ms_class = &gprs_ms_multislot_class[ms->ms_class()];
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200386 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200387 "class %d\n", ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200388 } else {
389 ms_class = &gprs_ms_multislot_class[12];
390 LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200391 "unknown class (assuming 12)\n");
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200392 }
393
394 if (ms_class->tx == MS_NA) {
395 LOGP(DRLCMAC, LOGL_NOTICE, "Multislot class %d not "
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200396 "applicable.\n", ms->ms_class());
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200397 return -EINVAL;
398 }
399
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200400 Tx = ms_class->tx;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200401 Sum = ms_class->sum;
402 Tta = ms_class->ta;
403 Ttb = ms_class->tb;
404 Tra = ms_class->ra;
405 Trb = ms_class->rb;
406 Type = ms_class->type;
407
408 /* Tta and Ttb may depend on hopping or frequency change */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200409 /* TODO: Set them to 1 */
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100410 if (Ttb == MS_A || Ttb == MS_B)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200411 Ttb = 0;
Holger Hans Peter Freytherf34f3442013-12-25 20:33:37 +0100412 if (Trb == MS_A || Trb == MS_C)
Holger Hans Peter Freyther11a74892013-09-29 08:13:42 +0200413 Trb = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200414
415 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 +0100416 " Tra=%d Trb=%d Type=%d\n", ms_class->rx, Tx,
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200417 (Sum == MS_NA) ? "N/A" : digit[Sum],
418 (Tta == MS_NA) ? "N/A" : digit[Tta], Ttb, Tra, Trb, Type);
419
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200420 max_slots = OSMO_MAX(ms_class->rx, ms_class->tx);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200421
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200422 if (*dl_slots == 0)
423 *dl_slots = 0xff;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200424
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200425 if (*ul_slots == 0)
426 *ul_slots = 0xff;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200427
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200428 pdch_slots = find_possible_pdchs(trx, max_slots, 0xff);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200429
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200430 *dl_slots &= pdch_slots;
431 *ul_slots &= pdch_slots;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200432
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200433 LOGP(DRLCMAC, LOGL_DEBUG, "- Possible DL/UL slots: (TS=0)\"%s\"(TS=7)\n",
434 set_flag_chars(set_flag_chars(set_flag_chars(slot_info,
435 *dl_slots, 'D', '.'),
436 *ul_slots, 'U'),
437 *ul_slots & *dl_slots, 'C'));
438
439 /* Check for each UL (TX) slot */
440
441 max_capacity = -1;
442 max_ul_slots = 0;
443 max_dl_slots = 0;
444
445 /* Iterate through possible numbers of TX slots */
446 for (num_tx = 1; num_tx <= ms_class->tx; num_tx += 1) {
447 uint16_t tx_valid_win = (1 << num_tx) - 1;
448
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200449 uint8_t rx_mask[MASK_TR+1];
Jacob Erlbeckdd08ac82015-07-09 12:06:56 +0200450 if (ms_class->type == 1) {
451 rx_mask[MASK_TT] = (0x100 >> OSMO_MAX(Ttb, Tta)) - 1;
452 rx_mask[MASK_TT] &= ~((1 << (Trb + num_tx)) - 1);
453 rx_mask[MASK_TR] = (0x100 >> Ttb) - 1;
454 rx_mask[MASK_TR] &=
455 ~((1 << (OSMO_MAX(Trb, Tra) + num_tx)) - 1);
456 } else {
457 /* Class type 2 MS have independant RX and TX */
458 rx_mask[MASK_TT] = 0xff;
459 rx_mask[MASK_TR] = 0xff;
460 }
461
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200462 rx_mask[MASK_TT] = (rx_mask[MASK_TT] << 3) | (rx_mask[MASK_TT] >> 5);
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200463 rx_mask[MASK_TR] = (rx_mask[MASK_TR] << 3) | (rx_mask[MASK_TR] >> 5);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200464
465 /* Rotate group of TX slots: UUU-----, -UUU----, ..., UU-----U */
466 for (ul_ts = 0; ul_ts < 8; ul_ts += 1, tx_valid_win <<= 1) {
467 unsigned tx_slot_count;
468 int max_rx;
469 uint16_t rx_valid_win;
470 uint32_t checked_rx[256/32] = {0};
471
472 /* Wrap valid window */
473 tx_valid_win = (tx_valid_win | tx_valid_win >> 8) & 0xff;
474
475 tx_window = tx_valid_win;
476
477 /* Filter out unavailable slots */
478 tx_window &= *ul_slots;
479
480 /* Avoid repeated TX combination check */
481 if (test_and_set_bit(checked_tx, tx_window))
482 continue;
483
484 if (!tx_window)
485 continue;
486
487 tx_slot_count = bitcount(tx_window);
488
489 max_rx = OSMO_MIN(ms_class->rx, ms_class->sum - num_tx);
490 rx_valid_win = (1 << max_rx) - 1;
491
492 /* Rotate group of RX slots: DDD-----, -DDD----, ..., DD-----D */
493 for (dl_ts = 0; dl_ts < 8; dl_ts += 1, rx_valid_win <<= 1) {
494 /* Wrap valid window */
495 rx_valid_win = (rx_valid_win | rx_valid_win >> 8) & 0xff;
496
497 /* Validate with both Tta/Ttb/Trb and Ttb/Tra/Trb */
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200498 for (mask_sel = MASK_TT; mask_sel <= MASK_TR; mask_sel += 1) {
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200499 unsigned common_slot_count;
500 unsigned req_common_slots;
501 unsigned rx_slot_count;
502 uint16_t rx_bad;
503 uint8_t rx_good;
504 unsigned ts;
505 int capacity;
506
507 /* Filter out bad slots */
Jacob Erlbeck5e46a202015-07-09 11:48:23 +0200508 rx_bad = (uint16_t)(0xff & ~rx_mask[mask_sel]) << ul_ts;
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200509 rx_bad = (rx_bad | (rx_bad >> 8)) & 0xff;
510 rx_good = *dl_slots & ~rx_bad;
511
512 /* TODO: CHECK this calculation -> separate function for unit
513 * testing */
514
515 rx_window = rx_good & rx_valid_win;
Jacob Erlbeckbae33a72015-07-06 14:55:13 +0200516 rx_slot_count = bitcount(rx_window);
517
518#if 0
519 LOGP(DRLCMAC, LOGL_DEBUG, "n_tx=%d, n_rx=%d, mask_sel=%d, "
520 "tx=%02x, rx=%02x, mask=%02x, bad=%02x, good=%02x, "
521 "ul=%02x, dl=%02x\n",
522 tx_slot_count, rx_slot_count, mask_sel,
523 tx_window, rx_window, rx_mask[mask_sel], rx_bad, rx_good,
524 *ul_slots, *dl_slots);
525#endif
526
527 /* Check compliance with TS 45.002, table 6.4.2.2.1 */
528 /* Whether to skip this round doesn not only depend on the bit
529 * sets but also on mask_sel. Therefore this check must be done
530 * before doing the test_and_set_bit shortcut. */
531 if (ms_class->type == 1) {
532 unsigned slot_sum = rx_slot_count + tx_slot_count;
533 /* Assume down+up/dynamic.
534 * TODO: For ext-dynamic, down only, up only add more
535 * cases.
536 */
537 if (slot_sum <= 6 && tx_slot_count < 3) {
538 if (mask_sel != MASK_TR)
539 /* Skip Tta */
540 continue;
541 } else if (slot_sum > 6 && tx_slot_count < 3) {
542 if (mask_sel != MASK_TT)
543 /* Skip Tra */
544 continue;
545 } else {
546 /* No supported row in table 6.4.2.2.1. */
547#ifdef ENABLE_TS_ALLOC_DEBUG
548 LOGP(DRLCMAC, LOGL_DEBUG,
549 "- Skipping DL/UL slots: (TS=0)\"%s\"(TS=7), "
550 "combination not supported\n",
551 set_flag_chars(set_flag_chars(set_flag_chars(
552 slot_info,
553 rx_bad, 'x', '.'),
554 rx_window, 'D'),
555 tx_window, 'U'));
556#endif
557 continue;
558 }
559 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200560
561 /* Avoid repeated RX combination check */
562 if (test_and_set_bit(checked_rx, rx_window))
563 continue;
564
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200565 if (!rx_good) {
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200566#ifdef ENABLE_TS_ALLOC_DEBUG
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200567 LOGP(DRLCMAC, LOGL_DEBUG,
568 "- Skipping DL/UL slots: (TS=0)\"%s\"(TS=7), "
569 "no DL slots available\n",
570 set_flag_chars(set_flag_chars(slot_info,
571 rx_bad, 'x', '.'),
572 tx_window, 'U'));
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200573#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200574 continue;
575 }
576
577 if (!rx_window)
578 continue;
579
580 /* Check number of common slots according to TS 54.002, 6.4.2.2 */
581 common_slot_count = bitcount(tx_window & rx_window);
582 req_common_slots = OSMO_MIN(tx_slot_count, rx_slot_count);
583 if (ms_class->type == 1)
584 req_common_slots = OSMO_MIN(req_common_slots, 2);
585
586 if (req_common_slots != common_slot_count) {
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200587#ifdef ENABLE_TS_ALLOC_DEBUG
588 LOGP(DRLCMAC, LOGL_DEBUG,
589 "- Skipping DL/UL slots: (TS=0)\"%s\"(TS=7), "
590 "invalid number of common TS: %d (expected %d)\n",
591 set_flag_chars(set_flag_chars(set_flag_chars(
592 slot_info,
593 rx_bad, 'x', '.'),
594 rx_window, 'D'),
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200595 tx_window, 'U'),
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200596 common_slot_count,
597 req_common_slots);
598#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200599 continue;
600 }
601
602 /* Compute capacity */
603 capacity = 0;
604
605 for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) {
606 int c;
607 struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts];
608 if (rx_window & (1 << ts)) {
609 c = 32 - pdch->num_reserved(GPRS_RLCMAC_DL_TBF);
Jacob Erlbeck9ae28232015-07-01 12:27:30 +0200610 c = OSMO_MAX(c, 1);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200611 capacity += c;
612 }
Jacob Erlbecked46afd2015-07-01 12:19:40 +0200613 /* Only consider common slots for UL */
614 if (tx_window & rx_window & (1 << ts)) {
Jacob Erlbeck16c6ecc2015-06-30 13:40:18 +0200615 if (find_free_usf(pdch) >= 0) {
616 c = 32 - pdch->num_reserved(GPRS_RLCMAC_UL_TBF);
617 c = OSMO_MAX(c, 1);
618 capacity += c;
619 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200620 }
621 }
622
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200623#ifdef ENABLE_TS_ALLOC_DEBUG
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200624 LOGP(DRLCMAC, LOGL_DEBUG,
625 "- Considering DL/UL slots: (TS=0)\"%s\"(TS=7), "
626 "capacity = %d\n",
627 set_flag_chars(set_flag_chars(set_flag_chars(set_flag_chars(
628 slot_info,
629 rx_bad, 'x', '.'),
630 rx_window, 'D'),
631 tx_window, 'U'),
632 rx_window & tx_window, 'C'),
633 capacity);
Jacob Erlbeck1653f832015-06-30 14:48:13 +0200634#endif
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200635
636 if (capacity <= max_capacity)
637 continue;
638
639 max_capacity = capacity;
640 max_ul_slots = tx_window;
641 max_dl_slots = rx_window;
642 }}}}
643
644 if (!max_ul_slots || !max_dl_slots) {
645 LOGP(DRLCMAC, LOGL_NOTICE,
646 "No valid UL/DL slot combination found\n");
647 return -EINVAL;
648 }
649
650 *ul_slots = max_ul_slots;
651 *dl_slots = max_dl_slots;
652
653 return 0;
654}
655
656/* Slot Allocation: Algorithm B
657 *
658 * Assign as many downlink slots as possible.
659 * Assign one uplink slot. (With free USF)
660 *
661 */
662int alloc_algorithm_b(struct gprs_rlcmac_bts *bts,
663 GprsMs *ms,
664 struct gprs_rlcmac_tbf *tbf, uint32_t cust, uint8_t single)
665{
666 uint8_t dl_slots = 0;
667 uint8_t ul_slots = 0;
668 int8_t first_common_ts;
669 uint8_t slotcount = 0;
670 uint8_t avail_count = 0;
671 char slot_info[9] = {0};
672 int ts;
673 int rc;
674
675 if (!ms) {
676 LOGP(DRLCMAC, LOGL_ERROR, "MS not set\n");
677 return -EINVAL;
678 }
679
680 dl_slots = ms->reserved_dl_slots();
681 ul_slots = ms->reserved_ul_slots();
682
683 if (!dl_slots || !ul_slots) {
684 rc = find_multi_slots(bts, tbf->trx, ms, &ul_slots, &dl_slots);
Holger Hans Peter Freyther73193112013-12-26 09:49:05 +0100685 if (rc < 0)
686 return rc;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200687
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200688 ms->set_reserved_slots(tbf->trx, ul_slots, dl_slots);
689
690 LOGP(DRLCMAC, LOGL_DEBUG,
691 "- Reserved DL/UL slots: (TS=0)\"%s\"(TS=7)\n",
692 set_flag_chars(set_flag_chars(set_flag_chars(slot_info,
693 dl_slots, 'D', '.'),
694 ul_slots, 'U'),
695 ul_slots & dl_slots, 'C'));
696 }
697
698 first_common_ts = ms->first_common_ts();
699
700 if (single) {
701 /* Make sure to consider the first common slot only */
702 ul_slots = dl_slots = dl_slots & ul_slots;
703
704 ts = first_common_ts;
705
706 if (ts < 0)
707 ts = find_least_busy_pdch(tbf->trx, tbf->direction,
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200708 dl_slots & ul_slots, compute_usage_by_num_tbfs,
709 NULL);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200710 if (ts < 0)
711 ul_slots = dl_slots = lsb(dl_slots & ul_slots);
712 else
713 ul_slots = dl_slots = (dl_slots & ul_slots) & (1<<ts);
714 } else if (first_common_ts > 0) {
715 /* Make sure to keep the common TBF */
716 uint8_t disable_dl_slots;
717
718 /* Mark all slots below the common TBF, e.g. cTS=4 -> xxx----- */
719 disable_dl_slots = (1 << (first_common_ts - 1)) - 1;
720
721 /* Only disable common slots in that set */
722 disable_dl_slots &= (dl_slots & ul_slots);
723
724 /* Remove them from the uplink set */
725 ul_slots &= ~disable_dl_slots;
726
727 /* The disabled UL slots will not be used again for subsequent
728 * TBF, do not reserve them anymore */
729 if (disable_dl_slots)
730 ms->set_reserved_slots(tbf->trx, ul_slots, dl_slots);
731 }
732
733 if (dl_slots == 0) {
734 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots available\n");
735 return -EINVAL;
736 }
737
738 if (ul_slots == 0) {
739 LOGP(DRLCMAC, LOGL_NOTICE, "No uplink slots available\n");
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200740 return -EINVAL;
741 }
742
743 if (tbf->direction == GPRS_RLCMAC_DL_TBF) {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200744 struct gprs_rlcmac_dl_tbf *dl_tbf = static_cast<gprs_rlcmac_dl_tbf *>(tbf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200745
746 LOGP(DRLCMAC, LOGL_DEBUG,
747 "- Selected DL slots: (TS=0)\"%s\"(TS=7)%s\n",
748 set_flag_chars(set_flag_chars(slot_info,
749 ms->reserved_dl_slots(), 'd', '.'),
750 dl_slots, 'D'),
751 single ? ", single" : "");
752
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200753 /* assign downlink */
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200754 if (dl_slots == 0) {
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200755 LOGP(DRLCMAC, LOGL_NOTICE, "No downlink slots "
756 "available\n");
757 return -EINVAL;
758 }
759 for (ts = 0; ts < 8; ts++) {
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200760 if (!(dl_slots & (1 << ts)))
761 continue;
762
763 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning DL TS "
764 "%d\n", ts);
765 assign_dlink_tbf(&tbf->trx->pdch[ts], dl_tbf);
766 slotcount++;
767 if (slotcount == 1)
768 dl_tbf->first_ts = ts;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200769 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200770 avail_count = bitcount(ms->reserved_dl_slots());
771
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200772 } else {
Daniel Willmanncd44ec42014-08-07 15:04:57 +0200773 struct gprs_rlcmac_ul_tbf *ul_tbf = static_cast<gprs_rlcmac_ul_tbf *>(tbf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200774 int free_usf = -1;
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200775
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200776 if (first_common_ts >= 0)
777 ul_slots = 1 << first_common_ts;
778 else
779 ul_slots = ul_slots & dl_slots;
780
781 ts = find_least_busy_pdch(tbf->trx, GPRS_RLCMAC_UL_TBF,
Jacob Erlbeckc135b872015-07-09 13:44:18 +0200782 ul_slots, compute_usage_by_num_tbfs,
783 &free_usf);
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200784
785 if (free_usf < 0) {
786 LOGP(DRLCMAC, LOGL_NOTICE, "No USF available\n");
787 return -EBUSY;
788 }
789 ul_slots = 1 << ts;
790
791 LOGP(DRLCMAC, LOGL_DEBUG,
792 "- Selected UL slots: (TS=0)\"%s\"(TS=7)%s\n",
793 set_flag_chars(set_flag_chars(slot_info,
794 ms->reserved_ul_slots(), 'u', '.'),
795 ul_slots, 'U'),
796 single ? ", single" : "");
797
798 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, free_usf);
799 slotcount++;
800 ul_tbf->first_ts = ts;
801
Jacob Erlbeck5f494b82015-07-01 13:10:41 +0200802 /* We will stick to that single UL slot, unreserve the others */
803 if (ul_slots != ms->reserved_ul_slots())
804 ms->set_reserved_slots(tbf->trx,
805 ul_slots, ms->reserved_dl_slots());
806
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200807 avail_count = bitcount(ms->reserved_ul_slots());
808#if 0 /* This code assigns multiple slots for UL (and wastes USFs that way) */
809 for (ts = 0; ts < 8; ts++) {
810 if (!(ul_slots & (1 << ts)))
811 continue;
812
813 free_usf = find_free_usf(&tbf->trx->pdch[ts]);
814 if (free_usf < 0) {
815 LOGP(DRLCMAC, LOGL_DEBUG,
816 "- Skipping TS %d, because "
817 "no USF available\n", ts);
818 continue;
819 }
820
821 LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning UL TS "
822 "%d\n", ts);
823 assign_uplink_tbf_usf(&tbf->trx->pdch[ts], ul_tbf, free_usf);
824 slotcount++;
825 if (slotcount == 1)
826 ul_tbf->first_ts = ts;
827 }
828#endif
829 }
830
831 if (single && slotcount) {
832 tbf->upgrade_to_multislot = (avail_count > slotcount);
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200833 LOGP(DRLCMAC, LOGL_INFO, "Using single slot at TS %d for %s\n",
834 tbf->first_ts,
835 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
836 } else {
Daniel Willmanncf1fae72014-05-30 17:58:01 +0200837 tbf->upgrade_to_multislot = 0;
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200838 LOGP(DRLCMAC, LOGL_INFO, "Using %d slots for %s\n", slotcount,
839 (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL");
840 }
Jacob Erlbeckea65c722015-06-22 16:14:23 +0200841
842 first_common_ts = ffs(dl_slots & ul_slots) - 1;
843
844 if (first_common_ts < 0) {
845 LOGP(DRLCMAC, LOGL_NOTICE, "No first common slots available\n");
846 return -EINVAL;
847 }
Holger Hans Peter Freyther02ab4a82013-09-29 07:37:40 +0200848
849 tbf->first_common_ts = first_common_ts;
850
851 return 0;
852}