MicroPython Installer for Arduino is a cross-platform tool that streamlines the process of downloading and installing MicroPython firmware on compatible Arduino boards. It is compatible with macOS, Linux, and Windows and is built using the Electron framework.

• Automatic download of MicroPython firmware.
• Seamless installation process onto Arduino boards.
• Cross-platform support (macOS, Linux, Windows).

There are no special system requirements for this tool beyond the prerequisites for running Electron applications.

Connect your Arduino board to your computer. Launch the application. Follow the on-screen prompts to download and install the MicroPython firmware.

• Arduino Giga
• Arduino Portenta H7
• Arduino Portenta C33
• Arduino Nano RP2040
• Arduino Nicla Vision
• Arduino Nano 33 BLE

# Clone this repository
git clone https://github.com/arduino/lab-micropython-installer.git

# Go into the repository
cd micropython-installer-arduino

# Install dependencies
npm install

# Run the app
npm run start

The packaging is done via Electron Forge. The configuration can be found in forge.config.js. To package the app, run:

npm run make # Creates a ready-to-run application
# or
npm run package # Creates a distributable file bundle

The CI takes care of making new releases. All that needs to be done is to bump the version with npm version patch, npm version minor or npm version major and push the tags with git push --follow-tags. When the CI is done the release will be in draft state so you can add release notes and publish it.

To do a development release, you can run e.g. npm version preminor --preid=beta to create a new minor version of the tool that contains the given suffix (e.g. v1.1.9-beta). For each successor development version you can run npm version prerelease which bumps the "beta" version to the next number (e.g. v1.1.0-beta.2).

To manually publish a new version (if you really need to), run:

npm run publish

To add support for additional boards a few changes / additions may be required:

• Add a descriptor for the device to descriptors.js. The descriptor contains the VID and PID of the board plus some instructions on how to flash a firmware.
• If the board requires a flashing tool other than the ones already supported, it needs to be added to firmware-flash/bin and the corresponding Node.js binding needs to be added to flasher.js
• An SVG asset of the board needs to be added to assets/boards. The filename will be derived from the board manufacturer and product name in the descriptor.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

For questions, comments, or feedback about this tool, please create an issue on this repository.