Skip to content
master
Switch branches/tags
micronucleus/commandline/
micronucleus/commandline/

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
This commandline application for the Micronucleus bootloader is written by
ihsan Kehribar <ihsan@kehribar.me> and Bluebie <a@creativepony.com>

It's been tested casually on Mac, Windows, and Linux, and aught to work on all
three. To make and install, do the regular 'make; sudo make install' on unixes.
If you're on linux and don't want a static binary, use 'make STATIC=' instead.

If you get the error "usb.h: No such file or directory" you must run "sudo apt-get install libusb-dev".

Building on windows requires mingw32+msys with lib-winusb32. Possibly it can also
be built with mingw64.

If building on Mac, you can choose to use Homebrew packages for libusb.
To do this, first run `brew install pkg-config libusb libusb-compat`,
then `make` (tested with OS X Mojave 10.14.6).

Usage on Ubuntu:
  sudo micronucleus --run name_of_the_file.hex
Usage on Mac:
  micronucleus --run name_of_the_file.hex
Usage on Windows
  micronucleus.exe --run name_of_the_file.hex

Raw binary file writing hasn't been tested as much as hex files.

Every now and then the program fails once it reaches the Writing stage - this is
a known bug - but if you simply rerun the micronucleus command immediately, it
will succeed the second time usually. Most of the time this issue is not present.

To linux users: sudo is used above because the default configuration under most
modern linux distributions is to not allow userspace apps to communicate
directly to unknown USB devices. You can fix this by installing some config
files, or you can just use sudo. Either way you're going to need root. To
configure your system to allow micronucleus access from non-root users, copy
49-micronucleus.rules from this folder to /etc/udev/rules.d/