| #pragma once |
| |
| #include <stdbool.h> |
| |
| struct vty; |
| |
| /* handover_cfg is an opaque struct to manage several levels of configuration. There is an overall handover |
| * config on 'network' level and a per-'bts' specific handover config. If the 'bts' level sets no values, |
| * the defaults from 'network' level are used implicitly, and changes take effect immediately. */ |
| struct handover_cfg; |
| |
| struct handover_cfg *ho_cfg_init(void *ctx, struct handover_cfg *higher_level_cfg); |
| |
| #define HO_CFG_STR_HANDOVER "Handover options\n" |
| #define HO_CFG_STR_WIN HO_CFG_STR_HANDOVER "Measurement averaging settings\n" |
| #define HO_CFG_STR_WIN_RXLEV HO_CFG_STR_WIN "Received-Level averaging\n" |
| #define HO_CFG_STR_WIN_RXQUAL HO_CFG_STR_WIN "Received-Quality averaging\n" |
| #define HO_CFG_STR_POWER_BUDGET HO_CFG_STR_HANDOVER "Neighbor cell power triggering\n" "Neighbor cell power triggering\n" |
| #define HO_CFG_STR_AVG_COUNT "Number of values to average over\n" |
| |
| #define as_is(x) (x) |
| |
| static inline bool a2bool(const char *arg) |
| { |
| return (bool)(atoi(arg)); |
| } |
| |
| static inline int bool2i(bool arg) |
| { |
| return arg? 1 : 0; |
| } |
| |
| |
| /* The HO_CFG_ONE_MEMBER macro gets redefined, depending on whether to define struct members, |
| * function declarations or definitions... It is of the format |
| * HO_CFG_ONE_MEMBER(TYPE, NAME, DEFAULT_VAL, |
| * VTY_CMD, VTY_CMD_ARG, VTY_ARG_EVAL, |
| * VTY_WRITE_FMT, VTY_WRITE_CONV, |
| * VTY_DOC) |
| * Then using HO_CFG_ALL_MEMBERS can save a lot of code dup in defining API declaration, API |
| * definitions, VTY commands and VTY write code. Of course this doesn't prevent us from adding manual |
| * members as well, in case future additions don't fit in this scheme. |
| * |
| * TYPE: a type name like int. |
| * NAME: a variable name suitable for a struct member. |
| * DEFAULT_VAL: default value, as passed to the VTY, e.g. '0' or 'foo', without quotes. |
| * VTY_CMD: a command string for VTY without any arguments. |
| * VTY_CMD_ARG: VTY value range like '<0-23>' or 'foo|bar', will become '(VTY_CMD_ARG|default)'. |
| * VTY_ARG_EVAL: function name for parsing the VTY arg[0], e.g. 'atoi'. |
| * VTY_WRITE_FMT: printf-like string format for vty_out(). |
| * VTY_WRITE_CONV: function name to convert struct value to VTY_WRITE_FMT, e.g. 'as_is'. |
| * VTY_DOC: VTY documentation strings to match VTY_CMD and VTY_CMD_ARGs. |
| */ |
| #define HO_CFG_ALL_MEMBERS \ |
| \ |
| HO_CFG_ONE_MEMBER(bool, ho_active, 0, \ |
| "handover", "0|1", a2bool, "%d", bool2i, \ |
| HO_CFG_STR_HANDOVER \ |
| "Disable in-call handover\n" \ |
| "Enable in-call handover\n" \ |
| "Enable/disable handover: ") \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, rxlev_avg_win, 10, \ |
| "handover window rxlev averaging", "<1-10>", atoi, "%u", as_is, \ |
| HO_CFG_STR_WIN_RXLEV \ |
| "How many RxLev measurements are used for averaging\n" \ |
| "RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, rxqual_avg_win, 1, \ |
| "handover window rxqual averaging", "<1-10>", atoi, "%u", as_is, \ |
| HO_CFG_STR_WIN_RXQUAL \ |
| "How many RxQual measurements are used for averaging\n" \ |
| "RxQual averaging: " HO_CFG_STR_AVG_COUNT) \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, rxlev_neigh_avg_win, 10, \ |
| "handover window rxlev neighbor averaging", "<1-10>", atoi, "%u", as_is, \ |
| HO_CFG_STR_WIN_RXLEV \ |
| "How many Neighbor RxLev measurements are used for averaging\n" \ |
| "How many Neighbor RxLev measurements are used for averaging\n" \ |
| "Neighbor RxLev averaging: " HO_CFG_STR_AVG_COUNT) \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, pwr_interval, 6, \ |
| "handover power budget interval", "<1-99>", atoi, "%u", as_is, \ |
| HO_CFG_STR_POWER_BUDGET \ |
| "How often to check for a better cell (SACCH frames)\n" \ |
| "Check for stronger neighbor every N number of SACCH frames\n") \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, pwr_hysteresis, 3, \ |
| "handover power budget hysteresis", "<0-999>", atoi, "%u", as_is, \ |
| HO_CFG_STR_POWER_BUDGET \ |
| "How many dBm stronger must a neighbor be to become a HO candidate\n" \ |
| "Neighbor's strength difference in dBm\n") \ |
| \ |
| HO_CFG_ONE_MEMBER(unsigned int, max_distance, 9999, \ |
| "handover maximum distance" , "<0-9999>", atoi, "%u", as_is, \ |
| HO_CFG_STR_HANDOVER \ |
| "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n" \ |
| "Maximum Timing-Advance value (i.e. MS distance) before triggering HO\n") \ |
| |
| |
| /* Declare public API for handover cfg parameters... */ |
| |
| #define HO_CFG_ONE_MEMBER(TYPE, NAME, DEFAULT_VAL, VTY1, VTY2, VTY3, VTY4, VTY5, VTY6) \ |
| TYPE ho_get_##NAME(struct handover_cfg *ho); \ |
| void ho_set_##NAME(struct handover_cfg *ho, TYPE val); \ |
| bool ho_isset_##NAME(struct handover_cfg *ho); \ |
| void ho_clear_##NAME(struct handover_cfg *ho); \ |
| bool ho_isset_on_parent_##NAME(struct handover_cfg *ho); |
| |
| HO_CFG_ALL_MEMBERS |
| #undef HO_CFG_ONE_MEMBER |