An SMS interface is available on SPN gateways. It can be used to:

• Configure the gateway.
• Configure the end-devices fleet.
• Configure the gateways fleet.
• Add license.
• Debug / troubleshoot the gateway.

The command syntax is also described in the web interface under the Help section in the SMS utils tab from the interface menu.

[spn:spnpwd] [cmdid1] flow/command

spn: SPN user, always spn.
spnpwd: SPN password.
cmdid1: command identifier used for response. Must be alphanumeric characters in lower case, 6 digits.
flow: group of command (end_device, gateway, rx_data, tx_data, configuration, update or status).
command: command to run, depending on flow.

[cmdid1:ok] answer

cmdid1: command identifier passed in request.
answer: the answer of the request, format depends on the request.

[cmdid1:error] error message

cmdid1: command identifier passed in request.
error message: error message indicating what goes wrong.

Before starting to work with the SMS manager, make sure to:

• For iFemtocell: plug an USB GSM dongle.
• Retrieve the SIM phone number used by the USB GSM Dongle.

[spn:spnpwd] [endadd] end_device/add_end_device end_device_csv

end_device_csv: syntax can be retrieved by downloading the template from the web interface.
Example:

[spn:spnpwd] [endadd] end_device/add_end_device ABP,C,,,,11223344,11112222333344445555666677778888,11112222333344445555666677778888,255,869525000,0

[spn:spnpwd] [endadd] end_device/add_end_device end_device_csv

end_device_csv: syntax can be retrieved by downloading the template from the web interface.
Example:

[spn:spnpwd] [endadd] end_device/add_end_device OTAA,C,1122334455667788,1122334455667788,11112222333344445555666677778888,,,,255,869525000,0

[spn:spnpwd] [enddel] end_device/delete_end_device dev_addr

dev_addr: ABP device address (8 hexadecimal digits in upper case).
Example:

[spn:spnpwd] [enddel] end_device/delete_end_device 11223344

[spn:spnpwd] [enddel] end_device/delete_end_device dev_eui

dev_eui: OTAA device EUI (16 hexadecimal digits in upper case).
Example:

[spn:spnpwd] [enddel] end_device/delete_end_device 1122334455667788

[spn:spnpwd] [enddef] end_device/delete_fleet

[spn:spnpwd] [gatadd] gateway/add_gateway gateway_csv

gateway_csv: syntax can be retrieved by downloading the template from the web interface.
Example:

[spn:spnpwd] [gatadd] gateway/add_gateway 7276FF0039020003

[spn:spnpwd] [gatdel] gateway/delete_gateway gateway_id

gateway_id: gateway identifier (16 hexadecimal digits in upper case).
Example:

[spn:spnpwd] [gatdel] gateway/delete_gateway 7276FF0039020003

[spn:spnpwd] [gatdef] gateway/delete_fleet

[spn:spnpwd] [rxdget] rx_data/get_rx_data dev_addr

dev_addr: ABP device address (8 hexadecimal digits in upper case).
Example:

[spn:spnpwd] [rxdget] rx_data/get_rx_data 11223344

SMS answer contains Rx data in CSV, syntax can be retrieved by downloading the template from the web interface.

[spn:spnpwd] [rxdget] rx_data/get_rx_data dev_eui

dev_eui: OTAA device EUI (16 hexadecimal digits in upper case).
Example:

[spn:spnpwd] [rxdget] rx_data/get_rx_data 1122334455667788

SMS answer contains Rx data in CSV, syntax can be retrieved by downloading the template from the web interface.

[spn:spnpwd] [txdadd] tx_data/add_tx_data tx_data_csv

tx_data_csv: syntax is described through DOWNLOAD button.
Example:

[spn:spnpwd] [txdadd] tx_data/add_tx_data 11223344,2,true,5,MDAyN2JkMDlkMGZlOWMzYTAwMDAwMDAwMDAwMGZmZmY=

Whole configuration is described can be retrieved by downloading the template from the web interface.

Sample of configuration file:

{
  "body": {
    "public": {
      "loftp": {
        "enable": false
      }
    }
  }
}

In this sample, parameter path is loftp.enable.

[spn:spnpwd] [conget] configuration/get_value parameter_path

parameter_path: parameter path.
Example:

[spn:spnpwd] [conget] configuration/get_value loftp.enable

[spn:spnpwd] [coset1] configuration/set_value boolean_parameter_path value

boolean_parameter_path: boolean parameter path.
value: true of false.
Example:

[spn:spnpwd] [coset1] configuration/set_value loftp.enable true

[spn:spnpwd] [coset1] configuration/set_value number_parameter_path value

number_parameter_path: number parameter path.
value: a number.
Example:

[spn:spnpwd] [coset2] configuration/set_value csvlo.rotation_count 55

[spn:spnpwd] [coset1] configuration/set_value string_parameter_path value

string_parameter_path: string parameter path.
value: a string in double quotes.

Example:

[spn:spnpwd] [coset3] configuration/set_value csvlo.rotation_time "hour"

[spn:spnpwd] [conres] configuration/reset

[spn:spnpwd] [updadd] update/add_license license_content

license_content: content of license file provided.
Example:

[spn:spnpwd] [updadd] update/add_license -----BEGIN SIGNATURE-----\nsmzmFH2J/tRteB62kkush427wKKE/ahM1ojCZukDlE2lGrR28QxPtKlBhoR9p0nc\nwm8uk1xFBlgj+x/1TmkxaRIkXJkQTqkUbvzsoe4omcPvgfjfTu3FiAiN3NkixCHw\nh6ehOilCNQvCiKTe8kWaO/Bx+jX+Pt4kmdpTMMch02dxisCNobAqPbzRq31ElH81\naa9nUgrcA4iqett5AowAcKfIPHIo6hTHvlGnmOhA7vN7IN9vdgtvTDEFclwxfbmU\nPqmqOVlXHfaaLV/Crn/R7wfkKjOPmEp3vaK0u2GkELzw0sQUzpkEMhJF2sN67ovd\ntDFUCNi54R5ziCmLMvko2A==\n-----END SIGNATURE-----\n-----BEGIN ICENSE-----\n[license]\nhardware_serial_number = 3903001D\nexpiration_date = 1540123200\ngateways_max_number = 10\nend_devices_max_number = 0\n-----END LICENSE-----

[spn:spnpwd] [updres] update/restore

[spn:spnpwd] [updreb] update/reboot

[spn:spnpwd] [updhal] update/halt

[spn:spnpwd] [staget] status/get_status

SMS answer contains status in CSV, syntax can be retrieved by downloading the template from the web interface.