eCall Development Server - User Manual

If audio recording has been enabled for the eCall Development Server then download links for the recordings can be found in the call details. There is also a delete link to delete only the audio recordings of a single call.

Additionally there is a button “Download Audio” to download the recordings of all calls of one day. To enable the button the calls table has to be filtered down to a specific time range using the filter.

If RTP recording has been enabled for the eCall Development Server and the corresponding test parameter has been set to true then a button will appear which allows to generate graphs from the recorded traffic which show the data rate of the call’s RTP media sessions.

Additionally, users with ROLE_ADMIN can download traffic captures as a PCAP file, which can be read with Wireshark for example.

To download calls in a CSV file click the button “Export as CSV” at the top of the page. The export function respects the currently set filter of the calls table. Setting no filter allows to download every call in the data base.

Calls can be deleted from the data base using the button “Delete Calls”. This button is only visible if the currently logged in user has an access level of at least ROLE_GROUP_ADMIN. The delete function respects the currently set filter of the calls table. Deleted calls cannot be restored. If audio recording is enabled then the audio recordings of the calls will also be deleted.

If the current user’s user group has at least one related group and the current user has the ROLE_PHONE_ADMIN access level then the Transferable Phones button will appear near the top of the phone administration page. It will open a table of all phones in related groups that may be transferred to the current user’s user group.

Upon transfer the user has to select one of the current user group’s test cases which will be assigned to the phone once it has been successfully transferred.

Group relationships can only be configured by a user with ROLE_GROUP_ADMIN access level.

The SMS page shows all received and sent SMS. It is possible to request a call, a MSD, an acceleration profile or a track by SMS using one of the buttons at the top of the page. It is also possible to get or set IVS configuration parameters, start or stop test mode or request network deregistration by SMS. For inbound SMS a corresponding phone entry must exist in the system. If no phone exists the SMS will be ignored.

The TCP/IP page shows all TCP connections of the past and where they were coming from.

Clicking on one of the table rows leads to the connection log for that connection.

Every TCP connection must be authenticated within 6 seconds or the server will close the connection. To authenticate the remote side must send a subrecord of type EGTS_SR_TERM_IDENTITY with a terminal identifier that matches one of the phone entries in the system.

Optional data contained in a MSD with OID 1.4.1 or 1.4.2 gets decoded according to Appendix C of GOST R 54620-2011. Both the original ASN.1 definition and the newer one from Amendment No. 1 are supported.

The conformance test execution page allows the user to execute a conformance test. After selecting a phone as the system under test, the test standard and a test, the test can be started by clicking the “Start Test” button.

During the execution of a conformance test the test case that is usually assigned to the system under test will be ignored.

A running conformance test can be cancelled by selecting the test in the list of recent conformance tests and clicking the “Cancel Test” button.

On the conformance tests results page the test results of already executed tests can be viewed and exported.

To export test results and generate a PDF with a conformance test report select the test results that you want to export by ticking the checkboxes next to it and then click the export button at the top of the page.

Test results can be deleted by clicking the “Delete Test Results” button. Note that this action deletes all test results according to the table filter (checkboxes are ignored). You need at least role TEST_ADMIN to delete test results.

This setting controls how incoming calls are handled when the external subscriber is unknown, i.e. no phone entry exists for the phone number of the external subscriber. The following options are available:

This setting allows you to control into which user group new phones are placed if a calls comes in from a yet unknown phone number. By default every phone is placed into the DEFAULT_USER_GROUP. The default mapping is marked by the *. You can add additional mappings if your eCall Development Server is reachable under multiple phone numbers. The mappings are always matched as the last digits of the called phone number.

For example your server is reachable under phone numbers 123450, 123451 and 123452 and you already created some user groups A and B. If you want calls to number 123450 to create phones in group A and calls to 123451 to create phones in group B then you would create two mappings

while calls to 123452 would still use the default mapping.

The default mapping is only getting used if the “Call Acceptance” setting is set to “Open”. Every user defined mapping has an override setting. If you set this to true then this mapping also applies if “Call Acceptance” is set to “Closed”.

You can configure up to two email addresses here where test protocols are sent to. If a phone has at least one email address configured that email address has precedence over the global mail addresses.

To enable sending of protocol emails a SMTP server has to be configured and activated here.

The map that is being used to display MSD positions on dispatch page and the calls page can be configured here. The URL must point to a tile server that serves image tiles. By default the URL points to the public OpenStreetMap server at http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png

Choose the SMS service to use for outbound SMS messages. By default Nexmo is being used.

This setting is only important if you intend to send and receive SMS for ERA-GLONASS with your server. First you need a Nexmo account which can be created at http://nexmo.com. Nexmo will provide an API key and an API secret which you will have to enter into the corresponding fields.

The field “Sender Address” is used when sending outbound SMS. Please use the international phone number format expected by Nexmo (without leading plus sign, e.g. 491234567890 for a number in Germany). The Sender Address should match a phone number that you have added to your Nexmo account using Numbers → Add Number at nexmo.com.

