diff options
Diffstat (limited to 'libusb')
| -rw-r--r-- | libusb/tusb_config.h | 107 | ||||
| -rw-r--r-- | libusb/tusb_helpers.h | 971 | ||||
| -rwxr-xr-x | libusb/tusb_helpers.h.gen | 82 | ||||
| -rw-r--r-- | libusb/usb_common.c | 189 | ||||
| -rw-r--r-- | libusb/usb_common.h | 59 |
5 files changed, 1408 insertions, 0 deletions
diff --git a/libusb/tusb_config.h b/libusb/tusb_config.h new file mode 100644 index 0000000..cb1ca3b --- /dev/null +++ b/libusb/tusb_config.h @@ -0,0 +1,107 @@ +/* tusb_config.h - Compile-time configuration for the TinyUSB library + * + * The MIT License (MIT) + * + * Copyright (c) 2019 Ha Thach (tinyusb.org) + * Copyright (c) 2024 Luke T. Shumaker <lukeshu@lukeshu.com> + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + */ + +#ifndef _TUSB_CONFIG_H_ +#define _TUSB_CONFIG_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +//-------------------------------------------------------------------- +// TinyUSB Device (TUD) initialization for rp2040-based boards +//-------------------------------------------------------------------- + +// Which USB port to use for the RootHub. +// The rp2040 only has 1 port, so it's gotta be port #0. +#define BOARD_TUD_RHPORT 0 + +// RHPort max operational speed. +// Use OPT_MODE_DEFAULT_SPEED for max speed supported by MCU. +#define BOARD_TUD_MAX_SPEED OPT_MODE_DEFAULT_SPEED + +//-------------------------------------------------------------------- +// Configuration: common +//-------------------------------------------------------------------- + +// defined by compiler flags +#ifndef CFG_TUSB_MCU +#error CFG_TUSB_MCU must be defined +#endif + +// Conditional because it might be defined with `-D` on the command +// line if `cmake -DCMAKE_BUILD_TYPE=Debug`. +#ifndef CFG_TUSB_DEBUG +#define CFG_TUSB_DEBUG 0 +#endif + +// USB DMA on some MCUs can only access a specific SRAM region with restriction on alignment. +// Tinyusb use follows macros to declare transferring memory so that they can be put +// into those specific section. +// e.g +// - CFG_TUSB_MEM SECTION : __attribute__ (( section(".usb_ram") )) +// - CFG_TUSB_MEM_ALIGN : __attribute__ ((aligned(4))) +#define CFG_TUSB_MEM_SECTION /* blank */ +#define CFG_TUSB_MEM_ALIGN __attribute__ ((aligned(4))) + +#define CFG_TUD_ENABLED 1 +#define CFG_TUD_MAX_SPEED BOARD_TUD_MAX_SPEED + +//-------------------------------------------------------------------- +// Configuration: TinyUSB Device (TUD) +//-------------------------------------------------------------------- + +// control endpoint max packet size (only 8, 16, 32, or 64 are valid) +#define CFG_TUD_ENDPOINT0_SIZE 64 + +// Which of TinyUSB's built-in class drivers to enable. +// +// If a class takes an int, that's the maximum number of interfaces of +// that type that may be listed in the same configuration descriptor. +#define CFG_TUD_CDC 0 // int : Communications Device Class (e.g. ttyUSB) https://www.usb.org/sites/default/files/CDC1.2_WMC1.1_012011.zip +#define CFG_TUD_MSC 0 // bool: Mass Storage Class https://www.usb.org/sites/default/files/Mass_Storage_Specification_Overview_v1.4_2-19-2010.pdf +#define CFG_TUD_HID 1 // int : Human Interface Device https://www.usb.org/sites/default/files/hid1_11.pdf +#define CFG_TUD_AUDIO 0 // int : Audio https://www.usb.org/sites/default/files/audio10.pdf +#define CFG_TUD_VIDEO 0 // int : Video https://www.usb.org/sites/default/files/USB_Video_Class_1_5.zip +#define CFG_TUD_MIDI 0 // int : Musical Instrument Digital Interface https://www.usb.org/sites/default/files/USB%20MIDI%20v2_0.pdf +#define CFG_TUD_VENDOR 0 // int : ??? +#define CFG_TUD_USBTMC 0 // bool: Test & Measurement Class https://www.usb.org/sites/default/files/USBTMC_1_006a.zip +#define CFG_TUD_DFU_RUNTIME 0 // bool: Device Firmware Upgrade https://www.usb.org/sites/default/files/DFU_1.1.pdf +#define CFG_TUD_DFU 0 // bool: Device Firmware Upgrade https://www.usb.org/sites/default/files/DFU_1.1.pdf +#define CFG_TUD_ECM_RNDIS 0 // bool: net +#define CFG_TUD_NCM 0 // bool: net +#define CFG_TUD_BTH 0 // bool: Bluetooth + +// HID buffer size Should be sufficient to hold ID (if any) + Data +#define CFG_TUD_HID_EP_BUFSIZE 8 + +//-------------------------------------------------------------------- +#ifdef __cplusplus +} +#endif + +#endif /* _TUSB_CONFIG_H_ */ diff --git a/libusb/tusb_helpers.h b/libusb/tusb_helpers.h new file mode 100644 index 0000000..cd96357 --- /dev/null +++ b/libusb/tusb_helpers.h @@ -0,0 +1,971 @@ +/* tusb_helpers.h - Preprocessor macros that I think should be included in TinyUSB + * + * Copyright (c) 2024 Luke T. Shumaker <lukeshu@lukeshu.com> + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + */ + +#ifndef _USB_HELPERS_H_ +#define _USB_HELPERS_H_ + +/* USB 2.0 §9.6.7 "String" says "The list of currently defined USB LANGIDs can be found at + * http://www.usb.org/developers/docs.html.", but that page 404s. + * + * Once upon a time the USB-IF (usb.org) published a "Language Identifiers (LANGIDs)" version 1.0, + * dated 2000-03-29. There is no longer any mention of this on usb.org, but I found a copy at + * http://www.baiheee.com/Documents/090518/090518112619/USB_LANGIDs.pdf + * + * So how does the USB-IF defined LANGIDs these days? + * + * https://www.usb.org/deprecated-links-and-tools says "To get the latest LANGID definitions go to + * https://docs.microsoft.com/en-us/windows/desktop/intl/language-identifier-constants-and-strings. This + * page will change as new LANGIDs are added." That page has no list of LANGIDs, but says "For the + * predefined primary language identifiers with their valid sublanguage identifiers, see + * [\[MS-LCID\]: Windows Language Code Identifier (LCID) + * Reference](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/70feba9f-294e-491e-b6eb-565326e84c37f)." + * That page at the time of this writing as a PDF marked as version 16.0, dated 2024-04-24: + * https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-LCID/%5bMS-LCID%5d.pdf + * [MS-LCID] defines an LCID as a 32-bit value consisting of a 16-bit a "Language ID", a 4-bit "Sort + * ID", and 12 reserved bits. + * + * That is to say: The USB-IF has said in essence "USB LANGIDs are defined to be the 'Language ID' + * portion of Microsoft Windows LCIDs (Language Code Identifiers); refer to Microsoft's published + * list of LCID Language IDs for a list of USB LANGIDs." + * + * The scheme for Language IDs is that the least-significant-byte is "primary" ID and the + * most-significant-byte is a "sublanguage" ID within that. With this in mind, Microsoft's choice + * to sort their list of by most-significant-byte was a poor editorial choice. + */ +#define LANGID_AR 0x0001 +#define LANGID_AR 0x0001 +#define LANGID_AR_SA 0x0401 +#define LANGID_AR_SA 0x0401 +#define LANGID_QPS_PLOC 0x0501 +#define LANGID_QPS_PLOC 0x0501 +#define LANGID_AR_IQ 0x0801 +#define LANGID_AR_IQ 0x0801 +#define LANGID_AR_EG 0x0C01 +#define LANGID_AR_EG 0x0C01 +#define LANGID_AR_LY 0x1001 +#define LANGID_AR_LY 0x1001 +#define LANGID_AR_DZ 0x1401 +#define LANGID_AR_DZ 0x1401 +#define LANGID_AR_MA 0x1801 +#define LANGID_AR_MA 0x1801 +#define LANGID_AR_TN 0x1C01 +#define LANGID_AR_TN 0x1C01 +#define LANGID_AR_OM 0x2001 +#define LANGID_AR_OM 0x2001 +#define LANGID_AR_YE 0x2401 +#define LANGID_AR_YE 0x2401 +#define LANGID_AR_SY 0x2801 +#define LANGID_AR_SY 0x2801 +#define LANGID_AR_JO 0x2C01 +#define LANGID_AR_JO 0x2C01 +#define LANGID_AR_LB 0x3001 +#define LANGID_AR_LB 0x3001 +#define LANGID_AR_KW 0x3401 +#define LANGID_AR_KW 0x3401 +#define LANGID_AR_AE 0x3801 +#define LANGID_AR_AE 0x3801 +#define LANGID_AR_BH 0x3C01 +#define LANGID_AR_BH 0x3C01 +#define LANGID_AR_QA 0x4001 +#define LANGID_AR_QA 0x4001 +#define LANGID_AR_PLOC_SA 0x4401 +#define LANGID_AR_PLOC_SA 0x4401 +#define LANGID_AR_145 0x4801 +#define LANGID_AR_145 0x4801 +#define LANGID_BG 0x0002 +#define LANGID_BG 0x0002 +#define LANGID_BG_BG 0x0402 +#define LANGID_BG_BG 0x0402 +#define LANGID_CA 0x0003 +#define LANGID_CA 0x0003 +#define LANGID_CA_ES 0x0403 +#define LANGID_CA_ES 0x0403 +#define LANGID_CA_ES_VALENCIA 0x0803 +#define LANGID_CA_ES_VALENCIA 0x0803 +#define LANGID_ZH_HANS 0x0004 +#define LANGID_ZH_HANS 0x0004 +#define LANGID_ZH_TW 0x0404 +#define LANGID_ZH_TW 0x0404 +#define LANGID_ZH_CN 0x0804 +#define LANGID_ZH_CN 0x0804 +#define LANGID_ZH_HK 0x0C04 +#define LANGID_ZH_HK 0x0C04 +#define LANGID_ZH_SG 0x1004 +#define LANGID_ZH_SG 0x1004 +#define LANGID_ZH_MO 0x1404 +#define LANGID_ZH_MO 0x1404 +#define LANGID_ZH 0x7804 +#define LANGID_ZH 0x7804 +#define LANGID_ZH_HANT 0x7C04 +#define LANGID_ZH_HANT 0x7C04 +#define LANGID_CS 0x0005 +#define LANGID_CS 0x0005 +#define LANGID_CS_CZ 0x0405 +#define LANGID_CS_CZ 0x0405 +#define LANGID_DA 0x0006 +#define LANGID_DA 0x0006 +#define LANGID_DA_DK 0x0406 +#define LANGID_DA_DK 0x0406 +#define LANGID_DE 0x0007 +#define LANGID_DE 0x0007 +#define LANGID_DE_DE 0x0407 +#define LANGID_DE_DE 0x0407 +#define LANGID_DE_CH 0x0807 +#define LANGID_DE_CH 0x0807 +#define LANGID_DE_AT 0x0C07 +#define LANGID_DE_AT 0x0C07 +#define LANGID_DE_LU 0x1007 +#define LANGID_DE_LU 0x1007 +#define LANGID_DE_LI 0x1407 +#define LANGID_DE_LI 0x1407 +#define LANGID_EL 0x0008 +#define LANGID_EL 0x0008 +#define LANGID_EL_GR 0x0408 +#define LANGID_EL_GR 0x0408 +#define LANGID_EN 0x0009 +#define LANGID_EN 0x0009 +#define LANGID_EN_US 0x0409 +#define LANGID_EN_US 0x0409 +#define LANGID_EN_GB 0x0809 +#define LANGID_EN_GB 0x0809 +#define LANGID_EN_AU 0x0C09 +#define LANGID_EN_AU 0x0C09 +#define LANGID_EN_CA 0x1009 +#define LANGID_EN_CA 0x1009 +#define LANGID_EN_NZ 0x1409 +#define LANGID_EN_NZ 0x1409 +#define LANGID_EN_IE 0x1809 +#define LANGID_EN_IE 0x1809 +#define LANGID_EN_ZA 0x1C09 +#define LANGID_EN_ZA 0x1C09 +#define LANGID_EN_JM 0x2009 +#define LANGID_EN_JM 0x2009 +#define LANGID_EN_029 0x2409 +#define LANGID_EN_029 0x2409 +#define LANGID_EN_BZ 0x2809 +#define LANGID_EN_BZ 0x2809 +#define LANGID_EN_TT 0x2C09 +#define LANGID_EN_TT 0x2C09 +#define LANGID_EN_ZW 0x3009 +#define LANGID_EN_ZW 0x3009 +#define LANGID_EN_PH 0x3409 +#define LANGID_EN_PH 0x3409 +#define LANGID_EN_ID 0x3809 +#define LANGID_EN_ID 0x3809 +#define LANGID_EN_HK 0x3C09 +#define LANGID_EN_HK 0x3C09 +#define LANGID_EN_IN 0x4009 +#define LANGID_EN_IN 0x4009 +#define LANGID_EN_MY 0x4409 +#define LANGID_EN_MY 0x4409 +#define LANGID_EN_SG 0x4809 +#define LANGID_EN_SG 0x4809 +#define LANGID_EN_AE 0x4C09 +#define LANGID_EN_AE 0x4C09 +#define LANGID_EN_BH 0x5009 +#define LANGID_EN_BH 0x5009 +#define LANGID_EN_EG 0x5409 +#define LANGID_EN_EG 0x5409 +#define LANGID_EN_JO 0x5809 +#define LANGID_EN_JO 0x5809 +#define LANGID_EN_KW 0x5C09 +#define LANGID_EN_KW 0x5C09 +#define LANGID_EN_TR 0x6009 +#define LANGID_EN_TR 0x6009 +#define LANGID_EN_YE 0x6409 +#define LANGID_EN_YE 0x6409 +#define LANGID_ES 0x000A +#define LANGID_ES 0x000A +#define LANGID_ES_ES_TRADNL 0x040A +#define LANGID_ES_ES_TRADNL 0x040A +#define LANGID_ES_MX 0x080A +#define LANGID_ES_MX 0x080A +#define LANGID_ES_ES 0x0C0A +#define LANGID_ES_ES 0x0C0A +#define LANGID_ES_GT 0x100A +#define LANGID_ES_GT 0x100A +#define LANGID_ES_CR 0x140A +#define LANGID_ES_CR 0x140A +#define LANGID_ES_PA 0x180A +#define LANGID_ES_PA 0x180A +#define LANGID_ES_DO 0x1C0A +#define LANGID_ES_DO 0x1C0A +#define LANGID_ES_VE 0x200A +#define LANGID_ES_VE 0x200A +#define LANGID_ES_CO 0x240A +#define LANGID_ES_CO 0x240A +#define LANGID_ES_PE 0x280A +#define LANGID_ES_PE 0x280A +#define LANGID_ES_AR 0x2C0A +#define LANGID_ES_AR 0x2C0A +#define LANGID_ES_EC 0x300A +#define LANGID_ES_EC 0x300A +#define LANGID_ES_CL 0x340A +#define LANGID_ES_CL 0x340A +#define LANGID_ES_UY 0x380A +#define LANGID_ES_UY 0x380A +#define LANGID_ES_PY 0x3C0A +#define LANGID_ES_PY 0x3C0A +#define LANGID_ES_BO 0x400A +#define LANGID_ES_BO 0x400A +#define LANGID_ES_SV 0x440A +#define LANGID_ES_SV 0x440A +#define LANGID_ES_HN 0x480A +#define LANGID_ES_HN 0x480A +#define LANGID_ES_NI 0x4C0A +#define LANGID_ES_NI 0x4C0A +#define LANGID_ES_PR 0x500A +#define LANGID_ES_PR 0x500A +#define LANGID_ES_US 0x540A +#define LANGID_ES_US 0x540A +#define LANGID_ES_419 0x580A +#define LANGID_ES_419 0x580A +#define LANGID_ES_CU 0x5C0A +#define LANGID_ES_CU 0x5C0A +#define LANGID_FI 0x000B +#define LANGID_FI 0x000B +#define LANGID_FI_FI 0x040B +#define LANGID_FI_FI 0x040B +#define LANGID_FR 0x000C +#define LANGID_FR 0x000C +#define LANGID_FR_FR 0x040C +#define LANGID_FR_FR 0x040C +#define LANGID_FR_BE 0x080C +#define LANGID_FR_BE 0x080C +#define LANGID_FR_CA 0x0C0C +#define LANGID_FR_CA 0x0C0C +#define LANGID_FR_CH 0x100C +#define LANGID_FR_CH 0x100C +#define LANGID_FR_LU 0x140C +#define LANGID_FR_LU 0x140C +#define LANGID_FR_MC 0x180C +#define LANGID_FR_MC 0x180C +#define LANGID_FR_029 0x1C0C +#define LANGID_FR_029 0x1C0C +#define LANGID_FR_RE 0x200C +#define LANGID_FR_RE 0x200C +#define LANGID_FR_CD 0x240C +#define LANGID_FR_CD 0x240C +#define LANGID_FR_SN 0x280C +#define LANGID_FR_SN 0x280C +#define LANGID_FR_CM 0x2C0C +#define LANGID_FR_CM 0x2C0C +#define LANGID_FR_CI 0x300C +#define LANGID_FR_CI 0x300C +#define LANGID_FR_ML 0x340C +#define LANGID_FR_ML 0x340C +#define LANGID_FR_MA 0x380C +#define LANGID_FR_MA 0x380C +#define LANGID_FR_HT 0x3C0C +#define LANGID_FR_HT 0x3C0C +#define LANGID_FR_015 0xE40C +#define LANGID_FR_015 0xE40C +#define LANGID_HE 0x000D +#define LANGID_HE 0x000D +#define LANGID_HE_IL 0x040D +#define LANGID_HE_IL 0x040D +#define LANGID_HU 0x000E +#define LANGID_HU 0x000E +#define LANGID_HU_HU 0x040E +#define LANGID_HU_HU 0x040E +#define LANGID_IS 0x000F +#define LANGID_IS 0x000F +#define LANGID_IS_IS 0x040F +#define LANGID_IS_IS 0x040F +#define LANGID_IT 0x0010 +#define LANGID_IT 0x0010 +#define LANGID_IT_IT 0x0410 +#define LANGID_IT_IT 0x0410 +#define LANGID_IT_CH 0x0810 +#define LANGID_IT_CH 0x0810 +#define LANGID_JA 0x0011 +#define LANGID_JA 0x0011 +#define LANGID_JA_JP 0x0411 +#define LANGID_JA_JP 0x0411 +#define LANGID_JA_PLOC_JP 0x0811 +#define LANGID_JA_PLOC_JP 0x0811 +#define LANGID_KO 0x0012 +#define LANGID_KO 0x0012 +#define LANGID_KO_KR 0x0412 +#define LANGID_KO_KR 0x0412 +#define LANGID_NL 0x0013 +#define LANGID_NL 0x0013 +#define LANGID_NL_NL 0x0413 +#define LANGID_NL_NL 0x0413 +#define LANGID_NL_BE 0x0813 +#define LANGID_NL_BE 0x0813 +#define LANGID_NO 0x0014 +#define LANGID_NO 0x0014 +#define LANGID_NB_NO 0x0414 +#define LANGID_NB_NO 0x0414 +#define LANGID_NN_NO 0x0814 +#define LANGID_NN_NO 0x0814 +#define LANGID_NN 0x7814 +#define LANGID_NN 0x7814 +#define LANGID_NB 0x7C14 +#define LANGID_NB 0x7C14 +#define LANGID_PL 0x0015 +#define LANGID_PL 0x0015 +#define LANGID_PL_PL 0x0415 +#define LANGID_PL_PL 0x0415 +#define LANGID_PT 0x0016 +#define LANGID_PT 0x0016 +#define LANGID_PT_BR 0x0416 +#define LANGID_PT_BR 0x0416 +#define LANGID_PT_PT 0x0816 +#define LANGID_PT_PT 0x0816 +#define LANGID_RM 0x0017 +#define LANGID_RM 0x0017 +#define LANGID_RM_CH 0x0417 +#define LANGID_RM_CH 0x0417 +#define LANGID_RO 0x0018 +#define LANGID_RO 0x0018 +#define LANGID_RO_RO 0x0418 +#define LANGID_RO_RO 0x0418 +#define LANGID_RO_MD 0x0818 +#define LANGID_RO_MD 0x0818 +#define LANGID_RU 0x0019 +#define LANGID_RU 0x0019 +#define LANGID_RU_RU 0x0419 +#define LANGID_RU_RU 0x0419 +#define LANGID_RU_MD 0x0819 +#define LANGID_RU_MD 0x0819 +#define LANGID_HR 0x001A +#define LANGID_HR 0x001A +#define LANGID_HR_HR 0x041A +#define LANGID_HR_HR 0x041A +#define LANGID_SR_LATN_CS 0x081A +#define LANGID_SR_LATN_CS 0x081A +#define LANGID_SR_CYRL_CS 0x0C1A +#define LANGID_SR_CYRL_CS 0x0C1A +#define LANGID_HR_BA 0x101A +#define LANGID_HR_BA 0x101A +#define LANGID_BS_LATN_BA 0x141A +#define LANGID_BS_LATN_BA 0x141A +#define LANGID_SR_LATN_BA 0x181A +#define LANGID_SR_LATN_BA 0x181A +#define LANGID_SR_CYRL_BA 0x1C1A +#define LANGID_SR_CYRL_BA 0x1C1A +#define LANGID_BS_CYRL_BA 0x201A +#define LANGID_BS_CYRL_BA 0x201A +#define LANGID_SR_LATN_RS 0x241A +#define LANGID_SR_LATN_RS 0x241A +#define LANGID_SR_CYRL_RS 0x281A +#define LANGID_SR_CYRL_RS 0x281A +#define LANGID_SR_LATN_ME 0x2C1A +#define LANGID_SR_LATN_ME 0x2C1A +#define LANGID_SR_CYRL_ME 0x301A +#define LANGID_SR_CYRL_ME 0x301A +#define LANGID_BS_CYRL 0x641A +#define LANGID_BS_CYRL 0x641A +#define LANGID_BS_LATN 0x681A +#define LANGID_BS_LATN 0x681A +#define LANGID_SR_CYRL 0x6C1A +#define LANGID_SR_CYRL 0x6C1A +#define LANGID_SR_LATN 0x701A +#define LANGID_SR_LATN 0x701A +#define LANGID_BS 0x781A +#define LANGID_BS 0x781A +#define LANGID_SR 0x7C1A +#define LANGID_SR 0x7C1A +#define LANGID_SK 0x001B +#define LANGID_SK 0x001B +#define LANGID_SK_SK 0x041B +#define LANGID_SK_SK 0x041B +#define LANGID_SQ 0x001C +#define LANGID_SQ 0x001C +#define LANGID_SQ_AL 0x041C +#define LANGID_SQ_AL 0x041C +#define LANGID_SV 0x001D +#define LANGID_SV 0x001D +#define LANGID_SV_SE 0x041D +#define LANGID_SV_SE 0x041D +#define LANGID_SV_FI 0x081D +#define LANGID_SV_FI 0x081D +#define LANGID_TH 0x001E +#define LANGID_TH 0x001E +#define LANGID_TH_TH 0x041E +#define LANGID_TH_TH 0x041E +#define LANGID_TR 0x001F +#define LANGID_TR 0x001F +#define LANGID_TR_TR 0x041F +#define LANGID_TR_TR 0x041F +#define LANGID_UR 0x0020 +#define LANGID_UR 0x0020 +#define LANGID_UR_PK 0x0420 +#define LANGID_UR_PK 0x0420 +#define LANGID_UR_IN 0x0820 +#define LANGID_UR_IN 0x0820 +#define LANGID_ID 0x0021 +#define LANGID_ID 0x0021 +#define LANGID_ID_ID 0x0421 +#define LANGID_ID_ID 0x0421 +#define LANGID_UK 0x0022 +#define LANGID_UK 0x0022 +#define LANGID_UK_UA 0x0422 +#define LANGID_UK_UA 0x0422 +#define LANGID_BE 0x0023 +#define LANGID_BE 0x0023 +#define LANGID_BE_BY 0x0423 +#define LANGID_BE_BY 0x0423 +#define LANGID_SL 0x0024 +#define LANGID_SL 0x0024 +#define LANGID_SL_SI 0x0424 +#define LANGID_SL_SI 0x0424 +#define LANGID_ET 0x0025 +#define LANGID_ET 0x0025 +#define LANGID_ET_EE 0x0425 +#define LANGID_ET_EE 0x0425 +#define LANGID_LV 0x0026 +#define LANGID_LV 0x0026 +#define LANGID_LV_LV 0x0426 +#define LANGID_LV_LV 0x0426 +#define LANGID_LT 0x0027 +#define LANGID_LT 0x0027 +#define LANGID_LT_LT 0x0427 +#define LANGID_LT_LT 0x0427 +#define LANGID_TG 0x0028 +#define LANGID_TG 0x0028 +#define LANGID_TG_CYRL_TJ 0x0428 +#define LANGID_TG_CYRL_TJ 0x0428 +#define LANGID_TG_CYRL 0x7C28 +#define LANGID_TG_CYRL 0x7C28 +#define LANGID_FA 0x0029 +#define LANGID_FA 0x0029 +#define LANGID_FA_IR 0x0429 +#define LANGID_FA_IR 0x0429 +#define LANGID_VI 0x002A +#define LANGID_VI 0x002A +#define LANGID_VI_VN 0x042A +#define LANGID_VI_VN 0x042A +#define LANGID_HY 0x002B +#define LANGID_HY 0x002B +#define LANGID_HY_AM 0x042B +#define LANGID_HY_AM 0x042B +#define LANGID_AZ 0x002C +#define LANGID_AZ 0x002C +#define LANGID_AZ_LATN_AZ 0x042C +#define LANGID_AZ_LATN_AZ 0x042C +#define LANGID_AZ_CYRL_AZ 0x082C +#define LANGID_AZ_CYRL_AZ 0x082C +#define LANGID_AZ_CYRL 0x742C +#define LANGID_AZ_CYRL 0x742C +#define LANGID_AZ_LATN 0x782C +#define LANGID_AZ_LATN 0x782C +#define LANGID_EU 0x002D +#define LANGID_EU 0x002D +#define LANGID_EU_ES 0x042D +#define LANGID_EU_ES 0x042D +#define LANGID_HSB 0x002E +#define LANGID_HSB 0x002E +#define LANGID_HSB_DE 0x042E +#define LANGID_HSB_DE 0x042E +#define LANGID_DSB_DE 0x082E +#define LANGID_DSB_DE 0x082E +#define LANGID_DSB 0x7C2E +#define LANGID_DSB 0x7C2E +#define LANGID_MK 0x002F +#define LANGID_MK 0x002F +#define LANGID_MK_MK 0x042F +#define LANGID_MK_MK 0x042F +#define LANGID_ST 0x0030 +#define LANGID_ST 0x0030 +#define LANGID_ST_ZA 0x0430 +#define LANGID_ST_ZA 0x0430 +#define LANGID_TS 0x0031 +#define LANGID_TS 0x0031 +#define LANGID_TS_ZA 0x0431 +#define LANGID_TS_ZA 0x0431 +#define LANGID_TN 0x0032 +#define LANGID_TN 0x0032 +#define LANGID_TN_ZA 0x0432 +#define LANGID_TN_ZA 0x0432 +#define LANGID_TN_BW 0x0832 +#define LANGID_TN_BW 0x0832 +#define LANGID_VE 0x0033 +#define LANGID_VE 0x0033 +#define LANGID_VE_ZA 0x0433 +#define LANGID_VE_ZA 0x0433 +#define LANGID_XH 0x0034 +#define LANGID_XH 0x0034 +#define LANGID_XH_ZA 0x0434 +#define LANGID_XH_ZA 0x0434 +#define LANGID_ZU 0x0035 +#define LANGID_ZU 0x0035 +#define LANGID_ZU_ZA 0x0435 +#define LANGID_ZU_ZA 0x0435 +#define LANGID_AF 0x0036 +#define LANGID_AF 0x0036 +#define LANGID_AF_ZA 0x0436 +#define LANGID_AF_ZA 0x0436 +#define LANGID_KA 0x0037 +#define LANGID_KA 0x0037 +#define LANGID_KA_GE 0x0437 +#define LANGID_KA_GE 0x0437 +#define LANGID_FO 0x0038 +#define LANGID_FO 0x0038 +#define LANGID_FO_FO 0x0438 +#define LANGID_FO_FO 0x0438 +#define LANGID_HI 0x0039 +#define LANGID_HI 0x0039 +#define LANGID_HI_IN 0x0439 +#define LANGID_HI_IN 0x0439 +#define LANGID_MT 0x003A +#define LANGID_MT 0x003A +#define LANGID_MT_MT 0x043A +#define LANGID_MT_MT 0x043A +#define LANGID_SE 0x003B +#define LANGID_SE 0x003B +#define LANGID_SE_NO 0x043B +#define LANGID_SE_NO 0x043B +#define LANGID_SE_SE 0x083B +#define LANGID_SE_SE 0x083B +#define LANGID_SE_FI 0x0C3B +#define LANGID_SE_FI 0x0C3B +#define LANGID_SMJ_NO 0x103B +#define LANGID_SMJ_NO 0x103B +#define LANGID_SMJ_SE 0x143B +#define LANGID_SMJ_SE 0x143B +#define LANGID_SMA_NO 0x183B +#define LANGID_SMA_NO 0x183B +#define LANGID_SMA_SE 0x1C3B +#define LANGID_SMA_SE 0x1C3B +#define LANGID_SMS_FI 0x203B +#define LANGID_SMS_FI 0x203B +#define LANGID_SMN_FI 0x243B +#define LANGID_SMN_FI 0x243B +#define LANGID_SMN 0x703B +#define LANGID_SMN 0x703B +#define LANGID_SMS 0x743B +#define LANGID_SMS 0x743B +#define LANGID_SMA 0x783B +#define LANGID_SMA 0x783B +#define LANGID_SMJ 0x7C3B +#define LANGID_SMJ 0x7C3B +#define LANGID_GA 0x003C +#define LANGID_GA 0x003C +#define LANGID_GA_IE 0x083C +#define LANGID_GA_IE 0x083C +#define LANGID_YI 0x003D +#define LANGID_YI 0x003D +#define LANGID_YI_001 0x043D +#define LANGID_YI_001 0x043D +#define LANGID_MS 0x003E +#define LANGID_MS 0x003E +#define LANGID_MS_MY 0x043E +#define LANGID_MS_MY 0x043E +#define LANGID_MS_BN 0x083E +#define LANGID_MS_BN 0x083E +#define LANGID_KK 0x003F +#define LANGID_KK 0x003F +#define LANGID_KK_KZ 0x043F +#define LANGID_KK_KZ 0x043F +#define LANGID_KK_LATN_KZ 0x083F +#define LANGID_KK_LATN_KZ 0x083F +#define LANGID_KK_CYRL 0x783F +#define LANGID_KK_CYRL 0x783F +#define LANGID_KK_LATN 0x7C3F +#define LANGID_KK_LATN 0x7C3F +#define LANGID_KY 0x0040 +#define LANGID_KY 0x0040 +#define LANGID_KY_KG 0x0440 +#define LANGID_KY_KG 0x0440 +#define LANGID_SW 0x0041 +#define LANGID_SW 0x0041 +#define LANGID_SW_KE 0x0441 +#define LANGID_SW_KE 0x0441 +#define LANGID_TK 0x0042 +#define LANGID_TK 0x0042 +#define LANGID_TK_TM 0x0442 +#define LANGID_TK_TM 0x0442 +#define LANGID_UZ 0x0043 +#define LANGID_UZ 0x0043 +#define LANGID_UZ_LATN_UZ 0x0443 +#define LANGID_UZ_LATN_UZ 0x0443 +#define LANGID_UZ_CYRL_UZ 0x0843 +#define LANGID_UZ_CYRL_UZ 0x0843 +#define LANGID_UZ_CYRL 0x7843 +#define LANGID_UZ_CYRL 0x7843 +#define LANGID_UZ_LATN 0x7C43 +#define LANGID_UZ_LATN 0x7C43 +#define LANGID_TT 0x0044 +#define LANGID_TT 0x0044 +#define LANGID_TT_RU 0x0444 +#define LANGID_TT_RU 0x0444 +#define LANGID_BN 0x0045 +#define LANGID_BN 0x0045 +#define LANGID_BN_IN 0x0445 +#define LANGID_BN_IN 0x0445 +#define LANGID_BN_BD 0x0845 +#define LANGID_BN_BD 0x0845 +#define LANGID_PA 0x0046 +#define LANGID_PA 0x0046 +#define LANGID_PA_IN 0x0446 +#define LANGID_PA_IN 0x0446 +#define LANGID_PA_ARAB_PK 0x0846 +#define LANGID_PA_ARAB_PK 0x0846 +#define LANGID_PA_ARAB 0x7C46 +#define LANGID_PA_ARAB 0x7C46 +#define LANGID_GU 0x0047 +#define LANGID_GU 0x0047 +#define LANGID_GU_IN 0x0447 +#define LANGID_GU_IN 0x0447 +#define LANGID_OR 0x0048 +#define LANGID_OR 0x0048 +#define LANGID_OR_IN 0x0448 +#define LANGID_OR_IN 0x0448 +#define LANGID_TA 0x0049 +#define LANGID_TA 0x0049 +#define LANGID_TA_IN 0x0449 +#define LANGID_TA_IN 0x0449 +#define LANGID_TA_LK 0x0849 +#define LANGID_TA_LK 0x0849 +#define LANGID_TE 0x004A +#define LANGID_TE 0x004A +#define LANGID_TE_IN 0x044A +#define LANGID_TE_IN 0x044A +#define LANGID_KN 0x004B +#define LANGID_KN 0x004B +#define LANGID_KN_IN 0x044B +#define LANGID_KN_IN 0x044B +#define LANGID_ML 0x004C +#define LANGID_ML 0x004C +#define LANGID_ML_IN 0x044C +#define LANGID_ML_IN 0x044C +#define LANGID_AS 0x004D +#define LANGID_AS 0x004D +#define LANGID_AS_IN 0x044D +#define LANGID_AS_IN 0x044D +#define LANGID_MR 0x004E +#define LANGID_MR 0x004E +#define LANGID_MR_IN 0x044E +#define LANGID_MR_IN 0x044E +#define LANGID_SA 0x004F +#define LANGID_SA 0x004F +#define LANGID_SA_IN 0x044F +#define LANGID_SA_IN 0x044F +#define LANGID_MN 0x0050 +#define LANGID_MN 0x0050 +#define LANGID_MN_MN 0x0450 +#define LANGID_MN_MN 0x0450 +#define LANGID_MN_MONG_CN 0x0850 +#define LANGID_MN_MONG_CN 0x0850 +#define LANGID_MN_MONG_MN 0x0C50 +#define LANGID_MN_MONG_MN 0x0C50 +#define LANGID_MN_CYRL 0x7850 +#define LANGID_MN_CYRL 0x7850 +#define LANGID_MN_MONG 0x7C50 +#define LANGID_MN_MONG 0x7C50 +#define LANGID_BO 0x0051 +#define LANGID_BO 0x0051 +#define LANGID_BO_CN 0x0451 +#define LANGID_BO_CN 0x0451 +#define LANGID_BO_BT 0x0851 +#define LANGID_BO_BT 0x0851 +#define LANGID_DZ_BT 0x0C51 +#define LANGID_DZ_BT 0x0C51 +#define LANGID_CY 0x0052 +#define LANGID_CY 0x0052 +#define LANGID_CY_GB 0x0452 +#define LANGID_CY_GB 0x0452 +#define LANGID_KM 0x0053 +#define LANGID_KM 0x0053 +#define LANGID_KM_KH 0x0453 +#define LANGID_KM_KH 0x0453 +#define LANGID_LO 0x0054 +#define LANGID_LO 0x0054 +#define LANGID_LO_LA 0x0454 +#define LANGID_LO_LA 0x0454 +#define LANGID_MY 0x0055 +#define LANGID_MY 0x0055 +#define LANGID_MY_MM 0x0455 +#define LANGID_MY_MM 0x0455 +#define LANGID_GL 0x0056 +#define LANGID_GL 0x0056 +#define LANGID_GL_ES 0x0456 +#define LANGID_GL_ES 0x0456 +#define LANGID_KOK 0x0057 +#define LANGID_KOK 0x0057 +#define LANGID_KOK_IN 0x0457 +#define LANGID_KOK_IN 0x0457 +#define LANGID_MNI 0x0058 +#define LANGID_MNI 0x0058 +#define LANGID_MNI_IN 0x0458 +#define LANGID_MNI_IN 0x0458 +#define LANGID_SD 0x0059 +#define LANGID_SD 0x0059 +#define LANGID_SD_DEVA_IN 0x0459 +#define LANGID_SD_DEVA_IN 0x0459 +#define LANGID_SD_ARAB_PK 0x0859 +#define LANGID_SD_ARAB_PK 0x0859 +#define LANGID_SD_ARAB 0x7C59 +#define LANGID_SD_ARAB 0x7C59 +#define LANGID_SYR 0x005A +#define LANGID_SYR 0x005A +#define LANGID_SYR_SY 0x045A +#define LANGID_SYR_SY 0x045A +#define LANGID_SI 0x005B +#define LANGID_SI 0x005B +#define LANGID_SI_LK 0x045B +#define LANGID_SI_LK 0x045B +#define LANGID_CHR 0x005C +#define LANGID_CHR 0x005C +#define LANGID_CHR_CHER_US 0x045C +#define LANGID_CHR_CHER_US 0x045C +#define LANGID_CHR_CHER 0x7C5C +#define LANGID_CHR_CHER 0x7C5C +#define LANGID_IU 0x005D +#define LANGID_IU 0x005D +#define LANGID_IU_CANS_CA 0x045D +#define LANGID_IU_CANS_CA 0x045D +#define LANGID_IU_LATN_CA 0x085D +#define LANGID_IU_LATN_CA 0x085D +#define LANGID_IU_CANS 0x785D +#define LANGID_IU_CANS 0x785D +#define LANGID_IU_LATN 0x7C5D +#define LANGID_IU_LATN 0x7C5D +#define LANGID_AM 0x005E +#define LANGID_AM 0x005E +#define LANGID_AM_ET 0x045E +#define LANGID_AM_ET 0x045E +#define LANGID_TZM 0x005F +#define LANGID_TZM 0x005F +#define LANGID_TZM_ARAB_MA 0x045F +#define LANGID_TZM_ARAB_MA 0x045F +#define LANGID_TZM_LATN_DZ 0x085F +#define LANGID_TZM_LATN_DZ 0x085F +#define LANGID_TMZ_MA 0x0C5F +#define LANGID_TMZ_MA 0x0C5F +#define LANGID_TZM_TFNG_MA 0x105F +#define LANGID_TZM_TFNG_MA 0x105F +#define LANGID_TZM_TFNG 0x785F +#define LANGID_TZM_TFNG 0x785F +#define LANGID_TZM_LATN 0x7C5F +#define LANGID_TZM_LATN 0x7C5F +#define LANGID_KS 0x0060 +#define LANGID_KS 0x0060 +#define LANGID_KS_ARAB 0x0460 +#define LANGID_KS_ARAB 0x0460 +#define LANGID_KS_DEVA_IN 0x0860 +#define LANGID_KS_DEVA_IN 0x0860 +#define LANGID_NE 0x0061 +#define LANGID_NE 0x0061 +#define LANGID_NE_NP 0x0461 +#define LANGID_NE_NP 0x0461 +#define LANGID_NE_IN 0x0861 +#define LANGID_NE_IN 0x0861 +#define LANGID_FY 0x0062 +#define LANGID_FY 0x0062 +#define LANGID_FY_NL 0x0462 +#define LANGID_FY_NL 0x0462 +#define LANGID_PS 0x0063 +#define LANGID_PS 0x0063 +#define LANGID_PS_AF 0x0463 +#define LANGID_PS_AF 0x0463 +#define LANGID_FIL 0x0064 +#define LANGID_FIL 0x0064 +#define LANGID_FIL_PH 0x0464 +#define LANGID_FIL_PH 0x0464 +#define LANGID_DV 0x0065 +#define LANGID_DV 0x0065 +#define LANGID_DV_MV 0x0465 +#define LANGID_DV_MV 0x0465 +#define LANGID_BIN 0x0066 +#define LANGID_BIN 0x0066 +#define LANGID_BIN_NG 0x0466 +#define LANGID_BIN_NG 0x0466 +#define LANGID_FF 0x0067 +#define LANGID_FF 0x0067 +#define LANGID_FF_NG 0x0467 +#define LANGID_FF_NG 0x0467 +#define LANGID_FF_LATN_SN 0x0867 +#define LANGID_FF_LATN_SN 0x0867 +#define LANGID_FF_LATN 0x7C67 +#define LANGID_FF_LATN 0x7C67 +#define LANGID_HA 0x0068 +#define LANGID_HA 0x0068 +#define LANGID_HA_LATN_NG 0x0468 +#define LANGID_HA_LATN_NG 0x0468 +#define LANGID_HA_LATN 0x7C68 +#define LANGID_HA_LATN 0x7C68 +#define LANGID_IBB 0x0069 +#define LANGID_IBB 0x0069 +#define LANGID_IBB_NG 0x0469 +#define LANGID_IBB_NG 0x0469 +#define LANGID_YO 0x006A +#define LANGID_YO 0x006A +#define LANGID_YO_NG 0x046A +#define LANGID_YO_NG 0x046A +#define LANGID_QUZ 0x006B +#define LANGID_QUZ 0x006B +#define LANGID_QUZ_BO 0x046B +#define LANGID_QUZ_BO 0x046B +#define LANGID_QUZ_EC 0x086B +#define LANGID_QUZ_EC 0x086B +#define LANGID_NSO 0x006C +#define LANGID_NSO 0x006C +#define LANGID_NSO_ZA 0x046C +#define LANGID_NSO_ZA 0x046C +#define LANGID_BA 0x006D +#define LANGID_BA 0x006D +#define LANGID_BA_RU 0x046D +#define LANGID_BA_RU 0x046D +#define LANGID_LB 0x006E +#define LANGID_LB 0x006E +#define LANGID_LB_LU 0x046E +#define LANGID_LB_LU 0x046E +#define LANGID_KL 0x006F +#define LANGID_KL 0x006F +#define LANGID_KL_GL 0x046F +#define LANGID_KL_GL 0x046F +#define LANGID_IG 0x0070 +#define LANGID_IG 0x0070 +#define LANGID_IG_NG 0x0470 +#define LANGID_IG_NG 0x0470 +#define LANGID_KR 0x0071 +#define LANGID_KR 0x0071 +#define LANGID_KR_LATN_NG 0x0471 +#define LANGID_KR_LATN_NG 0x0471 +#define LANGID_OM 0x0072 +#define LANGID_OM 0x0072 +#define LANGID_OM_ET 0x0472 +#define LANGID_OM_ET 0x0472 +#define LANGID_TI 0x0073 +#define LANGID_TI 0x0073 +#define LANGID_TI_ET 0x0473 +#define LANGID_TI_ET 0x0473 +#define LANGID_TI_ER 0x0873 +#define LANGID_TI_ER 0x0873 +#define LANGID_GN 0x0074 +#define LANGID_GN 0x0074 +#define LANGID_GN_PY 0x0474 +#define LANGID_GN_PY 0x0474 +#define LANGID_HAW 0x0075 +#define LANGID_HAW 0x0075 +#define LANGID_HAW_US 0x0475 +#define LANGID_HAW_US 0x0475 +#define LANGID_LA 0x0076 +#define LANGID_LA 0x0076 +#define LANGID_LA_VA 0x0476 +#define LANGID_LA_VA 0x0476 +#define LANGID_SO 0x0077 +#define LANGID_SO 0x0077 +#define LANGID_SO_SO 0x0477 +#define LANGID_SO_SO 0x0477 +#define LANGID_II 0x0078 +#define LANGID_II 0x0078 +#define LANGID_II_CN 0x0478 +#define LANGID_II_CN 0x0478 +#define LANGID_PAP 0x0079 +#define LANGID_PAP 0x0079 +#define LANGID_PAP_029 0x0479 +#define LANGID_PAP_029 0x0479 +#define LANGID_ARN 0x007A +#define LANGID_ARN 0x007A +#define LANGID_ARN_CL 0x047A +#define LANGID_ARN_CL 0x047A +#define LANGID_MOH 0x007C +#define LANGID_MOH 0x007C +#define LANGID_MOH_CA 0x047C +#define LANGID_MOH_CA 0x047C +#define LANGID_BR 0x007E +#define LANGID_BR 0x007E +#define LANGID_BR_FR 0x047E +#define LANGID_BR_FR 0x047E +#define LANGID_UG 0x0080 +#define LANGID_UG 0x0080 +#define LANGID_UG_CN 0x0480 +#define LANGID_UG_CN 0x0480 +#define LANGID_MI 0x0081 +#define LANGID_MI 0x0081 +#define LANGID_MI_NZ 0x0481 +#define LANGID_MI_NZ 0x0481 +#define LANGID_OC 0x0082 +#define LANGID_OC 0x0082 +#define LANGID_OC_FR 0x0482 +#define LANGID_OC_FR 0x0482 +#define LANGID_CO 0x0083 +#define LANGID_CO 0x0083 +#define LANGID_CO_FR 0x0483 +#define LANGID_CO_FR 0x0483 +#define LANGID_GSW 0x0084 +#define LANGID_GSW 0x0084 +#define LANGID_GSW_FR 0x0484 +#define LANGID_GSW_FR 0x0484 +#define LANGID_SAH 0x0085 +#define LANGID_SAH 0x0085 +#define LANGID_SAH_RU 0x0485 +#define LANGID_SAH_RU 0x0485 +#define LANGID_QUT 0x0086 +#define LANGID_QUT 0x0086 +#define LANGID_QUT_GT 0x0486 +#define LANGID_QUT_GT 0x0486 +#define LANGID_RW 0x0087 +#define LANGID_RW 0x0087 +#define LANGID_RW_RW 0x0487 +#define LANGID_RW_RW 0x0487 +#define LANGID_WO 0x0088 +#define LANGID_WO 0x0088 +#define LANGID_WO_SN 0x0488 +#define LANGID_WO_SN 0x0488 +#define LANGID_PRS 0x008C +#define LANGID_PRS 0x008C +#define LANGID_PRS_AF 0x048C +#define LANGID_PRS_AF 0x048C +#define LANGID_PLT_MG 0x048D +#define LANGID_PLT_MG 0x048D +#define LANGID_ZH_YUE_HK 0x048E +#define LANGID_ZH_YUE_HK 0x048E +#define LANGID_TDD_TALE_CN 0x048F +#define LANGID_TDD_TALE_CN 0x048F +#define LANGID_KHB_TALU_CN 0x0490 +#define LANGID_KHB_TALU_CN 0x0490 +#define LANGID_GD 0x0091 +#define LANGID_GD 0x0091 +#define LANGID_GD_GB 0x0491 +#define LANGID_GD_GB 0x0491 +#define LANGID_KU 0x0092 +#define LANGID_KU 0x0092 +#define LANGID_KU_ARAB_IQ 0x0492 +#define LANGID_KU_ARAB_IQ 0x0492 +#define LANGID_KU_ARAB 0x7C92 +#define LANGID_KU_ARAB 0x7C92 +#define LANGID_QUC 0x0093 +#define LANGID_QUC 0x0093 +#define LANGID_QUC_CO 0x0493 +#define LANGID_QUC_CO 0x0493 +#define LANGID_QPS_PLOCA 0x05FE +#define LANGID_QPS_PLOCA 0x05FE +#define LANGID_QPS_PLOCM 0x09FF +#define LANGID_QPS_PLOCM 0x09FF + +/* USB 2.0 §9.6.6 "Endpoint", field bEndpointAddress, bit 7 */ +#define TUD_ENDPOINT_OUT 0x00 +#define TUD_ENDPOINT_IN 0x80 + +#define TU_UTF16(str) u ## str + +#endif /* _USB_HELPERS_H_ */ diff --git a/libusb/tusb_helpers.h.gen b/libusb/tusb_helpers.h.gen new file mode 100755 index 0000000..a348b16 --- /dev/null +++ b/libusb/tusb_helpers.h.gen @@ -0,0 +1,82 @@ +#!/usr/bin/env bash +# -*- Mode: C -*- +set -e +exec >"${0%.gen}" +cat <<'EOT' +/* tusb_helpers.h - Preprocessor macros that I think should be included in TinyUSB + * + * Copyright (c) 2024 Luke T. Shumaker <lukeshu@lukeshu.com> + * + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + */ + +#ifndef _USB_HELPERS_H_ +#define _USB_HELPERS_H_ + +/* USB 2.0 §9.6.7 "String" says "The list of currently defined USB LANGIDs can be found at + * http://www.usb.org/developers/docs.html.", but that page 404s. + * + * Once upon a time the USB-IF (usb.org) published a "Language Identifiers (LANGIDs)" version 1.0, + * dated 2000-03-29. There is no longer any mention of this on usb.org, but I found a copy at + * http://www.baiheee.com/Documents/090518/090518112619/USB_LANGIDs.pdf + * + * So how does the USB-IF defined LANGIDs these days? + * + * https://www.usb.org/deprecated-links-and-tools says "To get the latest LANGID definitions go to + * https://docs.microsoft.com/en-us/windows/desktop/intl/language-identifier-constants-and-strings. This + * page will change as new LANGIDs are added." That page has no list of LANGIDs, but says "For the + * predefined primary language identifiers with their valid sublanguage identifiers, see + * [\[MS-LCID\]: Windows Language Code Identifier (LCID) + * Reference](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/70feba9f-294e-491e-b6eb-565326e84c37f)." + * That page at the time of this writing as a PDF marked as version 16.0, dated 2024-04-24: + * https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-LCID/%5bMS-LCID%5d.pdf + * [MS-LCID] defines an LCID as a 32-bit value consisting of a 16-bit a "Language ID", a 4-bit "Sort + * ID", and 12 reserved bits. + * + * That is to say: The USB-IF has said in essence "USB LANGIDs are defined to be the 'Language ID' + * portion of Microsoft Windows LCIDs (Language Code Identifiers); refer to Microsoft's published + * list of LCID Language IDs for a list of USB LANGIDs." + * + * The scheme for Language IDs is that the least-significant-byte is "primary" ID and the + * most-significant-byte is a "sublanguage" ID within that. With this in mind, Microsoft's choice + * to sort their list of by most-significant-byte was a poor editorial choice. + */ +EOT +[ -d 3rd-party ] || mkdir 3rd-party +[ -f 3rd-party/MS-LCID.pdf ] || wget -O 3rd-party/MS-LCID.pdf 'https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-LCID/%5bMS-LCID%5d.pdf' +[ -f 3rd-party/MS-LCID.txt ] || pdftotext -layout 3rd-party/MS-LCID.pdf +<3rd-party/MS-LCID.txt \ + grep -E '^\s*0x[0-9A-F]{4}\s+[a-z]' | sed 's/,.*//' | grep -v reserved | # find the lines we're interested in + sed -E 's/^\s*0x(..)(..)\s+(\S.*)/\2 \1 \3/p' | tr '[:lower:]-' '[:upper:]_' | # format them as 'PRIhex SUBhex UPPER_STR' + sort | + sed -E 's/(..) (..) (.*)/#define LANGID_\3 0x\2\1/' | # format them as '#define LANGID_UPPER_STR 0xSUBPRI' + column --table --output-separator=' ' +cat <<'EOT' + +/* USB 2.0 §9.6.6 "Endpoint", field bEndpointAddress, bit 7 */ +#define TUD_ENDPOINT_OUT 0x00 +#define TUD_ENDPOINT_IN 0x80 + +#define TU_UTF16(str) u ## str + +#endif /* _USB_HELPERS_H_ */ +EOT diff --git a/libusb/usb_common.c b/libusb/usb_common.c new file mode 100644 index 0000000..f10ace8 --- /dev/null +++ b/libusb/usb_common.c @@ -0,0 +1,189 @@ +/* usb_common.c - Common framework for implementing multiple USB devices at once + * + * Copyright (C) 2024 Luke T. Shumaker <lukeshu@lukeshu.com> + * SPDX-Licence-Identifier: AGPL-3.0-or-later + */ + +#include <stdint.h> /* for uint{n}_t types */ +#include <string.h> /* memcpy(newlib) */ +#include <assert.h> /* for assert(newlib) */ +#include <stdlib.h> /* for malloc(pico_malloc), realloc(pico_malloc), reallocarray(pico_malloc) */ +#include "bsp/board_api.h" /* for board_init(), board_init_after_usb(), board_usb_get_serial(TinyUSB) */ +#include "tusb.h" /* for various tusb_*_t types */ + +#include "tusb_helpers.h" /* for LANGID_*, TU_UTF16() */ +#include "usb_common.h" + +/* Strings ********************************************************************/ + +/** + * Return a pointer to the USB "String Descriptor" (see USB 2.0 §9.6.7 + * "String"). + */ +uint16_t const *tud_descriptor_string_cb(uint8_t strid, uint16_t langid) { + static struct TU_ATTR_PACKED { + uint8_t bLength; + uint8_t bDescriptorType; + uint16_t bString[(0xFF-2)/2]; + } desc; + TU_VERIFY_STATIC(sizeof desc == (0xFF/2)*2, "incorrect size"); + + static uint16_t const langids[] = { + LANGID_EN_US, + }; + + size_t bytelen = 0; + if (strid == 0) { + memcpy(desc.bString, langids, sizeof langids); + bytelen = sizeof langids; + } else { +#define CONST_STR(str) bytelen = ((sizeof (str))-1); memcpy(desc.bString, (str), ((sizeof (str))-1)); + switch (langid) { + case LANGID_EN_US: + switch (strid) { + case STRID_MANUF: CONST_STR(TU_UTF16("Umorpha Systems")); break; + case STRID_PRODUCT: CONST_STR(TU_UTF16("SBC-Harness Keyboard")); break; + case STRID_CFG: CONST_STR(TU_UTF16("Standard Configuration")); break; + case STRID_KBD_IFC: CONST_STR(TU_UTF16("Keyboard Interface")); break; + case STRID_SERIAL: +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Waddress-of-packed-member" + bytelen = 2 * board_usb_get_serial(desc.bString, TU_ARRAY_SIZE(desc.bString)); +#pragma GCC diagnostic pop + break; + default: + printf("GET STRING: unknown string id=%"PRIu8, strid); + return NULL; + } + break; + default: + printf("GET STRING: unknown LANGID=%"PRIx16, langid); + return NULL; + } + } + assert(bytelen <= sizeof desc.bString); + desc.bLength = bytelen + 2; + desc.bDescriptorType = TUSB_DESC_STRING; + return (uint16_t *)&desc; +} + +/* Globals ********************************************************************/ + +uint8_t cfgnum_std = 0; + +void usb_common_earlyinit(void) { + if (cfgnum_std) + return; + cfgnum_std = usb_add_config( + STRID_CFG, /* iConfiguration ; Index of string descriptor describing this configuration */ + TUSB_DESC_CONFIG_ATT_REMOTE_WAKEUP, /* bmAttributes ; Bitmap of flags (self-powered and remote-wakeup are the only flags defined in USB 2.0) */ + 100); /* bMaxPower (in mA) ; Maximum power consumption of the device when in this configuration */ +} + +void usb_common_lateinit(void) { + board_init(); + tud_init(BOARD_TUD_RHPORT); + if (board_init_after_tusb) + board_init_after_tusb(); +} + +COROUTINE usb_common_cr(void *_arg) { + (void) _arg; + cr_begin(); + + for (;;) { + tud_task(); + cr_yield(); + } + + cr_end(); +} + +/* Main utilities *************************************************************/ + +static uint8_t configc = 0; +static uint8_t **configv = NULL; + +uint8_t usb_add_config(uint8_t iConfiguration, uint8_t bmAttributes, uint8_t bMaxPower_mA) { + uint8_t *desc; + + configv = reallocarray(configv, ++configc, sizeof configv[0]); + desc = configv[configc-1] = malloc(TUD_CONFIG_DESC_LEN); + + memcpy(desc, (uint8_t[]){ + /* USB configuration descriptor header (USB 2.0 §9.6.4 "Configuration") */ + TUD_CONFIG_DESCRIPTOR( + configc, /* bConfigurationValue */ + 0, /* bNumInterfaces (will be incremented by usb_add_interface() */ + iConfiguration, /* iConfiguration */ + TUD_CONFIG_DESC_LEN, /* wTotalLength (will be incremented by usb_add_interface() */ + bmAttributes, /* bmAttributes */ + bMaxPower_mA+1), /* bMaxPower (+1 because tusb just does n/2 instead of (n+1)/2) */ + }, TUD_CONFIG_DESC_LEN); + + return configc; +} + +uint8_t usb_add_interface(uint8_t cfg_num, uint16_t ifc_len, uint8_t *ifc_dat) { + assert(cfg_num > 0 && cfg_num <= configc); + assert(ifc_len >= 3); + assert(ifc_dat); + + uint8_t *desc = configv[cfg_num-1]; + // wTotalLength + uint16_t total_len = TU_U16(desc[3], desc[2]) + ifc_len; + desc[3] = TU_U16_HIGH(total_len); + desc[2] = TU_U16_LOW(total_len); + // bNumInterfaces + ifc_dat[3] = desc[4]++; + + desc = configv[cfg_num-1] = realloc(desc, total_len); + memcpy(&desc[total_len-ifc_len], ifc_dat, ifc_len); + + return ifc_dat[3]; +} + +/** + * Return a pointer to the USB "Device Descriptor" (see USB 2.0 §9.6.1 + * "Device") as a byte-array. + */ +uint8_t const *tud_descriptor_device_cb(void) { + /* Our device descriptor is static, so just declare it as a + * static const. */ + static tusb_desc_device_t desc = { + .bLength = sizeof(tusb_desc_device_t), + .bDescriptorType = TUSB_DESC_DEVICE, + .bcdUSB = 0x200, /* USB 2.0 */ + + /* Use the "base device class", which means to use information + * from interface descriptors instead of a global device + * descriptor. */ + .bDeviceClass = 0x00, + .bDeviceSubClass = 0x00, + .bDeviceProtocol = 0x00, + + .bMaxPacketSize0 = CFG_TUD_ENDPOINT0_SIZE, + + .idVendor = 0xCAFE, /* Vendor ID (assigned by the USB-IF) */ + .idProduct = 0x4001, /* Product ID (assigned by the manufacturer) */ + .bcdDevice = 0x0100, /* Device release number */ + + .iManufacturer = STRID_MANUF, /* Index of string descriptor describing manufacturer */ + .iProduct = STRID_PRODUCT, /* Index of string descriptor describing product */ + .iSerialNumber = STRID_SERIAL, /* Index of string descriptor describing the device's serial number */ + + .bNumConfigurations = 0, /* Number of possible configurations */ + }; + desc.bNumConfigurations = configc; + return (uint8_t const *) &desc; +} + +/** + * Return a pointer to the USB config "Configuration Descriptor" (see + * USB 2.0 §9.6.4 "Configuration") for the given index. + */ +uint8_t const *tud_descriptor_configuration_cb(uint8_t index) { + if (index >= configc) + return NULL; + return configv[index]; +} diff --git a/libusb/usb_common.h b/libusb/usb_common.h new file mode 100644 index 0000000..3b45246 --- /dev/null +++ b/libusb/usb_common.h @@ -0,0 +1,59 @@ +/* usb_common.h - Common framework for implementing multiple USB devices at once + * + * Copyright (C) 2024 Luke T. Shumaker <lukeshu@lukeshu.com> + * SPDX-Licence-Identifier: AGPL-3.0-or-later + */ + +#ifndef _USB_COMMON_H_ +#define _USB_COMMON_H_ + +#include "coroutine.h" + +/* Strings ********************************************************************/ + +enum { + /* Be sure to keep this list in-sync with + * usb_common.c:tud_descriptor_string_cb() */ + STRID_LANGID = 0, + STRID_MANUF, + STRID_PRODUCT, + STRID_SERIAL, + STRID_CFG, + STRID_KBD_IFC, + + STRID_NONE = 0, +}; + +/* Globals ********************************************************************/ + +extern uint8_t cfgnum_std; +void usb_common_earlyinit(void); +void usb_common_lateinit(void); +COROUTINE usb_common_cr(void *arg); + +/* Main utilities *************************************************************/ + +/** + * Declare a new TUD configuration. + * + * @param iConfiguration : ID of the string descriptor describing this configuration + * @param bmAttributes : bitmap of flags; TUSB_DESC_CONFIG_ATT_{REMOTE_WAKUP,SELF_POWERED} + * @param bMaxPower_mA : maximum power consumption of the device when in this configuration, in mA + * @return the configuration number for the created config + */ +uint8_t usb_add_config(uint8_t iConfiguration, uint8_t bmAttributes, uint8_t bMaxPower_mA); + +/** + * Add an interface to a configuration that has been created with usb_add_config(). + * + * @param cfg_num : the value returned from usb_add_config() + * @param ifc_len : the length of ifc_Dat + * @param ifc_dat : the raw descriptor data for the interface (probably created by + * TUD_{CLASS}_DESCRIPTOR(); grep TinyUSB/src/device/usbd.h for '#define + * TUD_\S*_DESCRIPTOR(_itfnum'). The interface number in this data is overwritten with the + * appropriate number for this config. + * @return the interface number for the added interface + */ +uint8_t usb_add_interface(uint8_t cfg_num, uint16_t ifc_len, uint8_t *ifc_dat); + +#endif /* _USB_COMMON_H_ */ |