makeuf2-tool's Introduction

Arduino UF2 file creator

Arduino plugin which creates a .uf2 file from a .bin file located in the sketch folder.
Tested with the following Arduino IDE versions: 1.8.8

Installation

Make sure you use one of the supported versions of Arduino IDE.
Download the tool archive from the releases page.
In your Arduino sketchbook directory, create tools directory if it doesn't exist yet.
Unpack the tool into tools directory (the path will look like <home_dir>/Arduino/tools/makeUF2/tool/makeUF2.jar).
Restart Arduino IDE.

On the OS X create the tools directory in ~/Documents/Arduino/ and unpack the files there

Usage

Open a sketch (or create a new one and save it).
Make sure you have selected the proper board.
Create a compiled binary image of the sketch: (choose Sketch > Export compiled Binary).
Select the Tools > makeUF2 - UF2 file creator menu item. This will create a UF2 file from the compiled binary and place it in the sketch folder. Copy that file onto your xxxxBOOT disk to install it.

Screenshot

Credits and license

This work is based on:

   ESP8266FS.java,
   an Arduino plugin to put the contents of the sketch's "data" subfolder
   into an SPIFFS partition image and upload it to an ESP8266 MCU
   from the esp8266/arduino-esp8266fs-plugin repository 
   at 'https://github.com/esp8266/arduino-esp8266fs-plugin'
   Copyright (c) 2015 Hristo Gochkov (ficeto at ficeto dot com)

and on:

   bin2uf2.js,
   from the adafruit/uf2-samdx1 branch of the Microsoft/uf2-samdx1 repository 
   at 'https://github.com/adafruit/uf2-samdx1'

Issues and suggestions

File issues here on github

makeuf2-tool's People

Contributors

Stargazers

Watchers

makeuf2-tool's Issues

On linux, invoking the tool after exporting the binary results in NPE

Describe the bug

When trying to use the tool from the Arduino IDE it throws a NullPointerException. I am using Linux, Ubuntu 20.04 64-bit, Arduino 1.8.8 and 1.8.16 both exhibit this behaviour.

To Reproduce
Export binary
Invoke tool
A 0-byte uf2 is produced and the following stack trace appears:

java.lang.NullPointerException
	at java.lang.Long.decode(Long.java:892)
	at com.makeUF2.makeUF2.makeUF2.createUF2(makeUF2.java:232)
	at com.makeUF2.makeUF2.makeUF2.run(makeUF2.java:290)
	at java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:311)
	at java.awt.EventQueue.dispatchEventImpl(EventQueue.java:758)
	at java.awt.EventQueue.access$500(EventQueue.java:97)
	at java.awt.EventQueue$3.run(EventQueue.java:709)
	at java.awt.EventQueue$3.run(EventQueue.java:703)
	at java.security.AccessController.doPrivileged(Native Method)
	at java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(ProtectionDomain.java:74)
	at java.awt.EventQueue.dispatchEvent(EventQueue.java:728)
	at java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:205)
	at java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:116)
	at java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:105)
	at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:101)
	at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:93)
	at java.awt.EventDispatchThread.run(EventDispatchThread.java:82)
 Create Failed!

Recommend Projects