The URL field is by default https://rest.nexmo.com/sms/json. This is the URL that will be called by the eCall development server when sending a SMS. Normally you shouldn’t have to change that value.

Under API Settings in your account at nexmo.com you should set “Callback URL for Inbound Message” to http://<IP-address-of-server>/nexmo/inbound, and “Callback URL for Delivery Receipt” to http://<IP-address-of-server>/nexmo/delivery.

This setting is only important if you intend to send and receive SMS for ERA-GLONASS with your server. The implementation has been tested with Now SMS/MMS Gateway Lite Edition (v2015.06.24).

Sender Address can be left empty and will usually be ignored when NowSMS is used with a GSM modem.

URL should be set to the web interface of the computer with installed NowSMS.

To forward SMS from NowSMS to your eCall Development Server, NowSMS must be configured accordingly. You must enable option “Receive SMS Messages” in Modem tab. In 2-Way tab enable “Process received SMS Messages” and “Use 2-way command processor”. Create a rule with keyword ‘*’ and set “Run HTTP or Local Command” to

http://<IP-address-of-server >/nowSms/inbound?sender=@@SENDER@@&binary=@@BINARY@@&udh=@@UDH@@&pid=@@PID@@&dcs=@@DCS@@&data=@@FULLSMS@@

See SMS Service to enable NowSMS for outbound SMS.

This setting is only important if you intend to send SMS for ERA-GLONASS with your server. You need an account with https://seven.io and an API key to send SMS through this provider.

The field “Sender Address” is used when sending outbound SMS. Please use the international phone number format (without leading plus sign, e.g. 491234567890 for a number in Germany).

The URL field is by default https://gateway.seven.io/api/sms. This is the URL that will be called by the eCall development server when sending a SMS. Normally you shouldn’t have to change that value.

To receive delivery notifications under Account → Developer → Webhooks at seven.io you should add a webhook and set URL to http://<IP-address-of-server>/sms77/delivery , method to “JSON Payload” and event to “DLR”.

This setting is only important if you intend to send and receive SMS for ERA-GLONASS with your server. The implementation follows SMPP Integration Guide and is therefore Vodafone specific.

If enabled the eCall Development Server automatically connects to the specified SMPP host and port and uses a BIND operation to register to the SMSC. The specified system id and password will be used in the bind_transmitter message to authenticate to the SMSC.

The sender address is used as source address when sending outbound SMS. Please use the international phone number format (without leading plus sign, e.g. 491234567890 for a number in Germany).

The current session state is listed at the top of the configuration parameters. This should usually be BOUND_TRX if the eCall Development Server has successfully connected to the SMSC and is ready to send and receive SMS.

The eCall Development Server uses background processes called workers to actually handle a legacy eCall with inband modem transmission. You need n workers to handle n eCalls simultaneously. The workers are using SIP and RTP to communicate with the telephony backend. If you intend to only handle NG eCalls, you don’t need any workers at all.

Every worker configuration consists of:

You can add and remove workers with the “Add” and “Remove Last” buttons and change the configuration of an existing worker using the “Edit” button next to the worker. In the default configuration all workers are started when the systems starts and they will keep running as long as the system runs. It also possible to switch to an on demand mode. In this mode a worker will only be started once it has been requested and stopped once it is not needed anymore. The on demand mode therefore provides better resource utilization.

You can switch between the legacy worker implementation and the PJSIP worker implementation. The latter one is actively maintained and continually enhanced for stability and reliability. The legacy worker will eventually be phased out but stays the default choice for the time being.

Note that any changes will only be applied after the “Save” button was clicked.

You can change the displayed time zone here. This affects all time stamps on all pages.

If you only want to allow phone numbers of a certain format then you can configure a regular expression of the allowed format here. A description of regular expressions can be found here: https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html.

This setting allows enabling metrics which can be retrieved through http requests. Access to the metrics endpoint /actuator will be secured with basic auth with the configured user name and password.

You need a valid license key to run eCall Development Server (Version 3 and up). Please copy and paste the license key you have been sent from OECON P&S Support in the text field in this section. The software will instantly show the Licensee and the expiration date of your license once you press the Save button.

Without a valid license key installed eCall Development Server will show a red banner on every page informing you about the missing license.

The software will still receive and save eCalls without a valid license but you can’t see call details or decode a MSD. As soon as a valid license key is entered you can inspect all previously recorded calls.

To announce scheduled downtimes or anything else to all users, admin users can enter a message in the text field in this section. Once the checkbox is activated the message will be shown as a red banner at the top of every page.

The traffic capture service allows to capture the RTP traffic of calls. It consists of an internal and an external service. The external service is controlled by systemd and captures traffic using a native tcpdump process which communicates with the internal service over a named pipe. The internal service is responsible for assigning the packets to a call and assigning the packets to external, internal and worker channels.

If turned off then the Record RTP test parameter is without effect.

You can reboot the system using this button. You have to confirm the reboot before the reboot actually takes place.

You can halt the system using this button. You have to confirm the shutdown before it actually takes place.