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 Cinterion® PLS62‑W Wireless Module operating parameters are contained in the configuration file, which you can find here: 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 Updating firmware using AWS IoT jobs – Cinterion® PLS62‑W Wireless Module.

You can deploy the configuration file using either: http or 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: 2048 bytes. If the queue size is exceeded, the oldest messages are dropped.

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:

0 – NV queue is not enabled

1 (default) – NV queue is enabled

  nvqueuetrace Non-volatile (NV) queueing subsystem trace level (0-4), for Support purposes. Leave as 1 (default).
  mode

Operating mode, either:

mqtt

none (default)

  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:

2G – 2G only

LTE – LTE only

any (default) – either 2G or LTE

[application] Application parameters
  fotaport Modem firmware OTA image protocol IP port. Default: 80
  fotaurl

Modem firmware OTA image URL, either: http or https

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: http or https

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: http or https

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: http or https

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:

0 – Do not subscribe to AWS jobs topics

1 (default) – Subscribe to AWS jobs topics

  awsshadow

AWS shadow mode for reporting a set value to the device shadow/twin, either:

simple (default) – Report only the content of the state reported object

complete – Report the complete JSON data

off – Do not report a set value

For more information, see EMQPERSIST – report a set value to the device shadow .

  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 <mqttlwttopic> and <mqttlwtmessage>. Use:

<message> – the MQTT message that is discarded if the client disconnects gracefully

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

1 – the message is sent or delivered to the receiver one or more times

  mqttlwtretain

LWT message retained message flag, either:

0 (default) – message flag not enabled. This is a required setting for AWS only.

1 – message flag enabled

  mqttlwttopic

Last will and testament (LWT) topic path for notifying subscribed clients about an unexpected loss of connection. To enable LWT, you must configure <mqttlwttopic> and <mqttlwtmessage>. Use:

topic – the topic path

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:

topic – the subscribe topic title

  port MQTT IP port. Default: 8883
  singlepubtopic

Predefined topic for single-publish systems. The <topicsuffix> is not added as a suffix to the singlepubtopic name, however you can use a token instead.

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

1 – the message is sent or delivered to the receiver one or more times

  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

1 – the message is sent or delivered to the receiver one or more times

  topicsuffix

Appends a topic path to the end of the requested topic to uniquely identify the thing on the broker.

thingname (default) – the cloud thingName

imei – the unique IMEI number for the device

none – the exact topic is used, with no suffix appended

If topicsuffix is not present in the configuration file, then thingname is appended on the requested topic.

  tracelevel MQTT trace level (0-4), for Support purposes. Leave as 1 (default).
  urcautoformat

For formatting URCs, either:

0 – sends all URCs as ASCII-hex within quotes

For example: '{"key1":"val1"}' will appear in a URC as '+EMQ:<id>,15\r\n"7B226B657931223A2276616C31227D"'

1 (default) – this option enables sending URCs as either ASCII-hex or text, depending on the received payload.

  • If the received payload is printable text (including JSON), then the URC data is sent as text.

    For example:

    '{"key1":"val1"}' will appear in a URC as '+EMQ:<id>,15\r\n{"key1":"val1"}'

    For JSON, the maximum payload is 1012 characters. Escaped quotes count as 1 character: \"

  • If the received payload is binary data, then the URC data is sent as ASCII hex.

[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:

0 – SMS handling disabled

1 (default) – SMS handling enabled

  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:

0 (default) – location disabled

1 – location enabled; Cinterion® PLS62‑W Wireless Module will always try to establish a GPS/GNSS location while running

  tracelevel Location trace level (0-4), for Support purposes. Leave as 1 (default).