GSR Lite

SMS configuration

GSR’s configuration parameters can be programmed sending SMS messages to the device. The accepted format is as follows:

password,command,command, ... ,command

A sequence is created starting with the password and continuing with a list of commands separated by commas ( , ). The default password is 12345.

The commands used for the SMS configuration are:

  • S is used for configuration. The structure begins with ( S ), followed by colon ( : ), the parameter to set, colon again ( : ) and the value assigned to that parameter.
  • C is used for running commands. The structure begins with ( C ), followed by colon ( : ) and the command to run. Certain commands also use values, in these cases add colon again ( : ) and set the value.
  • Add W at the end of an SMS to save the changes introduced with that particular message. In case this command is not added, the changes will be lost after rebooting the device.
  • G is used for consulting a parameter. The structure begins with ( G ) followed by colon ( : ) and the parameter to consult. A message will be received with its current value.

Here follows an example:

12345,S:$apn:”apnaddress.com”

Password – 12345
Command – S
Parameter – $apn
Value – “apnaddress.com”

With these commands can be performed the following actions:

Consulting a parameter

G command is used for consulting (to consult) parameters like (as shown) in the following example:
12345,G:$apn

Answer:
["apnaddress.com"]

APN configuration

The APN the device uses can be configured with the following parameters:

  • $apn to set up APN address
  • $apnu to set up user
  • $apnp to set up password

The following SMS is an example of how to configure correctly APN settings:

12345,S:$apn:"apnaddress.com",S:$apnu:"user",S:$apnp:"password"

Response:

["OK","OK","OK"]

This example sets the APN apnaddress.com ($apn) with the user user ($apnu) and the password password ($apnp). These values must be inside quotation marks ( “ ) when setting up APN configuration.

WiFi connectivity

GSR is programmed to provide wireless internet connectivity only to Advertisim devices. As soon as an Advertisim device detects a GSR wireless network it will connect automatically. There is no need to perform any previous or additional settings to Advertisim nor GSR given that the connection is established automatically. GSR allows to enable or disable its WiFi network with the following SMS:

12345,C:wifi:1 enable WiFi

12345,C:wifi:0 disable WiFi

The response in both cases is:

["OK"]

Status report

The device features a SMS report. It shows:

  • Device ID
  • Signal strength (CSQ: 0 – 31)
  • ICC
  • IMEI
  • VPN connection status

The report can be requested with the following SMS:

12345,C:rp

Example response:

[{"id":"gsr.a8404118569f","modem.csq":17,"modem.icc":"8934075100252","modem.imei":"863786532","n4m.online":true}]

Where:

  • "id": device identification – MAC
  • "modem.csq": mobile networks signal strength. Values oscillate (eliminar) between 0 and 31. If it shows (The value) 99 it means that there is (indicates) an error in the network.
  • "modem.icc": SIM card ICC identifier.
  • "modem.imei": modem IMEI identifier.
  • "n4m.online": connection status to net4machines VPN. Its values can be true or false.

Device reboot

The device can be rebooted with the following SMS:

12345,C:rbt

Answer:

["OK"]

All LEDs will blink and the device will reboot.

Software reboot

In order to reboot only the internal software, the following SMS must be used:

12345,C:rst

Answer:

["OK"]

All LEDs will turn on for a few seconds and then off until the software is running again.

Factory reset

The device can be set to its factory settings with the following SMS:

12345,C:factory

Answer:

["OK"]

After the command is executed, the device will be automatically reflashed, rebooted and set to its factory configuration.