SERVICE


Some commands allow maintenance operations on the device:


APN PROTOCOL


The APN address is part of the device settings and is defined in parameter N03, this command allows you to set the protocol to be used for data connections through the cellular network.


Command

AT+APN=<mode>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<mode>

-1 : AUTOMATIC (IPV4/IPV6)

0 : FORCE IPV4 (SUITABLE FOR 2G CONNECTIONS)

1 : FORCE PPP

2 : FORCE IPV6

3 : AUTOMATIC (SAME AS -1)


AT#APN? returns current setting.

APN AUTHENTICATION


The APN address is part of the device settings and is defined in parameter N03, this command allows you to set the type of authentication to be used for data connections through the cellular network.


Command

AT+AUTH=<mode>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<mode>

0 : NO AUTHENTICATION

2 : PAP (Password Authentication Protocol)

3 : CHAP (Challenge Handshake Authentication Protocol)

4 : PAP/CHAP


AT#AUTH? returns current setting.

PLMN BANDS


This command allows you to limit or modify the use of the predefined radio bands for cellular communication.


Command

AT+QCFG="band",<bandval>,<ltebandval>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<bandval>

HEX VALUE SPECIFYING GSM AND WCDMA BANDS

00000000 : No change

00000001 : GSM900

00000002 : GSM1800

00000004 : GSM850

00000008 : GSM1900

00000010 : WCDMA 2100

00000020 : WCDMA 1900

00000040 : WCDMA 850

00000080 : WCDMA 900

00000100 : WCDMA 800

00000200 : WCDMA 1700

0000FFFF : Any frequency band


<ltebandval>

HEX VALUE SPECIFYING LTE BANDS

0 : No change

0x1 : LTE B1 (2100 MHz)

0x4 : LTE B3 (1800 MHz)

0x10 : LTE B5 (850 MHz)

0x40 : LTE B7 (2600 MHz)

0x80 : LTE B8 (900 MHz)

0x80000 : LTE B20 (800 MHz)

0x7FFFFFFFFFFFFFFF : Any frequency band


AT+QCFG="band" (omitting parameters) return current configuration.

Avior default is: AT+QCFG="band",93,80044

To force 2G (900/1800) only:  AT+QCFG="band",3,0

To force 2G (900/1800) and LTE B3 B7 B20: AT+QCFG="band"3,80044

To force all 2G, 3G, 4G bands: AT+QCFG="band",d3,800d5


To read the network registration status type the commands:

AT+CREG=2

AT+CREG?

the answer will be: +CREG: 2,<stat>,<lac>,<cid>,<Act>

stat is the registration status:

0 : NOT REGISTERED

1 : REGISTERED HOME NETWORK

2 : SEARCHING

3 : REGISTRATION DENIED

4 : UNKNOWN

5 : REGISTERED ROAMING

lac is the local area code

cid is network registration Cell ID

Act is the access technology in use:

0 : GSM (2G)

2 : UTRAN (3G)

3 : GSM W / EGPRS (2G EDGE)

4 : UTRAN W / HSDPA (3G)

5 : UTRAN W / HSUPA (3G)

6 : UTRAN W / HDSPA and HSUPA (3G)

7 : E-UTRAN (4G)


WIFI NETWORKS


Scan and list available WiFi networks.


Command

AT#WIFISCAN

Response

Network-1

Network-2

...

LIST OF DETECTED WIFI NETWORKS


ERROR

COMMAND REJECTED (WIFI UNAVAILABLE)

CLEAR PENDING MESSAGES


All pending messages waiting to be sent will be deleted.


Command

AT#CLEARMSG

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

CLEAR PENDING COMMANDS


All pending commands waiting to be executed will be deleted.


Command

AT#CLEARCMD

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

EVENT DETECTION


Event detection is disabled, no rules will be triggered until the service is disabled, restored automatically at the end of the day (23:59).


Command

AT#EVENT=<mode>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<mode>

0 : EVENT DETECTION DISABLED

1 : EVENT DETECTION ENABLED

EVENT SIMULATION


Forces the execution of all  rules belonging to an event.

Any conditions included within the rule will also be checked.


Command

AT#TRIGGER=<event>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<event>

CODE OF THE TRIGGER TO BE EXECUTED

