Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 1 | /* 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 Freyther | 34bd8bd | 2013-10-19 21:10:38 +0200 | [diff] [blame] | 24 | #include <bts.h> |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 25 | #include <tbf.h> |
Pau Espin Pedrol | 9d1cdb1 | 2019-09-25 17:47:02 +0200 | [diff] [blame] | 26 | #include <tbf_ul.h> |
Max | 6dc90b8 | 2018-02-19 17:17:28 +0100 | [diff] [blame] | 27 | #include <pdch.h> |
Jacob Erlbeck | e2e004e | 2015-06-18 17:16:26 +0200 | [diff] [blame] | 28 | #include <gprs_ms.h> |
Jacob Erlbeck | 8cba7e9 | 2016-01-19 15:48:03 +0100 | [diff] [blame] | 29 | #include <pcu_utils.h> |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 30 | |
| 31 | #include <errno.h> |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 32 | #include <values.h> |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 33 | |
Max | 842d781 | 2017-11-01 18:11:24 +0100 | [diff] [blame] | 34 | extern "C" { |
| 35 | #include "mslot_class.h" |
Max | 1187a77 | 2018-01-26 13:31:42 +0100 | [diff] [blame] | 36 | #include <osmocom/core/linuxlist.h> |
| 37 | #include <osmocom/core/logging.h> |
| 38 | #include <osmocom/core/utils.h> |
Max | 842d781 | 2017-11-01 18:11:24 +0100 | [diff] [blame] | 39 | } |
| 40 | |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 41 | /* Consider a PDCH as idle if has at most this number of TBFs assigned to it */ |
| 42 | #define PDCH_IDLE_TBF_THRESH 1 |
| 43 | |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 44 | #define LOGPSL(tbf, level, fmt, args...) LOGP(DRLCMAC, level, "[%s] " fmt, \ |
| 45 | (tbf->direction == GPRS_RLCMAC_DL_TBF) ? "DL" : "UL", ## args) |
| 46 | |
| 47 | #define LOGPAL(tbf, kind, single, trx_n, level, fmt, args...) LOGPSL(tbf, level, \ |
| 48 | "algo %s <%s> (suggested TRX: %d): " fmt, \ |
| 49 | kind, single ? "single" : "multi", trx_n, ## args) |
| 50 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 51 | static char *set_flag_chars(char *buf, uint8_t val, char set_char, char unset_char = 0) |
| 52 | { |
| 53 | int i; |
| 54 | |
| 55 | for (i = 0; i < 8; i += 1, val = val >> 1) { |
| 56 | if (val & 1) |
| 57 | buf[i] = set_char; |
| 58 | else if (unset_char) |
| 59 | buf[i] = unset_char; |
| 60 | } |
| 61 | |
| 62 | return buf; |
| 63 | } |
| 64 | |
Max | 731e2bb | 2018-02-05 16:15:30 +0100 | [diff] [blame] | 65 | static uint8_t find_possible_pdchs(const struct gprs_rlcmac_trx *trx, uint8_t max_slots, uint8_t mask, |
| 66 | const char *mask_reason = NULL) |
Holger Hans Peter Freyther | b0a0075 | 2013-09-29 08:18:17 +0200 | [diff] [blame] | 67 | { |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 68 | unsigned ts; |
Max | 731e2bb | 2018-02-05 16:15:30 +0100 | [diff] [blame] | 69 | uint8_t valid_ts_set = 0; |
Jacob Erlbeck | 83426b2 | 2015-06-30 09:44:05 +0200 | [diff] [blame] | 70 | int8_t last_tsc = -1; /* must be signed */ |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 71 | |
| 72 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 73 | const struct gprs_rlcmac_pdch *pdch; |
Holger Hans Peter Freyther | b0a0075 | 2013-09-29 08:18:17 +0200 | [diff] [blame] | 74 | |
| 75 | pdch = &trx->pdch[ts]; |
Holger Hans Peter Freyther | 17b0d83 | 2013-10-19 17:37:48 +0200 | [diff] [blame] | 76 | if (!pdch->is_enabled()) { |
Holger Hans Peter Freyther | b0a0075 | 2013-09-29 08:18:17 +0200 | [diff] [blame] | 77 | LOGP(DRLCMAC, LOGL_DEBUG, "- Skipping TS %d, because " |
| 78 | "not enabled\n", ts); |
| 79 | continue; |
| 80 | } |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 81 | |
| 82 | if (((1 << ts) & mask) == 0) { |
| 83 | if (mask_reason) |
| 84 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 85 | "- Skipping TS %d, because %s\n", |
| 86 | ts, mask_reason); |
| 87 | continue; |
| 88 | } |
| 89 | |
Jacob Erlbeck | 83426b2 | 2015-06-30 09:44:05 +0200 | [diff] [blame] | 90 | if (max_slots > 1) { |
| 91 | /* check if TSC changes, see TS 45.002, 6.4.2 */ |
| 92 | if (last_tsc < 0) |
| 93 | last_tsc = pdch->tsc; |
| 94 | else if (last_tsc != pdch->tsc) { |
| 95 | LOGP(DRLCMAC, LOGL_ERROR, |
| 96 | "Skipping TS %d of TRX=%d, because it " |
| 97 | "has different TSC than lower TS of TRX. " |
| 98 | "In order to allow multislot, all " |
| 99 | "slots must be configured with the same " |
| 100 | "TSC!\n", ts, trx->trx_no); |
| 101 | continue; |
| 102 | } |
| 103 | } |
| 104 | |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 105 | valid_ts_set |= 1 << ts; |
Holger Hans Peter Freyther | b0a0075 | 2013-09-29 08:18:17 +0200 | [diff] [blame] | 106 | } |
| 107 | |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 108 | return valid_ts_set; |
| 109 | } |
| 110 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 111 | static int compute_usage_by_num_tbfs(const struct gprs_rlcmac_pdch *pdch, enum gprs_rlcmac_tbf_direction dir) |
Jacob Erlbeck | c135b87 | 2015-07-09 13:44:18 +0200 | [diff] [blame] | 112 | { |
| 113 | return pdch->num_tbfs(dir); |
| 114 | } |
| 115 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 116 | static int compute_usage_by_reservation(const struct gprs_rlcmac_pdch *pdch, enum gprs_rlcmac_tbf_direction) |
Jacob Erlbeck | c135b87 | 2015-07-09 13:44:18 +0200 | [diff] [blame] | 117 | { |
| 118 | return |
| 119 | pdch->num_reserved(GPRS_RLCMAC_DL_TBF) + |
| 120 | pdch->num_reserved(GPRS_RLCMAC_UL_TBF); |
| 121 | } |
| 122 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 123 | static int compute_usage_for_algo_a(const struct gprs_rlcmac_pdch *pdch, enum gprs_rlcmac_tbf_direction dir) |
Jacob Erlbeck | 7af53e6 | 2015-07-16 15:04:07 +0200 | [diff] [blame] | 124 | { |
| 125 | int usage = |
| 126 | pdch->num_tbfs(GPRS_RLCMAC_DL_TBF) + |
| 127 | pdch->num_tbfs(GPRS_RLCMAC_UL_TBF) + |
| 128 | compute_usage_by_reservation(pdch, dir); |
| 129 | |
Max | d000d80 | 2017-09-20 17:55:28 +0200 | [diff] [blame] | 130 | if (pdch->assigned_tfi(reverse(dir)) == NO_FREE_TFI) |
Jacob Erlbeck | 7af53e6 | 2015-07-16 15:04:07 +0200 | [diff] [blame] | 131 | /* No TFI in the opposite direction, avoid it */ |
| 132 | usage += 32; |
| 133 | |
| 134 | return usage; |
| 135 | |
| 136 | } |
| 137 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 138 | /*! Return the TS which corresponds to least busy PDCH |
| 139 | * |
| 140 | * \param[in] trx Pointer to TRX object |
| 141 | * \param[in] dir TBF direction |
| 142 | * \param[in] mask set of available timeslots |
| 143 | * \param[in] fn Function pointer to function which computes number of associated TBFs |
| 144 | * \param[out] free_tfi Free TFI |
| 145 | * \param[out] free_usf Free USF |
| 146 | * \returns TS number or -1 if unable to find |
| 147 | */ |
| 148 | static int find_least_busy_pdch(const struct gprs_rlcmac_trx *trx, enum gprs_rlcmac_tbf_direction dir, uint8_t mask, |
| 149 | int (*fn)(const struct gprs_rlcmac_pdch *, enum gprs_rlcmac_tbf_direction dir), |
Pau Espin Pedrol | 1f8e229 | 2021-02-19 16:49:16 +0100 | [diff] [blame] | 150 | int *free_tfi = NULL, int *free_usf = NULL) |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 151 | { |
| 152 | unsigned ts; |
| 153 | int min_used = INT_MAX; |
| 154 | int min_ts = -1; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 155 | int min_tfi = -1; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 156 | int min_usf = -1; |
| 157 | |
| 158 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 159 | const struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts]; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 160 | int num_tbfs; |
| 161 | int usf = -1; /* must be signed */ |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 162 | int tfi = -1; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 163 | |
| 164 | if (((1 << ts) & mask) == 0) |
| 165 | continue; |
| 166 | |
Jacob Erlbeck | c135b87 | 2015-07-09 13:44:18 +0200 | [diff] [blame] | 167 | num_tbfs = fn(pdch, dir); |
Jacob Erlbeck | efe62a7 | 2015-07-02 15:48:25 +0200 | [diff] [blame] | 168 | |
| 169 | if (num_tbfs < min_used) { |
| 170 | /* We have found a candidate */ |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 171 | /* Make sure that a TFI is available */ |
| 172 | if (free_tfi) { |
Max | c5407c7 | 2018-02-05 16:11:36 +0100 | [diff] [blame] | 173 | tfi = find_free_tfi(pdch->assigned_tfi(dir)); |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 174 | if (tfi < 0) { |
| 175 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 176 | "- Skipping TS %d, because " |
| 177 | "no TFI available\n", ts); |
| 178 | continue; |
| 179 | } |
| 180 | } |
Jacob Erlbeck | efe62a7 | 2015-07-02 15:48:25 +0200 | [diff] [blame] | 181 | /* Make sure that an USF is available */ |
| 182 | if (dir == GPRS_RLCMAC_UL_TBF) { |
Max | adca67b | 2018-01-31 15:22:36 +0100 | [diff] [blame] | 183 | usf = find_free_usf(pdch->assigned_usf()); |
Jacob Erlbeck | efe62a7 | 2015-07-02 15:48:25 +0200 | [diff] [blame] | 184 | if (usf < 0) { |
| 185 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 186 | "- Skipping TS %d, because " |
| 187 | "no USF available\n", ts); |
| 188 | continue; |
| 189 | } |
| 190 | } |
| 191 | if (min_ts >= 0) |
| 192 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 193 | "- Skipping TS %d, because " |
| 194 | "num TBFs %d > %d\n", |
| 195 | min_ts, min_used, num_tbfs); |
| 196 | min_used = num_tbfs; |
| 197 | min_ts = ts; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 198 | min_tfi = tfi; |
Jacob Erlbeck | efe62a7 | 2015-07-02 15:48:25 +0200 | [diff] [blame] | 199 | min_usf = usf; |
| 200 | } else { |
| 201 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 202 | "- Skipping TS %d, because " |
| 203 | "num TBFs %d >= %d\n", |
| 204 | ts, num_tbfs, min_used); |
| 205 | } |
| 206 | } |
| 207 | |
| 208 | if (min_ts < 0) |
| 209 | return -1; |
| 210 | |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 211 | if (free_tfi) |
| 212 | *free_tfi = min_tfi; |
Jacob Erlbeck | efe62a7 | 2015-07-02 15:48:25 +0200 | [diff] [blame] | 213 | if (free_usf) |
| 214 | *free_usf = min_usf; |
| 215 | |
| 216 | return min_ts; |
| 217 | } |
| 218 | |
Jacob Erlbeck | ccc34e4 | 2015-06-29 13:45:05 +0200 | [diff] [blame] | 219 | static void attach_tbf_to_pdch(struct gprs_rlcmac_pdch *pdch, |
| 220 | struct gprs_rlcmac_tbf *tbf) |
| 221 | { |
| 222 | if (tbf->pdch[pdch->ts_no]) |
| 223 | tbf->pdch[pdch->ts_no]->detach_tbf(tbf); |
| 224 | |
| 225 | tbf->pdch[pdch->ts_no] = pdch; |
| 226 | pdch->attach_tbf(tbf); |
| 227 | } |
| 228 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 229 | static void assign_uplink_tbf_usf(struct gprs_rlcmac_pdch *pdch, struct gprs_rlcmac_ul_tbf *tbf, uint8_t tfi, int8_t usf) |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 230 | { |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 231 | tbf->m_tfi = tfi; |
Daniel Willmann | 7e994e3 | 2014-08-07 15:49:21 +0200 | [diff] [blame] | 232 | tbf->m_usf[pdch->ts_no] = usf; |
Jacob Erlbeck | ccc34e4 | 2015-06-29 13:45:05 +0200 | [diff] [blame] | 233 | attach_tbf_to_pdch(pdch, tbf); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 234 | } |
| 235 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 236 | static void assign_dlink_tbf(struct gprs_rlcmac_pdch *pdch, struct gprs_rlcmac_dl_tbf *tbf, uint8_t tfi) |
Holger Hans Peter Freyther | 8481a05 | 2013-09-29 08:08:28 +0200 | [diff] [blame] | 237 | { |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 238 | tbf->m_tfi = tfi; |
Jacob Erlbeck | ccc34e4 | 2015-06-29 13:45:05 +0200 | [diff] [blame] | 239 | attach_tbf_to_pdch(pdch, tbf); |
Holger Hans Peter Freyther | 8481a05 | 2013-09-29 08:08:28 +0200 | [diff] [blame] | 240 | } |
| 241 | |
Pau Espin Pedrol | 0ece97d | 2021-01-18 12:53:54 +0100 | [diff] [blame] | 242 | static int find_trx(const struct gprs_rlcmac_bts *bts, const GprsMs *ms, int8_t use_trx) |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 243 | { |
| 244 | unsigned trx_no; |
| 245 | unsigned ts; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 246 | |
| 247 | /* We must use the TRX currently actively used by an MS */ |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 248 | if (ms && ms_current_trx(ms)) |
| 249 | return ms_current_trx(ms)->trx_no; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 250 | |
| 251 | if (use_trx >= 0 && use_trx < 8) |
| 252 | return use_trx; |
| 253 | |
| 254 | /* Find the first TRX that has a PDCH with a free UL and DL TFI */ |
Pau Espin Pedrol | 0ece97d | 2021-01-18 12:53:54 +0100 | [diff] [blame] | 255 | for (trx_no = 0; trx_no < ARRAY_SIZE(bts->trx); trx_no += 1) { |
| 256 | const struct gprs_rlcmac_trx *trx = &bts->trx[trx_no]; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 257 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 258 | const struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts]; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 259 | if (!pdch->is_enabled()) |
| 260 | continue; |
| 261 | |
Max | d000d80 | 2017-09-20 17:55:28 +0200 | [diff] [blame] | 262 | if (pdch->assigned_tfi(GPRS_RLCMAC_UL_TBF) == NO_FREE_TFI) |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 263 | continue; |
| 264 | |
Max | d000d80 | 2017-09-20 17:55:28 +0200 | [diff] [blame] | 265 | if (pdch->assigned_tfi(GPRS_RLCMAC_DL_TBF) == NO_FREE_TFI) |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 266 | continue; |
| 267 | |
| 268 | return trx_no; |
| 269 | } |
| 270 | } |
| 271 | |
| 272 | return -EBUSY; |
| 273 | } |
| 274 | |
Pau Espin Pedrol | 0ece97d | 2021-01-18 12:53:54 +0100 | [diff] [blame] | 275 | static bool idle_pdch_avail(const struct gprs_rlcmac_bts *bts) |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 276 | { |
| 277 | unsigned trx_no; |
| 278 | unsigned ts; |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 279 | |
| 280 | /* Find the first PDCH with an unused DL TS */ |
Pau Espin Pedrol | 0ece97d | 2021-01-18 12:53:54 +0100 | [diff] [blame] | 281 | for (trx_no = 0; trx_no < ARRAY_SIZE(bts->trx); trx_no += 1) { |
| 282 | const struct gprs_rlcmac_trx *trx = &bts->trx[trx_no]; |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 283 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 284 | const struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts]; |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 285 | if (!pdch->is_enabled()) |
| 286 | continue; |
| 287 | |
| 288 | if (pdch->num_tbfs(GPRS_RLCMAC_DL_TBF) > PDCH_IDLE_TBF_THRESH) |
| 289 | continue; |
| 290 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 291 | return true; |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 292 | } |
| 293 | } |
| 294 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 295 | return false; |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 296 | } |
| 297 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 298 | /*! Return free TFI |
| 299 | * |
| 300 | * \param[in] bts Pointer to BTS struct |
Max | 7e4921d | 2017-09-28 16:41:24 +0200 | [diff] [blame] | 301 | * \param[in] trx Optional pointer to TRX struct |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 302 | * \param[in] ms Pointer to MS object |
| 303 | * \param[in] dir DL or UL direction |
| 304 | * \param[in] use_trx which TRX to use or -1 if it should be selected based on what MS uses |
| 305 | * \param[out] trx_no_ TRX number on which TFI was found |
| 306 | * \returns negative error code or 0 on success |
| 307 | */ |
Pau Espin Pedrol | 2182e62 | 2021-01-14 16:48:38 +0100 | [diff] [blame] | 308 | static int tfi_find_free(const struct gprs_rlcmac_bts *bts, const gprs_rlcmac_trx *trx, const GprsMs *ms, |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 309 | enum gprs_rlcmac_tbf_direction dir, int8_t use_trx, uint8_t *trx_no_) |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 310 | { |
| 311 | int tfi; |
| 312 | uint8_t trx_no; |
| 313 | |
Max | 7e4921d | 2017-09-28 16:41:24 +0200 | [diff] [blame] | 314 | if (trx) { |
| 315 | if (use_trx >= 0 && use_trx != trx->trx_no) { |
| 316 | LOGP(DRLCMAC, LOGL_ERROR, "- Requested incompatible TRX %d (current is %d)\n", |
| 317 | use_trx, trx->trx_no); |
| 318 | return -EINVAL; |
| 319 | } |
| 320 | use_trx = trx->trx_no; |
| 321 | } |
| 322 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 323 | if (use_trx == -1 && ms_current_trx(ms)) |
| 324 | use_trx = ms_current_trx(ms)->trx_no; |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 325 | |
Pau Espin Pedrol | 2182e62 | 2021-01-14 16:48:38 +0100 | [diff] [blame] | 326 | tfi = bts_tfi_find_free(bts, dir, &trx_no, use_trx); |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 327 | if (tfi < 0) |
| 328 | return -EBUSY; |
| 329 | |
| 330 | if (trx_no_) |
| 331 | *trx_no_ = trx_no; |
| 332 | |
| 333 | return tfi; |
| 334 | } |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 335 | |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 336 | /*! Slot Allocation: Algorithm A |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 337 | * |
| 338 | * Assign single slot for uplink and downlink |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 339 | * |
| 340 | * \param[in,out] bts Pointer to BTS struct |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 341 | * \param[in,out] tbf Pointer to TBF struct |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 342 | * \param[in] single flag indicating if we should force single-slot allocation |
| 343 | * \param[in] use_trx which TRX to use or -1 if it should be selected during allocation |
| 344 | * \returns negative error code or 0 on success |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 345 | */ |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 346 | int alloc_algorithm_a(struct gprs_rlcmac_bts *bts, struct gprs_rlcmac_tbf *tbf, bool single, |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 347 | int8_t use_trx) |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 348 | { |
| 349 | struct gprs_rlcmac_pdch *pdch; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 350 | int ts = -1; |
Jacob Erlbeck | 5cd496d | 2015-06-30 10:24:37 +0200 | [diff] [blame] | 351 | uint8_t ul_slots, dl_slots; |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 352 | int trx_no; |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 353 | int tfi = -1; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 354 | int usf = -1; |
Max | 731e2bb | 2018-02-05 16:15:30 +0100 | [diff] [blame] | 355 | uint8_t mask = 0xff; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 356 | const char *mask_reason = NULL; |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 357 | struct GprsMs *ms = tbf->ms(); |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 358 | gprs_rlcmac_trx *trx = ms_current_trx(ms); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 359 | |
Pau Espin Pedrol | 8353d97 | 2020-10-23 17:07:10 +0200 | [diff] [blame] | 360 | LOGPAL(tbf, "A", single, use_trx, LOGL_DEBUG, "Alloc start\n"); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 361 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 362 | trx_no = find_trx(bts, ms, use_trx); |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 363 | if (trx_no < 0) { |
Pau Espin Pedrol | a611b4f | 2020-10-23 17:11:00 +0200 | [diff] [blame] | 364 | LOGPAL(tbf, "A", single, use_trx, LOGL_NOTICE, |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 365 | "failed to find a usable TRX (TFI exhausted)\n"); |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 366 | return trx_no; |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 367 | } |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 368 | if (!trx) |
| 369 | trx = &bts->trx[trx_no]; |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 370 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 371 | dl_slots = ms_reserved_dl_slots(ms); |
| 372 | ul_slots = ms_reserved_ul_slots(ms); |
Jacob Erlbeck | 5cd496d | 2015-06-30 10:24:37 +0200 | [diff] [blame] | 373 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 374 | ts = ms_first_common_ts(ms); |
Jacob Erlbeck | 5cd496d | 2015-06-30 10:24:37 +0200 | [diff] [blame] | 375 | |
| 376 | if (ts >= 0) { |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 377 | mask_reason = "need to reuse TS"; |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 378 | mask = 1 << ts; |
Jacob Erlbeck | 5cd496d | 2015-06-30 10:24:37 +0200 | [diff] [blame] | 379 | } else if (dl_slots || ul_slots) { |
| 380 | mask_reason = "need to use a reserved common TS"; |
| 381 | mask = dl_slots & ul_slots; |
| 382 | } |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 383 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 384 | mask = find_possible_pdchs(trx, 1, mask, mask_reason); |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 385 | if (!mask) |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 386 | return -EINVAL; |
| 387 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 388 | ts = find_least_busy_pdch(trx, tbf->direction, mask, |
Jacob Erlbeck | 7af53e6 | 2015-07-16 15:04:07 +0200 | [diff] [blame] | 389 | compute_usage_for_algo_a, |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 390 | &tfi, &usf); |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 391 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 392 | if (tbf->direction == GPRS_RLCMAC_UL_TBF && usf < 0) { |
Pau Espin Pedrol | a611b4f | 2020-10-23 17:11:00 +0200 | [diff] [blame] | 393 | LOGPAL(tbf, "A", single, use_trx, LOGL_NOTICE, |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 394 | "failed to allocate a TS, no USF available\n"); |
Jacob Erlbeck | ec47875 | 2015-06-19 16:35:38 +0200 | [diff] [blame] | 395 | return -EBUSY; |
| 396 | } |
| 397 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 398 | if (ts < 0) { |
Pau Espin Pedrol | a611b4f | 2020-10-23 17:11:00 +0200 | [diff] [blame] | 399 | LOGPAL(tbf, "A", single, use_trx, LOGL_NOTICE, |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 400 | "failed to allocate a TS, no TFI available\n"); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 401 | return -EBUSY; |
| 402 | } |
| 403 | |
| 404 | pdch = &trx->pdch[ts]; |
| 405 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 406 | /* The allocation will be successful, so the system state and tbf/ms |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 407 | * may be modified from now on. */ |
Pau Espin Pedrol | b5fece9 | 2021-08-23 16:58:04 +0200 | [diff] [blame] | 408 | if (tbf->direction == GPRS_RLCMAC_UL_TBF) { |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 409 | struct gprs_rlcmac_ul_tbf *ul_tbf = as_ul_tbf(tbf); |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 410 | LOGPSL(tbf, LOGL_DEBUG, "Assign uplink TS=%d TFI=%d USF=%d\n", ts, tfi, usf); |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 411 | assign_uplink_tbf_usf(pdch, ul_tbf, tfi, usf); |
Pau Espin Pedrol | b5fece9 | 2021-08-23 16:58:04 +0200 | [diff] [blame] | 412 | } else { |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 413 | struct gprs_rlcmac_dl_tbf *dl_tbf = as_dl_tbf(tbf); |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 414 | LOGPSL(tbf, LOGL_DEBUG, "Assign downlink TS=%d TFI=%d\n", ts, tfi); |
Jacob Erlbeck | e0853cd | 2015-07-10 12:25:25 +0200 | [diff] [blame] | 415 | assign_dlink_tbf(pdch, dl_tbf, tfi); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 416 | } |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 417 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 418 | tbf->trx = trx; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 419 | /* the only one TS is the common TS */ |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 420 | tbf->first_ts = tbf->first_common_ts = ts; |
Pau Espin Pedrol | c85e093 | 2021-02-25 18:08:10 +0100 | [diff] [blame] | 421 | ms_set_reserved_slots(ms, trx, 1 << ts, 1 << ts); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 422 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 423 | tbf->upgrade_to_multislot = false; |
Pau Espin Pedrol | 2182e62 | 2021-01-14 16:48:38 +0100 | [diff] [blame] | 424 | bts_do_rate_ctr_inc(bts, CTR_TBF_ALLOC_ALGO_A); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 425 | return 0; |
| 426 | } |
| 427 | |
Max | adca67b | 2018-01-31 15:22:36 +0100 | [diff] [blame] | 428 | /*! Compute capacity of a given TRX |
| 429 | * |
| 430 | * \param[in] trx Pointer to TRX object |
| 431 | * \param[in] rx_window Receive window |
| 432 | * \param[in] tx_window Transmit window |
| 433 | * \returns non-negative capacity |
| 434 | */ |
| 435 | static inline unsigned compute_capacity(const struct gprs_rlcmac_trx *trx, int rx_window, int tx_window) |
| 436 | { |
| 437 | const struct gprs_rlcmac_pdch *pdch; |
| 438 | unsigned ts, capacity = 0; |
| 439 | |
| 440 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
| 441 | pdch = &trx->pdch[ts]; |
| 442 | if (rx_window & (1 << ts)) |
| 443 | capacity += OSMO_MAX(32 - pdch->num_reserved(GPRS_RLCMAC_DL_TBF), 1); |
| 444 | |
| 445 | /* Only consider common slots for UL */ |
| 446 | if (tx_window & rx_window & (1 << ts)) { |
| 447 | if (find_free_usf(pdch->assigned_usf()) >= 0) |
| 448 | capacity += OSMO_MAX(32 - pdch->num_reserved(GPRS_RLCMAC_UL_TBF), 1); |
| 449 | } |
| 450 | } |
| 451 | |
| 452 | return capacity; |
| 453 | } |
| 454 | |
Max | 731e2bb | 2018-02-05 16:15:30 +0100 | [diff] [blame] | 455 | /*! Decide if a given slot should be skipped by multislot allocator |
| 456 | * |
| 457 | * \param[in] ms_class Pointer to MS Class object |
| 458 | * \param[in] check_tr Flag indicating whether we should check for Tra or Tta parameters for a given MS class |
| 459 | * \param[in] rx_window Receive window |
| 460 | * \param[in] tx_window Transmit window |
| 461 | * \param[in,out] checked_rx array with already checked RX timeslots |
| 462 | * \returns true if the slot should be skipped, false otherwise |
| 463 | */ |
| 464 | static bool skip_slot(uint8_t mslot_class, bool check_tr, |
| 465 | int16_t rx_window, int16_t tx_window, |
| 466 | uint32_t *checked_rx) |
| 467 | { |
| 468 | uint8_t common_slot_count, req_common_slots, |
| 469 | rx_slot_count = pcu_bitcount(rx_window), |
| 470 | tx_slot_count = pcu_bitcount(tx_window); |
| 471 | |
| 472 | /* Check compliance with TS 45.002, table 6.4.2.2.1 */ |
| 473 | /* Whether to skip this round doesn not only depend on the bit |
| 474 | * sets but also on check_tr. Therefore this check must be done |
| 475 | * before doing the mslot_test_and_set_bit shortcut. */ |
| 476 | if (mslot_class_get_type(mslot_class) == 1) { |
| 477 | uint16_t slot_sum = rx_slot_count + tx_slot_count; |
| 478 | /* Assume down + up / dynamic. |
| 479 | * TODO: For ext-dynamic, down only, up only add more cases. |
| 480 | */ |
| 481 | if (slot_sum <= 6 && tx_slot_count < 3) { |
| 482 | if (!check_tr) |
| 483 | return true; /* Skip Tta */ |
| 484 | } else if (slot_sum > 6 && tx_slot_count < 3) { |
| 485 | if (check_tr) |
| 486 | return true; /* Skip Tra */ |
| 487 | } else |
| 488 | return true; /* No supported row in TS 45.002, table 6.4.2.2.1. */ |
| 489 | } |
| 490 | |
| 491 | /* Avoid repeated RX combination check */ |
| 492 | if (mslot_test_and_set_bit(checked_rx, rx_window)) |
| 493 | return true; |
| 494 | |
| 495 | /* Check number of common slots according to TS 45.002, §6.4.2.2 */ |
| 496 | common_slot_count = pcu_bitcount(tx_window & rx_window); |
| 497 | req_common_slots = OSMO_MIN(tx_slot_count, rx_slot_count); |
| 498 | if (mslot_class_get_type(mslot_class) == 1) |
| 499 | req_common_slots = OSMO_MIN(req_common_slots, 2); |
| 500 | |
| 501 | if (req_common_slots != common_slot_count) |
| 502 | return true; |
| 503 | |
| 504 | return false; |
| 505 | } |
| 506 | |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 507 | /*! Find set of slots available for allocation while taking MS class into account |
| 508 | * |
| 509 | * \param[in] trx Pointer to TRX object |
| 510 | * \param[in] mslot_class The multislot class |
| 511 | * \param[in,out] ul_slots set of UL timeslots |
| 512 | * \param[in,out] dl_slots set of DL timeslots |
| 513 | * \returns negative error code or 0 on success |
| 514 | */ |
Max | 46fbfce | 2017-11-01 19:22:25 +0100 | [diff] [blame] | 515 | int find_multi_slots(struct gprs_rlcmac_trx *trx, uint8_t mslot_class, uint8_t *ul_slots, uint8_t *dl_slots) |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 516 | { |
Pau Espin Pedrol | 10475f5 | 2021-02-19 17:33:21 +0100 | [diff] [blame] | 517 | const uint8_t Rx = mslot_class_get_rx(mslot_class), /* Max number of Rx slots */ |
| 518 | Tx = mslot_class_get_tx(mslot_class), /* Max number of Tx slots */ |
Pau Espin Pedrol | 4df2658 | 2021-02-19 17:35:11 +0100 | [diff] [blame] | 519 | Sum = mslot_class_get_sum(mslot_class), /* Max number of Tx + Rx slots */ |
| 520 | Type = mslot_class_get_type(mslot_class); |
Pau Espin Pedrol | 10475f5 | 2021-02-19 17:33:21 +0100 | [diff] [blame] | 521 | uint8_t max_slots, num_rx, num_tx, mask_sel, pdch_slots, ul_ts, dl_ts; |
Max | 731e2bb | 2018-02-05 16:15:30 +0100 | [diff] [blame] | 522 | int16_t rx_window, tx_window; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 523 | char slot_info[9] = {0}; |
Max | f633b8d | 2018-01-31 15:28:53 +0100 | [diff] [blame] | 524 | int max_capacity = -1; |
| 525 | uint8_t max_ul_slots = 0, max_dl_slots = 0; |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 526 | |
Max | 842d781 | 2017-11-01 18:11:24 +0100 | [diff] [blame] | 527 | if (mslot_class) |
| 528 | LOGP(DRLCMAC, LOGL_DEBUG, "Slot Allocation (Algorithm B) for class %d\n", |
| 529 | mslot_class); |
| 530 | |
Max | 842d781 | 2017-11-01 18:11:24 +0100 | [diff] [blame] | 531 | if (Tx == MS_NA) { |
| 532 | LOGP(DRLCMAC, LOGL_NOTICE, "Multislot class %d not applicable.\n", |
| 533 | mslot_class); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 534 | return -EINVAL; |
| 535 | } |
| 536 | |
Pau Espin Pedrol | dfbf3d2 | 2021-02-19 17:31:24 +0100 | [diff] [blame] | 537 | max_slots = OSMO_MAX(Rx, Tx); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 538 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 539 | if (*dl_slots == 0) |
| 540 | *dl_slots = 0xff; |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 541 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 542 | if (*ul_slots == 0) |
| 543 | *ul_slots = 0xff; |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 544 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 545 | pdch_slots = find_possible_pdchs(trx, max_slots, 0xff); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 546 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 547 | *dl_slots &= pdch_slots; |
| 548 | *ul_slots &= pdch_slots; |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 549 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 550 | LOGP(DRLCMAC, LOGL_DEBUG, "- Possible DL/UL slots: (TS=0)\"%s\"(TS=7)\n", |
| 551 | set_flag_chars(set_flag_chars(set_flag_chars(slot_info, |
| 552 | *dl_slots, 'D', '.'), |
| 553 | *ul_slots, 'U'), |
| 554 | *ul_slots & *dl_slots, 'C')); |
| 555 | |
| 556 | /* Check for each UL (TX) slot */ |
| 557 | |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 558 | /* Iterate through possible numbers of TX slots */ |
Pau Espin Pedrol | 47a3b78 | 2021-02-19 16:56:36 +0100 | [diff] [blame] | 559 | for (num_tx = 1; num_tx <= Tx; num_tx += 1) { |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 560 | uint16_t tx_valid_win = (1 << num_tx) - 1; |
Max | f633b8d | 2018-01-31 15:28:53 +0100 | [diff] [blame] | 561 | uint8_t rx_mask[MASK_TR + 1]; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 562 | |
Max | f633b8d | 2018-01-31 15:28:53 +0100 | [diff] [blame] | 563 | mslot_fill_rx_mask(mslot_class, num_tx, rx_mask); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 564 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 565 | /* Rotate group of TX slots: UUU-----, -UUU----, ..., UU-----U */ |
| 566 | for (ul_ts = 0; ul_ts < 8; ul_ts += 1, tx_valid_win <<= 1) { |
| 567 | uint16_t rx_valid_win; |
| 568 | uint32_t checked_rx[256/32] = {0}; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 569 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 570 | /* Wrap valid window */ |
| 571 | tx_valid_win = mslot_wrap_window(tx_valid_win); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 572 | |
Alexander Couzens | 695ce77 | 2021-01-12 19:33:53 +0100 | [diff] [blame] | 573 | /* for multislot type 1: don't split the window to wrap around. |
| 574 | * E.g. 'UU-----U' is invalid for a 4 TN window. Except 8 TN window. |
| 575 | * See 45.002 B.1 */ |
Pau Espin Pedrol | 4df2658 | 2021-02-19 17:35:11 +0100 | [diff] [blame] | 576 | if (Type == 1 && num_tx < 8 && |
Alexander Couzens | 695ce77 | 2021-01-12 19:33:53 +0100 | [diff] [blame] | 577 | tx_valid_win & (1 << 0) && tx_valid_win & (1 << 7)) |
| 578 | continue; |
| 579 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 580 | tx_window = tx_valid_win; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 581 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 582 | /* Filter out unavailable slots */ |
| 583 | tx_window &= *ul_slots; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 584 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 585 | /* Skip if the the first TS (ul_ts) is not in the set */ |
| 586 | if ((tx_window & (1 << ul_ts)) == 0) |
| 587 | continue; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 588 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 589 | /* Skip if the the last TS (ul_ts+num_tx-1) is not in the set */ |
| 590 | if ((tx_window & (1 << ((ul_ts+num_tx-1) % 8))) == 0) |
| 591 | continue; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 592 | |
Pau Espin Pedrol | dfbf3d2 | 2021-02-19 17:31:24 +0100 | [diff] [blame] | 593 | num_rx = OSMO_MIN(Rx, Sum - num_tx); |
Alexander Couzens | 695ce77 | 2021-01-12 19:33:53 +0100 | [diff] [blame] | 594 | rx_valid_win = (1 << num_rx) - 1; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 595 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 596 | /* Rotate group of RX slots: DDD-----, -DDD----, ..., DD-----D */ |
| 597 | for (dl_ts = 0; dl_ts < 8; dl_ts += 1, rx_valid_win <<= 1) { |
| 598 | /* Wrap valid window */ |
| 599 | rx_valid_win = (rx_valid_win | rx_valid_win >> 8) & 0xff; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 600 | |
Alexander Couzens | 695ce77 | 2021-01-12 19:33:53 +0100 | [diff] [blame] | 601 | /* for multislot type 1: don't split the window to wrap around. |
| 602 | * E.g. 'DD-----D' is invalid for a 4 TN window. Except 8 TN window. |
| 603 | * See 45.002 B.1 */ |
Pau Espin Pedrol | 4df2658 | 2021-02-19 17:35:11 +0100 | [diff] [blame] | 604 | if (Type == 1 && num_rx < 8 && |
Alexander Couzens | 695ce77 | 2021-01-12 19:33:53 +0100 | [diff] [blame] | 605 | (rx_valid_win & (1 << 0)) && (rx_valid_win & (1 << 7))) |
| 606 | continue; |
| 607 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 608 | /* Validate with both Tta/Ttb/Trb and Ttb/Tra/Trb */ |
| 609 | for (mask_sel = MASK_TT; mask_sel <= MASK_TR; mask_sel += 1) { |
| 610 | int capacity; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 611 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 612 | rx_window = mslot_filter_bad(rx_mask[mask_sel], ul_ts, *dl_slots, rx_valid_win); |
| 613 | if (rx_window < 0) |
| 614 | continue; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 615 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 616 | if (skip_slot(mslot_class, mask_sel != MASK_TT, rx_window, tx_window, checked_rx)) |
| 617 | continue; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 618 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 619 | /* Compute capacity */ |
| 620 | capacity = compute_capacity(trx, rx_window, tx_window); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 621 | |
Jacob Erlbeck | 1653f83 | 2015-06-30 14:48:13 +0200 | [diff] [blame] | 622 | #ifdef ENABLE_TS_ALLOC_DEBUG |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 623 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 624 | "- Considering DL/UL slots: (TS=0)\"%s\"(TS=7), " |
| 625 | "capacity = %d\n", |
| 626 | set_flag_chars(set_flag_chars(set_flag_chars(set_flag_chars( |
| 627 | slot_info, |
| 628 | rx_bad, 'x', '.'), |
| 629 | rx_window, 'D'), |
| 630 | tx_window, 'U'), |
| 631 | rx_window & tx_window, 'C'), |
| 632 | capacity); |
Jacob Erlbeck | 1653f83 | 2015-06-30 14:48:13 +0200 | [diff] [blame] | 633 | #endif |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 634 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 635 | if (capacity <= max_capacity) |
| 636 | continue; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 637 | |
Pau Espin Pedrol | 5d2d2ec | 2020-09-22 18:03:56 +0200 | [diff] [blame] | 638 | max_capacity = capacity; |
| 639 | max_ul_slots = tx_window; |
| 640 | max_dl_slots = rx_window; |
| 641 | } |
| 642 | } |
| 643 | } |
Max | adca67b | 2018-01-31 15:22:36 +0100 | [diff] [blame] | 644 | } |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 645 | |
| 646 | if (!max_ul_slots || !max_dl_slots) { |
| 647 | LOGP(DRLCMAC, LOGL_NOTICE, |
| 648 | "No valid UL/DL slot combination found\n"); |
Pau Espin Pedrol | 9688dc9 | 2021-02-25 18:30:33 +0100 | [diff] [blame] | 649 | bts_do_rate_ctr_inc(trx->bts, CTR_TBF_ALLOC_FAIL_NO_SLOT_COMBI); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 650 | return -EINVAL; |
| 651 | } |
| 652 | |
| 653 | *ul_slots = max_ul_slots; |
| 654 | *dl_slots = max_dl_slots; |
| 655 | |
| 656 | return 0; |
| 657 | } |
| 658 | |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 659 | /*! Count used bits in slots and reserved_slots bitmasks |
| 660 | * |
| 661 | * \param[in] slots Timeslots in use |
| 662 | * \param[in] reserved_slots Reserved timeslots |
| 663 | * \param[out] slotcount Number of TS in use |
| 664 | * \param[out] avail_count Number of reserved TS |
| 665 | */ |
| 666 | static void update_slot_counters(uint8_t slots, uint8_t reserved_slots, uint8_t *slotcount, uint8_t *avail_count) |
| 667 | { |
| 668 | (*slotcount) = pcu_bitcount(slots); |
| 669 | (*avail_count) = pcu_bitcount(reserved_slots); |
| 670 | } |
| 671 | |
| 672 | /*! Return slot mask with single TS from a given UL/DL set according to TBF's direction, ts pointer is set to that TS |
| 673 | * number or to negative value on error |
| 674 | * |
| 675 | * \param[in] trx Pointer to TRX object |
| 676 | * \param[in] tbf Pointer to TBF object |
| 677 | * \param[in] dl_slots set of DL timeslots |
| 678 | * \param[in] ul_slots set of UL timeslots |
| 679 | * \param[in] ts corresponding TS or -1 for autoselection |
| 680 | * \returns slot mask with single UL or DL timeslot number if possible |
| 681 | */ |
| 682 | static uint8_t get_single_ts(const gprs_rlcmac_trx *trx, const gprs_rlcmac_tbf *tbf, uint8_t dl_slots, uint8_t ul_slots, |
| 683 | int ts) |
| 684 | { |
| 685 | uint8_t ret = dl_slots & ul_slots; /* Make sure to consider the first common slot only */ |
| 686 | |
| 687 | if (ts < 0) |
| 688 | ts = find_least_busy_pdch(trx, tbf->direction, ret, compute_usage_by_num_tbfs, NULL, NULL); |
| 689 | |
| 690 | if (ts < 0) |
| 691 | return ffs(ret); |
| 692 | |
| 693 | return ret & (1 << ts); |
| 694 | } |
| 695 | |
| 696 | /*! Find set of timeslots available for allocation |
| 697 | * |
| 698 | * \param[in] trx Pointer to TRX object |
| 699 | * \param[in] tbf Pointer to TBF object |
| 700 | * \param[in] single Flag to force the single TS allocation |
| 701 | * \param[in] ul_slots set of UL timeslots |
| 702 | * \param[in] dl_slots set of DL timeslots |
| 703 | * \param[in] reserved_ul_slots set of reserved UL timeslots |
| 704 | * \param[in] reserved_dl_slots set of reserved DL timeslots |
| 705 | * \param[in] first_common_ts First TS common for both UL and DL or -1 if unknown |
| 706 | * \returns negative error code or selected TS on success |
| 707 | */ |
| 708 | static int tbf_select_slot_set(const gprs_rlcmac_tbf *tbf, const gprs_rlcmac_trx *trx, bool single, |
| 709 | uint8_t ul_slots, uint8_t dl_slots, |
| 710 | uint8_t reserved_ul_slots, uint8_t reserved_dl_slots, |
| 711 | int8_t first_common_ts) |
| 712 | { |
Pau Espin Pedrol | 393484a | 2021-05-10 11:21:50 +0200 | [diff] [blame] | 713 | bool is_ul = tbf->direction == GPRS_RLCMAC_UL_TBF; |
| 714 | uint8_t sl = is_ul ? ul_slots : dl_slots; |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 715 | char slot_info[9] = { 0 }; |
| 716 | |
| 717 | if (single) |
| 718 | sl = get_single_ts(trx, tbf, dl_slots, ul_slots, first_common_ts); |
| 719 | |
| 720 | if (!sl) { |
| 721 | LOGP(DRLCMAC, LOGL_NOTICE, "No %s slots available\n", |
Pau Espin Pedrol | 393484a | 2021-05-10 11:21:50 +0200 | [diff] [blame] | 722 | is_ul ? "uplink" : "downlink"); |
Pau Espin Pedrol | 9688dc9 | 2021-02-25 18:30:33 +0100 | [diff] [blame] | 723 | bts_do_rate_ctr_inc(trx->bts, CTR_TBF_ALLOC_FAIL_NO_SLOT_AVAIL); |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 724 | return -EINVAL; |
| 725 | } |
| 726 | |
Pau Espin Pedrol | 393484a | 2021-05-10 11:21:50 +0200 | [diff] [blame] | 727 | if (is_ul) { |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 728 | snprintf(slot_info, 9, OSMO_BIT_SPEC, OSMO_BIT_PRINT_EX(reserved_ul_slots, 'u')); |
| 729 | masked_override_with(slot_info, sl, 'U'); |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 730 | } else { |
| 731 | snprintf(slot_info, 9, OSMO_BIT_SPEC, OSMO_BIT_PRINT_EX(reserved_dl_slots, 'd')); |
| 732 | masked_override_with(slot_info, sl, 'D'); |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 733 | } |
| 734 | |
Pau Espin Pedrol | 393484a | 2021-05-10 11:21:50 +0200 | [diff] [blame] | 735 | LOGPC(DRLCMAC, LOGL_DEBUG, "Selected %s slots: (TS=0)\"%s\"(TS=7), %s\n", |
| 736 | is_ul ? "UL" : "DL", |
| 737 | slot_info, single ? "single" : "multi"); |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 738 | |
| 739 | return sl; |
| 740 | } |
| 741 | |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 742 | /*! Allocate USF according to a given UL TS mapping |
| 743 | * |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 744 | * \param[in] trx Pointer to TRX object |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 745 | * \param[in] selected_ul_slots set of UL timeslots selected for allocation |
| 746 | * \param[in] dl_slots set of DL timeslots |
| 747 | * \param[out] usf array for allocated USF |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 748 | * \returns updated UL TS mask or negative on error |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 749 | */ |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 750 | static int allocate_usf(const gprs_rlcmac_trx *trx, uint8_t selected_ul_slots, uint8_t dl_slots, |
| 751 | int *usf_list) |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 752 | { |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 753 | uint8_t ul_slots = selected_ul_slots & dl_slots; |
| 754 | unsigned int ts; |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 755 | |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 756 | for (ts = 0; ts < ARRAY_SIZE(trx->pdch); ts++) { |
| 757 | const struct gprs_rlcmac_pdch *pdch = &trx->pdch[ts]; |
| 758 | int8_t free_usf; |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 759 | |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 760 | if (((1 << ts) & ul_slots) == 0) |
| 761 | continue; |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 762 | |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 763 | free_usf = find_free_usf(pdch->assigned_usf()); |
| 764 | if (free_usf < 0) { |
| 765 | LOGP(DRLCMAC, LOGL_DEBUG, |
| 766 | "- Skipping TS %d, because " |
| 767 | "no USF available\n", ts); |
| 768 | ul_slots &= (~(1 << ts)) & 0xff; |
| 769 | continue; |
| 770 | } |
| 771 | usf_list[ts] = free_usf; |
| 772 | } |
| 773 | |
| 774 | if (!ul_slots) { |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 775 | LOGP(DRLCMAC, LOGL_NOTICE, "No USF available\n"); |
Pau Espin Pedrol | 9688dc9 | 2021-02-25 18:30:33 +0100 | [diff] [blame] | 776 | bts_do_rate_ctr_inc(trx->bts, CTR_TBF_ALLOC_FAIL_NO_USF); |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 777 | return -EBUSY; |
| 778 | } |
| 779 | |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 780 | return ul_slots; |
| 781 | } |
| 782 | |
Max | 77988d4 | 2018-02-19 18:00:38 +0100 | [diff] [blame] | 783 | /*! Update MS' reserved timeslots |
| 784 | * |
| 785 | * \param[in,out] trx Pointer to TRX struct |
| 786 | * \param[in,out] ms_ Pointer to MS object |
| 787 | * \param[in] tbf_ Pointer to TBF struct |
| 788 | * \param[in] res_ul_slots Newly reserved UL slots |
| 789 | * \param[in] res_dl_slots Newly reserved DL slots |
| 790 | * \param[in] ul_slots available UL slots (for logging only) |
| 791 | * \param[in] dl_slots available DL slots (for logging only) |
| 792 | */ |
| 793 | static void update_ms_reserved_slots(gprs_rlcmac_trx *trx, GprsMs *ms, uint8_t res_ul_slots, uint8_t res_dl_slots, |
| 794 | uint8_t ul_slots, uint8_t dl_slots) |
| 795 | { |
| 796 | char slot_info[9] = { 0 }; |
| 797 | |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 798 | if (res_ul_slots == ms_reserved_ul_slots(ms) && res_dl_slots == ms_reserved_dl_slots(ms)) |
Max | 77988d4 | 2018-02-19 18:00:38 +0100 | [diff] [blame] | 799 | return; |
| 800 | |
| 801 | /* The reserved slots have changed, update the MS */ |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 802 | ms_set_reserved_slots(ms, trx, res_ul_slots, res_dl_slots); |
Max | 77988d4 | 2018-02-19 18:00:38 +0100 | [diff] [blame] | 803 | |
| 804 | ts_format(slot_info, dl_slots, ul_slots); |
| 805 | LOGP(DRLCMAC, LOGL_DEBUG, "- Reserved DL/UL slots: (TS=0)\"%s\"(TS=7)\n", slot_info); |
| 806 | } |
| 807 | |
| 808 | /*! Assign given UL timeslots to UL TBF |
| 809 | * |
| 810 | * \param[in,out] ul_tbf Pointer to UL TBF struct |
| 811 | * \param[in,out] trx Pointer to TRX object |
| 812 | * \param[in] ul_slots Set of slots to be assigned |
| 813 | * \param[in] tfi selected TFI |
| 814 | * \param[in] usf selected USF |
| 815 | */ |
| 816 | static void assign_ul_tbf_slots(struct gprs_rlcmac_ul_tbf *ul_tbf, gprs_rlcmac_trx *trx, uint8_t ul_slots, int tfi, |
| 817 | int *usf) |
| 818 | { |
| 819 | uint8_t ts; |
| 820 | |
| 821 | for (ts = 0; ts < 8; ts++) { |
| 822 | if (!(ul_slots & (1 << ts))) |
| 823 | continue; |
| 824 | |
| 825 | OSMO_ASSERT(usf[ts] >= 0); |
| 826 | |
| 827 | LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning UL TS %u\n", ts); |
| 828 | assign_uplink_tbf_usf(&trx->pdch[ts], ul_tbf, tfi, usf[ts]); |
| 829 | } |
| 830 | } |
| 831 | |
| 832 | /*! Assign given DL timeslots to DL TBF |
| 833 | * |
| 834 | * \param[in,out] dl_tbf Pointer to DL TBF struct |
| 835 | * \param[in,out] trx Pointer to TRX object |
| 836 | * \param[in] ul_slots Set of slots to be assigned |
| 837 | * \param[in] tfi selected TFI |
| 838 | */ |
| 839 | static void assign_dl_tbf_slots(struct gprs_rlcmac_dl_tbf *dl_tbf, gprs_rlcmac_trx *trx, uint8_t dl_slots, int tfi) |
| 840 | { |
| 841 | uint8_t ts; |
| 842 | |
| 843 | for (ts = 0; ts < 8; ts++) { |
| 844 | if (!(dl_slots & (1 << ts))) |
| 845 | continue; |
| 846 | |
| 847 | LOGP(DRLCMAC, LOGL_DEBUG, "- Assigning DL TS %u\n", ts); |
| 848 | assign_dlink_tbf(&trx->pdch[ts], dl_tbf, tfi); |
| 849 | } |
| 850 | } |
| 851 | |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 852 | /*! Slot Allocation: Algorithm B |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 853 | * |
| 854 | * Assign as many downlink slots as possible. |
| 855 | * Assign one uplink slot. (With free USF) |
| 856 | * |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 857 | * \param[in,out] bts Pointer to BTS struct |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 858 | * \param[in,out] tbf Pointer to TBF struct |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 859 | * \param[in] single flag indicating if we should force single-slot allocation |
| 860 | * \param[in] use_trx which TRX to use or -1 if it should be selected during allocation |
| 861 | * \returns negative error code or 0 on success |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 862 | */ |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 863 | int alloc_algorithm_b(struct gprs_rlcmac_bts *bts, struct gprs_rlcmac_tbf *tbf, bool single, |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 864 | int8_t use_trx) |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 865 | { |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 866 | uint8_t dl_slots; |
| 867 | uint8_t ul_slots; |
| 868 | uint8_t reserved_dl_slots; |
| 869 | uint8_t reserved_ul_slots; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 870 | int8_t first_common_ts; |
| 871 | uint8_t slotcount = 0; |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 872 | uint8_t avail_count = 0, trx_no; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 873 | int first_ts = -1; |
| 874 | int usf[8] = {-1, -1, -1, -1, -1, -1, -1, -1}; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 875 | int rc; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 876 | int tfi; |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 877 | struct GprsMs *ms = tbf->ms(); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 878 | gprs_rlcmac_trx *trx; |
Jacob Erlbeck | 5879c64 | 2015-07-10 10:41:36 +0200 | [diff] [blame] | 879 | |
Pau Espin Pedrol | 8353d97 | 2020-10-23 17:07:10 +0200 | [diff] [blame] | 880 | LOGPAL(tbf, "B", single, use_trx, LOGL_DEBUG, "Alloc start\n"); |
| 881 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 882 | /* Step 1: Get current state from the MS object */ |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 883 | |
Pau Espin Pedrol | 50272a4 | 2021-05-10 12:25:20 +0200 | [diff] [blame] | 884 | reserved_dl_slots = ms_reserved_dl_slots(ms); |
| 885 | reserved_ul_slots = ms_reserved_ul_slots(ms); |
Pau Espin Pedrol | da971ee | 2020-12-16 15:59:45 +0100 | [diff] [blame] | 886 | first_common_ts = ms_first_common_ts(ms); |
| 887 | trx = ms_current_trx(ms); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 888 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 889 | /* Step 2a: Find usable TRX and TFI */ |
Pau Espin Pedrol | 2182e62 | 2021-01-14 16:48:38 +0100 | [diff] [blame] | 890 | tfi = tfi_find_free(bts, trx, ms, tbf->direction, use_trx, &trx_no); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 891 | if (tfi < 0) { |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 892 | LOGPAL(tbf, "B", single, use_trx, LOGL_NOTICE, "failed to allocate a TFI\n"); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 893 | return tfi; |
| 894 | } |
| 895 | |
| 896 | /* Step 2b: Reserve slots on the TRX for the MS */ |
| 897 | if (!trx) |
| 898 | trx = &bts->trx[trx_no]; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 899 | |
Pau Espin Pedrol | 50272a4 | 2021-05-10 12:25:20 +0200 | [diff] [blame] | 900 | if (!reserved_dl_slots || !reserved_ul_slots) { |
| 901 | rc = find_multi_slots(trx, ms_ms_class(ms), &reserved_ul_slots, &reserved_dl_slots); |
Holger Hans Peter Freyther | 7319311 | 2013-12-26 09:49:05 +0100 | [diff] [blame] | 902 | if (rc < 0) |
| 903 | return rc; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 904 | } |
Pau Espin Pedrol | 50272a4 | 2021-05-10 12:25:20 +0200 | [diff] [blame] | 905 | dl_slots = reserved_dl_slots; |
| 906 | ul_slots = reserved_ul_slots; |
Max | 92e9c17 | 2017-09-28 16:25:25 +0200 | [diff] [blame] | 907 | |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 908 | /* Step 3a: Derive the slot set for the current TBF */ |
| 909 | rc = tbf_select_slot_set(tbf, trx, single, ul_slots, dl_slots, reserved_ul_slots, reserved_dl_slots, |
| 910 | first_common_ts); |
| 911 | if (rc < 0) |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 912 | return -EINVAL; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 913 | |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 914 | /* Step 3b: Derive the slot set for a given direction */ |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 915 | if (tbf->direction == GPRS_RLCMAC_DL_TBF) { |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 916 | dl_slots = rc; |
| 917 | update_slot_counters(dl_slots, reserved_dl_slots, &slotcount, &avail_count); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 918 | } else { |
Pau Espin Pedrol | ed2afa3 | 2021-02-22 17:20:15 +0100 | [diff] [blame] | 919 | rc = allocate_usf(trx, rc, dl_slots, usf); |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 920 | if (rc < 0) |
| 921 | return rc; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 922 | |
Max | 2afec6d | 2018-01-31 17:21:21 +0100 | [diff] [blame] | 923 | ul_slots = rc; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 924 | reserved_ul_slots = ul_slots; |
Jacob Erlbeck | 5f494b8 | 2015-07-01 13:10:41 +0200 | [diff] [blame] | 925 | |
Max | 0cc7212 | 2018-01-31 17:00:06 +0100 | [diff] [blame] | 926 | update_slot_counters(ul_slots, reserved_ul_slots, &slotcount, &avail_count); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 927 | } |
| 928 | |
Pau Espin Pedrol | 84abd2f | 2020-09-22 20:08:18 +0200 | [diff] [blame] | 929 | first_ts = ffs(rc) - 1; |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 930 | first_common_ts = ffs(dl_slots & ul_slots) - 1; |
| 931 | |
| 932 | if (first_common_ts < 0) { |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 933 | LOGPAL(tbf, "B", single, use_trx, LOGL_NOTICE, "first common slot unavailable\n"); |
Jacob Erlbeck | ea65c72 | 2015-06-22 16:14:23 +0200 | [diff] [blame] | 934 | return -EINVAL; |
| 935 | } |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 936 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 937 | if (first_ts < 0) { |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 938 | LOGPAL(tbf, "B", single, use_trx, LOGL_NOTICE, "first slot unavailable\n"); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 939 | return -EINVAL; |
| 940 | } |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 941 | |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 942 | if (single && slotcount) { |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 943 | tbf->upgrade_to_multislot = (avail_count > slotcount); |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 944 | LOGPAL(tbf, "B", single, use_trx, LOGL_INFO, "using single slot at TS %d\n", first_ts); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 945 | } else { |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 946 | tbf->upgrade_to_multislot = false; |
Max | 0e6ac79 | 2018-02-19 18:43:01 +0100 | [diff] [blame] | 947 | LOGPAL(tbf, "B", single, use_trx, LOGL_INFO, "using %d slots\n", slotcount); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 948 | } |
| 949 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 950 | /* The allocation will be successful, so the system state and tbf/ms |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 951 | * may be modified from now on. */ |
| 952 | |
| 953 | /* Step 4: Update MS and TBF and really allocate the resources */ |
| 954 | |
Pau Espin Pedrol | c85e093 | 2021-02-25 18:08:10 +0100 | [diff] [blame] | 955 | update_ms_reserved_slots(trx, ms, reserved_ul_slots, reserved_dl_slots, ul_slots, dl_slots); |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 956 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 957 | tbf->trx = trx; |
| 958 | tbf->first_common_ts = first_common_ts; |
| 959 | tbf->first_ts = first_ts; |
Jacob Erlbeck | 5a2b8be | 2015-07-14 11:35:21 +0200 | [diff] [blame] | 960 | |
Pau Espin Pedrol | b5fece9 | 2021-08-23 16:58:04 +0200 | [diff] [blame] | 961 | if (tbf->direction == GPRS_RLCMAC_DL_TBF) |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 962 | assign_dl_tbf_slots(as_dl_tbf(tbf), trx, dl_slots, tfi); |
Pau Espin Pedrol | b5fece9 | 2021-08-23 16:58:04 +0200 | [diff] [blame] | 963 | else |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 964 | assign_ul_tbf_slots(as_ul_tbf(tbf), trx, ul_slots, tfi, usf); |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 965 | |
Pau Espin Pedrol | 2182e62 | 2021-01-14 16:48:38 +0100 | [diff] [blame] | 966 | bts_do_rate_ctr_inc(bts, CTR_TBF_ALLOC_ALGO_B); |
Jacob Erlbeck | 5979fe9 | 2015-07-14 14:02:41 +0200 | [diff] [blame] | 967 | |
Holger Hans Peter Freyther | 02ab4a8 | 2013-09-29 07:37:40 +0200 | [diff] [blame] | 968 | return 0; |
| 969 | } |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 970 | |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 971 | /*! Slot Allocation: Algorithm dynamic |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 972 | * |
| 973 | * This meta algorithm automatically selects on of the other algorithms based |
| 974 | * on the current system state. |
| 975 | * |
| 976 | * The goal is to support as many MS and TBF as possible. On low usage, the |
| 977 | * goal is to provide the highest possible bandwidth per MS. |
| 978 | * |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 979 | * \param[in,out] bts Pointer to BTS struct |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 980 | * \param[in,out] tbf Pointer to TBF struct |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 981 | * \param[in] single flag indicating if we should force single-slot allocation |
| 982 | * \param[in] use_trx which TRX to use or -1 if it should be selected during allocation |
| 983 | * \returns negative error code or 0 on success |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 984 | */ |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 985 | int alloc_algorithm_dynamic(struct gprs_rlcmac_bts *bts, struct gprs_rlcmac_tbf *tbf, bool single, |
Max | e9fe0e3 | 2017-09-28 15:56:05 +0200 | [diff] [blame] | 986 | int8_t use_trx) |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 987 | { |
| 988 | int rc; |
| 989 | |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 990 | /* Reset load_is_high if there is at least one idle PDCH */ |
| 991 | if (bts->multislot_disabled) { |
Max | a76a7d0 | 2018-01-26 11:09:16 +0100 | [diff] [blame] | 992 | bts->multislot_disabled = !idle_pdch_avail(bts); |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 993 | if (!bts->multislot_disabled) |
| 994 | LOGP(DRLCMAC, LOGL_DEBUG, "Enabling algorithm B\n"); |
| 995 | } |
| 996 | |
| 997 | if (!bts->multislot_disabled) { |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 998 | rc = alloc_algorithm_b(bts, tbf, single, use_trx); |
Jacob Erlbeck | 77da355 | 2015-07-16 18:33:46 +0200 | [diff] [blame] | 999 | if (rc >= 0) |
| 1000 | return rc; |
| 1001 | |
| 1002 | if (!bts->multislot_disabled) |
| 1003 | LOGP(DRLCMAC, LOGL_DEBUG, "Disabling algorithm B\n"); |
| 1004 | bts->multislot_disabled = 1; |
| 1005 | } |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 1006 | |
Pau Espin Pedrol | 77e2ff3 | 2021-10-18 14:00:24 +0200 | [diff] [blame] | 1007 | return alloc_algorithm_a(bts, tbf, single, use_trx); |
Jacob Erlbeck | 400ec02 | 2015-07-14 13:31:48 +0200 | [diff] [blame] | 1008 | } |
Jacob Erlbeck | 7f79f0d | 2015-07-17 11:38:49 +0200 | [diff] [blame] | 1009 | |
Max | 4da3859 | 2018-01-31 18:03:49 +0100 | [diff] [blame] | 1010 | int gprs_alloc_max_dl_slots_per_ms(const struct gprs_rlcmac_bts *bts, uint8_t ms_class) |
Jacob Erlbeck | 7f79f0d | 2015-07-17 11:38:49 +0200 | [diff] [blame] | 1011 | { |
Max | 842d781 | 2017-11-01 18:11:24 +0100 | [diff] [blame] | 1012 | int rx = mslot_class_get_rx(ms_class); |
Jacob Erlbeck | 7f79f0d | 2015-07-17 11:38:49 +0200 | [diff] [blame] | 1013 | |
| 1014 | if (rx == MS_NA) |
| 1015 | rx = 4; |
| 1016 | |
Pau Espin Pedrol | ac3fd12 | 2021-01-13 18:54:38 +0100 | [diff] [blame] | 1017 | if (the_pcu->alloc_algorithm == alloc_algorithm_a) |
Jacob Erlbeck | 7f79f0d | 2015-07-17 11:38:49 +0200 | [diff] [blame] | 1018 | return 1; |
| 1019 | |
| 1020 | if (bts->multislot_disabled) |
| 1021 | return 1; |
| 1022 | |
| 1023 | return rx; |
| 1024 | } |