⌨️

Bluetooth HID Keyboard & Mouse

Turn the box on and your keyboard and mouse are connected — multiple hosts at once

Page 22 of 24 MCP / API open OTA updates

Turns the box into a standard Bluetooth keyboard, mouse and trackpad (HID service 0x1812) with encrypted pairing, Boot protocol and multi-host subscriptions. Once paired it works on Windows / macOS / Linux / iOS / Android with no driver installation.

The mouse uses a TrackPoint-style algorithm driven by the IMU or touch displacement, with a dead zone and squared acceleration curve — precise at low speed, fast across the screen. The keyboard supports text entry, key combos and media keys, all exposed to both serial and remote commands.

Screen

On-screen interface

A recreation of this page on the 2.41-inch AMOLED display (600 × 450). Actual interaction and layout follow the latest firmware.

BTHID HID 2 subscribers
Trackpad · Drag to move pointer
StatusConnected host
PairingEncrypted
Pointer1 000 px/s
BootEnabled
CtrlAltDelEnterEscTab⌫⏯
Screen · Page 22
Recreated from the real firmware layout; the display type can be changed in the admin panel
Highlights

Key capabilities

⌨️

Keyboard + mouse + trackpad

Standard HID reports the OS recognises natively — no drivers.

🎮

TrackPoint feel

Dead zone plus squared acceleration, up to roughly 1000 px/s.

🔐

Encrypted pairing

Report characteristics force encrypted access; Boot protocol compatible.

👥

Multiple hosts online

Several hosts can subscribe at once; switching needs no reconnection.

🎵

Media keys

Volume, playback, brightness and other consumer keys included.

Specifications

Technical specs

HID service0x1812 with keyboard, mouse, media and consumer reports
Report formatKeyboard id=1 (8 B), mouse id=2 (4 B), media id=3 (2 B)
SecurityBOND + IO_CAP_NONE; report characteristics READ/WRITE_ENCRYPTED
CompatibilityBoot protocol (0x2A22 / 0x2A33) for BIOS and legacy systems
Pointer tuning20 ms tick, dead zone 0.10, full speed ≈1000 px/s
Use Cases

Typical scenarios

HTPC / living-room PC

Drive the whole media setup from the sofa.

Test automation

Remote commands drive keyboard and mouse for repetitive UI regression.

Switching devices

Connected to a desktop and a laptop at once, switch at will.

Commands

Related commands

page 22  Jump to Bluetooth HID
hid on|off  Enable or disable the HID service and advertising
hid move <dx> <dy>  Relative mouse movement
hid click [n]  Left click
hid type <text>  Type ASCII text
hid combo <mod>+<key>  Key combo, e.g. ctrl+alt+delete

Read the full API & command reference →

⚠ Boundaries & notes
  • Non-ASCII text such as Chinese cannot be typed directly; use an IME or paste instead.
  • On iOS the pointer requires Accessibility → AssistiveTouch → Pointer Devices to be enabled before a cursor appears.
  • Enabling HID locks the UI to this page by design; use the on-page "back home" action to exit.

Other feature pages