Live Pen™2/Professional Firmware 1.x and 2.x compatibility
Please read this information before upgrading your Live Pen™2 or Live Pen™2 Professional to firmware v2.x to avoid compatibility issues.
As the incremented version number indicates, there has been a major change between firmware versions 1.x and 2.x for Live Pen™2 and Live Pen™2 professional devices. It is important to understand that version 2.x is not backwards compatible with applications based on older SDK's.
Before upgrading to firmware 2.x, you must ensure any application required to read the ink data has been updated to support the STF2 format extension scheme, now used for the first time in this version
Ink data stroke format
Ink stroke data is stored as a stream of data within a container called STF2, the design of which is extensible allowing us to add new functionality as the product matures. A bug was discovered which caused applications to hang when presented with data in the STF2 file that wasn't expected. In order to prevent future compatibility issues, updated SDK's have been made available which correct this issue but resulted in older versions becoming incompatible with the later STF2 format. In order to use firmware 2.x (STF2 v2.2), the following SDK and application versions are required:-
|Firmware 2.x (STF2 v2.2)||Min Required Version|
|Live Encryption SDK for Windows||1.0.2|
|Live Encryption SDK for Linux||1.0.2|
|Live SDK for Windows||1.4.0|
|Anoto Live Forms||TBC|
Please note that Anoto Live Forms (ALF) v4.5.0 is not compatible with Firmware 2.x. Customers using this version of ALF should continue to use firmware 1.x.
Why is this change necessary?
In order to retain backward compatibility with legacy systems based on the Anoto PGC stroke format, an ink converter library is provided as part of the Windows SDK which provides functionality to transform STF2 data to PGC. In previous versions of this converter, the SYSTEM_TIME reported in the PGC output was taken from the host clock rather than the pen clock. To be able to report the pen clock (as done in previous pens), an extra data element was added to the STF2 file which allowed later versions of the ink converter to provide access to the pen time information whilst remaining compatible with existing customer applications. Unfortunately, a bug in the STF2 parsing library (present in all of the applications listed above) causes it and its associated application to hang when presented with the additional data rather than simply ignoring it. In order to resolve this, the parsing library was updated and re-issued in these SDK's which are therefore a prerequisite prior to the use of firmware 2.x.