Skip to content

ahnlak-rp2040/picow-boilerplate

Repository files navigation

CMake

PicoW C/C Boilerplate Project

This is a template repository, inspired by and based on Pimoroni's Pico C Boilerplate Project. It is specifically designed to help leverage the additional features of the PicoW, but obviously parts of it that do not require the WiFi / Bluetooth functionality will be transferable to a regular Pico.

It is intended as a useful starting point for working with PicoW-based projects using the Raspberry Pi Pico C/C SDK; it also bakes in support for the Pimoroni Pico Libraries, although it does not depend on these at all.

You generally want to be working with the latest release of the Raspberry Pi Pico C/C SDK; specifically, you will need to be on at least 1.5.0 to have support for all the features we have here.

Features

  • ready to build project framework, including Github Actions for builds and releases
  • support for a USB Mass Storage mode, to make it easy to provide a configuration file to your PicoW project (for example, providing WiFi settings) without the need to recompile.
  • A collection of optional additional lightweight libraries for specific tasks:
    • config provides basic handling for configuration files stored on the internal filesystem provided by USBFS.
    • httpclient provides a simple mechanism for retrieving data from a web server.

Documentation

I've attempted to keep everything as comprehensively documented as possible; this can be found in the /docs folder of this repository, and on PicoW C/C Boilerplate GitHub Pages.

Further Examples

These small projects are all based on this Boilerplate, and demonstrate something specific in a hopefully well-explained way.

  • Galactic Unicorn Scrolling Quote Demo does what it says on the tin; pulls a quote from the web and scrolls it. Derived from Pimoroni's scroll_text demo, it shows how you can fetch remote data easily.

License

This template is nominally released under the BSD 3-Clause License, to match that used in the SDK and to be as permissive as possible.

Share and Enjoy