diff options
Diffstat (limited to 'examples/baremetal/msp430f5529/nes-gamepads/hiddesc.c')
-rw-r--r-- | examples/baremetal/msp430f5529/nes-gamepads/hiddesc.c | 303 |
1 files changed, 303 insertions, 0 deletions
diff --git a/examples/baremetal/msp430f5529/nes-gamepads/hiddesc.c b/examples/baremetal/msp430f5529/nes-gamepads/hiddesc.c new file mode 100644 index 000000000..eb391d6c0 --- /dev/null +++ b/examples/baremetal/msp430f5529/nes-gamepads/hiddesc.c @@ -0,0 +1,303 @@ +/**************************************************************************** +** +** Copyright (C) 2019 Denis Shienkov <denis.shienkov@gmail.com> +** Contact: https://www.qt.io/licensing/ +** +** This file is part of the examples of Qbs. +** +** $QT_BEGIN_LICENSE:BSD$ +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and The Qt Company. For licensing terms +** and conditions see https://www.qt.io/terms-conditions. For further +** information use the contact form at https://www.qt.io/contact-us. +** +** BSD License Usage +** Alternatively, you may use this file under the terms of the BSD license +** as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * 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. +** * Neither the name of The Qt Company Ltd 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 AND CONTRIBUTORS +** "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 +** OWNER OR CONTRIBUTORS 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." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "hid.h" +#include "usb.h" + +#include <stdint.h> + +#define usb_word_msb_get(word) \ + (uint8_t)(((uint16_t)(word) >> 8) & 0xFF) +#define usb_word_lsb_get(word) \ + (uint8_t)((uint16_t)(word) & 0xFF) + +enum usb_bcd_version { + SPEC_BCD_VERSION = 0x0200, + DEVICE_BCD_VERSION = 0x1234, + HID_BCD_VERSION = 0x0111 +}; + +enum usb_ids { + DEVICE_VID = 0xFFFF, + DEVICE_PID = 0xFFFF +}; + +enum usb_lang_id { + LANG_ID = 0x0409 +}; + +enum usb_descriptor_string_index { + DESC_LANGID_STRING_INDEX = 0, + DESC_MFG_STRING_INDEX, + DESC_PRODUCT_STRING_INDEX, + DESC_SERIAL_STRING_INDEX +}; + +enum usb_descr_length { + // Standard length. + DESC_DEVICE_LEN = 18, + DESC_DEVICE_QUAL_LEN = 10, + DESC_CONF_LEN = 9, + DESC_OTHER_SPEED_CONF_LEN = 9, + DESC_INTERFACE_LEN = 9, + DESC_HID_LEN = 9, + DESCR_HID_REP_LEN = 56, + DESC_ENDPOINT_LEN = 7, + + // Total length. + DESC_DEVICE_TOTAL_LEN = DESC_DEVICE_LEN, + DESC_DEVICE_QUAL_TOTAL_LEN = DESC_DEVICE_QUAL_LEN, + DESC_CONF_TOTAL_LEN = DESC_CONF_LEN + DESC_INTERFACE_LEN + DESC_HID_LEN + DESC_ENDPOINT_LEN, + DESC_OTHER_SPEED_CONF_TOTAL_LEN = DESC_OTHER_SPEED_CONF_LEN + DESC_INTERFACE_LEN, + DESCR_HID_REP_TOTAL_LEN = DESCR_HID_REP_LEN +}; + +enum usb_descr_attributes { + // Attributes (b7 - buspwr, b6 - selfpwr, b5 - rwu). + USB_DESC_ATTRIBUTES = 0xA0, + // 100 mA (div 2). + USB_DESC_POWER_CONSUMPTION = 50 +}; + +enum usb_descr_numbers { + USB_DESC_CONFIG_COUNT = 1 +}; + +static const uint8_t g_hid_report_desc[DESCR_HID_REP_TOTAL_LEN] = { + // Pad #1 configuration. + 0x05, 0x01, // Usage page (Generic Desktop). + 0x09, 0x05, // Usage (Game Pad). + 0xa1, 0x01, // Collection (Application). + 0xa1, 0x00, // Collection (Physical). + 0x85, HID_REPORT_ID_GAMEPAD1, // Report id (1). + 0x05, 0x09, // Usage page (Button). + 0x19, 0x01, // Usage minimum (Button 1). + 0x29, 0x08, // Usage maximum (Button 8). + 0x15, 0x00, // Logical minimum (0). + 0x25, 0x01, // Logical maximum (1). + 0x95, HID_REPORT_BITS_COUNT, // Report count (8). + 0x75, 0x01, // Report size (1). + 0x81, 0x02, // Input (Data,Var,Abs). + 0xc0, // End collection. + 0xc0, // End collection. + // Pad #2 configuration. + 0x05, 0x01, // Usage page (Generic Desktop). + 0x09, 0x05, // Usage (Game Pad). + 0xa1, 0x01, // Collection (Application). + 0xa1, 0x00, // Collection (Physical). + 0x85, HID_REPORT_ID_GAMEPAD2, // Report id (2). + 0x05, 0x09, // Usage page (Button). + 0x19, 0x01, // Usage minimum (Button 1). + 0x29, 0x08, // Usage maximum (Button 8). + 0x15, 0x00, // Logical minimum (0). + 0x25, 0x01, // Logical maximum (1). + 0x95, HID_REPORT_BITS_COUNT, // Report count (8). + 0x75, 0x01, // Report size (1). + 0x81, 0x02, // Input (Data,Var,Abs). + 0xc0, // End collection + 0xc0 // End collection. +}; + +static const uint8_t g_device_desc[DESC_DEVICE_TOTAL_LEN] = { + DESC_DEVICE_LEN, // Descriptor length. + DESC_DEVICE, // Descriptor type. + usb_word_lsb_get(SPEC_BCD_VERSION), // USB BCD version, lo. + usb_word_msb_get(SPEC_BCD_VERSION), // USB BCD version, hi. + 0x00, // Device class. + 0x00, // Device sub-class. + 0x00, // Device protocol. + EP0_MAX_PACKET_SIZE, // Maximum packet size (ep0 size). + usb_word_lsb_get(DEVICE_VID), // Vendor ID, lo. + usb_word_msb_get(DEVICE_VID), // Vendor ID, hi. + usb_word_lsb_get(DEVICE_PID), // Product ID, lo. + usb_word_msb_get(DEVICE_PID), // Product ID, hi. + usb_word_lsb_get(DEVICE_BCD_VERSION), // Device BCD version, lo. + usb_word_msb_get(DEVICE_BCD_VERSION), // Device BCD version, hi. + DESC_MFG_STRING_INDEX, + DESC_PRODUCT_STRING_INDEX, + DESC_SERIAL_STRING_INDEX, + USB_DESC_CONFIG_COUNT // Configurations count. +}; + +static const uint8_t g_device_qual_desc[DESC_DEVICE_QUAL_TOTAL_LEN] = { + DESC_DEVICE_QUAL_LEN, // Descriptor length. + DESC_DEVICE_QUAL, // Descriptor type. + usb_word_lsb_get(SPEC_BCD_VERSION), // USB BCD version, lo. + usb_word_msb_get(SPEC_BCD_VERSION), // USB BCD version, hi. + 0x00, // Device class. + 0x00, // Device sub-class. + 0x00, // Device protocol. + EP0_MAX_PACKET_SIZE, // Maximum packet size (ep0 size). + USB_DESC_CONFIG_COUNT, // Configurations count. + 0x00 // Reserved. +}; + +static const uint8_t g_config_desc[DESC_CONF_TOTAL_LEN] = { + DESC_CONF_LEN, // Descriptor length. + DESC_CONF, // Descriptor type. + usb_word_lsb_get(DESC_CONF_TOTAL_LEN), // Total length, lo. + usb_word_msb_get(DESC_CONF_TOTAL_LEN), // Total length, hi. + 0x01, // Interfaces count. + HID_CONFIG_NUMBER, // Configuration number. + 0x00, // Configuration string index. + USB_DESC_ATTRIBUTES, // Attributes. + USB_DESC_POWER_CONSUMPTION, // Power consumption. + + // Interface descriptor. + DESC_INTERFACE_LEN, // Descriptor length. + DESC_INTERFACE, // Descriptor type. + HID_IFACE_NUMBER, // Zero-based index of this interfacce. + HID_ALT_IFACE_NUMBER, // Alternate setting. + 0x01, // End points count (ep1 in). + 0x03, // Class code (HID). + 0x00, // Subclass code (boot). + 0x00, // Protocol code (none). + 0x00, // Interface string descriptor index. + + // HID descriptor. + DESC_HID_LEN, // Descriptor length. + DESC_HID, // Descriptor type. + usb_word_lsb_get(HID_BCD_VERSION), // HID class BCD version, lo. + usb_word_msb_get(HID_BCD_VERSION), // HID class BCD version, hi. + 0x00, // Country code (HW country code). + 0x01, // Number of HID class descriptors to follow. + DESC_REPORT, // Repord descriptor type (HID). + usb_word_lsb_get(DESCR_HID_REP_LEN), // Report descriptor total length, lo. + usb_word_msb_get(DESCR_HID_REP_LEN), // Report descriptor total length, hi. + + // End point descriptor. + DESC_ENDPOINT_LEN, // Descriptor length. + DESC_ENDPOINT, // Descriptor type. + HID_EP_IN, // End point address (ep1 in). + 0x03, // End point type (interrupt). + usb_word_lsb_get(EP_MAX_PACKET_SIZE), // Maximum packet size, lo (ep1 size). + usb_word_msb_get(EP_MAX_PACKET_SIZE), // Maximum packet size, hi (ep1 size). + 0x01 // Polling interval (1 ms). +}; + +static const uint8_t g_lang_id_desc[] = { + 0x04, // Descriptor length. + DESC_STRING, // Descriptor type. + usb_word_lsb_get(LANG_ID), // Language id, lo. + usb_word_msb_get(LANG_ID) // Language id, hi. +}; + +static const uint8_t g_manuf_str_desc[] = { + 0x18, // Descriptor length. + DESC_STRING, // Descriptor type. + // Unicode string: + 'Q', 0, 'B', 0, 'S', 0, ' ', 0, + 'e', 0, 'x', 0, 'a', 0, 'm', 0, 'p', 0, 'l', 0, 'e', 0 +}; + +static const uint8_t g_product_str_desc[] = { + 0x1A, // Descriptor length. + DESC_STRING, // Descriptor type. + // Unicode string: + 'N', 0, 'E', 0, 'S', 0, ' ', 0, + 'G', 0, 'a', 0, 'm', 0, 'e', 0, + 'P', 0, 'a', 0, 'd', 0, 's', 0 +}; + +static const uint8_t g_serialno_str_desc[] = { + 0x1A, // Descriptor length. + DESC_STRING, // Descriptor type. + // Unicode string: + '0', 0 ,'1', 0, '0', 0, '2', 0, '0', 0, '3', 0, + '0', 0, '4', 0, '0', 0, '5', 0, '0', 0, '6', 0 +}; + +static const uint8_t *ep0_string_desc_get(uint16_t *length) +{ + const uint8_t index = hid_ep0_setup_lvalue_get(); + switch (index) { + case DESC_LANGID_STRING_INDEX: + *length = sizeof(g_lang_id_desc); + return g_lang_id_desc; + case DESC_MFG_STRING_INDEX: + *length = sizeof(g_manuf_str_desc); + return g_manuf_str_desc; + case DESC_PRODUCT_STRING_INDEX: + *length = sizeof(g_product_str_desc); + return g_product_str_desc; + case DESC_SERIAL_STRING_INDEX: + *length = sizeof(g_serialno_str_desc); + return g_serialno_str_desc; + default: + break; + } + return 0; +} + +const uint8_t *hid_ep0_desc_get(uint8_t type, uint16_t *length) +{ + switch (type) { + case DESC_DEVICE: + *length = DESC_DEVICE_TOTAL_LEN; + return g_device_desc; + case DESC_CONF: + *length = DESC_CONF_TOTAL_LEN; + return g_config_desc; + case DESC_STRING: + return ep0_string_desc_get(length); + case DESC_DEVICE_QUAL: + *length = DESC_DEVICE_QUAL_TOTAL_LEN; + return g_device_qual_desc; + case DESC_HID: + *length = DESC_HID_LEN; + return &g_config_desc[DESC_CONF_LEN + DESC_INTERFACE_LEN]; + case DESC_REPORT: + *length = DESCR_HID_REP_TOTAL_LEN; + return g_hid_report_desc; + default: + break; + } + return 0; +} |