Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 1 | /* GSM Radio Signalling Link messages on the A-bis interface |
| 2 | * 3GPP TS 08.58 version 8.6.0 Release 1999 / ETSI TS 100 596 V8.6.0 */ |
| 3 | |
| 4 | /* (C) 2008 by Harald Welte <laforge@gnumonks.org> |
| 5 | * All Rights Reserved |
| 6 | * |
| 7 | * This program is free software; you can redistribute it and/or modify |
| 8 | * it under the terms of the GNU General Public License as published by |
| 9 | * the Free Software Foundation; either version 2 of the License, or |
| 10 | * (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 along |
| 18 | * with this program; if not, write to the Free Software Foundation, Inc., |
| 19 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| 20 | * |
| 21 | */ |
| 22 | |
| 23 | #ifndef _RSL_H |
| 24 | #define _RSL_H |
| 25 | |
| 26 | struct abis_rsl_common_hdr { |
| 27 | u_int8_t msg_discr; |
| 28 | u_int8_t msg_type; |
| 29 | u_int8_t data[0]; |
| 30 | } __attribute__ ((packed)); |
| 31 | |
| 32 | /* Chapter 8.3 */ |
| 33 | struct abis_rsl_rll_hdr { |
| 34 | struct abis_rsl_common_hdr c; |
| 35 | u_int8_t ie_chan; |
| 36 | u_int8_t chan_nr; |
| 37 | u_int8_t ie_link_id; |
| 38 | u_int8_t link_id; |
| 39 | u_int8_t data[0]; |
| 40 | } __attribute__ ((packed)); |
| 41 | |
| 42 | /* Chapter 8.3 and 8.4 */ |
| 43 | struct abis_rsl_dchan_hdr { |
| 44 | struct abis_rsl_common_hdr c; |
| 45 | u_int8_t ie_chan; |
| 46 | u_int8_t chan_nr; |
| 47 | u_int8_t data[0]; |
| 48 | } __attribute__ ((packed)); |
| 49 | |
| 50 | |
| 51 | /* Chapter 9.1 */ |
| 52 | #define ABIS_RSL_MDISC_RLL 0x02 |
| 53 | #define ABIS_RSL_MDISC_DED_CHAN 0x08 |
| 54 | #define ABIS_RSL_MDISC_COM_CHAN 0x0c |
| 55 | #define ABIS_RSL_MDISC_TRX 0x10 |
| 56 | #define ABIS_RSL_MDISC_LOC 0x20 |
| 57 | |
| 58 | #define ABIS_RSL_MDISC_IS_TRANSP(x) (x & 0x01) |
| 59 | |
| 60 | /* Chapter 9.2 */ |
| 61 | enum abis_rsl_msgtype { |
| 62 | /* Radio Link Layer Management */ |
| 63 | RSL_MT_DATA_REQ = 0x01, |
| 64 | RSL_MT_DATA_IND, |
| 65 | RSL_MT_ERROR_IND, |
| 66 | RSL_MT_EST_REQ, |
| 67 | RSL_MT_EST_CONF, |
| 68 | RSL_MT_EST_IND, |
| 69 | RSL_MT_REL_REQ, |
| 70 | RSL_MT_REL_CONF, |
| 71 | RSL_MT_REL_IND, |
| 72 | RSL_MT_UNIT_DATA_REQ, |
| 73 | RSL_MT_UNIT_DATA_IND, /* 0x0b */ |
| 74 | |
| 75 | /* Common Channel Management / TRX Management */ |
| 76 | RSL_MT_BCCH_INFO = 0x11, |
| 77 | RSL_MT_CCCH_LOAD_IND, |
| 78 | RSL_MT_CHAN_RQD, |
| 79 | RSL_MT_DELETE_IND, |
| 80 | RSL_MT_PAGING_CMD, |
| 81 | RSL_MT_IMMEDIATE_ASSIGN_CMD, |
| 82 | RSL_MT_SMS_BC_REQ, |
| 83 | /* empty */ |
| 84 | RSL_MT_RF_RES_IND = 0x19, |
| 85 | RSL_MT_SACCH_FILL, |
| 86 | RSL_MT_OVERLOAD, |
| 87 | RSL_MT_ERROR_REPORT, |
| 88 | RSL_MT_SMS_BC_CMD, |
| 89 | RSL_MT_CBCH_LOAD_IND, |
| 90 | RSL_MT_NOT_CMD, /* 0x1f */ |
| 91 | |
| 92 | /* Dedicate Channel Management */ |
| 93 | RSL_MT_CHAN_ACTIV = 0x21, |
| 94 | RSL_MT_CHAN_ACTIV_ACK, |
| 95 | RSL_MT_CHAN_ACTIV_NACK, |
| 96 | RSL_MT_CONN_FAIL, |
| 97 | RSL_MT_DEACTIVATE_SACCH, |
| 98 | RSL_MT_ENCR_CMD, |
| 99 | RSL_MT_HANDO_DET, |
| 100 | RSL_MT_MEAS_RES, |
| 101 | RSL_MT_MODE_MODIFY_REQ, |
| 102 | RSL_MT_MODE_MODIFY_ACK, |
| 103 | RSL_MT_MODE_MODIFY_NACK, |
| 104 | RSL_MT_PHY_CONTEXT_REQ, |
| 105 | RSL_MT_PHY_CONTEXT_CONF, |
| 106 | RSL_MT_RF_CHAN_REL, |
| 107 | RSL_MT_MS_POWER_CONTROL, |
Harald Welte | 8470bf2 | 2008-12-25 23:28:35 +0000 | [diff] [blame] | 108 | RSL_MT_BS_POWER_CONTROL, /* 0x30 */ |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 109 | RSL_MT_PREPROC_CONFIG, |
| 110 | RSL_MT_PREPROC_MEAS_RES, |
| 111 | RSL_MT_RF_CHAN_REL_ACK, |
| 112 | RSL_MT_SACCH_INFO_MODIFY, |
| 113 | RSL_MT_TALKER_DET, |
| 114 | RSL_MT_LISTENER_DET, |
| 115 | RSL_MT_REMOTE_CODEC_CONF_REP, |
| 116 | RSL_MT_RTD_REP, |
| 117 | RSL_MT_PRE_HANDO_NOTIF, |
| 118 | RSL_MT_MR_CODEC_MOD_REQ, |
| 119 | RSL_MT_MR_CODEC_MOD_ACK, |
| 120 | RSL_MT_MR_CODEC_MOD_NACK, |
| 121 | RSL_MT_MR_CODEC_MOD_PER, |
| 122 | RSL_MT_TFO_REP, |
| 123 | RSL_MT_TFO_MOD_REQ, /* 0x3f */ |
| 124 | }; |
| 125 | |
| 126 | /* Chapter 9.3 */ |
| 127 | enum abis_rsl_ie { |
| 128 | RSL_IE_CHAN_NR = 0x01, |
| 129 | RSL_IE_LINK_IDENT, |
| 130 | RSL_IE_ACT_TYPE, |
| 131 | RSL_IE_BS_POWER, |
| 132 | RSL_IE_CHAN_IDENT, |
| 133 | RSL_IE_CHAN_MODE, |
| 134 | RSL_IE_ENCR_INFO, |
| 135 | RSL_IE_FRAME_NUMBER, |
| 136 | RSL_IE_HANDO_REF, |
| 137 | RSL_IE_L1_INFO, |
| 138 | RSL_IE_L3_INFO, |
| 139 | RSL_IE_MS_IDENTITY, |
| 140 | RSL_IE_MS_POWER, |
| 141 | RSL_IE_PAGING_GROUP, |
| 142 | RSL_IE_PAGING_LOAD, |
| 143 | RSL_IE_PYHS_CONTEXT = 0x10, |
| 144 | RSL_IE_ACCESS_DELAY, |
| 145 | RSL_IE_RACH_LOAD, |
| 146 | RSL_IE_REQ_REFERENCE, |
| 147 | RSL_IE_RELEASE_MODE, |
| 148 | RSL_IE_RESOURCE_INFO, |
| 149 | RSL_IE_RLM_CAUSE, |
| 150 | RSL_IE_STARTNG_TIME, |
| 151 | RSL_IE_TIMING_ADVANCE, |
| 152 | RSL_IE_UPLINK_MEAS, |
| 153 | RSL_IE_CAUSE, |
| 154 | RSL_IE_MEAS_RES_NR, |
| 155 | RSL_IE_MSG_ID, |
| 156 | /* reserved */ |
| 157 | RSL_IE_SYSINFO_TYPE = 0x1e, |
| 158 | RSL_IE_MS_POWER_PARAM, |
| 159 | RSL_IE_BS_POWER_PARAM, |
| 160 | RSL_IE_PREPROC_PARAM, |
| 161 | RSL_IE_PREPROC_MEAS, |
| 162 | RSL_IE_IMM_ASS_INFO, /* Phase 1 (3.6.0), later Full below */ |
| 163 | RSL_IE_SMSCB_INFO = 0x24, |
| 164 | RSL_IE_MS_TIMING_OFFSET, |
| 165 | RSL_IE_ERR_MSG, |
| 166 | RSL_IE_FULL_BCCH_INFO, |
| 167 | RSL_IE_CHAN_NEEDED, |
| 168 | RSL_IE_CB_CMD_TYPE, |
| 169 | RSL_IE_SMSCB_MSG, |
| 170 | RSL_IE_FULL_IMM_ASS_INFO, |
| 171 | RSL_IE_SACCH_INFO, |
| 172 | RSL_IE_CBCH_LOAD_INFO, |
| 173 | RSL_IE_SMSCB_CHAN_INDICATOR, |
| 174 | RSL_IE_GROUP_CALL_REF, |
| 175 | RSL_IE_CHAN_DESC, |
| 176 | RSL_IE_NCH_DRX_INFO, |
| 177 | RSL_IE_CMD_INDICATOR, |
| 178 | RSL_IE_EMLPP_PRIO, |
| 179 | RSL_IE_UIC, |
| 180 | RSL_IE_MAIN_CHAN_REF, |
| 181 | RSL_IE_MR_CONFIG, |
| 182 | RSL_IE_MR_CONTROL, |
| 183 | RSL_IE_SUP_CODEC_TYPES, |
| 184 | RSL_IE_CODEC_CONFIG, |
| 185 | RSL_IE_RTD, |
| 186 | RSL_IE_TFO_STATUS, |
| 187 | RSL_IE_LLP_APDU, |
| 188 | }; |
| 189 | |
| 190 | /* Chapter 9.3.1 */ |
| 191 | #define RSL_CHAN_NR_MASK 0xf8 |
| 192 | #define RSL_CHAN_Bm_ACCHs 0x08 |
| 193 | #define RSL_CHAN_Lm_ACCHs 0x10 /* .. 0x18 */ |
| 194 | #define RSL_CHAN_SDCCH4_ACCH 0x20 /* .. 0x38 */ |
| 195 | #define RSL_CHAN_SDCCH8_ACCH 0x40 /* ...0x78 */ |
| 196 | #define RSL_CHAN_BCCH 0x80 |
| 197 | #define RSL_CHAN_RACH 0x88 |
| 198 | #define RSL_CHAN_PCH_AGCH 0x90 |
| 199 | |
| 200 | /* Chapter 9.3.3 */ |
| 201 | #define RSL_ACT_TYPE_INITIAL 0x00 |
| 202 | #define RSL_ACT_TYPE_REACT 0x80 |
| 203 | #define RSL_ACT_INTRA_IMM_ASS 0x00 |
| 204 | #define RSL_ACT_INTRA_NORM_ASS 0x01 |
| 205 | #define RSL_ACT_INTER_ASYNC 0x02 |
| 206 | #define RSL_ACT_INTER_SYNC 0x03 |
| 207 | #define RSL_ACT_SECOND_ADD 0x04 |
| 208 | #define RSL_ACT_SECOND_MULTI 0x05 |
| 209 | |
| 210 | /* Chapter 9.3.6 */ |
| 211 | struct rsl_ie_chan_mode { |
| 212 | u_int8_t dtx_dtu; |
| 213 | u_int8_t spd_ind; |
| 214 | u_int8_t chan_rt; |
| 215 | u_int8_t chan_rate; |
| 216 | } __attribute__ ((packed)); |
| 217 | #define RSL_CMOD_DTXu 0x01 /* uplink */ |
| 218 | #define RSL_CMOD_DTXd 0x02 /* downlink */ |
| 219 | #define RSL_CMOD_SPD_SPEECH 0x01 |
| 220 | #define RSL_CMOD_SPD_DATA 0x02 |
| 221 | #define RSL_CMOD_SPD_SIGN 0x03 |
| 222 | #define RSL_CMOD_CRT_SDCCH 0x01 |
| 223 | #define RSL_CMOD_CRT_TCH_Bm 0x08 /* full-rate */ |
| 224 | #define RSL_CMOD_CRT_TCH_Lm 0x09 /* half-rate */ |
| 225 | /* FIXME: More CRT types */ |
| 226 | #define RSL_CMOD_SP_GSM1 0x01 |
| 227 | #define RSL_CMOD_SP_GSM2 0x11 |
| 228 | #define RSL_CMOD_SP_GSM3 0x21 |
| 229 | |
| 230 | /* Chapter 9.3.5 */ |
| 231 | struct rsl_ie_chan_ident { |
| 232 | /* GSM 04.08 10.5.2.5 */ |
| 233 | struct { |
| 234 | u_int8_t iei; |
| 235 | u_int8_t chan_nr; /* enc_chan_nr */ |
| 236 | u_int8_t oct3; |
| 237 | u_int8_t oct4; |
| 238 | } chan_desc; |
| 239 | #if 0 /* spec says we need this but Abissim doesn't use it */ |
| 240 | struct { |
| 241 | u_int8_t tag; |
| 242 | u_int8_t len; |
| 243 | } mobile_alloc; |
| 244 | #endif |
| 245 | } __attribute__ ((packed)); |
| 246 | |
Harald Welte | 702d870 | 2008-12-26 20:25:35 +0000 | [diff] [blame] | 247 | /* Chapter 9.3.26 */ |
| 248 | #define RSL_ERRCLS_NORMAL 0x00 |
| 249 | #define RSL_ERRCLS_RESOURCE_UNAVAIL 0x20 |
| 250 | #define RSL_ERRCLS_SERVICE_UNAVAIL 0x30 |
| 251 | #define RSL_ERRCLS_SERVICE_UNIMPL 0x40 |
| 252 | #define RSL_ERRCLS_INVAL_MSG 0x50 |
| 253 | #define RSL_ERRCLS_PROTO_ERROR 0x60 |
| 254 | #define RSL_ERRCLS_INTERWORKING 0x70 |
| 255 | |
| 256 | #define RSL_ERR_RADIO_IF_FAIL 0x00 |
| 257 | #define RSL_ERR_RADIO_LINK_FAIL 0x01 |
| 258 | #define RSL_ERR_HANDOVER_ACC_FAIL 0x02 |
| 259 | #define RSL_ERR_TALKER_ACC_FAIL 0x03 |
| 260 | #define RSL_ERR_OM_INTERVENTION 0x07 |
| 261 | #define RSL_ERR_EQUIPMENT_FAIL 0x20 |
| 262 | #define RSL_ERR_RR_UNAVAIL 0x21 |
| 263 | #define RSL_ERR_TERR_CH_FAIL 0x22 |
| 264 | #define RSL_ERR_CCCH_OVERLOAD 0x23 |
| 265 | #define RSL_ERR_ACCH_OVERLOAD 0x24 |
| 266 | #define RSL_ERR_PROCESSOR_OVERLOAD 0x25 |
| 267 | #define RSL_ERR_RES_UNAVAIL 0x2f |
| 268 | #define RSL_ERR_TRANSC_UNAVAIL 0x30 |
| 269 | #define RSL_ERR_SERV_OPT_UNAVAIL 0x3f |
| 270 | #define RSL_ERR_ENCR_UNIMPL 0x40 |
| 271 | #define RSL_ERR_SEV_OPT_UNIMPL 0x4f |
| 272 | #define RSL_ERR_RCH_ALR_ACTV_ALLOC 0x50 |
| 273 | #define RSL_ERR_INVALID_MESSAGE 0x5f |
| 274 | #define RSL_ERR_MSG_DISCR 0x60 |
| 275 | #define RSL_ERR_MSG_TYPE 0x61 |
| 276 | #define RSL_ERR_MSG_SEQA 0x62 |
| 277 | #define RSL_ERR_IE_ERROR 0x63 |
| 278 | #define RSL_ERR_MAND_IE_ERROR 0x64 |
| 279 | #define RSL_ERR_OPT_IE_ERROR 0x65 |
| 280 | #define RSL_ERR_IE_NONEXIST 0x66 |
| 281 | #define RSL_ERR_IE_LENGTH 0x67 |
| 282 | #define RSL_ERR_IE_CONTENT 0x68 |
| 283 | #define RSL_ERR_PROTO 0x6f |
| 284 | #define RSL_ERR_INTERWORKING 0x7f |
| 285 | |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 286 | /* Chapter 9.3.30 */ |
| 287 | #define RSL_SYSTEM_INFO_8 0x00 |
| 288 | #define RSL_SYSTEM_INFO_1 0x01 |
| 289 | #define RSL_SYSTEM_INFO_2 0x02 |
| 290 | #define RSL_SYSTEM_INFO_3 0x03 |
| 291 | #define RSL_SYSTEM_INFO_4 0x04 |
| 292 | #define RSL_SYSTEM_INFO_5 0x05 |
| 293 | #define RSL_SYSTEM_INFO_6 0x06 |
| 294 | #define RSL_SYSTEM_INFO_7 0x07 |
| 295 | #define RSL_SYSTEM_INFO_16 0x08 |
| 296 | #define RSL_SYSTEM_INFO_17 0x09 |
| 297 | #define RSL_SYSTEM_INFO_2bis 0x0a |
| 298 | #define RSL_SYSTEM_INFO_2ter 0x0b |
| 299 | #define RSL_SYSTEM_INFO_5bis 0x0d |
| 300 | #define RSL_SYSTEM_INFO_5ter 0x0e |
| 301 | #define RSL_SYSTEM_INFO_10 0x0f |
| 302 | #define REL_EXT_MEAS_ORDER 0x47 |
| 303 | #define RSL_MEAS_INFO 0x48 |
| 304 | #define RSL_SYSTEM_INFO_13 0x28 |
| 305 | #define RSL_SYSTEM_INFO_2quater 0x29 |
| 306 | #define RSL_SYSTEM_INFO_9 0x2a |
| 307 | #define RSL_SYSTEM_INFO_18 0x2b |
| 308 | #define RSL_SYSTEM_INFO_19 0x2c |
| 309 | #define RSL_SYSTEM_INFO_20 0x2d |
| 310 | |
| 311 | /* Chapter 9.3.40 */ |
| 312 | #define RSL_CHANNEED_ANY 0x00 |
| 313 | #define RSL_CHANNEED_SDCCH 0x01 |
| 314 | #define RSL_CHANNEED_TCH_F 0x02 |
| 315 | #define RSL_CHANNEED_TCH_ForH 0x03 |
| 316 | |
| 317 | |
| 318 | #include "msgb.h" |
| 319 | |
| 320 | int rsl_bcch_info(struct gsm_bts *bts, u_int8_t type, |
| 321 | const u_int8_t *data, int len); |
| 322 | int rsl_sacch_filling(struct gsm_bts *bts, u_int8_t type, |
| 323 | const u_int8_t *data, int len); |
| 324 | int rsl_chan_activate(struct gsm_bts *bts, u_int8_t chan_nr, |
| 325 | u_int8_t act_type, |
| 326 | struct rsl_ie_chan_mode *chan_mode, |
| 327 | struct rsl_ie_chan_ident *chan_ident, |
| 328 | u_int8_t bs_power, u_int8_t ms_power, |
| 329 | u_int8_t ta); |
| 330 | int rsl_chan_activate_tch_f(struct gsm_bts_trx_ts *ts); |
| 331 | int rsl_chan_activate_sdcch(struct gsm_bts_trx_ts *ts); |
Harald Welte | 8470bf2 | 2008-12-25 23:28:35 +0000 | [diff] [blame] | 332 | int rsl_chan_release(struct gsm_lchan *lchan); |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 333 | int rsl_paging_cmd(struct gsm_bts *bts, u_int8_t paging_group, u_int8_t len, |
| 334 | u_int8_t *ms_ident, u_int8_t chan_needed); |
| 335 | int rsl_paging_cmd_imsi(struct gsm_bts *bts, u_int8_t chan_needed, const char *imsi_str); |
| 336 | int rsl_imm_assign_cmd(struct gsm_bts *bts, u_int8_t len, u_int8_t *val); |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 337 | |
Harald Welte | 8470bf2 | 2008-12-25 23:28:35 +0000 | [diff] [blame] | 338 | int rsl_data_request(struct msgb *msg, u_int8_t link_id); |
| 339 | |
| 340 | int abis_rsl_rcvmsg(struct msgb *msg); |
| 341 | |
| 342 | /* to be provided by external code */ |
| 343 | int abis_rsl_sendmsg(struct msgb *msg); |
Harald Welte | 52b1f98 | 2008-12-23 20:25:15 +0000 | [diff] [blame] | 344 | |
| 345 | #endif /* RSL_MT_H */ |
| 346 | |