8a34d822ff
Rough merge of upstream libdivecomputer. This is mainly about making the new iostream code upstream, although we don't actually use it. It abstracts out the the old serial and usbhid code, but we end up still using our own 'custom_io' interface because the iostream code doesn't do it right. * jef/master: Correctly determine git SHA if libdivecomputer is a git submodule Don't accept a NULL pointer as parameter Add support for semi-closed circuit diving Detect dives with invalid profile data Implement the serial communication functions as no-ops Move the socket code to a common file Add support for a custom I/O implementation Port the USB HID code to the new I/O interface Port the bluetooth code to the new I/O interface Port the IrDA code to the new I/O interface Port the serial code to the new I/O interface Add a new abstract I/O interface Post release version bump to 0.7.0
72 lines
3.0 KiB
C
72 lines
3.0 KiB
C
#ifndef CUSTOM_IO_H
|
|
#define CUSTOM_IO_H
|
|
|
|
#include <libdivecomputer/iostream.h>
|
|
|
|
#include "common.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
struct dc_context_t;
|
|
struct dc_user_device_t;
|
|
|
|
/*
|
|
* Two different pointers to user-supplied data.
|
|
*
|
|
* The 'userdata' pointer is for the IO routines themselves,
|
|
* generally filled in by the 'xyz_open()' routine with whatever
|
|
* file descriptor etc information.
|
|
*
|
|
* The 'user_device' pointer is set when registering the
|
|
* custom IO with the download context, and has whatever
|
|
* data the downloader needs.
|
|
*
|
|
* The two are very different. The userdata is "per instance",
|
|
* and when nesting custom IO handlers, each level would
|
|
* generally have its own userdata, that would be specific
|
|
* to that particular set of IO routines.
|
|
*
|
|
* In contrast, the user_device is filled in when the
|
|
* download context is created, before open() is even called,
|
|
* and isn't specific to the IO routines, but to the download
|
|
* as a whole.
|
|
*/
|
|
typedef struct dc_custom_io_t
|
|
{
|
|
void *userdata;
|
|
struct dc_user_device_t *user_device;
|
|
|
|
// Custom serial (generally BT rfcomm)
|
|
dc_status_t (*serial_open) (struct dc_custom_io_t *io, struct dc_context_t *, const char *name);
|
|
dc_status_t (*serial_close) (struct dc_custom_io_t *io);
|
|
dc_status_t (*serial_read) (struct dc_custom_io_t *io, void* data, size_t size, size_t *actual);
|
|
dc_status_t (*serial_write) (struct dc_custom_io_t *io, const void* data, size_t size, size_t *actual);
|
|
dc_status_t (*serial_purge) (struct dc_custom_io_t *io, dc_direction_t);
|
|
dc_status_t (*serial_get_available) (struct dc_custom_io_t *io, size_t *value);
|
|
dc_status_t (*serial_set_timeout) (struct dc_custom_io_t *io, long timeout);
|
|
dc_status_t (*serial_configure) (struct dc_custom_io_t *io, unsigned int baudrate, unsigned int databits, dc_parity_t parity, dc_stopbits_t stopbits, dc_flowcontrol_t flowcontrol);
|
|
dc_status_t (*serial_set_dtr) (struct dc_custom_io_t *io, int level);
|
|
dc_status_t (*serial_set_rts) (struct dc_custom_io_t *io, int level);
|
|
dc_status_t (*serial_set_halfduplex) (struct dc_custom_io_t *io, unsigned int value);
|
|
dc_status_t (*serial_set_break) (struct dc_custom_io_t *io, unsigned int level);
|
|
//dc_serial_set_latency (dc_serial_t *device, unsigned int milliseconds) - Unused
|
|
//dc_serial_get_lines (dc_serial_t *device, unsigned int *value) - Unused
|
|
//dc_serial_flush (dc_serial_t *device) - No device interaction
|
|
//dc_serial_sleep (dc_serial_t *device, unsigned int timeout) - No device interaction
|
|
|
|
// Custom packet transfer (generally BLE GATT)
|
|
int packet_size;
|
|
dc_status_t (*packet_open) (struct dc_custom_io_t *, struct dc_context_t *, const char *);
|
|
dc_status_t (*packet_close) (struct dc_custom_io_t *);
|
|
dc_status_t (*packet_read) (struct dc_custom_io_t *, void* data, size_t size, size_t *actual);
|
|
dc_status_t (*packet_write) (struct dc_custom_io_t *, const void* data, size_t size, size_t *actual);
|
|
} dc_custom_io_t;
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif /* CUSTOM_IO_H */
|