How to configure OP5 to send SMS via Telit HT910G

Connect

  • Add your SIM card to the Telit GSM modem and attach it via USB port to your server.
  • To find the port where your GSM modem is attached, execute the following script after you’ve marked it as executable.

#!/bin/bash
for sysdevpath in $(find /sys/bus/usb/devices/usb*/ -name dev); do
(
syspath=”${sysdevpath%/dev}”
devname=”$(udevadm info -q name -p $syspath)”
[[ “$devname” == “bus/”* ]] && continue
eval “$(udevadm info -q property –export -p $syspath)”
[[ -z “$ID_SERIAL” ]] && continue
echo “/dev/$devname – $ID_SERIAL”
)
done

# ./listdev.sh/dev/ttyACM0 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM1 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM2 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM3 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM4 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM5 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/ttyACM6 - Telit_wireless_solutions_Telit_Wireless_Module_351579057468926/dev/input/mouse2 - VMware_VMware_Virtual_USB_Mouse/dev/input/event4 - VMware_VMware_Virtual_USB_Mouse/dev/input/js0 - VMware_VMware_Virtual_USB_Mouse/dev/input/mouse3 - VMware_VMware_Virtual_USB_Mouse/dev/input/event5 - VMware_VMware_Virtual_USB_Mouse

Take a note of the device-path (/dev/ttyACM0)

Configuration

This sample configuration file works fine in our productive environment on a SIM card without PIN code enabled, find it at /etc/smsd.conf. Make sure you use the correct device-path from above (device=/dev/ttyACM0)

# Example smsd.conf. Read the manual for a description
devices=GSM1
logfile=/var/log/smsd/smsd.log
loglevel=8
user=root
infofile=/var/run/smsd/smsd.working
pidfile=/var/run/smsd/smsd.pid
# 3.1.5 introduced smart logging
# once your configuration is OK, set log level lower (5 is good in most cases)
smart_logging=yes

 

[GSM1]
init=ATE0
incoming=no
rtscts=no
cs_convert=yes
report=no
mode=new
device=/dev/ttyACM0
pin=0014
baudrate=115200

Testing

Configure your hyperterminal session by using minicom -s

# minicom -s

Select “Serial port setup”

Make sure your settings looks like this (A – Serial Device must match the path from above, E – Bps/Par/Bits must be 19200 8N1 or 115200 8N1). Press ENTER to save your setting.

Select Exit to open the connection to the GSM modem

The connection is initalized

The connection is open, the GSM modem is ready to receive commands

Send SMS by using AT commands. NOTE: In this example we have removed the PIN of the SIM card, if the PIN is still present make sure you are properly authenticated – additional details please see the chapter ‘PIN codes by using AT commands’ below)ATOKAT+CMGF=1 -----> set message format, see AT referenceOKAT+CMGS="+41796316771"> Hello World!><PRESS CTRL-Z to send the message>
+CMGS: 255OK

To exit minicom press CRTL-A and then x or q.

Services

Make sure the smsd service is enabled to start on boot# chkconfig --list smsdsmsd 0:off 1:off 2:off 3:on 4:off 5:off 6:off

Enable the service on boot for runlevel 3,4 and 5 by using the following command# chkconfig smsd on

To start/stop the service use following command# service smsd stop# service smsd start

Make sure the smsd service is running by using the command line
# service smsd statussmsd (pid 1476 1475) is running...
Or check the service status via OP5 webbased GUI

Make sure you can send a SMS message by using OP5 webbased GUI.

To send SMS notifications, make sure your contacts have filled out the ‘Pager’ information

Troubleshooting

CMS Error: 314

AT+CMGS="+41796316771"+CMS ERROR: 314
CMS Error: 314 usualy means the device is busy and you have to try later again. Sometimes you can try as long as you want, you wont become able to send messages. If this is the case try to reset your GSM modem by using following command and try again afterwards, you may have solved the problem with that.

AT&F

CMS Error: 500

CMS ERROR: 500 is unfortunately a very generic error message. Try to send an SMS directly without storing it to the SIM.

AT+CMGS    ‘ Send an SMS directly without storing to the SIM
AT+CMGW   ‘ Writing an SMS to the SIM card and then send the SMS
AT+CMGR    ‘ By using the CMGR command you can verify if the SMS is written to SIM and it’s current status

Read your configured Service-Center number configured on your SIM card to send SMS messages (for example the number of Swisscom)AT+CSCA?
+CSCA: "+41794999000",145

