Wirnet iBTS can be configured by sms command. The configuration available via SMS are mostly similar to the feature available in the web interface and rest API.

All SMS command will follow the same pattern :

[login:password] [sms_command_id] sms_command sms_field sms_value

• login: The login use for the board configuration. The value is admin.
• password: The password of the configuration user (pwd4admin by default). This password is the same as the web interface password.
• sms_command_id: ID defined by the customer to identify the SMS command. There is no default value. This ID is mandatory and must be 6 characters long.
• sms_command: The command to be executed with '/' separated fields.
• sms_field: The configuration field to be set/get (Optional).
• sms_value: The value that as to be set to a configuration field (Optional).

SMS reponses uses the following syntax:

[sms_command_id:sms_command_status] sms_error_info

• sms_command_id: ID defined by the customer to identify the SMS command. This matches with the sms_command_id description parameters send in the SMS.
• sms_command_status: ok or error.
• sms_error_info: SMS error information (Optional).

Examples:

Reboot command:

#SMS send to the gateway
[admin:pwd4admin] [reboot] system/reboot

#SMS response from gateway
[reboot:ok]

Restore stock command with wrong password:

#SMS send to the gateway
[admin:badpassword] [rstock] system/restore/stock

#SMS response from gateway
[rstock:error] login/password

Configuration commands are separated in two types: get commands and set commands.

Example:

Get GSM IP address:

#SMS send to the gateway
[admin:pwd4admin] [getgsm] configuration/get_value statm.gsm.address 

#SMS response from gateway
[getgsm:ok] "10.172.108.48"

Examples:

The Wirnet iBTS is able to send and receive SMS if the mobile network is properly configured. Modems are identified by sierra_X where X is a number. This can vary if the iBTS is a dual-SIM device.

To retrieve the identifier, use the gsmdiag.py command and read the resulting text file:

root@klk-lpbs-060434:~ # gsmdiag.py
Diagnostic written in /tmp/gsmdiag.txt
root@klk-lpbs-060434:~ # cat /tmp/gsmdiag.txt
Number of modems: 2
[Modem:/sierra_1]
  Syspath:/sys/devices/soc0/soc/2100000.aips-bus/2184200.usb/ci_hdrc.1/usb2/2-1/2-1.3
  HardwarePosition:1,1
  Powered:1
  Online:0
  Manufacturer:Sierra Wireless, Incorporated
  Model:MC7304
  Revision:SWI9X15C_05.05.58.00 r27038 carmd-fwbuild1 2015/03/04 21:30:23
  [SimProps]
    Present:0
  Error: no SIM in modem  
[Modem:/sierra_0]
  Powered:1
  Online:1
  Manufacturer:Sierra Wireless, Incorporated
  Model:MC7354
  Revision:SWI9X15C_05.05.58.00 r27038 carmd-fwbuild1 2015/03/04 21:30:23
  [SimProps]
    Present:1
    CardIdentifier:895XXXXXXXXXXXX1015
    SubscriberIdentity:3XXXXXXXXXXXXX3
    LockedPins:dbus.Array([], signature=dbus.Signature('s'), variant_level=1)
    PinRequired:none
  [NetworkRegistrationProps]
    Status:registered
    MobileCountryCode:XXX
    MobileNetworkCode:YY
    Name:ABCD
    Strength:80
  [ConnectionContexts]
    [/sierra_0/context1]
      Name:Internet
      Active:1
      Type:internet
      Protocol:ip
      AccessPointName:apname
      Username:uname
      Password:pass
      AuthenticationMethod:chap

Here there are two modems, and only one has a SIM card present. Its identifier is /sierra_0.

To send an SMS using the modem /sierra_0:

dbus-send --system --print-reply --dest=org.ofono /sierra_0 org.ofono.MessageManager.SendMessage string:"+33XXXXXXXXXX" string:"test sms"

Receive an SMS using a python test script :

receive-sms

#!/usr/bin/python2
 
from gi.repository import GLib
 
import dbus
import dbus.mainloop.glib
 
def chunkstring(string, length):
	return (string[0+i:length+i] for i in range(0, len(string), length))
 
def incoming_message(message, details, path, interface):
	message_txt = str(message.encode('utf-8'))
	print("Size of message: %d" % len(message_txt))
	print("%s" % (message_txt))
	for line in chunkstring(message_txt, 40):
		print("%s" % line)
 
	for key in details:
		val = details[key]
		print("    %s = %s" % (key, val))
	print("    %s = %s" % ('path',path))
	print("    %s = %s" % ('interface', interface))
 
if __name__ == '__main__':
	dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
 
	bus = dbus.SystemBus()
 
	bus.add_signal_receiver(incoming_message,
					bus_name="org.ofono",
					signal_name = "ImmediateMessage",
						path_keyword="path",
						interface_keyword="interface")
 
	bus.add_signal_receiver(incoming_message,
					bus_name="org.ofono",
					signal_name = "IncomingMessage",
						path_keyword="path",
						interface_keyword="interface")
 
	mainloop = GLib.MainLoop()
	mainloop.run()