Date: September 30, 2022
Subject: eSync Software Release 20220930

Overview:
--------
This folder contains the files used with the eSynC Products,
as described in the "eSynC Installation Manual". This installation
package is intended for mobile devices running android 7, 8, and 9.

Related Documents:
-----------------
The "eSynC Quick Start Guide" describes how to prepare a mobile device
for operation with a eSynC product.

The "eSynC Product Family - Reference Manual" describes the features
of the eSynC products.

The "LTM Advanced Utility" describes the advanced configuration settings
of the LTM Application, in addition to Lava Battery Info and Lava Device
Info which are located in the Extra folder.


Application Descriptions:
------------------------
LAVA Tablet Manager (LTM) runs on the mobile device to manage the eSynC
product. This application MUST be installed on the mobile device.
The application is reported as "LAVA" v4.04.
The installation file name is LTM_v4.04.apk.

The LAVA Battery Information (LBI) runs on the mobile device to report
battery status. LBI is an optional utility useful during debug.
The application is reported as "Battery Information" v3.07.
The installation file name is LBI.apk.

The LAVA Device Info utility runs on the mobile device to report
the firmware version and settings within a LAVA Device.
The application is reported as "LAVA Device Info" v1.04.


Release Package Files:
---------------------

File Name                       Description
----------------------------    ------------------------------------------
README - 20220930.TXT           This is the file currently being read.

LTM_v4.06.apk                   The LAVA Tablet Manager (LTM) is used to 
                                remotely manage battery features.
                                The current version is 4.06.

eSynC_Quick_Start_Guide_Web.pdf
                                The Installation Manual describes how to
                                prepare the eSynC product and the mobile
                                device for operation.
                                Version Web.

eSynC_Product_Family_Reference_Manual_Web.pdf
                                This manual describes the features of the
                                eSynC products, ports, LEDs, firmware
                                upgrading, and the LTM.INI configuration file.
                                Version Web.

LTM_Advanced_Utilities_Web.pdf
                                This manual describes the features associated 
                                with LTM 4.06 in addition some advanced 
                                customization of the LTM app.
                                

.\Extra\LBI_v4.02.apk           The LAVA Battery Information is a diagnostic
                                tool used to report the battery charging
                                status on a Samsung Tablet.
                                The current version is 4.02.

.\Extra\LBI.pdf                 The manual for the LBI v4.02 application.
                                Version A00.

.\Extra\LAVA Device Info.apk    The LAVA Device Info utility is used to
                                report the firmware version and settings
                                of a LAVA device.
                                The current version is 1.04.


Release Package History:
------------------------
20180706  1)Initial release of the software package.
             Only supports up to Android 7.

20181010  2)Updated package to handle Android 7 and 8 based mobile devices.
            The LTM application now works with the new consolidated KNOX SDK.
            Now includes the "LTM Setup" utility to view and modify the LTM
            configuration on the running mobile device.

20190111  1)Updated LTM so that if the Screen Brightness Management feature
            is not disabled, the "Allow LTM to access system settings"
            permission is not prompted for. This change simplifies deployments
            to sites which must run 24 hours a day.
          2)Added LBI.APK, which was missing in the previous release package.
          3)Added the "LAVA Device Info" utility.
          4)Updates to the installation and reference manuals.
          5)Now use ZIP compression rather than RAR for the release package.

20190529  1)Updated LTM handling of the maintenance reset feature.
          2)Updates to LTM for Android 9 support. The mechanism used to
            monitor that battery charge current had to be changed.
            Android 9 devices should only use LTM v3.03 or newer.
          3)Updated LBI for Android 9 operation. The mechanism used to
            monitor the battery charge current had to be changed.
          4)Updated LAVA Device Info for Android 9 operation.
          5)LAVA Device Info now works with Android 5.0 and newer.
            The previous release required Android 7 as a minimum.
          6)LAVA Device Info now supports a Docking Detect Enable/Disable
            provided the firmware of the eSTS device supports the
            required commands. Support was added in eSTS v2.06.

