Hi,
I made some important changes to the libdivecomputer api, to support a
number of new features. Some of them break backwards compatibility. The
remainder of this email is an overview of the changes.
I believe we are now reaching a status where all must-have functionality
for downloading is available, but maybe not yet in the best possible
way. Anyway, the current version is definitely the one you should be using!
1. CLOCK EVENT
A new clock event was added to solve the clock synchronization problem
for the reefnet and uwatec devices. As soon as the device and system
timestamps to adjust the internal clock become available, you'll receive
them in this event.
2. FINGERPRINTS
In the foreach callback function, not only the dive data but also its
fingerprint is provided. You should store the fingerprint (of the most
recent dive) somewhere and pass it to the device_set_fingerprint()
function during the next download to retrieve only the new dives. You
could already do that before, but until now there was no way to get at
the fingerprint of each dive.
Note: The legacy xxx_device_set_timestamp() functions of the uwatec and
reefnet backends are deprecated and might be removed at some time later.
3. CANCELLATION
You can now cancel an operation by registering a cancellation callback
function. This callback function should return a non-zero value whenever
the active operaton should be cancelled, and zero when it should
continue. A backend can invoke this callback function to query the
application for a pending cancellation request.
Note that there is NO guarantee that the operation will actually be
cancelled. Not all backends support safe cancellation, and those that do
may not always notice a cancellation request in time.
4. OTHER
The Uwatec Smart backend breaks backwards compatibility by removing the
uwatec_smart_device_handshake and uwatec_smart_device_version functions.
The first one is done automatically during initialization and the second
one is replaced with the device_version function. The format of the
version data has changed too (the content remains the same, but the
order of the fields has changed into: model number, serial number,
timestamp). But you shouldn't need this info anymore because the same
info is delivered in the devinfo and clock events.
For systems without IrDA support (e.g. Mac OS X), a dummy IrDa backend
is used, which will always return an error at runtime.
The universal example application was update to use the new features.
One of the major additions is that it can now also parse the downloaded
dives and export them into a very simple xml file. You may find it
useful for testing.
Jef
