Skip to content

Commit 56c98f1

Browse files
committed
EXAMPLES_ADVANCED: Add --smartbattery example
Signed-off-by: Daniel Schaefer <dhs@frame.work>
1 parent 1e61641 commit 56c98f1

1 file changed

Lines changed: 44 additions & 0 deletions

File tree

EXAMPLES_ADVANCED.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,50 @@ Keyboard backlight: 0%
2828
Keyboard backlight: 0%
2929
```
3030

31+
## Battery
32+
33+
### Smart Battery
34+
35+
Get smart battery information by talking to the battery directly through SMBUS.
36+
37+
Allows unsealing the battery and reading privileged registers - this needs the
38+
secret key and is not available to end-users. Implemented for Framework
39+
internal analysis of RMA units.
40+
End-users, please press enter to skip unseal key.
41+
42+
```
43+
> sudo framework_tool --smartbattery
44+
Enter unseal key in hex (e.g. 04143672), or press enter to skip:
45+
Device Name: FRANEDA
46+
Manuf Name: ATC
47+
Serial Num: 0188
48+
Manuf Date: 2025-11-27
49+
Chemistry: LION
50+
FW Version: Device=0x0045 FW=09.03 Build=0x4900
51+
Mode: 0x6001
52+
Temperature: 32.6C
53+
Voltage: 17.719V
54+
Cell 1: 4.430V
55+
Cell 2: 4.429V
56+
Cell 3: 4.431V
57+
Cell 4: 4.428V
58+
Current: 0.000A (avg 0.000A)
59+
Charge: 98% (4776 / 4920 mAh)
60+
Design: 4640mAh @ 15.640V
61+
Bat Status: 0x00E0 [FC (Fully Charged), DSG (Discharging), INIT (Initialization)]
62+
Cycle Count: 76
63+
64+
=== Battery Health Analysis ===
65+
66+
Status: HEALTHY
67+
No issues detected. Battery is operating normally.
68+
69+
Summary:
70+
Cycle count: 76
71+
Capacity: 4920 / 4640 mAh (106%)
72+
Current cell balance: 3mV spread
73+
```
74+
3175
## PD
3276

3377
### Check PD state

0 commit comments

Comments
 (0)