452 lines
14 KiB
C
452 lines
14 KiB
C
/**************************************************************************/
|
|
/*!
|
|
@file hid_device.c
|
|
@author hathach (tinyusb.org)
|
|
|
|
@section LICENSE
|
|
|
|
Software License Agreement (BSD License)
|
|
|
|
Copyright (c) 2013, hathach (tinyusb.org)
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
1. Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
2. Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
3. Neither the name of the copyright holders nor the
|
|
names of its contributors may be used to endorse or promote products
|
|
derived from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
|
|
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY
|
|
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
This file is part of the tinyusb stack.
|
|
*/
|
|
/**************************************************************************/
|
|
|
|
#include "tusb_option.h"
|
|
|
|
#if (MODE_DEVICE_SUPPORTED && DEVICE_CLASS_HID)
|
|
|
|
#define _TINY_USB_SOURCE_FILE_
|
|
//--------------------------------------------------------------------+
|
|
// INCLUDE
|
|
//--------------------------------------------------------------------+
|
|
#include "common/common.h"
|
|
#include "hid_device.h"
|
|
#include "tusb_descriptors.h"
|
|
|
|
//--------------------------------------------------------------------+
|
|
// MACRO CONSTANT TYPEDEF
|
|
//--------------------------------------------------------------------+
|
|
ATTR_USB_MIN_ALIGNMENT uint8_t set_report[ MAX_OF(sizeof(hid_keyboard_report_t), sizeof(hid_mouse_report_t)) ];
|
|
|
|
typedef struct {
|
|
uint8_t const * p_report_desc;
|
|
uint16_t report_length;
|
|
|
|
endpoint_handle_t ept_handle;
|
|
uint8_t interface_number;
|
|
}hidd_interface_t;
|
|
|
|
|
|
//--------------------------------------------------------------------+
|
|
// KEYBOARD APPLICATION API
|
|
//--------------------------------------------------------------------+
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
STATIC_VAR TUSB_CFG_ATTR_USBRAM hidd_interface_t keyboardd_data =
|
|
{
|
|
.p_report_desc = app_tusb_keyboard_desc_report
|
|
};
|
|
|
|
bool tusbd_hid_keyboard_is_busy(uint8_t coreid)
|
|
{
|
|
return dcd_pipe_is_busy(keyboardd_data.ept_handle);
|
|
}
|
|
|
|
tusb_error_t tusbd_hid_keyboard_send(uint8_t coreid, hid_keyboard_report_t const *p_report)
|
|
{
|
|
ASSERT(tusbd_is_configured(coreid), TUSB_ERROR_USBD_DEVICE_NOT_CONFIGURED);
|
|
|
|
hidd_interface_t * p_kbd = &keyboardd_data; // TODO &keyboardd_data[coreid];
|
|
|
|
ASSERT_STATUS( dcd_pipe_xfer(p_kbd->ept_handle, p_report, sizeof(hid_keyboard_report_t), false) ) ;
|
|
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
#endif
|
|
|
|
//--------------------------------------------------------------------+
|
|
// MOUSE APPLICATION API
|
|
//--------------------------------------------------------------------+
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
STATIC_VAR TUSB_CFG_ATTR_USBRAM hidd_interface_t moused_data =
|
|
{
|
|
.p_report_desc = app_tusb_mouse_desc_report
|
|
};
|
|
|
|
bool tusbd_hid_mouse_is_busy(uint8_t coreid)
|
|
{
|
|
return dcd_pipe_is_busy(moused_data.ept_handle);
|
|
}
|
|
|
|
tusb_error_t tusbd_hid_mouse_send(uint8_t coreid, hid_mouse_report_t const *p_report)
|
|
{
|
|
ASSERT(tusbd_is_configured(coreid), TUSB_ERROR_USBD_DEVICE_NOT_CONFIGURED);
|
|
|
|
hidd_interface_t * p_mouse = &moused_data; // TODO &keyboardd_data[coreid];
|
|
|
|
ASSERT_STATUS( dcd_pipe_xfer(p_mouse->ept_handle, p_report, sizeof(hid_mouse_report_t), false) ) ;
|
|
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
//--------------------------------------------------------------------+
|
|
// USBD-CLASS API
|
|
//--------------------------------------------------------------------+
|
|
void hidd_init(void)
|
|
{
|
|
// TODO not implemented yet
|
|
}
|
|
|
|
void hidd_close(uint8_t coreid)
|
|
{
|
|
// TODO not implemented yet
|
|
}
|
|
|
|
tusb_error_t hidd_control_request(uint8_t coreid, tusb_control_request_t const * p_request)
|
|
{
|
|
hidd_interface_t* p_hid =
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
(p_request->wIndex == keyboardd_data.interface_number) ? &keyboardd_data :
|
|
#endif
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
(p_request->wIndex == moused_data.interface_number) ? &moused_data :
|
|
#endif
|
|
NULL;
|
|
|
|
ASSERT_PTR(p_hid, TUSB_ERROR_FAILED);
|
|
|
|
//------------- STD Request -------------//
|
|
if (p_request->bmRequestType_bit.type == TUSB_REQUEST_TYPE_STANDARD)
|
|
{
|
|
uint8_t const desc_type = u16_high_u8(p_request->wValue);
|
|
uint8_t const desc_index = u16_low_u8 (p_request->wValue);
|
|
|
|
(void) desc_index;
|
|
|
|
ASSERT ( p_request->bRequest == TUSB_REQUEST_GET_DESCRIPTOR && desc_type == HID_DESC_TYPE_REPORT,
|
|
TUSB_ERROR_DCD_CONTROL_REQUEST_NOT_SUPPORT);
|
|
|
|
dcd_pipe_control_xfer(coreid, TUSB_DIR_DEV_TO_HOST, p_hid->p_report_desc, p_hid->report_length);
|
|
}
|
|
//------------- Class Specific Request -------------//
|
|
else if (p_request->bmRequestType_bit.type == TUSB_REQUEST_TYPE_CLASS)
|
|
{
|
|
switch(p_request->bRequest)
|
|
{
|
|
case HID_REQUEST_CONTROL_SET_IDLE:
|
|
// idle_rate = u16_high_u8(p_request->wValue);
|
|
break;
|
|
|
|
case HID_REQUEST_CONTROL_SET_REPORT:
|
|
{
|
|
return TUSB_ERROR_DCD_CONTROL_REQUEST_NOT_SUPPORT; // TODO test STALL control out endpoint (with mouse+keyboard)
|
|
|
|
// TODO HIDD set report support
|
|
hid_request_report_type_t report_type = u16_high_u8(p_request->wValue);
|
|
uint8_t report_id = u16_low_u8(p_request->wValue);
|
|
|
|
(void) report_id;
|
|
(void) report_type;
|
|
|
|
dcd_pipe_control_xfer(coreid, TUSB_DIR_HOST_TO_DEV, &set_report, p_request->wLength);
|
|
}
|
|
break;
|
|
|
|
case HID_REQUEST_CONTROL_GET_IDLE:
|
|
case HID_REQUEST_CONTROL_GET_REPORT:
|
|
case HID_REQUEST_CONTROL_GET_PROTOCOL:
|
|
case HID_REQUEST_CONTROL_SET_PROTOCOL:
|
|
default:
|
|
return TUSB_ERROR_DCD_CONTROL_REQUEST_NOT_SUPPORT;
|
|
}
|
|
}else
|
|
{
|
|
return TUSB_ERROR_DCD_CONTROL_REQUEST_NOT_SUPPORT;
|
|
}
|
|
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
|
|
tusb_error_t hidd_open(uint8_t coreid, tusb_descriptor_interface_t const * p_interface_desc, uint16_t *p_length)
|
|
{
|
|
uint8_t const *p_desc = (uint8_t const *) p_interface_desc;
|
|
|
|
//------------- HID descriptor -------------//
|
|
p_desc += p_desc[DESCRIPTOR_OFFSET_LENGTH];
|
|
tusb_hid_descriptor_hid_t const *p_desc_hid = (tusb_hid_descriptor_hid_t const *) p_desc;
|
|
ASSERT_INT(HID_DESC_TYPE_HID, p_desc_hid->bDescriptorType, TUSB_ERROR_HIDD_DESCRIPTOR_INTERFACE);
|
|
|
|
//------------- Endpoint Descriptor -------------//
|
|
p_desc += p_desc[DESCRIPTOR_OFFSET_LENGTH];
|
|
tusb_descriptor_endpoint_t const *p_desc_endpoint = (tusb_descriptor_endpoint_t const *) p_desc;
|
|
ASSERT_INT(TUSB_DESC_TYPE_ENDPOINT, p_desc_endpoint->bDescriptorType, TUSB_ERROR_HIDD_DESCRIPTOR_INTERFACE);
|
|
|
|
if (p_interface_desc->bInterfaceSubClass == HID_SUBCLASS_BOOT)
|
|
{
|
|
switch(p_interface_desc->bInterfaceProtocol)
|
|
{
|
|
case HID_PROTOCOL_KEYBOARD:
|
|
case HID_PROTOCOL_MOUSE:
|
|
{
|
|
hidd_interface_t* p_hid =
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
(p_interface_desc->bInterfaceProtocol == HID_PROTOCOL_KEYBOARD) ? &keyboardd_data :
|
|
#endif
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
(p_interface_desc->bInterfaceProtocol == HID_PROTOCOL_MOUSE) ? &moused_data :
|
|
#endif
|
|
NULL;
|
|
|
|
ASSERT_PTR(p_hid, TUSB_ERROR_FAILED);
|
|
|
|
p_hid->ept_handle = dcd_pipe_open(coreid, p_desc_endpoint, p_interface_desc->bInterfaceClass);
|
|
ASSERT( endpointhandle_is_valid(p_hid->ept_handle), TUSB_ERROR_DCD_FAILED);
|
|
|
|
p_hid->interface_number = p_interface_desc->bInterfaceNumber;
|
|
p_hid->report_length = p_desc_hid->wReportLength;
|
|
|
|
if (p_interface_desc->bInterfaceProtocol == HID_PROTOCOL_KEYBOARD)
|
|
{
|
|
tusbd_hid_keyboard_mounted_cb(coreid);
|
|
}else
|
|
{
|
|
tusbd_hid_mouse_mounted_cb(coreid);
|
|
}
|
|
}
|
|
break;
|
|
|
|
default: // TODO unknown, unsupported protocol --> skip this interface
|
|
return TUSB_ERROR_HIDD_DESCRIPTOR_INTERFACE;
|
|
}
|
|
*p_length = sizeof(tusb_descriptor_interface_t) + sizeof(tusb_hid_descriptor_hid_t) + sizeof(tusb_descriptor_endpoint_t);
|
|
}else
|
|
{
|
|
// open generic
|
|
*p_length = 0;
|
|
return TUSB_ERROR_HIDD_DESCRIPTOR_INTERFACE;
|
|
}
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
|
|
void hidd_isr(endpoint_handle_t edpt_hdl, tusb_event_t event, uint32_t xferred_bytes)
|
|
{
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
if ( endpointhandle_is_equal(edpt_hdl, keyboardd_data.ept_handle) )
|
|
{
|
|
tusbd_hid_keyboard_isr(edpt_hdl.coreid, event, xferred_bytes);
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
if ( endpointhandle_is_equal(edpt_hdl, moused_data.ept_handle) )
|
|
{
|
|
tusbd_hid_mouse_isr(edpt_hdl.coreid, event, xferred_bytes);
|
|
return;
|
|
}
|
|
#endif
|
|
}
|
|
|
|
#if defined(CAP_DEVICE_ROMDRIVER)
|
|
|
|
//--------------------------------------------------------------------+
|
|
// MACRO CONSTANT TYPEDEF
|
|
//--------------------------------------------------------------------+
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
TUSB_CFG_ATTR_USBRAM uint8_t hidd_keyboard_buffer[1024]; // TODO memory reduce
|
|
TUSB_CFG_ATTR_USBRAM hid_keyboard_report_t hid_keyboard_report;
|
|
static volatile bool bKeyChanged = false;
|
|
#endif
|
|
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
TUSB_CFG_ATTR_USBRAM uint8_t hidd_mouse_buffer[1024]; // TODO memory reduce
|
|
TUSB_CFG_ATTR_USBRAM hid_mouse_report_t hid_mouse_report;
|
|
static volatile bool bMouseChanged = false;
|
|
#endif
|
|
|
|
//--------------------------------------------------------------------+
|
|
// APPLICATION API
|
|
//--------------------------------------------------------------------+
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
tusb_error_t tusbd_hid_keyboard_send_report(hid_keyboard_report_t *p_kbd_report)
|
|
{
|
|
// uint32_t start_time = systickGetSecondsActive();
|
|
// while (bKeyChanged) // TODO blocking while previous key has yet sent - can use fifo to improve this
|
|
// {
|
|
// ASSERT_MESSAGE(systickGetSecondsActive() - start_time < 5, ERR_FAILED, "HID Keyboard Timeout");
|
|
// }
|
|
|
|
if (bKeyChanged)
|
|
{
|
|
return TUSB_ERROR_FAILED;
|
|
}
|
|
|
|
ASSERT_PTR(p_kbd_report, TUSB_ERROR_FAILED);
|
|
|
|
hid_keyboard_report = *p_kbd_report;
|
|
bKeyChanged = true;
|
|
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
#endif
|
|
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
tusb_error_t tusbd_hid_mouse_send_report(hid_mouse_report_t *p_mouse_report)
|
|
{
|
|
// uint32_t start_time = systickGetSecondsActive();
|
|
// while (bMouseChanged) // TODO Block while previous key hasn't been sent - can use fifo to improve this
|
|
// {
|
|
// ASSERT_MESSAGE(systickGetSecondsActive() - start_time < 5, ERR_FAILED, "HID Mouse Timeout");
|
|
// }
|
|
|
|
if (bMouseChanged)
|
|
{
|
|
return TUSB_ERROR_FAILED;
|
|
}
|
|
|
|
hid_mouse_report = *p_mouse_report;
|
|
bMouseChanged = true;
|
|
|
|
return TUSB_ERROR_NONE;
|
|
}
|
|
#endif
|
|
|
|
//--------------------------------------------------------------------+
|
|
// IMPLEMENTATION
|
|
//--------------------------------------------------------------------+
|
|
ErrorCode_t HID_GetReport( USBD_HANDLE_T hHid, USB_SETUP_PACKET* pSetup, uint8_t** pBuffer, uint16_t* plength)
|
|
{
|
|
USB_HID_CTRL_T* pHidCtrl = (USB_HID_CTRL_T*) hHid;
|
|
|
|
/* ReportID = SetupPacket.wValue.WB.L; */
|
|
if (pSetup->wValue.WB.H == HID_REQUEST_REPORT_INPUT)
|
|
return (ERR_USBD_STALL); /* Not Supported */
|
|
|
|
switch (pHidCtrl->protocol)
|
|
{
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
case HID_PROTOCOL_KEYBOARD:
|
|
*pBuffer = (uint8_t*) &hid_keyboard_report;
|
|
*plength = sizeof(hid_keyboard_report_t);
|
|
|
|
if (!bKeyChanged)
|
|
{
|
|
memset(pBuffer, 0, *plength);
|
|
}
|
|
bKeyChanged = false;
|
|
break;
|
|
#endif
|
|
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
case HID_PROTOCOL_MOUSE:
|
|
*pBuffer = (uint8_t*) &hid_mouse_report;
|
|
*plength = sizeof(hid_mouse_report_t);
|
|
|
|
if (!bMouseChanged)
|
|
{
|
|
memset(pBuffer, 0, *plength);
|
|
}
|
|
bMouseChanged = false;
|
|
break;
|
|
#endif
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return (LPC_OK);
|
|
}
|
|
|
|
ErrorCode_t HID_SetReport( USBD_HANDLE_T hHid, USB_SETUP_PACKET* pSetup, uint8_t** pBuffer, uint16_t length)
|
|
{
|
|
/* we will reuse standard EP0Buf */
|
|
if (length == 0)
|
|
return LPC_OK;
|
|
|
|
/* ReportID = SetupPacket.wValue.WB.L; */
|
|
if (pSetup->wValue.WB.H != HID_REQUEST_REPORT_OUTPUT)
|
|
return (ERR_USBD_STALL); /* Not Supported */
|
|
|
|
return (LPC_OK);
|
|
}
|
|
|
|
ErrorCode_t HID_EpIn_Hdlr (USBD_HANDLE_T hUsb, void* data, uint32_t event)
|
|
{
|
|
if (USB_EVT_IN == event)
|
|
{
|
|
USB_HID_CTRL_T* pHidCtrl = (USB_HID_CTRL_T*)data;
|
|
switch(pHidCtrl->protocol)
|
|
{
|
|
#if TUSB_CFG_DEVICE_HID_KEYBOARD
|
|
case HID_PROTOCOL_KEYBOARD:
|
|
if (!bKeyChanged)
|
|
{
|
|
memset(&hid_keyboard_report, 0, sizeof(hid_keyboard_report_t));
|
|
}
|
|
ROM_API->hw->WriteEP(hUsb, pHidCtrl->epin_adr, (uint8_t*) &hid_keyboard_report, sizeof(hid_keyboard_report_t));
|
|
bKeyChanged = false;
|
|
break;
|
|
#endif
|
|
|
|
#if TUSB_CFG_DEVICE_HID_MOUSE
|
|
case HID_PROTOCOL_MOUSE:
|
|
if (!bMouseChanged)
|
|
{
|
|
memset(&hid_mouse_report, 0, sizeof(hid_mouse_report_t));
|
|
}
|
|
ROM_API->hw->WriteEP(hUsb, pHidCtrl->epin_adr, (uint8_t*) &hid_mouse_report, sizeof(hid_mouse_report_t));
|
|
bMouseChanged = false;
|
|
break;
|
|
#endif
|
|
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
|
|
return LPC_OK;
|
|
}
|
|
|
|
ErrorCode_t HID_EpOut_Hdlr (USBD_HANDLE_T hUsb, void* data, uint32_t event)
|
|
{
|
|
if (USB_EVT_OUT == event)
|
|
{
|
|
// not used yet
|
|
// uint8_t outreport[8];
|
|
// USB_HID_CTRL_T* pHidCtrl = (USB_HID_CTRL_T*)data;
|
|
// ROM_API->hw->ReadEP(hUsb, pHidCtrl->epout_adr, outreport);
|
|
}
|
|
return LPC_OK;
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|