Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 1 | module RAN_Adapter { |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 2 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 3 | /* This module implements a 'dumb' RAN adapter. It creates the M3UA and SCCP components and stacks a |
| 4 | * BSSAP/RANAP codec port on top. As a result, it provides the ability to transceive SCCP-User-SAP primitives |
| 5 | * with deoded BSSAP/RANAP payload. Use this if you want to have full control about what you transmit or |
| 6 | * receive, without any automatisms in place. Allows you to refuse connections or other abnormal behavior. */ |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 7 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 8 | import from General_Types all; |
| 9 | import from Osmocom_Types all; |
| 10 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 11 | import from M3UA_Emulation all; |
| 12 | import from MTP3asp_Types all; |
| 13 | import from MTP3asp_PortType all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 14 | |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 15 | import from IPA_Emulation all; |
| 16 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 17 | import from SCCP_Types all; |
| 18 | import from SCCPasp_Types all; |
| 19 | import from SCCP_Emulation all; |
Stefan Sperling | c307e68 | 2018-06-14 15:15:46 +0200 | [diff] [blame] | 20 | import from SCCP_Templates all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 21 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 22 | import from SCTPasp_Types all; |
| 23 | import from SCTPasp_PortType all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 24 | |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 25 | #ifdef RAN_EMULATION_BSSAP |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 26 | import from BSSMAP_Templates all; |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 27 | #endif |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 28 | import from RAN_Emulation all; |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 29 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 30 | type record RAN_Adapter { |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 31 | /* component references */ |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 32 | M3UA_CT vc_M3UA, /* only in 3GPP AoIP */ |
| 33 | IPA_Emulation_CT vc_IPA, /* only in SCCPlite */ |
| 34 | IPA_EventWaiter_CT vc_WAIT, /* only in SCCPlite */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 35 | SCCP_CT vc_SCCP, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 36 | |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 37 | MSC_SCCP_MTP3_parameters sccp_pars, |
| 38 | SCCP_PAR_Address sccp_addr_own, |
| 39 | SCCP_PAR_Address sccp_addr_peer, |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 40 | |
| 41 | /* handler mode */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 42 | RAN_Emulation_CT vc_RAN |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 43 | } |
| 44 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 45 | type enumerated RAN_Transport { |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 46 | BSSAP_TRANSPORT_AoIP, /* 3GPP AoIP: SCCP over M3UA over SCTP */ |
| 47 | BSSAP_TRANSPORT_SCCPlite_SERVER, /* SCCPlite: SCCP over IPA over TCP */ |
| 48 | BSSAP_TRANSPORT_SCCPlite_CLIENT /* SCCPlite: SCCP over IPA over TCP */ |
| 49 | }; |
| 50 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 51 | type record RAN_Configuration { |
| 52 | RAN_Transport transport, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 53 | charstring sccp_service_type, |
| 54 | SCTP_Association_Address sctp_addr, |
| 55 | integer own_pc, |
| 56 | integer own_ssn, |
| 57 | integer peer_pc, |
| 58 | integer peer_ssn, |
Philipp Maier | 7593298 | 2018-03-27 14:52:35 +0200 | [diff] [blame] | 59 | octetstring sio, |
| 60 | integer rctx |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 61 | }; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 62 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 63 | private function init_pars(inout RAN_Adapter ba, in RAN_Configuration cfg) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 64 | ba.sccp_pars := { |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 65 | sio := { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 66 | ni := substr(oct2bit(cfg.sio),0,2), |
| 67 | prio := substr(oct2bit(cfg.sio),2,2), |
| 68 | si := substr(oct2bit(cfg.sio),4,4) |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 69 | }, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 70 | opc := cfg.own_pc, |
| 71 | dpc := cfg.peer_pc, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 72 | sls := 0, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 73 | sccp_serviceType := cfg.sccp_service_type, |
| 74 | ssn := cfg.own_ssn |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 75 | }; |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 76 | ba.sccp_addr_own := valueof(ts_SccpAddr_PC_SSN(cfg.own_pc, cfg.own_ssn, cfg.sio, cfg.sccp_service_type)); |
| 77 | ba.sccp_addr_peer := valueof(ts_SccpAddr_PC_SSN(cfg.peer_pc, cfg.peer_ssn, cfg.sio, cfg.sccp_service_type)); |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 78 | } |
| 79 | |
| 80 | |
Harald Welte | 3ca0ce1 | 2019-04-23 17:18:48 +0200 | [diff] [blame] | 81 | function f_ran_adapter_init(inout RAN_Adapter ba, in RAN_Configuration cfg, charstring id, |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 82 | template RanOps ops) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 83 | init_pars(ba, cfg); |
| 84 | ops.sccp_addr_local := ba.sccp_addr_own; |
| 85 | ops.sccp_addr_peer := ba.sccp_addr_peer; |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 86 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 87 | /* create components */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 88 | ba.vc_SCCP := SCCP_CT.create(id & "-SCCP"); |
Harald Welte | 67089ee | 2018-01-17 22:19:03 +0100 | [diff] [blame] | 89 | if (isvalue(ops)) { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 90 | ba.vc_RAN := RAN_Emulation_CT.create(id & "-RAN"); |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 91 | } |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 92 | select (cfg.transport) { |
Harald Welte | 2fce788 | 2019-04-15 11:48:05 +0200 | [diff] [blame] | 93 | #ifdef RAN_EMULATION_BSSAP |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 94 | case (BSSAP_TRANSPORT_AoIP) { |
| 95 | ba.vc_M3UA := M3UA_CT.create(id & "-M3UA"); |
| 96 | map(ba.vc_M3UA:SCTP_PORT, system:sctp); |
| 97 | /* connect MTP3 service provider (M3UA) to lower side of SCCP */ |
| 98 | connect(ba.vc_M3UA:MTP3_SP_PORT, ba.vc_SCCP:MTP3_SCCP_PORT); |
| 99 | ba.vc_M3UA.start(f_M3UA_Emulation(cfg.sctp_addr, cfg.rctx)); |
| 100 | } |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 101 | #ifdef IPA_EMULATION_SCCP |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 102 | case (BSSAP_TRANSPORT_SCCPlite_SERVER) { |
| 103 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 104 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 105 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 106 | connect(ba.vc_IPA:MTP3_SP_PORT, ba.vc_SCCP:MTP3_SCCP_PORT); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 107 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 108 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 109 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 110 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 111 | ba.vc_IPA.start(IPA_Emulation.main_server(cfg.sctp_addr.local_ip_addr, |
Neels Hofmeyr | 3bf31d2 | 2018-08-24 14:44:32 +0200 | [diff] [blame] | 112 | cfg.sctp_addr.local_sctp_port, |
| 113 | true, IPA_INIT_SEND_IPA_ID_ACK)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 114 | /* wait until we received an IPA CCM ID_ACK */ |
| 115 | ba.vc_WAIT.done; |
| 116 | disconnect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 117 | } |
| 118 | case (BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
| 119 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 120 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 121 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 122 | connect(ba.vc_IPA:MTP3_SP_PORT, ba.vc_SCCP:MTP3_SCCP_PORT); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 123 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 124 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 125 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 126 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 127 | ba.vc_IPA.start(IPA_Emulation.main_client(cfg.sctp_addr.remote_ip_addr, |
| 128 | cfg.sctp_addr.remote_sctp_port, |
| 129 | cfg.sctp_addr.local_ip_addr, |
| 130 | cfg.sctp_addr.local_sctp_port)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 131 | /* wait until we received an IPA CCM ID_ACK */ |
| 132 | ba.vc_WAIT.done; |
| 133 | disconnect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 134 | } |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 135 | #endif /* SCCP */ |
| 136 | #endif /* BSSAP */ |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 137 | case else { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 138 | setverdict(fail, "Unsuppored RAN_Transport"); |
Daniel Willmann | e4ff537 | 2018-07-05 17:35:03 +0200 | [diff] [blame] | 139 | mtc.stop; |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 140 | } |
| 141 | } |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 142 | |
Harald Welte | 67089ee | 2018-01-17 22:19:03 +0100 | [diff] [blame] | 143 | if (isvalue(ops)) { |
Harald Welte | b0ec4ee | 2018-01-21 13:53:17 +0100 | [diff] [blame] | 144 | timer T := 5.0; |
| 145 | T.start; |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 146 | //T.timeout; |
| 147 | log("Connecting BSSMAP Emulation to SCCP_SP_PORT and starting emulation"); |
Harald Welte | 2fce788 | 2019-04-15 11:48:05 +0200 | [diff] [blame] | 148 | #if RAN_EMULATION_BSSAP |
Harald Welte | 710ec21 | 2018-05-27 15:07:32 +0200 | [diff] [blame] | 149 | /* connect BSSNAP component to upper side of SCCP */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 150 | connect(ba.vc_RAN:BSSAP, ba.vc_SCCP:SCCP_SP_PORT); |
Harald Welte | 2fce788 | 2019-04-15 11:48:05 +0200 | [diff] [blame] | 151 | #endif |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 152 | if (cfg.transport == BSSAP_TRANSPORT_SCCPlite_SERVER or |
| 153 | cfg.transport == BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 154 | #ifdef IPA_EMULATION_MGCP |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 155 | /* connect IPA MGCP port with BSSMAP MGCP port */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 156 | connect(ba.vc_IPA:IPA_MGCP_PORT, ba.vc_RAN:MGCP); |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame^] | 157 | #endif |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 158 | } |
Harald Welte | b0ec4ee | 2018-01-21 13:53:17 +0100 | [diff] [blame] | 159 | /* start the BSSMAP emulation */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 160 | ba.vc_RAN.start(RAN_Emulation.main(valueof(ops), "")); |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 161 | } |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 162 | |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 163 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 164 | } |
| 165 | |
Harald Welte | 3ca0ce1 | 2019-04-23 17:18:48 +0200 | [diff] [blame] | 166 | function f_ran_adapter_start(inout RAN_Adapter ba) { |
Harald Welte | d5833a8 | 2018-05-27 16:52:56 +0200 | [diff] [blame] | 167 | ba.vc_SCCP.start(SCCPStart(ba.sccp_pars)); |
| 168 | } |
| 169 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 170 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 171 | } |