# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1604618251 0
# Node ID 28d58a8cd70424bb87b2bb8fcb8c9d1ed460dfd8
# Parent  2cd5ac909e2345b321b360c6acf92d14dd766b8b
fc-fsio help: write-battery-table change documented

diff -r 2cd5ac909e23 -r 28d58a8cd704 rvinterf/etmsync/fsio.help
--- a/rvinterf/etmsync/fsio.help	Thu Nov 05 22:32:51 2020 +0000
+++ b/rvinterf/etmsync/fsio.help	Thu Nov 05 23:17:31 2020 +0000
@@ -34,7 +34,8 @@
 upload-fs		Upload a complete file system tree into device FFS
 upload-rf-table		Upload an RF calibration table into device FFS
 upload-subtree		Upload a subtree into device FFS
-write-battery-table	Upload table of battery thresholds into device FFS
+write-battery-table-v1	Upload table of battery thresholds into device FFS (v1)
+write-battery-table-v2	Upload table of battery thresholds into device FFS (v2)
 write-charging-config	Upload FCHG configuration into device FFS
 
 To get help on any command, type help and the command keyword.
@@ -324,13 +325,24 @@
 the given non-root directory in the target device FFS.
 
 === write-battery-table
-write-battery-table src-file
+=== write-battery-table-v1
+=== write-battery-table-v2
+write-battery-table-v1 src-file
+write-battery-table-v2 src-file
 
-This command provides the mechanism for uploading FreeCalypso-invented battery
-discharge threshold tables to target devices.  The argument is the name of the
-table source file on the host; this source file is read and compiled into the
-corresponding binary representation, and the latter is then written into
-/etc/batterytab on the target.
+This command (which now exists in two versions) provides the mechanism for
+uploading FreeCalypso-invented battery discharge threshold tables to target
+devices.  The argument is the name of the table source file on the host; this
+source file is read and compiled into the corresponding binary representation,
+and the latter is then written into /etc/batterytab or /etc/batterytab2 on the
+target.
+
+write-battery-table-v1 writes /etc/batterytab as needed for the original
+Magnetite and Selenite version of FCHG, write-battery-table-v2 writes
+/etc/batterytab2 (a different binary format) as needed for the new Tourmaline
+version of FCHG.  Both accept the same table source files; conversion to v1
+binary format made by write-battery-table-v1 discards the battery bars icon
+thresholds that were added in v2.
 
 === write-charging-config
 write-charging-config src-file