docs/control/README.md

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
52 `/usr/share/phosphor-fan-presence/control/manager.json`
53 `/usr/share/phosphor-fan-presence/control/profiles.json`
54 `/usr/share/phosphor-fan-presence/control/fans.json`
55 `/usr/share/phosphor-fan-presence/control/zones.json`
56 `/usr/share/phosphor-fan-presence/control/groups.json`
57 `/usr/share/phosphor-fan-presence/control/events.json`
65 A system type sub-directory can be obtained from the
66 `Inventory.Decorator.Compatible` D-Bus interface's `Names` property. The
71 - `com.ampere.Hardware.Chassis.Model.MtJade`
72 - `com.ampere.Hardware.Chassis.Model.MtMitchell`
74 The `phosphor-fan-control` application then traverses the supported directory,
75 appending each compatible system type entry as a sub-directory on each config
80 1. `/usr/share/phosphor-fan-presence/control/com.ampere.Hardware.Chassis.Model.MtJade/`
81    - (directory/config file does not exist)
82 2. `/usr/share/phosphor-fan-presence/control/com.ampere.Hardware.Chassis.Model.MtMitchell/events.js…
83    - (config file found)
86 is logged and `phosphor-fan-control` application terminates preventing the
91 `/etc/phosphor-fan-presence/control/`
102 `mkdir -p /etc/phosphor-fan-presence/control`
106 The `phosphor-fan-control` application will search for each config file at the
111    - Default location
112    - Compatible System Type location
156 #### groups.json
158 This file defines the groups that events.json will use in its actions. Groups
159 consist of one or more D-Bus object paths and a name.
178 [Syntax](groups.md)
182 This file contains the fan control events, where each event can contain groups,
190       "groups": [
242 <https://github.com/openbmc/phosphor-fan-presence/blob/master/docs/control/fanctl/README.md>
260 The config files are loaded when the `phosphor-fan-control` application starts.
265 `systemctl kill -s HUP phosphor-fan-control@0.service`
269 `journalctl -u phosphor-fan-control@0.service | grep Loading`