Documentation/hwmon/abituguru-datasheet.rst

5 First of all, what I know about uGuru is no fact based on any help, hints or
6 datasheet from Abit. The data I have got on uGuru have I assembled through
14 Olle Sandberg <ollebull@gmail.com>, 2005-05-25
19 and extended with write support and info on more databanks, the write support
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.
45 have to test CMD for two different values. On these uGuru's DATA will initially
57 ----------
63 The number of bytes is fixed for a given bank, you should always read or write
75 Notice that some banks have both a read and a write address this is how the
76 uGuru determines if a read from or a write to the bank is taking place, thus
78 write address. The write address is always one (1) more than the read address.
82 -----------
84 Before you can read from or write to the uGuru you must first put the uGuru
87 To put the uGuru in ready mode first write 0x00 to DATA and then wait for DATA
101 ----------------------------------------------
106 Next write the bank address to DATA. After the bank address has been written
107 wait for to DATA to hold 0x08 again indicating that it wants / is ready for
110 Once DATA holds 0x08 again write the sensor address to CMD.
114 -------
117 Then for each byte of data you want to read wait for DATA to hold 0x01
126 ready mode, so that it is ready for the next read / write cycle. This way
133 -------
136 Then for each byte of data you want to write wait for DATA to hold 0x00
138 once DATA holds 0x00 write the byte to CMD.
140 Once all bytes have been written wait for DATA to hold 0x01 (max 250 reads)
145 After completing a successful write it is advised to put the uGuru back in
146 ready mode, so that it is ready for the next read / write cycle. This way
152 -------
167 --------------------
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
185 --------------------------------------------
187 So far the following sensors are known to be available on all motherboards:
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 .
213 ---------------------------------------------------------------------------
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)
253        comments on how todo this.
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)
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
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
292 ---------------------------------------------
296 So far the following sensors are known to be available on all motherboards:
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)
306 -----------------------------------------------------------------------------
331 0-0x30 with the reading code used for the sensor banks (0x20-0x28) and this
333 sensors part configured so that it would shutdown my system on any out of spec
336 the read/write cycle for the non sensor part is different from the sensor part.