简介

这个驱动程序模拟USB HID设备。目前键盘和鼠标已经实现。

依赖性

这个驱动器基于：

• Adafruit CircuitPython

请确保CircuitPython文件系统中的所有依赖项都可用。这可以通过下载Adafruit库和驱动包轻松实现.

其他布局

这个库有一个en-US布局。请查看并扩展来自Neradoc的库 用于其布局.

使用实例

键盘 "类发送USB键盘设备的按键报告到主机。

键盘代码 "类定义了使用 "键盘 "发送的USB HID键盘代码。

import usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keycode import Keycode

# Set up a keyboard device.
kbd = Keyboard(usb_hid.devices)

# Type lowercase 'a'. Presses the 'a' key and releases it.
kbd.send(Keycode.A)

# Type capital 'A'.
kbd.send(Keycode.SHIFT, Keycode.A)

# Type control-x.
kbd.send(Keycode.CONTROL, Keycode.X)

# You can also control press and release actions separately.
kbd.press(Keycode.CONTROL, Keycode.X)
kbd.release_all()

# Press and hold the shifted '1' key to get '!' (exclamation mark).
kbd.press(Keycode.SHIFT, Keycode.ONE)
# Release the ONE key and send another report.
kbd.release(Keycode.ONE)
# Press shifted '2' to get '@'.
kbd.press(Keycode.TWO)
# Release all keys.
kbd.release_all()

KeyboardLayoutUS "使用按键发送ASCII字符。它假定主机被设置为接受来自美国键盘的按键。

如果主机希望使用非美国键盘，KeyboardLayoutUS提供的字符与键的映射将不总是正确的。在某些情况下需要不同的按键。例如，要在法语键盘（AZERTY而不是QWERTY）上输入"'A'"，应该按下Keycode.Q。

目前这个包只提供KeyboardLayoutUS。可以添加更多的KeyboardLayout类来处理非美国键盘和各种操作系统提供的不同输入法。

import usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keyboard_layout_us import KeyboardLayoutUS

kbd = Keyboard(usb_hid.devices)
layout = KeyboardLayoutUS(kbd)

# 输入‘abc’并回车
layout.write('abc\n')

# 获取输入'$'所需的键码。
# 该方法将返回（Keycode.SHIFT, Keycode.FOUR）。
keycodes = layout.keycodes('$')

Mouse "类模拟了一个带有滚轮的三键鼠标。

import usb_hid
from adafruit_hid.mouse import Mouse

m = Mouse(usb_hid.devices)

# Click the left mouse button.
m.click(Mouse.LEFT_BUTTON)

# 将鼠标斜着移到左上方。
m.move(-100, -100, 0)

# 将鼠标滚轮从用户处滚开一个单位。
# 滚动的数量取决于主机。
m.move(0, 0, -1)

# Keyword arguments may also be used. Omitted arguments default to 0.
m.move(x=-100, y=-100)
m.move(wheel=-1)

# Move the mouse while holding down the left button. (click-drag).
m.press(Mouse.LEFT_BUTTON)
m.move(x=50, y=20)
m.release_all()       # or m.release(Mouse.LEFT_BUTTON)

ConsumerControl "类模拟消费者控制设备，如遥控器，或某些键盘上的多媒体键。

import usb_hid
from adafruit_hid.consumer_control import ConsumerControl
from adafruit_hid.consumer_control_code import ConsumerControlCode

cc = ConsumerControl(usb_hid.devices)

# Raise volume.
cc.send(ConsumerControlCode.VOLUME_INCREMENT)

# Pause or resume playback.
cc.send(ConsumerControlCode.PLAY_PAUSE)

文档

这个库的API文档可以在阅读文档上找到。

关于建立图书馆文档的信息，请查看 this guide.

实例

用于 USB Mouse Jiggler 以防止您的计算机进入睡眠状态，因此我决定使用 raspberry pi pico 制作一个 DIY 版本的鼠标 jiggler。

import time
import usb_hid
from adafruit_hid.mouse import Mouse
import board
import digitalio

mouse = Mouse(usb_hid.devices)

led = digitalio.DigitalInOut(board.GP25)
led.direction = digitalio.Direction.OUTPUT

led.value = False
time.sleep(5)

while True:
	led.value = True
	mouse.move(x=100)
	led.value = False
	time.sleep(0.5)
	led.value = True
	mouse.move(x=-100)
	led.value = False
	time.sleep(0.5)

本文正在参加「金石计划 . 瓜分6万现金大奖」