Upgrading Firmware

Ben V. Brown edited this page Oct 18, 2018 · 10 revisions

Downloads for the hex files to flash are available on the releases page. If you run into issues with flashing the firmware this is usually down to issues in the DFU bootloader that comes with the iron. As this is closed source, there is nothing I can do to try and fix these issues.

Windows

Upgrading on Windows works following the published Miniware guide. Please note that you need to use the windows explorer for file copying. Using Teracopy, or other explorer replacements will make it fail.

  1. Hold the button closest to the tip, and plug in the USB to the computer.
  2. The unit will appear as a USB drive.
  3. Drag the .hex file onto the USB drive.
  4. The unit will disconnect and reconnect.
  5. The filename will have changed to end in .RDY or .ERR or .NOT
  6. If it ends with .RDY you're done! Otherwise, something went wrong
  7. Disconnect the USB and power up the iron. You're good to go.

Mac

sgr1ff1n (Shane) commented in issue 11 that upgrading worked on their Mac as per normal:

I just wanted to say that I was able to update the firmware on my ts100 from the stock version to 1.08 found in this repository using my Mac. I simply followed the same steps however through Finder. I have a MacBook Pro (13-inch, Mid 2012) running Sierra 10.12.4 (16E195).

Linux

While in past there were reports of unreliable upgrades, the consensus in issue 11 is that things work mostly as expected in Linux.

@awigen has contributed a script flash_ts100_linux.sh that works on Ubuntu 16.04 as well as other distro's.

If you want to do it manually (or if the script does not work for some reason) the general procedure is the same as for Windows, the differences are in the way to mount the unit and copy the firmware. Remember that after flashing, the firmware filename will have changed to end in .RDY or .ERR or .NOT and only .RDY means the flashing was successful!

  • The unit has to be mounted as msdos type (thanks @balrog-kun for having spotted it). You may disable automount, but unmounting the automounted drive and remounting as msdos works fine. You do not need to turn off automounting, but you do need to unmount the device with umount.
  • It is recommended to use an all-caps filename for the firmware, even if successful flashing were done with lower case names.
  • Avoid USB hubs, plug directly in your computer.
  • If it fails, try again several times the procedure.

Example, to be run as root, once the unit has been plugged in DFU mode and auto-mounted:

FW=ts100.hex
unset NAME
eval $(lsblk -P -p -d --output NAME,MODEL|grep "DFU Disk")
[ -z ${NAME+x} ] && exit 1  # Could not find DFU device
umount "$NAME"
mkdir /tmp/mntdfu
mount -t msdos "$NAME" /tmp/mntdfu
cp "$FW" "/tmp/mntdfu/$(basename $FW|tr a-z A-Z)"
sync
umount /tmp/mntdfu
rmdir /tmp/mntdfu

Device will reboot and automount will rerun if not disabled. Check the extension of your firmware, it should be .RDY now.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.