Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 1 | /* TRAU frame handling according to GSM TS 08.60 */ |
| 2 | |
| 3 | /* (C) 2009 by Harald Welte <laforge@gnumonks.org> |
| 4 | * All Rights Reserved |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or modify |
| 7 | * it under the terms of the GNU Affero General Public License as published by |
| 8 | * the Free Software Foundation; either version 3 of the License, or |
| 9 | * (at your option) any later version. |
| 10 | * |
| 11 | * This program is distributed in the hope that it will be useful, |
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 | * GNU Affero General Public License for more details. |
| 15 | * |
| 16 | * You should have received a copy of the GNU Affero General Public License |
| 17 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 18 | * |
| 19 | */ |
| 20 | #include "internal.h" |
| 21 | |
| 22 | #include <unistd.h> |
| 23 | #include <stdlib.h> |
| 24 | #include <stdio.h> |
| 25 | #include <string.h> |
| 26 | #include <errno.h> |
| 27 | |
Pablo Neira Ayuso | 177094b | 2011-06-07 12:21:51 +0200 | [diff] [blame] | 28 | #include <osmocom/abis/trau_frame.h> |
| 29 | #include <osmocom/abis/subchan_demux.h> |
Pablo Neira Ayuso | 7b2d18b | 2011-06-05 18:38:43 +0200 | [diff] [blame] | 30 | #include <osmocom/core/logging.h> |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 31 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 32 | /*! \addtogroup trau_frame |
| 33 | * @{ |
| 34 | * |
| 35 | * \file trau_frame.c |
| 36 | */ |
| 37 | |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 38 | static uint32_t get_bits(const uint8_t *bitbuf, int offset, int num) |
| 39 | { |
| 40 | int i; |
| 41 | uint32_t ret = 0; |
| 42 | |
| 43 | for (i = offset; i < offset + num; i++) { |
| 44 | ret = ret << 1; |
| 45 | if (bitbuf[i]) |
| 46 | ret |= 1; |
| 47 | } |
| 48 | return ret; |
| 49 | } |
| 50 | |
| 51 | /* Decode according to 3.1.1 */ |
| 52 | static void decode_fr(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| 53 | { |
| 54 | int i; |
| 55 | int d_idx = 0; |
| 56 | |
| 57 | /* C1 .. C15 */ |
| 58 | memcpy(fr->c_bits+0, trau_bits+17, 15); |
| 59 | /* C16 .. C21 */ |
| 60 | memcpy(fr->c_bits+15, trau_bits+310, 6); |
| 61 | /* T1 .. T4 */ |
| 62 | memcpy(fr->t_bits+0, trau_bits+316, 4); |
| 63 | /* D1 .. D255 */ |
| 64 | for (i = 32; i < 304; i+= 16) { |
| 65 | memcpy(fr->d_bits + d_idx, trau_bits+i+1, 15); |
| 66 | d_idx += 15; |
| 67 | } |
| 68 | /* D256 .. D260 */ |
| 69 | memcpy(fr->d_bits + d_idx, trau_bits + 305, 5); |
| 70 | } |
| 71 | |
| 72 | /* Decode according to 3.1.2 */ |
| 73 | static void decode_amr(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| 74 | { |
| 75 | int i; |
| 76 | int d_idx = 0; |
| 77 | |
| 78 | /* C1 .. C15 */ |
| 79 | memcpy(fr->c_bits+0, trau_bits+17, 15); |
| 80 | /* C16 .. C25 */ |
| 81 | memcpy(fr->c_bits+15, trau_bits+33, 10); |
| 82 | /* T1 .. T4 */ |
| 83 | memcpy(fr->t_bits+0, trau_bits+316, 4); |
| 84 | /* D1 .. D5 */ |
| 85 | memcpy(fr->d_bits, trau_bits+43, 5); |
| 86 | /* D6 .. D245 */ |
| 87 | for (i = 48; i < 304; i += 16) { |
| 88 | memcpy(fr->d_bits + d_idx, trau_bits+i+1, 15); |
| 89 | d_idx += 15; |
| 90 | } |
| 91 | /* D246 .. D256 */ |
| 92 | memcpy(fr->d_bits + d_idx, trau_bits + 305, 11); |
| 93 | } |
| 94 | |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 95 | static void decode_data(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| 96 | { |
| 97 | /* C1 .. C15 */ |
| 98 | memcpy(fr->c_bits+0, trau_bits+17, 15); |
| 99 | /* octets 4 .. 39 */ |
| 100 | memcpy(fr->d_bits, trau_bits+32, 288); |
| 101 | } |
| 102 | |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 103 | int decode_trau_frame(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| 104 | { |
| 105 | uint8_t cbits5 = get_bits(trau_bits, 17, 5); |
| 106 | |
| 107 | switch (cbits5) { |
| 108 | case TRAU_FT_FR_UP: |
| 109 | case TRAU_FT_FR_DOWN: |
| 110 | case TRAU_FT_IDLE_UP: |
| 111 | case TRAU_FT_IDLE_DOWN: |
| 112 | case TRAU_FT_EFR: |
| 113 | decode_fr(fr, trau_bits); |
| 114 | break; |
| 115 | case TRAU_FT_AMR: |
| 116 | decode_amr(fr, trau_bits); |
| 117 | break; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 118 | case TRAU_FT_DATA_UP: |
| 119 | case TRAU_FT_DATA_DOWN: |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 120 | decode_data(fr, trau_bits); |
| 121 | break; |
| 122 | case TRAU_FT_OM_UP: |
| 123 | case TRAU_FT_OM_DOWN: |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 124 | case TRAU_FT_D145_SYNC: |
| 125 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 126 | LOGP(DLMUX, LOGL_NOTICE, "can't decode unimplemented TRAU " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 127 | "Frame Type 0x%02x\n", cbits5); |
| 128 | return -1; |
| 129 | break; |
| 130 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 131 | LOGP(DLMUX, LOGL_NOTICE, "can't decode unknown TRAU " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 132 | "Frame Type 0x%02x\n", cbits5); |
| 133 | return -1; |
| 134 | break; |
| 135 | } |
| 136 | |
| 137 | return 0; |
| 138 | } |
| 139 | |
| 140 | const uint8_t ft_fr_down_bits[] = { 1, 1, 1, 0, 0 }; |
| 141 | const uint8_t ft_idle_down_bits[] = { 0, 1, 1, 1, 0 }; |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 142 | const uint8_t ft_data_down_bits[] = { 1, 0, 1, 1, 0 }; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 143 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 144 | /*! \brief modify an uplink TRAU frame so we can send it downlink |
| 145 | * \param[in,out] fr the uplink TRAU frame that is to be converted |
| 146 | * \returns 0 in case of success, < 0 in caes of error |
| 147 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 148 | int trau_frame_up2down(struct decoded_trau_frame *fr) |
| 149 | { |
| 150 | uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| 151 | |
| 152 | switch (cbits5) { |
| 153 | case TRAU_FT_FR_UP: |
| 154 | memcpy(fr->c_bits, ft_fr_down_bits, 5); |
| 155 | /* clear time alignment */ |
| 156 | memset(fr->c_bits+5, 0, 6); |
| 157 | /* FIXME: SP / BFI in case of DTx */ |
| 158 | /* C12 .. C21 are spare and coded as '1' */ |
| 159 | memset(fr->c_bits+11, 0x01, 10); |
| 160 | break; |
| 161 | case TRAU_FT_EFR: |
| 162 | /* clear time alignment */ |
| 163 | memset(fr->c_bits+5, 0, 6); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 164 | /* set UFE appropriately */ |
| 165 | fr->c_bits[11] = 1; /* C12 (UFE), good frame (TODO) */ |
| 166 | /* C13 .. C15 are spare and coded as '1' */ |
| 167 | memset(fr->c_bits+12, 0x01, 3); |
| 168 | /* SP / BFI in case of DTx */ |
| 169 | fr->c_bits[15] = 1; /* C16 (SP), no DTX (TODO) */ |
| 170 | /* C17 .. C21 are spare and coded as '1' */ |
| 171 | memset(fr->c_bits+16, 0x01, 5); |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 172 | break; |
| 173 | case TRAU_FT_IDLE_UP: |
| 174 | memcpy(fr->c_bits, ft_idle_down_bits, 5); |
| 175 | /* clear time alignment */ |
| 176 | memset(fr->c_bits+5, 0, 6); |
| 177 | /* FIXME: SP / BFI in case of DTx */ |
| 178 | /* C12 .. C21 are spare and coded as '1' */ |
| 179 | memset(fr->c_bits+11, 0x01, 10); |
| 180 | break; |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 181 | case TRAU_FT_DATA_UP: |
| 182 | memcpy(fr->c_bits, ft_data_down_bits, 5); |
| 183 | break; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 184 | case TRAU_FT_FR_DOWN: |
| 185 | case TRAU_FT_IDLE_DOWN: |
| 186 | case TRAU_FT_OM_DOWN: |
| 187 | case TRAU_FT_DATA_DOWN: |
| 188 | /* we cannot convert a downlink to a downlink frame */ |
| 189 | return -EINVAL; |
| 190 | break; |
| 191 | case TRAU_FT_AMR: |
| 192 | case TRAU_FT_OM_UP: |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 193 | case TRAU_FT_D145_SYNC: |
| 194 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 195 | LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 196 | "0x%02x\n", cbits5); |
| 197 | return -1; |
| 198 | break; |
| 199 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 200 | LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 201 | "0x%02x\n", cbits5); |
| 202 | return -1; |
| 203 | break; |
| 204 | } |
| 205 | |
| 206 | return 0; |
| 207 | |
| 208 | } |
| 209 | |
| 210 | static void encode_fr(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| 211 | { |
| 212 | int i; |
| 213 | int d_idx = 0; |
| 214 | |
| 215 | trau_bits[16] = 1; |
| 216 | /* C1 .. C15 */ |
| 217 | memcpy(trau_bits+17, fr->c_bits+0, 15); |
| 218 | /* D1 .. D255 */ |
| 219 | for (i = 32; i < 304; i+= 16) { |
| 220 | trau_bits[i] = 1; |
| 221 | memcpy(trau_bits+i+1, fr->d_bits + d_idx, 15); |
| 222 | d_idx += 15; |
| 223 | } |
| 224 | /* D256 .. D260 */ |
| 225 | trau_bits[304] = 1; |
| 226 | memcpy(trau_bits + 305, fr->d_bits + d_idx, 5); |
| 227 | /* C16 .. C21 */ |
| 228 | memcpy(trau_bits+310, fr->c_bits+15, 6); |
| 229 | |
| 230 | /* FIXME: handle timing adjustment */ |
| 231 | |
| 232 | /* T1 .. T4 */ |
| 233 | memcpy(trau_bits+316, fr->t_bits+0, 4); |
| 234 | } |
| 235 | |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 236 | static void encode_data(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| 237 | { |
| 238 | trau_bits[16] = 1; |
| 239 | /* C1 .. C15 */ |
| 240 | memcpy(trau_bits+17, fr->c_bits+0, 15); |
| 241 | /* octets 4 .. 39 */ |
| 242 | memcpy(trau_bits+32, fr->d_bits, 288); |
| 243 | } |
| 244 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 245 | /*! \brief encode a TRAU frame from the decoded bits |
| 246 | * \param[out] trau_bits output buffer, will contain encoded bits |
| 247 | * \param[in] fr decoded trau frame structure |
| 248 | * \returns 0 in case of success, < 0 in case of error |
| 249 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 250 | int encode_trau_frame(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| 251 | { |
| 252 | uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| 253 | |
| 254 | /* 16 bits of sync header */ |
| 255 | memset(trau_bits, 0, 16); |
| 256 | |
| 257 | switch (cbits5) { |
| 258 | case TRAU_FT_FR_UP: |
| 259 | case TRAU_FT_FR_DOWN: |
| 260 | case TRAU_FT_IDLE_UP: |
| 261 | case TRAU_FT_IDLE_DOWN: |
| 262 | case TRAU_FT_EFR: |
| 263 | encode_fr(trau_bits, fr); |
| 264 | break; |
Tobias Engel | f684976 | 2012-10-08 23:06:44 +0200 | [diff] [blame] | 265 | case TRAU_FT_DATA_UP: |
| 266 | case TRAU_FT_DATA_DOWN: |
| 267 | encode_data(trau_bits, fr); |
| 268 | break; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 269 | case TRAU_FT_AMR: |
| 270 | case TRAU_FT_OM_UP: |
| 271 | case TRAU_FT_OM_DOWN: |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 272 | case TRAU_FT_D145_SYNC: |
| 273 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 274 | LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 275 | "0x%02x\n", cbits5); |
| 276 | return -1; |
| 277 | break; |
| 278 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 279 | LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 280 | "0x%02x\n", cbits5); |
| 281 | return -1; |
| 282 | break; |
| 283 | } |
| 284 | |
| 285 | return 0; |
| 286 | } |
| 287 | |
| 288 | static struct decoded_trau_frame fr_idle_frame = { |
| 289 | .c_bits = { 0, 1, 1, 1, 0 }, /* IDLE DOWNLINK 3.5.5 */ |
| 290 | .t_bits = { 1, 1, 1, 1 }, |
| 291 | }; |
| 292 | static uint8_t encoded_idle_frame[TRAU_FRAME_BITS]; |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 293 | static int dbits_initted = 0; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 294 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 295 | /*! \brief return pointer to global buffer containing a TRAU idle frame |
| 296 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 297 | uint8_t *trau_idle_frame(void) |
| 298 | { |
| 299 | /* only initialize during the first call */ |
| 300 | if (!dbits_initted) { |
| 301 | /* set all D-bits to 1 */ |
| 302 | memset(&fr_idle_frame.d_bits, 0x01, 260); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 303 | |
| 304 | memset(&fr_idle_frame.c_bits, 0x01, 25); /* spare are set to 1 */ |
| 305 | /* set Downlink Idle Speech Frame pattern */ |
| 306 | fr_idle_frame.c_bits[0] = 0; /* C1 */ |
| 307 | fr_idle_frame.c_bits[1] = 1; /* C2 */ |
| 308 | fr_idle_frame.c_bits[2] = 1; /* C3 */ |
| 309 | fr_idle_frame.c_bits[3] = 1; /* C4 */ |
| 310 | fr_idle_frame.c_bits[4] = 0; /* C5 */ |
| 311 | /* set no Time Alignment pattern */ |
| 312 | fr_idle_frame.c_bits[5] = 0; /* C6 */ |
| 313 | fr_idle_frame.c_bits[6] = 0; /* C7 */ |
| 314 | fr_idle_frame.c_bits[7] = 0; /* C8 */ |
| 315 | fr_idle_frame.c_bits[8] = 0; /* C9 */ |
| 316 | fr_idle_frame.c_bits[9] = 0; /* C10 */ |
| 317 | fr_idle_frame.c_bits[10] = 0; /* C11 */ |
| 318 | /* already set to 1, but maybe we need to modify it in the future */ |
| 319 | fr_idle_frame.c_bits[11] = 1; /* C12 (UFE), good frame */ |
| 320 | fr_idle_frame.c_bits[15] = 1; /* C16 (SP), no DTX */ |
| 321 | |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 322 | encode_fr(encoded_idle_frame, &fr_idle_frame); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 323 | dbits_initted = 1; /* set it to 1 to not call it again */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 324 | } |
| 325 | return encoded_idle_frame; |
| 326 | } |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 327 | |
| 328 | /* }@ */ |