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 | |
| 95 | int decode_trau_frame(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| 96 | { |
| 97 | uint8_t cbits5 = get_bits(trau_bits, 17, 5); |
| 98 | |
| 99 | switch (cbits5) { |
| 100 | case TRAU_FT_FR_UP: |
| 101 | case TRAU_FT_FR_DOWN: |
| 102 | case TRAU_FT_IDLE_UP: |
| 103 | case TRAU_FT_IDLE_DOWN: |
| 104 | case TRAU_FT_EFR: |
| 105 | decode_fr(fr, trau_bits); |
| 106 | break; |
| 107 | case TRAU_FT_AMR: |
| 108 | decode_amr(fr, trau_bits); |
| 109 | break; |
| 110 | case TRAU_FT_OM_UP: |
| 111 | case TRAU_FT_OM_DOWN: |
| 112 | case TRAU_FT_DATA_UP: |
| 113 | case TRAU_FT_DATA_DOWN: |
| 114 | case TRAU_FT_D145_SYNC: |
| 115 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 116 | LOGP(DLMUX, LOGL_NOTICE, "can't decode unimplemented TRAU " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 117 | "Frame Type 0x%02x\n", cbits5); |
| 118 | return -1; |
| 119 | break; |
| 120 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 121 | LOGP(DLMUX, LOGL_NOTICE, "can't decode unknown TRAU " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 122 | "Frame Type 0x%02x\n", cbits5); |
| 123 | return -1; |
| 124 | break; |
| 125 | } |
| 126 | |
| 127 | return 0; |
| 128 | } |
| 129 | |
| 130 | const uint8_t ft_fr_down_bits[] = { 1, 1, 1, 0, 0 }; |
| 131 | const uint8_t ft_idle_down_bits[] = { 0, 1, 1, 1, 0 }; |
| 132 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 133 | /*! \brief modify an uplink TRAU frame so we can send it downlink |
| 134 | * \param[in,out] fr the uplink TRAU frame that is to be converted |
| 135 | * \returns 0 in case of success, < 0 in caes of error |
| 136 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 137 | int trau_frame_up2down(struct decoded_trau_frame *fr) |
| 138 | { |
| 139 | uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| 140 | |
| 141 | switch (cbits5) { |
| 142 | case TRAU_FT_FR_UP: |
| 143 | memcpy(fr->c_bits, ft_fr_down_bits, 5); |
| 144 | /* clear time alignment */ |
| 145 | memset(fr->c_bits+5, 0, 6); |
| 146 | /* FIXME: SP / BFI in case of DTx */ |
| 147 | /* C12 .. C21 are spare and coded as '1' */ |
| 148 | memset(fr->c_bits+11, 0x01, 10); |
| 149 | break; |
| 150 | case TRAU_FT_EFR: |
| 151 | /* clear time alignment */ |
| 152 | memset(fr->c_bits+5, 0, 6); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 153 | /* set UFE appropriately */ |
| 154 | fr->c_bits[11] = 1; /* C12 (UFE), good frame (TODO) */ |
| 155 | /* C13 .. C15 are spare and coded as '1' */ |
| 156 | memset(fr->c_bits+12, 0x01, 3); |
| 157 | /* SP / BFI in case of DTx */ |
| 158 | fr->c_bits[15] = 1; /* C16 (SP), no DTX (TODO) */ |
| 159 | /* C17 .. C21 are spare and coded as '1' */ |
| 160 | memset(fr->c_bits+16, 0x01, 5); |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 161 | break; |
| 162 | case TRAU_FT_IDLE_UP: |
| 163 | memcpy(fr->c_bits, ft_idle_down_bits, 5); |
| 164 | /* clear time alignment */ |
| 165 | memset(fr->c_bits+5, 0, 6); |
| 166 | /* FIXME: SP / BFI in case of DTx */ |
| 167 | /* C12 .. C21 are spare and coded as '1' */ |
| 168 | memset(fr->c_bits+11, 0x01, 10); |
| 169 | break; |
| 170 | case TRAU_FT_FR_DOWN: |
| 171 | case TRAU_FT_IDLE_DOWN: |
| 172 | case TRAU_FT_OM_DOWN: |
| 173 | case TRAU_FT_DATA_DOWN: |
| 174 | /* we cannot convert a downlink to a downlink frame */ |
| 175 | return -EINVAL; |
| 176 | break; |
| 177 | case TRAU_FT_AMR: |
| 178 | case TRAU_FT_OM_UP: |
| 179 | case TRAU_FT_DATA_UP: |
| 180 | case TRAU_FT_D145_SYNC: |
| 181 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 182 | LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 183 | "0x%02x\n", cbits5); |
| 184 | return -1; |
| 185 | break; |
| 186 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 187 | LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 188 | "0x%02x\n", cbits5); |
| 189 | return -1; |
| 190 | break; |
| 191 | } |
| 192 | |
| 193 | return 0; |
| 194 | |
| 195 | } |
| 196 | |
| 197 | static void encode_fr(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| 198 | { |
| 199 | int i; |
| 200 | int d_idx = 0; |
| 201 | |
| 202 | trau_bits[16] = 1; |
| 203 | /* C1 .. C15 */ |
| 204 | memcpy(trau_bits+17, fr->c_bits+0, 15); |
| 205 | /* D1 .. D255 */ |
| 206 | for (i = 32; i < 304; i+= 16) { |
| 207 | trau_bits[i] = 1; |
| 208 | memcpy(trau_bits+i+1, fr->d_bits + d_idx, 15); |
| 209 | d_idx += 15; |
| 210 | } |
| 211 | /* D256 .. D260 */ |
| 212 | trau_bits[304] = 1; |
| 213 | memcpy(trau_bits + 305, fr->d_bits + d_idx, 5); |
| 214 | /* C16 .. C21 */ |
| 215 | memcpy(trau_bits+310, fr->c_bits+15, 6); |
| 216 | |
| 217 | /* FIXME: handle timing adjustment */ |
| 218 | |
| 219 | /* T1 .. T4 */ |
| 220 | memcpy(trau_bits+316, fr->t_bits+0, 4); |
| 221 | } |
| 222 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 223 | /*! \brief encode a TRAU frame from the decoded bits |
| 224 | * \param[out] trau_bits output buffer, will contain encoded bits |
| 225 | * \param[in] fr decoded trau frame structure |
| 226 | * \returns 0 in case of success, < 0 in case of error |
| 227 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 228 | int encode_trau_frame(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| 229 | { |
| 230 | uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| 231 | |
| 232 | /* 16 bits of sync header */ |
| 233 | memset(trau_bits, 0, 16); |
| 234 | |
| 235 | switch (cbits5) { |
| 236 | case TRAU_FT_FR_UP: |
| 237 | case TRAU_FT_FR_DOWN: |
| 238 | case TRAU_FT_IDLE_UP: |
| 239 | case TRAU_FT_IDLE_DOWN: |
| 240 | case TRAU_FT_EFR: |
| 241 | encode_fr(trau_bits, fr); |
| 242 | break; |
| 243 | case TRAU_FT_AMR: |
| 244 | case TRAU_FT_OM_UP: |
| 245 | case TRAU_FT_OM_DOWN: |
| 246 | case TRAU_FT_DATA_UP: |
| 247 | case TRAU_FT_DATA_DOWN: |
| 248 | case TRAU_FT_D145_SYNC: |
| 249 | case TRAU_FT_EDATA: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 250 | LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 251 | "0x%02x\n", cbits5); |
| 252 | return -1; |
| 253 | break; |
| 254 | default: |
Harald Welte | cc2241b | 2011-07-19 16:06:06 +0200 | [diff] [blame] | 255 | LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 256 | "0x%02x\n", cbits5); |
| 257 | return -1; |
| 258 | break; |
| 259 | } |
| 260 | |
| 261 | return 0; |
| 262 | } |
| 263 | |
| 264 | static struct decoded_trau_frame fr_idle_frame = { |
| 265 | .c_bits = { 0, 1, 1, 1, 0 }, /* IDLE DOWNLINK 3.5.5 */ |
| 266 | .t_bits = { 1, 1, 1, 1 }, |
| 267 | }; |
| 268 | static uint8_t encoded_idle_frame[TRAU_FRAME_BITS]; |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 269 | static int dbits_initted = 0; |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 270 | |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 271 | /*! \brief return pointer to global buffer containing a TRAU idle frame |
| 272 | */ |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 273 | uint8_t *trau_idle_frame(void) |
| 274 | { |
| 275 | /* only initialize during the first call */ |
| 276 | if (!dbits_initted) { |
| 277 | /* set all D-bits to 1 */ |
| 278 | memset(&fr_idle_frame.d_bits, 0x01, 260); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 279 | |
| 280 | memset(&fr_idle_frame.c_bits, 0x01, 25); /* spare are set to 1 */ |
| 281 | /* set Downlink Idle Speech Frame pattern */ |
| 282 | fr_idle_frame.c_bits[0] = 0; /* C1 */ |
| 283 | fr_idle_frame.c_bits[1] = 1; /* C2 */ |
| 284 | fr_idle_frame.c_bits[2] = 1; /* C3 */ |
| 285 | fr_idle_frame.c_bits[3] = 1; /* C4 */ |
| 286 | fr_idle_frame.c_bits[4] = 0; /* C5 */ |
| 287 | /* set no Time Alignment pattern */ |
| 288 | fr_idle_frame.c_bits[5] = 0; /* C6 */ |
| 289 | fr_idle_frame.c_bits[6] = 0; /* C7 */ |
| 290 | fr_idle_frame.c_bits[7] = 0; /* C8 */ |
| 291 | fr_idle_frame.c_bits[8] = 0; /* C9 */ |
| 292 | fr_idle_frame.c_bits[9] = 0; /* C10 */ |
| 293 | fr_idle_frame.c_bits[10] = 0; /* C11 */ |
| 294 | /* already set to 1, but maybe we need to modify it in the future */ |
| 295 | fr_idle_frame.c_bits[11] = 1; /* C12 (UFE), good frame */ |
| 296 | fr_idle_frame.c_bits[15] = 1; /* C16 (SP), no DTX */ |
| 297 | |
Pablo Neira Ayuso | 0ba77d5 | 2011-06-05 18:32:44 +0200 | [diff] [blame] | 298 | encode_fr(encoded_idle_frame, &fr_idle_frame); |
Dieter Spaar | aa49424 | 2011-07-27 23:52:36 +0200 | [diff] [blame] | 299 | 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] | 300 | } |
| 301 | return encoded_idle_frame; |
| 302 | } |
Harald Welte | 2f69b89 | 2011-08-21 11:13:50 +0200 | [diff] [blame] | 303 | |
| 304 | /* }@ */ |