Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 1 | /* |
| 2 | * Data for the true BSC |
| 3 | * |
Holger Hans Peter Freyther | 32dd2f3 | 2015-04-01 18:15:48 +0200 | [diff] [blame] | 4 | * (C) 2010-2015 by Holger Hans Peter Freyther <zecke@selfish.org> |
| 5 | * (C) 2010-2015 by On-Waves |
Harald Welte | 68e4be9 | 2018-05-26 22:42:29 +0200 | [diff] [blame] | 6 | * (C) 2018 by Harald Welte <laforge@gnumonks.org> |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 7 | * All Rights Reserved |
| 8 | * |
| 9 | * This program is free software; you can redistribute it and/or modify |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 10 | * it under the terms of the GNU Affero General Public License as published by |
| 11 | * the Free Software Foundation; either version 3 of the License, or |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 12 | * (at your option) any later version. |
| 13 | * |
| 14 | * This program is distributed in the hope that it will be useful, |
| 15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 17 | * GNU Affero General Public License for more details. |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 18 | * |
Harald Welte | 9af6ddf | 2011-01-01 15:25:50 +0100 | [diff] [blame] | 19 | * You should have received a copy of the GNU Affero General Public License |
| 20 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 21 | * |
| 22 | */ |
| 23 | |
Neels Hofmeyr | 9762b4c | 2017-02-23 21:41:20 +0100 | [diff] [blame] | 24 | /* |
| 25 | * NOTE: This is about a *remote* MSC for OsmoBSC and is not part of libmsc. |
| 26 | */ |
| 27 | |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 28 | #ifndef _OSMO_MSC_DATA_H |
| 29 | #define _OSMO_MSC_DATA_H |
| 30 | |
Harald Welte | 584ab8e | 2018-05-25 17:35:54 +0200 | [diff] [blame] | 31 | #include "debug.h" |
Pau Espin Pedrol | 2cfd000 | 2019-03-12 18:53:26 +0100 | [diff] [blame] | 32 | #include "osmo_bsc_lcls.h" |
Pau Espin Pedrol | 6c548dc | 2019-04-16 20:01:47 +0200 | [diff] [blame] | 33 | #include "osmux.h" |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 34 | |
Pablo Neira Ayuso | 136f453 | 2011-03-22 16:47:59 +0100 | [diff] [blame] | 35 | #include <osmocom/core/timer.h> |
Harald Welte | 1626f90 | 2018-05-26 22:56:59 +0200 | [diff] [blame] | 36 | #include <osmocom/core/select.h> |
Holger Hans Peter Freyther | 25aa749 | 2011-08-06 07:00:52 +0200 | [diff] [blame] | 37 | #include <osmocom/gsm/protocol/gsm_04_08.h> |
Holger Hans Peter Freyther | 5832b3e | 2010-09-16 02:14:41 +0800 | [diff] [blame] | 38 | |
Philipp Maier | 39f62bb | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 39 | |
| 40 | #include <osmocom/sigtran/osmo_ss7.h> |
| 41 | #include <osmocom/sigtran/sccp_sap.h> |
| 42 | #include <osmocom/sigtran/sccp_helpers.h> |
| 43 | #include <osmocom/sigtran/protocol/sua.h> |
| 44 | #include <osmocom/sigtran/protocol/m3ua.h> |
| 45 | #include <osmocom/core/fsm.h> |
Neels Hofmeyr | f93970b | 2018-03-05 02:09:40 +0100 | [diff] [blame] | 46 | #include <osmocom/gsm/gsm23003.h> |
Philipp Maier | 39f62bb | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 47 | |
Harald Welte | 584ab8e | 2018-05-25 17:35:54 +0200 | [diff] [blame] | 48 | #include <errno.h> |
Holger Hans Peter Freyther | 83d2d38 | 2011-06-09 17:37:04 +0200 | [diff] [blame] | 49 | |
Holger Hans Peter Freyther | 9a8b5ae | 2010-09-15 23:53:54 +0800 | [diff] [blame] | 50 | struct osmo_bsc_rf; |
Holger Hans Peter Freyther | 620c2e6 | 2010-11-14 20:38:06 +0100 | [diff] [blame] | 51 | struct gsm_network; |
Holger Hans Peter Freyther | 9a8b5ae | 2010-09-15 23:53:54 +0800 | [diff] [blame] | 52 | |
Alexander Chemeris | e26b153 | 2020-05-08 02:37:47 +0300 | [diff] [blame] | 53 | /* Constants for the MSC rate counters */ |
| 54 | enum { |
Alexander Chemeris | 98824b8 | 2020-05-09 21:27:40 +0300 | [diff] [blame] | 55 | /* Rx message counters */ |
Alexander Chemeris | e26b153 | 2020-05-08 02:37:47 +0300 | [diff] [blame] | 56 | MSC_CTR_BSSMAP_RX_UDT_RESET_ACKNOWLEDGE, |
| 57 | MSC_CTR_BSSMAP_RX_UDT_RESET, |
| 58 | MSC_CTR_BSSMAP_RX_UDT_PAGING, |
| 59 | MSC_CTR_BSSMAP_RX_UDT_UNKNOWN, |
| 60 | MSC_CTR_BSSMAP_RX_DT1_CLEAR_CMD, |
| 61 | MSC_CTR_BSSMAP_RX_DT1_CIPHER_MODE_CMD, |
| 62 | MSC_CTR_BSSMAP_RX_DT1_ASSIGMENT_RQST, |
| 63 | MSC_CTR_BSSMAP_RX_DT1_LCLS_CONNECT_CTRL, |
| 64 | MSC_CTR_BSSMAP_RX_DT1_HANDOVER_CMD, |
| 65 | MSC_CTR_BSSMAP_RX_DT1_CLASSMARK_RQST, |
Alexander Chemeris | 3a656da | 2020-05-13 00:47:03 +0300 | [diff] [blame] | 66 | MSC_CTR_BSSMAP_RX_DT1_CONFUSION, |
Alexander Chemeris | e26b153 | 2020-05-08 02:37:47 +0300 | [diff] [blame] | 67 | MSC_CTR_BSSMAP_RX_DT1_UNKNOWN, |
Alexander Chemeris | aac5423 | 2020-05-10 01:49:34 +0300 | [diff] [blame] | 68 | MSC_CTR_BSSMAP_RX_DT1_DTAP, |
| 69 | MSC_CTR_BSSMAP_RX_DT1_DTAP_ERROR, |
Alexander Chemeris | 98824b8 | 2020-05-09 21:27:40 +0300 | [diff] [blame] | 70 | |
| 71 | /* Tx message counters (per connection type) */ |
| 72 | MSC_CTR_BSSMAP_TX_BSS_MANAGEMENT, |
| 73 | MSC_CTR_BSSMAP_TX_DTAP, |
| 74 | MSC_CTR_BSSMAP_TX_UNKNOWN, |
| 75 | MSC_CTR_BSSMAP_TX_SHORT, |
| 76 | MSC_CTR_BSSMAP_TX_ERR_CONN_NOT_READY, |
| 77 | MSC_CTR_BSSMAP_TX_ERR_SEND, |
| 78 | MSC_CTR_BSSMAP_TX_SUCCESS, |
| 79 | |
| 80 | /* Tx message counters (per message type) */ |
| 81 | MSC_CTR_BSSMAP_TX_UDT_RESET, |
| 82 | MSC_CTR_BSSMAP_TX_UDT_RESET_ACK, |
| 83 | MSC_CTR_BSSMAP_TX_DT1_CLEAR_RQST, |
| 84 | MSC_CTR_BSSMAP_TX_DT1_CLEAR_COMPLETE, |
| 85 | MSC_CTR_BSSMAP_TX_DT1_ASSIGMENT_FAILURE, |
| 86 | MSC_CTR_BSSMAP_TX_DT1_ASSIGMENT_COMPLETE, |
| 87 | MSC_CTR_BSSMAP_TX_DT1_SAPI_N_REJECT, |
| 88 | MSC_CTR_BSSMAP_TX_DT1_CIPHER_COMPLETE, |
| 89 | MSC_CTR_BSSMAP_TX_DT1_CIPHER_REJECT, |
| 90 | MSC_CTR_BSSMAP_TX_DT1_CLASSMARK_UPDATE, |
| 91 | MSC_CTR_BSSMAP_TX_DT1_LCLS_CONNECT_CTRL_ACK, |
| 92 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_REQUIRED, |
| 93 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_PERFORMED, |
| 94 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_RQST_ACKNOWLEDGE, |
| 95 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_DETECT, |
| 96 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_COMPLETE, |
| 97 | MSC_CTR_BSSMAP_TX_DT1_HANDOVER_FAILURE, |
| 98 | MSC_CTR_BSSMAP_TX_DT1_DTAP, |
Neels Hofmeyr | 1c963eb | 2020-06-16 12:08:39 +0200 | [diff] [blame] | 99 | |
| 100 | MSC_CTR_MSCPOOL_SUBSCR_NEW, |
| 101 | MSC_CTR_MSCPOOL_SUBSCR_REATTACH, |
| 102 | MSC_CTR_MSCPOOL_SUBSCR_KNOWN, |
| 103 | MSC_CTR_MSCPOOL_SUBSCR_PAGED, |
| 104 | MSC_CTR_MSCPOOL_SUBSCR_ATTACH_LOST, |
| 105 | MSC_CTR_MSCPOOL_EMERG_FORWARDED, |
Alexander Chemeris | e26b153 | 2020-05-08 02:37:47 +0300 | [diff] [blame] | 106 | }; |
| 107 | |
Alexander Chemeris | 5e89333 | 2020-05-07 16:41:26 +0300 | [diff] [blame] | 108 | /* Constants for the MSC stats */ |
| 109 | enum { |
| 110 | MSC_STAT_MSC_LINKS_ACTIVE, |
| 111 | MSC_STAT_MSC_LINKS_TOTAL, |
| 112 | }; |
| 113 | |
Neels Hofmeyr | 9762b4c | 2017-02-23 21:41:20 +0100 | [diff] [blame] | 114 | /*! /brief Information on a remote MSC for libbsc. |
| 115 | */ |
Neels Hofmeyr | a369e24 | 2017-02-23 21:57:23 +0100 | [diff] [blame] | 116 | struct bsc_msc_data { |
Holger Hans Peter Freyther | 20fea24 | 2011-06-04 19:58:26 +0200 | [diff] [blame] | 117 | struct llist_head entry; |
| 118 | |
Daniel Willmann | 163f612 | 2011-03-03 13:48:28 +0100 | [diff] [blame] | 119 | /* Back pointer */ |
| 120 | struct gsm_network *network; |
| 121 | |
Holger Hans Peter Freyther | 18fa70a | 2011-06-08 19:25:38 +0200 | [diff] [blame] | 122 | int allow_emerg; |
Holger Hans Peter Freyther | 210565e | 2011-06-07 20:56:18 +0200 | [diff] [blame] | 123 | |
Holger Hans Peter Freyther | 47b2601 | 2010-09-15 23:28:49 +0800 | [diff] [blame] | 124 | /* Connection data */ |
Neels Hofmeyr | f93970b | 2018-03-05 02:09:40 +0100 | [diff] [blame] | 125 | struct osmo_plmn_id core_plmn; |
Holger Hans Peter Freyther | 32dd2f3 | 2015-04-01 18:15:48 +0200 | [diff] [blame] | 126 | int core_lac; |
| 127 | int core_ci; |
Holger Hans Peter Freyther | 47b2601 | 2010-09-15 23:28:49 +0800 | [diff] [blame] | 128 | |
Holger Hans Peter Freyther | 7bf66c5 | 2010-11-03 13:55:49 +0100 | [diff] [blame] | 129 | /* audio codecs */ |
Holger Hans Peter Freyther | 25aa749 | 2011-08-06 07:00:52 +0200 | [diff] [blame] | 130 | struct gsm48_multi_rate_conf amr_conf; |
Philipp Maier | 0d9a1a7 | 2019-03-07 16:50:34 +0100 | [diff] [blame] | 131 | bool amr_octet_aligned; |
Holger Hans Peter Freyther | 7bf66c5 | 2010-11-03 13:55:49 +0100 | [diff] [blame] | 132 | struct gsm_audio_support **audio_support; |
| 133 | int audio_length; |
Harald Welte | 1f1c56c | 2018-06-03 12:24:27 +0200 | [diff] [blame] | 134 | enum bsc_lcls_mode lcls_mode; |
Philipp Maier | 4833857 | 2018-07-10 09:32:27 +0200 | [diff] [blame] | 135 | bool lcls_codec_mismatch_allow; |
Holger Hans Peter Freyther | 7bf66c5 | 2010-11-03 13:55:49 +0100 | [diff] [blame] | 136 | |
Holger Hans Peter Freyther | 20fea24 | 2011-06-04 19:58:26 +0200 | [diff] [blame] | 137 | int nr; |
Jacob Erlbeck | 1b89402 | 2013-08-28 10:16:54 +0200 | [diff] [blame] | 138 | |
Alexander Chemeris | 5e89333 | 2020-05-07 16:41:26 +0300 | [diff] [blame] | 139 | /* structures for keeping rate counters and gauge stats */ |
| 140 | struct rate_ctr_group *msc_ctrs; |
| 141 | struct osmo_stat_item_group *msc_statg; |
| 142 | |
Philipp Maier | 39f62bb | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 143 | /* Sigtran connection data */ |
| 144 | struct { |
| 145 | uint32_t cs7_instance; |
| 146 | bool cs7_instance_valid; |
| 147 | struct osmo_sccp_instance *sccp; |
| 148 | struct osmo_sccp_user *sccp_user; |
| 149 | |
Harald Welte | 3909d99 | 2018-05-25 15:51:05 +0200 | [diff] [blame] | 150 | /* IPA or M3UA or SUA? */ |
| 151 | enum osmo_ss7_asp_protocol asp_proto; |
| 152 | |
Philipp Maier | 39f62bb | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 153 | /* Holds a copy of the our local MSC address, |
| 154 | * this will be the sccp-address that is associated |
| 155 | * with the A interface of this particular BSC, |
| 156 | * this address is filled up by the VTY interface */ |
| 157 | struct osmo_sccp_addr bsc_addr; |
| 158 | char *bsc_addr_name; |
| 159 | |
| 160 | /* Holds a copy of the MSC address. This is the |
| 161 | * address of the MSC that handles the calls of |
| 162 | * this BSC. The address is configured via the |
| 163 | * VTY interface */ |
| 164 | struct osmo_sccp_addr msc_addr; |
| 165 | char *msc_addr_name; |
| 166 | |
Philipp Maier | 0b10399 | 2018-05-07 12:43:28 +0200 | [diff] [blame] | 167 | /* Pointer to the osmo-fsm that controls the |
| 168 | * BSSMAP RESET procedure */ |
| 169 | struct osmo_fsm_inst *reset_fsm; |
Philipp Maier | 39f62bb | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 170 | } a; |
Neels Hofmeyr | d8f46c0 | 2018-08-23 17:28:55 +0200 | [diff] [blame] | 171 | |
| 172 | uint32_t x_osmo_ign; |
| 173 | bool x_osmo_ign_configured; |
Pau Espin Pedrol | 6c548dc | 2019-04-16 20:01:47 +0200 | [diff] [blame] | 174 | |
| 175 | /* Whether we want to use Osmux against this MSC. Controlled via VTY */ |
| 176 | enum osmux_usage use_osmux; |
Pau Espin Pedrol | a94907e | 2019-04-16 20:03:15 +0200 | [diff] [blame] | 177 | /* Whether we detected the MSC supports Osmux (during BSSMAP_RESET) */ |
| 178 | bool remote_supports_osmux; |
Harald Welte | 1626f90 | 2018-05-26 22:56:59 +0200 | [diff] [blame] | 179 | |
| 180 | /* Proxy between IPA/SCCPlite encapsulated MGCP and UDP */ |
| 181 | struct { |
| 182 | /* local (BSC) IP address to be used */ |
| 183 | char *local_addr; |
| 184 | /* local (BSC) UDP port to be used to talk with MGW */ |
| 185 | uint16_t local_port; |
| 186 | /* UDP socket for proxying MGCP via SCCPlite/IPA */ |
| 187 | struct osmo_fd ofd; |
| 188 | } mgcp_ipa; |
Neels Hofmeyr | 4099f1d | 2020-05-26 03:58:14 +0200 | [diff] [blame] | 189 | |
| 190 | struct osmo_nri_ranges *nri_ranges; |
Neels Hofmeyr | b69db82 | 2020-06-11 02:36:29 +0200 | [diff] [blame] | 191 | bool allow_attach; |
Holger Hans Peter Freyther | 8ec4952 | 2011-08-15 15:53:00 +0200 | [diff] [blame] | 192 | }; |
| 193 | |
Neels Hofmeyr | a369e24 | 2017-02-23 21:57:23 +0100 | [diff] [blame] | 194 | int osmo_bsc_msc_init(struct bsc_msc_data *msc); |
Holger Hans Peter Freyther | f3d1ae7 | 2010-11-03 16:40:03 +0100 | [diff] [blame] | 195 | int osmo_bsc_sccp_init(struct gsm_network *gsmnet); |
Holger Hans Peter Freyther | 5832b3e | 2010-09-16 02:14:41 +0800 | [diff] [blame] | 196 | |
Holger Hans Peter Freyther | 620c2e6 | 2010-11-14 20:38:06 +0100 | [diff] [blame] | 197 | int osmo_bsc_audio_init(struct gsm_network *network); |
| 198 | |
Neels Hofmeyr | a369e24 | 2017-02-23 21:57:23 +0100 | [diff] [blame] | 199 | struct bsc_msc_data *osmo_msc_data_find(struct gsm_network *, int); |
| 200 | struct bsc_msc_data *osmo_msc_data_alloc(struct gsm_network *, int); |
Holger Hans Peter Freyther | 20fea24 | 2011-06-04 19:58:26 +0200 | [diff] [blame] | 201 | |
Pau Espin Pedrol | a115052 | 2019-03-12 18:55:57 +0100 | [diff] [blame] | 202 | |
| 203 | struct osmo_cell_global_id *cgi_for_msc(struct bsc_msc_data *msc, struct gsm_bts *bts); |
| 204 | |
Harald Welte | 584ab8e | 2018-05-25 17:35:54 +0200 | [diff] [blame] | 205 | /* Helper function to calculate the port number for a given |
| 206 | * timeslot/multiplex. This functionality is needed to support |
| 207 | * the sccp-lite scenario where the MGW is handled externally */ |
| 208 | static inline int mgcp_timeslot_to_port(int multiplex, int timeslot, int base) |
| 209 | { |
| 210 | if (timeslot == 0) { |
| 211 | LOGP(DLMGCP, LOGL_ERROR, "Timeslot should not be 0\n"); |
| 212 | timeslot = 255; |
| 213 | } |
| 214 | |
| 215 | return base + (timeslot + (32 * multiplex)) * 2; |
| 216 | } |
| 217 | |
| 218 | static inline int mgcp_port_to_cic(uint16_t port, uint16_t base) |
| 219 | { |
| 220 | if (port < base) |
| 221 | return -EINVAL; |
| 222 | return (port - base) / 2; |
| 223 | } |
| 224 | |
Pau Espin Pedrol | ed41e8c | 2019-06-06 16:44:20 +0200 | [diff] [blame] | 225 | static inline bool msc_is_aoip(const struct bsc_msc_data *msc) |
| 226 | { |
| 227 | switch (msc->a.asp_proto) { |
| 228 | case OSMO_SS7_ASP_PROT_SUA: |
| 229 | case OSMO_SS7_ASP_PROT_M3UA: |
| 230 | return true; |
| 231 | default: |
| 232 | return false; |
| 233 | } |
| 234 | } |
| 235 | |
| 236 | static inline bool msc_is_sccplite(const struct bsc_msc_data *msc) |
| 237 | { |
| 238 | switch (msc->a.asp_proto) { |
| 239 | case OSMO_SS7_ASP_PROT_IPA: |
| 240 | return true; |
| 241 | default: |
| 242 | return false; |
| 243 | } |
| 244 | } |
Holger Hans Peter Freyther | 20fea24 | 2011-06-04 19:58:26 +0200 | [diff] [blame] | 245 | |
Holger Hans Peter Freyther | 3e8e046 | 2010-09-15 22:29:25 +0800 | [diff] [blame] | 246 | #endif |