摘要

之前做了一个智能安防系统，用STM32单片机作为主控芯片，ESP8266-01s模块作为Wi-Fi模块，成功利用MQTT协议实现了连接阿里云物联网平台或中国移动OneNET平台，并支持实时上报环境温湿度、烟雾、有害气体浓度等信息和远程修改报警阈值、远程开关继电器、LED灯亮度调节、控制步进电机等功能。

后来为了完善功能，在物联网平台的官方文档里看到其开放了很多实用的API，其中有一部分是基于HTTP协议的POST和GET方式与服务器进行数据交换的，笔者突发奇想，利用这些API在iOS端“快捷指令”里执行HTTP请求，然后用Siri执行快捷指令，获取当前温湿度或设置报警阈值、下发命令控制设备等功能。

以下介绍如何实现这些功能，主要讲基于OneNET的快捷指令，至于如何连接阿里云和OneNET物联网平台，相关教程将在后续更新。

摘要

1 准备工作

2 如何向设备发送命令

3 一个控制风扇打开的快捷指令

3.1 创建快捷指令

3.2 修改快捷指令属性

3.3 添加操作

（1）首先添加"URL"块

（2）添加“获取URL内容”操作

3.4 功能测试

3.4.1 服务器返回数据处理

3.4.2 如何用Siri运行这个快捷指令

3.5 改进与调试

4 如何批量添加快捷指令

5 扩展功能

6 附录多协议接入API列表：

新增数据流

批量查询数据流信息

发送命令

1 准备工作

准备一套正常连接OneNET物联网平台“多协议接入”下创建的设备的系统，笔者采用的是基于STM32和ESP8266-01s模块的系统（笔者将在后续文章给出此系统教程）；

OneNET物联网平台设备数据流界面

需要提前记下设备ID、数据流名称、API-Key和API。数据流可以用之前添加的，比如“Cur_Temp”表示当前温度值，“LED_Light”表示LED亮度等，也可以后面通过HTTP请求进行添加、删除数据流等；
准备一台能运行iOS快捷指令的iPhone、iPad（如果有Appel Watch，那么你在手机平板编辑好的快捷指令也可以在Watch上使用）；
对HTTP请求概念有一些基本的了解，知道JSON格式数据的含义以及如何提取键值等（有需要的话笔者后续会更文）；

2 如何向设备发送命令

通过此以下API向设备发送命令，可以修改设备相关数据，比如开/关继电器、调节RGB灯颜色、修改报警阈值、修改期望温度值等：

请求方式：POST URL:http://api.heclouds.com/cmds
URL参数：device_id、qos、timeout
HTTP头部：api-key
请求体：用户自定义内容，json、字符串，数字、也可以是二进制数据（64KB以内）

其中，device_id为接受该命令的设备ID；qos等级可以为0或1，为0代表向设备发送命令后不需要设备应答；1表示向设备发送命令后需要等待设备回应，如果没有应答则会重发该命令；timeout为命令有效时间，在有效时间内命令才会重发，否则命令失效；api-key可以是平台给的MasterKry，也可以是自己添加具有该设备访问权限的api-key；请求体可以是json格式数据，如：

{"SWITCH":1,"RGB":000000}

或者是一个字符串，如：

I am a Robot.

也可以是二进制数据，比如一张图片、一段录音等，但每条消息大小不能超过64KB；也可以是任意格式的命令，只要单片机端方便编程识别和处理。

3 一个控制风扇打开的快捷指令

3.1 创建快捷指令

打开iPhone或者iPad上的“快捷指令”app，点击右上角“+”新建一个快捷指令（要求iOS版本为iOS 12.4.1及以上，或者iPadOS 12.4.1及以上）；

创建快捷指令

3.2 修改快捷指令属性

在新快捷指令里，可以点击右上方“...”来设置快捷指令名称，我们设置为“打开卧室小风扇”，然后修改图标和颜色和图形为自己喜欢的样式。

修改快捷指令属性

如果你后续有上传二进制文件的需求，可以打开“在共享表单中显示”选项，并在后面步骤里添加获取二进制文件的脚本；如果你有Apple Watch并希望这个快捷指令能在上面运行，则可以打开“在Apple Watch上显示”；

3.3 添加操作

以“打开卧室小风扇”为例，步骤如下：

（1）首先添加"URL"块

输入格式如下：

http://api.heclouds.com/cmds?device_id=********&timeout=100&qos=1

其中，device_id、timeout、qos等URL参数在上面介绍过，这里不再赘述。

添加“URL”块

（2）添加“获取URL内容”操作

将“URL”变量设置为上面添加的URL（默认自动添加），其他参数如下：

方法：设置为“POST”；
头部：点击添加新头部，在“键”框内输入“api-key”（不带引号），在“文本”框内输入你的api-key；
请求体：请求体可以设置为JSON、表单和文件，你可以按照自己的STM32安防项目内解析命令的程序来选择相应的类型，笔者此处示范“JSON”类型的填法：添加新字段，因为本例程是控制风扇开关，只需要true和false表示开关，所以选择“布尔值”，在键“框内输入“Fan”，键值默认为“false”，本处我们要打开风扇，所以点击修改为“true”。

