bsncubed/aes67-ESP32-P4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
02c02a821de305f165a1b691f5e638f3c95b07cc
aes67-ESP32-P4/README.md
T
bsncubed 41103e3b5e Licences: MIT for the AES67 core and web page, GPL-3.0 for the rest 
- LICENSE (GPL-3.0) at the root; an MIT LICENSE in each components/aes67_*
  and in web/, so they travel with the code when reused.
- THIRD_PARTY.md: third-party code and licences, and the known conflict of
  the Espressif binary audio libraries with GPL-3.0 (firmware contains cspot).
- CLAUDE.md: rule to keep GPL code out of the core; phase 2 item to replace
  the Espressif binaries (opencore-aacdec, Speex resampler).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 08:37:38 +10:00

1.8 KiB
Raw Blame History

aes67-ESP32-P4

AES67 sender for the Waveshare ESP32-P4-ETH (PoE): Spotify Connect and HLS/m3u8 internet radio (with failover between them) go out as an AES67 multicast stream, locked to PTP. Everything is set up from a built-in web page, with SAP announcements and SDP export for receivers (tested with Riedel PTP).

Using it: see the user guide.

Quick start: power the board over PoE and open http://p4-aes67.local/. Pick a source and save. Then find "P4 AES67" via SAP on the receiver, or import the SDP from the page.

Building and flashing

  • ESP-IDF 5.5 or later, target esp32p4: idf.py set-target esp32p4 && idf.py build
  • cspot submodule: git submodule update --init external/cspot && git -C external/cspot submodule update --init cspot/bell
  • New board over USB: tools/flash_board.py
  • Update over the network: web page → Firmware, or curl -f --data-binary @build/aes67_p4.bin -H 'Content-Type: application/octet-stream' http://p4-aes67.local/api/ota

Toolchain details and caveats (chip revision, Python packages for cspot) are in CLAUDE.md.

Documentation

  • docs/user-guide.md: setup, web page, sources, Spotify, AES67, PTP, network, updates, player API, troubleshooting
  • docs/aes67-core-base.md: reusable AES67 core design (PTP, RTP, SDP/SAP, syslog, web UI and API contract)
  • docs/hardware-and-design-notes.md: board details and project-specific design
  • web/index.html: the web page (served by the device)
  • CLAUDE.md: working rules, build order and status

Licence

The AES67 core (components/aes67_*) and the web page (web/) are MIT. Everything else is GPL-3.0-or-later (LICENSE). The firmware image contains cspot (GPL-3.0), so distributing it falls under GPL-3.0. Third-party code, its licences and a known conflict with two Espressif binary libraries: THIRD_PARTY.md.

Reference in New Issue View Git Blame Copy Permalink