class USB_HID -- USB 人機介面裝置(HID)¶
USB_HID 類別代表 OpenMV Cam 的 USB 人機介面裝置(Human Interface Device)介面。它可用於模擬諸如滑鼠或鍵盤之類的周邊裝置。
在建構 USB_HID 物件之前,請以包含 HID 的模式(例如 'VCP+HID')呼叫 pyb.usb_mode() ── 這會在主機上列舉 USB HID 類別。傳遞給 usb_mode 的報告描述子會選擇裝置類別;預先建好的 tuple 可透過 pyb.hid_mouse 與 pyb.hid_keyboard 取得。
範例 ── 送出一次滑鼠左鍵點擊,然後將其向右移動 5 個像素::
import pyb
pyb.usb_mode("VCP+HID", hid=pyb.hid_mouse)
hid = pyb.USB_HID()
# report layout: (buttons, dx, dy, wheel)
hid.send((1, 0, 0, 0)) # press left button
hid.send((0, 0, 0, 0)) # release
hid.send((0, 5, 0, 0)) # move +5 in X
建構子¶
- class pyb.USB_HID¶
建立一個新的 USB_HID 物件。HID 介面只有一個,因此建構子會傳回該單例物件。
方法¶
- send(data: Tuple[int, ...] | List[int] | bytes | bytearray) None¶
向 USB 主機送出一份 HID 輸入報告。
data是一個整數的 tuple/list,或一個類bytes緩衝區,其佈局取決於所使用的報告描述子。對於內建的滑鼠描述子,報告為(buttons, dx, dy, wheel);對於鍵盤描述子,報告為(modifiers, 0, key1, key2, key3, key4, key5, key6)。請參閱pyb.hid_mouse與pyb.hid_keyboard。