Firmware Upgrade ################ Prerequisites ------------- The ``usbmuxctl`` tool uses ``dfu-util`` to upgrade a devices firmware. On distributions based on Debian this is available as the ``dfu-util`` package. .. warning:: Firmware updates are not available on Windows! How to check for Firmware Updates --------------------------------- .. _firmware-upgrade: Firmware updates for the USB-Mux come packaged with the ``usbmuxctl`` python package. Make sure to update the ``usbmuxctl`` package from time to time. If a firmware update is available a message is displayed in ``usbmuxctl status`` and ``usbmuxctl list``: .. code-block:: bash $ sudo usbmuxctl list Serial | USB-Path | Host-DUT Lock? | Connections ----------- | ------------------ | -------------- | ----------- 22 | 1-3.1 | unlocked | None Software update for USB-Mux available Install an Update ----------------- Updates can be installed using the ``usbmuxctl update`` command. .. note:: This commands must be called with a ``--serial `` parameter even if only one USB-Mux is connected to the host. The command will install the currently packaged firmware onto the specified device: .. code-block:: none usbmuxctl --serial 00022 update dfu-util 0.9 Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. Copyright 2010-2016 Tormod Volden and Stefan Schmidt This program is Free Software and has ABSOLUTELY NO WARRANTY Please report bugs to http://sourceforge.net/p/dfu-util/tickets/ Opening DFU capable USB device... ID 0483:df11 Run-time device DFU version 011a Claiming USB DFU Interface... Setting Alternate Setting #0 ... Determining device status: state = dfuERROR, status = 10 dfuERROR, clearing status Determining device status: state = dfuIDLE, status = 0 dfuIDLE, continuing DFU mode device DFU version 011a Device returned transfer size 2048 DfuSe interface name: "Internal Flash " Downloading to address = 0x08000000, size = 12340 Download [=========================] 100% 12340 bytes Download done. File downloaded successfully OK