More examples

Signed-off-by: Daniel Schaefer <[email protected]>

Author: JohnAZoidberg

EXAMPLES.md

@@ -93,19 +93,6 @@ LED Matrix
 ALS:   76 Lux
 ```
 
-## Check power (AC and battery) status
-
-```
-> sudo ./target/debug/framework_tool --power
-  AC is:            not connected
-  Battery is:       connected
-  Battery LFCC:     3949 mAh (Last Full Charge Capacity)
-  Battery Capacity: 2770 mAh
-                    44.729 Wh
-  Charge level:     70%
-  Battery discharging
-```
-
 ## Set custom fan duty/RPM
 
 ```
@@ -171,10 +158,48 @@ Battery Status
   Battery discharging
 ```
 
+Get more information
+
+```
+> sudo framework_tool --power -vv
+Charger Status
+  AC is:            not connected
+  Charger Voltage:  14824mV
+  Charger Current:  0mA
+  Chg Input Current:384mA
+  Battery SoC:      33%
+Battery Status
+  AC is:            not connected
+  Battery is:       connected
+  Battery LFCC:     4021 mAh (Last Full Charge Capacity)
+  Battery Capacity: 1300 mAh
+                    19.267 Wh
+  Charge level:     32%
+  Manufacturer:     NVT
+  Model Number:     FRANGWA
+  Serial Number:    038F
+  Battery Type:     LION
+  Present Voltage:  14.821 V
+  Present Rate:     943 mA
+  Design Capacity:  3915 mAh
+                    60.604 Wh
+  Design Voltage:   15.480 V
+  Cycle Count:      64
+  Battery discharging
+```
+
 ### Setting a custom charger current limit
 
 ```
-# Set limit to 2A
+# 1C = normal charging rate
+# This means charging from 0 to 100% takes 1 hour
+# Set charging rate to 0.8C
+> sudo framework_tool --charge-rate-limit 0.8
+
+# Limit charge current to the battery to to 2A
+# In the output of `framework_tool --power -vv` above you can se "Design Capacity"
+# Dividing that by 1h gives you the maximum charging current (1C)
+# For example Design Capacity:  3915 mAh => 3915mA
 > sudo framework_tool --charge-current-limit 2000
 
 # And then plug in a power adapter
@@ -183,6 +208,7 @@ Charger Status
   AC is:            connected
   Charger Voltage:  17800mV
   Charger Current:  2000mA
+                    0.51C
   Chg Input Current:3084mA
   Battery SoC:      87%
 Battery Status
@@ -194,14 +220,16 @@ Battery Status
   Charge level:     86%
   Battery charging
 
-# Remove limit (highest USB-PD current is 5A)
-> sudo framework_tool --charge-current-limit 5000
+# Remove limit (set rate to 1C)
+> sudo framework_tool --charge-rate-limit 1
 
+# Back to normal
 > sudo framework_tool --power
 Charger Status
   AC is:            connected
   Charger Voltage:  17800mV
   Charger Current:  2740mA
+                    0.70C
   Chg Input Current:3084mA
   Battery SoC:      92%
 Battery Status
@@ -212,4 +240,8 @@ Battery Status
                     60.146 Wh
   Charge level:     91%
   Battery charging
+
+# Set charge rate/current limit only if battery is >80% charged
+> sudo framework_tool --charge-rate-limit 80 0.8
+> sudo framework_tool --charge-current-limit 80 2000
 ```