| /* TRAU frame handling according to GSM TS 08.60 */ |
| |
| /* (C) 2009 by Harald Welte <laforge@gnumonks.org> |
| * All Rights Reserved |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU Affero General Public License as published by |
| * the Free Software Foundation; either version 3 of the License, or |
| * (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU Affero General Public License for more details. |
| * |
| * You should have received a copy of the GNU Affero General Public License |
| * along with this program. If not, see <http://www.gnu.org/licenses/>. |
| * |
| */ |
| #include "internal.h" |
| |
| #include <unistd.h> |
| #include <stdlib.h> |
| #include <stdio.h> |
| #include <string.h> |
| #include <errno.h> |
| |
| #include <osmocom/abis/trau_frame.h> |
| #include <osmocom/abis/subchan_demux.h> |
| #include <osmocom/core/logging.h> |
| |
| /*! \addtogroup trau_frame |
| * @{ |
| * |
| * \file trau_frame.c |
| */ |
| |
| static uint32_t get_bits(const uint8_t *bitbuf, int offset, int num) |
| { |
| int i; |
| uint32_t ret = 0; |
| |
| for (i = offset; i < offset + num; i++) { |
| ret = ret << 1; |
| if (bitbuf[i]) |
| ret |= 1; |
| } |
| return ret; |
| } |
| |
| /* Decode according to 3.1.1 */ |
| static void decode_fr(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| { |
| int i; |
| int d_idx = 0; |
| |
| /* C1 .. C15 */ |
| memcpy(fr->c_bits+0, trau_bits+17, 15); |
| /* C16 .. C21 */ |
| memcpy(fr->c_bits+15, trau_bits+310, 6); |
| /* T1 .. T4 */ |
| memcpy(fr->t_bits+0, trau_bits+316, 4); |
| /* D1 .. D255 */ |
| for (i = 32; i < 304; i+= 16) { |
| memcpy(fr->d_bits + d_idx, trau_bits+i+1, 15); |
| d_idx += 15; |
| } |
| /* D256 .. D260 */ |
| memcpy(fr->d_bits + d_idx, trau_bits + 305, 5); |
| } |
| |
| /* Decode according to 3.1.2 */ |
| static void decode_amr(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| { |
| int i; |
| int d_idx = 0; |
| |
| /* C1 .. C15 */ |
| memcpy(fr->c_bits+0, trau_bits+17, 15); |
| /* C16 .. C25 */ |
| memcpy(fr->c_bits+15, trau_bits+33, 10); |
| /* T1 .. T4 */ |
| memcpy(fr->t_bits+0, trau_bits+316, 4); |
| /* D1 .. D5 */ |
| memcpy(fr->d_bits, trau_bits+43, 5); |
| /* D6 .. D245 */ |
| for (i = 48; i < 304; i += 16) { |
| memcpy(fr->d_bits + d_idx, trau_bits+i+1, 15); |
| d_idx += 15; |
| } |
| /* D246 .. D256 */ |
| memcpy(fr->d_bits + d_idx, trau_bits + 305, 11); |
| } |
| |
| static void decode_data(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| { |
| /* C1 .. C15 */ |
| memcpy(fr->c_bits+0, trau_bits+17, 15); |
| /* octets 4 .. 39 */ |
| memcpy(fr->d_bits, trau_bits+32, 288); |
| } |
| |
| int decode_trau_frame(struct decoded_trau_frame *fr, const uint8_t *trau_bits) |
| { |
| uint8_t cbits5 = get_bits(trau_bits, 17, 5); |
| |
| switch (cbits5) { |
| case TRAU_FT_FR_UP: |
| case TRAU_FT_FR_DOWN: |
| case TRAU_FT_IDLE_UP: |
| case TRAU_FT_IDLE_DOWN: |
| case TRAU_FT_EFR: |
| decode_fr(fr, trau_bits); |
| break; |
| case TRAU_FT_AMR: |
| decode_amr(fr, trau_bits); |
| break; |
| case TRAU_FT_DATA_UP: |
| case TRAU_FT_DATA_DOWN: |
| decode_data(fr, trau_bits); |
| break; |
| case TRAU_FT_OM_UP: |
| case TRAU_FT_OM_DOWN: |
| case TRAU_FT_D145_SYNC: |
| case TRAU_FT_EDATA: |
| LOGP(DLMUX, LOGL_NOTICE, "can't decode unimplemented TRAU " |
| "Frame Type 0x%02x\n", cbits5); |
| return -1; |
| break; |
| default: |
| LOGP(DLMUX, LOGL_NOTICE, "can't decode unknown TRAU " |
| "Frame Type 0x%02x\n", cbits5); |
| return -1; |
| break; |
| } |
| |
| return 0; |
| } |
| |
| const uint8_t ft_fr_down_bits[] = { 1, 1, 1, 0, 0 }; |
| const uint8_t ft_idle_down_bits[] = { 0, 1, 1, 1, 0 }; |
| const uint8_t ft_data_down_bits[] = { 1, 0, 1, 1, 0 }; |
| |
| /*! \brief modify an uplink TRAU frame so we can send it downlink |
| * \param[in,out] fr the uplink TRAU frame that is to be converted |
| * \returns 0 in case of success, < 0 in caes of error |
| */ |
| int trau_frame_up2down(struct decoded_trau_frame *fr) |
| { |
| uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| |
| switch (cbits5) { |
| case TRAU_FT_FR_UP: |
| memcpy(fr->c_bits, ft_fr_down_bits, 5); |
| /* clear time alignment */ |
| memset(fr->c_bits+5, 0, 6); |
| /* FIXME: SP / BFI in case of DTx */ |
| /* C12 .. C21 are spare and coded as '1' */ |
| memset(fr->c_bits+11, 0x01, 10); |
| break; |
| case TRAU_FT_EFR: |
| /* clear time alignment */ |
| memset(fr->c_bits+5, 0, 6); |
| /* set UFE appropriately */ |
| fr->c_bits[11] = 1; /* C12 (UFE), good frame (TODO) */ |
| /* C13 .. C15 are spare and coded as '1' */ |
| memset(fr->c_bits+12, 0x01, 3); |
| /* SP / BFI in case of DTx */ |
| fr->c_bits[15] = 1; /* C16 (SP), no DTX (TODO) */ |
| /* C17 .. C21 are spare and coded as '1' */ |
| memset(fr->c_bits+16, 0x01, 5); |
| break; |
| case TRAU_FT_IDLE_UP: |
| memcpy(fr->c_bits, ft_idle_down_bits, 5); |
| /* clear time alignment */ |
| memset(fr->c_bits+5, 0, 6); |
| /* FIXME: SP / BFI in case of DTx */ |
| /* C12 .. C21 are spare and coded as '1' */ |
| memset(fr->c_bits+11, 0x01, 10); |
| break; |
| case TRAU_FT_DATA_UP: |
| memcpy(fr->c_bits, ft_data_down_bits, 5); |
| break; |
| case TRAU_FT_FR_DOWN: |
| case TRAU_FT_IDLE_DOWN: |
| case TRAU_FT_OM_DOWN: |
| case TRAU_FT_DATA_DOWN: |
| /* we cannot convert a downlink to a downlink frame */ |
| return -EINVAL; |
| break; |
| case TRAU_FT_AMR: |
| case TRAU_FT_OM_UP: |
| case TRAU_FT_D145_SYNC: |
| case TRAU_FT_EDATA: |
| LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
| "0x%02x\n", cbits5); |
| return -1; |
| break; |
| default: |
| LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
| "0x%02x\n", cbits5); |
| return -1; |
| break; |
| } |
| |
| return 0; |
| |
| } |
| |
| static void encode_fr(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| { |
| int i; |
| int d_idx = 0; |
| |
| trau_bits[16] = 1; |
| /* C1 .. C15 */ |
| memcpy(trau_bits+17, fr->c_bits+0, 15); |
| /* D1 .. D255 */ |
| for (i = 32; i < 304; i+= 16) { |
| trau_bits[i] = 1; |
| memcpy(trau_bits+i+1, fr->d_bits + d_idx, 15); |
| d_idx += 15; |
| } |
| /* D256 .. D260 */ |
| trau_bits[304] = 1; |
| memcpy(trau_bits + 305, fr->d_bits + d_idx, 5); |
| /* C16 .. C21 */ |
| memcpy(trau_bits+310, fr->c_bits+15, 6); |
| |
| /* FIXME: handle timing adjustment */ |
| |
| /* T1 .. T4 */ |
| memcpy(trau_bits+316, fr->t_bits+0, 4); |
| } |
| |
| static void encode_data(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| { |
| trau_bits[16] = 1; |
| /* C1 .. C15 */ |
| memcpy(trau_bits+17, fr->c_bits+0, 15); |
| /* octets 4 .. 39 */ |
| memcpy(trau_bits+32, fr->d_bits, 288); |
| } |
| |
| /*! \brief encode a TRAU frame from the decoded bits |
| * \param[out] trau_bits output buffer, will contain encoded bits |
| * \param[in] fr decoded trau frame structure |
| * \returns 0 in case of success, < 0 in case of error |
| */ |
| int encode_trau_frame(uint8_t *trau_bits, const struct decoded_trau_frame *fr) |
| { |
| uint8_t cbits5 = get_bits(fr->c_bits, 0, 5); |
| |
| /* 16 bits of sync header */ |
| memset(trau_bits, 0, 16); |
| |
| switch (cbits5) { |
| case TRAU_FT_FR_UP: |
| case TRAU_FT_FR_DOWN: |
| case TRAU_FT_IDLE_UP: |
| case TRAU_FT_IDLE_DOWN: |
| case TRAU_FT_EFR: |
| encode_fr(trau_bits, fr); |
| break; |
| case TRAU_FT_DATA_UP: |
| case TRAU_FT_DATA_DOWN: |
| encode_data(trau_bits, fr); |
| break; |
| case TRAU_FT_AMR: |
| case TRAU_FT_OM_UP: |
| case TRAU_FT_OM_DOWN: |
| case TRAU_FT_D145_SYNC: |
| case TRAU_FT_EDATA: |
| LOGP(DLMUX, LOGL_NOTICE, "unimplemented TRAU Frame Type " |
| "0x%02x\n", cbits5); |
| return -1; |
| break; |
| default: |
| LOGP(DLMUX, LOGL_NOTICE, "unknown TRAU Frame Type " |
| "0x%02x\n", cbits5); |
| return -1; |
| break; |
| } |
| |
| return 0; |
| } |
| |
| static struct decoded_trau_frame fr_idle_frame = { |
| .c_bits = { 0, 1, 1, 1, 0 }, /* IDLE DOWNLINK 3.5.5 */ |
| .t_bits = { 1, 1, 1, 1 }, |
| }; |
| static uint8_t encoded_idle_frame[TRAU_FRAME_BITS]; |
| static int dbits_initted = 0; |
| |
| /*! \brief return pointer to global buffer containing a TRAU idle frame |
| */ |
| uint8_t *trau_idle_frame(void) |
| { |
| /* only initialize during the first call */ |
| if (!dbits_initted) { |
| /* set all D-bits to 1 */ |
| memset(&fr_idle_frame.d_bits, 0x01, 260); |
| |
| memset(&fr_idle_frame.c_bits, 0x01, 25); /* spare are set to 1 */ |
| /* set Downlink Idle Speech Frame pattern */ |
| fr_idle_frame.c_bits[0] = 0; /* C1 */ |
| fr_idle_frame.c_bits[1] = 1; /* C2 */ |
| fr_idle_frame.c_bits[2] = 1; /* C3 */ |
| fr_idle_frame.c_bits[3] = 1; /* C4 */ |
| fr_idle_frame.c_bits[4] = 0; /* C5 */ |
| /* set no Time Alignment pattern */ |
| fr_idle_frame.c_bits[5] = 0; /* C6 */ |
| fr_idle_frame.c_bits[6] = 0; /* C7 */ |
| fr_idle_frame.c_bits[7] = 0; /* C8 */ |
| fr_idle_frame.c_bits[8] = 0; /* C9 */ |
| fr_idle_frame.c_bits[9] = 0; /* C10 */ |
| fr_idle_frame.c_bits[10] = 0; /* C11 */ |
| /* already set to 1, but maybe we need to modify it in the future */ |
| fr_idle_frame.c_bits[11] = 1; /* C12 (UFE), good frame */ |
| fr_idle_frame.c_bits[15] = 1; /* C16 (SP), no DTX */ |
| |
| encode_fr(encoded_idle_frame, &fr_idle_frame); |
| dbits_initted = 1; /* set it to 1 to not call it again */ |
| } |
| return encoded_idle_frame; |
| } |
| |
| /* }@ */ |