mirror of
https://github.com/STMicroelectronics/stm32-mw-usb-device.git
synced 2026-02-09 04:25:36 -05:00
199 lines
5.0 KiB
C
199 lines
5.0 KiB
C
/**
|
|
******************************************************************************
|
|
* @file usbd_customhid.h
|
|
* @author MCD Application Team
|
|
* @brief header file for the usbd_customhid.c file.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2015 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef __USB_CUSTOMHID_H
|
|
#define __USB_CUSTOMHID_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "usbd_ioreq.h"
|
|
|
|
/** @addtogroup STM32_USB_DEVICE_LIBRARY
|
|
* @{
|
|
*/
|
|
|
|
/** @defgroup USBD_CUSTOM_HID
|
|
* @brief This file is the Header file for USBD_customhid.c
|
|
* @{
|
|
*/
|
|
|
|
|
|
/** @defgroup USBD_CUSTOM_HID_Exported_Defines
|
|
* @{
|
|
*/
|
|
#ifndef CUSTOM_HID_EPIN_ADDR
|
|
#define CUSTOM_HID_EPIN_ADDR 0x81U
|
|
#endif /* CUSTOM_HID_EPIN_ADDR */
|
|
|
|
#ifndef CUSTOM_HID_EPIN_SIZE
|
|
#define CUSTOM_HID_EPIN_SIZE 0x02U
|
|
#endif /* CUSTOM_HID_EPIN_SIZE */
|
|
|
|
#ifndef CUSTOM_HID_EPOUT_ADDR
|
|
#define CUSTOM_HID_EPOUT_ADDR 0x01U
|
|
#endif /* CUSTOM_HID_EPOUT_ADDR */
|
|
|
|
#ifndef CUSTOM_HID_EPOUT_SIZE
|
|
#define CUSTOM_HID_EPOUT_SIZE 0x02U
|
|
#endif /* CUSTOM_HID_EPOUT_SIZE*/
|
|
|
|
#define USB_CUSTOM_HID_CONFIG_DESC_SIZ 41U
|
|
#define USB_CUSTOM_HID_DESC_SIZ 9U
|
|
|
|
#ifndef CUSTOM_HID_HS_BINTERVAL
|
|
#define CUSTOM_HID_HS_BINTERVAL 0x05U
|
|
#endif /* CUSTOM_HID_HS_BINTERVAL */
|
|
|
|
#ifndef CUSTOM_HID_FS_BINTERVAL
|
|
#define CUSTOM_HID_FS_BINTERVAL 0x05U
|
|
#endif /* CUSTOM_HID_FS_BINTERVAL */
|
|
|
|
#ifndef USBD_CUSTOMHID_OUTREPORT_BUF_SIZE
|
|
#define USBD_CUSTOMHID_OUTREPORT_BUF_SIZE 0x02U
|
|
#endif /* USBD_CUSTOMHID_OUTREPORT_BUF_SIZE */
|
|
|
|
#ifndef USBD_CUSTOM_HID_REPORT_DESC_SIZE
|
|
#define USBD_CUSTOM_HID_REPORT_DESC_SIZE 163U
|
|
#endif /* USBD_CUSTOM_HID_REPORT_DESC_SIZE */
|
|
|
|
#define CUSTOM_HID_DESCRIPTOR_TYPE 0x21U
|
|
#define CUSTOM_HID_REPORT_DESC 0x22U
|
|
|
|
#define CUSTOM_HID_REQ_SET_PROTOCOL 0x0BU
|
|
#define CUSTOM_HID_REQ_GET_PROTOCOL 0x03U
|
|
|
|
#define CUSTOM_HID_REQ_SET_IDLE 0x0AU
|
|
#define CUSTOM_HID_REQ_GET_IDLE 0x02U
|
|
|
|
#define CUSTOM_HID_REQ_SET_REPORT 0x09U
|
|
#define CUSTOM_HID_REQ_GET_REPORT 0x01U
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/** @defgroup USBD_CORE_Exported_TypesDefinitions
|
|
* @{
|
|
*/
|
|
typedef enum
|
|
{
|
|
CUSTOM_HID_IDLE = 0U,
|
|
CUSTOM_HID_BUSY,
|
|
} CUSTOM_HID_StateTypeDef;
|
|
|
|
typedef struct _USBD_CUSTOM_HID_Itf
|
|
{
|
|
uint8_t *pReport;
|
|
int8_t (* Init)(void);
|
|
int8_t (* DeInit)(void);
|
|
int8_t (* OutEvent)(uint8_t event_idx, uint8_t state);
|
|
#ifdef USBD_CUSTOMHID_CTRL_REQ_COMPLETE_CALLBACK_ENABLED
|
|
int8_t (* CtrlReqComplete)(uint8_t request, uint16_t wLength);
|
|
#endif /* USBD_CUSTOMHID_CTRL_REQ_COMPLETE_CALLBACK_ENABLED */
|
|
#ifdef USBD_CUSTOMHID_CTRL_REQ_GET_REPORT_ENABLED
|
|
uint8_t *(* GetReport)(uint16_t *ReportLength);
|
|
#endif /* USBD_CUSTOMHID_CTRL_REQ_GET_REPORT_ENABLED */
|
|
} USBD_CUSTOM_HID_ItfTypeDef;
|
|
|
|
typedef struct
|
|
{
|
|
uint8_t Report_buf[USBD_CUSTOMHID_OUTREPORT_BUF_SIZE];
|
|
uint32_t Protocol;
|
|
uint32_t IdleState;
|
|
uint32_t AltSetting;
|
|
uint32_t IsReportAvailable;
|
|
CUSTOM_HID_StateTypeDef state;
|
|
} USBD_CUSTOM_HID_HandleTypeDef;
|
|
|
|
/*
|
|
* HID Class specification version 1.1
|
|
* 6.2.1 HID Descriptor
|
|
*/
|
|
|
|
typedef struct
|
|
{
|
|
uint8_t bLength;
|
|
uint8_t bDescriptorTypeCHID;
|
|
uint16_t bcdCUSTOM_HID;
|
|
uint8_t bCountryCode;
|
|
uint8_t bNumDescriptors;
|
|
uint8_t bDescriptorType;
|
|
uint16_t wItemLength;
|
|
} __PACKED USBD_DescTypeDef;
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
|
|
/** @defgroup USBD_CORE_Exported_Macros
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup USBD_CORE_Exported_Variables
|
|
* @{
|
|
*/
|
|
|
|
extern USBD_ClassTypeDef USBD_CUSTOM_HID;
|
|
#define USBD_CUSTOM_HID_CLASS &USBD_CUSTOM_HID
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup USB_CORE_Exported_Functions
|
|
* @{
|
|
*/
|
|
#ifdef USE_USBD_COMPOSITE
|
|
uint8_t USBD_CUSTOM_HID_SendReport(USBD_HandleTypeDef *pdev,
|
|
uint8_t *report, uint16_t len, uint8_t ClassId);
|
|
#else
|
|
uint8_t USBD_CUSTOM_HID_SendReport(USBD_HandleTypeDef *pdev,
|
|
uint8_t *report, uint16_t len);
|
|
#endif /* USE_USBD_COMPOSITE */
|
|
uint8_t USBD_CUSTOM_HID_ReceivePacket(USBD_HandleTypeDef *pdev);
|
|
|
|
uint8_t USBD_CUSTOM_HID_RegisterInterface(USBD_HandleTypeDef *pdev,
|
|
USBD_CUSTOM_HID_ItfTypeDef *fops);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __USB_CUSTOMHID_H */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|