1# set_func_on_present
2
3## Description
4Immediately set the fan FRU's contained rotors to functional when the fan's
5presence has been detected and **only** allow the fan FRU to be set to
6functional when presence is detected. Using this configuration option
7essentially latches a nonfunctional fan FRU to nonfunctional until it has been
8replaced (i.e. removed and replugged). It does still allow the functional state
9of the rotors to continue to be updated to reflect their current functional
10state(s). After a fan's presence has been detected, any faults will be
11re-detected for that fan FRU and its contained rotors.
12
13This attribute is optional and defaults to false, meaning a newly inserted fan
14will need to spin up before being set back to functional, and if it never spins
15up, there won't be additional errors.
16
17## Attribute Value(s)
18bool (default = false)
19
20## Example
21<pre><code>
22{
23  "fans": [
24    {
25      "inventory": "/system/chassis/motherboard/fan0",
26      "allowed_out_of_range_time": 30,
27      "functional_delay": 5,
28      "deviation": 15,
29      "num_sensors_nonfunc_for_fan_nonfunc": 1,
30      "monitor_start_delay": 30,
31      "fan_missing_error_delay": 20,
32      "nonfunc_rotor_error_delay": 0,
33      <b><i>"set_func_on_present": true</i></b>,
34      "sensors": [
35        {
36          "name": "fan0_0",
37          "has_target": true
38        },
39        {
40          "name": "fan0_1",
41          "has_target": false,
42          "factor": 1.45,
43          "offset": -909
44        }
45      ]
46    }
47  ]
48}
49</code></pre>
50