Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

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