Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 1 | /*! \file gsm23003.h */ |
| 2 | |
Harald Welte | bda26c0 | 2016-05-11 09:13:08 +0200 | [diff] [blame] | 3 | #pragma once |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 4 | |
Harald Welte | bda26c0 | 2016-05-11 09:13:08 +0200 | [diff] [blame] | 5 | #include <stdint.h> |
Neels Hofmeyr | 9cd1e74 | 2017-10-04 03:15:47 +0200 | [diff] [blame] | 6 | #include <stdbool.h> |
Harald Welte | bda26c0 | 2016-05-11 09:13:08 +0200 | [diff] [blame] | 7 | |
| 8 | /* 23.003 Chapter 12.1 */ |
| 9 | struct osmo_plmn_id { |
| 10 | uint16_t mcc; |
| 11 | uint16_t mnc; |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 12 | bool mnc_3_digits; /*< ignored and implied true if mnc > 99, otherwise defines leading zeros. */ |
Harald Welte | bda26c0 | 2016-05-11 09:13:08 +0200 | [diff] [blame] | 13 | }; |
| 14 | |
| 15 | /* 4.1 */ |
| 16 | struct osmo_location_area_id { |
| 17 | struct osmo_plmn_id plmn; |
| 18 | uint16_t lac; |
| 19 | }; |
| 20 | |
| 21 | /* 4.2 */ |
| 22 | struct osmo_routing_area_id { |
| 23 | struct osmo_location_area_id lac; |
| 24 | uint8_t rac; |
| 25 | }; |
| 26 | |
| 27 | /* 4.3.1 */ |
| 28 | struct osmo_cell_global_id { |
| 29 | struct osmo_location_area_id lai; |
| 30 | uint16_t cell_identity; |
| 31 | }; |
| 32 | |
Pau Espin Pedrol | b5551ee | 2022-02-16 13:09:32 +0100 | [diff] [blame] | 33 | /* 3GPP TS 48.018: |
| 34 | * 8c.1.4.1.1 GERAN BSS identification (RIM) |
| 35 | * sec 11.3.9 Cell Identifier */ |
Pau Espin Pedrol | ca33a71 | 2021-01-05 19:36:48 +0100 | [diff] [blame] | 36 | struct osmo_cell_global_id_ps { |
| 37 | struct osmo_routing_area_id rai; |
| 38 | uint16_t cell_identity; |
| 39 | }; |
| 40 | |
Neels Hofmeyr | 3a50453 | 2019-02-10 22:28:27 +0100 | [diff] [blame] | 41 | /*! Bitmask of items contained in a struct osmo_cell_global_id. |
| 42 | * See also gsm0808_cell_id_to_cgi(). |
| 43 | */ |
| 44 | enum osmo_cgi_part { |
| 45 | OSMO_CGI_PART_PLMN = 1, |
| 46 | OSMO_CGI_PART_LAC = 2, |
| 47 | OSMO_CGI_PART_CI = 4, |
Pau Espin Pedrol | ca33a71 | 2021-01-05 19:36:48 +0100 | [diff] [blame] | 48 | OSMO_CGI_PART_RAC = 8, |
Neels Hofmeyr | 3a50453 | 2019-02-10 22:28:27 +0100 | [diff] [blame] | 49 | }; |
| 50 | |
Stefan Sperling | 11a4d9d | 2018-02-15 18:28:04 +0100 | [diff] [blame] | 51 | /* Actually defined in 3GPP TS 48.008 3.2.2.27 Cell Identifier List, |
| 52 | * but conceptually belongs with the above structures. */ |
| 53 | struct osmo_lac_and_ci_id { |
| 54 | uint16_t lac; |
| 55 | uint16_t ci; |
| 56 | }; |
| 57 | |
Harald Welte | bda26c0 | 2016-05-11 09:13:08 +0200 | [diff] [blame] | 58 | /* 12.5 */ |
| 59 | struct osmo_service_area_id { |
| 60 | struct osmo_location_area_id lai; |
| 61 | uint16_t sac; |
| 62 | }; |
| 63 | |
| 64 | /* 12.6 */ |
| 65 | struct osmo_shared_network_area_id { |
| 66 | struct osmo_plmn_id plmn; |
| 67 | uint32_t snac; |
| 68 | }; |
| 69 | |
| 70 | /* 5.1 */ |
| 71 | enum osmo_gsn_addr_type { |
| 72 | GSN_ADDR_TYPE_IPV4 = 0, |
| 73 | GSN_ADDR_TYPE_IPV6 = 1, |
| 74 | }; |
| 75 | |
| 76 | /* 5.1 */ |
| 77 | struct osmo_gsn_address { |
| 78 | enum osmo_gsn_addr_type type; |
| 79 | uint8_t length; |
| 80 | uint8_t addr[16]; |
| 81 | }; |
| 82 | |
| 83 | /* 19.4.2.3 */ |
| 84 | struct osmo_tracking_area_id { |
| 85 | struct osmo_plmn_id plmn; |
| 86 | uint16_t tac; |
| 87 | }; |
| 88 | |
| 89 | struct osmo_eutran_cell_global_id { |
| 90 | struct osmo_plmn_id plmn; |
| 91 | uint32_t eci; /* FIXME */ |
| 92 | }; |
| 93 | |
| 94 | /* 2.8.1 */ |
| 95 | struct osmo_mme_id { |
| 96 | uint16_t group_id; |
| 97 | uint8_t code; |
| 98 | }; |
| 99 | |
| 100 | /* 2.8.1 */ |
| 101 | struct osmo_gummei { |
| 102 | struct osmo_plmn_id plmn; |
| 103 | struct osmo_mme_id mme; |
| 104 | }; |
| 105 | |
| 106 | /* 2.8.1 */ |
| 107 | struct osmo_guti { |
| 108 | struct osmo_gummei gummei; |
| 109 | uint32_t mtmsi; |
| 110 | }; |
Neels Hofmeyr | 9cd1e74 | 2017-10-04 03:15:47 +0200 | [diff] [blame] | 111 | |
| 112 | bool osmo_imsi_str_valid(const char *imsi); |
| 113 | bool osmo_msisdn_str_valid(const char *msisdn); |
Oliver Smith | 894be2d | 2019-01-11 13:13:37 +0100 | [diff] [blame] | 114 | bool osmo_imei_str_valid(const char *imei, bool with_15th_digit); |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 115 | |
| 116 | const char *osmo_mcc_name(uint16_t mcc); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 117 | char *osmo_mcc_name_buf(char *buf, size_t buf_len, uint16_t mcc); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 118 | const char *osmo_mcc_name_c(const void *ctx, uint16_t mcc); |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 119 | const char *osmo_mnc_name(uint16_t mnc, bool mnc_3_digits); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 120 | char *osmo_mnc_name_buf(char *buf, size_t buf_len, uint16_t mnc, bool mnc_3_digits); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 121 | char *osmo_mnc_name_c(const void *ctx, uint16_t mnc, bool mnc_3_digits); |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 122 | const char *osmo_plmn_name(const struct osmo_plmn_id *plmn); |
| 123 | const char *osmo_plmn_name2(const struct osmo_plmn_id *plmn); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 124 | char *osmo_plmn_name_buf(char *buf, size_t buf_len, const struct osmo_plmn_id *plmn); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 125 | char *osmo_plmn_name_c(const void *ctx, const struct osmo_plmn_id *plmn); |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 126 | const char *osmo_lai_name(const struct osmo_location_area_id *lai); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 127 | char *osmo_lai_name_buf(char *buf, size_t buf_len, const struct osmo_location_area_id *lai); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 128 | char *osmo_lai_name_c(const void *ctx, const struct osmo_location_area_id *lai); |
Pau Espin Pedrol | ca33a71 | 2021-01-05 19:36:48 +0100 | [diff] [blame] | 129 | const char *osmo_rai_name2(const struct osmo_routing_area_id *rai); |
| 130 | char *osmo_rai_name2_buf(char *buf, size_t buf_len, const struct osmo_routing_area_id *rai); |
| 131 | char *osmo_rai_name2_c(const void *ctx, const struct osmo_routing_area_id *rai); |
Neels Hofmeyr | 4349620 | 2018-03-22 14:04:30 +0100 | [diff] [blame] | 132 | const char *osmo_cgi_name(const struct osmo_cell_global_id *cgi); |
| 133 | const char *osmo_cgi_name2(const struct osmo_cell_global_id *cgi); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 134 | char *osmo_cgi_name_buf(char *buf, size_t buf_len, const struct osmo_cell_global_id *cgi); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 135 | char *osmo_cgi_name_c(const void *ctx, const struct osmo_cell_global_id *cgi); |
Pau Espin Pedrol | ca33a71 | 2021-01-05 19:36:48 +0100 | [diff] [blame] | 136 | const char *osmo_cgi_ps_name(const struct osmo_cell_global_id_ps *cgi_ps); |
| 137 | const char *osmo_cgi_ps_name2(const struct osmo_cell_global_id_ps *cgi_ps); |
| 138 | char *osmo_cgi_ps_name_buf(char *buf, size_t buf_len, const struct osmo_cell_global_id_ps *cgi_ps); |
| 139 | char *osmo_cgi_ps_name_c(const void *ctx, const struct osmo_cell_global_id_ps *cgi_ps); |
Pau Espin Pedrol | b5551ee | 2022-02-16 13:09:32 +0100 | [diff] [blame] | 140 | const char *osmo_sai_name(const struct osmo_service_area_id *sai); |
| 141 | const char *osmo_sai_name2(const struct osmo_service_area_id *sai); |
| 142 | char *osmo_sai_name_buf(char *buf, size_t buf_len, const struct osmo_service_area_id *sai); |
| 143 | char *osmo_sai_name_c(const void *ctx, const struct osmo_service_area_id *sai); |
Harald Welte | de1da35 | 2018-10-08 22:27:04 +0200 | [diff] [blame] | 144 | const char *osmo_gummei_name(const struct osmo_gummei *gummei); |
Harald Welte | 4a62eda | 2019-03-18 18:27:00 +0100 | [diff] [blame] | 145 | char *osmo_gummei_name_buf(char *buf, size_t buf_len, const struct osmo_gummei *gummei); |
Harald Welte | 179f357 | 2019-03-18 18:38:47 +0100 | [diff] [blame] | 146 | char *osmo_gummei_name_c(const void *ctx, const struct osmo_gummei *gummei); |
Neels Hofmeyr | c4fce14 | 2018-02-20 13:47:08 +0100 | [diff] [blame] | 147 | |
| 148 | void osmo_plmn_to_bcd(uint8_t *bcd_dst, const struct osmo_plmn_id *plmn); |
| 149 | void osmo_plmn_from_bcd(const uint8_t *bcd_src, struct osmo_plmn_id *plmn); |
Neels Hofmeyr | 721aa6d | 2018-02-20 21:38:00 +0100 | [diff] [blame] | 150 | |
| 151 | int osmo_mnc_from_str(const char *mnc_str, uint16_t *mnc, bool *mnc_3_digits); |
| 152 | |
Neels Hofmeyr | 4d68fd0 | 2018-03-05 04:16:48 +0100 | [diff] [blame] | 153 | /* Convert string to MCC. |
| 154 | * \param mcc_str[in] String representation of an MCC, with or without leading zeros. |
| 155 | * \param mcc[out] MCC result buffer, or NULL. |
| 156 | * \returns zero on success, -EINVAL in case of surplus characters, negative errno in case of conversion |
| 157 | * errors. In case of error, do not modify the out-arguments. |
| 158 | */ |
| 159 | static inline int osmo_mcc_from_str(const char *mcc_str, uint16_t *mcc) |
| 160 | { |
| 161 | return osmo_mnc_from_str(mcc_str, mcc, NULL); |
| 162 | } |
| 163 | |
Neels Hofmeyr | 721aa6d | 2018-02-20 21:38:00 +0100 | [diff] [blame] | 164 | int osmo_mnc_cmp(uint16_t a_mnc, bool a_mnc_3_digits, uint16_t b_mnc, bool b_mnc_3_digits); |
| 165 | int osmo_plmn_cmp(const struct osmo_plmn_id *a, const struct osmo_plmn_id *b); |
Neels Hofmeyr | d01ef75 | 2018-09-21 15:57:26 +0200 | [diff] [blame] | 166 | int osmo_lai_cmp(const struct osmo_location_area_id *a, const struct osmo_location_area_id *b); |
Pau Espin Pedrol | d426ba6 | 2021-01-22 17:44:34 +0100 | [diff] [blame] | 167 | int osmo_rai_cmp(const struct osmo_routing_area_id *a, const struct osmo_routing_area_id *b); |
Neels Hofmeyr | d01ef75 | 2018-09-21 15:57:26 +0200 | [diff] [blame] | 168 | int osmo_cgi_cmp(const struct osmo_cell_global_id *a, const struct osmo_cell_global_id *b); |
Pau Espin Pedrol | d426ba6 | 2021-01-22 17:44:34 +0100 | [diff] [blame] | 169 | int osmo_cgi_ps_cmp(const struct osmo_cell_global_id_ps *a, const struct osmo_cell_global_id_ps *b); |
Harald Welte | de1da35 | 2018-10-08 22:27:04 +0200 | [diff] [blame] | 170 | |
| 171 | int osmo_gen_home_network_domain(char *out, const struct osmo_plmn_id *plmn); |
| 172 | int osmo_parse_home_network_domain(struct osmo_plmn_id *out, const char *in); |
| 173 | int osmo_gen_mme_domain(char *out, const struct osmo_gummei *gummei); |
| 174 | int osmo_gen_mme_group_domain(char *out, uint16_t mmegi, const struct osmo_plmn_id *plmn); |
| 175 | int osmo_parse_mme_domain(struct osmo_gummei *out, const char *in); |