# Configuration Interface

The **Configuration Interface** of the CloudBox allows users to customize and manage all essential system settings. From here, you can adjust general parameters, set date and time, configure the RFID reader, manage network connectivity, and safely shut down the device.

This interface is divided into clear sections, each represented by a card in the UI.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2Fnv4idRlYc9NGP2uO333U%2FConfiguration_Interface_Combined.png?alt=media&#x26;token=4d797281-2a38-4e90-a2b7-356946b50b67" alt=""><figcaption><p>Configuration interface</p></figcaption></figure>

## General

This section lets you set basic operational parameters.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2F3cwBGijrRN0aRlAQdZz3%2FScreenshot%202025-08-21%20at%2023.05.26.png?alt=media&#x26;token=c1abf62a-1f83-445a-a60f-0f48c6348fdd" alt=""><figcaption></figcaption></figure>

**Fields**

* **Bounce Time (seconds)**: Defines the minimum interval between two reads of the same tag to avoid duplicates. Typical values are 5–10 seconds for running events, higher in dense read environments.
* **Disable Buzzer**: Mutes the beeper sound when a passing is detected.
* **Disable Start Button**: Disables the physical start button to prevent accidental session starts.

## Date & Time

This section ensures the CloudBox maintains accurate timing.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2Fa9llF15q88wwe91cM4HT%2FScreenshot%202025-08-21%20at%2023.06.11.png?alt=media&#x26;token=a45e1069-d2e7-4889-bd17-8ff6c625b2ef" alt=""><figcaption></figcaption></figure>

**Fields**

* **Sync Source**: Select how the system clock is maintained (e.g., **NTP,** GPS or Disabled).
* **Set System Date/Time**: If NTP or GPS is not used, you can manually set the date and time.
* **Timezone**: Configure the timezone. Changing the timezone will reboot the device.

## Reader

The **Reader configuration** section is one of the most critical parts of the CloudBox setup. This is where you define how the system connects to and controls your RFID reader — directly impacting read performance, system stability, and overall timing reliability.

With the latest firmware, CloudBox introduces **native LLRP integration**, giving operators significantly more control over reader behavior, especially in professional and multi-antenna race timing environments.

#### Native LLRP Integration

CloudBox now supports **Native LLRP mode**, which provides a more direct and reliable communication layer with compatible readers (such as Zebra and Impinj devices).

Compared to legacy approaches, Native LLRP offers:

* **Improved connection stability**
* **Better control over reader behavior**
* **More predictable performance in high-density environments**
* **Enhanced compatibility with multi-antenna setups**

For most modern deployments, **Native LLRP is the recommended option**.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2FLgkJImrD5OIn8MVYcrLV%2FScreenshot%202026-04-12%20at%2017.01.28.png?alt=media&#x26;token=afa34282-67b7-4fe3-93fc-cdf5f96a7e73" alt=""><figcaption></figcaption></figure>

**Fields**

* **Reader Model**: Select the reader model connected to the CloudBox.
* **Reader Port**: Specify the communication port (default: **5084** for LLRP).
* **LLRP Implementation Mode**
  * **Native (recommended)**\
    Direct integration with the reader for improved performance and reliability.
  * **Legacy (if available)**\
    Maintained for compatibility with older setups.
* **Antenna Ports**\
  Choose which physical ports are active, or allow the reader to manage them automatically.
* **Antenna Mux Time (ms)**\
  Controls how long the reader spends on each antenna before switching.\
  This is especially important in multi-antenna environments where timing precision and coverage must be balanced.
  * Lower values → faster switching, broader coverage
  * Higher values → more stable reads per antenna

## Ethernet (Fixed IP)

This section manages the Ethernet configuration. Ethernet always uses a fixed IP.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2FZqpTzHBQTVIqDnvh0oE9%2FScreenshot%202025-08-21%20at%2023.08.22.png?alt=media&#x26;token=7976adf2-5859-4198-80d8-d2cd5c5ca47e" alt=""><figcaption></figcaption></figure>

**Fields**

* **IP Address**: The fixed IP for accessing the CloudBox over LAN.
* **Port**: Default is **8080**, but this can be customized.
* **Subnet**: Default is `/24`, standard for most networks.
* **Gateway**: Needed only when connecting through a router for internet access.

Changing any of these values reboots the device.

## WiFi

This section covers both Access Point (AP) and client WiFi modes.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2F3UDY7QdpeJIfz7aPT3fJ%2FScreenshot%202025-08-21%20at%2023.09.04.png?alt=media&#x26;token=e0766412-5487-4aef-8352-33f254371e2f" alt=""><figcaption></figcaption></figure>

**WiFi Access Point (AP)**

* **AP Password**: Password for connecting client devices to the CloudBox AP.

**WiFi Client**

* **SSID / Password**: Enter credentials to join the CloudBox to an external WiFi network.
* **Connect / Disconnect WiFi**: Control the connection to the external WiFi.\
  When connected as a client, the CloudBox receives its IP from the external router (DHCP).

## SIM & 4G

This section configures the SIM card used by the 4G modem.

<figure><img src="https://1651595949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpgQL0NScGMC46VblErZq%2Fuploads%2Fw0Fu20QErVZA1W2b9cwk%2FScreenshot%202025-08-21%20at%2023.09.43.png?alt=media&#x26;token=9da0717f-180f-4abe-bb2c-151470a6cb66" alt=""><figcaption></figcaption></figure>

**Fields**

* **SIM PIN**: Enter or remove the SIM PIN if required. Changing this setting reboots the device.

## Quick Reference

A summary of key network and system behaviors:

* Ethernet uses a fixed IP.
* AP clients connect directly to the UI and TCP socket.
* WiFi client mode gets IP via DHCP.
* Gateway is only needed for internet access.
* Some changes (timezone, reader config, IP) trigger a reboot.

## Danger Zone

This section provides the safe shutdown option.

**Shutdown CLBX**: Performs a controlled shutdown of the device to prevent filesystem corruption and protect stored data. Always use this option before powering off the CloudBox manually.

## Summary

The **Configuration Interface** centralizes all system setup for CloudBox. From adjusting Bounce Time and reader settings to configuring network access and powering down safely, this interface ensures that operators have complete control over the device. Proper configuration guarantees stable performance and accurate results during race timing.