MicroPython-ESP32之WebRepl-1Z实验室

出品：1Z实验室 1zlab.com
1ZLAB: Make Things Easy

导引

其实这篇文章,笔者一直在犹豫要不要写.两点原因:

MicroPython官方给出的WebRepl其实体验不怎么样,并不能真正的提高开发者们的生产效率.
我分析了WebRepl的源码,正在用更先进的web技术来构造一款Web (伪)IDE,以此来为开发者们提供更好的开发效率和更优质的开发体验.
但由于这段时间一直忙于开发,更新节奏有点慢,便借此为大家稍作讲解 webrepl的使用,同时,对于我们1Z实验室正在开发的工具,稍作预告(画饼).

什么是WebRepl

webrepl.png

点我前去官网围观

除了简洁(丑陋),似乎再没什么优点.
由于MicroPython目前并不是很完善,所以其配套的开发工具一并都十分的简陋.这个WebRepl的功能,大致分为三部分:

1 通过浏览器访问的的WebRepl组件,使用WebSocket进行通信.用户可以方便的在网页上与MicroPython的Repl进行交互,避免了USB串口连线的限制.
2 向设备发送文件
3 从设备获取文件,以下载的方式

不足之处也很明显:

1 WebRepl样式单一,字体过小
2 界面存有大量留白,利用率不高
3 没有汉化(可能大部分人都不需要)
4 笔者仔细分析了这个WebRepl网站的源码,发现了大量的毫无用处的样式文件,占到了源代码很长的篇幅...感觉就像是在某个demo模板里改过来的.

可见,这个"官方"的WebRepl在一定程度上,解决了开发MicroPython的基本需求,但是对于工具的便捷性而言,实质上对开发效率的提高收效甚微.

如何使用WebRepl呢?

虽然目前的WebRepl存在诸多不足,但是还是很有必要对此进行一番学习和应用的,因为无线调试和开发的应用场景还是较为频繁的.使用WebRepl也十分的简单,大致分为以下几个步骤:

将你的设备连接至无线网络

介于笔者之前有专门叙述过这里便不再赘述,详细请移步MicroPython-ESP32之更合理的建立wifi连接-1Z实验室

在MicroPython中开启WebRepl

只需在REPL中输入:

import webrepl_setup

然后在询问是否开启WebRepl中选择开启:

Would you like to (E)nable or (D)isable it running on boot?
(Empty line to quit)
> E

然后根据根据提示设置密码,这个密码是在建立WebSocket通信时需要进行的验证,请牢记.

最后一步,需要我们手动去开启webrepl

import webrepl
webrepl.start()

为了正真的把WebRepl服务添加到每次的启动中,你需要把以上代码放入boot.py或main.py中.

以boot.py为例,贴出以下代码,包含了开机的wifi连接以及自动开启webrepl.

def do_connect():
    import json
    import network
    # 尝试读取配置文件wifi_confi.json,这里我们以json的方式来存储WIFI配置
    # wifi_config.json在根目录下
    
    # 若不是初次运行,则将文件中的内容读取并加载到字典变量 config
    try:
        with open('wifi_config.json','r') as f:
            config = json.loads(f.read())
    # 若初次运行,则将进入excpet,执行配置文件的创建        
    except:
        essid = input('wifi name:') # 输入essid
        password = input('wifi passwrod:') # 输入password
        config = dict(essid=essid, password=password) # 创建字典
        with open('wifi_config.json','w') as f:
            f.write(json.dumps(config)) # 将字典序列化为json字符串,存入wifi_config.json
            
    #以下为正常的WIFI连接流程        
    wifi = network.WLAN(network.STA_IF)  
    if not wifi.isconnected(): 
        print('connecting to network...')
        wifi.active(True) 
        wifi.connect(config['essid'], config['password']) 
        import time
        time.sleep(5) #一般睡个5-10秒,应该绰绰有余
        
        if not wifi.isconnected():
            wifi.active(False) #关掉连接,免得repl死循环输出
            print('wifi connection error, please reconnect')
            import os
            # 连续输错essid和password会导致wifi_config.json不存在
            try:
                os.remove('wifi_config.json') # 删除配置文件
            except:
                pass
            do_connect() # 重新连接
        else:
            print('network config:', wifi.ifconfig()) 

if __name__ == '__main__':
    do_connect()
    import webrepl
    webrepl.start()

使用WebRepl

dev.1zlab.com

em等等,我们使用的好像不是同一个 WebRepl?
没错,这就是1Z实验室的小伙伴为大家开发的新的WebRepl,暂时项目取名为MicroIDE.使用教程--1Z实验室-MicroIDE使用说明文档
目前还在开发阶段哦,基础功能大致已经完善,但是UI似乎不是...毕竟我们没有专业做web前端的程序员,所以如果你碰巧是一个前端大佬,是否愿意加入一起开发呢?

推广

ad.png