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.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
- Navigate to Data Sources in your building
- Click API Catalog and search for Legrand Encelium
- Click + Add Datasource
- Fill in the fields below and complete the three-page setup flow
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.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
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 devicesSchedule Sync
Schedule state synchronization data between KODE OS and the external system’s controller schedulesPolling Schedule
- Point History — Default polling: 60 minutes (min: 60 minutes, max: 60 minutes)
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.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
WebSocket connection failed
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.
Discovery returns no devices
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.
Data collection stops or gaps appear
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.