Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) Kernel driver ltc4261
^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)   * Linear Technology LTC4261
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8)     Prefix: 'ltc4261'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)     Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)     Datasheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 	http://cds.linear.com/docs/Datasheet/42612fb.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Author: Guenter Roeck <linux@roeck-us.net>
^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) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) The LTC4261/LTC4261-2 negative voltage Hot Swap controllers allow a board
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) to be safely inserted and removed from a live backplane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) This driver does not probe for LTC4261 devices, since there is no register
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) which can be safely used to identify the chip. You will have to instantiate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) the devices explicitly.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Example: the following will load the driver for an LTC4261 at address 0x10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) on I2C bus #1::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 	$ modprobe ltc4261
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 	$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Voltage readings provided by this driver are reported as obtained from the ADC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) registers. If a set of voltage divider resistors is installed, calculate the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) real voltage by multiplying the reported value with (R1+R2)/R2, where R1 is the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) value of the divider resistor against the measured voltage and R2 is the value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) of the divider resistor against Ground.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Current reading provided by this driver is reported as obtained from the ADC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Current Sense register. The reported value assumes that a 1 mOhm sense resistor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) is installed. If a different sense resistor is installed, calculate the real
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) current by dividing the reported value by the sense resistor value in mOhm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) The chip has two voltage sensors, but only one set of voltage alarm status bits.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) In many many designs, those alarms are associated with the ADIN2 sensor, due to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) the proximity of the ADIN2 pin to the OV pin. ADIN2 is, however, not available
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) on all chip variants. To ensure that the alarm condition is reported to the user,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) report it with both voltage sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) ======================= =============================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) in1_input		ADIN2 voltage (mV)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) in1_min_alarm		ADIN/ADIN2 Undervoltage alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) in1_max_alarm		ADIN/ADIN2 Overvoltage alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) in2_input		ADIN voltage (mV)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) in2_min_alarm		ADIN/ADIN2 Undervoltage alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) in2_max_alarm		ADIN/ADIN2 Overvoltage alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) curr1_input		SENSE current (mA)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) curr1_alarm		SENSE overcurrent alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) ======================= =============================