Max | bea2edb | 2019-03-06 17:04:59 +0100 | [diff] [blame] | 1 | /* coding_scheme.h |
| 2 | * |
| 3 | * Copyright (C) 2015-2019 by sysmocom s.f.m.c. GmbH |
| 4 | * |
| 5 | * This program is free software; you can redistribute it and/or |
| 6 | * modify it under the terms of the GNU General Public License |
| 7 | * as published by the Free Software Foundation; either version 2 |
| 8 | * of the License, or (at your option) any later version. |
| 9 | * |
| 10 | * This program is distributed in the hope that it will be useful, |
| 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | * GNU General Public License for more details. |
Max | bea2edb | 2019-03-06 17:04:59 +0100 | [diff] [blame] | 14 | */ |
| 15 | |
| 16 | #pragma once |
| 17 | |
Max | 136ebcc | 2019-03-05 14:59:03 +0100 | [diff] [blame] | 18 | #include <osmocom/core/utils.h> |
| 19 | |
Pau Espin Pedrol | 2ae8337 | 2020-05-18 11:35:35 +0200 | [diff] [blame] | 20 | #include <stdbool.h> |
| 21 | |
Max | bea2edb | 2019-03-06 17:04:59 +0100 | [diff] [blame] | 22 | enum CodingScheme { |
| 23 | UNKNOWN, |
| 24 | /* GPRS Coding Schemes: */ |
| 25 | CS1, CS2, CS3, CS4, |
| 26 | /* EDGE/EGPRS Modulation and Coding Schemes: */ |
| 27 | MCS1, MCS2, MCS3, MCS4, MCS5, MCS6, MCS7, MCS8, MCS9, |
| 28 | NUM_SCHEMES |
| 29 | }; |
Max | 51754b6 | 2019-03-13 17:14:13 +0100 | [diff] [blame] | 30 | |
Pau Espin Pedrol | 2ae8337 | 2020-05-18 11:35:35 +0200 | [diff] [blame] | 31 | enum mcs_kind { |
| 32 | GPRS, |
| 33 | EGPRS_GMSK, |
| 34 | EGPRS, |
| 35 | }; |
| 36 | |
Pau Espin Pedrol | 97296b2 | 2021-01-14 13:08:02 +0100 | [diff] [blame] | 37 | enum egprs_arq_type { |
| 38 | EGPRS_ARQ1 = 0, |
| 39 | EGPRS_ARQ2 = 1 |
| 40 | }; |
Pau Espin Pedrol | 2ae8337 | 2020-05-18 11:35:35 +0200 | [diff] [blame] | 41 | |
Max | 136ebcc | 2019-03-05 14:59:03 +0100 | [diff] [blame] | 42 | extern const struct value_string mcs_names[]; |
| 43 | const char *mcs_name(enum CodingScheme val); |
Max | 902e3e5 | 2019-03-25 16:38:53 +0100 | [diff] [blame] | 44 | enum CodingScheme get_retx_mcs(enum CodingScheme initial_mcs, enum CodingScheme commanded_mcs, bool resegment_bit); |
Max | 136ebcc | 2019-03-05 14:59:03 +0100 | [diff] [blame] | 45 | |
Max | 8a8e0fb | 2019-03-25 16:32:50 +0100 | [diff] [blame] | 46 | bool mcs_is_gprs(enum CodingScheme cs); |
| 47 | bool mcs_is_edge(enum CodingScheme cs); |
| 48 | bool mcs_is_edge_gmsk(enum CodingScheme cs); |
| 49 | |
Max | 898dddb | 2019-03-12 15:50:57 +0100 | [diff] [blame] | 50 | uint8_t mcs_chan_code(enum CodingScheme cs); |
| 51 | |
Pau Espin Pedrol | 2ae8337 | 2020-05-18 11:35:35 +0200 | [diff] [blame] | 52 | enum CodingScheme mcs_get_by_size_ul(unsigned size); |
| 53 | enum CodingScheme mcs_get_gprs_by_num(unsigned num); |
| 54 | enum CodingScheme mcs_get_egprs_by_num(unsigned num); |
| 55 | bool mcs_is_valid(enum CodingScheme cs); |
| 56 | bool mcs_is_compat(enum CodingScheme cs, enum CodingScheme o); |
| 57 | bool mcs_is_compat_kind(enum CodingScheme cs, enum mcs_kind mode); |
| 58 | |
| 59 | uint8_t mcs_size_ul(enum CodingScheme cs); |
| 60 | uint8_t mcs_size_dl(enum CodingScheme cs); |
| 61 | uint8_t mcs_used_size_ul(enum CodingScheme cs); |
| 62 | uint8_t mcs_used_size_dl(enum CodingScheme cs); |
| 63 | uint8_t mcs_max_bytes_ul(enum CodingScheme cs); |
| 64 | uint8_t mcs_max_bytes_dl(enum CodingScheme cs); |
| 65 | uint8_t mcs_spare_bits_ul(enum CodingScheme cs); |
| 66 | uint8_t mcs_spare_bits_dl(enum CodingScheme cs); |
| 67 | uint8_t mcs_max_data_block_bytes(enum CodingScheme cs); |
| 68 | uint8_t mcs_opt_padding_bits(enum CodingScheme cs); |
| 69 | |
| 70 | void mcs_inc_kind(enum CodingScheme *cs, enum mcs_kind mode); |
| 71 | void mcs_dec_kind(enum CodingScheme *cs, enum mcs_kind mode); |
| 72 | void mcs_inc(enum CodingScheme *cs); |
| 73 | void mcs_dec(enum CodingScheme *cs); |
| 74 | |
| 75 | bool mcs_is_family_compat(enum CodingScheme cs, enum CodingScheme o); |
| 76 | void mcs_dec_to_single_block(enum CodingScheme *cs, bool *need_stuffing); |
| 77 | |
Max | 51754b6 | 2019-03-13 17:14:13 +0100 | [diff] [blame] | 78 | enum HeaderType { |
| 79 | HEADER_INVALID, |
| 80 | HEADER_GPRS_CONTROL, |
| 81 | HEADER_GPRS_DATA, |
| 82 | HEADER_EGPRS_DATA_TYPE_1, |
| 83 | HEADER_EGPRS_DATA_TYPE_2, |
| 84 | HEADER_EGPRS_DATA_TYPE_3, |
| 85 | NUM_HEADER_TYPES |
| 86 | }; |
| 87 | |
Pau Espin Pedrol | 2ae8337 | 2020-05-18 11:35:35 +0200 | [diff] [blame] | 88 | enum HeaderType mcs_header_type(enum CodingScheme mcs); |
Max | 51754b6 | 2019-03-13 17:14:13 +0100 | [diff] [blame] | 89 | |
| 90 | uint8_t num_data_blocks(enum HeaderType ht); |
| 91 | uint8_t num_data_header_bits_UL(enum HeaderType ht); |
| 92 | uint8_t num_data_header_bits_DL(enum HeaderType ht); |
| 93 | uint8_t num_data_block_header_bits(enum HeaderType ht); |
Max | a4de02d | 2019-03-13 16:35:09 +0100 | [diff] [blame] | 94 | |
Max | a4de02d | 2019-03-13 16:35:09 +0100 | [diff] [blame] | 95 | const char *mode_name(enum mcs_kind val); |