eCall dialin eall™ sms & fax-portal · e all™ sms & fax-portal eCall dialin Concatenated SMS...

Dolphin Systems AG | Informieren & Alarmieren | Samstagernstrasse 45 |CH-8832 Wollerau Tel. +41 44 787 30 70 | Fax +41 44 787 30 71 | [email protected] | www.dolphin.ch

eCall™ sms & fax-portal

eCall dialin


eCall dialin

General information

Filename General information - eCall dialin 2015.08.12

Version 1.2

Date 12.08.2015

Changes 1.2 I


eCall dialin

Changes

Version Date Changes Author

1.0 22.01.2013 1st version DS

1.1 26.02.2013 Restructured, renamed and completed DS

1.2 12.08.2015 Chapter 5.2 Support and Layout updated DS

Content 1.2 I


eCall dialin

Content

1 Introduction .............................................................................................................................. 1

2 Basic information ....................................................................................................................... 2

2.1 Standard SMS .............................................................................................................................. 2

2.2 Results ......................................................................................................................................... 2

2.3 Notifications ................................................................................................................................ 2

2.4 Deferred delivery ........................................................................................................................ 2

2.5 Concatenated SMS ...................................................................................................................... 2

3 Access information .................................................................................................................... 3

3.1 Access number ............................................................................................................................ 3

3.2 Connection .................................................................................................................................. 3

3.3 Modems ...................................................................................................................................... 3

3.4 Protocol-types ............................................................................................................................. 4

4 Specification UCP ....................................................................................................................... 5

4.1 Document EMI-UCP Interface 5.2 – Specification ...................................................................... 5

4.2 Specification eCall dialin service from Dolphin Systems AG ....................................................... 5

4.2.1 Requirements............................................................................................................... 6

4.2.2 Supported features ...................................................................................................... 6

4.2.3 Structure of UCP-string – header and checksum ......................................................... 9

4.2.4 Operation codes and parameters ................................................................................ 9

4.2.5 Error code message ................................................................................................... 11

5 Remarks ................................................................................................................................... 12

5.1 Costs .......................................................................................................................................... 12

5.2 Support ..................................................................................................................................... 12

5.3 Individual solutions ................................................................................................................... 12

Chapter 1 - Introduction 1.2 1


eCall dialin

1 Introduction

This document contains general information about the dialin service from Dolphin Systems AG. This dialin

service allows analogue or digital (ISDN) modems to send SMS. The dialin service uses the Universal

Computer Protocol (UCP), a protocol primarily used to connect to Short Message Service Centres (SMSC)

for mobile telephones.

The dialin service can be used from any Swiss number using the access number 0900 900 941. The costs

are CHF 0.10 for establishing the connection and then CHF 0.39 per minute. The billing of SMS messages is

done via the phone bill from the number, which the call has come from.

In February 2013 eCall dialin from Dolphin Systems AG replaced the former Swisscom solution called

“SMS Single Account”. The main functionalities and features remain so that there is no change for

costumers. The access number is still the same.

This document has the following chapters as structure:

Basic information

Access information

Specification UCP

Remarks

Chapter 2 - Basic information 1.2 2


eCall dialin

2 Basic information

This chapter gives basic information about the eCall dialin service and its features.

2.1 Standard SMS

The standard SMS is a simple submit of a message from any analogue or digital (ISDN) modem to a mobile

phone. The service allows sending up to 160 characters per SMS to any number.

2.2 Results

The dialin service sends a result after the validation of the received date. A positive result shows that an

SMS was created and successfully sent to the SMSC of the provider. A negative result shows that no SMS

is sent and that there is incorrect information in the received data. In this case an error code and text is

sent back to easier find the problem of the string.

2.3 Notifications

It is possible to request a notification, if the SMS is delivered to the mobile phone. In this case the

connection between modem and eCall dialin remains and as soon as eCall dialin gets die notification from

the SMSC, it will be forwarded to the modem.

2.4 Deferred delivery

It is possible to defer delivery of a message to specific time in future.

2.5 Concatenated SMS

It is possible to send long SMS up to 800 characters. Therefore an extra service called concatenated SMS

is used, which allows to combine two or more messages.

Chapter 3 - Access information 1.2 3


eCall dialin

3 Access information

In this chapter information about access, connection, modems and protocol-types are found.

3.1 Access number

The eCall dialin service can be used from any Swiss number using the access number 0900 900 941. This

number is charged as described under 5.1 Costs. Basically this number can be accessed by any analogue or

digital (ISDN) modem.

3.2 Connection

Note the following setting for the connection:

Usually the calling system will have to close the connection after all the data is transmitted.

The connection will be closed after 180 seconds anyway.