If the number is not correctly configured then change it by usingAT+CSCA="+41794999000",145
OK

PIN codes by using AT commands

If you have a PIN code enabled SIM card and want to remove / disable the PIN code by using AT commands, then follow these commands. Suppose 9546 is the current PIN code, replace 9546 with your PIN code. Query the state of the SIM card by using the CPIN? command and remove the SIM code afterwards.

AT+CPIN?
+CPIN: SIM PIN ----> pin codes need to be entered
OK
AT+CPIN="9546"
OKAT+CLCK="SC",0,"9546" ----> disable pin code
OKAT+CPIN?
+CPIN: READY

Attached some examples about PIN and PUK management:
AT+CLCK="SC",1,"0000",1 ---->When you want to set pin code "0000"
OK
--Reboot module
AT+CPIN?
+CPIN: SIM PIN
OK
AT+CPIN="0000"
OK
AT+CPWD="SC","0000","1234" ---->When you want to change the pin code to "1234"
OK
--Reboot module
AT+CPIN?
+CPIN: SIM PIN
OK
AT*PSPRAS?
*PSPRAS: 3,10,255,255
OK
AT+CPIN="7777" ---->Input the wrong pin code will reduce the available try times
+CME ERROR: incorrect password
AT*PSPRAS?
*PSPRAS: 2,10,255,255
OK
AT+CPIN="1234"
OK
AT+CPIN?
+CPIN: SIM PUK
OK
AT+CPIN="44753796","1234" ---->When you want to input the PUK code after you input 3 times of the wrong pin.
OK

GSM connection state details

Check for Received Signal Strength & Quality

AT+CSQ
+CSQ: 13,1

Wait for the response in format: +CSQ: <rssi>, <ber>

<rssi>
Integer from 0 to 99 indicates the received signal strength. NOTE: Signal strength less than 6 indicates only 1 antenna bar, the quality of a connection will be poor and the connection may even drop.

<rssi> value Signal strength  Indication (for devices with a User Interface (MMI)) 
0 -113 dBm or less Signal is VERY low: at the extreme sensibility limit
1 -111 dBm MMI may indicate only 1 antenna bar
2 -109 dBm MMI may indicate only 1 antenna bar
3 -107 dBm MMI may indicate only 1 antenna bar
4 -105 dBm MMI may indicate only 1 antenna bar
5 -103 dBm MMI may indicate only 1 antenna bar
6 -101 dBm MMI may indicate 2 antenna bars
7 -99 dBm MMI may indicate 2 antenna bars
8 -97 dBm MMI may indicate 2 antenna bars
9 -95 dBm MMI may indicate 2 antenna bars
10 -93 dBm MMI may indicate 3 antenna bars
11 -91 dBm MMI may indicate 3 antenna bars
12 -89 dBm MMI may indicate 3 antenna bars
13 -87 dBm MMI may indicate 3 antenna bars
14 -85 dBm MMI may indicate 3 antenna bars
15 -83 dBm MMI may indicate 4 antenna bars
16 -81 dBm MMI may indicate 4 antenna bars
17 -79 dBm MMI may indicate 4 antenna bars
18 -77 dBm MMI may indicate 4 antenna bars
19 -75 dBm MMI may indicate 4 antenna bars
20 -73 dBm MMI may indicate 4 antenna bars
21 -71 dBm MMI may indicate 4 antenna bars
22 -69 dBm MMI may indicate 4 antenna bars
23 -67 dBm MMI may indicate 4 antenna bars
24 -65 dBm MMI may indicate 4 antenna bars
25 -63 dBm MMI may indicate 4 antenna bars
26 -61 dBm MMI may indicate 4 antenna bars
27 -59 dBm MMI may indicate 4 antenna bars
28 -57 dBm MMI may indicate 4 antenna bars
29 -55 dBm MMI may indicate 4 antenna bars
30 -53 dBm MMI may indicate 4 antenna bars
31 -51 dBm or more MMI may indicate 4 antenna bars
99 not detected MMI may indicate flashing antenna bars

<bet>
Integer from 0 to 7 and 99 reports the received signal quality measured on the radio traffic channel (error bit rate in percent)

Check if device is registered to the network

AT+CREG?
+CREG: 0,1

Wait for response in the format: +CREG: <mode>, <stat>

<mode>
0 GSM
2 UTRAN

<stat>
0 – not registered, ME is not currently searching a new operator to register to
1 – registered, home network
2 – not registered, but ME is currently searching a new operator to register to
3 – registration denied
4 – unknown
5 – registered, roaming

