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 | 34b5a95 | 2019-05-27 11:54:11 +0200 | [diff] [blame] | 8 | /* (C) 2017-2019 Harald Welte <laforge@gnumonks.org> |
| 9 | * contributions by sysmocom - s.f.m.c. GmbH |
| 10 | * All rights reserved. |
| 11 | * |
| 12 | * Released under the terms of GNU General Public License, Version 2 or |
| 13 | * (at your option) any later version. |
| 14 | * |
| 15 | * SPDX-License-Identifier: GPL-2.0-or-later |
| 16 | */ |
| 17 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 18 | import from General_Types all; |
| 19 | import from Osmocom_Types all; |
| 20 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 21 | import from M3UA_Emulation all; |
| 22 | import from MTP3asp_Types all; |
| 23 | import from MTP3asp_PortType all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 24 | |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 25 | import from IPA_Emulation all; |
| 26 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 27 | import from SCCP_Types all; |
| 28 | import from SCCPasp_Types all; |
| 29 | import from SCCP_Emulation all; |
Stefan Sperling | c307e68 | 2018-06-14 15:15:46 +0200 | [diff] [blame] | 30 | import from SCCP_Templates all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 31 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 32 | import from SCTPasp_Types all; |
| 33 | import from SCTPasp_PortType all; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 34 | |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 35 | #ifdef RAN_EMULATION_BSSAP |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 36 | import from BSSMAP_Templates all; |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 37 | #endif |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 38 | import from RAN_Emulation all; |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 39 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 40 | type record RAN_Adapter { |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 41 | /* component references */ |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 42 | M3UA_CT vc_M3UA, /* only in 3GPP AoIP */ |
| 43 | IPA_Emulation_CT vc_IPA, /* only in SCCPlite */ |
| 44 | IPA_EventWaiter_CT vc_WAIT, /* only in SCCPlite */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 45 | SCCP_CT vc_SCCP, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 46 | |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 47 | MSC_SCCP_MTP3_parameters sccp_pars, |
| 48 | SCCP_PAR_Address sccp_addr_own, |
| 49 | SCCP_PAR_Address sccp_addr_peer, |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 50 | |
| 51 | /* handler mode */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 52 | RAN_Emulation_CT vc_RAN |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 53 | } |
| 54 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 55 | type record RAN_Configuration { |
| 56 | RAN_Transport transport, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 57 | charstring sccp_service_type, |
| 58 | SCTP_Association_Address sctp_addr, |
| 59 | integer own_pc, |
| 60 | integer own_ssn, |
| 61 | integer peer_pc, |
| 62 | integer peer_ssn, |
Philipp Maier | 7593298 | 2018-03-27 14:52:35 +0200 | [diff] [blame] | 63 | octetstring sio, |
| 64 | integer rctx |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 65 | }; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 66 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 67 | private function init_pars(inout RAN_Adapter ba, in RAN_Configuration cfg) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 68 | ba.sccp_pars := { |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 69 | sio := { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 70 | ni := substr(oct2bit(cfg.sio),0,2), |
| 71 | prio := substr(oct2bit(cfg.sio),2,2), |
| 72 | si := substr(oct2bit(cfg.sio),4,4) |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 73 | }, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 74 | opc := cfg.own_pc, |
| 75 | dpc := cfg.peer_pc, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 76 | sls := 0, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 77 | sccp_serviceType := cfg.sccp_service_type, |
| 78 | ssn := cfg.own_ssn |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 79 | }; |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 80 | ba.sccp_addr_own := valueof(ts_SccpAddr_PC_SSN(cfg.own_pc, cfg.own_ssn, cfg.sio, cfg.sccp_service_type)); |
| 81 | 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] | 82 | } |
| 83 | |
| 84 | |
Harald Welte | 3ca0ce1 | 2019-04-23 17:18:48 +0200 | [diff] [blame] | 85 | 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] | 86 | template RanOps ops) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 87 | init_pars(ba, cfg); |
| 88 | ops.sccp_addr_local := ba.sccp_addr_own; |
| 89 | ops.sccp_addr_peer := ba.sccp_addr_peer; |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 90 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 91 | /* create components */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 92 | ba.vc_SCCP := SCCP_CT.create(id & "-SCCP"); |
Alexander Couzens | 5932cd3 | 2019-07-23 20:14:34 +0200 | [diff] [blame] | 93 | if (not istemplatekind(ops, "omit")) { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 94 | ba.vc_RAN := RAN_Emulation_CT.create(id & "-RAN"); |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 95 | } |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 96 | select (cfg.transport) { |
Harald Welte | 5b02762 | 2019-04-14 23:40:17 +0200 | [diff] [blame] | 97 | case (BSSAP_TRANSPORT_AoIP, RANAP_TRANSPORT_IuCS) { |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 98 | ba.vc_M3UA := M3UA_CT.create(id & "-M3UA"); |
| 99 | map(ba.vc_M3UA:SCTP_PORT, system:sctp); |
| 100 | /* connect MTP3 service provider (M3UA) to lower side of SCCP */ |
| 101 | connect(ba.vc_M3UA:MTP3_SP_PORT, ba.vc_SCCP:MTP3_SCCP_PORT); |
| 102 | ba.vc_M3UA.start(f_M3UA_Emulation(cfg.sctp_addr, cfg.rctx)); |
| 103 | } |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 104 | #ifdef IPA_EMULATION_SCCP |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 105 | case (BSSAP_TRANSPORT_SCCPlite_SERVER) { |
| 106 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 107 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 108 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 109 | 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] | 110 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 111 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 112 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 113 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 114 | 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] | 115 | cfg.sctp_addr.local_sctp_port, |
| 116 | true, IPA_INIT_SEND_IPA_ID_ACK)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 117 | /* wait until we received an IPA CCM ID_ACK */ |
| 118 | ba.vc_WAIT.done; |
| 119 | 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] | 120 | } |
| 121 | case (BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
| 122 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 123 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 124 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 125 | 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] | 126 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 127 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 128 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 129 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 130 | ba.vc_IPA.start(IPA_Emulation.main_client(cfg.sctp_addr.remote_ip_addr, |
| 131 | cfg.sctp_addr.remote_sctp_port, |
| 132 | cfg.sctp_addr.local_ip_addr, |
| 133 | cfg.sctp_addr.local_sctp_port)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 134 | /* wait until we received an IPA CCM ID_ACK */ |
| 135 | ba.vc_WAIT.done; |
| 136 | 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] | 137 | } |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 138 | #endif /* SCCP */ |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 139 | case else { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 140 | setverdict(fail, "Unsuppored RAN_Transport"); |
Daniel Willmann | e4ff537 | 2018-07-05 17:35:03 +0200 | [diff] [blame] | 141 | mtc.stop; |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 142 | } |
| 143 | } |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 144 | |
Alexander Couzens | 5932cd3 | 2019-07-23 20:14:34 +0200 | [diff] [blame] | 145 | if (not istemplatekind(ops, "omit")) { |
Harald Welte | b0ec4ee | 2018-01-21 13:53:17 +0100 | [diff] [blame] | 146 | timer T := 5.0; |
| 147 | T.start; |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 148 | //T.timeout; |
Pau Espin Pedrol | c6b78ff | 2019-06-06 15:58:17 +0200 | [diff] [blame] | 149 | ops.transport := cfg.transport; |
Harald Welte | 710ec21 | 2018-05-27 15:07:32 +0200 | [diff] [blame] | 150 | /* connect BSSNAP component to upper side of SCCP */ |
Harald Welte | 5b02762 | 2019-04-14 23:40:17 +0200 | [diff] [blame] | 151 | if (cfg.transport == RANAP_TRANSPORT_IuCS) { |
| 152 | #ifdef RAN_EMULATION_RANAP |
Harald Welte | bc04327 | 2019-05-02 12:00:16 +0200 | [diff] [blame] | 153 | log("Connecting RANAP RAN_Emulation to SCCP_SP_PORT"); |
Harald Welte | 5b02762 | 2019-04-14 23:40:17 +0200 | [diff] [blame] | 154 | ops.protocol := RAN_PROTOCOL_RANAP |
| 155 | connect(ba.vc_RAN:RANAP, ba.vc_SCCP:SCCP_SP_PORT); |
Harald Welte | 2fce788 | 2019-04-15 11:48:05 +0200 | [diff] [blame] | 156 | #endif |
Harald Welte | 5b02762 | 2019-04-14 23:40:17 +0200 | [diff] [blame] | 157 | } else { |
| 158 | #ifdef RAN_EMULATION_BSSAP |
Harald Welte | bc04327 | 2019-05-02 12:00:16 +0200 | [diff] [blame] | 159 | log("Connecting BSSAP RAN_Emulation to SCCP_SP_PORT"); |
Harald Welte | 5b02762 | 2019-04-14 23:40:17 +0200 | [diff] [blame] | 160 | connect(ba.vc_RAN:BSSAP, ba.vc_SCCP:SCCP_SP_PORT); |
| 161 | #endif |
| 162 | } |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 163 | if (cfg.transport == BSSAP_TRANSPORT_SCCPlite_SERVER or |
| 164 | cfg.transport == BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 165 | #ifdef IPA_EMULATION_MGCP |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 166 | /* connect IPA MGCP port with BSSMAP MGCP port */ |
Harald Welte | bc04327 | 2019-05-02 12:00:16 +0200 | [diff] [blame] | 167 | log("Connecting MGCP RAN Emulation to IPA MGCP PORT"); |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 168 | connect(ba.vc_IPA:IPA_MGCP_PORT, ba.vc_RAN:MGCP); |
Harald Welte | 3e16b4d | 2019-04-23 17:41:46 +0200 | [diff] [blame] | 169 | #endif |
Pau Espin Pedrol | 4d0e5e5 | 2019-06-07 19:38:28 +0200 | [diff] [blame] | 170 | #ifdef IPA_EMULATION_CTRL |
Alexander Couzens | d7b2950 | 2019-07-22 21:08:59 +0200 | [diff] [blame] | 171 | #ifdef RAN_EMULATION_CTRL |
Pau Espin Pedrol | 4d0e5e5 | 2019-06-07 19:38:28 +0200 | [diff] [blame] | 172 | /* connect IPA CTRL port with BSSMAP CTRL port */ |
| 173 | log("Connecting CTRL RAN Emulation to IPA CTRL PORT"); |
| 174 | connect(ba.vc_IPA:IPA_CTRL_PORT, ba.vc_RAN:CTRL); |
| 175 | #endif |
Alexander Couzens | d7b2950 | 2019-07-22 21:08:59 +0200 | [diff] [blame] | 176 | #endif |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 177 | } |
Harald Welte | bc04327 | 2019-05-02 12:00:16 +0200 | [diff] [blame] | 178 | log("Starting RAN_Emulation"); |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 179 | ba.vc_RAN.start(RAN_Emulation.main(valueof(ops), "")); |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 180 | } |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 181 | |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 182 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 183 | } |
| 184 | |
Harald Welte | 3ca0ce1 | 2019-04-23 17:18:48 +0200 | [diff] [blame] | 185 | function f_ran_adapter_start(inout RAN_Adapter ba) { |
Harald Welte | d5833a8 | 2018-05-27 16:52:56 +0200 | [diff] [blame] | 186 | ba.vc_SCCP.start(SCCPStart(ba.sccp_pars)); |
| 187 | } |
| 188 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 189 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 190 | } |