diff --git a/doc/15.TencentOS_tiny_EVB_MX_Plus_Quick_Start.md b/doc/15.TencentOS_tiny_EVB_MX_Plus_Quick_Start.md index 41f3e559..ced8ba43 100644 --- a/doc/15.TencentOS_tiny_EVB_MX_Plus_Quick_Start.md +++ b/doc/15.TencentOS_tiny_EVB_MX_Plus_Quick_Start.md @@ -336,7 +336,13 @@ https://github.com/Tencent/TencentOS-tiny TencentOS tiny项目工程中包含了explorer的demo工程: 进入TencentOS-tiny\board\TencentOS_tiny_EVB_MX_plus\KEIL\qcloud_iot_explorer_sdk_data_template目录,双击TencentOS_tiny.uvprojx,用mdk打开。 - 2. 填写配置信息 +Demo工程中example分组下的配置文件说明: + +- `data_config.c`:设备属性功能相关参数配置 +- `action_config.c`:行为调用相关参数配置 +- `events_config.c`:事件调用相关参数配置 + +2. 填写配置信息 进入TencentOS-tiny\components\connectivity\qcloud-iot-explorer-sdk\port\TencentOS_tiny目录,修改HAL_Device_tencentos_tiny.c文件: ![](./image/EVB_MX_guide/explorer_param_set.png) @@ -347,7 +353,7 @@ https://github.com/Tencent/TencentOS-tiny * 设备密钥:将控制台的设备密钥,复制到上图sg_device_secret。 注:demo工程中已添加了一个用于调试的explorer设备信息,可以直接与explorer平台对接。 - 进入TencentOS-tiny\examples\qcloud_iot_explorer_sdk_data_template目录,修改qcloud_iot_hub_sdk_explorer.c: + 进入TencentOS-tiny\examples\qcloud_iot_explorer_sdk_data_template目录,修改entry.c: ![](./image/EVB_MX_guide/explorer_wifi_set.png) 这里esp8266_join_ap函数的入参,填写用户自己的wifi热点名字及密码。 @@ -408,4 +414,40 @@ https://github.com/Tencent/TencentOS-tiny } ``` -5. 查看通信日志,即可查看到设备成功接收到下行指令,并上报最新数据到开发平台的详细日志。 \ No newline at end of file +5. 查看通信日志,即可查看到设备成功接收到下行指令,并上报最新数据到开发平台的详细日志。 + +### 4.2.7 设备事件上报 + +1. 修改工程中的`config.h`文件,开启事件支持: + +![](./image/EVB_MX_guide/enable_event_post.png) + +2. 修改`data_template_sample.c`文件,开启事件上报示例: + +![](./image/EVB_MX_guide/enable_event_post_sample.png) + +3. 编译程序,下载到开发板中,复位开发板,程序开始运行。 + +4. 在平台端可以看到设备上报事件的日志: + +![](./image/EVB_MX_guide/event_post_result.png) + +### 4.2.8 设备行为调用 + +1. 在云端的数据模板中,选择自定义功能版块,手动新建一个设备行为功能: + +![](./image/EVB_MX_guide/create_action.png) + +2. 在`data_template_sample.c`文件中使能Action示例: + +![](./image/EVB_MX_guide/enable_action_sample.png) + +3. 编译程序,下载到开发板中,复位开发板,程序开始运行。 + +4. 在云端下发设备行为调用: + +![](./image/EVB_MX_guide/start_action.png) + +5. 在串口助手中可以看到设备行为被调用: + +![](./image/EVB_MX_guide/action_result.png) \ No newline at end of file diff --git a/doc/image/EVB_MX_guide/action_result.png b/doc/image/EVB_MX_guide/action_result.png new file mode 100644 index 00000000..40b34bcb Binary files /dev/null and b/doc/image/EVB_MX_guide/action_result.png differ diff --git a/doc/image/EVB_MX_guide/create_action.png b/doc/image/EVB_MX_guide/create_action.png new file mode 100644 index 00000000..2a2177f8 Binary files /dev/null and b/doc/image/EVB_MX_guide/create_action.png differ diff --git a/doc/image/EVB_MX_guide/enable_action_sample.png b/doc/image/EVB_MX_guide/enable_action_sample.png new file mode 100644 index 00000000..4598d936 Binary files /dev/null and b/doc/image/EVB_MX_guide/enable_action_sample.png differ diff --git a/doc/image/EVB_MX_guide/enable_event_post.png b/doc/image/EVB_MX_guide/enable_event_post.png new file mode 100644 index 00000000..974a61d5 Binary files /dev/null and b/doc/image/EVB_MX_guide/enable_event_post.png differ diff --git a/doc/image/EVB_MX_guide/enable_event_post_sample.png b/doc/image/EVB_MX_guide/enable_event_post_sample.png new file mode 100644 index 00000000..ff7a0824 Binary files /dev/null and b/doc/image/EVB_MX_guide/enable_event_post_sample.png differ diff --git a/doc/image/EVB_MX_guide/event_post_result.png b/doc/image/EVB_MX_guide/event_post_result.png new file mode 100644 index 00000000..a0867b6f Binary files /dev/null and b/doc/image/EVB_MX_guide/event_post_result.png differ diff --git a/doc/image/EVB_MX_guide/start_action.png b/doc/image/EVB_MX_guide/start_action.png new file mode 100644 index 00000000..346a42e3 Binary files /dev/null and b/doc/image/EVB_MX_guide/start_action.png differ