这篇文档以SIPEEDMaixDuino的使用为示例说明,并且大部分内容通用于K210系列开发板,可供购入K210系列顾客参考使用。
以下为MaixDuino全引脚标注图
在使用板子上手之前,我们需要先掌握一些基础知识(有基础的小伙伴可跳过)由于MaixPy是基于MicroPython之上进行开发构建的,提供给用户最终的接口是Micropython,所以在使用MaixPy之初我们需要熟悉下MicroPython的基础知识与语法以及常用的Git与Github。
以下是图像及音频的背景知识,有需要或感兴趣的小伙伴可以查看。
无论是新手小白还是开发者在踏入K210系列开发板学习之路前,做好充足的准备工作在一定程度上可以在使用途中避免踩坑。这篇文档是以一份避坑上手步骤的指南为核心来构写的,所以切记!!新手小白千万不可以跳着看,下图是示例硬件MaixDuino开发板、摄像头、屏幕、以及USBType-c数据线。
避坑指南可以搭配上手流程图一起使用更佳~
自行准备质量可靠或者是手机附赠的数据线,质量差的数据线会因电压问题造成开发板处于非正常工作状态导致后续影响使用,有些Type-C线只能供电。
在K210开发板上不使用MicroSD卡也可操作文件,我们在内部Flash上保留了一部分作为文件系统,只是Flash速度很慢,为了操作方便的话可以选购MicroSD/TF卡,以下图例为SD卡安装卡槽。
注意:MaixPy不支持挂载文件系统到电脑!!!K210芯片没有USB功能无法模拟U盘设备!!!不要再问为什么没有U盘或者是显示SD卡了!那不是K210那是M2dock跟openmv!
当我们收到开发板后,首先对硬件进行检查是否有外表损坏,接着再根据屏幕以及摄像头的排线丝印安装到开发板上,即排线上的数字“1”和板子卡座边上引脚丝印“1”方位对应接上。
先使用准备的USBtype-c数据线两端分别接入板子及电脑端进行上电操作,方便后续更新固件等使用。如果是新购买出厂的开发板的话,上电后会显示红色屏幕。
因K210没有USB硬件支持功能需通过USB转串口与电脑连接,所以用户需安装串口搭建板子与电脑的连接桥梁,点击文档链接根据板子的型号下载相对应的驱动,安装成功后设备管理器会显示(COMx)端口。
如果出现安装失败、安装后设备接入PC端的设备管理器不显示COM端口的现象,需要检查系统是不是正版或更新下(Win7Win8)系统,部分盗版系统会导致驱动安装失败或是安装后不显示。
升级固件对K210系列板子来说至关重要,快速避免掉用户在使用中无限踩雷影响体验感,例如常见的MaxiPyIDE连接失败、屏幕白屏/黄屏等现象,所以板子到手后更新固件成了必不可少的一件事情。
如果是第一次使用k210系列版更新固件,请无脑看图选标准固件(序号:15)!如果是因为应用需要特殊固件,看应用文档需要什么下载什么!其余一律看功能尾缀!功能尾缀!选择固件。K210Amigo开发板固件与以上不通用,固件请在(序号3-6)里选择下载。
参考上方描述选择(日期最新)所需的固件并下载到本地,使用kflash_gui烧录工具对板子进行升级固件。
使用MaixPyIDE进行调试操作的话,板子需烧录固件而且版本必须是v0.3.1以上,否则MaixPyIDE会出现连接不上的现象。
根据下图将K210开发板连接MaixPyIDE软件,连接成功后步骤3的图标会变成红色,接下来运行helloworld.py测试摄像头及屏幕是否可用,运行后开发板屏幕以及软件会显示摄像头画面。
如果是有基础的用户较推荐使用终端来调试,MaixPyIDE虽然运行报错会显示但信息可能不完整,而终端会输出更详细的报错信息方便排错。如果出现串口连接终端失败的现象,看看串口是否被占用。
点击MaixPyIDE软件页面上方的工具->打开终端->新终端->连接到串口->确定默认串口号->波特率:115200确定自动连接,连接后按复位即可正常编辑。
上文我们简单介绍了在MaixPyIDE上如何运行代码以及使用串口终端,但实际这些运行都是一次性并不保存到设备里,我们更希望代码保存在文件系统,这样不需要再次敲代码可直接运行程序更为便利快捷,小伙伴们可以参考以下的示例方法进行操作。
如何编辑并保存文件请参考以下示例:
如何执行文件请参考以下示例:
我们可以通过多种方式打开编辑器来直接编辑文件系统中的文件,但如果出现代码量庞大或需要高亮支持的情况就不适用了,这时可以在电脑上写完代码放入开发板的文件系统内。
可参考以下几种方法示例进行操作:
出于满足部分小伙伴对内存的需求,可通过源码编译所需固件。
MaixPy中的存储介质主要由Flash、SD卡组成,并分为三块区域分别是MaixPy.bin固件区、xxx.kmodel模型区、文件系统区:Flash上为spiffs(SPIFlashFileSystem)、SD卡为Fatfs(FATfilesystem)后续方便小伙伴们使用模型或烧写固件时参考,注意烧写时的不同区域防止报错或烧写失败。
在【更多功能应用】里的部分示例里需要用到SD卡存储模型或固件等,很多小伙伴会遇见SD卡文件读取不到,先判断路径是否正确,再判断是否挂载成功了。
K210系列板卡连接麦克风阵列有以下两种方式供参考:
注意:烧录过key_gen.bin之后的开发板将永久禁用K210的JTAG调试功能。
API手册只罗列几种分类出来,如有需要更详细的请点击前往各分类查看下一级目录,可搭配上文【更多功能应用】使用更佳!
对于想尝试开发K210的用户们我们也准备了相对应的文档供大家参考:
为什么会写学会使用文档呢,众所周知K210系列的板卡已经是2019年的产物了,各方面的文档也好例程也好早已经是成熟的了,该踩的坑基本都在前几年就被踩完了,现在更多的新手小白踩坑可能都是因为性能上的不足或者是自身使用环境的乱导致出问题。这篇文档的初衷是想要让大家在使用的过程中避坑,但我们还是要学会把文档资源利用起来。
Mind+从1.6.6版本开始支持基于K210主控的Maixduino开发板,可满足对于K210开发有兴趣的用户。
卸载干净之前下的软件安装包,重新下载并换磁盘安装。
一般出现这个问题,先从以下几个方面判断问题(因使用环境不同造就的设备握手失败)
显示黑斑但是有正常画面就是摄像头内片不干净,可以把摄像头拆出来擦一擦。
摄像头连接超时,重新连接下或者是换摄像头。
AMR是AutonomousMobileRobot的缩写,即自主移动机器人,是集环境感知,动态决策规划,行为控制与执行等多功能于一体的综合系统。
MaixCube是基于SipeedM1n模块(主控:KendryteK210)开发的一款集学习开发和商用一体的人脸识别产品。
Sipeedk210RISC-VAI+lOTESP32视觉听觉开发套装的开发环境搭建。
勘智K210采用RISC-V处理器架构,具备视听一体、自主IP核与可编程能力强三大特点,支持机器视觉与机器听觉多模态识别,可广泛应用于智能家居、智能园区、智能能耗和智能农业等场景。