docs/control/README.md

1 # Fan Control Configuration File
5 - [Overview](#overview)
6 - [Data Format](#data-format)
7 - [System Config Location](#system-config-location)
8 - [Contents](#contents)
9 - [Validation](#validation)
10 - [Firmware Updates](#firmware-updates)
11 - [Loading and Reloading](#loading-and-reloading)
12 - [Debug](#debug)
16 The `phosphor-fan-control` application is comprised of as set of configuration
30 - `manager.json`
31 - `profiles.json`
32 - `fans.json`
33 - `zones.json`
34 - `groups.json`
35 - `events.json`
39 `/usr/share/phosphor-fan-presence/control/`
41 The supported version of the config files are installed under this read-only
48 Where a single set of config files for 1-or-more system types can be used, the
51 i.e.) `/usr/share/phosphor-fan-presence/control/manager.json`
52 `/usr/share/phosphor-fan-presence/control/profiles.json`
53 `/usr/share/phosphor-fan-presence/control/fans.json`
54 `/usr/share/phosphor-fan-presence/control/zones.json`
55 `/usr/share/phosphor-fan-presence/control/groups.json`
56 `/usr/share/phosphor-fan-presence/control/events.json`
64 A system type sub-directory can be obtained from the
65 `Inventory.Decorator.Compatible` D-Bus interface's `Names` property. The
70 - `com.ampere.Hardware.Chassis.Model.MtJade`
71 - `com.ampere.Hardware.Chassis.Model.MtMitchell`
73 The `phosphor-fan-control` application then traverses the supported directory,
74 appending each compatible system type entry as a sub-directory on each config
79 1. `/usr/share/phosphor-fan-presence/control/com.ampere.Hardware.Chassis.Model.MtJade/`
80    - (directory/config file does not exist)
81 2. `/usr/share/phosphor-fan-presence/control/com.ampere.Hardware.Chassis.Model.MtMitchell/events.js…
82    - (config file found)
85 is logged and `phosphor-fan-control` application terminates preventing the
90 `/etc/phosphor-fan-presence/control/`
101 `mkdir -p /etc/phosphor-fan-presence/control`
105 The `phosphor-fan-control` application will search for each config file at the
110    - Default location
111    - Compatible System Type location
119 This file consists of an array of fan objects representing the fan FRUs in the
158 consist of one or more D-Bus object paths and a name.
163      "name": "fan inventory",
181 This file contains the fan control events, where each event can contain groups,
241 <https://github.com/openbmc/phosphor-fan-presence/blob/master/docs/control/fanctl/README.md>
254 fan presence configuration instead of the config file located under the
259 The config files are loaded when the `phosphor-fan-control` application starts.
264 `systemctl kill -s HUP phosphor-fan-control@0.service`
268 `journalctl -u phosphor-fan-control@0.service | grep Loading`
272 Fan control maintains internal data structures that can be be dumped at runtime.