Using the Cinterion® PLS62‑W Wireless Module configuration file
Eseye-enabled module operating parameters are contained in a module-specific configuration file.
The Eseye-enabled a:/config.ini
You can use the configuration file to set the following parameters:
If this file does not exist, AnyNet SMARTconnect™ uses internal default configuration parameters.
To update the configuration file over the air, see
You can deploy the configuration file using either: http
https
.
You can trigger an update using MQTT.
The .ini file is divided into sections, denoted by square brackets. Each section has parameters listed underneath it.
Section | Parameter | Definition |
---|---|---|
[operation] | Operational parameters | |
apptrace | Application trace level (0-4), for Support purposes. Leave as 1 (default). |
|
attrace | AT command trace level (0-4), for Support purposes. Leave as 1 (default). |
|
nvqueuemaxsize |
Maximum size (in bytes) of the NV data TX queue. Default: The default size is intended for devices sending small message payloads. Increase this amount if you are using devices that send large message payloads. For large messages, you must ensure that the maximum NV store size is at least four times the largest expected published message size, plus eight bytes for the storage header. For example, for 1000 byte messages, set a minimum nvqueuemaxsize of 4032. |
|
nvqueue_enable |
The non-volatile memory NV queue is enabled by default to prevent message loss during a power-cycle or reboot. Use:
|
|
nvqueuetrace | Non-volatile (NV) queueing subsystem trace level (0-4), for Support purposes. Leave as 1 (default). |
|
mode |
Operating mode, either: mqtt
|
|
teletrace | Data connection subsystem trace level (0-4), for Support purposes. Leave as 1 (default). |
|
[network] | Network parameters | |
apn | Access Point Name | |
apnuser | APN user name | |
apnpass | APN password | |
tech |
Preferred technology for connecting to the cellular network, either:
|
|
[application] | Application parameters | |
fotaport | Modem firmware OTA image protocol IP port. Default: 80 |
|
fotaurl |
Modem firmware OTA image URL, either: If this parameter is not set, it is not included in the configuration file. |
|
updateport | Application firmware update protocol IP port. Default: 80 |
|
updateurl |
Application firmware update URL, either: If this parameter is not set, it is not included in the configuration file. |
|
[host] | Host parameters | |
updateport | Host firmware update protocol IP port. Default: 80 |
|
updateurl |
Host firmware update URL, either: If this parameter is not set, it is not included in the configuration file. |
|
[config] | Configuration file update parameters | |
updateport | Configuration file update protocol IP port. Default: 80 |
|
updateurl |
Configuration file update URL, either: If this parameter is not set, it is not included in the configuration file. |
|
[mqtt] | MQTT parameters | |
awsjobs |
AWS jobs topics subscription and for processing jobs instructions, either:
|
|
awsshadow |
AWS shadow mode for reporting a set value to the device shadow/twin, either:
For more information, see
|
|
clientid |
MQTT client ID. This parameter is ignored when AnyNet SMARTconnect™ connects to Google IoT. If this parameter is not set, it is not included in the configuration file. |
|
keepalive | Maximum expected time (in seconds) between received keepalives before AnyNet SMARTconnect™ assumes the MQTT connection is down. Default: 1200 |
|
mqttlwtmessage |
LWT message for notifying subscribed clients about an unexpected loss of connection. To enable LWT, you must configure
If this parameter is not set, it is not included in the configuration file. |
|
mqttlwtqos |
Last will and testament (LWT) message QoS, defining the guarantee of message delivery. Either: 0 (default) – at most once, no guarantee of message receipt
|
|
mqttlwtretain |
LWT message retained message flag, either:
|
|
mqttlwttopic |
Last will and testament (LWT) topic path for notifying subscribed clients about an unexpected loss of connection. To enable LWT, you must configure
If this parameter is not set, it is not included in the configuration file. |
|
mqttsettingstopic |
Alternative to the AWS IoT shadow for configuring AnyNet SMARTconnect™ behaviour. Subscription to this single topic enables commands to be sent from the cloud broker to AnyNet SMARTconnect™ via MQTT. Use either:
|
|
port | MQTT IP port. Default: 8883 |
|
singlepubtopic |
Predefined topic for single-publish systems. The < If this parameter is not set, it is not included in the configuration file. |
|
singlepubtopicqos |
QoS for single publish, defining the guarantee of message delivery. Either: 0 (default) – at most once, no guarantee of message receipt
|
|
singlesubtopic |
Predefined topic for single subscription systems. If this parameter is not set, it is not included in the configuration file. |
|
singlesubtopicqos |
Quality of Service (QoS) for single subscription, defining the guarantee of message delivery. Either: 0 (default) – at most once, no guarantee of message receipt
|
|
topicsuffix |
Appends a topic path to the end of the requested topic to uniquely identify the thing on the broker.
If |
|
tracelevel | MQTT trace level (0-4), for Support purposes. Leave as 1 (default). |
|
urcautoformat |
For formatting URCs, either:
For example:
|
|
[udp] | UDP parameters | |
port | UDP IP port. Default: 12401 | |
url |
UDP IP address If this parameter is not set, it is not included in the configuration file. |
|
[sms] | SMS parameters | |
enable |
For configuring SMS handling, either:
|
|
tracelevel | SMS trace level (0-4), for Support purposes. Leave as 1 (default). |
|
whitelist | Comma-separated list of one or more MSISDN values from which SMS is accepted. For example: 447624499970,447624499971 |
|
[location] | Location parameters | |
enable |
For configuring location, either:
|
|
tracelevel | Location trace level (0-4), for Support purposes. Leave as 1 (default). |