3d394c9262
When two or more identical (or very similar) dive computers are connected, the USB VID/PID can be ambiguous. That's because the VID/PID identifies the type of the USB device, and not the individual device. But each USB HID device descriptor returned by the device discovery represents a single connected device, and thus guarantees to open the correct USB device. To obtain the same behaviour as before, an application can simply open the first discovered device.
92 lines
2.5 KiB
C
92 lines
2.5 KiB
C
/*
|
|
* libdivecomputer
|
|
*
|
|
* Copyright (C) 2016 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
|
|
*/
|
|
|
|
#ifndef DC_USBHID_H
|
|
#define DC_USBHID_H
|
|
|
|
#include "common.h"
|
|
#include "context.h"
|
|
#include "iostream.h"
|
|
#include "iterator.h"
|
|
#include "descriptor.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/**
|
|
* Opaque object representing a USB HID device.
|
|
*/
|
|
typedef struct dc_usbhid_device_t dc_usbhid_device_t;
|
|
|
|
/**
|
|
* Get the vendor id (VID) of the USB HID device.
|
|
*
|
|
* @param[in] device A valid USB HID device.
|
|
*/
|
|
unsigned int
|
|
dc_usbhid_device_get_vid (dc_usbhid_device_t *device);
|
|
|
|
/**
|
|
* Get the product id (PID) of the USB HID device.
|
|
*
|
|
* @param[in] device A valid USB HID device.
|
|
*/
|
|
unsigned int
|
|
dc_usbhid_device_get_pid (dc_usbhid_device_t *device);
|
|
|
|
/**
|
|
* Destroy the USB HID device and free all resources.
|
|
*
|
|
* @param[in] device A valid USB HID device.
|
|
*/
|
|
void
|
|
dc_usbhid_device_free(dc_usbhid_device_t *device);
|
|
|
|
/**
|
|
* Create an iterator to enumerate the USB HID devices.
|
|
*
|
|
* @param[out] iterator A location to store the iterator.
|
|
* @param[in] context A valid context object.
|
|
* @param[in] descriptor A valid device descriptor or NULL.
|
|
* @returns #DC_STATUS_SUCCESS on success, or another #dc_status_t code
|
|
* on failure.
|
|
*/
|
|
dc_status_t
|
|
dc_usbhid_iterator_new (dc_iterator_t **iterator, dc_context_t *context, dc_descriptor_t *descriptor);
|
|
|
|
/**
|
|
* Open a USB HID connection.
|
|
*
|
|
* @param[out] iostream A location to store the USB HID connection.
|
|
* @param[in] context A valid context object.
|
|
* @param[in] device A valid USB HID device.
|
|
* @returns #DC_STATUS_SUCCESS on success, or another #dc_status_t code
|
|
* on failure.
|
|
*/
|
|
dc_status_t
|
|
dc_usbhid_open (dc_iostream_t **iostream, dc_context_t *context, dc_usbhid_device_t *device);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif /* DC_USBHID_H */
|