2014-05-03 22:27:38 +00:00
|
|
|
/*
|
2017-06-30 07:22:17 +00:00
|
|
|
* This file is part of the MicroPython project, http://micropython.org/
|
2014-05-03 22:27:38 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
******************************************************************************
|
|
|
|
* @file USB_Device/CDC_Standalone/Src/usbd_desc.c
|
|
|
|
* @author MCD Application Team
|
|
|
|
* @version V1.0.1
|
|
|
|
* @date 26-February-2014
|
|
|
|
* @brief This file provides the USBD descriptors and string formating method.
|
|
|
|
******************************************************************************
|
|
|
|
* @attention
|
|
|
|
*
|
|
|
|
* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
|
|
|
|
*
|
|
|
|
* Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
|
|
|
|
* You may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at:
|
|
|
|
*
|
|
|
|
* http://www.st.com/software_license_agreement_liberty_v2
|
|
|
|
*
|
2014-10-25 21:55:07 +00:00
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
2014-05-03 22:27:38 +00:00
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*
|
|
|
|
******************************************************************************
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "usbd_core.h"
|
|
|
|
#include "usbd_desc.h"
|
|
|
|
#include "usbd_conf.h"
|
|
|
|
|
2018-02-01 01:44:16 +00:00
|
|
|
// need this header just for MP_HAL_UNIQUE_ID_ADDRESS
|
2015-10-30 23:03:58 +00:00
|
|
|
#include "py/mphal.h"
|
2015-10-29 16:03:10 +00:00
|
|
|
|
2019-03-06 04:27:18 +00:00
|
|
|
// need this header for any overrides to the below constants
|
|
|
|
#include "mpconfigboard.h"
|
|
|
|
|
|
|
|
#ifndef USBD_LANGID_STRING
|
2014-05-03 22:27:38 +00:00
|
|
|
#define USBD_LANGID_STRING 0x409
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_MANUFACTURER_STRING
|
2015-10-11 23:06:25 +00:00
|
|
|
#define USBD_MANUFACTURER_STRING "MicroPython"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_PRODUCT_HS_STRING
|
2014-05-03 22:27:38 +00:00
|
|
|
#define USBD_PRODUCT_HS_STRING "Pyboard Virtual Comm Port in HS Mode"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_PRODUCT_FS_STRING
|
2014-05-03 22:27:38 +00:00
|
|
|
#define USBD_PRODUCT_FS_STRING "Pyboard Virtual Comm Port in FS Mode"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_CONFIGURATION_HS_STRING
|
2015-02-03 20:52:48 +00:00
|
|
|
#define USBD_CONFIGURATION_HS_STRING "Pyboard Config"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_INTERFACE_HS_STRING
|
2015-02-03 20:52:48 +00:00
|
|
|
#define USBD_INTERFACE_HS_STRING "Pyboard Interface"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_CONFIGURATION_FS_STRING
|
2015-02-03 20:52:48 +00:00
|
|
|
#define USBD_CONFIGURATION_FS_STRING "Pyboard Config"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef USBD_INTERFACE_FS_STRING
|
2015-02-03 20:52:48 +00:00
|
|
|
#define USBD_INTERFACE_FS_STRING "Pyboard Interface"
|
2019-03-06 04:27:18 +00:00
|
|
|
#endif
|
2014-05-03 22:27:38 +00:00
|
|
|
|
2017-09-22 00:57:21 +00:00
|
|
|
__ALIGN_BEGIN static const uint8_t USBD_LangIDDesc[USB_LEN_LANGID_STR_DESC] __ALIGN_END = {
|
2014-10-25 21:55:07 +00:00
|
|
|
USB_LEN_LANGID_STR_DESC,
|
|
|
|
USB_DESC_TYPE_STRING,
|
|
|
|
LOBYTE(USBD_LANGID_STRING),
|
|
|
|
HIBYTE(USBD_LANGID_STRING),
|
2014-05-03 22:27:38 +00:00
|
|
|
};
|
|
|
|
|
2015-02-03 22:37:50 +00:00
|
|
|
// set the VID, PID and device release number
|
2017-09-22 00:57:21 +00:00
|
|
|
void USBD_SetVIDPIDRelease(usbd_cdc_msc_hid_state_t *usbd, uint16_t vid, uint16_t pid, uint16_t device_release_num, int cdc_only) {
|
|
|
|
uint8_t *dev_desc = &usbd->usbd_device_desc[0];
|
|
|
|
|
|
|
|
dev_desc[0] = USB_LEN_DEV_DESC; // bLength
|
|
|
|
dev_desc[1] = USB_DESC_TYPE_DEVICE; // bDescriptorType
|
|
|
|
dev_desc[2] = 0x00; // bcdUSB
|
|
|
|
dev_desc[3] = 0x02; // bcdUSB
|
2015-10-03 06:25:31 +00:00
|
|
|
if (cdc_only) {
|
|
|
|
// Make it look like a Communications device if we're only
|
|
|
|
// using CDC. Otherwise, windows gets confused when we tell it that
|
|
|
|
// its a composite device with only a cdc serial interface.
|
2017-09-22 00:57:21 +00:00
|
|
|
dev_desc[4] = 0x02; // bDeviceClass
|
|
|
|
dev_desc[5] = 0x00; // bDeviceSubClass
|
|
|
|
dev_desc[6] = 0x00; // bDeviceProtocol
|
2015-10-03 06:25:31 +00:00
|
|
|
} else {
|
|
|
|
// For the other modes, we make this look like a composite device.
|
2017-09-22 00:57:21 +00:00
|
|
|
dev_desc[4] = 0xef; // bDeviceClass: Miscellaneous Device Class
|
|
|
|
dev_desc[5] = 0x02; // bDeviceSubClass: Common Class
|
|
|
|
dev_desc[6] = 0x01; // bDeviceProtocol: Interface Association Descriptor
|
2015-10-03 06:25:31 +00:00
|
|
|
}
|
2017-09-22 00:57:21 +00:00
|
|
|
dev_desc[7] = USB_MAX_EP0_SIZE; // bMaxPacketSize
|
|
|
|
dev_desc[8] = LOBYTE(vid); // idVendor
|
|
|
|
dev_desc[9] = HIBYTE(vid); // idVendor
|
|
|
|
dev_desc[10] = LOBYTE(pid); // idVendor
|
|
|
|
dev_desc[11] = HIBYTE(pid); // idVendor
|
|
|
|
dev_desc[12] = LOBYTE(device_release_num); // bcdDevice
|
|
|
|
dev_desc[13] = HIBYTE(device_release_num); // bcdDevice
|
|
|
|
dev_desc[14] = USBD_IDX_MFC_STR; // Index of manufacturer string
|
|
|
|
dev_desc[15] = USBD_IDX_PRODUCT_STR; // Index of product string
|
|
|
|
dev_desc[16] = USBD_IDX_SERIAL_STR; // Index of serial number string
|
|
|
|
dev_desc[17] = USBD_MAX_NUM_CONFIGURATION; // bNumConfigurations
|
2014-10-25 21:55:07 +00:00
|
|
|
}
|
2014-05-03 22:27:38 +00:00
|
|
|
|
|
|
|
/**
|
2014-10-25 21:55:07 +00:00
|
|
|
* @brief Returns the device descriptor.
|
2014-05-03 22:27:38 +00:00
|
|
|
* @param speed: Current device speed
|
|
|
|
* @param length: Pointer to data length variable
|
|
|
|
* @retval Pointer to descriptor buffer
|
|
|
|
*/
|
2017-09-22 00:28:56 +00:00
|
|
|
STATIC uint8_t *USBD_DeviceDescriptor(USBD_HandleTypeDef *pdev, uint16_t *length) {
|
2017-09-22 00:57:21 +00:00
|
|
|
uint8_t *dev_desc = ((usbd_cdc_msc_hid_state_t*)pdev->pClassData)->usbd_device_desc;
|
|
|
|
*length = USB_LEN_DEV_DESC;
|
|
|
|
return dev_desc;
|
2014-05-03 22:27:38 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-02-01 01:46:37 +00:00
|
|
|
* @brief Returns a string descriptor
|
|
|
|
* @param idx: Index of the string descriptor to retrieve
|
2014-05-03 22:27:38 +00:00
|
|
|
* @param length: Pointer to data length variable
|
2018-02-01 01:46:37 +00:00
|
|
|
* @retval Pointer to descriptor buffer, or NULL if idx is invalid
|
2014-05-03 22:27:38 +00:00
|
|
|
*/
|
2018-02-01 01:46:37 +00:00
|
|
|
STATIC uint8_t *USBD_StrDescriptor(USBD_HandleTypeDef *pdev, uint8_t idx, uint16_t *length) {
|
|
|
|
char str_buf[16];
|
|
|
|
const char *str = NULL;
|
|
|
|
|
|
|
|
switch (idx) {
|
|
|
|
case USBD_IDX_LANGID_STR:
|
|
|
|
*length = sizeof(USBD_LangIDDesc);
|
|
|
|
return (uint8_t*)USBD_LangIDDesc; // the data should only be read from this buf
|
|
|
|
|
|
|
|
case USBD_IDX_MFC_STR:
|
|
|
|
str = USBD_MANUFACTURER_STRING;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case USBD_IDX_PRODUCT_STR:
|
|
|
|
if (pdev->dev_speed == USBD_SPEED_HIGH) {
|
|
|
|
str = USBD_PRODUCT_HS_STRING;
|
|
|
|
} else {
|
|
|
|
str = USBD_PRODUCT_FS_STRING;
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case USBD_IDX_SERIAL_STR: {
|
|
|
|
// This document: http://www.usb.org/developers/docs/devclass_docs/usbmassbulk_10.pdf
|
|
|
|
// says that the serial number has to be at least 12 digits long and that
|
|
|
|
// the last 12 digits need to be unique. It also stipulates that the valid
|
|
|
|
// character set is that of upper-case hexadecimal digits.
|
|
|
|
//
|
|
|
|
// The onboard DFU bootloader produces a 12-digit serial number based on
|
|
|
|
// the 96-bit unique ID, so for consistency we go with this algorithm.
|
|
|
|
// You can see the serial number if you use: lsusb -v
|
|
|
|
//
|
|
|
|
// See: https://my.st.com/52d187b7 for the algorithim used.
|
|
|
|
|
|
|
|
uint8_t *id = (uint8_t *)MP_HAL_UNIQUE_ID_ADDRESS;
|
|
|
|
snprintf(str_buf, sizeof(str_buf),
|
|
|
|
"%02X%02X%02X%02X%02X%02X",
|
|
|
|
id[11], id[10] + id[2], id[9], id[8] + id[0], id[7], id[6]);
|
|
|
|
|
|
|
|
str = str_buf;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
case USBD_IDX_CONFIG_STR:
|
|
|
|
if (pdev->dev_speed == USBD_SPEED_HIGH) {
|
|
|
|
str = USBD_CONFIGURATION_HS_STRING;
|
|
|
|
} else {
|
|
|
|
str = USBD_CONFIGURATION_FS_STRING;
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case USBD_IDX_INTERFACE_STR:
|
|
|
|
if (pdev->dev_speed == USBD_SPEED_HIGH) {
|
|
|
|
str = USBD_INTERFACE_HS_STRING;
|
|
|
|
} else {
|
|
|
|
str = USBD_INTERFACE_FS_STRING;
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
|
|
|
// invalid string index
|
|
|
|
return NULL;
|
2014-10-25 21:55:07 +00:00
|
|
|
}
|
2014-05-03 22:27:38 +00:00
|
|
|
|
2017-09-22 00:57:21 +00:00
|
|
|
uint8_t *str_desc = ((usbd_cdc_msc_hid_state_t*)pdev->pClassData)->usbd_str_desc;
|
2018-02-01 01:46:37 +00:00
|
|
|
USBD_GetString((uint8_t*)str, str_desc, length);
|
2017-09-22 00:57:21 +00:00
|
|
|
return str_desc;
|
2014-05-03 22:27:38 +00:00
|
|
|
}
|
|
|
|
|
2015-02-03 20:52:48 +00:00
|
|
|
const USBD_DescriptorsTypeDef USBD_Descriptors = {
|
|
|
|
USBD_DeviceDescriptor,
|
2018-02-01 01:46:37 +00:00
|
|
|
USBD_StrDescriptor,
|
2014-10-25 21:55:07 +00:00
|
|
|
};
|
2014-05-03 22:27:38 +00:00
|
|
|
|
2014-10-25 21:55:07 +00:00
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|