本文主要簡單介紹USB HID Vendor Defined設備的應用和調試方法，結合Telink 8355 Dongle做簡要說明。

1

USB HID Vendor Defined 設備概述

1、hid設備類型是由hid報告描述符中的用途頁（USAGE PAGE）決定的，常見的有Generic Desktop Controls ,Keyboard/Keypad ,還有有廠商自定義（Vendor Defined Page）選項。常用的用途表如下：

2、借助USB HID Vendor Defined設備可以實現USB設備與上位機間的雙向通信。

2

新增一個USB HID Vendor Defined設備

1、修復報告描述符

開發者可以在已有的usb interface中新增一個vendor defined設備，也可以新增一個interface，把這個vendor defined設備掛在新增的接口下面。

采用在一個單獨的接口中添加Vendor Defined設備，report 描述符如下：

通過上面的修改，usb設備枚舉完成后，在bus hound中可以查看到兩個Vendor Defined設備已經枚舉成功。

3

USB HID Vendor Defined設備的調試

1、Vendor Defined設備調試方法

根據第二章中的報告描述符，設置了兩個usage page 并開辟了兩個集合，分別對應兩個Vendor Defined設備。第一個設備的usage page為0xFFEF，用來給dongle 升級使用。Report ID為6，既有輸入也有輸出，report長度都為63。第二個設備開發者可以自由決定他的用途，可以跟上位機做自定義的數據通信。設備2的Report ID,9，Report length為32。這兩個設備都使用相同的輸入輸出端點，他們的數據通過不同的報告ID來進行區分。

2、利用bus hound模擬上位機下發數據

對于上位機一般是通過指定的usage page來打開usb設備，然后進行數據讀取和寫入。使用bus hound可以簡單的模擬上位機進行數據發送。

特別在發送數據的時候，要嚴格按照報告描述符中定義的report ID 和Report Length來發，否則可能出錯。

雙擊上圖中的USB Input Device，可以選Control Out 和 interrupt Out進行發送數據測試。如果接口里面有OUT端點，則set report命令下發數據和write file命令數據都是通過out端點下來，如果沒有OUT端點，則set report命令數據是通過控制端點下發的。

01

通過Set report命令下發數據

Set report命令格式如下：

02

通過write file下發數據

03

MCU讀取上位機發送的數據

• 讀取上位機set report命令數據

• MCU讀取上位機write file數據

04

Vendor Defined設備發送數據

上報數據就是通過往Vendor Defined設備所在接口的in端點里面寫數據。

特別的，第一個字節需要為報告描述符指定的Report ID，數據長度需要為報告描述符指定的長度。

4

總結

USB HID Vendor Defined設備是一種非常常見的人機交互接口，可以方便的實現用戶各種定制化的與上位機交互需求，廣泛應用于固件升級、參數設置、命令收發等定制化場景。目前Telink 鍵鼠領域的各SDK均支持USB HID Vendor Defined 設備，用戶只需簡單調用接口便可以實現與上位機交互功能。

關 于 泰 凌

泰凌微電子致力于為客戶提供一站式的低功耗高性能無線連接SoC芯片解決方案，包括經典藍牙，藍牙低功耗，藍牙Mesh，Zigbee，Thread，Matter，Apple HomeKit，Apple“查找（Find My）”，和私有協議等低功耗2.4GHz多協議無線連接系統級芯片和豐富的固件協議棧。公司產品廣泛應用于智能照明，智能家居/樓宇，智能遙控，無線外設，智能零售，穿戴設備，無線音頻，智能玩具，物流追蹤，智慧城市等各類消費和商業應用場景中。

官網：www.telink-semi.com

微信公眾號：telink-semi

泰凌開發者論壇：

https://developers.telink-semi.cn/

銷售接洽：

中國大陸（華東、華北） :

+86-21-20281118-8213

中國大陸（華南、香港、音頻） :

+86-0755-26614003

telinksales@telink-semi.com