Documentation/hwmon/abituguru-datasheet.rst

14 Olle Sandberg <ollebull@gmail.com>, 2005-05-25
27 Hans de Goede <j.w.r.degoede@hhs.nl>, 28-01-2006
33 As far as known the uGuru is always placed at and using the (ISA) I/O-ports
34 0xE0 and 0xE4, so we don't have to scan any port-range, just check what the two
35 ports are holding for detection. We will refer to 0xE0 as CMD (command-port)
39 present. We have to check for two different values at data-port, because
41 later on attached again data-port will hold 0x08, more about this later.
57 ----------
59 The uGuru has a number of different addressing levels. The first addressing
60 level we will call banks. A bank holds data for one or more sensors. The data
61 in a bank for a sensor is one or more bytes large.
63 The number of bytes is fixed for a given bank, you should always read or write
65 less then the number of bytes for a given bank are undetermined.
67 See below for all known bank addresses, numbers of sensors in that bank,
68 number of bytes data per sensor and contents/meaning of those bytes.
71 terminology for the addressing within a bank this is not 100% correct, in
72 bank 0x24 for example the addressing within the bank selects a PWM output not
76 uGuru determines if a read from or a write to the bank is taking place, thus
82 -----------
92 has to be read a number of times (max 50).
97 not yet reported 0x08 at DATA and you proceed with writing a bank address.
100 Sending bank and sensor addresses to the uGuru
101 ----------------------------------------------
104 0x08 indicating that the uGuru wants input, in this case the bank address.
106 Next write the bank address to DATA. After the bank address has been written
114 -------
116 First send the bank and sensor addresses as described above.
122 test for this. Notice that the number of bytes is bank address dependent see
133 -------
135 First send the bank and sensor addresses as described above.
152 -------
156 bank address. With these versions this happens quite frequent, using larger
166 Bank 0x20 Alarms (R)
167 --------------------
168 This bank contains 0 sensors, iow the sensor address is ignored (but must be
169 written) just use 0. Bank 0x20 contains 3 bytes:
172   This byte holds the alarm flags for sensor 0-7 of Sensor Bank1, with bit 0
176   This byte holds the alarm flags for sensor 8-15 of Sensor Bank1, with bit 0
180   This byte holds the alarm flags for sensor 0-5 of Sensor Bank2, with bit 0
184 Bank 0x21 Sensor Bank1 Values / Readings (R)
185 --------------------------------------------
186 This bank contains 16 sensors, for each sensor it contains 1 byte.
189 - Sensor  0 CPU temp
190 - Sensor  1 SYS temp
191 - Sensor  3 CPU core volt
192 - Sensor  4 DDR volt
193 - Sensor 10 DDR Vtt volt
194 - Sensor 15 PWM temp
205 in use result in ranges of: 0-4361mV, 0-6248mV or 0-14510mV. 3.3 volt sources
206 use the 0-4361mV range, 5 volt the 0-6248mV and 12 volt the 0-14510mV .
212 Bank 0x22 Sensor Bank1 Settings (R) and Bank 0x23 Sensor Bank1 Settings (W)
213 ---------------------------------------------------------------------------
217 address in Bank 0x21 .
245   - Volt sensor: Shutdown if alarm persist for more than 4 seconds	(RW)
246   - Temp sensor: Shutdown if temp is over the shutdown threshold	(RW)
256   - Temp sensor: warning threshold  (scale as bank 0x21)
257   - Volt sensor: min threshold      (scale as bank 0x21)
260   - Temp sensor: shutdown threshold (scale as bank 0x21)
261   - Volt sensor: max threshold      (scale as bank 0x21)
264 Bank 0x24 PWM outputs for FAN's (R) and Bank 0x25 PWM outputs for FAN's (W)
265 ---------------------------------------------------------------------------
268   - Sensor 0 usually controls the CPU fan
269   - Sensor 1 usually controls the NB (or chipset for single chip) fan
270   - Sensor 2 usually controls the System fan
274   low nibble (temp)sensor address at bank 0x21 used for control.
277   0-255 = 0-12v (linear), specify voltage at which fan will rotate when under
281   0-255 = 0-12v (linear), specify voltage at which fan will rotate when above
285   Low threshold temp  (scale as bank 0x21)
288   High threshold temp (scale as bank 0x21)
291 Bank 0x26 Sensors Bank2 Values / Readings (R)
292 ---------------------------------------------
294 This bank contains 6 sensors (AFAIK), for each sensor it contains 1 byte.
297   - Sensor 0: CPU fan speed
298   - Sensor 1: NB (or chipset for single chip) fan speed
299   - Sensor 2: SYS fan speed
302   This byte holds the reading from the sensor. 0-255 = 0-15300 (linear)
305 Bank 0x27 Sensors Bank2 Settings (R) and Bank 0x28 Sensors Bank2 Settings (W)
306 -----------------------------------------------------------------------------
323   min threshold (scale as bank 0x26)
331 0-0x30 with the reading code used for the sensor banks (0x20-0x28) and this