139 lines
3.3 KiB
C
139 lines
3.3 KiB
C
|
/**
|
|||
|
|
* @file UsbDevice.h
|
|||
|
|
* @brief USB设备抽象接口定义
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
#ifndef USB2CAN_USB_DEVICE_H
|
|||
|
|
#define USB2CAN_USB_DEVICE_H
|
|||
|
|
|
|||
|
|
#include <string>
|
|||
|
|
#include <vector>
|
|||
|
|
#include <cstdint>
|
|||
|
|
|
|||
|
|
#include "../platform/Platform.h"
|
|||
|
|
|
|||
|
|
namespace usb2can {
|
|||
|
|
namespace usb {
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief USB设备信息结构体
|
|||
|
|
*/
|
|||
|
|
struct UsbDeviceInfo {
|
|||
|
|
uint16_t vendorId; ///< 供应商ID
|
|||
|
|
uint16_t productId; ///< 产品ID
|
|||
|
|
std::string manufacturer; ///< 制造商
|
|||
|
|
std::string productName; ///< 产品名称
|
|||
|
|
std::string serialNumber; ///< 序列号
|
|||
|
|
std::string devicePath; ///< 设备路径
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief USB设备抽象接口类
|
|||
|
|
*/
|
|||
|
|
class UsbDevice {
|
|||
|
|
public:
|
|||
|
|
virtual ~UsbDevice() = default;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 打开USB设备
|
|||
|
|
* @param devicePath 设备路径
|
|||
|
|
* @return 操作成功返回true，否则返回false
|
|||
|
|
*/
|
|||
|
|
virtual bool open(const std::string& devicePath) = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 关闭USB设备
|
|||
|
|
*/
|
|||
|
|
virtual void close() = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 检查设备是否已打开
|
|||
|
|
* @return 设备已打开返回true，否则返回false
|
|||
|
|
*/
|
|||
|
|
virtual bool isOpen() const = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 写入数据
|
|||
|
|
* @param data 数据缓冲区
|
|||
|
|
* @param size 数据大小
|
|||
|
|
* @param timeout 超时时间（毫秒）
|
|||
|
|
* @return 实际写入的字节数，失败返回-1
|
|||
|
|
*/
|
|||
|
|
virtual int write(const uint8_t* data, size_t size, int timeout = 1000) = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 读取数据
|
|||
|
|
* @param data 数据缓冲区
|
|||
|
|
* @param size 数据大小
|
|||
|
|
* @param timeout 超时时间（毫秒）
|
|||
|
|
* @return 实际读取的字节数，失败返回-1
|
|||
|
|
*/
|
|||
|
|
virtual int read(uint8_t* data, size_t size, int timeout = 1000) = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取设备信息
|
|||
|
|
* @param[out] info 设备信息
|
|||
|
|
* @return 操作成功返回true，否则返回false
|
|||
|
|
*/
|
|||
|
|
virtual bool getDeviceInfo(UsbDeviceInfo& info) = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取设备路径
|
|||
|
|
* @return 设备路径
|
|||
|
|
*/
|
|||
|
|
virtual std::string getDevicePath() const = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 创建USB设备实例
|
|||
|
|
* @param platform 平台实例
|
|||
|
|
* @return USB设备实例
|
|||
|
|
*/
|
|||
|
|
static UsbDevice* createUsbDevice(platform::Platform* platform);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief USB设备管理器类
|
|||
|
|
*/
|
|||
|
|
class UsbDeviceManager {
|
|||
|
|
public:
|
|||
|
|
/**
|
|||
|
|
* @brief 构造函数
|
|||
|
|
* @param platform 平台实例
|
|||
|
|
*/
|
|||
|
|
explicit UsbDeviceManager(platform::Platform* platform);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 析构函数
|
|||
|
|
*/
|
|||
|
|
~UsbDeviceManager();
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 扫描USB设备
|
|||
|
|
* @param vendorId 供应商ID，0表示匹配所有供应商
|
|||
|
|
* @param productId 产品ID，0表示匹配所有产品
|
|||
|
|
* @return USB设备信息列表
|
|||
|
|
*/
|
|||
|
|
std::vector<UsbDeviceInfo> scanDevices(uint16_t vendorId = 0, uint16_t productId = 0);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 打开USB设备
|
|||
|
|
* @param devicePath 设备路径
|
|||
|
|
* @return USB设备实例，失败返回nullptr
|
|||
|
|
*/
|
|||
|
|
UsbDevice* openDevice(const std::string& devicePath);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 关闭USB设备
|
|||
|
|
* @param device USB设备实例
|
|||
|
|
*/
|
|||
|
|
void closeDevice(UsbDevice* device);
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
platform::Platform* platform_; ///< 平台实例
|
|||
|
|
std::vector<UsbDevice*> devices_; ///< 已打开的设备列表
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
} // namespace usb
|
|||
|
|
} // namespace usb2can
|
|||
|
|
|
|||
|
|
#endif // USB2CAN_USB_DEVICE_H
|