UnitV Maixpy上手指南
驱动安装
将设备连接至PC，打开设备管理器为设备安装
FTDI驱动
。以win10环境为例,下载匹配操作系统的驱动文件, 并解压,通过设备管理器进行安装。（注:某些系统环境下,需要安装两次,驱动才会生效,未识别的设备名通常为M5Stack或USB Serial, Windows推荐使用驱动文件在设备管理器直接进行安装(自定义更新), 可执行文件安装方式可能无法正常工作）。
点击此处，前往下载FTDI驱动
对于MacOS用户安装前请勾选 系统偏好设置 - >安全性与隐私 - >通用 - >允许以下位置下载的App - > App Store和认可的开发者选项。
EasyLoader
1.EasyLoader是一个简洁快速的程序烧录器,每一个产品页面里的EasyLoader都提供了一个与产品相关的案例程序,对于不需要对固件进行定制或进行其他操作的用户,使用EasyLoader为UnitV烧录固件,会是一个最简洁的方案（目前EasyLoader仅适用于Windows操作系统）.
2.下载软件后,双击运行应用程序,将M5设备通过数据线连接至电脑,选择端口参数,点击 "Burn" 即可开始烧录
固件烧录
需要指定烧录文件的用户也可以选用Kflash进行固件烧录.
1.点击下方对应自己操作系统的 Kflash_GUI烧录工具进行下载.
| 软件版本 | 下载链接 |
|---|---|
| Kflash_GUI_Windows | Download |
| Kflash_GUI_MacOS | Download |
| Kflash_GUI_Linux | Download |
2.将设备通过Tpye-C数据线连接至电脑,双击打开烧录工具Kflash_GUI应用程序,选择对应的设备端口、开发板类型(M5StickV)、固件程序、波特率. 点击下载,开始烧录 .
Kflash
3.对于习惯使用命令行操作的用户来说还可以选择Kflash作为固件烧录工具. 点击此处查看详情
串口调试工具
1.编程UnitV需要使用到串口调试工具,您可以使用Putty作为串口调试工具, 点击此处 访问Putty资源页面,选择对应自己操作系统Putty进行下载,并安装.
2.运行Putty后,将UnitV通过Tpye-C数据线连接至电脑端口,在Putty中设置相应的端口号与波特率,点击"open",开始连接. （你可以通过查看设备管理器得到UnitV所使用的端口号）
连接成功后,将自动进入,MaixPy 的交互界面. 此时设备正在运行着默认程序,您可以通过按下快捷键"Ctrl+C"中断其运行,并进入命令行.
编辑与运行文件
编辑文件
在交互解释器（REPL）中,我们能够便捷的输入程序并马上得到运行结果,但这仅适合用作短程序的验证,在实际项目中,庞大代码量使得我们不得不将代码编辑成一个个的文件.
在 MaixPy 中,内置了一款编开源编辑器 Micropython Editor(pye) ,这使得我们能够非常方便的修改程序文件.
使用 os.listdir() 可以查看当前目录下的文件,
使用 pye("hello.py") 可以创建文件并进入编辑模式(已存在同名文件,则仅进入编辑), 快捷键等使用说明可以在
这里查看
在编辑器中完成编辑后,按 Ctrl+S > Enter 键进行保存, 按 Ctrl+Q 退出编辑
注意: 使用这款编辑器对使用的串口工具有一定要求, 必须将 BackSpace 按键设置为 DEL 功能, 否则按 BackSpace 调用的是 Ctrl+H 一样的功能（即字符替换）
运行文件
使用 os.chdir() 切换当前目录到文件的目录,比如 os.chdir("/flash")
方法一: import
然后执行 import hello
即可看到输出 hello maixpy
使用此方法简单易用,但是需要注意的是, 目前 import 只能使用一次, 如果第二次 import, 则文件不会再执行, 如果需要多次执行,建议使用下面的方法
方法二: exec()
使用 exec() 函数来执行
with open("hello.py") as f:
exec(f.read())
开机自动运行脚本
系统会在 /flash 或者 /sd 目录创建 boot.py 文件, 开机会自动先执行这个脚本, 编辑这个脚本的内容即可实现开机自启
MaixPy IDE
下载MaixPy IDE
MaixPy IDE能够便捷的实现脚本程序的实时编辑、上传、执行,以及实时监控摄像头图像,文件传输等功能.使用 MaixPy IDE 因为数据的压缩、传输需要耗费一部分资源,所以性能会有所降低,但对性能需求不苛刻,或处于调试阶段的开发者来说这会是一个很不错的开发工具.
安装MaixPy IDE
Windows平台可直接双击exe文件,运行安装程序.
Linux命令行给运行权限然后,执行命令
chmod +x maixpy-ide-linux-x86_64-0.2.2.run
./maixpy-ide-linux-x86_64-0.2.2.run
使用MaixPy IDE
运行MaixPy IDE, 点击工具栏,选择开发板的型号.Tool-> Select Board-> M5StickV (工具->选择开发板)
点击左下角的连接按钮,并选择正确的连接端口,点击OK.
当连接按钮由绿色变为红色的时表示,已经连接成功,你可以在上方的编辑框进行代码编辑,点击左下角的运行按钮能够执行代码,进行验证.
WS2812
固件内置了WS2812 RGB LED驱动库,以下为参考例程. 注意:由于UnitV的拓展端口不具备驱动负载功能,因此该程序仅适用于驱动内置的RGB LED:
from modules import ws2812
from fpioa_manager import *
fm.register(8)
class_ws2812 = ws2812(8,100)
r=0
dir = True
while True:
if dir:
r += 5
else:
r -= 5
if r>=255:
r = 255
dir = False
elif r<0:
r = 0
dir = True
for i in range(100):
a = class_ws2812.set_led(i,(0,0,r))
a=class_ws2812.display()
程序库
在程序库文档中,你可以找到更多的API,方便你搭建各式各样的应用。