Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 1 | /* GSM 04.08 System Information (SI) encoding and decoding |
| 2 | * 3GPP TS 04.08 version 7.21.0 Release 1998 / ETSI TS 100 940 V7.21.0 */ |
| 3 | |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 4 | /* (C) 2008-2010 by Harald Welte <laforge@gnumonks.org> |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 5 | * |
| 6 | * All Rights Reserved |
| 7 | * |
| 8 | * This program is free software; you can redistribute it and/or modify |
Harald Welte | 9af6ddf | 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 | a43f789 | 2009-12-01 18:04:30 +0530 | [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 | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 16 | * GNU Affero General Public License for more details. |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 17 | * |
Harald Welte | 9af6ddf | 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 | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 20 | * |
| 21 | */ |
| 22 | |
| 23 | #include <errno.h> |
| 24 | #include <string.h> |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 25 | #include <stdio.h> |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 26 | #include <sys/types.h> |
| 27 | #include <netinet/in.h> |
| 28 | |
| 29 | #include <openbsc/gsm_04_08.h> |
| 30 | #include <openbsc/gsm_data.h> |
| 31 | #include <openbsc/abis_rsl.h> |
| 32 | #include <openbsc/rest_octets.h> |
Harald Welte | dfe6c7d | 2010-02-20 16:24:02 +0100 | [diff] [blame] | 33 | #include <osmocore/bitvec.h> |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 34 | #include <osmocore/utils.h> |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 35 | #include <openbsc/debug.h> |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 36 | |
| 37 | #define GSM48_CELL_CHAN_DESC_SIZE 16 |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 38 | #define GSM_MACBLOCK_PADDING 0x2b |
| 39 | |
Holger Hans Peter Freyther | b91a106 | 2010-01-06 06:38:14 +0100 | [diff] [blame] | 40 | /* verify the sizes of the system information type structs */ |
| 41 | |
| 42 | /* rest octets are not part of the struct */ |
| 43 | static_assert(sizeof(struct gsm48_system_information_type_header) == 3, _si_header_size); |
| 44 | static_assert(sizeof(struct gsm48_rach_control) == 3, _si_rach_control); |
| 45 | static_assert(sizeof(struct gsm48_system_information_type_1) == 22, _si1_size); |
| 46 | static_assert(sizeof(struct gsm48_system_information_type_2) == 23, _si2_size); |
| 47 | static_assert(sizeof(struct gsm48_system_information_type_3) == 19, _si3_size); |
| 48 | static_assert(sizeof(struct gsm48_system_information_type_4) == 13, _si4_size); |
| 49 | |
| 50 | /* bs11 forgot the l2 len, 0-6 rest octets */ |
| 51 | static_assert(sizeof(struct gsm48_system_information_type_5) == 18, _si5_size); |
| 52 | static_assert(sizeof(struct gsm48_system_information_type_6) == 11, _si6_size); |
| 53 | |
| 54 | static_assert(sizeof(struct gsm48_system_information_type_13) == 3, _si13_size); |
| 55 | |
Harald Welte | da760d3 | 2009-12-14 20:25:05 +0100 | [diff] [blame] | 56 | /* Frequency Lists as per TS 04.08 10.5.2.13 */ |
| 57 | |
| 58 | /* 10.5.2.13.2: Bit map 0 format */ |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 59 | static int freq_list_bm0_set_arfcn(u_int8_t *chan_list, unsigned int arfcn) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 60 | { |
| 61 | unsigned int byte, bit; |
| 62 | |
Harald Welte | b1d4c8e | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 63 | if (arfcn > 124 || arfcn < 1) { |
| 64 | LOGP(DRR, LOGL_ERROR, "Bitmap 0 only supports ARFCN 1...124\n"); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 65 | return -EINVAL; |
Harald Welte | b1d4c8e | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 66 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 67 | |
Harald Welte | da760d3 | 2009-12-14 20:25:05 +0100 | [diff] [blame] | 68 | /* the bitmask is from 1..124, not from 0..123 */ |
| 69 | arfcn--; |
| 70 | |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 71 | byte = arfcn / 8; |
| 72 | bit = arfcn % 8; |
| 73 | |
Harald Welte | da760d3 | 2009-12-14 20:25:05 +0100 | [diff] [blame] | 74 | chan_list[GSM48_CELL_CHAN_DESC_SIZE-1-byte] |= (1 << bit); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 75 | |
| 76 | return 0; |
| 77 | } |
| 78 | |
Harald Welte | da760d3 | 2009-12-14 20:25:05 +0100 | [diff] [blame] | 79 | /* 10.5.2.13.7: Variable bit map format */ |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 80 | static int freq_list_bmrel_set_arfcn(u_int8_t *chan_list, unsigned int arfcn) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 81 | { |
| 82 | unsigned int byte, bit; |
| 83 | unsigned int min_arfcn; |
| 84 | unsigned int bitno; |
| 85 | |
| 86 | min_arfcn = (chan_list[0] & 1) << 9; |
| 87 | min_arfcn |= chan_list[1] << 1; |
| 88 | min_arfcn |= (chan_list[2] >> 7) & 1; |
| 89 | |
| 90 | /* The lower end of our bitmaks is always implicitly included */ |
| 91 | if (arfcn == min_arfcn) |
| 92 | return 0; |
| 93 | |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 94 | if (arfcn < min_arfcn) { |
Harald Welte | b1d4c8e | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 95 | LOGP(DRR, LOGL_ERROR, "arfcn(%u) < min(%u)\n", arfcn, min_arfcn); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 96 | return -EINVAL; |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 97 | } |
| 98 | if (arfcn > min_arfcn + 111) { |
Harald Welte | b1d4c8e | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 99 | LOGP(DRR, LOGL_ERROR, "arfcn(%u) > min(%u) + 111\n", arfcn, min_arfcn); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 100 | return -EINVAL; |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 101 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 102 | |
| 103 | bitno = (arfcn - min_arfcn); |
| 104 | byte = bitno / 8; |
| 105 | bit = bitno % 8; |
| 106 | |
| 107 | chan_list[2 + byte] |= 1 << (7 - bit); |
| 108 | |
| 109 | return 0; |
| 110 | } |
| 111 | |
| 112 | /* generate a cell channel list as per Section 10.5.2.1b of 04.08 */ |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 113 | static int bitvec2freq_list(u_int8_t *chan_list, struct bitvec *bv, |
| 114 | const struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 115 | { |
Sylvain Munaut | 42a5652 | 2009-12-24 14:20:19 +0100 | [diff] [blame] | 116 | int i, rc, min = 1024, max = -1; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 117 | |
| 118 | memset(chan_list, 0, 16); |
| 119 | |
| 120 | /* GSM900-only handsets only support 'bit map 0 format' */ |
| 121 | if (bts->band == GSM_BAND_900) { |
| 122 | chan_list[0] = 0; |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 123 | |
| 124 | for (i = 0; i < bv->data_len*8; i++) { |
| 125 | if (bitvec_get_bit_pos(bv, i)) { |
| 126 | rc = freq_list_bm0_set_arfcn(chan_list, i); |
| 127 | if (rc < 0) |
| 128 | return rc; |
| 129 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 130 | } |
| 131 | return 0; |
| 132 | } |
| 133 | |
| 134 | /* We currently only support the 'Variable bitmap format' */ |
| 135 | chan_list[0] = 0x8e; |
| 136 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 137 | for (i = 0; i < bv->data_len*8; i++) { |
| 138 | if (bitvec_get_bit_pos(bv, i)) { |
| 139 | if (i < min) |
| 140 | min = i; |
| 141 | if (i > max) |
| 142 | max = i; |
| 143 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 144 | } |
| 145 | |
Sylvain Munaut | 42a5652 | 2009-12-24 14:20:19 +0100 | [diff] [blame] | 146 | if (max == -1) { |
| 147 | /* Empty set, use 'bit map 0 format' */ |
| 148 | chan_list[0] = 0; |
| 149 | return 0; |
| 150 | } |
| 151 | |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 152 | if ((max - min) > 111) { |
Harald Welte | b1d4c8e | 2009-12-17 23:10:46 +0100 | [diff] [blame] | 153 | LOGP(DRR, LOGL_ERROR, "min_arfcn=%u, max_arfcn=%u, " |
| 154 | "distance > 111\n", min, max); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 155 | return -EINVAL; |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 156 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 157 | |
| 158 | chan_list[0] |= (min >> 9) & 1; |
| 159 | chan_list[1] = (min >> 1); |
| 160 | chan_list[2] = (min & 1) << 7; |
| 161 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 162 | for (i = 0; i < bv->data_len*8; i++) { |
Harald Welte | 152b626 | 2009-12-16 11:57:48 +0100 | [diff] [blame] | 163 | if (bitvec_get_bit_pos(bv, i)) { |
| 164 | rc = freq_list_bmrel_set_arfcn(chan_list, i); |
| 165 | if (rc < 0) |
| 166 | return rc; |
| 167 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 168 | } |
| 169 | |
| 170 | return 0; |
| 171 | } |
| 172 | |
| 173 | /* generate a cell channel list as per Section 10.5.2.1b of 04.08 */ |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 174 | static int generate_cell_chan_list(u_int8_t *chan_list, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 175 | { |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 176 | struct gsm_bts_trx *trx; |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 177 | struct bitvec *bv = &bts->si_common.cell_alloc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 178 | |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 179 | /* Zero-initialize the bit-vector */ |
Harald Welte | c8794b5 | 2010-06-16 11:09:18 +0200 | [diff] [blame] | 180 | memset(bv->data, 0, bv->data_len); |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 181 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 182 | /* first we generate a bitvec of all TRX ARFCN's in our BTS */ |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 183 | llist_for_each_entry(trx, &bts->trx_list, list) { |
| 184 | unsigned int i, j; |
| 185 | /* Always add the TRX's ARFCN */ |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 186 | bitvec_set_bit_pos(bv, trx->arfcn, 1); |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 187 | for (i = 0; i < ARRAY_SIZE(trx->ts); i++) { |
| 188 | struct gsm_bts_trx_ts *ts = &trx->ts[i]; |
| 189 | /* Add any ARFCNs present in hopping channels */ |
| 190 | for (j = 0; j < 1024; j++) { |
| 191 | if (bitvec_get_bit_pos(&ts->hopping.arfcns, j)) |
| 192 | bitvec_set_bit_pos(bv, j, 1); |
| 193 | } |
| 194 | } |
| 195 | } |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 196 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 197 | /* then we generate a GSM 04.08 frequency list from the bitvec */ |
| 198 | return bitvec2freq_list(chan_list, bv, bts); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 199 | } |
| 200 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 201 | /* generate a cell channel list as per Section 10.5.2.1b of 04.08 */ |
| 202 | static int generate_bcch_chan_list(u_int8_t *chan_list, struct gsm_bts *bts) |
| 203 | { |
| 204 | struct gsm_bts *cur_bts; |
| 205 | struct bitvec *bv = &bts->si_common.neigh_list; |
| 206 | |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 207 | /* Zero-initialize the bit-vector */ |
Harald Welte | c8794b5 | 2010-06-16 11:09:18 +0200 | [diff] [blame] | 208 | memset(bv->data, 0, bv->data_len); |
Harald Welte | a39b0f2 | 2010-06-14 22:26:10 +0200 | [diff] [blame] | 209 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 210 | /* first we generate a bitvec of the BCCH ARFCN's in our BSC */ |
| 211 | llist_for_each_entry(cur_bts, &bts->network->bts_list, list) { |
| 212 | if (cur_bts == bts) |
| 213 | continue; |
| 214 | bitvec_set_bit_pos(bv, cur_bts->c0->arfcn, 1); |
| 215 | } |
| 216 | |
| 217 | /* then we generate a GSM 04.08 frequency list from the bitvec */ |
| 218 | return bitvec2freq_list(chan_list, bv, bts); |
| 219 | } |
| 220 | |
| 221 | static int generate_si1(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 222 | { |
| 223 | int rc; |
| 224 | struct gsm48_system_information_type_1 *si1 = |
| 225 | (struct gsm48_system_information_type_1 *) output; |
| 226 | |
| 227 | memset(si1, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 228 | |
| 229 | si1->header.l2_plen = (21 << 2) | 1; |
| 230 | si1->header.rr_protocol_discriminator = GSM48_PDISC_RR; |
| 231 | si1->header.skip_indicator = 0; |
| 232 | si1->header.system_information = GSM48_MT_RR_SYSINFO_1; |
| 233 | |
| 234 | rc = generate_cell_chan_list(si1->cell_channel_description, bts); |
| 235 | if (rc < 0) |
| 236 | return rc; |
| 237 | |
| 238 | si1->rach_control = bts->si_common.rach_control; |
| 239 | |
| 240 | /* SI1 Rest Octets (10.5.2.32), contains NCH position */ |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 241 | rc = rest_octets_si1(si1->rest_octets, NULL); |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 242 | |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 243 | return sizeof(*si1) + rc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 244 | } |
| 245 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 246 | static int generate_si2(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 247 | { |
| 248 | int rc; |
| 249 | struct gsm48_system_information_type_2 *si2 = |
| 250 | (struct gsm48_system_information_type_2 *) output; |
| 251 | |
| 252 | memset(si2, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 253 | |
| 254 | si2->header.l2_plen = (22 << 2) | 1; |
| 255 | si2->header.rr_protocol_discriminator = GSM48_PDISC_RR; |
| 256 | si2->header.skip_indicator = 0; |
| 257 | si2->header.system_information = GSM48_MT_RR_SYSINFO_2; |
| 258 | |
| 259 | rc = generate_bcch_chan_list(si2->bcch_frequency_list, bts); |
| 260 | if (rc < 0) |
| 261 | return rc; |
| 262 | |
| 263 | si2->ncc_permitted = bts->si_common.ncc_permitted; |
| 264 | si2->rach_control = bts->si_common.rach_control; |
| 265 | |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 266 | return sizeof(*si2); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 267 | } |
| 268 | |
Harald Welte | 1f89329 | 2010-03-14 23:46:48 +0800 | [diff] [blame] | 269 | static struct gsm48_si_ro_info si_info = { |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 270 | .selection_params = { |
| 271 | .present = 0, |
| 272 | }, |
| 273 | .power_offset = { |
| 274 | .present = 0, |
| 275 | }, |
| 276 | .si2ter_indicator = 0, |
| 277 | .early_cm_ctrl = 1, |
| 278 | .scheduling = { |
| 279 | .present = 0, |
| 280 | }, |
| 281 | .gprs_ind = { |
| 282 | .si13_position = 0, |
| 283 | .ra_colour = 0, |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 284 | .present = 1, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 285 | }, |
| 286 | .lsa_params = { |
| 287 | .present = 0, |
| 288 | }, |
| 289 | .cell_id = 0, /* FIXME: doesn't the bts have this? */ |
| 290 | .break_ind = 0, |
| 291 | }; |
| 292 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 293 | static int generate_si3(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 294 | { |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 295 | int rc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 296 | struct gsm48_system_information_type_3 *si3 = |
| 297 | (struct gsm48_system_information_type_3 *) output; |
| 298 | |
| 299 | memset(si3, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 300 | |
| 301 | si3->header.l2_plen = (18 << 2) | 1; |
| 302 | si3->header.rr_protocol_discriminator = GSM48_PDISC_RR; |
| 303 | si3->header.skip_indicator = 0; |
| 304 | si3->header.system_information = GSM48_MT_RR_SYSINFO_3; |
| 305 | |
| 306 | si3->cell_identity = htons(bts->cell_identity); |
Harald Welte | afedeab | 2010-03-04 10:55:40 +0100 | [diff] [blame] | 307 | gsm48_generate_lai(&si3->lai, bts->network->country_code, |
| 308 | bts->network->network_code, |
| 309 | bts->location_area_code); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 310 | si3->control_channel_desc = bts->si_common.chan_desc; |
| 311 | si3->cell_options = bts->si_common.cell_options; |
| 312 | si3->cell_sel_par = bts->si_common.cell_sel_par; |
| 313 | si3->rach_control = bts->si_common.rach_control; |
| 314 | |
| 315 | /* SI3 Rest Octets (10.5.2.34), containing |
| 316 | CBQ, CELL_RESELECT_OFFSET, TEMPORARY_OFFSET, PENALTY_TIME |
| 317 | Power Offset, 2ter Indicator, Early Classmark Sending, |
| 318 | Scheduling if and WHERE, GPRS Indicator, SI13 position */ |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 319 | rc = rest_octets_si3(si3->rest_octets, &si_info); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 320 | |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 321 | return sizeof(*si3) + rc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 322 | } |
| 323 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 324 | static int generate_si4(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 325 | { |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 326 | int rc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 327 | struct gsm48_system_information_type_4 *si4 = |
| 328 | (struct gsm48_system_information_type_4 *) output; |
| 329 | |
| 330 | /* length of all IEs present except SI4 rest octets and l2_plen */ |
| 331 | int l2_plen = sizeof(*si4) - 1; |
| 332 | |
| 333 | memset(si4, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 334 | |
| 335 | si4->header.rr_protocol_discriminator = GSM48_PDISC_RR; |
| 336 | si4->header.skip_indicator = 0; |
| 337 | si4->header.system_information = GSM48_MT_RR_SYSINFO_4; |
| 338 | |
Harald Welte | afedeab | 2010-03-04 10:55:40 +0100 | [diff] [blame] | 339 | gsm48_generate_lai(&si4->lai, bts->network->country_code, |
| 340 | bts->network->network_code, |
| 341 | bts->location_area_code); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 342 | si4->cell_sel_par = bts->si_common.cell_sel_par; |
| 343 | si4->rach_control = bts->si_common.rach_control; |
| 344 | |
| 345 | /* Optional: CBCH Channel Description + CBCH Mobile Allocation */ |
| 346 | |
| 347 | si4->header.l2_plen = (l2_plen << 2) | 1; |
| 348 | |
| 349 | /* SI4 Rest Octets (10.5.2.35), containing |
| 350 | Optional Power offset, GPRS Indicator, |
| 351 | Cell Identity, LSA ID, Selection Parameter */ |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 352 | rc = rest_octets_si4(si4->data, &si_info); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 353 | |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 354 | return sizeof(*si4) + rc; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 355 | } |
| 356 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 357 | static int generate_si5(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 358 | { |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 359 | struct gsm48_system_information_type_5 *si5; |
| 360 | int rc, l2_plen = 18; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 361 | |
Holger Hans Peter Freyther | 17d81e2 | 2010-01-06 07:52:55 +0100 | [diff] [blame] | 362 | memset(output, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 363 | |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 364 | /* ip.access nanoBTS needs l2_plen!! */ |
| 365 | if (is_ipaccess_bts(bts)) { |
| 366 | *output++ = (l2_plen << 2) | 1; |
| 367 | l2_plen++; |
| 368 | } |
| 369 | |
| 370 | si5 = (struct gsm48_system_information_type_5 *) output; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 371 | |
| 372 | /* l2 pseudo length, not part of msg: 18 */ |
| 373 | si5->rr_protocol_discriminator = GSM48_PDISC_RR; |
| 374 | si5->skip_indicator = 0; |
| 375 | si5->system_information = GSM48_MT_RR_SYSINFO_5; |
| 376 | rc = generate_bcch_chan_list(si5->bcch_frequency_list, bts); |
| 377 | if (rc < 0) |
| 378 | return rc; |
| 379 | |
| 380 | /* 04.08 9.1.37: L2 Pseudo Length of 18 */ |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 381 | return l2_plen; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 382 | } |
| 383 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 384 | static int generate_si6(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 385 | { |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 386 | struct gsm48_system_information_type_6 *si6; |
| 387 | int l2_plen = 11; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 388 | |
Holger Hans Peter Freyther | 17d81e2 | 2010-01-06 07:52:55 +0100 | [diff] [blame] | 389 | memset(output, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 390 | |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 391 | /* ip.access nanoBTS needs l2_plen!! */ |
| 392 | if (is_ipaccess_bts(bts)) { |
| 393 | *output++ = (l2_plen << 2) | 1; |
| 394 | l2_plen++; |
| 395 | } |
| 396 | |
| 397 | si6 = (struct gsm48_system_information_type_6 *) output; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 398 | |
| 399 | /* l2 pseudo length, not part of msg: 11 */ |
| 400 | si6->rr_protocol_discriminator = GSM48_PDISC_RR; |
| 401 | si6->skip_indicator = 0; |
| 402 | si6->system_information = GSM48_MT_RR_SYSINFO_6; |
| 403 | si6->cell_identity = htons(bts->cell_identity); |
Harald Welte | afedeab | 2010-03-04 10:55:40 +0100 | [diff] [blame] | 404 | gsm48_generate_lai(&si6->lai, bts->network->country_code, |
| 405 | bts->network->network_code, |
| 406 | bts->location_area_code); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 407 | si6->cell_options = bts->si_common.cell_options; |
| 408 | si6->ncc_permitted = bts->si_common.ncc_permitted; |
| 409 | |
| 410 | /* SI6 Rest Octets: 10.5.2.35a: PCH / NCH info, VBS/VGCS options */ |
| 411 | |
Harald Welte | e2d0d5f | 2009-12-19 21:26:54 +0100 | [diff] [blame] | 412 | return l2_plen; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 413 | } |
| 414 | |
| 415 | static struct gsm48_si13_info si13_default = { |
| 416 | .cell_opts = { |
Harald Welte | 8584918 | 2010-06-02 12:19:21 +0200 | [diff] [blame] | 417 | .nmo = GPRS_NMO_II, |
Harald Welte | a4b1665 | 2010-05-31 12:54:23 +0200 | [diff] [blame] | 418 | .t3168 = 2000, |
| 419 | .t3192 = 200, |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 420 | .drx_timer_max = 3, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 421 | .bs_cv_max = 15, |
Harald Welte | a4b1665 | 2010-05-31 12:54:23 +0200 | [diff] [blame] | 422 | .ext_info_present = 1, |
Harald Welte | da0586a | 2010-04-18 14:49:05 +0200 | [diff] [blame] | 423 | .ext_info = { |
| 424 | /* The values below are just guesses ! */ |
Harald Welte | a06fea0 | 2010-04-18 15:53:40 +0200 | [diff] [blame] | 425 | .egprs_supported = 0, |
Harald Welte | da0586a | 2010-04-18 14:49:05 +0200 | [diff] [blame] | 426 | .use_egprs_p_ch_req = 1, |
Harald Welte | a4b1665 | 2010-05-31 12:54:23 +0200 | [diff] [blame] | 427 | .bep_period = 5, |
Harald Welte | da0586a | 2010-04-18 14:49:05 +0200 | [diff] [blame] | 428 | .pfc_supported = 0, |
| 429 | .dtm_supported = 0, |
| 430 | .bss_paging_coordination = 0, |
| 431 | }, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 432 | }, |
| 433 | .pwr_ctrl_pars = { |
| 434 | .alpha = 10, /* a = 1.0 */ |
Harald Welte | a4b1665 | 2010-05-31 12:54:23 +0200 | [diff] [blame] | 435 | .t_avg_w = 16, |
| 436 | .t_avg_t = 16, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 437 | .pc_meas_chan = 0, /* downling measured on CCCH */ |
Harald Welte | a4b1665 | 2010-05-31 12:54:23 +0200 | [diff] [blame] | 438 | .n_avg_i = 8, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 439 | }, |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 440 | .bcch_change_mark = 1, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 441 | .si_change_field = 0, |
| 442 | .pbcch_present = 0, |
| 443 | { |
| 444 | .no_pbcch = { |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 445 | .rac = 0, /* needs to be patched */ |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 446 | .spgc_ccch_sup = 0, |
| 447 | .net_ctrl_ord = 0, |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 448 | .prio_acc_thr = 6, |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 449 | }, |
| 450 | }, |
| 451 | }; |
| 452 | |
Harald Welte | 6c40def | 2009-12-14 22:07:14 +0100 | [diff] [blame] | 453 | static int generate_si13(u_int8_t *output, struct gsm_bts *bts) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 454 | { |
| 455 | struct gsm48_system_information_type_13 *si13 = |
| 456 | (struct gsm48_system_information_type_13 *) output; |
| 457 | int ret; |
| 458 | |
| 459 | memset(si13, GSM_MACBLOCK_PADDING, GSM_MACBLOCK_LEN); |
| 460 | |
| 461 | si13->header.rr_protocol_discriminator = GSM48_PDISC_RR; |
| 462 | si13->header.skip_indicator = 0; |
| 463 | si13->header.system_information = GSM48_MT_RR_SYSINFO_13; |
| 464 | |
Harald Welte | 97a282b | 2010-03-14 15:37:43 +0800 | [diff] [blame] | 465 | si13_default.no_pbcch.rac = bts->gprs.rac; |
| 466 | |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 467 | ret = rest_octets_si13(si13->rest_octets, &si13_default); |
| 468 | if (ret < 0) |
| 469 | return ret; |
| 470 | |
Holger Hans Peter Freyther | 1c6f394 | 2010-06-16 12:05:56 +0800 | [diff] [blame] | 471 | /* length is coded in bit 2 an up */ |
| 472 | si13->header.l2_plen = 0x01; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 473 | |
Holger Hans Peter Freyther | 7ec448d | 2010-01-06 07:52:31 +0100 | [diff] [blame] | 474 | return sizeof (*si13) + ret; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 475 | } |
| 476 | |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 477 | static const uint8_t sitype2rsl[_MAX_SYSINFO_TYPE] = { |
| 478 | [SYSINFO_TYPE_1] = RSL_SYSTEM_INFO_1, |
| 479 | [SYSINFO_TYPE_2] = RSL_SYSTEM_INFO_2, |
| 480 | [SYSINFO_TYPE_3] = RSL_SYSTEM_INFO_3, |
| 481 | [SYSINFO_TYPE_4] = RSL_SYSTEM_INFO_4, |
| 482 | [SYSINFO_TYPE_5] = RSL_SYSTEM_INFO_5, |
| 483 | [SYSINFO_TYPE_6] = RSL_SYSTEM_INFO_6, |
| 484 | [SYSINFO_TYPE_7] = RSL_SYSTEM_INFO_7, |
| 485 | [SYSINFO_TYPE_8] = RSL_SYSTEM_INFO_8, |
| 486 | [SYSINFO_TYPE_9] = RSL_SYSTEM_INFO_9, |
| 487 | [SYSINFO_TYPE_10] = RSL_SYSTEM_INFO_10, |
| 488 | [SYSINFO_TYPE_13] = RSL_SYSTEM_INFO_13, |
| 489 | [SYSINFO_TYPE_16] = RSL_SYSTEM_INFO_16, |
| 490 | [SYSINFO_TYPE_17] = RSL_SYSTEM_INFO_17, |
| 491 | [SYSINFO_TYPE_18] = RSL_SYSTEM_INFO_18, |
| 492 | [SYSINFO_TYPE_19] = RSL_SYSTEM_INFO_19, |
| 493 | [SYSINFO_TYPE_20] = RSL_SYSTEM_INFO_20, |
| 494 | [SYSINFO_TYPE_2bis] = RSL_SYSTEM_INFO_2bis, |
| 495 | [SYSINFO_TYPE_2ter] = RSL_SYSTEM_INFO_2ter, |
| 496 | [SYSINFO_TYPE_2quater] = RSL_SYSTEM_INFO_2quater, |
| 497 | [SYSINFO_TYPE_5bis] = RSL_SYSTEM_INFO_5bis, |
| 498 | [SYSINFO_TYPE_5ter] = RSL_SYSTEM_INFO_5ter, |
| 499 | }; |
| 500 | |
| 501 | static const uint8_t rsl2sitype[0xff] = { |
| 502 | [RSL_SYSTEM_INFO_1] = SYSINFO_TYPE_1, |
| 503 | [RSL_SYSTEM_INFO_2] = SYSINFO_TYPE_2, |
| 504 | [RSL_SYSTEM_INFO_3] = SYSINFO_TYPE_3, |
| 505 | [RSL_SYSTEM_INFO_4] = SYSINFO_TYPE_4, |
| 506 | [RSL_SYSTEM_INFO_5] = SYSINFO_TYPE_5, |
| 507 | [RSL_SYSTEM_INFO_6] = SYSINFO_TYPE_6, |
Harald Welte | 5f827f4 | 2010-07-30 11:11:38 +0200 | [diff] [blame] | 508 | [RSL_SYSTEM_INFO_7] = SYSINFO_TYPE_7, |
| 509 | [RSL_SYSTEM_INFO_8] = SYSINFO_TYPE_8, |
| 510 | [RSL_SYSTEM_INFO_9] = SYSINFO_TYPE_9, |
| 511 | [RSL_SYSTEM_INFO_10] = SYSINFO_TYPE_10, |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 512 | [RSL_SYSTEM_INFO_13] = SYSINFO_TYPE_13, |
Harald Welte | 5f827f4 | 2010-07-30 11:11:38 +0200 | [diff] [blame] | 513 | [RSL_SYSTEM_INFO_16] = SYSINFO_TYPE_16, |
| 514 | [RSL_SYSTEM_INFO_17] = SYSINFO_TYPE_17, |
| 515 | [RSL_SYSTEM_INFO_18] = SYSINFO_TYPE_18, |
| 516 | [RSL_SYSTEM_INFO_19] = SYSINFO_TYPE_19, |
| 517 | [RSL_SYSTEM_INFO_20] = SYSINFO_TYPE_20, |
| 518 | [RSL_SYSTEM_INFO_2bis] = SYSINFO_TYPE_2bis, |
| 519 | [RSL_SYSTEM_INFO_2ter] = SYSINFO_TYPE_2ter, |
| 520 | [RSL_SYSTEM_INFO_2quater] = SYSINFO_TYPE_2quater, |
| 521 | [RSL_SYSTEM_INFO_5bis] = SYSINFO_TYPE_5bis, |
| 522 | [RSL_SYSTEM_INFO_5ter] = SYSINFO_TYPE_5ter, |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 523 | }; |
| 524 | |
| 525 | typedef int (*gen_si_fn_t)(uint8_t *output, struct gsm_bts *bts); |
| 526 | |
| 527 | static const gen_si_fn_t gen_si_fn[_MAX_SYSINFO_TYPE] = { |
| 528 | [SYSINFO_TYPE_1] = &generate_si1, |
| 529 | [SYSINFO_TYPE_2] = &generate_si2, |
| 530 | [SYSINFO_TYPE_3] = &generate_si3, |
| 531 | [SYSINFO_TYPE_4] = &generate_si4, |
| 532 | [SYSINFO_TYPE_5] = &generate_si5, |
| 533 | [SYSINFO_TYPE_6] = &generate_si6, |
| 534 | [SYSINFO_TYPE_13] = &generate_si13, |
| 535 | }; |
| 536 | |
Harald Welte | 5f827f4 | 2010-07-30 11:11:38 +0200 | [diff] [blame] | 537 | const struct value_string osmo_sitype_strs[_MAX_SYSINFO_TYPE] = { |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 538 | { SYSINFO_TYPE_1, "1" }, |
| 539 | { SYSINFO_TYPE_2, "2" }, |
| 540 | { SYSINFO_TYPE_3, "3" }, |
| 541 | { SYSINFO_TYPE_4, "4" }, |
| 542 | { SYSINFO_TYPE_5, "5" }, |
| 543 | { SYSINFO_TYPE_6, "6" }, |
| 544 | { SYSINFO_TYPE_7, "7" }, |
| 545 | { SYSINFO_TYPE_8, "8" }, |
| 546 | { SYSINFO_TYPE_9, "9" }, |
| 547 | { SYSINFO_TYPE_10, "10" }, |
| 548 | { SYSINFO_TYPE_13, "13" }, |
| 549 | { SYSINFO_TYPE_16, "16" }, |
| 550 | { SYSINFO_TYPE_17, "17" }, |
| 551 | { SYSINFO_TYPE_18, "18" }, |
| 552 | { SYSINFO_TYPE_19, "19" }, |
| 553 | { SYSINFO_TYPE_20, "20" }, |
| 554 | { SYSINFO_TYPE_2bis, "2bis" }, |
| 555 | { SYSINFO_TYPE_2ter, "2ter" }, |
| 556 | { SYSINFO_TYPE_2quater, "2quater" }, |
| 557 | { SYSINFO_TYPE_5bis, "5bis" }, |
| 558 | { SYSINFO_TYPE_5ter, "5ter" }, |
| 559 | { 0, NULL } |
| 560 | }; |
| 561 | |
| 562 | uint8_t gsm_sitype2rsl(enum osmo_sysinfo_type si_type) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 563 | { |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 564 | return sitype2rsl[si_type]; |
| 565 | } |
| 566 | |
| 567 | const char *gsm_sitype_name(enum osmo_sysinfo_type si_type) |
| 568 | { |
Harald Welte | 5f827f4 | 2010-07-30 11:11:38 +0200 | [diff] [blame] | 569 | return get_value_string(osmo_sitype_strs, si_type); |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 570 | } |
| 571 | |
| 572 | int gsm_generate_si(struct gsm_bts *bts, enum osmo_sysinfo_type si_type) |
| 573 | { |
| 574 | gen_si_fn_t gen_si; |
| 575 | |
Harald Welte | 4511d89 | 2010-04-18 15:51:20 +0200 | [diff] [blame] | 576 | switch (bts->gprs.mode) { |
| 577 | case BTS_GPRS_EGPRS: |
Harald Welte | a06fea0 | 2010-04-18 15:53:40 +0200 | [diff] [blame] | 578 | si13_default.cell_opts.ext_info_present = 1; |
| 579 | si13_default.cell_opts.ext_info.egprs_supported = 1; |
| 580 | /* fallthrough */ |
Harald Welte | 4511d89 | 2010-04-18 15:51:20 +0200 | [diff] [blame] | 581 | case BTS_GPRS_GPRS: |
| 582 | si_info.gprs_ind.present = 1; |
| 583 | break; |
| 584 | case BTS_GPRS_NONE: |
| 585 | si_info.gprs_ind.present = 0; |
| 586 | break; |
| 587 | } |
Harald Welte | 1f89329 | 2010-03-14 23:46:48 +0800 | [diff] [blame] | 588 | |
Sylvain Munaut | e0b06b0 | 2010-11-28 18:17:28 +0100 | [diff] [blame] | 589 | memcpy(&si_info.selection_params, |
| 590 | &bts->si_common.cell_ro_sel_par, |
| 591 | sizeof(struct gsm48_si_selection_params)); |
| 592 | |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 593 | gen_si = gen_si_fn[si_type]; |
| 594 | if (!gen_si) |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 595 | return -EINVAL; |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 596 | |
Harald Welte | 7401ae6 | 2010-06-15 16:44:12 +0200 | [diff] [blame] | 597 | return gen_si(bts->si_buf[si_type], bts); |
Harald Welte | a43f789 | 2009-12-01 18:04:30 +0530 | [diff] [blame] | 598 | } |