Skip to content

Media: finalize Bluetooth Serial lesson (esp32/bluetooth-serial.md) #131

Description

@jonfroehlich

Media shot-list for esp32/bluetooth-serial.md (L2: Bluetooth Serial). Part of the draft-lesson finalization tracked in #122.

⚠️ This page lives on the unmerged esp32-bluetooth branch. Goes live when that branch merges. Carries the "in draft form" banner. Only media today: the Huzzah32 board photo.

Shot list — desk work (drawable in software)

  • Small graphic: Bluetooth logo + Harald Bluetooth's bind rune (ᚼ + ᛒ). (bluetooth-serial.md:70 TODO)
  • Diagram: USB serial vs Bluetooth serial — same code/libraries, different transport (ESP32 → USB→COM3 vs ESP32 → radio→COM8 → pySerial/serial.js). (bluetooth-serial.md:115 TODO)

Shot list — bench/capture (hardware + screen recording)

  • macOS video (~2–3 min): upload sketch, Serial Monitor [USB Serial] greetings, pair in System Settings, cat /dev/tty.ESP32-Bluetooth, then the "aha" — unplug USB, data keeps streaming. (bluetooth-serial.md:404 TODO; page also suggests a tethered + untethered pair of clips)
  • Windows video (~2–3 min): pair, Device Manager shows the BT COM port, serial_reader.ps1 COMxx. (bluetooth-serial.md:404 TODO)
  • Python video (~2 min): pySerial serial_reader.py / serial_demo.py over the BT port — identical code to USB. (bluetooth-serial.md:515 TODO)
  • (Bonus) Android video (~1–2 min): Serial Bluetooth Terminal app receiving greetings. (bluetooth-serial.md:535 TODO)
  • Screenshots: macOS Bluetooth settings (paired) (:316); Windows Device Manager COM ports (:328); Android terminal app.

Also blocked on (code, tracked here)

  • Push Arduino sketches to makeabilitylab/arduino ESP32/Bluetooth/; Python scripts to Python/Bluetooth/.

Suggested hero

A ~5–8s clip: terminal streaming messages while the USB cable is unplugged. Draft caption:

Send data from your ESP32 wirelessly — no USB cable. Bluetooth's Serial Port Profile makes it look exactly like a wired connection to your computer.

Placement (hero-first standard)

Put the hero block immediately after the TOC --- — before any intro prose, the draft banner, or note box (slot: TOC → hero → optional note → prose; see #123). Markup: <video autoplay loop muted playsinline aria-label="..."> for a local clip (use controls instead of autoplay if it has audio), or <div class="iframe-container"><iframe ... title="descriptive..."></iframe></div> for YouTube — followed by a **Video.**/**Figure.** caption with {: .fs-1 }.

Activity

  1. added
    contentLesson content: errata, corrections, new sections, pedagogy
    figures-mediaFigures, captions, diagrams, images, video/embeds
    v2.0Targeted for the Version 2.0 release
    on Jun 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentLesson content: errata, corrections, new sections, pedagogyfigures-mediaFigures, captions, diagrams, images, video/embedsv2.0Targeted for the Version 2.0 release

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions