> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/modules/cinterion-r-pls62-w-wireless-module/using-the-cinterion-pls62-w-wireless-module-configuration-file.md).

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

* Operational
* Network
* Application
* Host
* Config
* MQTT
* UDP
* SMS
* Location

{% hint style="info" %}
If this file does not exist, AnyNet SMARTconnect™ uses internal default configuration parameters.
{% endhint %}

{% hint style="info" %}
To update the configuration file over the air, see [Updating firmware using AWS IoT jobs – Cinterion® PLS62‑W Wireless Module](https://docs.eseye.com/modules/cinterion-r-pls62-w-wireless-module/updating-firmware-using-aws-iot-jobs-cinterion-pls62-w-wireless-module.md).
{% endhint %}

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                       | <p>Maximum size (in bytes) of the NV data TX queue. Default: <code>2048</code> bytes. If the queue size is exceeded, the oldest messages are dropped.</p><p><strong>Note:</strong> The default size is intended for devices sending small message payloads. Increase this amount if you are using devices that send large message payloads.</p><p>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.</p>                                                                                                                                                                                                                             |
|                | nvqueue\_enable                      | <p>The non-volatile memory NV queue is enabled by default to prevent message loss during a power-cycle or reboot. Use:</p><p><code>0</code> – NV queue is not enabled</p><p><code>1</code> (default) – NV queue is enabled</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                | nvqueuetrace                         | Non-volatile (NV) queueing subsystem trace level (0-4), for Support purposes. Leave as `1` (default).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|                | mode                                 | <p>Operating mode, either:</p><p><code>mqtt</code></p><p><code>none</code> (default)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|                | 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                                 | <p>Preferred technology for connecting to the cellular network, either:</p><p><code>2G</code> – 2G only</p><p><code>LTE</code> – LTE only</p><p><code>any</code> (default) – either 2G or LTE</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| \[application] | Application parameters               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | fotaport                             | Modem firmware OTA image protocol IP port. Default: `80`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|                | fotaurl                              | <p>Modem firmware OTA image URL, either: <code>http</code> or <code>https</code></p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|                | updateport                           | Application firmware update protocol IP port. Default: `80`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                | updateurl                            | <p>Application firmware update URL, either: <code>http</code> or <code>https</code></p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| \[host]        | Host parameters                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | updateport                           | Host firmware update protocol IP port. Default: `80`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                | updateurl                            | <p>Host firmware update URL, either: <code>http</code> or <code>https</code></p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| \[config]      | Configuration file update parameters |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | updateport                           | Configuration file update protocol IP port. Default: `80`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|                | updateurl                            | <p>Configuration file update URL, either: <code>http</code> or <code>https</code></p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| \[mqtt]        | MQTT parameters                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | awsjobs                              | <p>AWS jobs topics subscription and for processing jobs instructions, either:</p><p><code>0</code> – Do not subscribe to AWS jobs topics</p><p><code>1</code> (default) – Subscribe to AWS jobs topics</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|                | awsshadow                            | <p>AWS shadow mode for reporting a set value to the device shadow/twin, either:</p><p><code>simple</code> (default) – Report only the content of the state reported object</p><p><code>complete</code> – Report the complete JSON data</p><p><code>off</code> – Do not report a set value</p><p>For more information, see <a href="https://docs.eseye.com/modules/cinterion-r-pls62-w-wireless-module/mqtt-at-commands/emqpersist-report-a-set-value-to-the-device-shadow.md">EMQPERSIST – report a set value to the device shadow</a> .</p>                                                                                                                                                                                                                                                                                                 |
|                | clientid                             | <p>MQTT client ID. This parameter is ignored when AnyNet SMARTconnect™ connects to Google IoT.</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                | keepalive                            | Maximum expected time (in seconds) between received keepalives before AnyNet SMARTconnect™ assumes the MQTT connection is down. Default: `1200`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | mqttlwtmessage                       | <p>LWT message for notifying subscribed clients about an unexpected loss of connection. To enable LWT, you must configure <code>\<mqttlwttopic></code> and <code>\<mqttlwtmessage></code>. Use:</p><p><code>\<message></code> – the MQTT message that is discarded if the client disconnects gracefully</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                | mqttlwtqos                           | <p>Last will and testament (LWT) message QoS, defining the guarantee of message delivery. Either:</p><p><code>0</code> (default) – at most once, no guarantee of message receipt</p><p><code>1</code> – the message is sent or delivered to the receiver one or more times</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                | mqttlwtretain                        | <p>LWT message retained message flag, either:</p><p><code>0</code> (default) – message flag not enabled. This is a required setting for AWS only.</p><p><code>1</code> – message flag enabled</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                | mqttlwttopic                         | <p>Last will and testament (LWT) topic path for notifying subscribed clients about an unexpected loss of connection. To enable LWT, you must configure <code>\<mqttlwttopic></code> and <code>\<mqttlwtmessage></code>. Use:</p><p><code>topic</code> – the topic path</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|                | mqttsettingstopic                    | <p>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:</p><p><code>topic</code> – the subscribe topic title</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | port                                 | MQTT IP port. Default: `8883`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|                | singlepubtopic                       | <p>Predefined topic for single-publish systems. The <<code>topicsuffix</code>> is not added as a suffix to the singlepubtopic name, however you can use a token instead.</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|                | singlepubtopicqos                    | <p>QoS for single publish, defining the guarantee of message delivery. Either:</p><p><code>0</code> (default) – at most once, no guarantee of message receipt</p><p><code>1</code> – the message is sent or delivered to the receiver one or more times</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                | singlesubtopic                       | <p>Predefined topic for single subscription systems.</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                | singlesubtopicqos                    | <p>Quality of Service (QoS) for single subscription, defining the guarantee of message delivery. Either:</p><p><code>0</code> (default) – at most once, no guarantee of message receipt</p><p><code>1</code> – the message is sent or delivered to the receiver one or more times</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|                | topicsuffix                          | <p>Appends a topic path to the end of the requested topic to uniquely identify the thing on the broker.</p><p><code>thingname</code> (default) – the cloud thingName</p><p><code>imei</code> – the unique IMEI number for the device</p><p><code>none</code> – the exact topic is used, with no suffix appended</p><p><strong>Note:</strong> If <code>topicsuffix</code> is not present in the configuration file, then <code>thingname</code> is appended on the requested topic.</p>                                                                                                                                                                                                                                                                                                                                                       |
|                | tracelevel                           | MQTT trace level (0-4), for Support purposes. Leave as `1` (default).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|                | urcautoformat                        | <p>For formatting URCs, either:</p><p><code>0</code> – sends all URCs as ASCII-hex within quotes</p><p>For example: <code>'{"key1":"val1"}'</code> will appear in a URC as <code>'+EMQ:\<id>,15\r\n"7B226B657931223A2276616C31227D"'</code></p><p><code>1</code> (default) – this option enables sending URCs as either ASCII-hex or text, depending on the received payload.</p><ul><li><p>If the received payload is printable text (including JSON), then the URC data is sent as text.</p><p>For example:</p><p><code>'{"key1":"val1"}'</code> will appear in a URC as <code>'+EMQ:\<id>,15\r\n{"key1":"val1"}'</code></p><p>For JSON, the maximum payload is 1012 characters. Escaped quotes count as 1 character: <code>"</code></p></li><li>If the received payload is binary data, then the URC data is sent as ASCII hex.</li></ul> |
| \[udp]         |                                      | UDP parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                | port                                 | UDP IP port. Default: 12401                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                | url                                  | <p>UDP IP address</p><p><strong>Note:</strong> If this parameter is not set, it is not included in the configuration file.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| \[sms]         |                                      | SMS parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                | enable                               | <p>For configuring SMS handling, either:</p><p><code>0</code> – SMS handling disabled</p><p><code>1</code> (default) – SMS handling enabled</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                | 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                               | <p>For configuring location, either:</p><p><code>0</code> (default) – location disabled</p><p><code>1</code> – location enabled; Cinterion® PLS62‑W Wireless Module will always try to establish a GPS/GNSS location while running</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|                | tracelevel                           | Location trace level (0-4), for Support purposes. Leave as `1` (default).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eseye.com/modules/cinterion-r-pls62-w-wireless-module/using-the-cinterion-pls62-w-wireless-module-configuration-file.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
