docs/designs/multihost-phosphor-buttons.md

1 # Multi-host front panel phosphor buttons interface
15 phosphor-buttons currently only support push type buttons.support for different
16 form factor inputs such as switches/MUX other than push type buttons are needed
38    +----------------------------------------------+
42    |   +--------------+      +--------------+     |
46    |   +--------------+      +--------------+     |
51    +----------------------------------------------+
57 example for a multihost platform yosemite-V2 it has host selector switch mux as
61 +---------------------------+                                      +------------+
63 |       yv2 front panel     |           power/           ---------+|  host 1    |
65 |     +----------------+    |           control          |         +------------+
67 |     |  power button  |-+  |                            |         +------------+
69 |     +----------------+ |  |                            |--------+|  host 2    |
71 |                        |  |                            |         +------------+
72 |                        |  |     +---------------+      |
73 |     +----------------+ |  |     |    host       |      |         +-------------+
74 |     |                | |  |     |  selector     |------+         |             |
75 |     |  reset button  --|--------+   switch      |      |---------+  host 3     |
76 |     |                |    |     +---------------+      |         |             |
77 |     +----------------+    |                            |         +-------------+
79 |                           |                            |          +------------+
81 |     +----------------+    |                            |----------+ host 4     |
82 |     | serial console +---------------------------------|          |            |
83 |     |    mux switch  |    |                            |          +------------+
85 |     +----------------+    |                            |           +-----------+
86 |                           |                            +-----------|   BMC     |
88 +---------------------------+                                        +-----------+
164 - init() - This method may have gpio configuration and event handler
167 - handleEvent() - This method may have custom event handling routines for the
174 button interface monitors these 4 gpio io events as sd-event based event loop
182 1. Position(property) - This is the property which holds the current value of
185 2. MaxPosition(property) - This is the property which keeps the maximum number
194 selection button press and release event via sd-event based loop.
198 1. Released(signal) - This is signal is triggered in the ocp debug card event
219 0 - bmc serial console 1 - host 1 serial console 2 - host 2 serial console 3 -
220 host 3 serial console 4 - host 4 serial console
231 should be modified to adapt corresponding multi host power events and the