/* * libdivecomputer * * Copyright (C) 2014 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 // memcmp, memcpy #include // malloc, free #include #include "context-private.h" #include "device-private.h" #include "serial.h" #include "checksum.h" #include "array.h" #define ISINSTANCE(device) dc_device_isinstance((device), &divesystem_idive_device_vtable) #define IX3M_EASY 0x22 #define IX3M_DEEP 0x23 #define IX3M_TEC 0x24 #define IX3M_REB 0x25 #define MAXRETRIES 9 #define MAXPACKET 0xFF #define START 0x55 #define ACK 0x06 #define NAK 0x15 #define BUSY 0x60 #define NSTEPS 1000 #define STEP(i,n) (NSTEPS * (i) / (n)) typedef struct divesystem_idive_command_t { unsigned char cmd; unsigned int size; } divesystem_idive_command_t; typedef struct divesystem_idive_commands_t { divesystem_idive_command_t id; divesystem_idive_command_t range; divesystem_idive_command_t header; divesystem_idive_command_t sample; } divesystem_idive_commands_t; typedef struct divesystem_idive_device_t { dc_device_t base; dc_serial_t *port; unsigned char fingerprint[4]; unsigned int model; } divesystem_idive_device_t; static dc_status_t divesystem_idive_device_set_fingerprint (dc_device_t *abstract, const unsigned char data[], unsigned int size); static dc_status_t divesystem_idive_device_foreach (dc_device_t *abstract, dc_dive_callback_t callback, void *userdata); static dc_status_t divesystem_idive_device_close (dc_device_t *abstract); static const dc_device_vtable_t divesystem_idive_device_vtable = { sizeof(divesystem_idive_device_t), DC_FAMILY_DIVESYSTEM_IDIVE, divesystem_idive_device_set_fingerprint, /* set_fingerprint */ NULL, /* read */ NULL, /* write */ NULL, /* dump */ divesystem_idive_device_foreach, /* foreach */ divesystem_idive_device_close /* close */ }; static const divesystem_idive_commands_t idive = { {0x10, 0x0A}, {0x98, 0x04}, {0xA0, 0x32}, {0xA8, 0x2A}, }; static const divesystem_idive_commands_t ix3m = { {0x11, 0x1A}, {0x78, 0x04}, {0x79, 0x36}, {0x7A, 0x36}, }; dc_status_t divesystem_idive_device_open (dc_device_t **out, dc_context_t *context, const char *name) { return divesystem_idive_device_open2 (out, context, name, 0); } dc_status_t divesystem_idive_device_open2 (dc_device_t **out, dc_context_t *context, const char *name, unsigned int model) { dc_status_t status = DC_STATUS_SUCCESS; divesystem_idive_device_t *device = NULL; if (out == NULL) return DC_STATUS_INVALIDARGS; // Allocate memory. device = (divesystem_idive_device_t *) dc_device_allocate (context, &divesystem_idive_device_vtable); if (device == NULL) { ERROR (context, "Failed to allocate memory."); return DC_STATUS_NOMEMORY; } // Set the default values. device->port = NULL; memset (device->fingerprint, 0, sizeof (device->fingerprint)); device->model = model; // Open the device. status = dc_serial_open (&device->port, context, name); if (status != DC_STATUS_SUCCESS) { ERROR (context, "Failed to open the serial port."); goto error_free; } // Set the serial communication protocol (115200 8N1). status = dc_serial_configure (device->port, 115200, 8, DC_PARITY_NONE, DC_STOPBITS_ONE, DC_FLOWCONTROL_NONE); if (status != DC_STATUS_SUCCESS) { ERROR (context, "Failed to set the terminal attributes."); goto error_close; } // Set the timeout for receiving data (1000ms). status = dc_serial_set_timeout (device->port, 1000); if (status != DC_STATUS_SUCCESS) { ERROR (context, "Failed to set the timeout."); goto error_close; } // Make sure everything is in a sane state. dc_serial_sleep (device->port, 300); dc_serial_purge (device->port, DC_DIRECTION_ALL); *out = (dc_device_t *) device; return DC_STATUS_SUCCESS; error_close: dc_serial_close (device->port); error_free: dc_device_deallocate ((dc_device_t *) device); return status; } static dc_status_t divesystem_idive_device_close (dc_device_t *abstract) { dc_status_t status = DC_STATUS_SUCCESS; divesystem_idive_device_t *device = (divesystem_idive_device_t*) abstract; dc_status_t rc = DC_STATUS_SUCCESS; // Close the device. rc = dc_serial_close (device->port); if (rc != DC_STATUS_SUCCESS) { dc_status_set_error(&status, rc); } return status; } static dc_status_t divesystem_idive_device_set_fingerprint (dc_device_t *abstract, const unsigned char data[], unsigned int size) { divesystem_idive_device_t *device = (divesystem_idive_device_t *) abstract; if (size && size != sizeof (device->fingerprint)) return DC_STATUS_INVALIDARGS; if (size) memcpy (device->fingerprint, data, sizeof (device->fingerprint)); else memset (device->fingerprint, 0, sizeof (device->fingerprint)); return DC_STATUS_SUCCESS; } static dc_status_t divesystem_idive_send (divesystem_idive_device_t *device, const unsigned char command[], unsigned int csize) { dc_status_t status = DC_STATUS_SUCCESS; dc_device_t *abstract = (dc_device_t *) device; unsigned char packet[MAXPACKET + 4]; unsigned short crc = 0; if (device_is_cancelled (abstract)) return DC_STATUS_CANCELLED; if (csize < 1 || csize > MAXPACKET) return DC_STATUS_INVALIDARGS; // Setup the data packet packet[0] = START; packet[1] = csize; memcpy(packet + 2, command, csize); crc = checksum_crc_ccitt_uint16 (packet, csize + 2); packet[csize + 2] = (crc >> 8) & 0xFF; packet[csize + 3] = (crc ) & 0xFF; // Send the data packet. status = dc_serial_write (device->port, packet, csize + 4, NULL); if (status != DC_STATUS_SUCCESS) { ERROR (abstract->context, "Failed to send the command."); return status; } return DC_STATUS_SUCCESS; } static dc_status_t divesystem_idive_receive (divesystem_idive_device_t *device, unsigned char answer[], unsigned int *asize) { dc_status_t status = DC_STATUS_SUCCESS; dc_device_t *abstract = (dc_device_t *) device; unsigned char packet[MAXPACKET + 4]; if (asize == NULL || *asize < MAXPACKET) { ERROR (abstract->context, "Invalid arguments."); return DC_STATUS_INVALIDARGS; } // Read the packet start byte. while (1) { status = dc_serial_read (device->port, packet + 0, 1, NULL); if (status != DC_STATUS_SUCCESS) { ERROR (abstract->context, "Failed to receive the packet start byte."); return status; } if (packet[0] == START) break; } // Read the packet length. status = dc_serial_read (device->port, packet + 1, 1, NULL); if (status != DC_STATUS_SUCCESS) { ERROR (abstract->context, "Failed to receive the packet length."); return status; } unsigned int len = packet[1]; if (len < 2 || len > MAXPACKET) { ERROR (abstract->context, "Invalid packet length."); return DC_STATUS_PROTOCOL; } // Read the packet payload and checksum. status = dc_serial_read (device->port, packet + 2, len + 2, NULL); if (status != DC_STATUS_SUCCESS) { ERROR (abstract->context, "Failed to receive the packet payload and checksum."); return status; } // Verify the checksum. unsigned short crc = array_uint16_be (packet + len + 2); unsigned short ccrc = checksum_crc_ccitt_uint16 (packet, len + 2); if (crc != ccrc) { ERROR (abstract->context, "Unexpected packet checksum."); return DC_STATUS_PROTOCOL; } memcpy(answer, packet + 2, len); *asize = len; return DC_STATUS_SUCCESS; } static dc_status_t divesystem_idive_transfer (divesystem_idive_device_t *device, const unsigned char command[], unsigned int csize, unsigned char answer[], unsigned int asize) { dc_status_t rc = DC_STATUS_SUCCESS; dc_device_t *abstract = (dc_device_t *) device; unsigned char packet[MAXPACKET] = {0}; unsigned int length = 0; unsigned int nretries = 0; while (1) { // Send the command. rc = divesystem_idive_send (device, command, csize); if (rc != DC_STATUS_SUCCESS) return rc; // Receive the answer. length = sizeof(packet); rc = divesystem_idive_receive (device, packet, &length); if (rc != DC_STATUS_SUCCESS) return rc; // Verify the command byte. if (packet[0] != command[0]) { ERROR (abstract->context, "Unexpected packet header."); return DC_STATUS_PROTOCOL; } // Check the ACK byte. if (packet[length - 1] == ACK) break; // Verify the NAK byte. if (packet[length - 1] != NAK) { ERROR (abstract->context, "Unexpected ACK/NAK byte."); return DC_STATUS_PROTOCOL; } // Verify the length of the packet. if (length != 3) { ERROR (abstract->context, "Unexpected packet length."); return DC_STATUS_PROTOCOL; } // Verify the error code. unsigned int errcode = packet[1]; if (errcode != BUSY) { ERROR (abstract->context, "Received NAK packet with error code %02x.", errcode); return DC_STATUS_PROTOCOL; } // Abort if the maximum number of retries is reached. if (nretries++ >= MAXRETRIES) return DC_STATUS_PROTOCOL; // Delay the next attempt. dc_serial_sleep(device->port, 100); } // Verify the length of the packet. if (asize != length - 2) { ERROR (abstract->context, "Unexpected packet length."); return DC_STATUS_PROTOCOL; } memcpy(answer, packet + 1, length - 2); return DC_STATUS_SUCCESS; } static dc_status_t divesystem_idive_device_foreach (dc_device_t *abstract, dc_dive_callback_t callback, void *userdata) { dc_status_t rc = DC_STATUS_SUCCESS; divesystem_idive_device_t *device = (divesystem_idive_device_t *) abstract; unsigned char packet[MAXPACKET - 2]; const divesystem_idive_commands_t *commands = &idive; if (device->model >= IX3M_EASY && device->model <= IX3M_REB) { commands = &ix3m; } // Enable progress notifications. dc_event_progress_t progress = EVENT_PROGRESS_INITIALIZER; device_event_emit (abstract, DC_EVENT_PROGRESS, &progress); unsigned char cmd_id[] = {commands->id.cmd, 0xED}; rc = divesystem_idive_transfer (device, cmd_id, sizeof(cmd_id), packet, commands->id.size); if (rc != DC_STATUS_SUCCESS) return rc; // Emit a device info event. dc_event_devinfo_t devinfo; devinfo.model = array_uint16_le (packet); devinfo.firmware = 0; devinfo.serial = array_uint32_le (packet + 6); device_event_emit (abstract, DC_EVENT_DEVINFO, &devinfo); // Emit a vendor event. dc_event_vendor_t vendor; vendor.data = packet; vendor.size = commands->id.size; device_event_emit (abstract, DC_EVENT_VENDOR, &vendor); unsigned char cmd_range[] = {commands->range.cmd, 0x8D}; rc = divesystem_idive_transfer (device, cmd_range, sizeof(cmd_range), packet, commands->range.size); if (rc != DC_STATUS_SUCCESS) return rc; // Get the range of the available dive numbers. unsigned int first = array_uint16_le (packet + 0); unsigned int last = array_uint16_le (packet + 2); if (first > last) { ERROR(abstract->context, "Invalid dive numbers."); return DC_STATUS_DATAFORMAT; } // Calculate the number of dives. unsigned int ndives = last - first + 1; // Update and emit a progress event. progress.maximum = ndives * NSTEPS; device_event_emit (abstract, DC_EVENT_PROGRESS, &progress); dc_buffer_t *buffer = dc_buffer_new(0); if (buffer == NULL) { return DC_STATUS_NOMEMORY; } for (unsigned int i = 0; i < ndives; ++i) { unsigned int number = last - i; unsigned char cmd_header[] = {commands->header.cmd, (number ) & 0xFF, (number >> 8) & 0xFF}; rc = divesystem_idive_transfer (device, cmd_header, sizeof(cmd_header), packet, commands->header.size); if (rc != DC_STATUS_SUCCESS) return rc; if (memcmp(packet + 7, device->fingerprint, sizeof(device->fingerprint)) == 0) break; unsigned int nsamples = array_uint16_le (packet + 1); // Update and emit a progress event. progress.current = i * NSTEPS + STEP(1, nsamples + 1); device_event_emit (abstract, DC_EVENT_PROGRESS, &progress); dc_buffer_clear(buffer); dc_buffer_reserve(buffer, commands->header.size + commands->sample.size * nsamples); dc_buffer_append(buffer, packet, commands->header.size); for (unsigned int j = 0; j < nsamples; ++j) { unsigned int idx = j + 1; unsigned char cmd_sample[] = {commands->sample.cmd, (idx ) & 0xFF, (idx >> 8) & 0xFF}; rc = divesystem_idive_transfer (device, cmd_sample, sizeof(cmd_sample), packet, commands->sample.size); if (rc != DC_STATUS_SUCCESS) return rc; // Update and emit a progress event. progress.current = i * NSTEPS + STEP(j + 2, nsamples + 1); device_event_emit (abstract, DC_EVENT_PROGRESS, &progress); dc_buffer_append(buffer, packet, commands->sample.size); } unsigned char *data = dc_buffer_get_data(buffer); unsigned int size = dc_buffer_get_size(buffer); if (callback && !callback (data, size, data + 7, sizeof(device->fingerprint), userdata)) { dc_buffer_free (buffer); return DC_STATUS_SUCCESS; } } dc_buffer_free(buffer); return DC_STATUS_SUCCESS; }