Skip to content

Media: finalize Introduction to BLE lesson (esp32/ble-intro.md) #129

Description

@jonfroehlich

Media shot-list for esp32/ble-intro.md (L4: Introduction to BLE). Part of the draft-lesson finalization tracked in #122.

⚠️ This page lives on the unmerged esp32-bluetooth branch. It will go live (and join the live draft list) when that branch merges. Carries the "in draft form" banner.

Already present

  • Component photos in the materials table only. No hero, no diagrams, no demo media.

Shot list — desk work (drawable in software)

  • GATT hierarchy diagram: Server → Service (UUID) → Characteristic (UUID, value, Read/Write/Notify) → Descriptor (CCCD 0x2902). (text ASCII tree ~line 118)
  • BLE advertising + connection lifecycle diagram: advertise → scan → connect → exchange (read/write/notify) → disconnect. (ble-intro.md:103 TODO)
  • Fritzing wiring diagram: potentiometer on ESP32-S3 Feather A5. (ble-intro.md:449 TODO)

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

BLE demos are mostly screen capture (nRF Connect phone app / Python CLI) alongside the breadboard.

  • Part 1 video (~1–2 min): upload BLEHelloWorld, run ble_discover.py, then nRF Connect scan → connect → expand service tree → read value. (ble-intro.md:433 TODO)
  • Part 2 video (~1–2 min): pot wired to A5, subscribe to notifications in nRF Connect, turn knob, values update live. (ble-intro.md:683 TODO)
  • Screenshot: nRF Connect scan results (iOS + Android side by side). (ble-intro.md:420 TODO)
  • Screenshot: nRF Connect service/characteristic tree. (ble-intro.md:424 TODO)
  • Screenshot: nRF Connect live notification values. (ble-intro.md:665 TODO)

Also blocked on (code, tracked here)

  • Push BLEHelloWorld.ino, BLENotifySensor.ino to makeabilitylab/arduino ESP32/Bluetooth/; ble_discover.py, ble_sensor_reader.py to Python/BLE/.

Suggested hero

A ~10–15s cut of the Part 2 notification demo (pot → phone). Draft caption:

Watch a potentiometer's readings stream wirelessly to your phone over Bluetooth Low Energy — no cable, no WiFi, just structured BLE notifications updating in real time.

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