出品: 1ZLAB 1zlab.com
EMP
EMP (Easy MicroPython) is a upy module to make things Easy on MicroPython.
当前版本为0.1.11, 包含以下几个模块:
- emp_boot.py 一句代码用于设置MicroPython的boot启动模式
- emp_wifi.py 一句代码搞定WIFI连接
- emp_utils.py 工具模块,包含了emp_boot.py 和emp_wifi.py模块的一些依赖
- emp_dev.py 原microide.py,封装了一些文件操作的接口,供microide所调用的,现在已放置当前项目维护
当前版本主要包含的功能是为用户提供便捷的WIFI连接,通过emp_wifi.py
通过EMP来设置MicroPython开机WIFI连接和WebREPL
第一步,让你的MicroPython设备连接到网络
(如果已经连接请忽略,直接执行第二步)
连接wifi的代码如下:
>>> import network
>>> wifi = network.WLAN(network.STA_IF)
>>> wifi.active(True)
>>> wifi.connect('<essid>', '<password>') #essid为WIFI名
>>> I (62825) wifi: n:1 1, o:1 0, ap:255 255, sta:1 1, prof:1
I (63395) wifi: state: init -> auth (b0)
I (63405) wifi: state: auth -> assoc (0)
I (63465) wifi: state: assoc -> run (10)
I (63515) wifi: connected with 你的WIFI名字, channel 1
I (63515) wifi: pm start, type: 1
I (63515) network: CONNECTED
I (64385) event: sta ip: 192.168.0.115, mask: 255.255.255.0, gw: 192.168.0.1
I (64385) network: GOT_IP
# 至此,可能你需要回车一下,才能出现下一 提示符 >>>
>>>
第二步,安装emp-1zlab库
>>> import upip
I (240305) modsocket: Initializing
>>> upip.install('emp-1zlab')
Installing to: /lib/
Warning: pypi.org SSL certificate is not validated
Installing emp-1zlab 0.1.11 from https://files.pythonhosted.org/packages/59/95/b9e425d00c195c9beb2e77c0b02020676115c42762a32d61047650e3884b/emp-1zlab-0.1.11.tar.gz
>>>
第三步,设置启动模式
>>> from emp_boot import set_boot_mode
>>> set_boot_mode()
[0] Boot with nothing
attention: this option will clear up boot.py, careful!
[1] Boot with wifi startup
this mode will auto start wifi connect program.
[2] Easy to develop
this mode is for developers.In this mode you can develop much easier via EMP-IDE(emp.1zlab.com)
Please input your choice [0-2]:
简单说明以下,第0项为启动脚本为空,这个会清除boot.py中的所有内容
第1项为开机时启动WIFI连接
第2项为开机启动WIFI连接的同时启动WebRepl,配合我们的IDE一起使用
第四步,按照提示进行开机引导
在此我们以第二项 Easy to develop为例:当你按下2回车后,你的设备将会重启:
# 以上省略若干行日志,以下会罗列出 你当前的可用WIFI
created config/wifi_cfg.json # 初次运行会创建配置文件
I (3675) network: event 1
[0] How_Router_Home -79 dBm
[1] CMCC-iEPD -83 dBm
No record available # 如果你有已经登陆过的wifi,那么将会尝试自动连接
scaning networks...
I (6205) network: event 1
[0] How_Router_Home -80 dBm
[1] CMCC-iEPD -84 dBm
Which one do you want to access? [0-1]
在此选择你想要连接的WIFI,我的WIFI是第0个:
scaning networks...
I (6205) network: event 1
[0] How_Router_Home -80 dBm
[1] CMCC-iEPD -84 dBm
Which one do you want to access? [0-1]0
Password for How_Router_Home: # 输入你的WIFI密码,回车
初次运行设置WebRepl
# 省略若干行日志
I (369455) network: CONNECTED
I (370225) event: sta ip: 192.168.0.115, mask: 255.255.255.0, gw: 192.168.0.1
I (370225) network: GOT_IP
You are connected to How_Router_Home
IP: 192.168.0.115 # 你的内网 IP
Netmask: 255.255.255.0 # 掩码
Gateway: 192.168.0.1 # 网关
Added record: How_Router_Home
WebREPL daemon auto-start status: enabled
Would you like to (E)nable or (D)isable it running on boot?
(Empty line to quit)
> E # E 为开启
To enable WebREPL, you must set password for it
New password (4-9 chars): 1zlab # 输入你的密码
Confirm password: 1zlab # 再次输入
No further action required
至此已成功的设置完成 你的MicroPython启动模式至 Easy develop模式,请访问我们的 网站emp.1zlab.com进行webrepl的高效开发吧!
可能你有如下的疑问:
-
自动连接wifi的话,我如何控制在多个网络下的连接?比如我有家两个路由器,分别为A,B,我都进行过连接,我该如何保证我想要连接到A而不是B呢?
>>> Wifi.set_default('<essid>') -
如何删除一条记录呢? 忘记WIFI?
>>> Wifi.del_record('<essid>') -
查看ip的接口?
>>> Wifi.ifconfig() You are connected to How_Router_Home IP: 192.168.0.115 Netmask: 255.255.255.0 Gateway: 192.168.0.1 -
断开当前的WIFI
>>> Wifi.disconnect() I (601244) wifi: state: run -> init (0) I (601244) wifi: pm stop, total sleep time: 565609183 us / 597113853 us I (601244) wifi: n:1 0, o:1 1, ap:255 255, sta:1 1, prof:1 I (601264) wifi: flush txq I (601264) wifi: stop sw txq I (601264) wifi: lmac stop hw txq I (601264) wifi: STA_DISCONNECTED, reason:8 E (601264) wifi: esp_wifi_connect 935 wifi not start I (601264) wifi: error attempting to reconnect: 0x3002 I (601274) network: event 3 WIFI connection has been disconnected -
重新连接到其他WIFI?
# TODO em,有点小bug,待修复 ...
