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 }.

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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions