Creating a REST Tag

After creating a tag on a REST (CAREL BOSS) device, you need to tell Koios which BOSS variable to read or write. You can configure these fields during creation or afterwards on the tag's Configuration tab.

Protocol Fields

Device Address

The address of the device within the BOSS system. BOSS controllers can manage multiple downstream devices, and this field identifies which one to communicate with.

• Each device in the BOSS system has a unique address
• Example: 1, LOC001

Variable Code

The code that identifies the specific variable (data point) on the BOSS device.

• Each variable on a BOSS device has a unique code
• Example: B0, A15

Variable Type

The data type of the BOSS variable.

Using the BOSS Browser

The BOSS browser connects to the controller and lets you explore its device and variable hierarchy.

1. Open the tag's Configuration tab and click Browse
2. The browser lists all devices registered in the BOSS controller
3. Expand a device to see its available variables
4. Select the variable you want — the Device Address, Variable Code, and Variable Type are auto-populated
5. Click Apply to save the selection

After Configuration

1. Save the tag configuration
2. Test the tag — click

   Test

   to verify Koios can read the variable's value (see Testing a Tag)
3. Enable the tag — flip the enable switch to start collecting data