当前位置： 首页 > article >正文

USB键盘实现——字符串描述符（四）

article 2025/1/23 17:44:31

字符串描述符

字符串描述符内容解析和 HID鼠标 一致。

获取字符串描述符请求

标准设备请求

typedef struct __attribute__ ((packed)){
    union {
        struct __attribute__ ((packed)) {
          uint8_t recipient :  5; ///< Recipient type usb_request_recipient_t.
          uint8_t type      :  2; ///< Request type usb_request_type_t.
          uint8_t direction :  1; ///< Direction type. usb_dir_t
        } bmRequestType_bit;

        uint8_t bmRequestType;
    };

    uint8_t  bRequest;
    uint16_t wValue;
    uint16_t wIndex;
    uint16_t wLength;
} usb_control_request_t;

语言 ID 获取(字符串索引为 0)

USB 控制端点收到的数据

0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0
  • bmRequestType：0x80
    • 数据传输方向为 1，device-to-host
    • 标准请求
    • 请求的接收者为设备。
  • bRequest：0x06
    • GET_DESCRIPTOR 获取描述符请求。
  • wValue：0x0003（LSB）
    • 低位：0x03 字符串描述符
    • 高位：0x00 索引号，当前字符串索引为 0，表示获取语言 ID。
  • wIndex：0x0000（LSB）
    • 低位：0x00
    • 高位：0x00
  • wLength：0xff
    • 低位：0xff 请求返回的字节数为 0xff，设备实际返回的字节数可以比该域指定的字节数少。
    • 高位：0x00

语言 ID 返回

0x4 0x3 0x9 0x4
  • bLength：0x04
    • 描述符的长度。语言 ID 描述符的长度为 0x04。
  • bDescriptorType：0x03
    • 描述符的类型。字符串描述符的类型编码为 0x03。
  • 语言 ID：0x0409
  • 0x0409为美式英语的 ID。

厂商字符串获取(字符串索引为 1)

在 设备描述符，将 iManufacturer，的索引设置为 1。所以主机请求索引为 1 的字符串时，需要返回厂商字符串

USB 控制端点收到的数据

0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0
  • bmRequestType：0x80
    • 数据传输方向为 1，device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest：0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue：0x0003（LSB）
    • 低位：0x03 字符串描述符
    • 高位：0x001 索引号，当前字符串索引为 1，表示获取厂商字符串。
  • wIndex：0x0000（LSB）
    • 低位：0x09 主机使用获取到的语言 ID 0x0409。
    • 高位：0x04
  • wLength：0xff
    • 低位：0xff 请求返回的字节数为 0xff，设备实际返回的字节数可以比该域指定的字节数少。
    • 高位：0x00

厂商字符串返回

0x10 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0
  • bLength：0x10
    • 描述符的长度。本次使用的厂商字符串描述符的长度为 0x10。
  • bDescriptorType：0x03
    • 描述符的类型。字符串描述符的类型编码为 0x03。
  • 厂商字符串：
  • 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 UNICODE 编码的字符串，即为 tyustli

产品字符串获取(字符串索引为 2)

在 设备描述符，将 iProduct，的索引设置为 2。

USB 控制端点收到的数据

0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0
  • bmRequestType：0x80
    • 数据传输方向为 1，device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest：0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue：0x0003（LSB）
    • 低位：0x03 字符串描述符
    • 高位：0x002 索引号，当前字符串索引为 2，表示获取产品字符串。
  • wIndex：0x0000（LSB）
    • 低位：0x09 主机使用获取到的语言 ID 0x0409。
    • 高位：0x04
  • wLength：0xff
    • 低位：0xff 请求返回的字节数为 0xff，设备实际返回的字节数可以比该域指定的字节数少。
    • 高位：0x00

产品字符串返回

0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0
  • bLength：0x1e
    • 描述符的长度。本次使用的产品字符串描述符的长度为 0x1e。
  • bDescriptorType：0x03
    • 描述符的类型。字符串描述符的类型编码为 0x03。
  • 厂商字符串：
  • 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 UNICODE 编码的字符串，即为 tyustli Device

产品序列号字符串获取(字符串索引为 3)

在 设备描述符，将 iSerialNumber，的索引设置为 3。

USB 控制端点收到的数据

0x80 0x6 0x3 0x3 0x9 0x4 0xff 0x0
  • bmRequestType：0x80
    • 数据传输方向为 1，device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest：0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue：0x0003（LSB）
    • 低位：0x03 字符串描述符
    • 高位：0x003 索引号，当前字符串索引为 3，表示获取产品序列号字符串。
  • wIndex：0x0000（LSB）
    • 低位：0x09 主机使用获取到的语言 ID 0x0409。
    • 高位：0x04
  • wLength：0xff
    • 低位：0xff 请求返回的字节数为 0xff，设备实际返回的字节数可以比该域指定的字节数少。
    • 高位：0x00

