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 | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 25 | import from BSSMAP_Templates all; |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 26 | import from RAN_Emulation all; |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 27 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 28 | type record RAN_Adapter { |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 29 | /* component references */ |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 30 | M3UA_CT vc_M3UA, /* only in 3GPP AoIP */ |
| 31 | IPA_Emulation_CT vc_IPA, /* only in SCCPlite */ |
| 32 | IPA_EventWaiter_CT vc_WAIT, /* only in SCCPlite */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 33 | SCCP_CT vc_SCCP, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 34 | |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 35 | MSC_SCCP_MTP3_parameters sccp_pars, |
| 36 | SCCP_PAR_Address sccp_addr_own, |
| 37 | SCCP_PAR_Address sccp_addr_peer, |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 38 | |
| 39 | /* handler mode */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 40 | RAN_Emulation_CT vc_RAN |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 41 | } |
| 42 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 43 | type enumerated RAN_Transport { |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 44 | BSSAP_TRANSPORT_AoIP, /* 3GPP AoIP: SCCP over M3UA over SCTP */ |
| 45 | BSSAP_TRANSPORT_SCCPlite_SERVER, /* SCCPlite: SCCP over IPA over TCP */ |
| 46 | BSSAP_TRANSPORT_SCCPlite_CLIENT /* SCCPlite: SCCP over IPA over TCP */ |
| 47 | }; |
| 48 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 49 | type record RAN_Configuration { |
| 50 | RAN_Transport transport, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 51 | charstring sccp_service_type, |
| 52 | SCTP_Association_Address sctp_addr, |
| 53 | integer own_pc, |
| 54 | integer own_ssn, |
| 55 | integer peer_pc, |
| 56 | integer peer_ssn, |
Philipp Maier | 7593298 | 2018-03-27 14:52:35 +0200 | [diff] [blame] | 57 | octetstring sio, |
| 58 | integer rctx |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 59 | }; |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 60 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 61 | private function init_pars(inout RAN_Adapter ba, in RAN_Configuration cfg) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 62 | ba.sccp_pars := { |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 63 | sio := { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 64 | ni := substr(oct2bit(cfg.sio),0,2), |
| 65 | prio := substr(oct2bit(cfg.sio),2,2), |
| 66 | si := substr(oct2bit(cfg.sio),4,4) |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 67 | }, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 68 | opc := cfg.own_pc, |
| 69 | dpc := cfg.peer_pc, |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 70 | sls := 0, |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 71 | sccp_serviceType := cfg.sccp_service_type, |
| 72 | ssn := cfg.own_ssn |
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 | ba.sccp_addr_own := valueof(ts_SccpAddr_PC_SSN(cfg.own_pc, cfg.own_ssn, cfg.sio, cfg.sccp_service_type)); |
| 75 | 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] | 76 | } |
| 77 | |
| 78 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 79 | function f_bssap_init(inout RAN_Adapter ba, in RAN_Configuration cfg, charstring id, |
| 80 | template RanOps ops) { |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 81 | init_pars(ba, cfg); |
| 82 | ops.sccp_addr_local := ba.sccp_addr_own; |
| 83 | ops.sccp_addr_peer := ba.sccp_addr_peer; |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 84 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 85 | /* create components */ |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 86 | ba.vc_SCCP := SCCP_CT.create(id & "-SCCP"); |
Harald Welte | 67089ee | 2018-01-17 22:19:03 +0100 | [diff] [blame] | 87 | if (isvalue(ops)) { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 88 | ba.vc_RAN := RAN_Emulation_CT.create(id & "-RAN"); |
Harald Welte | 624f963 | 2017-12-16 19:26:04 +0100 | [diff] [blame] | 89 | } |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 90 | select (cfg.transport) { |
| 91 | case (BSSAP_TRANSPORT_AoIP) { |
| 92 | ba.vc_M3UA := M3UA_CT.create(id & "-M3UA"); |
| 93 | map(ba.vc_M3UA:SCTP_PORT, system:sctp); |
| 94 | /* connect MTP3 service provider (M3UA) to lower side of SCCP */ |
| 95 | connect(ba.vc_M3UA:MTP3_SP_PORT, ba.vc_SCCP:MTP3_SCCP_PORT); |
| 96 | ba.vc_M3UA.start(f_M3UA_Emulation(cfg.sctp_addr, cfg.rctx)); |
| 97 | } |
| 98 | case (BSSAP_TRANSPORT_SCCPlite_SERVER) { |
| 99 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 100 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 101 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 102 | 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] | 103 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 104 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 105 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 106 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 107 | 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] | 108 | cfg.sctp_addr.local_sctp_port, |
| 109 | true, IPA_INIT_SEND_IPA_ID_ACK)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 110 | /* wait until we received an IPA CCM ID_ACK */ |
| 111 | ba.vc_WAIT.done; |
| 112 | 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] | 113 | } |
| 114 | case (BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
| 115 | ba.vc_IPA := IPA_Emulation_CT.create(id & "-IPA"); |
| 116 | map(ba.vc_IPA:IPA_PORT, system:IPA_CODEC_PT); |
| 117 | /* connect MTP3 service provider (IPA) to lower side of SCCP */ |
| 118 | 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] | 119 | /* connect waiter to general IPA port (for ASP_IPA_Event) */ |
| 120 | ba.vc_WAIT := IPA_EventWaiter_CT.create(id & "-IPA-WAIT"); |
| 121 | connect(ba.vc_IPA:IPA_SP_PORT, ba.vc_WAIT:IPA_SP_PORT); |
| 122 | ba.vc_WAIT.start(IPA_Emulation.waiter_main()); |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 123 | ba.vc_IPA.start(IPA_Emulation.main_client(cfg.sctp_addr.remote_ip_addr, |
| 124 | cfg.sctp_addr.remote_sctp_port, |
| 125 | cfg.sctp_addr.local_ip_addr, |
| 126 | cfg.sctp_addr.local_sctp_port)); |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 127 | /* wait until we received an IPA CCM ID_ACK */ |
| 128 | ba.vc_WAIT.done; |
| 129 | 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] | 130 | } |
| 131 | case else { |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 132 | setverdict(fail, "Unsuppored RAN_Transport"); |
Daniel Willmann | e4ff537 | 2018-07-05 17:35:03 +0200 | [diff] [blame] | 133 | mtc.stop; |
Harald Welte | 7ef51aa | 2018-04-16 19:16:01 +0200 | [diff] [blame] | 134 | } |
| 135 | } |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 136 | |
Harald Welte | 67089ee | 2018-01-17 22:19:03 +0100 | [diff] [blame] | 137 | if (isvalue(ops)) { |
Harald Welte | b0ec4ee | 2018-01-21 13:53:17 +0100 | [diff] [blame] | 138 | timer T := 5.0; |
| 139 | T.start; |
Harald Welte | a4ca446 | 2018-02-09 00:17:14 +0100 | [diff] [blame] | 140 | //T.timeout; |
| 141 | log("Connecting BSSMAP Emulation to SCCP_SP_PORT and starting emulation"); |
Harald Welte | 710ec21 | 2018-05-27 15:07:32 +0200 | [diff] [blame] | 142 | /* connect BSSNAP component to upper side of SCCP */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 143 | connect(ba.vc_RAN:BSSAP, ba.vc_SCCP:SCCP_SP_PORT); |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 144 | if (cfg.transport == BSSAP_TRANSPORT_SCCPlite_SERVER or |
| 145 | cfg.transport == BSSAP_TRANSPORT_SCCPlite_CLIENT) { |
| 146 | /* connect IPA MGCP port with BSSMAP MGCP port */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 147 | connect(ba.vc_IPA:IPA_MGCP_PORT, ba.vc_RAN:MGCP); |
Harald Welte | 4239918 | 2018-05-27 15:07:14 +0200 | [diff] [blame] | 148 | } |
Harald Welte | b0ec4ee | 2018-01-21 13:53:17 +0100 | [diff] [blame] | 149 | /* start the BSSMAP emulation */ |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 150 | ba.vc_RAN.start(RAN_Emulation.main(valueof(ops), "")); |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 151 | } |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 152 | |
Harald Welte | 2e32e43 | 2018-05-24 20:00:00 +0200 | [diff] [blame] | 153 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 154 | } |
| 155 | |
Harald Welte | 6811d10 | 2019-04-14 22:23:14 +0200 | [diff] [blame] | 156 | function f_bssap_start(inout RAN_Adapter ba) { |
Harald Welte | d5833a8 | 2018-05-27 16:52:56 +0200 | [diff] [blame] | 157 | ba.vc_SCCP.start(SCCPStart(ba.sccp_pars)); |
| 158 | } |
| 159 | |
Harald Welte | ae02669 | 2017-12-09 01:03:01 +0100 | [diff] [blame] | 160 | |
Harald Welte | 28d943e | 2017-11-25 15:00:50 +0100 | [diff] [blame] | 161 | } |