blob: c9b4a552dd78f98adafbac501dd7e16956ebfbb8 [file] [log] [blame]
Brad Bishop45387d62016-11-10 21:58:58 -06001description: >
2 Implement to provide sensor readings. Objects implementing
3 Sensor.Value must be instantiated in the correct
4 hierarchy within the sensors namespace. The following sensor
5 hierarchies are recognized:
6 temperature
7 fan_tach
8 voltage
9 altitude
Brad Bishop6c4e2e92016-12-28 13:38:31 -050010 current
11 power
12 energy
Adrian Ambrożewiczff697932020-05-11 11:46:50 +020013 utilization
Brad Bishop45387d62016-11-10 21:58:58 -060014
15 Any service implementing Sensor.Value on one or more objects must
16 implement org.freedesktop.DBus.ObjectManager on the sensors namespace root.
17
18 All Sensor.Value properties are read-only.
19
20properties:
21 - name: Value
James Feist4ec65872018-07-31 11:00:25 -070022 type: double
Brad Bishop45387d62016-11-10 21:58:58 -060023 description: >
24 The sensor reading.
James Feist8a3b49d2018-01-22 16:11:43 -080025 - name: MaxValue
James Feist4ec65872018-07-31 11:00:25 -070026 type: double
James Feist8a3b49d2018-01-22 16:11:43 -080027 description: >
28 The Maximum supported sensor reading.
29 - name: MinValue
James Feist4ec65872018-07-31 11:00:25 -070030 type: double
James Feist8a3b49d2018-01-22 16:11:43 -080031 description: >
32 The Minimum supported sensor reading.
Brad Bishop45387d62016-11-10 21:58:58 -060033 - name: Unit
34 type: enum[self.Unit]
35 description: >
Patrick Venture573f1822017-11-08 10:18:18 -080036 The unit of the reading. Immutable once set for a sensor.
Brad Bishop45387d62016-11-10 21:58:58 -060037 For objects in the temperature namespace, Unit must be "DegreesC".
38 For objects in the fan_tach namespace, Unit must be "RPMS".
39 For objects in the voltage namespace, Unit must be "Volts".
40 For objects in the altitude namespace, Unit must be "Meters".
Brad Bishop6c4e2e92016-12-28 13:38:31 -050041 For objects in the current namespace, Unit must be "Amperes".
42 For objects in the power namespace, Unit must be "Watts".
43 For objects in the energy namespace, Unit must be "Joules".
Adrian Ambrożewiczff697932020-05-11 11:46:50 +020044 For objects in the utilization namespace, Unit must be "Percent"
Igor Kononenkof9d1af62020-09-17 13:37:52 +030045 For objects in the airflow namespace, Unit must be "CFM"
Brad Bishop45387d62016-11-10 21:58:58 -060046
47enumerations:
48 - name: Unit
49 description: >
50 A sensor reading unit.
51 values:
52 - name: DegreesC
53 description: >
54 Temperature as degrees Celsius.
55 - name: RPMS
56 description: >
57 Frequency of rotation as revolutions per minute.
58 - name: Volts
59 description: >
60 Electomotive force as volts.
61 - name: Meters
62 description: >
63 Length as meters.
Brad Bishop6c4e2e92016-12-28 13:38:31 -050064 - name: Amperes
65 description: >
66 Electrical charge flow rate as Amperes.
67 - name: Watts
68 description: >
69 Rate of energy transfer as Watts.
70 - name: Joules
71 description: >
72 Energy transfer as Joules.
Adrian Ambrożewiczff697932020-05-11 11:46:50 +020073 - name: Percent
74 description: >
75 Resource utilization as percentage.
Igor Kononenkof9d1af62020-09-17 13:37:52 +030076 - name: CFM
77 description: >
78 To calculate Air Flow in Cubic Feet per Minute