Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) Kernel driver w83627hf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) ======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5)   * Winbond W83627HF (ISA accesses ONLY)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6)     Prefix: 'w83627hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7)     Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8)   * Winbond W83627THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9)     Prefix: 'w83627thf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10)     Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11)   * Winbond W83697HF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12)     Prefix: 'w83697hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13)     Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14)   * Winbond W83637HF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15)     Prefix: 'w83637hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16)     Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17)   * Winbond W83687THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18)     Prefix: 'w83687thf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19)     Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20)     Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) Authors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) 	Frodo Looijaard <frodol@dds.nl>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) 	Philip Edelbrock <phil@netroedge.com>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25) 	Mark Studebaker <mdsxyz123@yahoo.com>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) 	Bernhard C. Schrenk <clemy@clemy.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) Module Parameters
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) * force_i2c: int
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32)   Initialize the I2C address of the sensors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) * init: int
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34)   (default is 1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35)   Use 'init=0' to bypass initializing the chip.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36)   Try this if your computer crashes when you load the module.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41) This driver implements support for ISA accesses *only* for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43) We will refer to them collectively as Winbond chips.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45) This driver supports ISA accesses, which should be more reliable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) than i2c accesses. Also, for Tyan boards which contain both a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47) Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) using this driver will avoid i2c address conflicts and complex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49) initialization that were required in the w83781d driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51) If you really want i2c accesses for these Super I/O chips,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) use the w83781d driver. However this is not the preferred method
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53) now that this ISA driver has been developed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55) The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57) VID reading. However the two chips have the identical 128 pin package. So,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) it is possible or even likely for a w83627thf to have the VID signals routed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59) to these pins despite their not being labeled for that purpose. Therefore,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) the w83627thf driver interprets these as VID. If the VID on your board
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61) doesn't work, first see doc/vid in the lm_sensors package[1]. If that still
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) doesn't help, you may just ignore the bogus VID reading with no harm done.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) For further information on this driver see the w83781d driver documentation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) [1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) Forcing the address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69) -------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71) The driver used to have a module parameter named force_addr, which could
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) be used to force the base I/O address of the hardware monitoring block.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73) This was meant as a workaround for mainboards with a broken BIOS. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) module parameter is gone for technical reasons. If you need this feature,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75) you can obtain the same result by using the isaset tool (part of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) lm-sensors) before loading the driver:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) # Enter the Super I/O config space::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) 	isaset -y -f 0x2e 0x87
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81) 	isaset -y -f 0x2e 0x87
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83) # Select the hwmon logical device::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) 	isaset -y 0x2e 0x2f 0x07 0x0b
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) # Set the base I/O address (to 0x290 in this example)::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 	isaset -y 0x2e 0x2f 0x60 0x02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) 	isaset -y 0x2e 0x2f 0x61 0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) # Exit the Super-I/O config space::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) 	isaset -y -f 0x2e 0xaa
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) 0x4e/0x4f is also possible.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) Voltage pin mapping
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) -------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Here is a summary of the voltage pin mapping for the W83627THF. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) can be useful to convert data provided by board manufacturers into
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) working libsensors configuration statements:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - W83627THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)   ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111)   Pin	   Name		   Register	   Sysfs attribute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)   ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)     100	   CPUVCORE	   20h		   in0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114)      99	   VIN0		   21h		   in1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115)      98	   VIN1		   22h		   in2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)      97	   VIN2		   24h		   in4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117)     114	   AVCC		   23h		   in3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118)      61	   5VSB		   50h (bank 5)	   in7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119)      74	   VBAT		   51h (bank 5)	   in8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)   ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) For other supported devices, you'll have to take the hard path and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) look up the information in the datasheet yourself (and then add it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) to this document please.)