Skip to content

Uploading the Firmware

pollito edited this page Aug 6, 2026 · 4 revisions

Index

  1. About
  2. Prerequisites
  3. Install ESPEasyFlasher
  4. Download PerryZi
  5. Upload PerryZi to the ESP8266
  6. Troubleshooting

About

This guide is explains how to upload the PerryZi ESP8266 firmware to the PerryFi.

It is geared towards Windows users. If you are using a different operating system, you will need to adjust these instructions to match your OS of choice.


Prerequisites

PerryFi 1.0

WARNING: PerryZi is not stable on the original PerryFi above 9600 baud so please use the old firmware instead. Because of this, the binary has been removed.

The only hardware you need is a USB-C cable. Remove the WEMOS D1 mini from the PerryFi before you start. If you do not, the upload will fail, and you may damage the PerryFi components.

Download and install the CH340 driver from the WEMOS site.

Plug the PerryFi into the USB-C cable, and the other end into your computer. Right-click the Start menu, and choose Device Manager. Now expand Ports (COM & LPT), and look for USB-SERIAL CH340. Note the COM port number in brackets. Now close Device Manager.

PerryFi 2.1

You will need a USB to TTL adapter. The only one I have tested is the CP2102 which is available, at the time of writing, for ₤0.99 on AliExpress. In addition, you will need four Dupont-style cables, which usually come with the adapter.

Download and install the CP210x Universal Windows Driver from the Silicon Labs site before starting.

Connect the 3.3V and GND on the USB to TTL adapter to the corresponding pins on the PerryFi, to the left of the ESP-12F module. Connect the TXD pin on the adapter to the RX pin on the PerryFi, and the RXD pin on the adapter to the TX pin on the PerryFi. NB: the RX and TX wires are crossed.

Plug the USB to TTL adapter into your computer. Then right-click the Start menu, and choose Device Manager. Now expand Ports (COM & LPT), and look for Silicon Labs CP210x USB to UART Bridge. Note the COM port number in brackets. Now close Device Manager.

Hold the PROGRAM button on the PerryFi, and press RESET. Now release the PROGRAM button, and your ESP-12F module will be in programming mode.


Install ESPEasyFlasher

Go to the ESPEasyFlash repo, and follow the instructions under Installation.


Download PerryZi

Download the latest PerryZi release here for your PerryFi version.

Copy the downloaded .bin file into the ESPEasyFlash folder from the previous section.


Upload PerryZi to the ESP8266

Run FlashESP8266.exe in ESPEasyFlash folder. For COM-Port, make sure you select the COM port you previously identified in Device Manager. Then, choose the relevant PerryFi firmware from the Firmware drop down menu, and click Upload to ESP.

A console window will appear, and the process will begin. If all goes well, the console window will close after a few seconds, and a pop up advising the Flash Complete will confirm that the process was successful.

If you have a PerryFi 1.0, unplug the WEMOS D1 mini, and re-insert it into the PerryFi. If you have a PerryFi 2.1, disconnect the Dupont-style cables.


Troubleshooting

If you are using a PerryFi 2.1, and get a Flash Failed error, your ESP-12F is probably not in programming mode. To put it into programming mode, leave everything plugged in, hold the PROGRAM button on the PerryFi, and press RESET. Now release the PROGRAM button, and try to upload the firmware again.

Clone this wiki locally