产品序列号字符串返回

0xe 0x3 0x31 0x0 0x32 0x0 0x33 0x0 0x34 0x0 0x35 0x0 0x36 0x0
  • bLength：0x0e
    • 描述符的长度。本次使用的产品字符串描述符的长度为 0x0e。
  • bDescriptorType：0x03
    • 描述符的类型。字符串描述符的类型编码为 0x03。
  • 产品序列号字符串：
  • 0x31 0x0 0x32 0x0 0x33 0x0 0x34 0x0 0x35 0x0 0x36 0x0 UNICODE 编码的字符串，即为 123456

附 STM32 枚举日志

HID 键盘枚举日志

suspend int
bus reset int
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x40 0x0 
dcd xfer 12
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
bus reset int
output ep int 
send xfer complete event
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x0 0x5 0x4 0x0 0x0 0x0 0x0 0x0 
dcd xfer 0
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0 
dcd xfer 12
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
output ep int 
send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0xff 0x0 
dcd xfer 22
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x0 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x3 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer e
input ep int 
d->h :0xe 0x3 0x31 0x0 0x32 0x0 0x33 0x0 0x34 0x0 0x35 0x0 0x36 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0 
send xfer complete event
dcd xfer 4
input ep int 
d->h :0x4 0x3 0x9 0x4 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer 1e
input ep int 
d->h :0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x6 0x0 0x0 0xa 0x0 
send xfer complete event
get device qualifier
stall ep0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0 
dcd xfer 12
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x9 0x0 
send xfer complete event
dcd xfer 9
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x22 0x0 
send xfer complete event
dcd xfer 22
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x0 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x0 0x9 0x1 0x0 0x0 0x0 0x0 0x0 
send xfer complete event
edpt open
dcd xfer 0
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x21 0xa 0x0 0x0 0x0 0x0 0x0 0x0 
dcd xfer 0
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x81 0x6 0x0 0x22 0x0 0x0 0x81 0x0 
dcd xfer 40
input ep int 
d->h :0x5 0x1 0x9 0x6 0xa1 0x1 0x5 0x7 0x19 0xe0 0x29 0xe7 0x15 0x0 0x25 0x1 0x95 0x8 0x75 0x1 0x81 0x2 0x95 0x1 0x75 0x8 0x81 0x1 0x5 0x8 0x19 0x1 0x29 0x5 0x95 0x5 0x75 0x1 0x91 0x2 0x95 0x1 0x75 0x3 0x91 0x1 0x5 0x7 0x19 0x0 0x2a 0xff 0x0 0x15 0x0 0x26 0xff 0x0 0x95 0x6 0x75 0x8 0x81 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 1
input ep int 
d->h :0xc0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
output ep int 
send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x21 0x9 0x0 0x2 0x0 0x0 0x1 0x0 
dcd xfer 1
rxflvl int
output ep int 
send xfer complete event
dcd xfer 0
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0 
dcd xfer 4
input ep int 
d->h :0x4 0x3 0x9 0x4 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer 10
input ep int 
d->h :0x10 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer 1e
input ep int 
d->h :0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 0
rxflvl int
output ep int 
send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer 8
0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 
input ep int 
d->h :0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event

http://www.kler.cn/a/3511.html

相关文章：

  • MFC程序设计（二）基于对话框编程
  • 澎峰科技计算软件栈与沐曦GPU完成适配和互认证
  • 顺序表和链表(详解)
  • MTK MT6890：LCD ST7789P3驱动移植调试
  • Linux shell 批量验证端口连通性
  • 【BUUCTF】[GXYCTF2019]BabySQli
  • JNI原理及常用方法概述
  • 【软件测试】基础知识第一篇
  • 使用chatGPT实现数字自增动画
  • 数字信号处理_QA_2023_超长
  • [渗透教程]-004-嗅探工具-Nmap
  • STM32开发基础知识入门
  • MongoDB 6.0 入门（二）
  • javaEE初阶 — 博客系统的页面设计
  • 4年功能测试，我一进阶python接口自动化测试，跳槽拿了20k......
  • 第二章 作业（6789B）【编译原理】
  • python迭代器详解
  • 2023最新ChatGPT整理的40道Java高级面试题
  • 第1节 线性回归模型
  • try-with-resource
  • mysql的limit查询竟然有坑？
  • C/C++中for语句循环用法及练习
  • 【机器学习面试总结】————特征工程
  • 蓝桥杯冲刺 - Lastweek - 你离省一仅剩一步之遥！！！(掌握【DP】冲刺国赛)
  • Python和Excel的完美结合:常用操作汇总(案例详析)
  • SIP协议及其简单介绍