Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) Kernel driver adc128d818
^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)   * Texas Instruments ADC818D818
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8)     Prefix: 'adc818d818'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)     Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
^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 TI website https://www.ti.com/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Author: Guenter Roeck
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) This driver implements support for the Texas Instruments ADC128D818.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) It is described as 'ADC System Monitor with Temperature Sensor'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) The ADC128D818 implements one temperature sensor and seven voltage sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Temperatures are measured in degrees Celsius. There is one set of limits.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) When the HOT Temperature Limit is crossed, this will cause an alarm that will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) be reasserted until the temperature drops below the HOT Hysteresis.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Measurements are guaranteed between -55 and +125 degrees. The temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) measurement has a resolution of 0.5 degrees; the limits have a resolution
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) of 1 degree.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Voltage sensors (also known as IN sensors) report their values in volts.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) An alarm is triggered if the voltage has crossed a programmable minimum
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) or maximum limit. Note that minimum in this case always means 'closest to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) zero'; this is important for negative voltage measurements. All voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) inputs can measure voltages between 0 and 2.55 volts, with a resolution
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) of 0.625 mV.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) If an alarm triggers, it will remain triggered until the hardware register
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) is read at least once. This means that the cause for the alarm may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) already have disappeared by the time the alarm is read. The driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) caches the alarm status for each sensor until it is at least reported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) once, to ensure that alarms are reported to user space.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) The ADC128D818 only updates its values approximately once per second;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) reading it more often will do no harm, but will return 'old' values.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) In addition to the scanned address list, the chip can also be configured for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) addresses 0x35 to 0x37. Those addresses are not scanned. You have to instantiate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) the driver explicitly if the chip is configured for any of those addresses in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) your system.