Skip to main content

​
Overview

The Pinecil V2 uses a Bouffalo BL706 MCU and does not use USB-DFU for flashing. Instead, it uses the BLISP flasher tool.
You cannot permanently damage Pinecil V2 during a firmware update because the bootloader (BIN) is in ROM. An invalid firmware flash may render it temporarily inoperable, but re-flashing with working firmware will fix everything.

​
Requirements

  • USB-C cable with data support
  • BLISP flasher tool
  • Downloaded .bin firmware file for Pinecil V2
A USB-C cable is required for updates. Avoid USB hubs when possible as some have compatibility issues.

​
Flashing Instructions

1

Download firmware

Download the Pinecil V2 firmware .bin file from the releases page
2

Install BLISP

Install the BLISP flasher tool for your operating system
3

Enter bootloader mode

Follow the BLISP instructions to put your Pinecil V2 into bootloader mode
4

Flash firmware

Use BLISP to upload the firmware to the MCU

​
Troubleshooting

​
Timeouts or Bootloader Errors

The BL706 has a USB PHY that can cause problems with certain cables and ports:
The USB PHY can struggle with cheap cables, especially thin ones without shielding. Use a good quality, short cable.This is especially common with cables supplied with Apple chargers when used with newer Ryzen processor ports.
Different USB ports may use different hubs or signaling lengths, which can fix the issue. Try multiple ports on your computer.
By design, Pinecil V2 exposes internal buses on USB3 pins for hacking/debugging. This may cause issues with some chipsets.Try using a USB 2.0 cable or a USB-C → USB-A → USB-C adapter chain (many adaptors are USB2 only).
Adding a USB hub in the chain can re-form the signal and work around connection issues.
Some users have reported Windows-specific issues that were resolved by switching to Linux (live CD).

​
Resources

Build docs developers (and LLMs) love

Get started for freeTalk to us