> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/services/reader-management-system/documentation/android-installation-and-operation-manual/user-instructions.md).

# User Instructions

## Connect to an Android Device

### USB Cable <a href="#id-4.1.1_usb_cable" id="id-4.1.1_usb_cable"></a>

To connect to a device via USB, plug the device into a compatible Android device.

1. Select the Device Type.&#x20;
2. Select the Interface Type.
3. The Refresh button will refresh the list of available devices.
4. Tap on the Device Name to connect.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2Ff1RAbj20CwxWuJGnV0PZ%2Fimage.png?alt=media&amp;token=bea5092c-dec2-4acc-9997-e16f303da50c" alt=""><figcaption></figcaption></figure>

Press OK to allow RMS to access the device.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FD7it1O82juB03SMte6Ki%2Fimage.png?alt=media&amp;token=52b53714-4e9a-4a61-a87b-221da873907b" alt=""><figcaption></figcaption></figure>

### Bluetooth LE <a href="#id-4.1.2_bluetooth_le" id="id-4.1.2_bluetooth_le"></a>

To connect to a device via Bluetooth LE, open the Android app and follow the steps below. It is important to note that Bluetooth pairing will be done through the RMS app, not through Android device settings.

1. Select the Device Type
2. Select the Interface Type
3. Press the Refresh button if the device does not appear.
4. Tap on the Device Name below.
5. When connecting to a device via Bluetooth LE for the first time, a prompt will appear and require the user to enter the PIN. Default is 000000,

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FmYrhC7VXIRN9MVVq20Vh%2Fimage.png?alt=media&amp;token=93dc04e1-0c66-4e54-9d74-3d30260f4979" alt=""><figcaption></figcaption></figure>

![](https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FaLM1J7qV5Mg4zI4nEYMa%2Fimage.png?alt=media\&token=5cfd6719-f5ae-4f83-8540-b5fa0740aee0)<br>

### WebSocket <a href="#id-4.1.3_websocket" id="id-4.1.3_websocket"></a>

To connect to a device via WebSocket (WLAN), follow the instructions in the device’s installation and operation manual.

* Select the Device Type

{% hint style="info" %}
**Note**: Only DynaFlex Products Support WLAN currently.
{% endhint %}

* Select WebSocket.
* Enter the device IP address in the prompt. If connecting by TLS start the address with “wss\://”. If connecting by mTLS start the address with “ws\://”, press File to load the certificate from a file

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FZ5ThjuIX3xlriYObC3y9%2Fimage.png?alt=media&amp;token=712607d1-a9ea-4170-a98d-5babca1f7d5a" alt=""><figcaption></figcaption></figure>

## Update Firmware and EMV Tags/CAPKS <a href="#id-4.2_update_firmware_and_emv_tags-capks" id="id-4.2_update_firmware_and_emv_tags-capks"></a>

To update device Firmware and EMV Tags/CAPKS, check the desired item to update and press the Update button. Only the updates that are selected will be loaded to the device. A prompt will appear asking the user it they would like to update Main firmware, press YES .

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F4hJj1lFM8ZTWRyHSbD06%2Fimage.png?alt=media&amp;token=00a863f8-b816-45d4-8f73-75cbda14cf03" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FH5K0Z9esTMpDlLlhJaGY%2Fimage.png?alt=media&amp;token=8a96abb7-5305-4bd2-b5f3-aead213aac39" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**: The Force Update option will update both Firmware and EMV Tags/CAPKs regardless of their current versions. DynaFlex devices do not support forcing Firmware update. Firmware option becomes unchecked and disabled, it is available MagneSafe devices only
{% endhint %}

### Updates Successful

The log will indicate:

* If current configurations are up to date,
* If updates have succeeded
* If updates have failed

### Configurations <a href="#id-4.3_configurations" id="id-4.3_configurations"></a>

To update or change your device’s configurations:

* Tap on desired configuration to select.
* Press the Update button to load the update.&#x20;
* Press Clear Log to clear the log if needed.
* Press Refresh to refresh the list of available configurations if none appear.

The log will indicate if the configuration update is successful or if it has failed.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2FxvLw99HtUPcLEFBDYzd6%2Fimage.png?alt=media&amp;token=0e4f83b1-4d88-4709-b3d3-dd209b9ca024" alt=""><figcaption></figcaption></figure>

## Commands <a href="#id-4.4_commands" id="id-4.4_commands"></a>

To send a command to the device and receive a response:

* Enter a command in the Command Field and press Send.

<figure><img src="https://3532725339-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT525JoRd5ZFOd0Mq9DrF%2Fuploads%2F29nlkEozvexj1Gd6f7kQ%2Fimage.png?alt=media&amp;token=213ccd90-cfc3-4ee7-98b7-255916c8dd2b" alt=""><figcaption></figcaption></figure>

In this example, the command entered was successfully sent and a response returned. This command turns on the device’s Bar Code Reader LED. The log indicates it was sent successfully, the response command matched the programmer’s manual and the LED illuminated. Refer to your device’s particular


---

# 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://developer.magtek.com/services/reader-management-system/documentation/android-installation-and-operation-manual/user-instructions.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.