If no connection can be established, the call will be dropped after 120 seconds.

Only one SMS per call.

3.3 Modems

Normally any modem may be used for eCall dialin. Especially the following modems are recommended:

MicroLink ISDN i devolo: This is a digital (ISDN) modem from devolo AG, more information is

found on the internet http://www.devolo.de .

TFM-560X, 56K External Data/Fax/TAM Modem: This is an analogue modem from TRENDnet,

more information is found on the internet http://www.trendnet.com .

56K USB Modem (Model 5637): This is an analogue modem from USRobotics with USB, more

information is found on the internet http://www.usr.com .

Chapter 3 - Access information 1.2 4


eCall dialin

3.4 Protocol-types

The following list of protocols used by digital (ISDN) modems is supported by eCall dialin:

X.25

X.31

X.75

V.110

V.120

The following list of protocols used by analogue modems is supported:

V.21

V.22

V.22bis

V.23

V.32

V.32bis

V.34

V.42

V.42bis

V.90

HDLC

The bit rate supported by eCall dialin is from 1200 up to 56’000 bits per second (send and receive).

Chapter 4 - Specification UCP 1.2 5


eCall dialin

4 Specification UCP

The eCall dialin service uses the Universal Computer Protocol (UCP), a protocol primarily used to connect

to short message service centres (SMSCs) for mobile telephones. UCP covers a wide spectrum of features

and services. The eCall dialin service only uses the key features of UCP, before using eCall dialin please

check the specification for the eCall dialin service from Dolphin Systems AG below.

4.1 Document EMI-UCP Interface 5.2 – Specification

General information for the specification for UCP is documented in the document EMI-UCP Interface 5.2 –

Specification from Acision BV and can be found under http://en.dialin.ecall.ch . The protocol was

developed by CMG Wireless Data Solutions, now part of Acision.

“The purpose of this document is to specify the interface that is used between the Short Message Service

Centre (SMSC) system and other computer systems/ applications. The interface is based on the ERMES

Universal Computer Protocol (UCP) with some SMSC specific extensions.

Throughout this document, the interface is referred to as EMI (External Machine Interface). The protocol

that is described in this document has been implemented in an Application Programming Interface (API)

built by Acision. Hereby, application programmers are able to build applications for communication with a

Acision SMSC in order to send and receive Short Messages to/from mobile stations.”

4.2 Specification eCall dialin service from Dolphin Systems AG

This chapter contains the specification for the eCall dialin service from Dolphin Systems AG. As mentioned

before eCall dialin service only uses the key features of UCP. As far as possible the eCall dialin service

coincides with this general specification, otherwise it is mentioned here. The following subjects are

explained on the following pages:

Requirements

Supported features

Structure of UCP-string – header and checksum

Operation codes and parameters

Error codes message



eCall dialin

4.2.1 Requirements

For using eCall dialin service from Dolphin Systems AG the following requirements are necessary:

An analogue or digital (ISDN) modem

The modem uses a phone line with a Swiss number to access.

090X-services (extra services) are not blocked.

The access number is not blocked.

The Universal Computer Protocol (UCP) is used.

4.2.2 Supported features

The eCall dialin service offers some specific features, which are described next.

Standard SMS

To transmit a standard SMS, the modem sends the data in UCP standards, for example

“01/00056/O/01/0041790000000/0041000000000//3/54657374/89” to send the Content “Test” to the

number 0041790000000 with originator 0041000000000.

Note: If the number of characters exceeds 160, the characters are cut off and the last character is

replaced by “#”.

Normally the SMS is sent within a few seconds. If an SMS could not be sent, it is buffered a maximum of

24 hours, in this period there are several retries of sending.

Results

The eCall dialin service sends a result after the validation of the received date. A positive result shows that

an SMS was created and successfully sent to the SMSC of the provider.

Examples of a positive result: “01/00042/R/01/A/0790000001:070113104022/E5”

A negative result shows that no SMS could be created and that there is incorrect information in the

received data. In this case an error code and text is sent back to easier find the problem of the string.

Examples of a negative result: “01/00032/R//N/02/Syntax error/72”



eCall dialin

Notification requested

The feature notification requested allows sending the notification, if the SMS is delivered to the mobile

phone, from the SMSC back to the modem. Therefore the connection between modem and eCall dialin

