Vadim Yanitskiy | 2eaee70 | 2019-02-14 16:44:45 +0700 | [diff] [blame] | 1 | #pragma once |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 2 | |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 3 | #include <osmocom/msc/gsm_data.h> |
| 4 | #include <osmocom/msc/gsm_subscriber.h> |
Pablo Neira Ayuso | 136f453 | 2011-03-22 16:47:59 +0100 | [diff] [blame] | 5 | #include <osmocom/core/linuxlist.h> |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 6 | #include <osmocom/core/fsm.h> |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 7 | #include <osmocom/msc/gsm_04_11.h> |
| 8 | #include <osmocom/msc/mncc.h> |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 9 | #include <osmocom/msc/msc_a.h> |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 10 | #include <osmocom/msc/debug.h> |
Neels Hofmeyr | 4c57bb0 | 2022-01-13 18:53:10 +0100 | [diff] [blame] | 11 | #include <osmocom/msc/codec_filter.h> |
Oliver Smith | 1063213 | 2023-05-12 12:14:22 +0200 | [diff] [blame] | 12 | #include <osmocom/msc/csd_filter.h> |
Andreas Eversberg | f7396ea | 2011-10-28 04:07:07 +0200 | [diff] [blame] | 13 | #include <osmocom/gsm/gsm0411_smc.h> |
Andreas Eversberg | bc6c43f | 2011-10-28 11:11:13 +0200 | [diff] [blame] | 14 | #include <osmocom/gsm/gsm0411_smr.h> |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 15 | |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 16 | struct vty; |
| 17 | |
Max | d8daaae | 2019-02-14 16:54:10 +0700 | [diff] [blame] | 18 | /* Used for late TID assignment */ |
| 19 | #define TRANS_ID_UNASSIGNED 0xff |
| 20 | |
Neels Hofmeyr | 1c06507 | 2022-08-07 02:43:15 +0200 | [diff] [blame] | 21 | #define LOG_TRANS_CAT_SRC(trans, subsys, level, file, line, fmt, args...) \ |
| 22 | LOGPSRC(subsys, level, file, line, \ |
| 23 | "trans(%s %s callref-0x%x tid-%u%s) " fmt, \ |
| 24 | (trans) ? trans_name(trans) : "NULL", \ |
| 25 | (trans) ? ((trans)->msc_a ? (trans)->msc_a->c.fi->id : vlr_subscr_name((trans)->vsub)) : "NULL", \ |
| 26 | (trans) ? (trans)->callref : 0, \ |
| 27 | (trans) ? (trans)->transaction_id : 0, \ |
| 28 | (trans) && (trans)->paging_request ? ",PAGING" : "", \ |
| 29 | ##args) |
| 30 | |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 31 | #define LOG_TRANS_CAT(trans, subsys, level, fmt, args...) \ |
Neels Hofmeyr | 1c06507 | 2022-08-07 02:43:15 +0200 | [diff] [blame] | 32 | LOG_TRANS_CAT_SRC(trans, subsys, level, __FILE__, __LINE__, fmt, ##args) |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 33 | |
| 34 | #define LOG_TRANS(trans, level, fmt, args...) \ |
Sylvain Munaut | 762bb04 | 2019-05-10 11:56:02 +0200 | [diff] [blame] | 35 | LOG_TRANS_CAT(trans, (trans) ? (trans)->log_subsys : DMSC, level, fmt, ##args) |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 36 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 37 | enum bridge_state { |
| 38 | BRIDGE_STATE_NONE, |
| 39 | BRIDGE_STATE_LOOPBACK_PENDING, |
| 40 | BRIDGE_STATE_LOOPBACK_ESTABLISHED, |
| 41 | BRIDGE_STATE_BRIDGE_PENDING, |
| 42 | BRIDGE_STATE_BRIDGE_ESTABLISHED, |
| 43 | }; |
| 44 | |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 45 | enum trans_type { |
Andreas Eversberg | 456c6f7 | 2023-04-23 11:54:16 +0200 | [diff] [blame] | 46 | TRANS_GCC = GSM48_PDISC_GROUP_CC, |
| 47 | TRANS_BCC = GSM48_PDISC_BCAST_CC, |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 48 | TRANS_CC = GSM48_PDISC_CC, |
| 49 | TRANS_SMS = GSM48_PDISC_SMS, |
| 50 | TRANS_USSD = GSM48_PDISC_NC_SS, |
| 51 | TRANS_SILENT_CALL, |
| 52 | }; |
| 53 | |
| 54 | extern const struct value_string trans_type_names[]; |
| 55 | static inline const char *trans_type_name(enum trans_type val) |
| 56 | { return get_value_string(trans_type_names, val); } |
| 57 | |
| 58 | uint8_t trans_type_to_gsm48_proto(enum trans_type type); |
| 59 | |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 60 | /* One transaction */ |
| 61 | struct gsm_trans { |
| 62 | /* Entry in list of all transactions */ |
| 63 | struct llist_head entry; |
| 64 | |
Neels Hofmeyr | 8ce66fd | 2016-08-29 17:52:39 +0200 | [diff] [blame] | 65 | /* Back pointer to the network struct */ |
Jacob Erlbeck | f07c605 | 2014-12-02 11:58:00 +0100 | [diff] [blame] | 66 | struct gsm_network *net; |
| 67 | |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 68 | /* What kind of transaction */ |
| 69 | enum trans_type type; |
Neels Hofmeyr | 7f85ace | 2019-05-09 15:12:34 +0200 | [diff] [blame] | 70 | /* Which category to log on, for LOG_TRANS(). */ |
| 71 | int log_subsys; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 72 | |
| 73 | /* The current transaction ID */ |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 74 | uint8_t transaction_id; |
Neels Hofmeyr | 8ce66fd | 2016-08-29 17:52:39 +0200 | [diff] [blame] | 75 | |
Harald Welte | 0e2fa5d | 2018-04-09 16:35:01 +0200 | [diff] [blame] | 76 | /* The DLCI (DCCH/ACCH + SAPI) of this transaction */ |
| 77 | uint8_t dlci; |
| 78 | |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 79 | /* To whom we belong, unique identifier of remote MM entity */ |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 80 | struct vlr_subscr *vsub; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 81 | |
Holger Hans Peter Freyther | e95d482 | 2010-03-23 07:00:22 +0100 | [diff] [blame] | 82 | /* The associated connection we are using to transmit messages */ |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 83 | struct msc_a *msc_a; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 84 | |
| 85 | /* reference from MNCC or other application */ |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 86 | uint32_t callref; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 87 | |
Andreas Eversberg | 712b28e | 2023-06-21 11:17:26 +0200 | [diff] [blame] | 88 | /* reference that may be used by MGW to identify a call */ |
| 89 | uint32_t call_id; |
| 90 | |
Harald Welte | da7ab74 | 2009-12-19 22:23:05 +0100 | [diff] [blame] | 91 | /* if traffic channel receive was requested */ |
| 92 | int tch_recv; |
| 93 | |
Holger Hans Peter Freyther | 49b3ed2 | 2010-12-29 17:09:07 +0100 | [diff] [blame] | 94 | /* is thats one paging? */ |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 95 | struct paging_request *paging_request; |
Holger Hans Peter Freyther | 49b3ed2 | 2010-12-29 17:09:07 +0100 | [diff] [blame] | 96 | |
Philipp Maier | fbf6610 | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 97 | /* bearer capabilities (rate and codec) */ |
| 98 | struct gsm_mncc_bearer_cap bearer_cap; |
| 99 | |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 100 | union { |
| 101 | struct { |
Andreas Eversberg | e24636c | 2023-04-23 12:20:55 +0200 | [diff] [blame] | 102 | /* State machine of setup process towards BSS */ |
| 103 | struct osmo_fsm_inst *fi; |
| 104 | /* BSS list with all VGCS/VBS calls */ |
| 105 | struct llist_head bss_list; |
| 106 | /* Inactivity timeout and timer */ |
| 107 | int inactivity_to; |
| 108 | struct osmo_timer_list timer_inactivity; |
| 109 | /* If talker's downlink shall be muted */ |
| 110 | bool mute_talker; |
| 111 | /* Indicator, if Uplink is used in one cell */ |
| 112 | bool uplink_busy; |
| 113 | /* BSS that uses the uplink */ |
| 114 | struct vgcs_bss *uplink_bss; |
| 115 | /* Cell that uses the uplink */ |
| 116 | struct vgcs_bss_cell *uplink_cell; |
| 117 | /* If uplink is used by the originator */ |
| 118 | bool uplink_originator; |
| 119 | } gcc; |
| 120 | struct { |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 121 | |
| 122 | /* current call state */ |
| 123 | int state; |
| 124 | |
| 125 | /* current timer and message queue */ |
| 126 | int Tcurrent; /* current CC timer */ |
| 127 | int T308_second; /* used to send release again */ |
Pablo Neira Ayuso | bf540cb | 2011-05-06 12:11:06 +0200 | [diff] [blame] | 128 | struct osmo_timer_list timer; |
Philipp Maier | 9ca7b31 | 2018-10-10 17:00:49 +0200 | [diff] [blame] | 129 | struct osmo_timer_list timer_guard; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 130 | struct gsm_mncc msg; /* stores setup/disconnect/release message */ |
Neels Hofmeyr | cf90bdb | 2019-10-01 19:47:26 +0200 | [diff] [blame] | 131 | bool mncc_initiated; /* Whether an MNCC Release is necessary on failure */ |
Keith Whyte | a1a70be | 2021-05-16 02:59:52 +0200 | [diff] [blame] | 132 | struct osmo_lcls *lcls; |
Oliver Smith | 593cd88 | 2023-05-24 10:40:19 +0200 | [diff] [blame] | 133 | /* SDP as last received from the remote call leg. */ |
| 134 | struct sdp_msg remote; |
Oliver Smith | 1063213 | 2023-05-12 12:14:22 +0200 | [diff] [blame] | 135 | /* Track codec/CSD choices from BSS and remote call leg */ |
Neels Hofmeyr | 4c57bb0 | 2022-01-13 18:53:10 +0100 | [diff] [blame] | 136 | struct codec_filter codecs; |
Oliver Smith | 1063213 | 2023-05-12 12:14:22 +0200 | [diff] [blame] | 137 | struct csd_filter csd; |
Oliver Smith | c63c3a0 | 2023-05-24 10:48:07 +0200 | [diff] [blame] | 138 | /* Resulting choice from codecs/bearer services and the |
| 139 | * local RTP address to be sent to the remote call leg. */ |
| 140 | struct sdp_msg local; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 141 | } cc; |
| 142 | struct { |
Andreas Eversberg | f7396ea | 2011-10-28 04:07:07 +0200 | [diff] [blame] | 143 | struct gsm411_smc_inst smc_inst; |
Andreas Eversberg | bc6c43f | 2011-10-28 11:11:13 +0200 | [diff] [blame] | 144 | struct gsm411_smr_inst smr_inst; |
Andreas Eversberg | f7396ea | 2011-10-28 04:07:07 +0200 | [diff] [blame] | 145 | |
Ivan Kluchnikov | 9bd4fd6 | 2015-12-21 12:05:56 +0300 | [diff] [blame] | 146 | /* SM-RP-MR, Message Reference (see GSM TS 04.11, section 8.2.3) */ |
| 147 | uint8_t sm_rp_mr; |
Vadim Yanitskiy | 643270f | 2019-05-12 05:38:41 +0700 | [diff] [blame] | 148 | /* More Messages to Send (see 3GPP TS 29.002, section 7.6.8.7) */ |
| 149 | bool sm_rp_mmts_ind; |
Ivan Kluchnikov | 9bd4fd6 | 2015-12-21 12:05:56 +0300 | [diff] [blame] | 150 | |
Harald Welte | 7604218 | 2009-08-08 16:03:15 +0200 | [diff] [blame] | 151 | struct gsm_sms *sms; |
Mychaela N. Falconia | 02c4937 | 2023-09-25 05:13:49 +0000 | [diff] [blame] | 152 | |
| 153 | uint8_t *gsup_source_name; |
| 154 | size_t gsup_source_name_len; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 155 | } sms; |
Vadim Yanitskiy | f2f83b0 | 2018-06-17 21:09:28 +0700 | [diff] [blame] | 156 | struct { |
| 157 | /** |
| 158 | * Stores a GSM 04.80 message to be sent to |
| 159 | * a subscriber after successful Paging Response |
| 160 | */ |
| 161 | struct msgb *msg; |
Vadim Yanitskiy | 64623e1 | 2018-11-28 23:05:51 +0700 | [diff] [blame] | 162 | /* Inactivity timer, triggers transaction release */ |
| 163 | struct osmo_timer_list timer_guard; |
Vadim Yanitskiy | f2f83b0 | 2018-06-17 21:09:28 +0700 | [diff] [blame] | 164 | } ss; |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 165 | struct { |
| 166 | struct gsm0808_channel_type ct; |
| 167 | struct osmo_sockaddr_str rtp_cn; |
| 168 | struct vty *from_vty; |
| 169 | } silent_call; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 170 | }; |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 171 | |
| 172 | struct { |
| 173 | struct gsm_trans *peer; |
| 174 | enum bridge_state state; |
| 175 | } bridge; |
Harald Welte | 0803b98 | 2009-07-26 14:24:11 +0200 | [diff] [blame] | 176 | }; |
| 177 | |
| 178 | |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 179 | |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 180 | struct gsm_trans *trans_find_by_type(const struct msc_a *msc_a, enum trans_type type); |
| 181 | struct gsm_trans *trans_find_by_id(const struct msc_a *msc_a, |
| 182 | enum trans_type type, uint8_t trans_id); |
Andreas Eversberg | 7e4b032 | 2023-04-23 11:43:13 +0200 | [diff] [blame] | 183 | struct gsm_trans *trans_find_by_callref(const struct gsm_network *net, enum trans_type type, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 184 | uint32_t callref); |
Vadim Yanitskiy | 36c44b2 | 2019-01-23 21:22:27 +0700 | [diff] [blame] | 185 | struct gsm_trans *trans_find_by_sm_rp_mr(const struct gsm_network *net, |
| 186 | const struct vlr_subscr *vsub, |
Ivan Kluchnikov | 9bd4fd6 | 2015-12-21 12:05:56 +0300 | [diff] [blame] | 187 | uint8_t sm_rp_mr); |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 188 | |
Keith Whyte | a1a70be | 2021-05-16 02:59:52 +0200 | [diff] [blame] | 189 | struct osmo_lcls *trans_lcls_compose(const struct gsm_trans *trans, bool use_lac); |
| 190 | |
Jacob Erlbeck | af792d6 | 2014-12-02 14:22:53 +0100 | [diff] [blame] | 191 | struct gsm_trans *trans_alloc(struct gsm_network *net, |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 192 | struct vlr_subscr *vsub, |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 193 | enum trans_type type, uint8_t trans_id, |
Holger Hans Peter Freyther | c42ad8b | 2011-04-18 17:04:00 +0200 | [diff] [blame] | 194 | uint32_t callref); |
Harald Welte | 9ee4825 | 2009-07-23 21:25:08 +0200 | [diff] [blame] | 195 | void trans_free(struct gsm_trans *trans); |
| 196 | |
Max | 7916ca1 | 2019-01-02 11:48:14 +0100 | [diff] [blame] | 197 | int trans_assign_trans_id(const struct gsm_network *net, const struct vlr_subscr *vsub, |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 198 | enum trans_type type); |
| 199 | struct gsm_trans *trans_has_conn(const struct msc_a *msc_a); |
| 200 | void trans_conn_closed(const struct msc_a *msc_a); |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 201 | |
Vadim Yanitskiy | b683dcf | 2019-05-11 02:17:16 +0700 | [diff] [blame] | 202 | static inline int trans_log_subsys(enum trans_type type) |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 203 | { |
Vadim Yanitskiy | b683dcf | 2019-05-11 02:17:16 +0700 | [diff] [blame] | 204 | switch (type) { |
Andreas Eversberg | 456c6f7 | 2023-04-23 11:54:16 +0200 | [diff] [blame] | 205 | case TRANS_GCC: |
| 206 | return DGCC; |
| 207 | case TRANS_BCC: |
| 208 | return DBCC; |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 209 | case TRANS_CC: |
Neels Hofmeyr | 7f85ace | 2019-05-09 15:12:34 +0200 | [diff] [blame] | 210 | case TRANS_SILENT_CALL: |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 211 | return DCC; |
Neels Hofmeyr | c4628a3 | 2018-12-07 14:47:34 +0100 | [diff] [blame] | 212 | case TRANS_SMS: |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 213 | return DLSMS; |
Neels Hofmeyr | 7f85ace | 2019-05-09 15:12:34 +0200 | [diff] [blame] | 214 | case TRANS_USSD: |
Neels Hofmeyr | 979b057 | 2019-05-09 15:24:49 +0200 | [diff] [blame] | 215 | return DSS; |
Neels Hofmeyr | ff7074a | 2019-02-28 05:50:06 +0100 | [diff] [blame] | 216 | default: |
| 217 | break; |
| 218 | } |
| 219 | return DMSC; |
| 220 | } |
Neels Hofmeyr | f636e6c | 2019-10-07 21:20:43 +0200 | [diff] [blame] | 221 | |
| 222 | const char *trans_name(const struct gsm_trans *trans); |