1# rail
2
3## Description
4
5A voltage rail produced by a regulator.
6
7Voltage regulators produce one or more rails. Each rail typically provides a
8different output voltage level, such as 1.1V.
9
10On a PMBus regulator with multiple rails, the current rail is selected using the
11PAGE command. Subsequent PMBus commands are sent to that PAGE/rail.
12
13## Properties
14
15| Name              | Required | Type                                      | Description                                                                                                                                                                                                         |
16| :---------------- | :------: | :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
17| comments          |    no    | array of strings                          | One or more comment lines describing this rail.                                                                                                                                                                     |
18| id                |   yes    | string                                    | Unique ID for this rail. Can only contain letters (A-Z, a-z), numbers (0-9), and underscore (\_).                                                                                                                   |
19| configuration     |    no    | [configuration](configuration.md)         | Specifies configuration changes that should be applied to this rail. These changes usually override hardware default settings. The configuration changes are applied during the boot before regulators are enabled. |
20| sensor_monitoring |    no    | [sensor_monitoring](sensor_monitoring.md) | Specifies how to read the sensors for this rail.                                                                                                                                                                    |
21
22## Example
23
24```json
25{
26  "comments": ["Vdd rail on PAGE 0 of the Vdd/Vio regulator"],
27  "id": "vdd",
28  "configuration": {
29    "volts": 1.1,
30    "rule_id": "set_page0_voltage_rule"
31  },
32  "sensor_monitoring": {
33    "rule_id": "read_ir35221_page0_sensors_rule"
34  }
35}
36```
37