1# rail
2
3## Description
4
5A voltage rail that is enabled or monitored by the power sequencer device.
6
7The "check_status_vout", "compare_voltage_to_limits", and "gpio" properties
8specify how to obtain the pgood status of the rail. You can specify more than
9one of these properties if necessary.
10
11## Properties
12
13| Name                      |      Required       | Type                    | Description                                                                                                                                                                                                                                                                                                             |
14| :------------------------ | :-----------------: | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
15| name                      |         yes         | string                  | Unique name for the rail. Can only contain letters (A-Z, a-z), numbers (0-9), period (.), and underscore (\_).                                                                                                                                                                                                          |
16| presence                  |         no          | string                  | D-Bus inventory path of a system component which must be present in order for the rail to be present. If this property is not specified, the rail is assumed to always be present.                                                                                                                                      |
17| page                      | see [notes](#notes) | number                  | PMBus PAGE number of the rail.                                                                                                                                                                                                                                                                                          |
18| check_status_vout         |         no          | boolean (true or false) | If true, determine the pgood status of the rail by checking the value of the PMBus STATUS_VOUT command. If one of the error bits is set, the rail pgood will be considered false. The default value of this property is false.                                                                                          |
19| compare_voltage_to_limits |         no          | boolean (true or false) | If true, determine the pgood status of the rail by comparing the output voltage (READ_VOUT) to the undervoltage (VOUT_UV_FAULT_LIMIT) and overvoltage (VOUT_OV_FAULT_LIMIT) limits. If the output voltage is beyond those limits, the rail pgood will be considered false. The default value of this property is false. |
20| gpio                      |         no          | [gpio](gpio.md)         | Determine the pgood status of the rail by reading a GPIO.                                                                                                                                                                                                                                                               |
21
22### Notes
23
24- The "page" property is required if the "check_status_vout" or
25  "compare_voltage_to_limits" property is specified.
26
27## Examples
28
29```
30{
31    "name": "VDD_CPU0",
32    "page": 11,
33    "check_status_vout": true
34}
35```
36
37```
38{
39    "name": "VCS_CPU1",
40    "presence": "/xyz/openbmc_project/inventory/system/chassis/motherboard/cpu1",
41    "gpio": { "line": 60 }
42}
43```
44