从按下复位键到main.pyESP-VISION启动流程与架构全景文章目录从按下复位键到main.pyESP-VISION启动流程与架构全景一、开篇你在REPL里敲的第一个命令背后发生了什么二、启动流程从芯片到Python2.1 硬复位 vs 软复位2.2 完整启动流程2.3 首次启动的特殊处理三、boot.py vs main.py3.1 boot.py在应用启动前做的事3.2 main.py应用入口3.3 ESP-VISION默认main.py四、架构全景4.1 分层架构4.2 各层职责4.3 源码结构速查五、MicroPython Overlay机制六、随芯片变化的源码七、故障恢复八、系列回顾参考链接总结一、开篇你在REPL里敲的第一个命令背后发生了什么你按下开发板的复位键1.5秒后REPL提示符出现。这1.5秒里ESP-VISION完成了从芯片上电到Python解释器就绪的全部工作。理解这个过程你才能理解为什么有的代码要放在boot.py、有的要放在main.py、有的要冻结到固件。本文是本系列的最后一篇带你看清ESP-VISION的全貌。二、启动流程从芯片到Python2.1 硬复位 vs 软复位复位类型触发方式发生了什么适用场景硬复位上电/复位键/machine.reset()/看门狗/深度睡眠唤醒重启MCU ESP-IDF MicroPython全部彻底重启软复位Ctrl-D / machine.soft_reset()仅重启MicroPython环境清理Python状态2.2 完整启动流程是否 上电 / 硬复位ESP-IDF启动初始化外设/内存/Flash挂载Flash文件系统_boot.py执行首次启动格式化文件系统创建默认文件加载已有文件系统执行 boot.py初始化网络等初始化MicroPython USB启用REPL执行 main.py应用入口进入 REPL 交互 等待输入2.3 首次启动的特殊处理ESP-VISION首次启动时如果Flash引导扇区为空格式化配置的vfs或ffat分区挂载到/创建默认文件/boot.py— 启动脚本/main.py— 应用入口/README.txt— 说明文件/.esp_vision_disk— 标记文件如果挂载或写入失败系统会尝试格式化文件系统并重新创建默认文件。格式化会清除该文件系统中的所有文件。⚠️ 正常固件升级或软复位不会覆盖已有启动文件。三、boot.py vs main.py3.1 boot.py在应用启动前做的事# boot.py — 适合执行# 1. 必须在应用启动前完成的操作# 2. 耗时短、结果确定# 3. 启动网络接口importnetwork# 选择产品模式# 连接WiFiwlannetwork.WLAN(network.STA_IF)wlan.active(True)wlan.connect(SSID,PASSWORD)# boot.py 必须返回不能包含死循环# ESP-VISION 在 boot.py 完成后才初始化 MicroPython USB# 阻塞的 boot.py 会导致 USB REPL 不可用3.2 main.py应用入口# main.py — 产品应用入口# 推荐将具体实现放在独立模块中importsysimportmy_apptry:my_app.main()exceptKeyboardInterrupt:raise# 允许Ctrl-C中断exceptExceptionaserror:print(Fatal application error:)sys.print_exception(error)# 产品环境可以调用 machine.reset() 自动恢复# 但无条件复位循环会增加调试难度3.3 ESP-VISION默认main.py默认的main.py会输出开发板就绪信息并在循环中休眠让VSCode扩展等主机工具能取得控制权。按Ctrl-C可中断并进入REPL。四、架构全景4.1 分层架构芯片层硬件抽象层算法层平台服务层绑定层Python层你的Python脚本应用逻辑MicroPython标准库asyncio / machine / networkmodules/Python ↔ C 绑定sensor / image / displayespdl / tflite / h264 / rtspplatform/共享运行时服务preview / display / sdcardusb_msc / jpeg / maincomponents/imlib纯C视觉算法源自OpenMVESP-DL端侧AI推理引擎boards//板级后端esp_video/V4L2esp32-cameraESP32-P4 / S3 / S31MIPI-CSI / DVP / PPA4.2 各层职责层级路径职责Python层你的脚本应用逻辑、编排绑定层modules/C/C绑定对象转换与轻量API适配平台服务层platform/共享运行时服务预览/显示/存储/USB/JPEG算法层components/imlib/纯C视觉算法MIT许可AI推理ESP-DL端侧深度学习推理板级后端boards/BOARD/板级配置、相机/显示/SD卡实现芯片层ESP32-P4/S3/S31MIPI-CSI/DVP/PPA硬件加速4.3 源码结构速查路径职责idf_ext.py板级感知的idf.py扩展micropython.cmake集成枢纽注册模块/平台/板级源文件lib/固定版本第三方子模块MicroPython/ulab/ZXing-Coverlay/micropython/ESP-VISION的MicroPython增量boards/各板配置、冻结清单、板级外设后端platform/共享运行时服务modules/MicroPython C/C绑定components/ESP-IDF组件imlib/ZXingmodels/可选模型资源example/MicroPython示例脚本stubs/.pyi类型存根五、MicroPython Overlay机制ESP-VISION以MicroPython v1.28.0为固定上游基线但做了大量修改。这些修改不直接改lib/micropython保持干净而是放在overlay/micropython/下lib/micropython/ # 干净的上游MicroPython永远不修改 overlay/micropython/ # ESP-VISION的增量修改 build/micropython/ # 构建时生成的合并副本prepare-micropython构建步骤会将overlay应用到build副本。lib/micropython子模块保持为干净的上游参考。六、随芯片变化的源码micropython.cmake根据IDF_TARGET和板级配置选择模块芯片额外模块额外后端ESP32-P4h264, rtsp, barcode(ZXing)esp_video/V4L2 PPAESP32-S3—esp32-cameraESP32-S31—esp_video/V4L2七、故障恢复如果应用导致设备无法正常启动# 在REPL中如果还能连接importosos.rename(/main.py,/main.disabled.py)# Ctrl-D 软复位# 如果连不上REPL擦除Flash重新烧录# idf.py --board BOARD -p PORT erase-flash# idf.py --board BOARD -p PORT flash monitor⚠️ 不擦除Flash的重新烧录不会清除文件系统有问题的boot.py/main.py会保留。八、系列回顾本系列12篇文章从ESP-VISION是什么到架构全景覆盖了全部核心内容篇目主题核心收获第1篇ESP-VISION是什么理解框架定位和价值第2篇芯片与开发板选择P4做视频推流S3做简单处理第3篇环境搭建30分钟编译第一个固件第4篇REPL调试交互式开发效率翻倍第5篇MicroPython语言数据结构选择内存管理第6篇图像模型像素格式帧缓冲ROI第7篇图像处理算法14个API从滤波到AprilTag第8篇摄像头流水线双缓冲PPA硬件加速第9篇AI推理部署ESP-DL vs TFLite Micro第10篇H.264RTSP网络摄像头完整方案第11篇软件包管理代码组织/分发/更新第12篇启动流程与架构从复位到main.py的全过程参考链接ESP-VISION 启动流程ESP-VISION 方案架构ESP-VISION 项目关系MicroPython v1.28.0 复位与启动总结ESP-VISION让嵌入式视觉开发的门槛从先学C和RTOS降到了会写Python就能上手。它把MicroPython的易用性、OpenMV的图像处理能力、ESP-DL的推理引擎和硬件编解码器全部整合在一起用统一的Python API暴露给开发者。这个系列写完了但你的ESP-VISION之旅才刚刚开始。拿一块板子烧一个固件在REPL里敲下第一行import sensor然后你就会明白——在MCU上写Python视觉应用真的可以这么简单。你还有什么想了解的ESP-VISION话题欢迎在评论区留言我会挑选呼声最高的主题继续深挖。作者码农阿虎运行环境ESP-VISION (MicroPython v1.28.0), ESP32-P4X-EYE关键词ESP-VISION架构、启动流程、MicroPython Overlay、分层设计、boot.py、main.py
从按下复位键到main.pyESP-VISION启动流程与架构全景文章目录从按下复位键到main.pyESP-VISION启动流程与架构全景一、开篇你在REPL里敲的第一个命令背后发生了什么二、启动流程从芯片到Python2.1 硬复位 vs 软复位2.2 完整启动流程2.3 首次启动的特殊处理三、boot.py vs main.py3.1 boot.py在应用启动前做的事3.2 main.py应用入口3.3 ESP-VISION默认main.py四、架构全景4.1 分层架构4.2 各层职责4.3 源码结构速查五、MicroPython Overlay机制六、随芯片变化的源码七、故障恢复八、系列回顾参考链接总结一、开篇你在REPL里敲的第一个命令背后发生了什么你按下开发板的复位键1.5秒后REPL提示符出现。这1.5秒里ESP-VISION完成了从芯片上电到Python解释器就绪的全部工作。理解这个过程你才能理解为什么有的代码要放在boot.py、有的要放在main.py、有的要冻结到固件。本文是本系列的最后一篇带你看清ESP-VISION的全貌。二、启动流程从芯片到Python2.1 硬复位 vs 软复位复位类型触发方式发生了什么适用场景硬复位上电/复位键/machine.reset()/看门狗/深度睡眠唤醒重启MCU ESP-IDF MicroPython全部彻底重启软复位Ctrl-D / machine.soft_reset()仅重启MicroPython环境清理Python状态2.2 完整启动流程是否 上电 / 硬复位ESP-IDF启动初始化外设/内存/Flash挂载Flash文件系统_boot.py执行首次启动格式化文件系统创建默认文件加载已有文件系统执行 boot.py初始化网络等初始化MicroPython USB启用REPL执行 main.py应用入口进入 REPL 交互 等待输入2.3 首次启动的特殊处理ESP-VISION首次启动时如果Flash引导扇区为空格式化配置的vfs或ffat分区挂载到/创建默认文件/boot.py— 启动脚本/main.py— 应用入口/README.txt— 说明文件/.esp_vision_disk— 标记文件如果挂载或写入失败系统会尝试格式化文件系统并重新创建默认文件。格式化会清除该文件系统中的所有文件。⚠️ 正常固件升级或软复位不会覆盖已有启动文件。三、boot.py vs main.py3.1 boot.py在应用启动前做的事# boot.py — 适合执行# 1. 必须在应用启动前完成的操作# 2. 耗时短、结果确定# 3. 启动网络接口importnetwork# 选择产品模式# 连接WiFiwlannetwork.WLAN(network.STA_IF)wlan.active(True)wlan.connect(SSID,PASSWORD)# boot.py 必须返回不能包含死循环# ESP-VISION 在 boot.py 完成后才初始化 MicroPython USB# 阻塞的 boot.py 会导致 USB REPL 不可用3.2 main.py应用入口# main.py — 产品应用入口# 推荐将具体实现放在独立模块中importsysimportmy_apptry:my_app.main()exceptKeyboardInterrupt:raise# 允许Ctrl-C中断exceptExceptionaserror:print(Fatal application error:)sys.print_exception(error)# 产品环境可以调用 machine.reset() 自动恢复# 但无条件复位循环会增加调试难度3.3 ESP-VISION默认main.py默认的main.py会输出开发板就绪信息并在循环中休眠让VSCode扩展等主机工具能取得控制权。按Ctrl-C可中断并进入REPL。四、架构全景4.1 分层架构芯片层硬件抽象层算法层平台服务层绑定层Python层你的Python脚本应用逻辑MicroPython标准库asyncio / machine / networkmodules/Python ↔ C 绑定sensor / image / displayespdl / tflite / h264 / rtspplatform/共享运行时服务preview / display / sdcardusb_msc / jpeg / maincomponents/imlib纯C视觉算法源自OpenMVESP-DL端侧AI推理引擎boards//板级后端esp_video/V4L2esp32-cameraESP32-P4 / S3 / S31MIPI-CSI / DVP / PPA4.2 各层职责层级路径职责Python层你的脚本应用逻辑、编排绑定层modules/C/C绑定对象转换与轻量API适配平台服务层platform/共享运行时服务预览/显示/存储/USB/JPEG算法层components/imlib/纯C视觉算法MIT许可AI推理ESP-DL端侧深度学习推理板级后端boards/BOARD/板级配置、相机/显示/SD卡实现芯片层ESP32-P4/S3/S31MIPI-CSI/DVP/PPA硬件加速4.3 源码结构速查路径职责idf_ext.py板级感知的idf.py扩展micropython.cmake集成枢纽注册模块/平台/板级源文件lib/固定版本第三方子模块MicroPython/ulab/ZXing-Coverlay/micropython/ESP-VISION的MicroPython增量boards/各板配置、冻结清单、板级外设后端platform/共享运行时服务modules/MicroPython C/C绑定components/ESP-IDF组件imlib/ZXingmodels/可选模型资源example/MicroPython示例脚本stubs/.pyi类型存根五、MicroPython Overlay机制ESP-VISION以MicroPython v1.28.0为固定上游基线但做了大量修改。这些修改不直接改lib/micropython保持干净而是放在overlay/micropython/下lib/micropython/ # 干净的上游MicroPython永远不修改 overlay/micropython/ # ESP-VISION的增量修改 build/micropython/ # 构建时生成的合并副本prepare-micropython构建步骤会将overlay应用到build副本。lib/micropython子模块保持为干净的上游参考。六、随芯片变化的源码micropython.cmake根据IDF_TARGET和板级配置选择模块芯片额外模块额外后端ESP32-P4h264, rtsp, barcode(ZXing)esp_video/V4L2 PPAESP32-S3—esp32-cameraESP32-S31—esp_video/V4L2七、故障恢复如果应用导致设备无法正常启动# 在REPL中如果还能连接importosos.rename(/main.py,/main.disabled.py)# Ctrl-D 软复位# 如果连不上REPL擦除Flash重新烧录# idf.py --board BOARD -p PORT erase-flash# idf.py --board BOARD -p PORT flash monitor⚠️ 不擦除Flash的重新烧录不会清除文件系统有问题的boot.py/main.py会保留。八、系列回顾本系列12篇文章从ESP-VISION是什么到架构全景覆盖了全部核心内容篇目主题核心收获第1篇ESP-VISION是什么理解框架定位和价值第2篇芯片与开发板选择P4做视频推流S3做简单处理第3篇环境搭建30分钟编译第一个固件第4篇REPL调试交互式开发效率翻倍第5篇MicroPython语言数据结构选择内存管理第6篇图像模型像素格式帧缓冲ROI第7篇图像处理算法14个API从滤波到AprilTag第8篇摄像头流水线双缓冲PPA硬件加速第9篇AI推理部署ESP-DL vs TFLite Micro第10篇H.264RTSP网络摄像头完整方案第11篇软件包管理代码组织/分发/更新第12篇启动流程与架构从复位到main.py的全过程参考链接ESP-VISION 启动流程ESP-VISION 方案架构ESP-VISION 项目关系MicroPython v1.28.0 复位与启动总结ESP-VISION让嵌入式视觉开发的门槛从先学C和RTOS降到了会写Python就能上手。它把MicroPython的易用性、OpenMV的图像处理能力、ESP-DL的推理引擎和硬件编解码器全部整合在一起用统一的Python API暴露给开发者。这个系列写完了但你的ESP-VISION之旅才刚刚开始。拿一块板子烧一个固件在REPL里敲下第一行import sensor然后你就会明白——在MCU上写Python视觉应用真的可以这么简单。你还有什么想了解的ESP-VISION话题欢迎在评论区留言我会挑选呼声最高的主题继续深挖。作者码农阿虎运行环境ESP-VISION (MicroPython v1.28.0), ESP32-P4X-EYE关键词ESP-VISION架构、启动流程、MicroPython Overlay、分层设计、boot.py、main.py
