Connect SmartCore to KODE OS for lighting, other data integration
Overview
Use this integration to connect SmartCore to KODE OS. You can discover devices over gRPC, collect lighting, occupancy, and door-status data with hybrid snapshot collection, and surface shared-space and meeting-room conditions in Data Sources.Supported Capabilities
- Discover Devices & Points
- Collect Sensor Data
- Write to Points (lighting levels, transitions)
Prerequisites
- SmartCore (Vanti) gRPC server accessible from the KODE OS network
- The IP address and port of the on-site SmartCore controller
- 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 SmartCore
- 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 SmartCore system and return a list of available devices and their data points. SmartCore devices are discovered with trait-based point definitions. Each device exposes points based on the traits it supports (e.g., a lighting fixture exposesLightApi and BrightnessSensorApi traits).
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
SmartCore devices are organized by traits — each trait defines a set of related data points with specific behaviors. All points are collected at 1-minute intervals.BrightnessSensorApi
Reports measured ambient brightness for a space.LightApi
Controls light output. Brightness is normalized to 0-100%. See device specifications for supported step values.OpenCloseApi
For devices that can open and close, such as window contacts, blinds, and garage doors.LockUnlockApi
For devices that can be locked or unlocked. Position may be in a steady state or transitioning.StatusApi
Reports the working status of a device. Reflects the most severe level from any active problems.What Data You Get
Point History
Time-series readings including brightness levels, lighting output percentages, door/window open positions, lock states, device health status, and transition progress, collected every 1 minute from connected SmartCore devices.Polling Schedule
- Point History — Default polling: 1 minute (min: 1 minute, max: 1 hour)
Use Cases
Once connected, this integration enables you to:- Control and monitor lighting levels across shared spaces and meeting rooms with personalized lux settings
- Detect lighting fixture failures automatically and receive maintenance alerts before occupants are affected
- Monitor door and window status (open/closed, locked/unlocked) from a central security dashboard
- Receive fire door tampering notifications for building safety compliance
- Track device health status to proactively schedule maintenance for degraded fixtures
Troubleshooting
Cannot connect to controller
Cannot connect to controller
Verify the host and port are correct. Ensure the SmartCore gRPC server is running and reachable from the KODE OS network. Check that firewalls allow TCP connections on the configured port.
Discovery returns no devices
Discovery returns no devices
Verify the SmartCore system has devices registered and that the gRPC server is responding. Run a test connection first to confirm connectivity. Ensure the controller has completed its own device commissioning process.
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 network interruptions or the SmartCore controller being restarted.