Skip to content

Keyboard

Main menu key: k

Use Cardputer as a USB or BLE HID keyboard / mouse. This App cannot return to the menu with ESChold BtnGO.

No header on the main input screen. Left pill column shows Fn / Aa / Opt / Ctrl / Alt; center shows a large last-key echo; footer shows link status, green device name, and a yellow slot badge.

Screenshots

Main / USB / Mouse

hid-mainhid-usbhid-mouse

Hosts / Special keys

hid-hostshid-special

Shortcuts

Mode and exit

KeyAction
Fn + uUSB HID
Fn + bBLE HID
Hold FnToggle IMU→mouse pointer
Fn + pBLE host list (switch / pair)
Tap BtnGOOpen / close the BLE host list (same as Fn + p)
Hold BtnGOExit to main menu (and disconnect BLE)
Fn + hHelp

IMU mouse (hold Fn)

Letters are used for clicks (not typed). Digits set sensitivity. Other function keys still go to the host.

KeyAction
Left-half letters qwerty asdfg zxcv (ygv left)Left click
Right-half letters uiop hjkl bnm (uhb right)Right click
19 / 0Sensitivity 1..10

Center shows a mouse icon; right side is the sensitivity bar. If BLE pointer does nothing, forget the device on the host and re-pair.

Transport and sensitivity are saved under hid_keyboard in config.json and restored the next time the app opens. The IMU mouse toggle is temporary and defaults to off whenever the app opens.

BLE host list (Fn+p / tap BtnGO)

Stores up to 5 paired hosts; only one connected at a time.

KeyAction
15 / ; , . /Select slot
Enter / SpaceSwitch to that host (disconnect current; on the target, tap Cardputer KB in Bluetooth)
nNew pairing (needs free slot; rejects reconnect from old hosts)
rRename current slot alias (Enter saves; empty name shows MAC again; ` cancels)
BackspaceDelete current slot pairing
p / h / tap BtnGOClose list

Fn layer (Help page 2)

KeyAction
` (bare)Esc (to host)
Fn + BackspaceDelete
Fn + ; , . /Arrow keys
Fn + 10F1–F10
Fn + - =F11 / F12
Fn + A/aCapsLock
Fn + modifiersRight-side modifier mapping (see Help)

Usage

  1. Use a cable for USB, or Fn+b for BLE keyboard then pair on the host (Fn+pn).
  2. Multiple hosts: Fn+p or a tap on BtnGO opens the list, select a slot, Enter to switch. reconnecting #N means waiting for the target PC to auto-reconnect (usually within a few seconds; otherwise tap Cardputer KB in Bluetooth again).
  3. New pairing with n: rejects old hosts grabbing the link, then search/pair on the new PC.
  4. Type normal characters directly; bare ` sends Esc; other function keys use the Fn layer.
  5. Hold Fn for IMU mouse; ygv left / uhb right click; 10 set sensitivity; other function keys still work.
  6. Always exit by holding BtnGO (disconnects BLE); a short tap only toggles the host list; ` is Esc to the host.
  7. BLE combo keyboard+mouse: after firmware update, forget Cardputer KB and re-pair if the pointer does nothing.

Sparks for M5Stack Cardputer