Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) Kernel driver lm70
^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)   * National Semiconductor LM70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8)     Datasheet: http://www.national.com/pf/LM/LM70.html
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)   * Texas Instruments TMP121/TMP123
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)     Information: http://focus.ti.com/docs/prod/folders/print/tmp121.html
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)   * Texas Instruments TMP122/TMP124
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)     Information: https://www.ti.com/product/tmp122
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)   * National Semiconductor LM71
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)     Datasheet: https://www.ti.com/product/LM71
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)   * National Semiconductor LM74
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)     Datasheet: https://www.ti.com/product/LM74
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Author:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) 	Kaiwan N Billimoria <kaiwan@designergraphix.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) This driver implements support for the National Semiconductor LM70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) temperature sensor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) The LM70 temperature sensor chip supports a single temperature sensor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) It communicates with a host processor (or microcontroller) via an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) SPI/Microwire Bus interface.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Communication with the LM70 is simple: when the temperature is to be sensed,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) the driver accesses the LM70 using SPI communication: 16 SCLK cycles
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) comprise the MOSI/MISO loop. At the end of the transfer, the 11-bit 2's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) complement digital temperature (sent via the SIO line), is available in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) driver for interpretation. This driver makes use of the kernel's in-core
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) SPI support.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) As a real (in-tree) example of this "SPI protocol driver" interfacing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) with a "SPI master controller driver", see drivers/spi/spi_lm70llp.c
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) and its associated documentation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) The LM74 and TMP121/TMP122/TMP123/TMP124 are very similar; main difference is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) 13-bit temperature data (0.0625 degrees celsius resolution).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) The TMP122/TMP124 also feature configurable temperature thresholds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) The LM71 is also very similar; main difference is 14-bit temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) data (0.03125 degrees celsius resolution).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Thanks to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) ---------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Jean Delvare <jdelvare@suse.de> for mentoring the hwmon-side driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) development.