Now that the library files and build script have been updated, it's time to open two pull requests: one on Adafruit_Wippersnapper_Arduino and one on the CI-Arduino repository.

Submit a Pull Request to CI-Arduino

First, let's push the changes you made to the build script within your CI-Arduino fork.

In a terminal window, navigate to ci-arduino's location on your computer.

Use the git branch command to create a new branch. The branch should contain the name of the board you're adding. As an example, name the branch add-esp32-s3-feather.

Next, use the git status command to verify that only the build_platform.py file has been modified.

Add the build_platform.py file by running git add build_platform.py.

Finally, verify that build_platform.py has been added by running git status one last time.

Use git commit to commit your changes and git push to push the changes to your fork.

Use GitHub to create a pull request (PR) to the CI-Arduino repository with your changes.

Submit a Pull Request to WipperSnapper Arduino Library

Next, to push the changes you made to the build script within your fork of the WipperSnapper Arduino Library.

First, verify that you have modified only the following files:

  • The board detection file
    • src/Wippersnapper_Boards.h
  • And one of the provisioning method files:
    • src/provisioning/tinyusb/Wippersnapper_FS.cpp
    • or
    • src/provisioning/littlefs/WipperSnapper_LittleFS.cpp

Next, in a terminal window, navigate the location of Adafruit_WipperSnapper_Arduino on your computer.

Use the git branch command to create a new branch. The branch should contain the name of the board you're adding. As an example, this branch is named add-esp32-s3-feather.

Next, use the git status command to verify that only the files listed above have been modified.

Add the files by running git add .

Finally, verify that your files have been added by running git status one last time.

Now commit your changes, and push your branch to your fork. Use GitHub to create a pull request to the WipperSnapper Arduino library with your changes.

What's next?

Once your pull requests are created, it's now up to Adafruit! We'll take a look at it and make sure everything is in order before merging your changes into WipperSnapper Arduino. If anything was missed, we'll let you know so you can get it taken care of. Once the changes in both repositories are merged, your board is officially part of WipperSnapper.

The next time WipperSnapper is released, all the boards that have been added to the repository will be included in the release. That includes your board! Firmware builds are available on the latest release on GitHub. The web-based WipperSnapper firmware uploader will also populate with the latest firmware and supported boards on a new release.

This guide was first published on May 04, 2022. It was last updated on 2022-05-04 10:39:33 -0400.

This page (Submit a Pull Request) was last updated on May 04, 2022.

Text editor powered by tinymce.