M851 WristApp GUI Plug-in Design Guide
Rev 1.0
Timex Corporation
8
3.3.2 Changed WristApp Data
When the database changes between downloads, the packager (TUCP.DLL) checks the size of the
database and the contents versus the last data sent to the watch. If the size of the new data is larger than
the previously allocated space, then a full download will occur. There is no call that needs to be done in
order for this to occur. The packager handles this for you. All that is required is that the database differs in
some way versus the previously downloaded database. If the database is the same size, yet the contents
are different, then the database will be re-downloaded, but the code will not have to be downloaded
again. This applies to all applications with database data associated with them.
3.3.3 Reading WristApp Data
If the WristApp has been modified in the watch, it will be uploaded back to the PC when the next read
occurs, which happens when the watch is connected to the PC. The packager DLL reads the files and
puts it into the DB directory in the PIM’s installation directory.
Each wristapp that has been uploaded back to the PC will have the name upwristappdbX.bin where X is
the instance of the application. When downloading, the PIM will place the instance number in the
WristApp’s associated .INI file (which is created if it doesn’t exist). The file shown below describes how
the INI file will be created:
[System]
Instance=5
In the example above, the WristApp has an instance of 5, so the WristApp’s file will be upwristappdb5.bin.
When the user double-clicks on your WristApp in the PIM’s mode list, you can read this file before
showing the user interface and show the changes to the user.
If the above Instance value was NULL (no value to the right of the equals sign), then that means no data
was read for the WristApp. In this case, you should provide default data for the user when the UI
launches.
This file should be the same format as the database that was downloaded, and its up to the WristApp
code to make sure that the database stays the same.
4 Trademarks
TIMEX is a registered trademark and service mark of Timex Corporation.
TIMEX DATA LINK and WristApp are trademarks of Timex Corporation in the U.S. and other countries.
Night-Mode is a registered trademark of Timex Corporation.
INDIGLO is a registered trademark of Indiglo Corporation.
