Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) Kernel driver adm1025
^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) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6)   * Analog Devices ADM1025, ADM1025A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8)     Prefix: 'adm1025'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)     Addresses scanned: I2C 0x2c - 0x2e
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)     Datasheet: Publicly available at the Analog Devices website
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)   * Philips NE1619
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)     Prefix: 'ne1619'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)     Addresses scanned: I2C 0x2c - 0x2d
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)     Datasheet: Publicly available at the Philips website
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) The NE1619 presents some differences with the original ADM1025:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)   * Only two possible addresses (0x2c - 0x2d).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)   * No temperature offset register, but we don't use it anyway.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)   * No INT mode for pin 16. We don't play with it anyway.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Authors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 	- Chen-Yuan Wu <gwu@esoft.com>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 	- Jean Delvare <jdelvare@suse.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) (This is from Analog Devices.) The ADM1025 is a complete system hardware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) monitor for microprocessor-based systems, providing measurement and limit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) comparison of various system parameters. Five voltage measurement inputs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) are provided, for monitoring +2.5V, +3.3V, +5V and +12V power supplies and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) the processor core voltage. The ADM1025 can monitor a sixth power-supply
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) voltage by measuring its own VCC. One input (two pins) is dedicated to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) remote temperature-sensing diode and an on-chip temperature sensor allows
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) ambient temperature to be monitored.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) One specificity of this chip is that the pin 11 can be hardwired in two
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) different manners. It can act as the +12V power-supply voltage analog
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) input, or as the a fifth digital entry for the VID reading (bit 4). It's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) kind of strange since both are useful, and the reason for designing the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) chip that way is obscure at least to me. The bit 5 of the configuration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) register can be used to define how the chip is hardwired. Please note that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) it is not a choice you have to make as the user. The choice was already
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) made by your motherboard's maker. If the configuration bit isn't set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) properly, you'll have a wrong +12V reading or a wrong VID reading. The way
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) the driver handles that is to preserve this bit through the initialization
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) process, assuming that the BIOS set it up properly beforehand. If it turns
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) out not to be true in some cases, we'll provide a module parameter to force
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) modes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) This driver also supports the ADM1025A, which differs from the ADM1025
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) only in that it has "open-drain VID inputs while the ADM1025 has on-chip
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 100k pull-ups on the VID inputs". It doesn't make any difference for us.