使用esp32+micropython+microdot搭建web(http+websocket)服务器（超详细）第一部分

  • microdot文档速查 什么是Microdot?Microdot是一个可以在micropython中搭建物联网web服务器的框架
  • micropyton文档api速查 Quick reference for the ESP32

先来个小demo先体验一下

演示视频链接

视频中我们简单的实现了

  • 使用esp32搭建web服务器
  • 实现get请求
  • 上传网页到服务器
  • 手机打开网址访问该网页
  • 服务器处理请求，实现开灯关灯操作

准备工作

百度网盘：https://pan.baidu.com/s/1ZKbaGjdjuBMJgK9l6w9mdg?pwd=1234 提取码：1234

  • esp32开发板一个
  • micro数据线一条（支持数据传输，有些只能充电）
  • micropython固件，下载地址MicroPython – Python for microcontrollers或者网盘中获取（esp32-20220618-v1.19.1.bin）
  • esp32电脑驱动(没有他电脑不能识别esp32)，网盘中获取（esp32usbDriver.zip）
  • Thonny，下载地址Thonny, Python IDE for beginners 或者网盘中获取（thonny-4.1.1.exe）
  • vscode，下载地址Documentation for Visual Studio Code 或者网盘中获取（VSCodeUserSetup-x64-1.79.2.exe）
  • microdot Microdot是一个可以在micropython中搭建物联网web服务器的框架(点击查看)

安装esp32电脑驱动

  • 解压该文件
  • 点击安装该驱动（64位电脑选择上面，32位电脑选择下面）
  • 安装完记得重启电脑，不然可能不生效

安装Thonny

  • 点击安装

  • thonny切换中文，点击tools

    • 点击options
    • 选择language，中文
    • 重启就汉化成功

  • 新建一个空文件夹，然后新建一个main.py文件

  • 使用thonny打开它

给esp32刷入micropython固件

  • micro数据线连接电脑，然后连接esp32
  • 点击配置解释器
  • 选择Micropython（esp32）解释器和选择端口，这个端口就安装电脑驱动之后生成的，名字可能不一样（如果没有端口，可能是驱动没装上或者线没连好）[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-dUJJotD8-1687272884567)()]

  • 点击Install or update MicroPython选择端口和固件（网盘里面有）

  • 等待进度条走完就好了

  • 如果一直不显示百分比 按住 esp32上的boot键

    • ESP32开发板上有2个按键,分别是boot和EN。烧录前需要先打开Download模式:长按boot键,按一下EN键,即可烧录。烧录完毕,按EN返回运行模式。

  • 完成！

  • 右下角已经可选esp32开发板了

  • esp32首先执行的是boot.py文件。该文件是由MicroPython系统创建的。因此您无需自己创建该文件就可以在刚刚刷好固件的NodeMCU开发板根目录下找到它。我不建议MicroPython的初学者对该文件进行修改，因为boot.py文件出现问题能会导致MicroPython无法正常启动，严重的会导致系统崩溃。要修复可能只有重新刷固件才行。所以除非您很了解MicroPython，否则请不要自行修改该文件。

    执行完boot.py以后，启动中的NodeMCU接下来将会执行main.py文件。如果您希望NodeMCU在每次启动后都执行一系列操作的话，可以将您的指令代码写入该文件。由于main.py文件是用户自己建立的而不是MicroPython系统建立的，因此在刚刚刷好固件的开发板根目录下是不存在该文件的。假如MicroPython在启动中找不到main.py文件，它会在系统启动时报错（如下图所示）。

  • 所以我们新建main.py,删除boot.py，main.py作为项目的主入口文件

安装vscode

  • 双击（VSCodeUserSetup-x64-1.79.2.exe）文件

esp32web服务器接口的搭建

  • 解压网盘中的microdot-main.zip

    • microdot-main\src下面有我们需要的文件

  • 在MicroPython设备 新建目录结构

    • lib 存放一些库文件

      • microdot.py （microdot-main\src中）

    • common

      • connect_wifi.py （连接热点）

    • public 存放网页内容

      • index.html 网页

    • main.py （程序主入口）

connect_wifi.py

# 操作esp32引脚from machine import Pin​# 操作时间 延迟几秒等import time​# 网络相关的函数import network​# esp32 引脚2是一颗自带的 led的灯light = Pin(2,Pin.OUT)def do_connect():# wifi模式wlan = network.WLAN(network.STA_IF)# 激活wlan.active(True)print("开始连接...")print("连接中...")#连接超时设置start_time = time.time()if not wlan.isconnected():# 自家的wifi名和密码wlan.connect("Xiaomi_A246","zy415415666")while not wlan.isconnected():# 灯亮light.value(1)# 延迟一秒time.sleep(1)# 灯灭light.value(0)time.sleep(1)# 15秒内没连接上就是超时了if time.time() - start_time > 15:print("wifi连接超时！！！")breakreturn Falseelse:print("连接成功！！！！")light.value(0)# 打印 网络信息print("网络配置:",wlan.ifconfig())return True​

main.py

# 导入Microdotfrom lib.microdot import Microdot# 连接wififrom common.connect_wifi import do_connect# 导入引脚from machine import Pin# esp32 引脚2是一颗自带的 led的灯light = Pin(2,Pin.OUT)​# 开始连接wifido_connect()# 实例化这个类app = Microdot()​# 设置一个get请求 如果@app.get('/on')def index(request):# 如果收到get请求on就开灯light.value(1)return "开灯了"​@app.get('/off')def index(request):# 如果收到get请求off就关灯light.value(0)return "关灯了"# 端口号为5000app.run(host='0.0.0.0', port=5000, debug=False, ssl=None)

执行main.py

  • esp32指示灯闪烁
  • 控制台打印ip地址等信息 就表示服务器已经启动好了
  • 打开浏览器输入ip+端口 成功啦！！！

新建网页

打开vscode编写一个网页

index.html

esp32服务器网页*{margin: 0;padding: 0;}button{width: 200px;height: 200px;}
开灯小网页
const onBtn = document.querySelector(".on");const offBtn = document.querySelector(".off");// 监听按钮点击事件onBtn.addEventListener("click",(e)=>{fetch("/on",{method:"get",}).then(e=>{console.log("消息",e);}).catch(error=>{console.log("报错了",error);})})offBtn.addEventListener("click",(e)=>{fetch("/off").then(e=>{console.log("消息",e);}).catch(error=>{console.log("报错了",error);})})​​

esp32部署网页

  • 将index.html文件放在public文件下面

  • 修改main.py

    # 导入Microdotfrom lib.microdot import Microdot,send_file# 连接wififrom common.connect_wifi import do_connect# 导入引脚from machine import Pin# esp32 引脚2是一颗自带的 led的灯light = Pin(2,Pin.OUT)​# 开始连接wifido_connect()# 实例化这个类app = Microdot()​# 返回一个网页@app.route('/')def index(request):return send_file('public/index.html')​# 设置一个get请求 如果@app.get('/on')def index(request):# 如果收到get请求on就开灯light.value(1)return "开灯了"​@app.get('/off')def index(request):# 如果收到get请求off就关灯light.value(0)return "关灯了"​# 端口号为5000app.run(host='0.0.0.0', port=5000, debug=False, ssl=None)​

开发完成

  • 重新运行main.py,
  • 打开浏览器输入地址
  • 点击网页上的开灯和关灯按钮，可以看到esp32上面的灯亮和灯灭
  • 开发结束！！！！！

第二部分马上就来！