The missing patch is in the attachment.
--- sensors.conf.5 2024-02-26 21:31:49.000000000 +0000 +++ sensors.conf.5.new 2024-02-27 23:23:36.000000000 +0000 @@ -34,8 +34,8 @@ translate the raw readings from the kern On a given system, there may be one or more hardware monitoring chips. Each chip may have several features. For example, the LM78 monitors 7 voltage inputs, 3 fans and one temperature. Feature names are -standardized. Typical feature names are in0, in1, in2... for voltage -inputs, fan1, fan2, fan3... for fans and temp1, temp2, temp3... for +standardized. Typical feature names are in0, in1, in2...\& for voltage +inputs, fan1, fan2, fan3...\& for fans and temp1, temp2, temp3...\& for temperature inputs. Each feature may in turn have one or more sub\-features, each @@ -79,14 +79,15 @@ configuration lines are examined for it, A chip description is built from several elements, separated by dashes. The first element is the chip type, the second element is the name of the bus, and the third element is the hexadecimal address -of the chip. Such chip descriptions are printed by sensors(1) as the -first line for every chip. +of the chip. Such chip descriptions are printed by +.BR sensors (1) +as the first line for every chip. The name of the bus is either .IR isa , .IR pci , .IR virtual , -.I spi-*, +.IR spi-* , .I i2c-N or .I mdio @@ -143,7 +144,7 @@ feature names. Same applies to all other An .I ignore -statement is a hint that a specific feature should be ignored - probably +statement is a hint that a specific feature should be ignored \(en probably because it returns bogus values (for example, because a fan or temperature sensor is not connected). Example: @@ -224,7 +225,7 @@ set in3_max 5 * 1.05 .RE The example above basically configures the chip to allow a 5% deviance -for the +5V power input. +for the +5 volt power input. The first argument is the feature name. The second argument is an expression which determines the written value. If there is an applying @@ -237,7 +238,9 @@ are substituted. You should be careful t Please note that .I set -statements are only executed by sensors(1) when you use the +statements are only executed by +.BR sensors (1) +when you use the .B \-s option. Typical graphical sensors applications do not care about these statements at all. @@ -276,7 +279,7 @@ all statements together at the top of your configuration file. Running -.B sensors --bus-list +.B sensors \-\-bus\-list will generate these lines for you. In the case where multiple configuration files are used, the scope @@ -296,12 +299,12 @@ the statements in this order to avoid ac .SH VOLTAGE COMPUTATION DETAILS -Most voltage sensors in sensor chips have a range of 0 to 4.08 V. -This is generally sufficient for the +3.3V and CPU supply voltages, so +Most voltage sensors in sensor chips have a range of 0 to 4.08 volt. +This is generally sufficient for the +3.3 volt and CPU supply voltages, so the sensor chip reading is the actual voltage. Other supply voltages must be scaled with an external resistor network. -The driver reports the value at the chip's pin (0 \- 4.08 V), and the +The driver reports the value at the chip's pin (0 to 4.08 volt), and the userspace application must convert this raw value to an actual voltage. The .I compute @@ -311,39 +314,59 @@ Unfortunately the resistor values vary a Therefore you have to figure out the correct resistor values for your own motherboard. -For positive voltages (typically +5V and +12V), two resistors are used, +For positive voltages (typically +5 and +12 volt), two resistors are used, with the following formula: - R1 = R2 * (Vs/Vin \- 1) +.in +8n +R1 = R2 * (Vs/Vin \- 1) +.in where: - R1 and R2 are the resistor values - Vs is the actual voltage being monitored - Vin is the voltage at the pin +.in +8n +.nf +R1 and R2 are the resistor values +Vs is the actual voltage being monitored +Vin is the voltage at the pin +.fi +.in This leads to the following compute formula: - compute inX @*((R1/R2)+1), @/(((R1/R2)+1) +.in +8n +compute inX @*((R1/R2)+1), @/(((R1/R2)+1) +.in -Real\-world formula for +5V and +12V would look like: - compute in3 @*((6.8/10)+1), @/((6.8/10)+1) - compute in4 @*((28/10)+1), @/((28/10)+1) +Real\-world formula for +5 and +12 volt would look like: +.in +8n +.nf +compute in3 @*((6.8/10)+1), @/((6.8/10)+1) +compute in4 @*((28/10)+1), @/((28/10)+1) +.fi +.in -For negative voltages (typically \-5V and \-12V), two resistors are used +For negative voltages (typically \-5 and \-12 volt), two resistors are used as well, but different boards use different strategies to bring the -voltage value into the 0 \- 4.08 V range. Some use an inverting +voltage value into the 0 to 4.08 volt range. Some use an inverting amplifier, others use a positive reference voltage. This leads to different computation formulas. Note that most users won't have to care -because most modern motherboards make little use of \-12V and no use of -\-5V so they do not bother monitoring these voltage inputs. +because most modern motherboards make little use of \-12 volt and no use of +\-5 volt so they do not bother monitoring these voltage inputs. Real\-world examples for the inverting amplifier case: - compute in5 \-@*(240/60), \-@/(240/60) - compute in6 \-@*(100/60), \-@/(100/60) +.in +8n +.nf +compute in5 \-@*(240/60), \-@/(240/60) +compute in6 \-@*(100/60), \-@/(100/60) +.fi +.in Real\-world examples for the positive voltage reference case: - compute in5 @*(1+232/56) \- 4.096*232/56, (@ + 4.096*232/56)/(1+232/56) - compute in6 @*(1+120/56) \- 4.096*120/56, (@ + 4.096*120/56)/(1+120/56) +.in +8n +.nf +compute in5 @*(1+232/56) \- 4.096*232/56, (@ + 4.096*232/56)/(1+232/56) +compute in6 @*(1+120/56) \- 4.096*120/56, (@ + 4.096*120/56)/(1+120/56) +.fi +.in -Many recent monitoring chips have a 0 \- 2.04 V range, so scaling resistors +Many recent monitoring chips have a 0 to 2.04 volt range, so scaling resistors are even more needed, and resistor values are different. There are also a few chips out there which have internal scaling @@ -563,7 +586,7 @@ ignored. .RE .SH SEE ALSO -libsensors(3) +.BR libsensors (3) .SH AUTHOR Frodo Looijaard and the lm_sensors group
