displaypad-driver

USB driver for the Mountain DisplayPad. Handles device connection, image uploads, key polling, and brightness control. Used internally by displaypad-lib; use that unless you need direct hardware access.

Modules

• device.py — DisplayPad driver class.
  • DisplayPad(vendor_id, product_id, auto_connect=True) — opens USB interfaces on init unless auto_connect=False.
  • try_connect() → bool — connect without raising on failure.
  • connect() / close() — open and release USB interfaces.
  • upload_button(key_index, bgr_pixels) — upload a 102×102 BGR image to one key slot (0–11).
  • upload_panel(tiles_bgr) — upload all 12 key slots at once.
  • poll_key(timeout) → {'pressed', 'released', 'current'} — read key state.
  • set_brightness(percent) — set backlight 0–100%.
  • close() — release interfaces.
• transport.py — opens Interface 1 (bulk pixel data via PyUSB) and Interface 3 (HID commands/events via hidapi). Not intended for direct use.
• hotplug.py — USBHotplugMonitor and is_device_present() for detecting plug/unplug events.
• protocol.py — VID/PID constants, packet templates, and get_pressed_keys().
• image.py — image conversion utilities: image_to_bgr102, split_image_to_tiles, load_gif_frames, split_gif_to_tiles, make_label_icon, make_folder_icon.

For a usage example, see driver_example.py.

Acknowledgments

Performance optimizations, dual-interface transport handling, initialization handshakes, and input report interleaving were built with inspiration from ramisotti13-eng/BaseCamp-Linux.