Ozeki 10 SMS Gateway

CIMD2 connection

The CIMD2 protocol is and SMS protocol that enables you to connect to Nokia SMSCs. In Europe many mobile networks use this protocol to offer IP SMS services to customers. This guide explains, how you can connect to the mobile network that offers IPS SMS services through the CIMD2 protocol. You will also find direct download links to the protocol specifications.

What is a CIMD2 connection?

A CIMD2 connection is TCP/IP connection to the short message service centre (SMSC) of a mobile network operator. It allows your Ozeki SMS Gateway system to connect directly your mobile network operator's SMSC.

What does CIMD2 stand for?

CIMD stands for Computer Interface to Message Distribution. CIMD2 stands for version two of this protocol. This is protocol is implemented by Ozeki SMS Gateway.

Connection steps

  1. Navigate to https://localhost:9515 in your browser
  2. Login using your username and password
  3. In the connections panel click "Add new connection"
  4. Select "CIMD2 client"
  5. Type in the cimd2 server details
  6. Specify the telephone number
  7. Click ok to save your entries
  8. Send a test SMS message

Screenshots of the cimd2 connection setup procedure

The first screenshot shows you how to start the connection procedure to connect your SMS gateway system to an CIMD2 service provider. To do this, you need to create an CIMD2 client connection. Click on the "Add new connection ..." as you can see on the Figure 1.

creating a new connection
Figure 1 - Creating a new connection

Select the CIMD2 Client connection from the list and click Install (Figure 2).

install the cimd2 connection
Figure 2 - Install the CIMD2 connection

Now enter the contact details like Host, port, username and password. And enter the phone number that the SMS Gateway uses to send the message. Finally click on the OK button (Figure 3).

providing cimd2 client connection
Figure 3 - Providing CIMD2 Client credentials

In the Events tab you can see the logging of the latest server events. As you can see on the Figure 4 the login is successful.

successful login
Figure 4 - Successful login

From the Test tab you can send test SMS message. Provide the recipient address, the message and click on the Send button (Figure 5).

sending a test message
Figure 5 - Sending a test message

Finally you can see if the message is sent successfully. (Figure 6)

message successfully sent
Figure 6 - Message successfully sent

Example CIMD2 PDU

An example CIMD PDUs look like the following:

03:007021:06201234657033:hello world   

Each packet starts with STX (hex 02) and ends with ETX (hex 03). The content of the packet consists of fields separated by TAB (hex 09). Each field, in turn, consists of a parameter type, a colon (:), and the parameter value. Note that the last field must also be terminated with a TAB before the ETX.

In the CIMD2 PDUs two-digit parameter types are operation codes and each message must have exactly one. The number after the operation code is the sequence number used to match an operation to its response. The response code often referred to as acknowledgement of the message is equal to the operation code plus 50.

In the example above, the operation code 03 means submit message. Field 021 defines the destination address (telephone number), with field 033 is the user data (content) of the message. Response code 53 with a field 060 time stamp indicates that the message was accepted; if the message failed, the SMSC would reply with field 900 (error code) instead.

CIMD2 protocol specification