OpenPPG Config

Configure your OpenPPG controller via WebUSB

Notes:

• Currently only works in Google Chrome and related chromium variants (like Brave browser and latest Microsoft Edge) https://caniuse.com/webusb
• Also tested and working in Chrome on Android
• In Windows you may have to enable the new USB backed by navigating to chrome://flags/#new-usb-backend

Requirements

OpenPPG config uses Doks and a number of other npm packages. Installing npm is pretty simple. Download and install Node.js (it includes npm) for your platform. We recommend installing the most recent LTS release.

Local development

1. Install npm packages

npm install

2. Start local development server

To interact with WebUSB devices you must use https. Hugo now provides https server out of the box. You can access the site at https://localhost:1313.

npm run start

3. (Not required) Build files

Github actions now auto-builds and deploys code when merged/commited into the master branch

When ready to publish to a static hosting site

npm run build

Firmware Development

Building ESP32-S3 Firmware

To build and merge firmware binaries for the OpenPPG SP140 ESP32-S3 controller using PlatformIO:

esptool.py --chip esp32s3 merge_bin \
  -o .pio/build/OpenPPG-CESP32S3-CAN-SP140/merged-firmware.bin \
  --flash_mode dio \
  --flash_freq 80m \
  --flash_size 8MB \
  0x0 .pio/build/OpenPPG-CESP32S3-CAN-SP140/bootloader.bin \
  0x8000 .pio/build/OpenPPG-CESP32S3-CAN-SP140/partitions.bin \
  0xe000 /Users/zach/.platformio/packages/framework-arduinoespressif32/tools/partitions/boot_app0.bin \
  0x10000 .pio/build/OpenPPG-CESP32S3-CAN-SP140/firmware.bin

This command merges the bootloader, partitions, and firmware binaries into a single flashable image for the ESP32-S3 chip used in the SP140 controller.