Flashing / Upgrading your iron

Downloading source file

In the development of this firmware, there are three types of firmware released. These are the "Main" stable releases, which generally have high confidence in being bug free. Release candidates are released slightly more often, and these are generally perfectly fine for everyday use. These are released early to allow for translation checking and for wonderful people to help spot bugs and regressions. Finally, there are the "mainline" builds, which are built from the main git branch. These are built on every change and can be found on the Actions tab (see below).

Main release

Main releases are made to the releases page. Download the zip file that matches your model of soldering iron and extract it. Select the appropriate file type for your unit, in general Miniware devices need .hex, Pinecil V1 needs .dfu, and Pinecil V2 needs .bin. Flash according to details below.

Bleeding edge / latest

For the latest code, you need to download the zip file from the artifacts page for the build that you want. Head to the Actions page and then select the run for the appropriate branch and beta you would like. In general you probably want master.

Once you click on a run, scroll down to the "Artifacts" section and then click on your device model name to download a zip file. Then this works the same as a production release (use the correct file).

Pinecil V2

  • The MCU in Pinecil V2 is Bouffalo BL706 and does not use usb-dfu for flashing as the previous Pinecil V1 MCU did.
  • See the Pinecil Wiki page here for instructions.
  • The V2 uses the BLISP flasher to upload the firmware to the MCU.
  • The Pinecil Wiki is a great resource for all things Pinecil.
  • Community chat: if there are issues updating, then join the Pine64 > Pinecil channel here. There are knowledgeable members in Discord/Telegram/Matrix. Discord has a bridge bot connection to Telegram and Matrix so that all pine64 volunteers/members can see advice for Pinecil and related items or just get tips on which power supply to purchase.
  • One advantage of Pinecil is that you cannot permanently damage it doing a firmware update (because BIN is in ROM); an update could render Pinecil temporarily inoperable if you flash an invalid firmware. But no worries, simply re-flashing with a working firmware copy will fix everything.
  • USB-C cable is required to do an update. Generally, all USB controllers work, but some hubs have issues, so it is preferred to avoid USB hubs for updates.
  • Background on the BL706 chipset