GP2040 Web Configurator

Simple web application for gamepad configuration.

Requirements

• PlatformIO with the Wiz-IO Pico platform module
• NodeJS and NPM to build the React app
• Python for the React app build script
• Perl for some text replacement done by the React app build script

Development

Navigate to the www folder and run npm run dev. This will start up the React app and an Express instance for mock data during development, allowing testing of the configurator without loading it onto the MCU, which is a SLOW process.

The mock data Express server is running at http://localhost:8080.

API Endpoints

When adding a new API endpoint to the GP2040 Configurator:

NOTE: All endpoints should be under the /api path

• Add the endpoint to src/webserver.cpp.
  • Add a define at the top: #define API_GET_NEW_ENDPOINT "/api/getNewEndpoint"
    • Use the naming convention API_[GET/SET]_{ENDPOINT_PATH} for the define
    • Use the naming convention /api/{[get/set]EndpointPath} for the path
  • Create the backing method with the same name as the API path: string getNewEndpoint()
  • Add handling code in fs_open_custom for the API path
• Add a mock data endpoint to src/server/app.js
• Add the client-side API function to www/src/Services/WebApi.js.
• Add the endpoint to the Postman collection at www/server/docs/GP2040.postman_collection.json

Files

Use JPG and PNG files for images, SVG file support requires modification to the lwIP library that hasn't been completed.

Building

The build-web.py script is used to build the React application and regenerate the embedded data in lib/httpd/fsdata.c. The makefsdata tool that performs the conversion doesn't set the correct #include lines for our use. This script will fix this issue.

If you just want to rebuild the React app in production mode for some reason, you can run npm run build from the www folder.

The lwIP lib in Wiz-IO Pico PlatformIO platform doesn't include the makefsdata source. A precompiled version for Windows and Unix are included in the tools folder.

References

Original example:

• https://forums.raspberrypi.com/viewtopic.php?t=306888
• https://github.com/maxnet/pico-webserver

WizIO example:

• https://github.com/Wiz-IO/wizio-pico-examples/tree/main/baremetal/pico-usb-webserver

Convert text to bytes:

• https://onlineasciitools.com/convert-ascii-to-bytes
• https://onlineasciitools.com/convert-bytes-to-ascii

Create image map:

• https://www.image-map.net/