How adafruit/adafruit_wippersnapper_arduino works
Project type and purpose
• This is an embedded IoT firmware project (Adafruit WipperSnapper) built with Arduino/PlatformIO.
• Purpose: turn supported Wi-Fi boards (ESP32, ESP8266, RP2040-W, RP2350-W, ATSAMD51+AirLift) into configurable sensors and actuators that communicate with Adafruit IO without any Arduino code.
File structure
• Top-level:
• .github, workflows, CODE_OF_CONDUCT, LICENSE, README.md, Doxyfile for CI & documentation
• examples/ shows sample firmware projects for many boards
• platformio.ini and library.properties define build and library metadata
• src/ contains the firmware code, broken into subdirectories
• tools/ contains helper scripts (rename_usb_config.py, UF2 bootloader files)
• src/ breakdown:
• Core: Wippersnapper.cpp/h, component registry, networking interface abstractions
• components/: driver wrappers for analog, digital I/O, I2C, PWM, pixels, servos, DS18X20, status LED, UART
• /: OLED/TFT UI helpers, symbols
• provisioning/: filesystem (LittleFS, TinyUSB/FAT) and JSON config loader
• nanopb/: Protocol Buffers C runtime & helpers
• wippersnapper/: generated .pb.c/.pb.h for each service (pin, i2c, servo, pixels, etc)
• network_interfaces/: board-specific Wi-Fi and AirLift abstractions
• Build and CI: GitHub Actions workflows for builds, Doxygen docs
README for additional insights
• Describes target boards, Adafruit IO requirement, build methods
Elements
– Clear labels for each module or layer
– Annotations showing build/CI tools as a side note (PlatformIO, GitHub Actions, Doxygen)
Summary
• Interactions through the core scheduler
• Provisioning and display subsystems as side branches