docs/control/events.md

57 object in the 'fan inventory' group, update those values in the object cache,
61 property on each D-Bus object in the group, update the new value in the object
65 the Present property on each member of the group and set the fan target hold to
84 The name of a group that must be also be defined in [groups.json](groups.md).
88 The actions and triggers defined with this group will look at this D-Bus
89 interface on the members of this group.
93 The actions and triggers defined with this group will look at this D-Bus
94 property on the members of this group.
116 1. `get_properties` - Read the property configured for the group from every
117    member of the group, and store it in fan control's object cache.
120    group member in fan control's D-Bus service cache map.
125 configured group. After handling the signal, any configured actions are run.
137    D-Bus interface and property specified in the group definition for each group
142    interface specified in the group definition for each group member. When the
147    D-Bus interface specified in the group definition for each group member. When
152    services that host the D-bus interface specified in the group definition for
153    each group member. When the signal occurs, the service owned state will be
156 5. `member` - Subscribes to the signal listed on each group member. No caches
269 property given within a group. The net target increase is based on the maximum
271 group. The final result is the increase change that's requested to the current
274 The group values can be compared to either a value hardcoded in the JSON, or a
294 - For each member of the 'pcie temps' group:
320 - For each member of the 'proc 0 core temps' group:
334 property given within a group. The net target decrease is based on the minimum
335 difference between the `delta` JSON value and all properties in the group. The
339 The group values can be compared to either a value hardcoded in the JSON, or a
359 - For each member of the 'pcie temps' group:
385 - For each member of the 'proc 0 core temps' group:
397 Sets the fans to a configured floor when a number of members within the group
411 The above config reads the configured D-Bus property on each group member
418 Sets the fans to a configured target when a number of members within the group
431 The above config reads the configured D-Bus property on each group member
439 associated to a given group has terminated. Once all services are functional and
447 values within certain ranges, where the key group chooses the set of tables in
448 which to check the remaining group values.
472           "group": "power save",
481 The above config will use the maximum value of the 'ambient temp' group as the
483 will be used when the key group has a max value of less than 25.
495 This action can also have a condition specified where a group property must
499 - "condition_group": The group name
500   - For now, this group must just have a single member.
504 For example, the following says the single member of the 'cpu 0' group must have
527 group is missing. Once all services are functional and providing all the group
545 with the 'fan inventory' group is lost.
566 one or more members in its configured group have a group property value of
598 without a call to run() from a group property value changing. As the PCIeDevice
607 Determines the maximum value from the properties of the group of D-Bus objects
629 property value of all members of the 'fan targets' group.
633 Sets a parameter value based on the maximum group property value. The property
654 from maximum group property value. The mapping is based on a provided table. If
663 The above JSON will cause the action to read the property specified in the group
664 "zone0_ambient" from all members of the group. The change in the group's members
668 group will be mapped to the "map" to get the output "target". Each configured
682 compared against all members within each group to start/stop the timer. When all
683 group members have a given value and it matches what's in the cache, the timer
686 When any group does not have a configured value to be compared against, the
688 providing a group member is not owned, the timer is started and if all members'
708 If its group configuration has a property value listed, like:
719 inventory group has a value of true. Otherwise, the timer will be stopped if
722 If the group configuration has no property value listed, like:
732 Then the timer will be started when any service providing a group member isn't