# esp_pyflasher

**Repository Path**: walkline/esp_pyflasher

## Basic Information

- **Project Name**: esp_pyflasher
- **Description**: Clone from https://github.com/youxinweizhi/esp_pyflasher
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2019-12-16
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一款烧写 MicroPython 固件的工具

用于上海乐鑫 ESP8266 / ESP32 系列芯片烧录 MicroPython 固件的 GUI 工具。

## 特点：

* 自动查找 本机串口 和 软件启动目录下的固件（.bin）文件。

* 支持启动配置，可以定义自动运行、是否擦除、高级烧录。

* 允许调用自定义的 Python esptool 烧写脚本，例如：esp_config.py。

* 同时运行 GUI 和 CMD 界面，可得知后台 log 信息，遇到问题截图贴出即可。

* Windows 下绿色单文件，开箱即用，也可使用 Python 跨平台运行。

## 系统要求

- Python 3.5.4 +
- requirements.txt

## 使用方法

### 运行 mpy-flasher 软件

### 1. 到 [releases](https://gitee.com/walkline/esp_pyflasher/releases) 下载 mpy-flasher.exe 。

寻找你所用的系统版本并下载，下载后双击运行它。

![](readme/00.png)

### 2. 运行 mpy-flasher.py 代码

```bash
pip install -r requirements.txt

python mpy-flasher.py
```

![](readme/01.png)

## 烧写 MicoPython 固件

以下面的两款 bpibit 和 nodemcu 硬件为例。

![](readme/03.png)

左边是 nodemcu (esp8266) 右边是 bpibit (esp32) ，均可以使用该工具烧录 MicroPython 固件（基于 esptool 依赖）。

运行软件后，可以点击 Board 下拉选择版型 esp8266 或 esp32 ，

![](readme/04.png)

此时连接你的硬件，此时会出现当前硬件的端口号（Com Port），如图中的 COM5 - USB-Serial CH340 (COM5)。

![](readme/05.png)

点击如图的 'COM5' 选项即可选定了烧写的硬件，之后就是根据你的硬件来选择烧写的固件。

## 准备 MicroPython 固件（.bin）文件

你可以将下载好的固件与软件置于同一目录或**新建一个子文件夹**（如果你不知道在哪下载，可以到 [micropython download](http://www.micropython.org/download) 下载官方标准的固件），如下图效果。

![](readme/07.png)

这样软件就会自动查找到固件，供你选择烧录了。

## 烧写 Bpibit （esp32）的 MicroPython

你可以看到将 Bpibit 硬件插入后，软件会显示如下情况。

![](readme/09.png)

根据红圈可以知道，选中了 esp32 ，勾选了 Erase （擦除板子），选择了esp32-bpibit-0521.bin 固件，点击 Flash 后运行烧写。

## 烧写 NodeMCU （esp8266）的 MicroPython

你可以看到将 NodeMCU 硬件插入后，软件会显示如下情况。

![](readme/11.png)

根据红圈可以知道，选中了 esp8266 ，勾选了 Erase （擦除板子），选择了 esp8266-20190125-v1.10.bin 固件，点击 Flash 后运行烧写。

## 高级烧写模式

如果你不想使用内置的 MicroPython 烧写脚本的方式，你也在软件同目录下放置以下示例脚本 [esp_config.py](https://github.com/junhuanchen/mpy-flasher/blob/master/esp_config.py) 来自定义 esptool 烧写脚本，如下代码所示。

```python
import os

def flash(com):
	FLASH_START = "0x1000"
	FLASH_MODE = "dio"
	FLASH_FREQ = "40m"

	import sys
	sys.argv = [
		'AutoFlash.py', '--chip', 'esp32',
		'--port', com,
		'--baud', '460800',
		'write_flash', '-z',
		'--flash_mode', FLASH_MODE,
		'--flash_size', '4MB',
		'--flash_freq', FLASH_FREQ,
		FLASH_START, os.getcwd() + '\\firmware.bin'
	]

	try:
		from esptool import main
		main()
		return None
	except Exception as e:
		print(e)
return str(e)
```

![](readme/13.png)

## 自动烧写配置

如果你将软件给一个初学者使用，你可以为他准备好初始配置，这样他就可以一键烧写了。

软件默认会在同目录下自动生成 config.ini 配置文件，其内容如下。

![](readme/15.png)

```ini
[DEFAULT]
auto = False
erase = False
advanced = False
```

对应的配置功能如下：

- auto 如果存在这个配置项，且值为 True，软件启动后会自动运行烧写，如同点击 Flash。

- erase 如果存在这个配置项，且值为 True，软件启动后会自动勾选 Erase 选项。

- advanced 如果存在这个配置项，且值为 True，软件启动后会自动勾选 Advanced 选项。

# pyinstaller

1. create mpy-flasher.exe

```bash
# 显示状态窗口
pyinstaller -c -F mpy-flasher.py -i logo.ico

# 不显示状态窗口
pyinstaller -c -F -w mpy-flasher.py -i logo.ico
```

> 如果`Windows`下编译失败则需要更新（降级）`pyinstaller`
> ```bash
> pip install https://github.com/pyinstaller/pyinstaller/archive/develop.tar.gz
> ```

# upload pypi

```bash
python setup.py sdist build
```

```bash
# pip install twine
twine upload dist/* --verbose
```