Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 1 | /* GSM Channel allocation routines |
| 2 | * |
| 3 | * (C) 2008 by Harald Welte <laforge@gnumonks.org> |
| 4 | * (C) 2008, 2009 by Holger Hans Peter Freyther <zecke@selfish.org> |
| 5 | * |
| 6 | * All Rights Reserved |
| 7 | * |
| 8 | * This program is free software; you can redistribute it and/or modify |
Harald Welte | 0e3e88e | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 9 | * it under the terms of the GNU Affero General Public License as published by |
| 10 | * the Free Software Foundation; either version 3 of the License, or |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 11 | * (at your option) any later version. |
| 12 | * |
| 13 | * This program is distributed in the hope that it will be useful, |
| 14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
Harald Welte | 0e3e88e | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 16 | * GNU Affero General Public License for more details. |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 17 | * |
Harald Welte | 0e3e88e | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 18 | * You should have received a copy of the GNU Affero General Public License |
| 19 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 20 | * |
| 21 | */ |
| 22 | |
| 23 | #include <stdio.h> |
| 24 | #include <stdlib.h> |
| 25 | #include <string.h> |
| 26 | #include <errno.h> |
| 27 | |
Holger Hans Peter Freyther | d300106 | 2010-12-22 18:13:00 +0100 | [diff] [blame] | 28 | #include <openbsc/gsm_subscriber.h> |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 29 | #include <openbsc/chan_alloc.h> |
| 30 | #include <openbsc/abis_nm.h> |
| 31 | #include <openbsc/abis_rsl.h> |
| 32 | #include <openbsc/debug.h> |
Holger Hans Peter Freyther | 00452c4 | 2012-01-17 15:27:33 +0100 | [diff] [blame] | 33 | #include <openbsc/rtp_proxy.h> |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 34 | #include <openbsc/signal.h> |
| 35 | |
Pablo Neira Ayuso | dd5fff4 | 2011-03-22 16:47:59 +0100 | [diff] [blame] | 36 | #include <osmocom/core/talloc.h> |
Holger Hans Peter Freyther | c08f6f0 | 2010-06-22 12:11:59 +0800 | [diff] [blame] | 37 | |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 38 | static int ts_is_usable(struct gsm_bts_trx_ts *ts) |
| 39 | { |
| 40 | /* FIXME: How does this behave for BS-11 ? */ |
| 41 | if (is_ipaccess_bts(ts->trx->bts)) { |
Harald Welte | 69f6f81 | 2011-05-30 12:07:53 +0200 | [diff] [blame] | 42 | if (!nm_is_running(&ts->mo.nm_state)) |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 43 | return 0; |
| 44 | } |
| 45 | |
Neels Hofmeyr | b3985cf | 2016-07-14 02:51:13 +0200 | [diff] [blame] | 46 | /* If a TCH/F_PDCH TS is busy changing, it is already taken or not |
Neels Hofmeyr | 10b0f1d | 2016-06-14 13:12:00 +0200 | [diff] [blame] | 47 | * yet available. */ |
| 48 | if (ts->pchan == GSM_PCHAN_TCH_F_PDCH) { |
| 49 | if (ts->flags & TS_F_PDCH_PENDING_MASK) |
| 50 | return 0; |
| 51 | } |
| 52 | |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 53 | /* If a dynamic channel is busy changing, it is already taken or not |
| 54 | * yet available. */ |
| 55 | if (ts->pchan == GSM_PCHAN_TCH_F_TCH_H_PDCH) { |
| 56 | if (ts->dyn.pchan_is != ts->dyn.pchan_want) |
| 57 | return 0; |
| 58 | } |
| 59 | |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 60 | return 1; |
| 61 | } |
| 62 | |
Harald Welte (local) | 43db2bf | 2009-12-28 16:36:28 +0100 | [diff] [blame] | 63 | int trx_is_usable(struct gsm_bts_trx *trx) |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 64 | { |
| 65 | /* FIXME: How does this behave for BS-11 ? */ |
| 66 | if (is_ipaccess_bts(trx->bts)) { |
Harald Welte | 69f6f81 | 2011-05-30 12:07:53 +0200 | [diff] [blame] | 67 | if (!nm_is_running(&trx->mo.nm_state) || |
| 68 | !nm_is_running(&trx->bb_transc.mo.nm_state)) |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 69 | return 0; |
| 70 | } |
| 71 | |
| 72 | return 1; |
| 73 | } |
| 74 | |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 75 | static struct gsm_lchan * |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 76 | _lc_find_trx(struct gsm_bts_trx *trx, enum gsm_phys_chan_config pchan, |
| 77 | enum gsm_phys_chan_config dyn_as_pchan) |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 78 | { |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 79 | struct gsm_bts_trx_ts *ts; |
Andreas Eversberg | e34707e | 2013-10-11 13:05:16 +0200 | [diff] [blame] | 80 | int j, start, stop, dir, ss; |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 81 | int check_subslots; |
Harald Welte | 351ff12 | 2009-08-10 13:25:55 +0200 | [diff] [blame] | 82 | |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 83 | if (!trx_is_usable(trx)) |
| 84 | return NULL; |
| 85 | |
Andreas Eversberg | e34707e | 2013-10-11 13:05:16 +0200 | [diff] [blame] | 86 | if (trx->bts->chan_alloc_reverse) { |
| 87 | /* check TS 7..0 */ |
| 88 | start = 7; |
| 89 | stop = -1; |
| 90 | dir = -1; |
| 91 | } else { |
| 92 | /* check TS 0..7 */ |
| 93 | start = 0; |
| 94 | stop = 8; |
| 95 | dir = 1; |
| 96 | } |
| 97 | |
| 98 | for (j = start; j != stop; j += dir) { |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 99 | ts = &trx->ts[j]; |
Harald Welte | edc7b2f | 2009-12-24 10:10:16 +0100 | [diff] [blame] | 100 | if (!ts_is_usable(ts)) |
| 101 | continue; |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 102 | if (ts->pchan != pchan) |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 103 | continue; |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 104 | |
| 105 | /* |
| 106 | * Allocation for fully dynamic timeslots |
| 107 | * (does not apply for ip.access style GSM_PCHAN_TCH_F_PDCH) |
| 108 | * |
| 109 | * Note the special nature of a dynamic timeslot in PDCH mode: |
| 110 | * in PDCH mode, typically, lchan->type is GSM_LCHAN_NONE and |
| 111 | * lchan->state is LCHAN_S_NONE -- an otherwise unused slot |
| 112 | * becomes PDCH implicitly. In the same sense, this channel |
| 113 | * allocator will never be asked to find an available PDCH |
| 114 | * slot; only TCH/F or TCH/H will be requested, and PDCH mode |
| 115 | * means that it is available for switchover. |
| 116 | * |
| 117 | * A dynamic timeslot in PDCH mode may be switched to TCH/F or |
| 118 | * TCH/H. If a dyn TS is already in TCH/F or TCH/H mode, it |
| 119 | * means that it is in use and its mode can't be switched. |
| 120 | * |
| 121 | * The logic concerning channels for TCH/F is trivial: there is |
| 122 | * only one channel, so a dynamic TS in TCH/F mode is already |
| 123 | * taken and not available for allocation. For TCH/H, we need |
| 124 | * to check whether a dynamic timeslot is already in TCH/H mode |
| 125 | * and whether one of the two channels is still available. |
| 126 | */ |
| 127 | if (pchan == GSM_PCHAN_TCH_F_TCH_H_PDCH) { |
| 128 | if (ts->dyn.pchan_is != ts->dyn.pchan_want) { |
| 129 | /* The TS's mode is being switched. Not |
| 130 | * available anymore/yet. */ |
| 131 | DEBUGP(DRLL, "%s already in switchover\n", |
| 132 | gsm_ts_and_pchan_name(ts)); |
| 133 | continue; |
| 134 | } |
| 135 | if (ts->dyn.pchan_is == GSM_PCHAN_PDCH) { |
| 136 | /* This slot is available. Still check for |
| 137 | * error states to be sure; in all cases the |
| 138 | * first lchan will be used. */ |
| 139 | if (ts->lchan->state != LCHAN_S_NONE |
| 140 | && ts->lchan->state != LCHAN_S_ACTIVE) |
| 141 | continue; |
| 142 | return ts->lchan; |
| 143 | } |
| 144 | if (ts->dyn.pchan_is == dyn_as_pchan) { |
| 145 | /* The requested type matches the dynamic |
| 146 | * timeslot's current mode. A channel may still |
| 147 | * be available (think TCH/H). */ |
Neels Hofmeyr | c1110e1 | 2016-07-29 18:13:38 +0200 | [diff] [blame] | 148 | check_subslots = ts_subslots(ts); |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 149 | } else |
| 150 | /* Otherwise this slot is not applicable. */ |
| 151 | continue; |
| 152 | } else { |
| 153 | /* Not a dynamic channel, there is only one pchan kind: */ |
Neels Hofmeyr | c1110e1 | 2016-07-29 18:13:38 +0200 | [diff] [blame] | 154 | check_subslots = ts_subslots(ts); |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 155 | } |
| 156 | |
| 157 | /* Is a sub-slot still available? */ |
| 158 | for (ss = 0; ss < check_subslots; ss++) { |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 159 | struct gsm_lchan *lc = &ts->lchan[ss]; |
Harald Welte (local) | c3be50c | 2009-12-27 18:12:29 +0100 | [diff] [blame] | 160 | if (lc->type == GSM_LCHAN_NONE && |
| 161 | lc->state == LCHAN_S_NONE) |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 162 | return lc; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 163 | } |
| 164 | } |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 165 | |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 166 | return NULL; |
| 167 | } |
| 168 | |
| 169 | static struct gsm_lchan * |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 170 | _lc_dyn_find_bts(struct gsm_bts *bts, enum gsm_phys_chan_config pchan, |
| 171 | enum gsm_phys_chan_config dyn_as_pchan) |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 172 | { |
| 173 | struct gsm_bts_trx *trx; |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 174 | struct gsm_lchan *lc; |
| 175 | |
| 176 | if (bts->chan_alloc_reverse) { |
| 177 | llist_for_each_entry_reverse(trx, &bts->trx_list, list) { |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 178 | lc = _lc_find_trx(trx, pchan, dyn_as_pchan); |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 179 | if (lc) |
| 180 | return lc; |
| 181 | } |
| 182 | } else { |
| 183 | llist_for_each_entry(trx, &bts->trx_list, list) { |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 184 | lc = _lc_find_trx(trx, pchan, dyn_as_pchan); |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 185 | if (lc) |
| 186 | return lc; |
| 187 | } |
| 188 | } |
| 189 | |
Harald Welte | 6468793 | 2015-01-01 12:46:26 +0100 | [diff] [blame] | 190 | return NULL; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 191 | } |
| 192 | |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 193 | static struct gsm_lchan * |
| 194 | _lc_find_bts(struct gsm_bts *bts, enum gsm_phys_chan_config pchan) |
| 195 | { |
| 196 | return _lc_dyn_find_bts(bts, pchan, GSM_PCHAN_NONE); |
| 197 | } |
| 198 | |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 199 | /* Allocate a logical channel. |
| 200 | * |
Neels Hofmeyr | b3985cf | 2016-07-14 02:51:13 +0200 | [diff] [blame] | 201 | * Dynamic channel types: we always prefer a dedicated TS, and only pick + |
| 202 | * switch a dynamic TS if no pure TS of the requested PCHAN is available. |
| 203 | * |
| 204 | * TCH_F/PDCH: if we pick a PDCH ACT style dynamic TS as TCH/F channel, PDCH |
| 205 | * will be disabled in rsl_chan_activate_lchan(); there is no need to check |
| 206 | * whether PDCH mode is currently active, here. |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 207 | */ |
Holger Hans Peter Freyther | db39203 | 2010-09-06 08:58:42 +0800 | [diff] [blame] | 208 | struct gsm_lchan *lchan_alloc(struct gsm_bts *bts, enum gsm_chan_t type, |
| 209 | int allow_bigger) |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 210 | { |
| 211 | struct gsm_lchan *lchan = NULL; |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 212 | enum gsm_phys_chan_config first, first_cbch, second, second_cbch; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 213 | |
| 214 | switch (type) { |
| 215 | case GSM_LCHAN_SDCCH: |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 216 | if (bts->chan_alloc_reverse) { |
| 217 | first = GSM_PCHAN_SDCCH8_SACCH8C; |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 218 | first_cbch = GSM_PCHAN_SDCCH8_SACCH8C_CBCH; |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 219 | second = GSM_PCHAN_CCCH_SDCCH4; |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 220 | second_cbch = GSM_PCHAN_CCCH_SDCCH4_CBCH; |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 221 | } else { |
| 222 | first = GSM_PCHAN_CCCH_SDCCH4; |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 223 | first_cbch = GSM_PCHAN_CCCH_SDCCH4_CBCH; |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 224 | second = GSM_PCHAN_SDCCH8_SACCH8C; |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 225 | second_cbch = GSM_PCHAN_SDCCH8_SACCH8C_CBCH; |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 226 | } |
| 227 | |
| 228 | lchan = _lc_find_bts(bts, first); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 229 | if (lchan == NULL) |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 230 | lchan = _lc_find_bts(bts, first_cbch); |
| 231 | if (lchan == NULL) |
Harald Welte | af86c0f | 2009-08-10 14:44:24 +0200 | [diff] [blame] | 232 | lchan = _lc_find_bts(bts, second); |
Harald Welte | bf4ba72 | 2014-12-28 15:00:45 +0100 | [diff] [blame] | 233 | if (lchan == NULL) |
| 234 | lchan = _lc_find_bts(bts, second_cbch); |
Holger Hans Peter Freyther | db39203 | 2010-09-06 08:58:42 +0800 | [diff] [blame] | 235 | |
| 236 | /* allow to assign bigger channels */ |
| 237 | if (allow_bigger) { |
| 238 | if (lchan == NULL) { |
| 239 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_H); |
Neels Hofmeyr | bb17dbc | 2016-06-06 12:57:22 +0200 | [diff] [blame] | 240 | if (lchan) |
| 241 | type = GSM_LCHAN_TCH_H; |
Holger Hans Peter Freyther | db39203 | 2010-09-06 08:58:42 +0800 | [diff] [blame] | 242 | } |
| 243 | |
| 244 | if (lchan == NULL) { |
| 245 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F); |
Neels Hofmeyr | bb17dbc | 2016-06-06 12:57:22 +0200 | [diff] [blame] | 246 | if (lchan) |
| 247 | type = GSM_LCHAN_TCH_F; |
Holger Hans Peter Freyther | db39203 | 2010-09-06 08:58:42 +0800 | [diff] [blame] | 248 | } |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 249 | |
| 250 | /* try dynamic TCH/F_PDCH */ |
| 251 | if (lchan == NULL) { |
| 252 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F_PDCH); |
| 253 | /* TCH/F_PDCH will be used as TCH/F */ |
| 254 | if (lchan) |
| 255 | type = GSM_LCHAN_TCH_F; |
| 256 | } |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 257 | |
| 258 | /* try fully dynamic TCH/F_TCH/H_PDCH */ |
| 259 | if (lchan == NULL) { |
| 260 | lchan = _lc_dyn_find_bts(bts, GSM_PCHAN_TCH_F_TCH_H_PDCH, |
| 261 | GSM_PCHAN_TCH_H); |
| 262 | if (lchan) |
| 263 | type = GSM_LCHAN_TCH_H; |
| 264 | } |
| 265 | /* |
| 266 | * No need to check fully dynamic channels for TCH/F: |
| 267 | * if no TCH/H was available, neither will be TCH/F. |
| 268 | */ |
Holger Hans Peter Freyther | db39203 | 2010-09-06 08:58:42 +0800 | [diff] [blame] | 269 | } |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 270 | break; |
| 271 | case GSM_LCHAN_TCH_F: |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 272 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F); |
Harald Welte | 64e68df | 2014-05-18 22:23:26 +0200 | [diff] [blame] | 273 | /* If we don't have TCH/F available, fall-back to TCH/H */ |
| 274 | if (!lchan) { |
| 275 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_H); |
Neels Hofmeyr | bb17dbc | 2016-06-06 12:57:22 +0200 | [diff] [blame] | 276 | if (lchan) |
| 277 | type = GSM_LCHAN_TCH_H; |
Harald Welte | 64e68df | 2014-05-18 22:23:26 +0200 | [diff] [blame] | 278 | } |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 279 | /* If we don't have TCH/H either, try dynamic TCH/F_PDCH */ |
| 280 | if (!lchan) { |
| 281 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F_PDCH); |
| 282 | /* TCH/F_PDCH used as TCH/F -- here, type is already |
| 283 | * set to GSM_LCHAN_TCH_F, but for clarity's sake... */ |
| 284 | if (lchan) |
| 285 | type = GSM_LCHAN_TCH_F; |
| 286 | } |
Neels Hofmeyr | f8d6053 | 2016-07-23 20:15:28 +0200 | [diff] [blame] | 287 | |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 288 | /* Try fully dynamic TCH/F_TCH/H_PDCH as TCH/F... */ |
Neels Hofmeyr | f8d6053 | 2016-07-23 20:15:28 +0200 | [diff] [blame] | 289 | if (!lchan && bts->network->dyn_ts_allow_tch_f) { |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 290 | lchan = _lc_dyn_find_bts(bts, |
| 291 | GSM_PCHAN_TCH_F_TCH_H_PDCH, |
| 292 | GSM_PCHAN_TCH_F); |
| 293 | if (lchan) |
| 294 | type = GSM_LCHAN_TCH_F; |
| 295 | } |
| 296 | /* ...and as TCH/H. */ |
| 297 | if (!lchan) { |
| 298 | lchan = _lc_dyn_find_bts(bts, |
| 299 | GSM_PCHAN_TCH_F_TCH_H_PDCH, |
| 300 | GSM_PCHAN_TCH_H); |
| 301 | if (lchan) |
| 302 | type = GSM_LCHAN_TCH_H; |
| 303 | } |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 304 | break; |
| 305 | case GSM_LCHAN_TCH_H: |
Harald Welte | ceb3c04 | 2009-08-10 13:46:55 +0200 | [diff] [blame] | 306 | lchan =_lc_find_bts(bts, GSM_PCHAN_TCH_H); |
Harald Welte | 1250337 | 2009-12-12 20:58:20 +0100 | [diff] [blame] | 307 | /* If we don't have TCH/H available, fall-back to TCH/F */ |
Harald Welte | 5ea9e8e | 2009-12-12 21:16:38 +0100 | [diff] [blame] | 308 | if (!lchan) { |
Harald Welte | 1250337 | 2009-12-12 20:58:20 +0100 | [diff] [blame] | 309 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F); |
Neels Hofmeyr | bb17dbc | 2016-06-06 12:57:22 +0200 | [diff] [blame] | 310 | if (lchan) |
| 311 | type = GSM_LCHAN_TCH_F; |
Harald Welte | 5ea9e8e | 2009-12-12 21:16:38 +0100 | [diff] [blame] | 312 | } |
Neels Hofmeyr | ff4ebd8 | 2016-07-14 03:01:24 +0200 | [diff] [blame] | 313 | /* No dedicated TCH/x available -- try fully dynamic |
| 314 | * TCH/F_TCH/H_PDCH */ |
| 315 | if (!lchan) { |
| 316 | lchan = _lc_dyn_find_bts(bts, |
| 317 | GSM_PCHAN_TCH_F_TCH_H_PDCH, |
| 318 | GSM_PCHAN_TCH_H); |
| 319 | if (lchan) |
| 320 | type = GSM_LCHAN_TCH_H; |
| 321 | } |
| 322 | /* |
| 323 | * No need to check TCH/F_TCH/H_PDCH channels for TCH/F: |
| 324 | * if no TCH/H was available, neither will be TCH/F. |
| 325 | */ |
Neels Hofmeyr | 05955e4 | 2016-06-06 12:53:25 +0200 | [diff] [blame] | 326 | /* If we don't have TCH/F either, try dynamic TCH/F_PDCH */ |
| 327 | if (!lchan) { |
| 328 | lchan = _lc_find_bts(bts, GSM_PCHAN_TCH_F_PDCH); |
| 329 | if (lchan) |
| 330 | type = GSM_LCHAN_TCH_F; |
| 331 | } |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 332 | break; |
| 333 | default: |
Harald Welte | cf2ec4a | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 334 | LOGP(DRLL, LOGL_ERROR, "Unknown gsm_chan_t %u\n", type); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 335 | } |
| 336 | |
| 337 | if (lchan) { |
| 338 | lchan->type = type; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 339 | |
Neels Hofmeyr | 9eee2cd | 2016-07-25 12:33:02 +0200 | [diff] [blame] | 340 | LOGP(DRLL, LOGL_INFO, "%s Allocating lchan=%u as %s\n", |
| 341 | gsm_ts_and_pchan_name(lchan->ts), |
| 342 | lchan->nr, gsm_lchant_name(lchan->type)); |
| 343 | |
Holger Hans Peter Freyther | d831805 | 2009-10-28 14:23:39 +0100 | [diff] [blame] | 344 | /* clear sapis */ |
Holger Hans Peter Freyther | 29afdc4 | 2009-11-18 22:59:51 +0100 | [diff] [blame] | 345 | memset(lchan->sapis, 0, ARRAY_SIZE(lchan->sapis)); |
Holger Hans Peter Freyther | d831805 | 2009-10-28 14:23:39 +0100 | [diff] [blame] | 346 | |
Holger Hans Peter Freyther | 3cce58f | 2009-11-18 22:57:02 +0100 | [diff] [blame] | 347 | /* clear multi rate config */ |
Andreas Eversberg | fa163e8 | 2014-01-19 11:47:44 +0100 | [diff] [blame] | 348 | memset(&lchan->mr_ms_lv, 0, sizeof(lchan->mr_ms_lv)); |
| 349 | memset(&lchan->mr_bts_lv, 0, sizeof(lchan->mr_bts_lv)); |
Holger Hans Peter Freyther | 960adfe | 2014-12-28 12:08:28 +0100 | [diff] [blame] | 350 | lchan->broken_reason = ""; |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 351 | } else { |
| 352 | struct challoc_signal_data sig; |
Neels Hofmeyr | 9eee2cd | 2016-07-25 12:33:02 +0200 | [diff] [blame] | 353 | |
| 354 | LOGP(DRLL, LOGL_ERROR, "Failed to allocate %s channel\n", |
| 355 | gsm_lchant_name(type)); |
| 356 | |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 357 | sig.bts = bts; |
| 358 | sig.type = type; |
Pablo Neira Ayuso | ef717c6 | 2011-05-06 12:12:31 +0200 | [diff] [blame] | 359 | osmo_signal_dispatch(SS_CHALLOC, S_CHALLOC_ALLOC_FAIL, &sig); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 360 | } |
| 361 | |
| 362 | return lchan; |
| 363 | } |
| 364 | |
| 365 | /* Free a logical channel */ |
| 366 | void lchan_free(struct gsm_lchan *lchan) |
| 367 | { |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 368 | struct challoc_signal_data sig; |
Harald Welte | f947681 | 2009-12-15 21:36:05 +0100 | [diff] [blame] | 369 | int i; |
| 370 | |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 371 | sig.type = lchan->type; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 372 | lchan->type = GSM_LCHAN_NONE; |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 373 | |
| 374 | |
| 375 | if (lchan->conn) { |
Holger Hans Peter Freyther | 645b383 | 2010-12-27 13:28:20 +0100 | [diff] [blame] | 376 | struct lchan_signal_data sig; |
| 377 | |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 378 | /* We might kill an active channel... */ |
Holger Hans Peter Freyther | 645b383 | 2010-12-27 13:28:20 +0100 | [diff] [blame] | 379 | sig.lchan = lchan; |
| 380 | sig.mr = NULL; |
Pablo Neira Ayuso | ef717c6 | 2011-05-06 12:12:31 +0200 | [diff] [blame] | 381 | osmo_signal_dispatch(SS_LCHAN, S_LCHAN_UNEXPECTED_RELEASE, &sig); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 382 | } |
| 383 | |
Holger Hans Peter Freyther | 00452c4 | 2012-01-17 15:27:33 +0100 | [diff] [blame] | 384 | if (lchan->abis_ip.rtp_socket) { |
| 385 | LOGP(DRLL, LOGL_ERROR, "%s RTP Proxy Socket remained open.\n", |
| 386 | gsm_lchan_name(lchan)); |
| 387 | rtp_socket_free(lchan->abis_ip.rtp_socket); |
| 388 | lchan->abis_ip.rtp_socket = NULL; |
| 389 | } |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 390 | |
| 391 | /* stop the timer */ |
Pablo Neira Ayuso | 840ccf6 | 2011-05-06 12:11:06 +0200 | [diff] [blame] | 392 | osmo_timer_del(&lchan->T3101); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 393 | |
Harald Welte | f947681 | 2009-12-15 21:36:05 +0100 | [diff] [blame] | 394 | /* clear cached measuement reports */ |
| 395 | lchan->meas_rep_idx = 0; |
| 396 | for (i = 0; i < ARRAY_SIZE(lchan->meas_rep); i++) { |
| 397 | lchan->meas_rep[i].flags = 0; |
| 398 | lchan->meas_rep[i].nr = 0; |
| 399 | } |
Harald Welte | 92d8891 | 2009-12-21 13:30:17 +0100 | [diff] [blame] | 400 | for (i = 0; i < ARRAY_SIZE(lchan->neigh_meas); i++) |
| 401 | lchan->neigh_meas[i].arfcn = 0; |
Harald Welte | f947681 | 2009-12-15 21:36:05 +0100 | [diff] [blame] | 402 | |
Holger Hans Peter Freyther | c08f6f0 | 2010-06-22 12:11:59 +0800 | [diff] [blame] | 403 | if (lchan->rqd_ref) { |
| 404 | talloc_free(lchan->rqd_ref); |
| 405 | lchan->rqd_ref = NULL; |
| 406 | lchan->rqd_ta = 0; |
| 407 | } |
| 408 | |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 409 | sig.lchan = lchan; |
| 410 | sig.bts = lchan->ts->trx->bts; |
Pablo Neira Ayuso | ef717c6 | 2011-05-06 12:12:31 +0200 | [diff] [blame] | 411 | osmo_signal_dispatch(SS_CHALLOC, S_CHALLOC_FREED, &sig); |
Harald Welte | 8f72544 | 2010-03-28 15:58:03 +0800 | [diff] [blame] | 412 | |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 413 | if (lchan->conn) { |
Holger Hans Peter Freyther | 6e5c50f | 2010-06-28 17:09:29 +0800 | [diff] [blame] | 414 | LOGP(DRLL, LOGL_ERROR, "the subscriber connection should be gone.\n"); |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 415 | lchan->conn = NULL; |
| 416 | } |
| 417 | |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 418 | /* FIXME: ts_free() the timeslot, if we're the last logical |
| 419 | * channel using it */ |
| 420 | } |
| 421 | |
Holger Hans Peter Freyther | 5a8b2b4 | 2010-04-15 11:21:02 +0200 | [diff] [blame] | 422 | /* |
| 423 | * There was an error with the TRX and we need to forget |
| 424 | * any state so that a lchan can be allocated again after |
| 425 | * the trx is fully usable. |
Holger Hans Peter Freyther | 66a3c77 | 2010-06-22 12:19:06 +0800 | [diff] [blame] | 426 | * |
| 427 | * This should be called after lchan_free to force a channel |
| 428 | * be available for allocation again. This means that this |
| 429 | * method will stop the "delay after error"-timer and set the |
| 430 | * state to LCHAN_S_NONE. |
Holger Hans Peter Freyther | 5a8b2b4 | 2010-04-15 11:21:02 +0200 | [diff] [blame] | 431 | */ |
| 432 | void lchan_reset(struct gsm_lchan *lchan) |
| 433 | { |
Pablo Neira Ayuso | 840ccf6 | 2011-05-06 12:11:06 +0200 | [diff] [blame] | 434 | osmo_timer_del(&lchan->T3101); |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 435 | osmo_timer_del(&lchan->T3109); |
Pablo Neira Ayuso | 840ccf6 | 2011-05-06 12:11:06 +0200 | [diff] [blame] | 436 | osmo_timer_del(&lchan->T3111); |
| 437 | osmo_timer_del(&lchan->error_timer); |
Holger Hans Peter Freyther | 5a8b2b4 | 2010-04-15 11:21:02 +0200 | [diff] [blame] | 438 | |
| 439 | lchan->type = GSM_LCHAN_NONE; |
| 440 | lchan->state = LCHAN_S_NONE; |
Holger Hans Peter Freyther | 00452c4 | 2012-01-17 15:27:33 +0100 | [diff] [blame] | 441 | |
| 442 | if (lchan->abis_ip.rtp_socket) { |
| 443 | rtp_socket_free(lchan->abis_ip.rtp_socket); |
| 444 | lchan->abis_ip.rtp_socket = NULL; |
| 445 | } |
Holger Hans Peter Freyther | 5a8b2b4 | 2010-04-15 11:21:02 +0200 | [diff] [blame] | 446 | } |
| 447 | |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 448 | /* Drive the release process of the lchan */ |
Holger Hans Peter Freyther | e38af68 | 2011-12-27 22:24:17 +0100 | [diff] [blame] | 449 | static void _lchan_handle_release(struct gsm_lchan *lchan, |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 450 | int sacch_deact, int mode) |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 451 | { |
Holger Hans Peter Freyther | e38af68 | 2011-12-27 22:24:17 +0100 | [diff] [blame] | 452 | /* Release all SAPIs on the local end and continue */ |
| 453 | rsl_release_sapis_from(lchan, 1, RSL_REL_LOCAL_END); |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 454 | |
Holger Hans Peter Freyther | e38af68 | 2011-12-27 22:24:17 +0100 | [diff] [blame] | 455 | /* |
| 456 | * Shall we send a RR Release, start T3109 and wait for the |
| 457 | * release indication from the BTS or just take it down (e.g. |
| 458 | * on assignment requests) |
| 459 | */ |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 460 | if (sacch_deact) { |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 461 | gsm48_send_rr_release(lchan); |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 462 | |
| 463 | /* Deactivate the SACCH on the BTS side */ |
| 464 | rsl_deact_sacch(lchan); |
| 465 | rsl_start_t3109(lchan); |
Holger Hans Peter Freyther | c63cb86 | 2012-12-25 23:45:14 +0100 | [diff] [blame] | 466 | } else if (lchan->sapis[0] == LCHAN_SAPI_UNUSED) { |
| 467 | rsl_direct_rf_release(lchan); |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 468 | } else { |
Holger Hans Peter Freyther | e38af68 | 2011-12-27 22:24:17 +0100 | [diff] [blame] | 469 | rsl_release_request(lchan, 0, mode); |
Holger Hans Peter Freyther | 969a405 | 2011-12-28 16:21:05 +0100 | [diff] [blame] | 470 | } |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 471 | } |
Holger Hans Peter Freyther | 5a8b2b4 | 2010-04-15 11:21:02 +0200 | [diff] [blame] | 472 | |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 473 | /* Consider releasing the channel now */ |
Holger Hans Peter Freyther | 2806c79 | 2012-12-06 12:01:38 +0100 | [diff] [blame] | 474 | int lchan_release(struct gsm_lchan *lchan, int sacch_deact, enum rsl_rel_mode mode) |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 475 | { |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 476 | DEBUGP(DRLL, "%s starting release sequence\n", gsm_lchan_name(lchan)); |
Holger Hans Peter Freyther | 79a62f4 | 2010-04-10 00:14:55 +0200 | [diff] [blame] | 477 | rsl_lchan_set_state(lchan, LCHAN_S_REL_REQ); |
Holger Hans Peter Freyther | 3fdf5b9 | 2010-07-29 17:09:36 +0800 | [diff] [blame] | 478 | |
Holger Hans Peter Freyther | 5322dbf | 2010-11-14 16:04:46 +0100 | [diff] [blame] | 479 | lchan->conn = NULL; |
Holger Hans Peter Freyther | e38af68 | 2011-12-27 22:24:17 +0100 | [diff] [blame] | 480 | _lchan_handle_release(lchan, sacch_deact, mode); |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 481 | return 1; |
| 482 | } |
| 483 | |
Holger Hans Peter Freyther | 8bf60d4 | 2010-06-16 13:05:35 +0800 | [diff] [blame] | 484 | static struct gsm_lchan* lchan_find(struct gsm_bts *bts, struct gsm_subscriber *subscr) { |
Harald Welte | e712a5f | 2009-06-21 16:17:15 +0200 | [diff] [blame] | 485 | struct gsm_bts_trx *trx; |
Holger Hans Peter Freyther | 7113514 | 2010-03-29 08:47:44 +0200 | [diff] [blame] | 486 | int ts_no, lchan_no; |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 487 | |
Harald Welte | e712a5f | 2009-06-21 16:17:15 +0200 | [diff] [blame] | 488 | llist_for_each_entry(trx, &bts->trx_list, list) { |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 489 | for (ts_no = 0; ts_no < 8; ++ts_no) { |
| 490 | for (lchan_no = 0; lchan_no < TS_MAX_LCHAN; ++lchan_no) { |
| 491 | struct gsm_lchan *lchan = |
Harald Welte | e712a5f | 2009-06-21 16:17:15 +0200 | [diff] [blame] | 492 | &trx->ts[ts_no].lchan[lchan_no]; |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 493 | if (lchan->conn && subscr == lchan->conn->subscr) |
Harald Welte | 59b0468 | 2009-06-10 05:40:52 +0800 | [diff] [blame] | 494 | return lchan; |
| 495 | } |
| 496 | } |
| 497 | } |
| 498 | |
| 499 | return NULL; |
| 500 | } |
Harald Welte | aa60edb | 2009-08-09 18:52:33 +0200 | [diff] [blame] | 501 | |
Holger Hans Peter Freyther | 2f4af77 | 2010-06-16 13:23:55 +0800 | [diff] [blame] | 502 | struct gsm_subscriber_connection *connection_for_subscr(struct gsm_subscriber *subscr) |
Harald Welte | aa60edb | 2009-08-09 18:52:33 +0200 | [diff] [blame] | 503 | { |
| 504 | struct gsm_bts *bts; |
Jacob Erlbeck | da8770b | 2014-12-03 09:28:24 +0100 | [diff] [blame] | 505 | struct gsm_network *net = subscr->group->net; |
Harald Welte | aa60edb | 2009-08-09 18:52:33 +0200 | [diff] [blame] | 506 | struct gsm_lchan *lchan; |
| 507 | |
| 508 | llist_for_each_entry(bts, &net->bts_list, list) { |
| 509 | lchan = lchan_find(bts, subscr); |
| 510 | if (lchan) |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 511 | return lchan->conn; |
Harald Welte | aa60edb | 2009-08-09 18:52:33 +0200 | [diff] [blame] | 512 | } |
| 513 | |
Holger Hans Peter Freyther | 3265b1a | 2009-10-27 10:42:53 +0100 | [diff] [blame] | 514 | return NULL; |
Harald Welte | aa60edb | 2009-08-09 18:52:33 +0200 | [diff] [blame] | 515 | } |
Harald Welte | fe96f38 | 2009-12-22 13:09:29 +0100 | [diff] [blame] | 516 | |
| 517 | void bts_chan_load(struct pchan_load *cl, const struct gsm_bts *bts) |
| 518 | { |
| 519 | struct gsm_bts_trx *trx; |
| 520 | |
| 521 | llist_for_each_entry(trx, &bts->trx_list, list) { |
| 522 | int i; |
| 523 | |
| 524 | /* skip administratively deactivated tranxsceivers */ |
Harald Welte | 69f6f81 | 2011-05-30 12:07:53 +0200 | [diff] [blame] | 525 | if (!nm_is_running(&trx->mo.nm_state) || |
| 526 | !nm_is_running(&trx->bb_transc.mo.nm_state)) |
Harald Welte | fe96f38 | 2009-12-22 13:09:29 +0100 | [diff] [blame] | 527 | continue; |
| 528 | |
| 529 | for (i = 0; i < ARRAY_SIZE(trx->ts); i++) { |
| 530 | struct gsm_bts_trx_ts *ts = &trx->ts[i]; |
| 531 | struct load_counter *pl = &cl->pchan[ts->pchan]; |
| 532 | int j; |
Neels Hofmeyr | 5d01f96 | 2016-07-29 18:10:59 +0200 | [diff] [blame] | 533 | int subslots; |
Harald Welte | fe96f38 | 2009-12-22 13:09:29 +0100 | [diff] [blame] | 534 | |
| 535 | /* skip administratively deactivated timeslots */ |
Harald Welte | 69f6f81 | 2011-05-30 12:07:53 +0200 | [diff] [blame] | 536 | if (!nm_is_running(&ts->mo.nm_state)) |
Harald Welte | fe96f38 | 2009-12-22 13:09:29 +0100 | [diff] [blame] | 537 | continue; |
| 538 | |
Neels Hofmeyr | 5d01f96 | 2016-07-29 18:10:59 +0200 | [diff] [blame] | 539 | subslots = ts_subslots(ts); |
| 540 | for (j = 0; j < subslots; j++) { |
Harald Welte | fe96f38 | 2009-12-22 13:09:29 +0100 | [diff] [blame] | 541 | struct gsm_lchan *lchan = &ts->lchan[j]; |
| 542 | |
| 543 | pl->total++; |
| 544 | |
| 545 | switch (lchan->state) { |
| 546 | case LCHAN_S_NONE: |
| 547 | break; |
| 548 | default: |
| 549 | pl->used++; |
| 550 | break; |
| 551 | } |
| 552 | } |
| 553 | } |
| 554 | } |
| 555 | } |
| 556 | |
| 557 | void network_chan_load(struct pchan_load *pl, struct gsm_network *net) |
| 558 | { |
| 559 | struct gsm_bts *bts; |
| 560 | |
| 561 | memset(pl, 0, sizeof(*pl)); |
| 562 | |
| 563 | llist_for_each_entry(bts, &net->bts_list, list) |
| 564 | bts_chan_load(pl, bts); |
| 565 | } |
Holger Hans Peter Freyther | 1a95fa8 | 2010-06-28 15:47:12 +0800 | [diff] [blame] | 566 | |