LIST OF EVENTS


To trigger all rules belonging to digital input 1:

AT#TRIGGER=I1

OK


SYNC CLOUD ACCOUNT


Send map, users and rules to the SMM Server, overwriting those currently stored. Synchronize the contents of the device uploading all the local information to cloud account in case of misalignment.


Command

AT#SYNC

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

SYNC CLOUD MAP


Send map to the SMM Server, overwriting the current one.


Command

AT#SMAP[=<p1>[,<p2>[,<p3>[,<p4>[,<p5>]]]]]

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<p1>,<p2>,<p3>,<p4>,<p5>

UP TO 5 PARAMETERS IDENTIFIED BY THEIR CODE,

SEPARATE BY COMMA

To update the entire map:

AT#SMAP

OK


To update the average value of the 4 analog inputs:

AT#SMAP=A12,A22,A32,A42

OK

FORCE GEO SYNC


Force geographic position update, retrieved from current information provided by network.


Command

AT#GEO

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

LOCATION INFORMATION UPDATE


Requires updating of parameters G04 (address), G05 (language), G06 (timezone), G07 (offset) based on the current location of the device (Reverse geocoding).

Usage is limited to 5 requests per day.


ComMand

AT#RGEO

REspoNSE

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

BACKUP


Make or update a copy of all the folders in the units D: U: R: 

to the SD card folder S:BACKUP

This command is ignored if it does not come from the console and does not allow redirection.


Command

AT#BACKUP

Response

Backup to SDcard? Y|N

COMMAND ACCEPTED, CONFIRM TO CREATE BACKUP


Backup completed

OPERATION COMPLETED


ERROR

COMMAND REJECTED

RESTORE


Make a copy of the contents of S:BACKUP

to the units  D: U: R: 

restoring a previously saved configuration.

If the unit or folder is not available, FACTORY CONFIGURATION will be restored. This command is ignored if it does not come from the console, asks for confirmation before execution and does not allow redirection.


Command

AT#RESTORE

Response

Restore from SDcard? Y|N

COMMAND ACCEPTED, CONFIRM TO RESTORE


Restore Factory defaults? Y|N

COMMAND ACCEPTED, CONFIRM TO RESTORE DEFAULT


Restore completed

CONFIRMATION ACCEPTED, OPERATION COMPLETED


ERROR

COMMAND REJECTED


If the device does not reboot automatically, perform a manual reboot after the operation is complete.

FIRMWARE UPGRADE


Starts the "over the air" upgrade procedure to the latest available version, downloaded from mobikey.eu

SSID must be set and WiFi data connection is required.

Once the download is completed and verified the unit will restart.


Command

AT#OTA

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PLMN FIRMWARE UPGRADE


Starts the "over the air" upgrade procedure to the latest available version of the optional PLMN module firmware, downloaded from mobikey.eu

APN must be set and cellular data connection is required.

Once the download is completed and verified the unit will restart.


Command

AT+FOTA

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

DEVICE INFO


Returns device information:

model, firmware, date of production, MAC address.


Command

AT#HEADER

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

COM PORT SETTINGS


Set serial communication port (RJ45) parameters.


Command

AT#UART=<baud>,<bits>,<parity>,<stop>

Response

OK

COMMAND ACCEPTED


ERROR

COMMAND REJECTED

PARAMETERS

<baud>

BAUD RATE

1200 2400 4800 9600 19200 38400 57600 115200


<bits>

FRAME BIT NUMBER

5 6 7 8


<parity>

FRAME PARITY

N: NONE

E: EVEN

O: ODD


<stop>

FRAME STOP BITS

1 2


To set baudrate 9600, frame 8 bit, even parity and 1 stop bit:

AT#UART=9600,8,N,1

No answer when command is issued to com port itself.


To retrieve current settings:

AT#UART?

#UART:115200,8,N,1

CHECK INTERNET AVAILABLITY


Verify internet connection is available via WiFi or cellular modem.


Command

AT#CHECKINTERNET

Response

OK

INTERNET  AVAILABLE


KO

INTERNET  NOT AVAILABLE


ERROR

COMMAND REJECTED


Anomalies may occur if this command is given when the only data access is through the cellular network and the connection does not guarantee direct access to the public network.