Chapter 8: Advanced Driver Metrics 2.0

1 11.1. Introduction
2 11.2. Pre-requisites
3 11.3. Operational Principle
4 11.4. Available Metrics
5 11.5. How is Data Collected
- 5.1 11.5.1. Time series Data
- 5.2 11.5.2. Static Data

Please note that the Organic Response June 2024 release will only enable the nodes to collect data in this firmware release. Although collected by the response node, the information will not currently be accessible to the users. In the future Response API (RESTful API) release, the users can access the data once the relevant endpoints are exposed.

11.1. Introduction

Advanced driver metrics are data sets collected in real-time by compatible smart drivers. Information such as real-time energy monitoring and time of manufacture can serve as a powerful tool in predictive maintenance and improved user experience among other benefits.

Response nodes can read most of the DALI driver’s memory banks (specified in DALI parts 102, 250, 251, 252, and 253) and send it to the Response Portal’s Database.

This feature is only available via Response SN3 nodes with firmware version 191.27 or higher. Therefore, ADM 1.0 through the app will be deprecated for these nodes.

Nodes with lower firmware versions can still obtain ADM data via the Response app, as mentioned in Advanced Driver Metrics.

11.2. Pre-requisites

In order to utilize the data a few pre-requisites need to be met such as,

Compatible PIC firmware version (v191.27 or higher)
Response Portal connected installation
The driver must be from the approved list of drivers with the following DALI parts: 102, 250, 251, 252, and 253.

If the driver doesn’t have one or more of the necessary parts, the metrics that’s associated with said parts will not be available.

No more than 12 devices (in any combination including this device type) are connected to a node.

11.3. Operational Principle

Once the node is powered on, it will detect the attached drivers and begin collecting data. The collected data will be sent to the Portal at 1-hour intervals. The Portal will then process the messages from the node, accounting for the connected drivers.

The Portal will only process the mapped nodes.

At the moment this feature will not include display of these Advanced Driver Metrics in the portal UI.

11.4. Available Metrics

There will be two types of driver metrics that will be collected from the nodes, Static Data and Timeseries Data.

These two types and respective data sets that are collected by the Response nodes are listed below,

Metrics type	Description
Static Data	The static data about the driver will be information that doesn’t change over time. Firmware Version Hardware Version Additional control gear information Luminaire year of manufacture Luminaire week of manufacture Nominal Input Power Power at minimum dim level Nominal Minimum AC mains voltage Nominal Maximum AC mains voltage Nominal light output CRI CCT Light Distribution Type Luminaire color Luminaire identification 101 version number 102 version number of all integrated control gear 103 version number of all integrated control devices Number of logical control device unites in the bus unit Number of logical control gear units in the bus unit Index number of this logical control gear unit Versionofthememorybank201 Guaranteed supply current of integrated DALI bus power supply Maximum supply current of integrated DALI bus power supply Version of the memory bank 202 Version of the memory bank 205 Version of the memory bank 206
Timeseries Data	Time series data is information that changes and updates over time. DALI bus power supply status Active Energy Active Power Control Gear Operating Time Control Gear Start Counter Control Gear External Supply Voltage Control Gear External Supply Voltage Frequency Control Gear Power Factor Control Gear Overall Failure Condition Control Gear Overall Failure Condition Counter Control Gear External Supply Undervoltage Control Gear External Supply Overvoltage Control Gear Output Power Limitation Control Gear Thermal Derating Control Gear Thermal Shutdown Control Gear Thermal Shutdown Counter Control Gear Temperature Control Gear Output Current Percent Light Source Start Counter Light Source On Time Light Source Voltage Light Source Current Light Source Overall Failure Condition Light Source Overall Failure Condition Counter Light Source Short Circuit Light Source Open Circuit Light Source Thermal Derating Light Source Thermal Shutdown Light Source Thermal Shutdown Counter Light Source Temperature

Please refer to the Appendices to a description of all the available Metrics.

11.5. How is Data Collected

The data flow for the two different types of ADM data is as follow.

11.5.1. Time series Data

The nodes query ADM data every hour and send them to the Portal at 1-hour interval. This data will be stored in the Portal Timeseries data base. When you make an API query in the future, the Portal retrieves the ADM data from the Timeseries database and responds with the stored data.

11.5.2. Static Data

The static data is not readily stored in the database. When you initiate an API query, the Portal performs a live query from the node and responds with the ADM data. This data is then stored in the database as well for future queries.

Documentation