Living Music Machines

Firmware updates

Yuna · updated over USB-C from a Mac or a Windows PC

Yuna's voice and behaviour run on firmware that can be updated. Updates are free. When one is out, owners get the file by email, and the changes are listed at the bottom of this page.

What you need

Nothing on her microSD card changes, and your settings live on the panel, so there's nothing to back up.

An update has three parts: Part 1 puts Yuna into update mode, Part 2 installs the file (follow the Mac or the Windows version), and Part 3 puts her back in the case.

Part 1 · Put Yuna into update mode

  1. Turn your case off.
  2. Undo Yuna's panel screws and lift her out far enough to reach the back of the board. Keep the power cable connected, hold her by the panel edges, and rest her where nothing metal can touch the board.
  3. Plug the USB-C cable into the port on the back of the board, and the other end into your computer.
  4. Hold down the small BOOT button on the back of the board, between the microSD slot and the USB-C port.
  5. Keep holding it, turn the case on, then let go.

Her face won't appear while she's in update mode. That's normal.

Part 2 · Install the update on a Mac

  1. Install Homebrew if you don't have it, then open Terminal and run:
    brew install dfu-util
    You only need to do this once.

    If Terminal says command not found: brew, Homebrew is installed but Terminal can't find it yet. This is common on Apple Silicon Macs (M1 and later). Run these two lines, one at a time, then run brew install dfu-util again:

    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
    If it still says not found, close Terminal, open a new window and try once more.
  2. Check that the Mac can see Yuna in update mode:
    dfu-util -l
    You should see a line with 0483:df11. If not, go back to Part 1 and put her into update mode again.
  3. Install the update. Change the file name to match the one you downloaded:
    dfu-util -a 0 -s 0x08000000:leave -D ~/Downloads/yuna_firmware_v1.1.bin
  4. Wait for File downloaded successfully. It takes a few seconds. An Error during download get_status line right at the end is harmless. Then go on to Part 3.

Part 2 · Install the update on Windows

  1. Download and install STM32CubeProgrammer, ST's free updater for the chip inside Yuna. ST asks for an email address before the download. The installer also sets up the USB driver.
  2. Open STM32CubeProgrammer. In the panel on the right, set the connection type to USB, click the refresh button next to Port until USB1 appears, then click Connect. If USB1 never appears, go back to Part 1 and put her into update mode again.
  3. Open the Erasing & Programming tab (the second icon on the left). Under File path, browse to the update file.
  4. Set Start address to 0x08000000, tick Run after programming, and click Start Programming.
  5. Wait for the "File download complete" message, click Disconnect, then go on to Part 3.

Part 3 · Finish

  1. Turn the case off, unplug the USB cable, and screw Yuna back in.
  2. Turn the case on. She boots as usual with the new firmware.

If something goes wrong

You can't break Yuna with an update. Update mode is built into the chip and can't be overwritten, so if an update stops halfway or the wrong file goes in, start again from Part 1.

Release notes

Yuna isn't shipping yet. Version 1.0 will come on the first batch of units, and each update after it will be listed here, newest first.

← Support About · FAQ · Manuals · Support · Contact · Privacy