添加“获取URL内容”操作

也可以按照你的设备端程序来添加相应的字段；比如选择“数字”，那么同样的，在“键”框内输入“Fan”（不包括引号），然后在显示“数字”提示的键值框内输入“1”代表开（取决于你设备端程序）；

3.4 功能测试

3.4.1 服务器返回数据处理

设置完以上步骤之后就可以控制风扇打开了。你也可以在后面添加脚本解析服务器返回的JSON数据，以下为服务器返回数据示例：

 {"errno":0,"data":{"cmd_uuid":"cc70d6b0-3644-57c9-9aa6-72b2cffd10b3"},"error":"succ"}

其中，“errno”表示错误代码，此处返回0，表示没有错误；“error”表示错误原因，此处返回“succ”表示成功。

URL返回数据处理

通过解析JSON数据，可以判断返回的错误类型、错误原因，加入“如果”操作即可以根据不同的返回内容显示快捷指令运行结果；笔者使用“获取词典值”操作进行JSON解析，输入选择“URL的内容”，“词典”设为“errno”，然后再用“如果”判断语句判断“errno”是否为0，如果为0则执行“显示结果”操作，我设置为结果为“卧室小风扇已打开”。

3.4.2 如何用Siri运行这个快捷指令

很简单，你只需要对设备说：“Hey Siri，打开卧室小风扇”，Siri就会自动执行快捷指令，不出意外的话，Siri会说：“好的，卧室小风扇已打开”（图中所示为笔者打开台灯的截图）。

3.5 改进与调试

由于单片机执行程序可能不及时，有时候下发的命令不一定会被单片机执行，这时候我们只需要添加“重复”操作，重复多次“获取URL的内容”操作即可，也可以添加“等待”操作，设置等待时间，实现类似单片机“delay”的效果。

重复执行命令

4 如何批量添加快捷指令

保存上面创建的打开风扇的快捷指令，然后在快捷指令列表里，长按“打开卧室小风扇”，选择“复制”，列表出现“打开卧室小风扇1”，我们点“…”符号编辑，再把请求体键值中“true”改为“false”，最后修改快捷指令名称为“关闭卧室小风扇”，就可以实现关闭功能了。

批量新建快捷指令

当然也可以直接在第三章创建的快捷指令里添加“选择”操作，通过语音、手动或特定输入条件，选择开或关、反转状态、定时开、延时开等各种操作，实现各种个性化的需求，有兴趣的可以打开快捷指令研究，笔者此处不再赘述。

5 扩展功能

有人说，ESP8266-本身就是基于一块非常强大的32位芯片开发的，为什么还要引入STM32？我认为，ESP8266和STM32相比各有优劣，外设种类和数量、稳定性、价格、开发难度等都有区别。只使用STM32W系列支持无线的芯片开发的物联网系统，或者只使用ESP-01s就能完成的物联网系统，都有其特定的使用环境，而将不支持无线功能的STM32F系列和ESP-01S运用在一个设备上，取长补短，不存在冲突一说。

除了上述打开、关闭电器以外，多协议接入还支持多种API，如下所示（点击下划线文字即可跳转到文档界面）。

6 附录多协议接入API列表：

新增设备注册设备更新设备查询设备详情批量查询设备详情批量查询设备状态删除设备

新增数据流更新数据流查询数据流批量查询数据流删除数据流查询设备历史数据批量查询设备数据上传数据点

上传文件获取文件发送命令查询命令状态查询命令响应查询设备历史命令

新增触发器更新触发器查询触发器删除触发器

新增apikey 更新apikey 查询apikey 删除apikey

以下贴出常用的三种请求方式，详细文档可参考OneNET多协议接入开发手册。

新增数据流

请求方式：POST URL: http://api.heclouds.com/devices/device_id/datastreamsdevice_id：需要替换为设备ID

请求头部示例

POST http://api.heclouds.com/devices/20474930/datastreams HTTP/1.1

请求body示例

{ "id": "speed", "tags": ["mobile"], "unit": "m/s", "unit_symbol": "m/s" }

返回示例

{ "errno": 0, "data": { "ds_uuid": "856f8622-64e7-5549-8e55-44931f07db6e" }, "error": "succ" }

批量查询数据流信息

请求方式：GET URL: http://api.heclouds.com/devices/device_id/datastreamsdevice_id：需要替换为设备ID

请求示例

GET http://api.heclouds.com/devices/20474930/datastreams?datastream_ids=aaa,bbb HTTP/1.1

返回示例

{ "errno": 0, "data": [{ "update_at": "2017-11-20 10:03:10", "id": "aaa", "create_time": "2017-11-20 09:59:35", "current_value": { "Header": { "CipherType": 1, "DevType": 1 }, "Body": 3 } }, { "update_at": "2017-12-22 10:30:22", "id": "bbb", "create_time": "2017-12-22 10:12:36", "current_value": 1 }], "error": "succ" }

发送命令

请求方式：POST URL:http://api.heclouds.com/cmds

请求示例

