SDAA062 September   2025 TMS320F28P559SJ-Q1

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1Introduction
    1. 1.1 Intelligent Cabin and IVI System
    2. 1.2 USB Interface Application in IVI
    3. 1.3 TMS320F28P55x Introduction
  5. 2USB Composite Device Enumeration and Data Report
    1. 2.1 USB Composite Device Enumeration
      1. 2.1.1 Descriptor Structure
      2. 2.1.2 Descriptor Types
        1. 2.1.2.1 Device Descriptor
        2. 2.1.2.2 Configuration Descriptor
        3. 2.1.2.3 Interface Descriptor
        4. 2.1.2.4 Endpoint Descriptor
        5. 2.1.2.5 String Descriptor
    2. 2.2 USB Composite Device HID Data Report
      1. 2.2.1 Data Report Item
      2. 2.2.2 HID Report Descriptor Structure
        1. 2.2.2.1 Main Item
        2. 2.2.2.2 Global Item
        3. 2.2.2.3 Local Item
    3. 2.3 Example of Building a HID Report Descriptor
  6. 3Software Realization
    1. 3.1 APIs for USB Composite Device Initialization
      1. 3.1.1 USBStackModeSet
      2. 3.1.2 USBDCDCCompositeInit
      3. 3.1.3 USBDHIDCustomCompositeInit
      4. 3.1.4 USBDCompositeInit
    2. 3.2 APIs for USB Composite Device CDC Data Report
      1. 3.2.1 USBBufferSpaceAvailable
      2. 3.2.2 USBBufferWrite
      3. 3.2.3 USBBufferRead
      4. 3.2.4 USBDCDCTxHandler
      5. 3.2.5 USBDCDCRxHandler
    3. 3.3 APIs for USB Composite Device HID Data Report
      1. 3.3.1 USBDHIDCustomTouchEvent
      2. 3.3.2 USBDHIDCustomReportKey
    4. 3.4 APIs for USB Composite Device Simulation
      1. 3.4.1 MultTouchSimHandler
      2. 3.4.2 KeySimHandler
    5. 3.5 APIs for USB Device Operate States Query
      1. 3.5.1 USBDCDCControlHandler
      2. 3.5.2 CustomHandler
  7. 4System Test
    1. 4.1 Test Setup
    2. 4.2 USB SCI CDC Device Function Test
    3. 4.3 USB Touch Screen HID Device Function Test
    4. 4.4 USB Button HID Device Function Test
  8. 5Summary
  9. 6References
  10. 7Appendix

2.2.2.1 Main Item

Main item is used to define the data domain or a group of data domain. The data domain types are defined with bTag, which is listed in Table 2-5

Table 2-5 Main Item Definition and bTag Value
Item Type bTag Value Description
Input 0x8 USB device reports data to USB host
Output 0x9 USB host send data to USB device
Feature 0xB Return configuration information
Collection 0xA Start of data domain
End Collection 0xC End of data domain

With the input, output, and feature item types, the data bytes come after the bTag, describes the detailed functions of this main item. The complete definition can be found in USB-IF documents hid-6.2.2.7. The data bytes come after the collection. End collection item types are listed in Table 2-6.

Table 2-6 bTag Details on Collection and End Collection Item Types
Item Type bTag Value Description
Collection 0xA0 Physical: defines the USB device physical structures and connection. For example, key and scroll wheel
0xA1 Application: defines the input and corresponding output signal of the USB device. For example, touchpad finger position, volume control.
0xA2 Logical: maps the physical and application. For example defines the scroll wheel (physical) as the volume control (application)
0xA3 Start of data domain
End Collection 0xC0 Close an item collection