[PATCH RESEND v2 3/3] Documentation: power: rt9756: Document exported sysfs entries
From: cy_huang
Date: Thu Aug 14 2025 - 03:39:19 EST
From: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
Document the settings exported by rt9756 charger driver through sysfs
entries:
- watchdog_timer
- battery_voltage
- battery_current
- operation_mode
Signed-off-by: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
---
.../ABI/testing/sysfs-class-power-rt9756 | 52 +++++++++++++++++++
1 file changed, 52 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-class-power-rt9756
diff --git a/Documentation/ABI/testing/sysfs-class-power-rt9756 b/Documentation/ABI/testing/sysfs-class-power-rt9756
new file mode 100644
index 000000000000..2d0f7ef1b855
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-class-power-rt9756
@@ -0,0 +1,52 @@
+What: /sys/class/power_supply/rt9756-*/watchdog_timer
+Date: Aug 2025
+KernelVersion: 6.17
+Contact: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
+Description:
+ This entry shows and sets the watchdog timer when rt9756 charger
+ operates in charging mode. When the timer expires, the device
+ will disable the charging. To prevent the timer expires, any
+ host communication can make the timer restarted.
+
+ Access: Read, Write
+
+ Valid values:
+ - 500, 1000, 5000, 30000, 40000, 80000, 128000 or 255000 (milliseconds),
+ - 0: disabled
+
+What: /sys/class/power_supply/rt9756-*/battery_voltage
+Date: Aug 2025
+KernelVersion: 6.17
+Contact: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
+Description:
+ Reports the current BAT voltage.
+
+ Access: Read-Only
+
+ Valid values: Represented in microvolts
+
+What: /sys/class/power_supply/rt9756-*/battery_current
+Date: Aug 2025
+KernelVersion: 6.17
+Contact: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
+Description:
+ Reports the current BAT current.
+
+ Access: Read-Only
+
+ Valid values: Represented in microamps
+
+What: /sys/class/power_supply/rt9756-*/operation_mode
+Date: Aug 2025
+KernelVersion: 6.17
+Contact: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
+Description:
+ This entry shows and set the operation mode when rt9756 charger
+ operates in charging phase. If 'bypass' mode is used, internal
+ path will connect vbus directly to vbat. Else, default 'div2'
+ mode for the switch-cap charging.
+
+ Access: Read, Write
+
+ Valid values:
+ - 'bypass' or 'div2'
--
2.34.1