Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 1 | #pragma once |
| 2 | |
| 3 | #include <stdbool.h> |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 4 | #include <string.h> |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 5 | |
| 6 | struct vty; |
| 7 | |
| 8 | /* handover_cfg is an opaque struct to manage several levels of configuration. There is an overall handover |
| 9 | * config on 'network' level and a per-'bts' specific handover config. If the 'bts' level sets no values, |
| 10 | * the defaults from 'network' level are used implicitly, and changes take effect immediately. */ |
| 11 | struct handover_cfg; |
| 12 | |
Neels Hofmeyr | 909e972 | 2017-12-07 03:54:01 +0100 | [diff] [blame] | 13 | #define HO_CFG_CONGESTION_CHECK_DEFAULT 10 |
| 14 | |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 15 | struct handover_cfg *ho_cfg_init(void *ctx, struct handover_cfg *higher_level_cfg); |
| 16 | |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 17 | #define HO_CFG_STR_HANDOVER1 "Handover options for handover decision algorithm 1\n" |
| 18 | #define HO_CFG_STR_HANDOVER2 "Handover options for handover decision algorithm 2\n" |
| 19 | #define HO_CFG_STR_WIN "Measurement averaging settings\n" |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 20 | #define HO_CFG_STR_WIN_RXLEV HO_CFG_STR_WIN "Received-Level averaging\n" |
| 21 | #define HO_CFG_STR_WIN_RXQUAL HO_CFG_STR_WIN "Received-Quality averaging\n" |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 22 | #define HO_CFG_STR_POWER_BUDGET "Neighbor cell power triggering\n" "Neighbor cell power triggering\n" |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 23 | #define HO_CFG_STR_AVG_COUNT "Number of values to average over\n" |
Neels Hofmeyr | 5a5c7fd | 2018-11-05 02:49:57 +0100 | [diff] [blame] | 24 | #define HO_CFG_STR_MIN "Minimum Level/Quality thresholds before triggering HO\n" |
| 25 | #define HO_CFG_STR_AFS_BIAS "Configure bias to prefer AFS (AMR on TCH/F) over other codecs\n" |
| 26 | #define HO_CFG_STR_MIN_TCH "Minimum free TCH timeslots before cell is considered congested\n" |
| 27 | #define HO_CFG_STR_PENALTY_TIME "Set penalty times to wait between repeated handovers\n" |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 28 | |
| 29 | #define as_is(x) (x) |
| 30 | |
| 31 | static inline bool a2bool(const char *arg) |
| 32 | { |
| 33 | return (bool)(atoi(arg)); |
| 34 | } |
| 35 | |
| 36 | static inline int bool2i(bool arg) |
| 37 | { |
| 38 | return arg? 1 : 0; |
| 39 | } |
| 40 | |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 41 | static inline bool a2tdma(const char *arg) |
| 42 | { |
| 43 | if (!strcmp(arg, "full")) |
| 44 | return true; |
| 45 | return false; |
| 46 | } |
| 47 | |
| 48 | static inline const char *tdma2a(bool val) |
| 49 | { |
| 50 | return val? "full" : "subset"; |
| 51 | } |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 52 | |
| 53 | /* The HO_CFG_ONE_MEMBER macro gets redefined, depending on whether to define struct members, |
| 54 | * function declarations or definitions... It is of the format |
| 55 | * HO_CFG_ONE_MEMBER(TYPE, NAME, DEFAULT_VAL, |
| 56 | * VTY_CMD, VTY_CMD_ARG, VTY_ARG_EVAL, |
| 57 | * VTY_WRITE_FMT, VTY_WRITE_CONV, |
| 58 | * VTY_DOC) |
| 59 | * Then using HO_CFG_ALL_MEMBERS can save a lot of code dup in defining API declaration, API |
| 60 | * definitions, VTY commands and VTY write code. Of course this doesn't prevent us from adding manual |
| 61 | * members as well, in case future additions don't fit in this scheme. |
| 62 | * |
| 63 | * TYPE: a type name like int. |
| 64 | * NAME: a variable name suitable for a struct member. |
| 65 | * DEFAULT_VAL: default value, as passed to the VTY, e.g. '0' or 'foo', without quotes. |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 66 | * VTY_CMD_PREFIX: "handover1 ", "handover2 ", ... or just "" for the common general items. |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 67 | * VTY_CMD: a command string for VTY without any arguments. |
| 68 | * VTY_CMD_ARG: VTY value range like '<0-23>' or 'foo|bar', will become '(VTY_CMD_ARG|default)'. |
| 69 | * VTY_ARG_EVAL: function name for parsing the VTY arg[0], e.g. 'atoi'. |
| 70 | * VTY_WRITE_FMT: printf-like string format for vty_out(). |
| 71 | * VTY_WRITE_CONV: function name to convert struct value to VTY_WRITE_FMT, e.g. 'as_is'. |
| 72 | * VTY_DOC: VTY documentation strings to match VTY_CMD and VTY_CMD_ARGs. |
| 73 | */ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 74 | #define HO_GENERAL_CFG_ALL_MEMBERS \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 75 | \ |
| 76 | HO_CFG_ONE_MEMBER(bool, ho_active, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 77 | "", "handover", "0|1", a2bool, "%d", bool2i, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 78 | "Handover general config\n" \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 79 | "Disable in-call handover\n" \ |
| 80 | "Enable in-call handover\n" \ |
| 81 | "Enable/disable handover: ") \ |
| 82 | \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 83 | HO_CFG_ONE_MEMBER(int, algorithm, 1, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 84 | "", "handover algorithm", "1|2", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 85 | "Handover general config\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 86 | "Choose algorithm for handover decision\n" \ |
| 87 | "Algorithm 1: trigger handover based on comparing current cell and neighbor RxLev and RxQual," \ |
| 88 | " only.\n" \ |
| 89 | "Algorithm 2: trigger handover on RxLev/RxQual, and also to balance the load across several" \ |
| 90 | " cells. Consider available codecs. Prevent repeated handover by penalty timers.\n") \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 91 | |
| 92 | |
| 93 | #define HODEC1_CFG_ALL_MEMBERS \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 94 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 95 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_rxlev_avg_win, 10, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 96 | "handover1 ", "window rxlev averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 97 | HO_CFG_STR_HANDOVER1 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 98 | HO_CFG_STR_WIN_RXLEV \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 99 | "How many RxLev measurements to use for averaging\n" \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 100 | "RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 101 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 102 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_rxqual_avg_win, 1, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 103 | "handover1 ", "window rxqual averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 104 | HO_CFG_STR_HANDOVER1 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 105 | HO_CFG_STR_WIN_RXQUAL \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 106 | "How many RxQual measurements to use for averaging\n" \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 107 | "RxQual averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 108 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 109 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_rxlev_neigh_avg_win, 10, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 110 | "handover1 ", "window rxlev neighbor averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 111 | HO_CFG_STR_HANDOVER1 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 112 | HO_CFG_STR_WIN_RXLEV \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 113 | "How many Neighbor RxLev measurements to use for averaging\n" \ |
| 114 | "How many Neighbor RxLev measurements to use for averaging\n" \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 115 | "Neighbor RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 116 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 117 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_pwr_interval, 6, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 118 | "handover1 ", "power budget interval", "<1-99>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 119 | HO_CFG_STR_HANDOVER1 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 120 | HO_CFG_STR_POWER_BUDGET \ |
| 121 | "How often to check for a better cell (SACCH frames)\n" \ |
| 122 | "Check for stronger neighbor every N number of SACCH frames\n") \ |
| 123 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 124 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_pwr_hysteresis, 3, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 125 | "handover1 ", "power budget hysteresis", "<0-999>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 126 | HO_CFG_STR_HANDOVER1 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 127 | HO_CFG_STR_POWER_BUDGET \ |
Neels Hofmeyr | 16dd64a | 2018-07-19 16:50:14 +0200 | [diff] [blame] | 128 | "How many dB stronger must a neighbor be to become a HO candidate\n" \ |
| 129 | "Neighbor's strength difference in dB\n") \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 130 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 131 | HO_CFG_ONE_MEMBER(unsigned int, hodec1_max_distance, 9999, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 132 | "handover1 ", "maximum distance" , "<0-9999>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 133 | HO_CFG_STR_HANDOVER1 \ |
| 134 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| 135 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| 136 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n") \ |
| 137 | |
| 138 | |
| 139 | #define HODEC2_CFG_ALL_MEMBERS \ |
| 140 | \ |
| 141 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_rxlev_avg_win, 10, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 142 | "handover2 ", "window rxlev averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 143 | HO_CFG_STR_HANDOVER2 \ |
| 144 | HO_CFG_STR_WIN_RXLEV \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 145 | "How many RxLev measurements to use for averaging\n" \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 146 | "RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 147 | \ |
| 148 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_rxqual_avg_win, 1, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 149 | "handover2 ", "window rxqual averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 150 | HO_CFG_STR_HANDOVER2 \ |
| 151 | HO_CFG_STR_WIN_RXQUAL \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 152 | "How many RxQual measurements to use for averaging\n" \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 153 | "RxQual averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 154 | \ |
| 155 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_rxlev_neigh_avg_win, 10, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 156 | "handover2 ", "window rxlev neighbor averaging", "<1-10>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 157 | HO_CFG_STR_HANDOVER2 \ |
| 158 | HO_CFG_STR_WIN_RXLEV \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 159 | "How many Neighbor RxLev measurements to use for averaging\n" \ |
| 160 | "How many Neighbor RxLev measurements to use for averaging\n" \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 161 | "Neighbor RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| 162 | \ |
| 163 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_pwr_interval, 6, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 164 | "handover2 ", "power budget interval", "<1-99>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 165 | HO_CFG_STR_HANDOVER2 \ |
| 166 | HO_CFG_STR_POWER_BUDGET \ |
| 167 | "How often to check for a better cell (SACCH frames)\n" \ |
| 168 | "Check for stronger neighbor every N number of SACCH frames\n") \ |
| 169 | \ |
| 170 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_pwr_hysteresis, 3, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 171 | "handover2 ", "power budget hysteresis", "<0-999>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 172 | HO_CFG_STR_HANDOVER2 \ |
| 173 | HO_CFG_STR_POWER_BUDGET \ |
Neels Hofmeyr | 16dd64a | 2018-07-19 16:50:14 +0200 | [diff] [blame] | 174 | "How many dB stronger must a neighbor be to become a HO candidate\n" \ |
| 175 | "Neighbor's strength difference in dB\n") \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 176 | \ |
| 177 | HO_CFG_ONE_MEMBER(unsigned int, hodec2_max_distance, 9999, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 178 | "handover2 ", "maximum distance" , "<0-9999>", atoi, "%u", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 179 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 180 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| 181 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| 182 | "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n") \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 183 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 184 | HO_CFG_ONE_MEMBER(bool, hodec2_as_active, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 185 | "handover2 ", "assignment", "0|1", a2bool, "%d", bool2i, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 186 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 187 | "Enable or disable in-call channel re-assignment within the same cell\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 188 | "Disable in-call assignment\n" \ |
| 189 | "Enable in-call assignment\n") \ |
| 190 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 191 | HO_CFG_ONE_MEMBER(bool, hodec2_full_tdma, subset, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 192 | "handover2 ", "tdma-measurement", "full|subset", a2tdma, "%s", tdma2a, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 193 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 5a5c7fd | 2018-11-05 02:49:57 +0100 | [diff] [blame] | 194 | "Define measurement set of TDMA frames\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 195 | "Full set of 102/104 TDMA frames\n" \ |
| 196 | "Sub set of 4 TDMA frames (SACCH)\n") \ |
| 197 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 198 | HO_CFG_ONE_MEMBER(int, hodec2_min_rxlev, -100, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 199 | "handover2 ", "min rxlev", "<-110--50>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 200 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 201 | HO_CFG_STR_MIN \ |
| 202 | "How weak may RxLev of an MS become before triggering HO\n" \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 203 | "minimum RxLev (dBm; note: negative values)\n") \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 204 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 205 | HO_CFG_ONE_MEMBER(int, hodec2_min_rxqual, 5, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 206 | "handover2 ", "min rxqual", "<0-7>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 207 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 208 | HO_CFG_STR_MIN \ |
Neels Hofmeyr | 4d8a469 | 2020-11-11 19:57:51 +0100 | [diff] [blame] | 209 | "How bad may RxQual of an MS become before triggering HO," \ |
| 210 | " where 0 is the best quality (bit error rate < 0.2%) and" \ |
| 211 | " 7 is the worst quality (bit error rate > 12.8%)," \ |
| 212 | " see 3GPP TS 45.008 8.2.4.\n" \ |
| 213 | "worst acceptable RxQual\n") \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 214 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 215 | HO_CFG_ONE_MEMBER(int, hodec2_afs_bias_rxlev, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 216 | "handover2 ", "afs-bias rxlev", "<0-20>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 217 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 218 | HO_CFG_STR_AFS_BIAS \ |
| 219 | "RxLev improvement bias for AFS over other codecs\n" \ |
Neels Hofmeyr | 16dd64a | 2018-07-19 16:50:14 +0200 | [diff] [blame] | 220 | "Virtual RxLev improvement (dB)\n") \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 221 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 222 | HO_CFG_ONE_MEMBER(int, hodec2_afs_bias_rxqual, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 223 | "handover2 ", "afs-bias rxqual", "<0-7>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 224 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 225 | HO_CFG_STR_AFS_BIAS \ |
| 226 | "RxQual improvement bias for AFS over other codecs\n" \ |
Neels Hofmeyr | 16dd64a | 2018-07-19 16:50:14 +0200 | [diff] [blame] | 227 | "Virtual RxQual improvement\n") \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 228 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 229 | HO_CFG_ONE_MEMBER(int, hodec2_tchf_min_slots, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 230 | "handover2 ", "min-free-slots tch/f", "<0-9999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 231 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 232 | HO_CFG_STR_MIN_TCH \ |
| 233 | "Minimum free TCH/F timeslots before cell is considered congested\n" \ |
| 234 | "Number of TCH/F slots\n") \ |
| 235 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 236 | HO_CFG_ONE_MEMBER(int, hodec2_tchh_min_slots, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 237 | "handover2 ", "min-free-slots tch/h", "<0-9999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 238 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 239 | HO_CFG_STR_MIN_TCH \ |
| 240 | "Minimum free TCH/H timeslots before cell is considered congested\n" \ |
| 241 | "Number of TCH/H slots\n") \ |
| 242 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 243 | HO_CFG_ONE_MEMBER(int, hodec2_ho_max, 9999, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 244 | "handover2 ", "max-handovers", "<1-9999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 245 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 5a5c7fd | 2018-11-05 02:49:57 +0100 | [diff] [blame] | 246 | "Maximum number of concurrent handovers allowed per cell\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 247 | "Number\n") \ |
| 248 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 249 | HO_CFG_ONE_MEMBER(int, hodec2_penalty_max_dist, 300, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 250 | "handover2 ", "penalty-time max-distance", "<0-99999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 251 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 252 | HO_CFG_STR_PENALTY_TIME \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 253 | "Time to suspend handover for a subscriber after leaving this cell due to exceeding max distance;" \ |
| 254 | " see also 'handover2 retries'\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 255 | "Seconds\n") \ |
| 256 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 257 | HO_CFG_ONE_MEMBER(int, hodec2_penalty_failed_ho, 60, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 258 | "handover2 ", "penalty-time failed-ho", "<0-99999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 259 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 260 | HO_CFG_STR_PENALTY_TIME \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 261 | "Time to suspend handover for a subscriber after a failed handover into this cell;" \ |
| 262 | " see also 'handover2 retries'\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 263 | "Seconds\n") \ |
| 264 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 265 | HO_CFG_ONE_MEMBER(int, hodec2_penalty_failed_as, 60, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 266 | "handover2 ", "penalty-time failed-assignment", "<0-99999>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 267 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 268 | HO_CFG_STR_PENALTY_TIME \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 269 | "Time to suspend handover for a subscriber after a failed re-assignment within this cell;" \ |
| 270 | " see also 'handover2 retries'\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 271 | "Seconds\n") \ |
| 272 | \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 273 | HO_CFG_ONE_MEMBER(int, hodec2_retries, 0, \ |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 274 | "handover2 ", "retries", "<0-9>", atoi, "%d", as_is, \ |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 275 | HO_CFG_STR_HANDOVER2 \ |
Neels Hofmeyr | 08371ec | 2019-06-24 13:43:06 +0200 | [diff] [blame] | 276 | "Number of times to immediately retry a failed handover/assignment, before a penalty time is applied\n" \ |
Neels Hofmeyr | 87b5eb6 | 2017-12-07 01:55:58 +0100 | [diff] [blame] | 277 | "Number of retries\n") \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 278 | |
Neels Hofmeyr | dd42eb9 | 2018-02-14 19:56:23 +0100 | [diff] [blame] | 279 | #define HO_CFG_ALL_MEMBERS \ |
| 280 | HO_GENERAL_CFG_ALL_MEMBERS \ |
| 281 | HODEC1_CFG_ALL_MEMBERS \ |
| 282 | HODEC2_CFG_ALL_MEMBERS \ |
| 283 | |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 284 | |
| 285 | /* Declare public API for handover cfg parameters... */ |
| 286 | |
Neels Hofmeyr | 444f9e2 | 2018-02-15 03:59:17 +0100 | [diff] [blame] | 287 | #define HO_CFG_ONE_MEMBER(TYPE, NAME, DEFAULT_VAL, VTY0, VTY1, VTY2, VTY3, VTY4, VTY5, VTY6) \ |
Neels Hofmeyr | e25018b | 2017-11-27 21:29:33 +0100 | [diff] [blame] | 288 | TYPE ho_get_##NAME(struct handover_cfg *ho); \ |
| 289 | void ho_set_##NAME(struct handover_cfg *ho, TYPE val); \ |
| 290 | bool ho_isset_##NAME(struct handover_cfg *ho); \ |
| 291 | void ho_clear_##NAME(struct handover_cfg *ho); \ |
| 292 | bool ho_isset_on_parent_##NAME(struct handover_cfg *ho); |
| 293 | |
| 294 | HO_CFG_ALL_MEMBERS |
| 295 | #undef HO_CFG_ONE_MEMBER |