needs to remain until the notification has been forwarded to the modem (otherwise there will be no

notification sent back to the originator.

This feature needs operation code 30 or 51 and the value of the NRq-field needs to be set to “1”. The

content of the answer of a successfully sent notification is "Message for 0041790000000, with

identification 070113104026 has been delivered on 2013-01-07 at 10:40:30." Otherwise if the message

could not be sent, the system will answer "Message for 0041790000000, with identification

130107133150 has been buffered" if the message could not be sent only at this moment or "Message for

0041790000000, with identification 130107132711 could not be delivered.” if the message could not be

sent at all.

Deferred delivery

The feature deferred delivery can be used with the operation code 30 or 51 for defer delivery of a

message to specific time in future. Therefore in the corresponding DDT-field the delivery time can be

specified in the common format DDMMYYHHmm.

Example of the DDT-field for deferred delivery to 15. January 2013 at 15:35: 1501131435

Note: If the date is in the past, the SMS is sent immediately.



eCall dialin

Concatenated SMS

The feature concatenated SMS uses an extra service within the operation code 51. The XSer-field of the

string can be specified in common format TTLLDD…DD using XSer type number 01.

Format: AABBCCDDEEFFGGHH

AA: Number of the XSer service (for concatenated SMS “01”);

BB: Number of octets in the whole followed DD…DD part (if only the service concatenated SMS is needed,

then it is “06”;

CC: Number of octets in the first service (if only the service concatenated SMS is needed, then it is “05”);

DD: Information-Element-Identifier (for concatenated SMS “00”);

EE: Number of octets in this element, it is “03”);

FF: Concatenated short message reference number (number from “00” to “FF”, needs to be the same in

all strings belonging together);

GG: Maximal number of short messages in the concatenated message (number from “00” to “FF”);

HH: Sequence number of the current short message (number from “00” to “FF”)

Example of the XSer-field for a concatenated short message in 3 parts:

String 1: 0106050003010301 (part 1 of 3)

String 2: 0106050003010302 (part 2 of 3)

String 3: 0106050003010303 (part 3 of 3)

Important:

The order of the incoming strings needs to be correct

All parts are needed before any further action is done

Any other field then the message and the XSer-field must be equal in all parts, especially the

transaction reference number, address code recipient and originator, and if needed the

notification request and deferred delivery request fields.

If one of these points is incorrect, the message cannot be sent.

Note: If the sum of the length of all concatenated messages together exceeds the maximum of XXX

characters, the characters are cut off and the last character is replaced by “#”.



eCall dialin

4.2.3 Structure of UCP-string – header and checksum

The UCP sends data in strings with a specific structure. This structure is

stx <Header> / <Data> / <Checksum> etx

The Header contains four parameters (TRN, LEN, O/R, OT) and the Checksum one (LSB). They are

mandatory. In the middle are the data-parameters, which are different for every operation code. They are

described in more detail in the next section.

4.2.4 Operation codes and parameters

The supported operation codes and parameters are described next.

Operation Code 01

This code can be used for standard messages.



eCall dialin

Operation Code 02

Technically this code is used for sending a message to several recipients, but the eCall dialin service only

allows one recipients per message.

Operation Code 30

This code allows the features “notification requested” and “deferred delivery” as described in 3.2.2

Supported feature.

Operation Code 51 and 53

These codes allow the features “concatenated SMS”, “notification requested” and “deferred delivery” as

described in 3.2.2 Supported feature.



eCall dialin

Operation Code 60

4.2.5 Error code message

The following List of error codes is used in the eCall dialin service.

Error code Error code message Description

01 Checksum Error Incorrect checksum

02 Syntax Error Incorrect characters, lengths, strings

03 Operation Not Allowed Incorrect data in supported parameters

06 AdC Invalid Incorrect or missing recipient

10 Repetition Not Allowed Multiple orders in one call are not supported

22 Time period not valid Incorrect deferred delivery time

Chapter 5 - Remarks 1.2 12


eCall dialin

5 Remarks

This chapter mentions other important information about the eCall dialin service.

5.1 Costs

The costs using eCall dialin depend on the number and length of the calls. The connection setup costs

CHF 0.10 per call. During the call CHF 0.39 per minute (billed every second) are charged, starting with the

call answering and ending with the End of the call). One must note that there may, after receiving the call

take some time for the two modems to establish a connection.

The billing of any costs is done via the phone bill of the originators address and is listed under the 090X

services.

5.2 Support

Dolphin Systems AG provides technical (second-level) support for the eCall dialin service in English and

German during business hours. For any further services costumers may make use of a Service Level

Agreement (SLA).

5.3 Individual solutions

Dolphin Systems as a provider offers many other services around communication and alerting as well as a

project management for customized individual solutions.

eCall dialin eall™ sms & fax-portal · e all™ sms & fax-portal eCall dialin Concatenated SMS...

Documents

Transcript of eCall dialin eall™ sms & fax-portal · e all™ sms & fax-portal eCall dialin Concatenated SMS...