Skip to content

Installation

The simplest way to install PedalinoMini firmware is using the Web Installer:

  1. Connect your device to your computer via USB

  2. Launch the Web Installer

  3. Click here: PedalinoMini Web Installer

  4. Works with Chrome, Edge, or other Chromium-based browsers that support WebUSB

  5. Follow the on-screen instructions

  6. Select your device from the connection dialog
  7. Choose the firmware version you want to install
  8. Wait for the installation to complete

Note: The Web Installer automatically handles both the firmware and filesystem installation in one step, making it ideal for most users.

How to Build and Upload PedalinoMini

Prerequisites

  1. Install Visual Studio Code

  2. Install PlatformIO Extension for VSCode

  3. Open VSCode
  4. Go to Extensions (Ctrl+Shift+X)
  5. Search for "PlatformIO" and install it

  6. Restart VSCode when prompted

  7. Install Git

  8. Windows: Download and install from git-scm.com/download/win
  9. macOS: Run xcode-select --install in Terminal
  10. Linux: Use your package manager (e.g., sudo apt install git)

Getting the Code

Option 1: Command Line (Recommended) 

git clone https://github.com/fuegovic/PedalinoMini
cd PedalinoMini
code .

Building and Uploading

  1. Open the PlatformIO sidebar

  2. Click the PlatformIO icon in the left sidebar (looks like an ant)

  3. Select your environment

  4. Expand "PROJECT TASKS"

  5. Find your board (e.g., env:esp32doit-devkit-v1)

  6. Build the firmware

  7. Under your selected environment, expand "General"
  8. Click "Build"
  9. Wait for the build to complete

Alternative methods if you can't find this option: - In the PlatformIO menu at the bottom of VSCode, click "PlatformIO: Build"

  1. Upload the firmware
  2. Under "General", click "Upload"
  3. Wait for the upload to complete

Alternative methods if you can't find this option: - In the PlatformIO menu at the bottom of VSCode, click "PlatformIO: Upload"

  1. Upload the File System Image (crucial for WebUI functionality)
  2. Under your selected environment, expand "Platform"
  3. Click "Upload File System Image"

Alternative methods if you can't find this option: - In the PlatformIO menu at the bottom of VSCode, click "PlatformIO: Upload File System Image" - Or use the command line in the project directory: 

pio run -t uploadfs

Troubleshooting

  • If you can't find the "Upload File System Image" option, make sure your selected environment supports it
  • If using the command line for uploadfs, ensure you've installed the PlatformIO CLI tool
  • Check the PlatformIO documentation for your specific board if you encounter issues

Important Note

Don't skip the "Upload File System Image" step, as the WebUI will not function properly without it.

Before any update save configuration, reset to factory default and reload configuration. EEPROM can change without any further advice.