Skip to content

🛠 Simple! Easy! Quick! Flash your micropython on esp32 or esp8266!

License

Notifications You must be signed in to change notification settings

BPI-STEAM/mpy-flasher

Repository files navigation

     一款烧写 MicroPython 固件的工具

English Docs

MIT

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

特点:

  1. 自动查找 本机串口 和 软件启动目录下的固件(.bin)文件。

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

  3. 允许调用自定义的 Python esptool 烧写脚本,例如:esp_config.py。

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

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

系统要求

  • Python 3.5.4 +
  • requirements.txt

使用方法

运行 mpy-flasher 软件

1. 到 releases 下载 mpy-flasher.exe 。

寻找你所用的系统版本并下载,如果下载很慢,可以用微云地址,下载后双击运行它。

2. 运行 mpy-flasher.py 代码

pip install -r requirements.txt

python mpy-flasher.py

烧写 MicoPython 固件

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

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

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

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

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

准备 MicroPython 固件(.bin)文件

你可以将下载好的固件,如果你不知道在哪下载,可以到 micropython download 下载官方标准的固件与软件置于同一目录下,如下图效果。

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

烧写 Bpibit (esp32)的 MicroPython

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

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

烧写 NodeMCU (esp8266)的 MicroPython

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

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

高级烧写模式

如果你不想使用内置的 MicroPython 烧写脚本的方式,你也在软件同目录下放置以下示例脚本 esp_config.py 来自定义 esptool 烧写脚本,如下代码所示。

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)

自动烧写配置

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

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

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

对应的配置功能如下:

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

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

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

pyinstaller

  1. create mpy-flasher.exe

pyinstaller -c -F mpy-flasher.py -i logo.ico -p venv\Lib\site-packages

uplaod pypi

python setup.py sdist build
# pip install twine
twine upload dist/* --verbose