Overall overview

“battchg” – battery charge level – battery charge level indicator range 0..5
“signal”   – signal quality – signal quality indicator, range: 0 to 7, 99 – not measurable
“service” – service availability – service availability indicator, range: 0 – not registered to any network, 1 – registered

AT+CIND=?
+CIND: (("battchg",(0-5,99)),("signal",(0-7,99)),("service",(0,1)),("sounder",()

Reboot device

AT#REBOOT

Check device hardware

Manufacturer Identification
AT+GMI
Telit

Model Identification
AT+GMM
HE910-D

Revidion Identification
AT+GMR
12.00.024

Serial Identification
AT+GSN
00007406xx

GSM Equipment and Network Error Codes

When controlling GSM devices using AT commands, the device can respond with either “OK” or “ERROR”. Sometimes you will receive an error and you do not know the cause of this error. That’s why most advanced GSM devices support extended errors. Instead of just displaying the “ERROR” message, it also shows an error number. The syntax of this extended error is either “+CMS ERROR: xxx” or “+CME ERROR: xxx”. When the error starts with “+CME ERROR”, it means that the error is a device specific error code. For instance, you are trying to read a phonebook entry before entering a pincode. When there is a network error, for instance, when you try to send an SMS message when there is no network coverage, you will receive an error which starts with “+CMS ERROR”. To enable these extended commands, execute the following commands, or add them to your modems init string:

AT+CMEE=1 AT&W

Below you can find a list containing almost every error code supported by GSM devices.

CME ERROR’s (GSM Equipment related codes)
Error Description
CME ERROR: 0 Phone failure
CME ERROR: 1 No connection to phone
CME ERROR: 2 Phone adapter link reserved
CME ERROR: 3 Operation not allowed
CME ERROR: 4 Operation not supported
CME ERROR: 5 PH_SIM PIN required
CME ERROR: 6 PH_FSIM PIN required
CME ERROR: 7 PH_FSIM PUK required
CME ERROR: 10 SIM not inserted
CME ERROR: 11 SIM PIN required
CME ERROR: 12 SIM PUK required
CME ERROR: 13 SIM failure
CME ERROR: 14 SIM busy
CME ERROR: 15 SIM wrong
CME ERROR: 16 Incorrect password
CME ERROR: 17 SIM PIN2 required
CME ERROR: 18 SIM PUK2 required
CME ERROR: 20 Memory full
CME ERROR: 21 Invalid index
CME ERROR: 22 Not found
CME ERROR: 23 Memory failure
CME ERROR: 24 Text string too long
CME ERROR: 25 Invalid characters in text string
CME ERROR: 26 Dial string too long
CME ERROR: 27 Invalid characters in dial string
CME ERROR: 30 No network service
CME ERROR: 31 Network timeout
CME ERROR: 32 Network not allowed, emergency calls only
CME ERROR: 40 Network personalization PIN required
CME ERROR: 41 Network personalization PUK required
CME ERROR: 42 Network subset personalization PIN required
CME ERROR: 43 Network subset personalization PUK required
CME ERROR: 44 Service provider personalization PIN required
CME ERROR: 45 Service provider personalization PUK required
CME ERROR: 46 Corporate personalization PIN required
CME ERROR: 47 Corporate personalization PUK required
CME ERROR: 48 PH-SIM PUK required
CME ERROR: 100 Unknown error
CME ERROR: 103 Illegal MS
CME ERROR: 106 Illegal ME
CME ERROR: 107 GPRS services not allowed
CME ERROR: 111 PLMN not allowed
CME ERROR: 112 Location area not allowed
CME ERROR: 113 Roaming not allowed in this location area
CME ERROR: 126 Operation temporary not allowed
CME ERROR: 132 Service operation not supported
CME ERROR: 133 Requested service option not subscribed
CME ERROR: 134 Service option temporary out of order
CME ERROR: 148 Unspecified GPRS error
CME ERROR: 149 PDP authentication failure
CME ERROR: 150 Invalid mobile class
CME ERROR: 256 Operation temporarily not allowed
CME ERROR: 257 Call barred
CME ERROR: 258 Phone is busy
CME ERROR: 259 User abort
CME ERROR: 260 Invalid dial string
CME ERROR: 261 SS not executed
CME ERROR: 262 SIM Blocked
CME ERROR: 263 Invalid block
CME ERROR: 772 SIM powered down
CMS ERROR’s (GSM Network related codes)
Error Description
CMS ERROR: 1 Unassigned number
CMS ERROR: 8 Operator determined barring
CMS ERROR: 10 Call bared
CMS ERROR: 21 Short message transfer rejected
CMS ERROR: 27 Destination out of service
CMS ERROR: 28 Unindentified subscriber
CMS ERROR: 29 Facility rejected
CMS ERROR: 30 Unknown subscriber
CMS ERROR: 38 Network out of order
CMS ERROR: 41 Temporary failure
CMS ERROR: 42 Congestion
CMS ERROR: 47 Recources unavailable
CMS ERROR: 50 Requested facility not subscribed
CMS ERROR: 69 Requested facility not implemented
CMS ERROR: 81 Invalid short message transfer reference value
CMS ERROR: 95 Invalid message unspecified
CMS ERROR: 96 Invalid mandatory information
CMS ERROR: 97 Message type non existent or not implemented
CMS ERROR: 98 Message not compatible with short message protocol
CMS ERROR: 99 Information element non-existent or not implemente
CMS ERROR: 111 Protocol error, unspecified
CMS ERROR: 127 Internetworking , unspecified
CMS ERROR: 128 Telematic internetworking not supported
CMS ERROR: 129 Short message type 0 not supported
CMS ERROR: 130 Cannot replace short message
CMS ERROR: 143 Unspecified TP-PID error
CMS ERROR: 144 Data code scheme not supported
CMS ERROR: 145 Message class not supported
CMS ERROR: 159 Unspecified TP-DCS error
CMS ERROR: 160 Command cannot be actioned
CMS ERROR: 161 Command unsupported
CMS ERROR: 175 Unspecified TP-Command error
CMS ERROR: 176 TPDU not supported
CMS ERROR: 192 SC busy
CMS ERROR: 193 No SC subscription
CMS ERROR: 194 SC System failure
CMS ERROR: 195 Invalid SME address
CMS ERROR: 196 Destination SME barred
CMS ERROR: 197 SM Rejected-Duplicate SM
CMS ERROR: 198 TP-VPF not supported
CMS ERROR: 199 TP-VP not supported
CMS ERROR: 208 D0 SIM SMS Storage full
CMS ERROR: 209 No SMS Storage capability in SIM
CMS ERROR: 210 Error in MS
CMS ERROR: 211 Memory capacity exceeded
CMS ERROR: 212 Sim application toolkit busy
CMS ERROR: 213 SIM data download error
CMS ERROR: 255 Unspecified error cause
CMS ERROR: 300 ME Failure
CMS ERROR: 301 SMS service of ME reserved
CMS ERROR: 302 Operation not allowed
CMS ERROR: 303 Operation not supported
CMS ERROR: 304 Invalid PDU mode parameter
CMS ERROR: 305 Invalid Text mode parameter
CMS ERROR: 310 SIM not inserted
CMS ERROR: 311 SIM PIN required
CMS ERROR: 312 PH-SIM PIN required
CMS ERROR: 313 SIM failure
CMS ERROR: 314 SIM busy
CMS ERROR: 315 SIM wrong
CMS ERROR: 316 SIM PUK required
CMS ERROR: 317 SIM PIN2 required
CMS ERROR: 318 SIM PUK2 required
CMS ERROR: 320 Memory failure
CMS ERROR: 321 Invalid memory index
CMS ERROR: 322 Memory full
CMS ERROR: 330 SMSC address unknown
CMS ERROR: 331 No network service
CMS ERROR: 332 Network timeout
CMS ERROR: 340 No +CNMA expected
CMS ERROR: 500 Unknown error
CMS ERROR: 512 User abort
CMS ERROR: 513 Unable to store
CMS ERROR: 514 Invalid Status
CMS ERROR: 515 Device busy or Invalid Character in string
CMS ERROR: 516 Invalid length
CMS ERROR: 517 Invalid character in PDU
CMS ERROR: 518 Invalid parameter
CMS ERROR: 519 Invalid length or character
CMS ERROR: 520 Invalid character in text
CMS ERROR: 521 Timer expired
CMS ERROR: 522 Operation temporary not allowed
CMS ERROR: 532 SIM not ready
CMS ERROR: 534 Cell Broadcast error unknown
CMS ERROR: 535 Protocol stack busy
CMS ERROR: 538 Invalid parameter

Reference Guide

Download offline copy: Telit 3G HE910 3G/HSDPA/GSM Modem AT Command Reference R10

One thought on “How to configure OP5 to send SMS via Telit HT910G

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.