POST http://api.heclouds.com/cmds?device_id=8029377 HTTP/1.1
api-key: l2aH*************BRtAo=
Host: api.heclouds.com
Content-Length: 19 <this is a command>

返回示例1：成功创建命令

{ "errno": 0, "error": "succ", "data": { "cmd_uuid": "81572aae-fc34-5deb-8f06-ab45d73cb12b" } }

返回示例2：设备不在线

{ "errno": 10, "error": "device not online: 8029377" }

------END------

基于iOS快捷指令和Siri控制连接OneNET物联网平台的STM32的智能安防家居系统相关推荐

米思奇（Mixly）连接OneNet物联网平台（一）
米思奇(Mixly)连接OneNet物联网平台初体验(一) 中国移动物联网开放平台是中移物联网有限公司基于物联网技术和产业特点打造的开放平台和生态环境,适配各种网络环境和协议类型,支持各类传感器和智能 ...
基于opencv的家居智能安防机器视觉系统
基于opencv的家居智能安防机器视觉系统(关键词:Windows.树莓派.python.opencv) 1.写在前面的话大学4年很快过去了,因为疫情原因我们从大四上学期结束之后直接跳到了大学的尾声 ...
【高效日程管理】基于iOS快捷指令自动化，这是一个记录长期目标、统计专注时长、记录健康数据（需要智能手环、手表）、并生成每日报告与自我总结的高效日程管理方式
核心功能: 1.记录专注时长:分为学霸模式和普通模式,又有正计时和倒计时两种方式.学霸模式下禁止离开计时页面,否则算您结束任务或放弃任务.普通模式下可以离开计时页面,但结束后要进行签到.并且在您进行体 ...
计算机专业智能安防,基于计算机视觉的智能安防监控系统研究
摘要: 随着时代的发展,人们对生活环境的安全性和智能性提出了更高的要求,而安防监控系统在其中扮演着重要的角色.现阶段安防监控系统主要包括两种:红外报警系统和视频监控系统.红外报警系统易受复杂环境的干扰 ...
mqtt 域名连接_中国移动OneNet物联网平台，如何使用MQTT协议，进行连接
大家好,超子又和大家见面了,超子我能力有限,技术不高,有什么错误的地方,欢迎板砖.今天我们一起构建MQTT协议中的CONNECT报文,连接OneNet物联网平台,然后进行通信.前面的文章中,超子介绍阿 ...
ios快捷指令使用指南-TUST校园网认证自动连接登录
ios快捷指令使用指南-TUST校园网认证自动连接登录 2021.9.1更新: 校园网登录页面更新后,部分规则变动,更新后快捷指令链接如下: https://www.icloud.com/shortc ...
iOS快捷指令：执行Python脚本（利用iSH Shell）
文章目录前言核心逻辑配置iSH 安装Python 创建Python脚本配置启动文件测试效果快捷指令前言 iOS快捷指令所能做的操作极为有限.假如快捷指令能运行Python程序,那么可操作 ...
ios快捷指令：一键登录/登出南京大学校园网
软件版本要求:ios13及以上演示机型:iPhone 12 mini 演示系统版本:ios14.6 文章目录导言核心步骤:最简单的一键登录指令自动化:连接NJU-WLAN后自动登录修改细节: ...
IOS快捷指令登录校园网
IOS快捷指令一键登录校园--以青岛理工大学校园网为例网络请求方式一般分POST命令和GET命令两种,本文主要分享GET命令的方法登录校园网. 先上指令的链接: https://www.icloud ...

基于iOS快捷指令和Siri控制连接OneNET物联网平台的STM32的智能安防家居系统

摘要

1 准备工作

2 如何向设备发送命令

3 一个控制风扇打开的快捷指令

3.1 创建快捷指令

3.2 修改快捷指令属性

3.3 添加操作

（1）首先添加"URL"块

（2）添加“获取URL内容”操作

3.4 功能测试

3.4.1 服务器返回数据处理

3.4.2 如何用Siri运行这个快捷指令

3.5 改进与调试

4 如何批量添加快捷指令

5 扩展功能

6 附录多协议接入API列表：

新增数据流

批量查询数据流信息

发送命令

基于iOS快捷指令和Siri控制连接OneNET物联网平台的STM32的智能安防家居系统相关推荐

最新文章

热门文章

基于iOS快捷指令和Siri控制连接OneNET物联网平台的STM32的智能安防家居系统

摘要

1 准备工作

2 如何向设备发送命令

3 一个控制风扇打开的快捷指令

3.1 创建快捷指令

3.2 修改快捷指令属性

3.3 添加操作

（1）首先添加"URL"块

（2）添加“获取URL内容”操作

3.4 功能测试

3.4.1 服务器返回数据处理

3.4.2 如何用Siri运行这个快捷指令

3.5 改进与调试

4 如何批量添加快捷指令

5 扩展功能

6 附录 多协议接入API列表：

新增数据流

批量查询数据流信息

发送命令

基于iOS快捷指令和Siri控制连接OneNET物联网平台的STM32的智能安防家居系统相关推荐

最新文章

热门文章

6 附录多协议接入API列表：