QuecPythonHeliosSDK 使用介绍

引言:

移远无线通信模组让万物互联成为现实, QuecPython 开启全新的模组开发方式, 用最简单易用的编程语言开发最前沿的无线通信产品.

自 QuecPython 面世以来, 以解析型; 可嵌入; 面向对象; 可交互; 简单易学这些优于传统的开发方式的优点而深受广大开发者好评.

QuecPython 开发相比较传统开发的简单易上手相信广大开发者已经深有体会, 但也有一点不尽如人意的地方. 说到这相信很多开发者要开始吐槽了, 槽点肯定是有的, 其中不能使用C 语言封装函数功能应该是槽点最多的了.

有困难我们克服困难, 没困难我们制作困难之后在克服困难. 开个玩笑. 但有槽点, 我们就 克服它. 今天“她”来了, 带着万众期待的目光“她”终于来了.

HeliosSDK 简介

HeliosSDK(Helios: 古希腊太阳神)以组件化方式组织, 分别包括系统级组件、服务级组件、外设组件及第三方组件.

⚫ 系统级组件主要包括 os/bsp/文件系统/各类网络协议栈/OTA/日志输出等功能.

⚫ 服务级组件目前包括 QuecPython 功能.

⚫ 外设组件目前包括 camera/NorFlash/LCD 等功能.

⚫ 第三方组件目前包括 lvgl/tts 等功能.

各组件之间的依赖关系, 通过在组件内编译管理的脚本中指定依赖路径即可, 下文详述.同时各组件功能是否开启, 可通过 menuconfig 进行配置, 方便功能裁剪.

环境搭建

目前 HeliosSDK 支持 Windows 与 Linux 两种开发环境. 此文档仅介绍 Windows 环境

下载工具链安装包

链接地址: helios-toolchain.exe

安装工具链

以管理员身份运行 helios-toolchain.exe, 如下图, 点击安装即可 .

注 : 目标文件夹 不能 包含空格

HeliosSDK 获取

官网介绍中, 开发者需自行使用 Git 拉取 HeliosSDK 源码. 但由于部分开发者对 Git 操作不熟悉, 相关介绍放于本文过于冗长; 且官网 SDK 过长时间为更新缘故. 有需要的开发者朋友请联系 QuecPython_FAE 获取.

附: Git 拉取代码如下:

其他说明

有关 HeliosSDK 目录结构等本文不做过多介绍, 有兴趣可自行查阅 HeliosSDK\docs\文件夹内容进行了解.

HeliosSDK 使用

HeliosSDK 包获取后, 我们就可以编译固件了, 首先我们介绍一下 HeliosSDK 工具链的编命令.

使用方法: 可直接于 HeliosSDK 根目录的地址栏输入 CMD 敲回车快速进行 CMD 命令工具.

此方案可直接切换至编译目录, 无需 cd 切换

C 代码运行固件编译

由于 HeliosSDK 是建立在 QuecOPEN 为基础上, 固 HeliosSDK 也可编译单独使用 C 代码的运行的固件. 由于不是本文介绍的重点, 这边简单提及下编译命令.

HeliosSDK 开发包根目录下存在一个 sample 命名的文件夹, 该文件夹就为官方编写的单独运行的 C 代码. 有兴趣的开发者可执行阅读. 这边简单介绍一下编译命令. 方便大家快速编译固件并观察运行效果

Python 固件编译

来到本文的重点内容, 编译 Python 的固件包. 这边我们以下章节进行介绍:

编译命令

编译命令介绍我们前面已经介绍过了, 下面我们以 EC600NCNLD 为例书写一个实际的编译命令.

Menuconfig 说明

上面我们说道 GUI 配置工具, 也就是本周说说的 menuconfig. 我们 CMD 执行 helios menuconfig

EC600NCN_LD 便可打开EC600NCNLD 的 GUI 配置界面.

使用该工具我们便可实现固件功能的裁减与添加.

注: 添加功能所占总空间不可超

过模块空间.

操作说明

⚫ 上下键: 用来选中不同的菜单.

⚫ 左右键: 用来选中不同的操作按键.

⚫ 回车键: 用来进入下级菜单, 或触发执行操作按键的功能.

⚫ 空格键: 用来打开或关闭选中的菜单功能.

⚫ Esc: 双击该键用来返回上级菜单, 在菜单根目录下执行该操作将会退出 menuconfig.

保存配置

在配置菜单界面, 通过左右键选中界面下方的<Save>按下回车键, 弹出下图所示的界面选中<OK>后, 即可保存配置.

C 代码封装 Python_API

本章节本计划详细介绍的, 但查看 HeliosSDK 帮助文档后发现文档已经进行了非常细致的介绍. 照搬照抄未免过于浮夸. 各位自行查看 .\HeliosSDK\docs\html\Helios_SDK 指南(3)__高级\HeliosSDK 高级.pdf 即 可. 

使用方法:

解压 core.zip 压缩文件后将解压文件复制至 .\HeliosSDK\services\microPython\ports\quectel\core 进行替换.

编译生产固件运行可看到固件中多出如下图函数:

后期需要添加自己的 API 函数按照附件格式进行添加即可.

总结：

以上就是 HeliosSDK 基础的使用介绍. 其中很多细节性的东西由于篇幅原因, 本文未能一一 介绍到. 但通过本文入门 HeliosSDK 肯定是已经足够了. 在 HeliosSDK 内部 .\HeliosSDK\docs 文件夹下也有相关细节性的介绍, 但官方的起点太高. 这也是输出本文的原因. 新入手的开发者通过本文入门后便可结合 SDK 中介绍继续深入了. 有兴趣的小伙伴可自行研究.

附: HeliosSDK 链接： https://gitee.com/quecpython/HeliosSDK.git

附言：

后期小Q也会陆续分享其他 QuecPython 学习心得，欢迎各位看官沟通交流。