Holger Hans Peter Freyther | 43b0909 | 2010-06-15 11:52:51 +0800 | [diff] [blame] | 1 | /* Routines for the MSC handling */ |
| 2 | |
| 3 | #ifndef OSMO_MSC_H |
| 4 | #define OSMO_MSC_H |
| 5 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 6 | #include <osmocom/core/fsm.h> |
| 7 | #include <osmocom/gsm/gsup.h> |
| 8 | |
Neels Hofmeyr | 9084396 | 2017-09-04 15:04:35 +0200 | [diff] [blame] | 9 | #include <osmocom/msc/gsm_data.h> |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 10 | |
Holger Hans Peter Freyther | 43b0909 | 2010-06-15 11:52:51 +0800 | [diff] [blame] | 11 | #include "bsc_api.h" |
| 12 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 13 | #define MSC_HLR_REMOTE_IP_DEFAULT "127.0.0.1" |
| 14 | #define MSC_HLR_REMOTE_PORT_DEFAULT OSMO_GSUP_PORT |
| 15 | |
| 16 | enum subscr_conn_fsm_event { |
| 17 | /* Mark 0 as invalid to catch uninitialized vars */ |
| 18 | SUBSCR_CONN_E_INVALID = 0, |
| 19 | /* Timeout on connection establishment starts */ |
| 20 | SUBSCR_CONN_E_START, |
| 21 | /* LU or Process Access FSM has determined that this conn is good */ |
| 22 | SUBSCR_CONN_E_ACCEPTED, |
| 23 | /* received first reply from MS in "real" CC, SMS, USSD communication */ |
| 24 | SUBSCR_CONN_E_COMMUNICATING, |
| 25 | /* Some async action has completed, check again whether all is done */ |
| 26 | SUBSCR_CONN_E_BUMP, |
| 27 | /* MS/BTS/BSC originated close request */ |
| 28 | SUBSCR_CONN_E_MO_CLOSE, |
| 29 | /* MSC originated close request, e.g. failed authentication */ |
| 30 | SUBSCR_CONN_E_CN_CLOSE, |
| 31 | }; |
| 32 | |
| 33 | enum subscr_conn_fsm_state { |
| 34 | SUBSCR_CONN_S_INIT, |
| 35 | SUBSCR_CONN_S_NEW, |
| 36 | SUBSCR_CONN_S_ACCEPTED, |
| 37 | SUBSCR_CONN_S_COMMUNICATING, |
| 38 | SUBSCR_CONN_S_RELEASED, |
| 39 | }; |
| 40 | |
| 41 | enum subscr_conn_from { |
| 42 | SUBSCR_CONN_FROM_INVALID, |
| 43 | SUBSCR_CONN_FROM_LU, |
| 44 | SUBSCR_CONN_FROM_CM_SERVICE_REQ, |
| 45 | SUBSCR_CONN_FROM_PAGING_RESP, |
| 46 | }; |
| 47 | |
| 48 | extern const struct value_string subscr_conn_from_names[]; |
| 49 | static inline const char *subscr_conn_from_name(enum subscr_conn_from val) |
| 50 | { |
| 51 | return get_value_string(subscr_conn_from_names, val); |
| 52 | } |
| 53 | |
Neels Hofmeyr | e2f24d5 | 2017-05-08 15:12:20 +0200 | [diff] [blame] | 54 | enum msc_compl_l3_rc { |
| 55 | MSC_CONN_ACCEPT = 0, |
| 56 | MSC_CONN_REJECT = 1, |
| 57 | }; |
| 58 | |
Holger Hans Peter Freyther | 43b0909 | 2010-06-15 11:52:51 +0800 | [diff] [blame] | 59 | struct bsc_api *msc_bsc_api(); |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 60 | |
| 61 | int msc_create_conn_fsm(struct gsm_subscriber_connection *conn, const char *id); |
| 62 | |
| 63 | int msc_vlr_alloc(struct gsm_network *net); |
| 64 | int msc_vlr_start(struct gsm_network *net); |
| 65 | |
Philipp Maier | fbf6610 | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 66 | void msc_sapi_n_reject(struct gsm_subscriber_connection *conn, int dlci); |
| 67 | int msc_clear_request(struct gsm_subscriber_connection *conn, uint32_t cause); |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 68 | int msc_compl_l3(struct gsm_subscriber_connection *conn, |
| 69 | struct msgb *msg, uint16_t chosen_channel); |
| 70 | void msc_dtap(struct gsm_subscriber_connection *conn, uint8_t link_id, |
| 71 | struct msgb *msg); |
| 72 | void msc_cipher_mode_compl(struct gsm_subscriber_connection *conn, |
| 73 | struct msgb *msg, uint8_t alg_id); |
| 74 | void msc_rx_sec_mode_compl(struct gsm_subscriber_connection *conn); |
Philipp Maier | fbf6610 | 2017-04-09 12:32:51 +0200 | [diff] [blame] | 75 | void msc_classmark_chg(struct gsm_subscriber_connection *conn, |
| 76 | const uint8_t *cm2, uint8_t cm2_len, |
| 77 | const uint8_t *cm3, uint8_t cm3_len); |
| 78 | void msc_assign_fail(struct gsm_subscriber_connection *conn, |
| 79 | uint8_t cause, uint8_t *rr_cause); |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 80 | |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 81 | void msc_subscr_conn_init(void); |
Max | d83b17b | 2018-02-06 16:51:31 +0100 | [diff] [blame] | 82 | bool msc_subscr_conn_is_accepted(const struct gsm_subscriber_connection *conn); |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 83 | void msc_subscr_conn_communicating(struct gsm_subscriber_connection *conn); |
| 84 | void msc_subscr_conn_close(struct gsm_subscriber_connection *conn, |
| 85 | uint32_t cause); |
| 86 | |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 87 | enum msc_subscr_conn_use { |
| 88 | MSC_CONN_USE_UNTRACKED = -1, |
| 89 | MSC_CONN_USE_COMPL_L3, |
| 90 | MSC_CONN_USE_DTAP, |
| 91 | MSC_CONN_USE_FSM, |
| 92 | MSC_CONN_USE_TRANS_CC, |
| 93 | MSC_CONN_USE_TRANS_SMS, |
| 94 | MSC_CONN_USE_TRANS_USSD, |
| 95 | MSC_CONN_USE_SILENT_CALL, |
| 96 | }; |
| 97 | |
| 98 | extern const struct value_string msc_subscr_conn_use_names[]; |
| 99 | static inline const char *msc_subscr_conn_use_name(enum msc_subscr_conn_use val) |
| 100 | { return get_value_string(msc_subscr_conn_use_names, val); } |
| 101 | |
| 102 | #define msc_subscr_conn_get(conn, balance_token) \ |
| 103 | _msc_subscr_conn_get(conn, balance_token, __BASE_FILE__, __LINE__) |
| 104 | #define msc_subscr_conn_put(conn, balance_token) \ |
| 105 | _msc_subscr_conn_put(conn, balance_token, __BASE_FILE__, __LINE__) |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 106 | struct gsm_subscriber_connection * |
| 107 | _msc_subscr_conn_get(struct gsm_subscriber_connection *conn, |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 108 | enum msc_subscr_conn_use balance_token, |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 109 | const char *file, int line); |
| 110 | void _msc_subscr_conn_put(struct gsm_subscriber_connection *conn, |
Neels Hofmeyr | 6166f29 | 2017-11-22 14:33:12 +0100 | [diff] [blame] | 111 | enum msc_subscr_conn_use balance_token, |
Harald Welte | 2483f1b | 2016-06-19 18:06:02 +0200 | [diff] [blame] | 112 | const char *file, int line); |
Holger Hans Peter Freyther | 43b0909 | 2010-06-15 11:52:51 +0800 | [diff] [blame] | 113 | |
Neels Hofmeyr | 84da6b1 | 2016-05-20 21:59:55 +0200 | [diff] [blame] | 114 | void msc_stop_paging(struct vlr_subscr *vsub); |
| 115 | |
Holger Hans Peter Freyther | 43b0909 | 2010-06-15 11:52:51 +0800 | [diff] [blame] | 116 | #endif |