EWP developer wiki

This wiki is the entry point for working on Ersa Wearable Platform firmware, board support, hardware, and host tools. It documents the code in this repository and labels planned integrations as planned.

Start here

• Project overview and build commands
• Latest release notes
• C++ API reference: generated classes, methods, headers, and source documentation.
• Wearable project: product and project landing page.
• Wearables package repository: downloadable ewctl packages and releases.
• Architecture and hardware boundaries
• Platform layers and runtime scheduler
• Build and register apps
• Add or port a board
• Feature catalog

Firmware and hardware

• Power and battery design
• Release history
• Current architecture and power audit
• PCB pin map
• Apple Bluetooth connectivity
• USB developer control and `ewctl`

API reference

The published C++ API reference covers project headers, source, services, board support, platform HALs, peripheral drivers, and tests. Class and function pages explain their purpose, behavior, constraints, side effects, and design rationale. Build it locally with make docs; the result is api/index.html in .pio/wiki-site/. Third-party Arduino and ESP-IDF SDK sources are maintained upstream and are linked from the app-building guide rather than copied into this reference.

Contributing changes

Run make test, make firmware, and make docs for changes that affect the firmware or its interfaces. Keep board wiring in the BSP, vendor APIs in the matching platform HAL or peripheral driver, and update the relevant wiki page when behavior changes.