Skip to content

Add hw---gdk support for the Game Designer's Kit#7600

Open
GarbhitSh wants to merge 2 commits into
microsoft:masterfrom
GarbhitSh:feature/add-hw-gdk
Open

Add hw---gdk support for the Game Designer's Kit#7600
GarbhitSh wants to merge 2 commits into
microsoft:masterfrom
GarbhitSh:feature/add-hw-gdk

Conversation

@GarbhitSh

@GarbhitSh GarbhitSh commented Jul 10, 2026

Copy link
Copy Markdown

Summary

Adds hw---gdk for the Game Designer's Kit: a micro:bit V2 shield with a direct ST7735 SPI display and GPIO arcade buttons (compileServiceVariant: nrf52833).

Product: Hadron RoboLabs (brand), Deltabotix (registered company). Pilot / pre-production hardware; product documentation is in the linked repository (PCB design files are not published).

Why not hw---n3?

hw---n3 targets shift-register buttons and smart-display type 4242. This board uses:

  • Direct GPIO buttons (no shift register)
  • Plain ST7735 SPI panel (type 7735)
  • Different CS, active-LOW backlight (P-FET on P10), and battery sense wiring

A separate variant is required so pin maps and drivers match the physical board.

Board-specific behavior

Area Implementation
Backlight init.ts drives P10 active-LOW and re-applies via a 1 Hz watchdog (CODAL ST7735 init does not match this FET wiring)
Battery sense Voltage divider on P0 (R1=113.4 kΩ, R2=297.5 kΩ)
Low-battery LED P6, on when P0 ADC < 700
SAADC gdk.readP0Adc() single-shot read in analog.cpp
Battery monitor batteryled.ts (does not alter PPI/timers)

Files changed

  • New package: libs/hw---gdk/config.ts, init.ts, batteryled.ts, analog.cpp, shims, pxt.json card
  • Target registration: pxtarget.json (bundleddirs + staticpkgdirs.base)
  • Gallery / docs: docs/hardware.md, docs/arcade-devices.md, docs/static/hardware/game-designers-kit.jpg
  • Not added: targetconfig.json hardwareOptions entry (that duplicated the hardware picker card; removed in commit 68df5f19)

Test plan

  • pxt build in libs/hw---gdk succeeds (cloud C++ compile) — verified on prior branch iteration
  • Flash on micro:bit V2: display backlight, orientation, buttons, audio
  • Battery LED on P6 when P0 ADC drops below threshold
  • No regression to existing hw---n3 shields (separate variant)
  • Full target pxt ci on this runner — not run here (pxt CLI not installed in local environment; upstream workflow pxt-buildpush requires maintainer approval for fork PRs)

Review notes

Introduce hw---gdk for the Game Designer's Kit: direct GPIO arcade buttons,
ST7735 SPI display, active-low backlight fix, and single-shot SAADC for the
on-board battery divider and low-battery LED.
@GarbhitSh GarbhitSh force-pushed the feature/add-hw-gdk branch from 35d2187 to 5fceba7 Compare July 10, 2026 10:35
@GarbhitSh

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree company="Deltabotix"

The in-editor hardware chooser already lists Game Designer's Kit from libs/hw---gdk/pxt.json; targetconfig hardwareOptions added a second card with the same name.
@GarbhitSh GarbhitSh changed the title Add Game Designer's Kit (hw---gdk) micro:bit V2 Arcade shield Add hw---gdk support for the Game Designer's Kit Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant