docs/architecture/LED-architecture.md

1 # LED Support for OpenBMC
3 This document describes how to add LED support for your machine based upon the
4 OpenBMC [LED Architecture][led d-bus readme] document. LED group management is
11 Service     xyx.openbmc_project.LED.GroupManager
25 The LED group state can be changed by setting the Asserted value to boolean 0
39 resource. This is for LED Identify operation only.
42 to LED Group D-Bus object, namely:
48 All applicable LED Group D-Bus objects would have an association mapping to
73 mapping to LED Group D-Bus object, namely;
79 All applicable LED Group D-Bus objects would have an association mapping to
90 When LED manager gets PropertyChanged signal, it does the following:
93 - Turn on/off the fault LED group depending on the value of `Functional` `false`
94   would mean turn ON the LED group `true` would mean turn OFF the LED group
101 There are two significant layers for LED operations. The physical and the
102 logical. The LED Group Manager communicates with the physical LED Manager to
104 led.yaml file. LED Group manager consumes this and creates D-Bus/REST interfaces
107 ### Defining the physical LED
109 Physical LED wiring is defined in the `leds` section of the machine's [device
112 _Add a fault LED to the device tree with a corresponding gpio pin..._
140 An LED Group can contain zero or more LEDs and is defined in the machines
151 LED name in `/sys/class/leds`.
155 `/xyz/openbmc_project/led/groups/lamp_test`. Both act on the same physical LED
157 the physical `power` LED if one was created.
178 OpenBMC Architecture requires specific LED Groups to be created and are
183 1. Create a tailored LED manager file
189        SUMMARY = "Phosphor LED Group Management for Romulus"