Cell Commands

Commands for the Cellular state engine. They are prefixed by "CELL ".

ON [ON/OFF]:

Powers up the device and initialises pins. The second argument specifies whether the device should remain powered on shutdown (from a powered state). If it is not given, the default is OFF.

OFF:

Powers down the device and disconnects pins.

GPSFIX:

Starts up the cell connection when a gps fix is acquired. This needs to be deprecated.

CONNECT [(ON)/OFF]:

Allows the user to stop the cell connecting when it is turned on by selecting off. Default is on.
Note this is a change from the depricated command "CELL CONNECT"

DISCONNECT:

Buggy, and needs to be renamed as CELL DIRECTIVE DISCONNECT.

CONTINUE:

Clears the cell error state. Needs to be deprecated in favour of the generic CELL STATE command.

APN:

Prints the current cell APN

APN AUTO:

Sets the APN to AUTO (Default)

APN SET <APN>:

Sets the apn to the desired value

APN CLEAR:

Clears the current APN setting

USER <username>:

Sets the cell username to username .

PASS <password>:

Sets the cell password to password .

AUDIO <ON>/OFF:

Turn on or off the text audio notifications for cell. No argument prints out current value.

BAUD <n>:

n is a positive integer. This sets the baud rate to switch to during module startup. The startup baud rate is 38,400 and the default to change to is 230,400.

BAND [2gband [3gband]/AUTO]:

Sets the cell band. See the AT refrence guide for more information. AUTO is the default, and the cell engine will "do the right thing" for Telstra vs regular firmware.

OPERATOR [SCAN/AUTO/<n>]:

Sets the cell operator. See the AT refrence guide for more information. AUTO is the default. To set a specific operator set CELL OPERATOR SCAN in the config. Check the logs to find the SCAN output then set the specific operator by setting CELL OPERATOR <n> in the config, where <n> is the number from the output from the SCAN.

SERVICE [2G/3G/LTE/(ALL)]:

Locks the cell modem to the requested service type. No arguments will list the current setting. The default is ALL.

USE_DEFAULT_DNS [YES/NO]:

Determines whether or not the cell is allowed to included the hardcoded default DNS in its fallback list. No arguments lists the current setting. The default is YES. This command will be rejected while the cell engine is running if it has arguments present (i.e. you can list but not change the value while the cell is on).

RESET_ON_TIMEOUT [YES/NO]:

Allows you to choose the behaviour when we timeout waiting for a heartbeat. NO is the default, and gives the existing behaviour. YES means that we skip both trying to escape the connection and checking the socket states to jump straight into a soft reset. No arguments gives you the current setting.

ENABLE_ESCAPE [YES/NO]:

Allows you to change the closure type of the connection. NO is the default, and gives the existing behaviour, with a closure type 0, disconnecting automatically when the remote disconnects. YES means socket dial for the data connection will be performed with closure type 255, which requires manual disconnection using escape characters. No arguments lists the current setting.