Fadecandy: Pre-compiled Binaries
This directory contains convenient precompiled firmware and server binaries for Fadecandy. This file explains the conventions for the various types of files here.
Fadecandy Server
-
fcserver-osx
- Ready-to-run fcserver for Mac OS 10.6 and later
-
fcserver.exe
- Ready-to-run fcserver for Windows 7 and later
-
fcserver-rpi
- Ready-to-run fcserver for Raspberry Pi
- May also work on other ARM Linux distributions
- Requires root privileges and/or special usbfs configuration
Firmware Images
-
fc-boot-v###.hex
- Bootloader image only, in Intel Hex format.
- This can be combined with other images to create a bootloader plus firmware image, or you can burn it alone and flash firmware separately using dfu-util.
- For use with Teensy Loader, JTAG debuggers, or the Testjig.
-
fc-firmware-v###.hex
- Firmware image, including bootloader, in Intel Hex format.
- For use with Teensy Loader, JTAG debuggers, or the Testjig.
- Since this includes the bootloader, it can be updated with dfu-util if necessary.
-
fc-firmware-v###.elf
- ELF binary for the firmware. Includes debug symbols. Does NOT include the bootloader.
- For use with GDB. Also used to generate Testjig firmware images.
- Mainly used as a source file for generating other types of firmware images. You probably won't use it directly.
-
fc-firmware-v###.dfu
- Firmware image for DFU firmware updates.
- For use with dfu-util to update firmware without any special debug hardware.
Firmware Update Tool
Firmware updates use the open source dfu-util package.
Usage:
$ dfu-util -D fc-firmware-v###.dfu
- On Windows, you may need to run this multiple times as Windows will need to install drivers automatically for the Bootloader device.
- First the Fadecandy board will go into bootloader mode. The LED will light.
- Next, firmware will download. During this process, the LED blinks.
- When the firmware download is done, the LED will go dark.
For example:
$ dfu-util -D fc-firmware-v106.dfu
dfu-util 0.7
Copyright 2005-2008 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2012 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to dfu-util@lists.gnumonks.org
Opening DFU capable USB device... ID 1d50:6082
Run-time device DFU version 0101
Found DFU: [1d50:6082] devnum=0, cfg=1, intf=0, alt=0, name="Fadecandy Bootloader"
Claiming USB DFU Interface...
Setting Alternate Setting #0 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 0101
Device returned transfer size 1024
Dfu suffix version 100
bytes_per_hash=296
Copying data from PC to DFU device
Starting download: [##################################################] finished!
state(7) = dfuMANIFEST, status(0) = No error condition is present
state(7) = dfuMANIFEST, status(0) = No error condition is present
...
- Windows:
dfu-util.exe
is included here, for convenience - Mac OS: Install this with homebrew:
brew install dfu-util
- Linux: dfu-util is probably in your favorite package manager