基于 Linux和STM32F411RE通过与WiFi模块进行AT指令串口通信，实现与阿里云&sds 直连的IoT联网开发应用

# How to use iot-sdk ## 1. 简介 本 sdk 提供一个基于 Linux和STM32F411RE，通过与 Wi-Fi 模块进行 AT 指令串口通信，实现与阿里云 ILOP 和 sds 以及中国移动杭研平台 直连的 IoT 物联网典型开发应用示例源代码,master分支是基于linux平台，NUCLEOF411RE分支是基于IAR和GCC平台。 ## 2. 目录结构 ```c |---example | |---ilopicaapp /*ilop平台 ica标准数据格式的demo*/ | |---iloprawapp /*ilop平台 自定义数据格式的demo*/ | |---sdsapp /*sds平台的demo*/ | |---qlinkapp /*杭研平台的demo*/ | |---test /*测试demo*/ | |---platform | |---linux /*linux平台相关的接口实现*/ | |---mx_hal.h | |---src |---alicloud_ilop /*ilop平台的实现*/ |---alicloud_sds /*sds平台的实现*/ |---helper /*at指令解析内核*/ ``` ## 3. Linux 平台开发 ### 3.1 准备 - 串口接入PC，并查询设备，命令：`ls -l /dev/ttyUSB*` ``` parallels@parallels-vm:~/iot-sdk$ ls -l /dev/ttyUSB* crw-rw---- 1 root dialout 188, 0 Sep 3 16:15 /dev/ttyUSB0 ``` ### 3.2 编译 iot-sdk 提供四个demo，编译demo的命令格式 `make <demo>` - 清除上次的make命令所产生的build文件，命令：`make clean` ``` parallels@parallels-vm:~/iot-sdk$ make clean cleaning... done ``` - 编译测试demo，命令：`make test` ``` parallels@parallels-vm:~/iot-sdk$ make test mkdir build compiling platform/linux/mx_serial.c compiling platform/linux/mx_stdio.c compiling platform/linux/mx_tick.c compiling platform/linux/mx_uart.c compiling src/helper/cli/mx_cli.c compiling src/helper/emhost/ATCmdParser/ATCmdParser.c compiling src/helper/emhost/emh_alisds.c compiling src/helper/emhost/emh_arg.c compiling src/helper/emhost/emh_ilop.c compiling src/helper/emhost/emh_module.c compiling src/helper/emhost/emh_wlan.c compiling src/helper/mx_utils/mx_ringbuffer.c compiling examples/test/test.c generating build/iot-test.elf text data bss dec hex filename 16294 928 3680 20902 51a6 build/iot-test.elf ``` - 编译完成后，在build目录下生成 `iot-test.elf` 文件 ### 3.3 运行 - 运行build目录下的elf文件，命令：`./build/iot-test.elf <dev>` ``` parallels@parallels-vm:~/iot-sdk$ sudo ./build/iot-test.elf /dev/ttyUSB0 [sudo] password for parallels: dev[/dev/ttyUSB0] open at uart succeed [APP: test.c: 19] FW version: ilop_AT_v2.1.4 [APP: test.c: 20] System tick: 757 ``` ## 4. IoT示例 ### 4.1 阿里 ilop 平台的标准数据格式demo ### 4.2 阿里 ilop 平台的透传demo ### 4.3 杭研 qlink 平台的demo #### 4.3.1 使用流程 (1) 获取客户在杭研申请账号密码 (2) 商务洽谈后，提交资料，完成后台产品创建，后台地址：[https://open.home.komect.com/partner/](https://open.home.komect.com/partner/) (3) 搭建虚拟网关开发环境（详见examples/qlink中materials文件夹） (4) 进行本地能网关环境下验证(使用虚拟网关开发调试) (5) 杭研现场验收 (6) 项目入库 (7) 厂家提交配网相关资料，杭研配置成XML文件集成到H5开发的和家亲APP(此步奏或许可以提前，需要厂商和杭研沟通) (8) 使用materials/下的和家亲APP测试(开发环境获取到的mqtt服务器地址以.199结尾,测试环境以.207结尾，生产环境以205结尾) (9) 杭研云网关验证 #### 4.3.2 使用方法 (1) 庆科wifi模块烧录杭研qlink最新[AT固件](http://developer.mxchip.com/downloads/22/) 固件烧录具体方法可以参考resource/common/烧录路径下相关文档。 (2) 修改产品信息 新建产品后，可以获得product_token,andlink_token,product_id,豪恩报警盒子产品信息如下： >>>> ``` 初始化产品参数 const emh_qlink_config_t config = { .product_info = { .product_id = "30531", .product_token = "PXmsE6kQmxEgc0e3", .andlink_token = "ZxMo0zJvvZMWP3Az", .format = EMH_ARG_QLINK_FORMAT_JSON, }, .version_info = { .firmware_version = "1.4.3", .software_version = "1.0.1", } }; ``` (3) 编译运行demo * make clean ``` wumingju@ubuntu:/mnt/hgfs/Work/project/AT_demo/at_host_qlink$ make clean cleaning... done ``` * make qlinkapp ``` mkdir build compiling platform/linux/mx_serial.c compiling platform/linux/mx_stdio.c compiling platform/linux/mx_tick.c compiling platform/linux/mx_uart.c compiling src/helper/cli/mx_cli.c compiling src/helper/emhost/ATCmdParser/ATCmdParser.c compiling src/helper/emhost/emh_alisds.c compiling src/helper/emhost/emh_arg.c compiling src/helper/emhost/emh_ilop.c compiling src/helper/emhost/emh_qlink.c generating build/iot-qlinkapp.elf text data bss dec hex filename 22826 1168 3696 27690 6c2a build/iot-qlinkapp.elf ``` * 运行 sudo ./build/iot-qlinkapp.elf ``` dev[/dev/ttyUSB0] [APP: main.c: 150] open cli function open at uart succeed [QLINK: cloud_qlink.c: 119] FW version: basic_AT_v2.1.2 [APP: main.c: 30] WiFi config in AP mode...... [APP: main.c: 30] WiFi config in AP mode...... [APP: main.c: 34] Wi-Fi connected [APP: main.c: 42] Cloud connected ``` (4) 基于虚拟网关使用说明 * 按照4.3.1使用流程中说明搭建好本地虚拟网关开发环境 * 测试本地环境是否OK 如果本地环境OK，点击配网andlinkdemo1.0.apk 开始连接按钮，会有如下页面： <img src="./resource/qlink/image/环境OK.png" width="500" hegiht="313" align=center /> * 配网操作 通过cli串口发送 raw start命令 或者 按键触发调用qlink_raw_start()接口使设备进入本地网关一键配网模式， 同时手机APP点击开始连接按钮，绑定成功后APP提示添加成功，后台虚拟网关下面会显示出设备，如下： >>>> * 数据下发 通过后台获取所有字段，操作如下所示： >>>> 通过后台获取部分字段，操作如下所示： >>>> 通过后台下发命令，操作如下所示： >>>> 设备收到云端获取字段指令后，需要调用mx_status emh_qlink_send_json_to_cloud( char *type, uint8_t *data, uint32_t len ) 函数将数据发送到云端 * 数据上传 mx_status qlink_send_data(char *type, uint8_t *data, uint32_t len)，通过此函数 即可完成发送数据的功能 ``` type: 为发送数据的类型，注意主动上报和响应要选择不同类型 设备主动上报： type = Inform 人为触发的数据上报： type = ParamChange 云端请求上报： type = Data 文件操作： type = File data:上传具体内容 ``` 也可通过cli串口输入send type <data> 发送数据 (5) 基于云网关使用说明 * 提交XML配网资料 完成本地网关验证后，可以提交配网引导界面相关资料，杭研配置XML到手机APP，之后方可进行云网关验证操作， 提交配网资料可以提交本地网关+云网关方式资料或者仅通过云网关配网资料，建议提供只用云网关配网资料， 如此一来，上线验证只需要验证云网关部分即可，减少验证流程，提高上线时间 * 配网操作 通过cli串口发送 user start命令 或者 按键触发调用qlink_user_start()接口使设备进入云网关用户配网模式， 同时手机APP(resource/qlink/2.云网关/app路径)进入添加设备页面，扫描到如下页面，说明设备进