20200131  1)Updated LTM and documentation to support second generation
            of eSynC products. The second generation products
            offer two battery protection schemes to permit operation
            with a wider range of Samsung devices.
          2)The default LTM.INI files have been revised to support
            the second generation products.
          3)All components in the package are backward compatible with
            the original generation of products.
          4)LTM optionally reports changes to the charging role of a
            mobile device when operating with a eSynC product.
            This report is in the form of an Android Intent message
            which can be intercepted by a customer application.
            This mechanism is for customers who are writing or extending
            their own application. If this feature is required, please
            contact LAVA Sales for additional documentation.

20200630  1)Updated LTM_Setup to v1.03, goal was to make LTM_Setup the main
            tool for creating and configuring the LTM.ini on a Tablet
          2)Default ini files were removed from the release package since
            they should not be needed with the updates to LTM_Setup
          3)Installation Manual changes were made to reflect updates

20201112  1)Preliminary release of LTM
          2)Updated LTM to v4.00 in order to remove reliance on KNOX.
          3)Older applications that were no longer required were not 
            removed from the release package.
          4)Installation Manual changes were made to reflect updates.
          
20200630  1)Updated LTM_Setup to v1.03, goal was to make LTM_Setup the main
            tool for creating and configuring the LTM.ini on a Tablet
          2)Default ini files were removed from the release package since
            they should not be needed with the updates to LTM_Setup
          3)Installation Manual changes were made to reflect updates

20201214  1)Updated LTM to v4.01.
          2)Updated installation manuals to reflect changes to LTM v4.01.
          3)Updated LBI.apk to v3.08.

20201218  1)Updated LTM Advanced Utilities document to A04.

20210113  1)Updated LTM to v4.02 to correct the Android Hardware filter used 
            to automatically launch LTM. There is also a cosmetic improvement 
            to display the network interface after the reported IP Address.

20210507  1)Changes to eliminate possible sources of the phantom USB
            Permission pop-up. The changes in v4.03 did not eliminate
            the problem. On occasion Android still requested the user grant
            LTM permission to access hardware, when permission was already
            established during the initial setup.
          2)Changes to the Network Recovery mechanism to address Android 10
            and Android 11 issues. The Samsung SM-T510 with Android 10 would
            report the network connection state in an erratic manner.
          3)Now target Android 10 rather than Android 11 to ensure that LTM
            can examine the Ethernet MAC address and make run-time decisions.
            Reading the LAVA Ethernet MAC address was a problem if running on
            an Android 11 device. An application which targets Android 10 is
            permitted to run on Android 11.
          4)The Extended Screen Timeout introduced in v4.03 now delays the
            first screen wakeup message for 12 hours after LTM first runs.
            Subsequent wakeup messages are every 7 days after the initial
            message. The wakeup message is an Android Toast pop-up with no
            text, so appears briefly as a small grey oval at the bottom
            of the screen. This feature sets the screen timeout to 24.8
            days, which is the maximum permitted by Android.
          5)Now count the network reset requests (DHCP recovery) and optionally
            report via the user debug toast messages if the debug level is 3.
            The value is non-volatile. The value is cleared when the LTM
            configuration disables Ethernet or is not using Network Recovery.
          6)The User Debug option 3 now includes the IP Address of the Ethernet
            interface and network reset request count. This is applicable only
            to LAVA devices with an Ethernet interface.
          7)The battery protection logic now runs every 60 seconds, rather
            than every 30 seconds. Some tablets take longer than is typical
            to recovery after a charge state change. This change adds an
            extra safety margin for all mobile devices.
          8)The "force to background" feature has been improved to ensure 
            resources are released before restarting the application.

20220930 1)LTM v4.06 has been updated to support the latest Android libraries
            to future proof the application. The minimum Android version supported
            is now Android 8.0.
          2)The Configuration page presentations have been changed in accordance with
            the Android library update. Configuration menu features remain the same.
          3)An "Export LTM Files" button has been added in the main page to copy
            LTM configuration and log files to an internal or external storage.
            This feature was added as the later Android versions do not allow users
            to access private application folders.
          4)LTM v4.05 was only for internal use and has never been released.
            The next version after LTM v4.04 is LTM v4.06.


[End of document]


