【AWTK开源智能串口屏方案】MCU SDK使用与编译运行-电子发烧友网

本篇文章将介绍AWTK-HMI中的MCU端开发方法，包括MCU SDK常用API的说明、使用流程及如何编译到Linux和STM32平台。引言：AWTK-HMI是基于AWTK与AWTK-MVVM开发的低代码智能串口屏方案，本系列文章介绍如何从零开发HMI程序，包括搭建开发环境、创建HMI运行时工程、修改应用界面以及开发MCU程序。

MCU端简介

相对于HMI端（串口屏端），MCU端工程是用户自己的主控程序，通过调用MCU SDK的API，可以与HMI端通过串口或网口通信。MCU端程序本身也是支持跨平台，且不受硬件与系统限制的。

图1AWTK-HMI工作原理

从官方的Gitee下载awtk-hmi仓库到本地目录，可以在mcu/sdk/hmi目录中浏览MCU SDK的API。如果是低资源平台则可以浏览mcu/mini-sdk/hmi目录的代码文件。

MCU开发基本流程

在使用API前需要把MCU SDK加入到目标平台编译成库或者直接放到项目中进行编译，才可以在业务逻辑中调用这些API，关于如何编译文章后面章节会进行详细介绍。

MCU SDK常用API

首先讲述一下MCU SDK实际开发中常用的API，通过这些API，MCU端可以主动获取、设置串口屏的变量值，或接收串口屏的事件，实现双向交互。

1、hmi_create或hmi_create_with_serial，这一步是创建一个hmi_t对象用于跟串口屏端进行通信。若需要使用网口通信可以先调用tk_stream_factory_create_iostream并根据函数说明传进去正确的url参数，接着再将返回的tk_iostream_t对象作为hmi_create函数的参数；

2、hmi_set_prop，通过MCU端设置串口屏某个绑定变量值，如：设置空调开关或温度值；

3、hmi_get_prop，通过MCU端获取串口屏某个绑定变量值；

4、hmi_dispatch，用于获取了串口屏事件后分发到MCU端程序中，如：监听到串口屏发生了EVT_PROP_CHANGED事件，MCU端程序接收到该事件后输出对应的日志信息；

5、hmi_destroy用于MCU端与串口屏端断开连接时销毁hmi_t对象。

MCU SDK开发示例

下图是一段在STM32平台上简单的示例代码，主要逻辑是在程序主循环中检测按键并设置串口屏变量值，并且不断检测串口屏的事件，分发到MCU端程序中：

图2MCU SDK使用示例除了上面所展示的API和例子，更多API说明和示例可以参考《MCU SDK》，完整示例工程可以浏览mcu/stm32目录中的几个STM32工程。

在嵌入式Linux平台使用MCU SDK

接下来介绍如何将MCU SDK编译到嵌入式Linux平台。编译环境需要准备交叉编译工具链、MCU SDK代码文件最新版awtk与awtk-linux-fb，awtk与awtk-linux-fb放在awtk-hmi目录中，详细的操作步骤如下：1. 参考《【从0开始创建AWTK应用程序】编译应用到嵌入式Linux平台》文章在awtk-linux-fb内配置交叉编译工具并编译awtk；2. 进入到awtk-hmi/mcu/sdk/hmi目录中，使用交叉编译工具编译得到hmi.o目标文件，下面为示例命令（宏定义可自己添加）：

arm-zlgmcu-linux-uclibcgnueabi-gcc -c hmi.c -I../../../awtk/src -DLINUX

3. 将hmi.o目标文件打包成库文件

arm-zlgmcu-linux-uclibcgnueabi-ar rcs libhmi.a ./hmi.o

4. 编译test示例程序命令如下：

arm-zlgmcu-linux-uclibcgnueabi-gcc test.c -o test -I./ -I../../../awtk/src -L./ -L../../../awtk-linux-fb/bin -lawtk -lhmi

最终可以得到test示例程序，将该程序以及awtk-linux-fb/bin目录下的libawtk.so库文件拷贝到板子上运行即可