> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Legrand Encelium

> Connect Legrand Encelium to KODE OS for lighting data

> Connect Legrand Encelium to KODE OS for lighting data integration

## Overview

Use this integration to connect Legrand Encelium to KODE OS. You can stream lighting data over WebSocket with delta collection, use supported schedules, and keep Encelium points visible in your building Data Sources.

| Property            | Value     |
| ------------------- | --------- |
| **System Type**     | Lighting  |
| **Communication**   | WebSocket |
| **Collection**      | Pull      |
| **Collection Mode** | DELTA     |
| **Schedules**       | Supported |

## Supported Capabilities

* Discover Devices & Points
* Collect Sensor Data
* Receive Webhook Data
* Discover Schedules
* Update Schedules
* WebSocket Connection

## Prerequisites

* Access credentials for the Legrand Encelium system
* KODE OS environment with access to Data Sources

## Configure Connector in KODE OS

1. Navigate to **Data Sources** in your building
2. Click **API Catalog** and search for **Legrand Encelium**
3. Click **+ Add Datasource**
4. Fill in the fields below and complete the three-page setup flow

| Field         | Required | Type     | Description                                              |
| ------------- | -------- | -------- | -------------------------------------------------------- |
| **URL**       | Yes      | text     | The base URL or IP address of the external system        |
| **Username**  | Yes      | text     | The username for authenticating with the external system |
| **Password**  | Yes      | password | The password for authenticating with the external system |
| **System ID** | Yes      | text     | The system identifier in the external platform           |

## Discover Devices and Points

After configuring the connector, click **Discover** on the connector detail page. KODE OS will query the Legrand Encelium system and return a list of available devices and their data points.

Review the discovered items and select the devices you want to register in KODE OS.

For more details on the discovery process, see the [Discovery guide](/products/integrations/capabilities/discovery).

## Devices and Points

When you discover devices from Legrand Encelium, KODE OS maps them to the following device types and data points:

### Presence / Occupancy Sensor

Canonical Type: `presenceDetection`

| #  | Point                                    | Description                                      | Unit  | Writable | Collection |
| -- | ---------------------------------------- | ------------------------------------------------ | ----- | -------- | ---------- |
| 1  | `occupancyState`                         | Current occupancy state of the zone              | --    | No       | Polling    |
| 2  | `scene`                                  | Currently active lighting scene                  | --    | Yes      | Polling    |
| 3  | `savingsReport_calculatedPowerInW`       | Calculated lighting power consumption (W)        | watts | No       | Polling    |
| 4  | `savingsReport_maximumPowerInW`          | Maximum possible power at full brightness (W)    | watts | No       | Polling    |
| 5  | `savingsReport_measuredEnergyInWh`       | Measured energy consumption (W)                  | watts | No       | Polling    |
| 6  | `savingsReport_measuredPowerInW`         | Measured actual power consumption (W)            | watts | No       | Polling    |
| 7  | `savingsReport_savingByLoadSheddingInW`  | Energy savings from automatic load shedding (W)  | watts | No       | Polling    |
| 8  | `savingsReport_savingByManualControlInW` | Energy savings from manual dimming/switching (W) | watts | No       | Polling    |
| 9  | `savingsReport_savingByTimeScheduleInW`  | Energy savings from time-based scheduling (W)    | watts | No       | Polling    |
| 10 | `savingsReport_totalSavingsInW`          | Total energy savings across all strategies (W)   | watts | No       | Polling    |
| 11 | `luxMinimum`                             | Minimum lux threshold setting                    | --    | No       | Polling    |
| 12 | `luxMaximum`                             | Maximum lux threshold setting                    | --    | No       | Polling    |
| 13 | `controlStatus`                          | Current control mode of the fixture/zone         | --    | Yes      | Polling    |
| 14 | `brightness`                             | Lighting brightness level                        | --    | Yes      | Polling    |
| 15 | `colorTemperature`                       | Current temperature reading                      | --    | No       | Polling    |
| 16 | `daylight`                               | Daylight sensor reading                          | --    | No       | Polling    |
| 17 | `batteryVoltage_mV`                      | Battery voltage reading                          | --    | No       | Polling    |
| 18 | `connectionStatus`                       | Device connectivity status                       | --    | No       | Polling    |

## What Data You Get

### Point History

Time-series readings including occupancyState, scene, savingsReport\_calculatedPowerInW, savingsReport\_maximumPowerInW, savingsReport\_measuredEnergyInWh, savingsReport\_measuredPowerInW, savingsReport\_savingByLoadSheddingInW, savingsReport\_savingByManualControlInW, and 10 more, collected at regular intervals from connected devices

### Schedule Sync

Schedule state synchronization data between KODE OS and the external system's controller schedules

### Polling Schedule

* **Point History** -- Default polling: 60 minutes (min: 60 minutes, max: 60 minutes)

For more details on collection modes, see the [Data Collection guide](/products/integrations/capabilities/data-collection).

## Schedule Management

This integration supports discovering and managing schedules in the Legrand Encelium system. You can discover existing schedules, create new ones, and sync schedule states between KODE OS and the external system.

For more details, see the [Schedules guide](/products/integrations/capabilities/schedules).

## Use Cases

Once connected, this integration enables you to:

* Monitor lighting system status, energy usage, and occupancy-driven behavior
* Coordinate lighting schedules with HVAC and building automation systems
* Track lighting energy consumption and identify optimization opportunities

## Troubleshooting

<AccordionGroup>
  <Accordion title="WebSocket connection failed">
    Verify the URL and credentials are correct. Check that the Legrand Encelium system allows WebSocket connections and that network firewalls are not blocking the connection.
  </Accordion>

  <Accordion title="Discovery returns no devices">
    Verify the connector credentials have sufficient permissions in the Legrand Encelium system to list devices. Run a test connection first to confirm connectivity. Some systems require specific API scopes or roles for device enumeration.
  </Accordion>

  <Accordion title="Data collection stops or gaps appear">
    Check the connector status on the Data Sources page. If the status shows an error, review the error logs on the connector detail page. Common causes include expired credentials, network changes, or rate limiting by the Legrand Encelium API.
  </Accordion>
</AccordionGroup>