/* * libdivecomputer * * Copyright (C) 2010 Jef Driesen * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * MA 02110-1301 USA */ #include // memcpy, memcmp #include // malloc, free #include // assert #include "device-private.h" #include "mares_iconhd.h" #include "serial.h" #include "array.h" #include "utils.h" #define EXITCODE(rc) \ ( \ rc == -1 ? DEVICE_STATUS_IO : DEVICE_STATUS_TIMEOUT \ ) #ifdef _WIN32 #define BAUDRATE 256000 #else #define BAUDRATE 230400 #endif #define ACK 0xAA #define EOF 0xEA #define RB_PROFILE_BEGIN 0xA000 #define RB_PROFILE_END MARES_ICONHD_MEMORY_SIZE typedef struct mares_iconhd_device_t { device_t base; serial_t *port; unsigned char fingerprint[10]; } mares_iconhd_device_t; static device_status_t mares_iconhd_device_set_fingerprint (device_t *abstract, const unsigned char data[], unsigned int size); static device_status_t mares_iconhd_device_dump (device_t *abstract, dc_buffer_t *buffer); static device_status_t mares_iconhd_device_foreach (device_t *abstract, dive_callback_t callback, void *userdata); static device_status_t mares_iconhd_device_close (device_t *abstract); static const device_backend_t mares_iconhd_device_backend = { DEVICE_TYPE_MARES_ICONHD, mares_iconhd_device_set_fingerprint, /* set_fingerprint */ NULL, /* version */ NULL, /* read */ NULL, /* write */ mares_iconhd_device_dump, /* dump */ mares_iconhd_device_foreach, /* foreach */ mares_iconhd_device_close /* close */ }; static int device_is_mares_iconhd (device_t *abstract) { if (abstract == NULL) return 0; return abstract->backend == &mares_iconhd_device_backend; } static device_status_t mares_iconhd_version (mares_iconhd_device_t *device) { // Send the command to the dive computer. unsigned char command[2] = {0xC2, 0x67}; int n = serial_write (device->port, command, sizeof (command)); if (n != sizeof (command)) { WARNING ("Failed to send the command."); return EXITCODE (n); } // Receive the answer of the dive computer. unsigned char answer[142] = {0}; n = serial_read (device->port, answer, sizeof (answer)); if (n != sizeof (answer)) { WARNING ("Failed to receive the answer."); return EXITCODE (n); } // Verify the first and last byte. if (answer[0] != ACK || answer[sizeof (answer) - 1] != EOF) { WARNING ("Unexpected answer byte."); return DEVICE_STATUS_PROTOCOL; } return DEVICE_STATUS_SUCCESS; } device_status_t mares_iconhd_device_open (device_t **out, const char* name) { if (out == NULL) return DEVICE_STATUS_ERROR; // Allocate memory. mares_iconhd_device_t *device = (mares_iconhd_device_t *) malloc (sizeof (mares_iconhd_device_t)); if (device == NULL) { WARNING ("Failed to allocate memory."); return DEVICE_STATUS_MEMORY; } // Initialize the base class. device_init (&device->base, &mares_iconhd_device_backend); // Set the default values. device->port = NULL; // Open the device. int rc = serial_open (&device->port, name); if (rc == -1) { WARNING ("Failed to open the serial port."); free (device); return DEVICE_STATUS_IO; } // Set the serial communication protocol (256000 8N1). rc = serial_configure (device->port, BAUDRATE, 8, SERIAL_PARITY_NONE, 1, SERIAL_FLOWCONTROL_NONE); if (rc == -1) { WARNING ("Failed to set the terminal attributes."); serial_close (device->port); free (device); return DEVICE_STATUS_IO; } // Set the timeout for receiving data (1000 ms). if (serial_set_timeout (device->port, 1000) == -1) { WARNING ("Failed to set the timeout."); serial_close (device->port); free (device); return DEVICE_STATUS_IO; } // Set the DTR/RTS lines. if (serial_set_dtr (device->port, 0) == -1 || serial_set_rts (device->port, 0) == -1) { WARNING ("Failed to set the DTR/RTS line."); serial_close (device->port); free (device); return DEVICE_STATUS_IO; } // Make sure everything is in a sane state. serial_flush (device->port, SERIAL_QUEUE_BOTH); // Send the version command. device_status_t status = mares_iconhd_version (device); if (status != DEVICE_STATUS_SUCCESS) { serial_close (device->port); free (device); return status; } *out = (device_t *) device; return DEVICE_STATUS_SUCCESS; } static device_status_t mares_iconhd_device_close (device_t *abstract) { mares_iconhd_device_t *device = (mares_iconhd_device_t*) abstract; if (! device_is_mares_iconhd (abstract)) return DEVICE_STATUS_TYPE_MISMATCH; // Close the device. if (serial_close (device->port) == -1) { free (device); return DEVICE_STATUS_IO; } // Free memory. free (device); return DEVICE_STATUS_SUCCESS; } static device_status_t mares_iconhd_device_set_fingerprint (device_t *abstract, const unsigned char data[], unsigned int size) { mares_iconhd_device_t *device = (mares_iconhd_device_t *) abstract; if (size && size != sizeof (device->fingerprint)) return DEVICE_STATUS_ERROR; if (size) memcpy (device->fingerprint, data, sizeof (device->fingerprint)); else memset (device->fingerprint, 0, sizeof (device->fingerprint)); return DEVICE_STATUS_SUCCESS; } static device_status_t mares_iconhd_init (mares_iconhd_device_t *device) { // Send the command to the dive computer. unsigned char command[2] = {0xE7, 0x42}; int n = serial_write (device->port, command, sizeof (command)); if (n != sizeof (command)) { WARNING ("Failed to send the command."); return EXITCODE (n); } // Receive the answer of the dive computer. unsigned char answer[1] = {0}; n = serial_read (device->port, answer, sizeof (answer)); if (n != sizeof (answer)) { WARNING ("Failed to receive the answer."); return EXITCODE (n); } // Verify the first byte. if (answer[0] != ACK) { WARNING ("Unexpected answer byte."); return DEVICE_STATUS_PROTOCOL; } return DEVICE_STATUS_SUCCESS; } static device_status_t mares_iconhd_device_dump (device_t *abstract, dc_buffer_t *buffer) { mares_iconhd_device_t *device = (mares_iconhd_device_t *) abstract; // Erase the current contents of the buffer and // pre-allocate the required amount of memory. if (!dc_buffer_clear (buffer) || !dc_buffer_resize (buffer, MARES_ICONHD_MEMORY_SIZE)) { WARNING ("Insufficient buffer space available."); return DEVICE_STATUS_MEMORY; } // Enable progress notifications. device_progress_t progress = DEVICE_PROGRESS_INITIALIZER; progress.maximum = MARES_ICONHD_MEMORY_SIZE; device_event_emit (abstract, DEVICE_EVENT_PROGRESS, &progress); // Send the init command. device_status_t rc = mares_iconhd_init (device); if (rc != DEVICE_STATUS_SUCCESS) return rc; // Send the command to the dive computer. unsigned char command[8] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00}; int n = serial_write (device->port, command, sizeof (command)); if (n != sizeof (command)) { WARNING ("Failed to send the command."); return EXITCODE (n); } unsigned char *data = dc_buffer_get_data (buffer); unsigned int nbytes = 0; while (nbytes < MARES_ICONHD_MEMORY_SIZE) { // Set the minimum packet size. unsigned int len = 1024; // Increase the packet size if more data is immediately available. int available = serial_get_received (device->port); if (available > len) len = available; // Limit the packet size to the total size. if (nbytes + len > MARES_ICONHD_MEMORY_SIZE) len = MARES_ICONHD_MEMORY_SIZE - nbytes; // Read the packet. n = serial_read (device->port, data + nbytes, len); if (n != len) { WARNING ("Failed to receive the answer."); return EXITCODE (n); } // Update and emit a progress event. progress.current += len; device_event_emit (abstract, DEVICE_EVENT_PROGRESS, &progress); nbytes += len; } // Receive the last byte. unsigned char answer[1] = {0}; n = serial_read (device->port, answer, sizeof (answer)); if (n != sizeof (answer)) { WARNING ("Failed to receive the answer."); return EXITCODE (n); } // Verify the last byte. if (answer[0] != EOF) { WARNING ("Unexpected answer byte."); return DEVICE_STATUS_PROTOCOL; } return DEVICE_STATUS_SUCCESS; } static device_status_t mares_iconhd_device_foreach (device_t *abstract, dive_callback_t callback, void *userdata) { dc_buffer_t *buffer = dc_buffer_new (MARES_ICONHD_MEMORY_SIZE); if (buffer == NULL) return DEVICE_STATUS_MEMORY; device_status_t rc = mares_iconhd_device_dump (abstract, buffer); if (rc != DEVICE_STATUS_SUCCESS) { dc_buffer_free (buffer); return rc; } // Emit a device info event. unsigned char *data = dc_buffer_get_data (buffer); device_devinfo_t devinfo; devinfo.model = 0; devinfo.firmware = 0; devinfo.serial = array_uint16_le (data + 12); device_event_emit (abstract, DEVICE_EVENT_DEVINFO, &devinfo); rc = mares_iconhd_extract_dives (abstract, dc_buffer_get_data (buffer), dc_buffer_get_size (buffer), callback, userdata); dc_buffer_free (buffer); return rc; } device_status_t mares_iconhd_extract_dives (device_t *abstract, const unsigned char data[], unsigned int size, dive_callback_t callback, void *userdata) { mares_iconhd_device_t *device = (mares_iconhd_device_t *) abstract; if (abstract && !device_is_mares_iconhd (abstract)) return DEVICE_STATUS_TYPE_MISMATCH; if (size < MARES_ICONHD_MEMORY_SIZE) return DEVICE_STATUS_ERROR; // Get the end of the profile ring buffer. unsigned int eop = 0; const unsigned int config[] = {0x2001, 0x3001}; for (unsigned int i = 0; i < sizeof (config) / sizeof (*config); ++i) { eop = array_uint32_le (data + config[i]); if (eop != 0xFFFFFFFF) break; } if (eop < RB_PROFILE_BEGIN || eop >= RB_PROFILE_END) { WARNING ("Ringbuffer pointer out of range."); return DEVICE_STATUS_ERROR; } // Make the ringbuffer linear, to avoid having to deal with the wrap point. unsigned char *buffer = (unsigned char *) malloc (RB_PROFILE_END - RB_PROFILE_BEGIN); if (buffer == NULL) { WARNING ("Out of memory."); return DEVICE_STATUS_MEMORY; } memcpy (buffer + 0, data + eop, RB_PROFILE_END - eop); memcpy (buffer + RB_PROFILE_END - eop, data + RB_PROFILE_BEGIN, eop - RB_PROFILE_BEGIN); unsigned int offset = RB_PROFILE_END - RB_PROFILE_BEGIN; while (offset >= 0x60) { // Get the number of samples in the profile data. unsigned int nsamples = array_uint16_le (buffer + offset - 0x5A); if (nsamples == 0xFFFF) break; // Calculate the total number of bytes for this dive. // If the buffer does not contain that much bytes, we reached the // end of the ringbuffer. The current dive is incomplete (partially // overwritten with newer data), and processing should stop. unsigned int nbytes = nsamples * 8 + 0x60; if (offset < nbytes) break; // Move to the start of the dive. offset -= nbytes; // Verify that the length that is stored in the profile data // equals the calculated length. If both values are different, // something is wrong and an error is returned. unsigned int length = array_uint32_le (buffer + offset); if (length == 0) break; if (length != nbytes) { WARNING ("Calculated and stored size are not equal."); free (buffer); return DEVICE_STATUS_ERROR; } unsigned char *fp = buffer + offset + length - 0x56; if (device && memcmp (fp, device->fingerprint, sizeof (device->fingerprint)) == 0) { free (buffer); return DEVICE_STATUS_SUCCESS; } if (callback && !callback (buffer + offset, length, fp, sizeof (device->fingerprint), userdata)) { free (buffer); return DEVICE_STATUS_SUCCESS; } } free (buffer); return DEVICE_STATUS_SUCCESS; }