一库打通所有云平台--IOT_CLOUD系列文档之TLINK物联网云平台

系列链接

​ 一库打通所有云平台--IOT_CLOUD系列文档

IOT_CLOUD介绍

​ 众所周知，市面上有很多云平台，阿里云、腾讯云、中移onenet、华为云、百度云、华为云、Tlink云等等......并且每家都有自己的协议，工程师要移植不同的sdk代码或基于各家的手册文档对接不同的协议，看着都头大！！！

​ 所以iotcloud应运而生！iotcloud是合宙专门为了合并iot平台而制作的库，意在使用统一且极简的代码接入各个云平台，轻松实现云功能。用户无需为那么多云平台的接入而头疼，只需要极简的通用API即可轻松上云！并且因为通用，所以云平台之间的迁移也十分方便。

​ 注意:本文档以AIR780E+Luatos作为示例，此库为网络通用库不限制型号，所有LUATOS支持的蜂窝模组都可使用

实现介绍：

​ iotcloud库本质就是上层设计一套通用的API，库来进行每个平台功能的对接。目前已经实现了各个平台的所有注册方式，其中自动注册会将相关验证信息保存kv，随后使用此验证信息进行连接，通知针对每个平台添加了特有系统实现，比如设备上线通知，设备版本号上传，ota功能等，用户无需管理这些只需要注意相关下发消息做应用逻辑即可

TLINK物联网介绍

​ Tlink物联网平台由模拟科技团队研发并运营，目前接入的传感器种类基本涵盖工业应用的所有场景，也适配市面上各大品牌的网关设备，接入各大工控品牌的终端设备(如PLC、HMI、变频器、仪器仪表等)。 ​ Tlink平台是围绕设备的“链接”展开多种相关服务的工具类平台，基于Tlink平台打通云平台、边缘计算网关、传感终端，使云、边、端可以灵活的搭建符合各种应用场景的数字化系统，轻松实现工业数字化. ​ Tlink 是一款链接工具的延伸，它实现了百万级节点实时连接，集成了 TCP、HITP、MB RTU、MB TCP、MOTT、UDP、TP500、NB-OT、COAP等物联网协议. ​ Tlink只作为一款链接平台存在，并通过长期的深入研究之后，变成一个具有高度的安全性和稳定性的物联网链接平台。让使用者在享受平台服务的同时，能够更加放心.

​ 官网地址：Tlink物联网-工业物联网平台

​ 官方文档地址：tlink-开发者中心-教程

前期准备

云平台准备

​ 需要登录官网Tlink物联网-工业物联网平台注册账号

​ 注意：牢牢记住账号和密码，后面会用到

​ 随后进入控制台

点击设备管理

点击新建设备组，我们这里输入测试

后续我们都在此测试新设备组下进行展示

硬件准备

• air780e开发板一块
• USB数据线
• 电脑

实战教学

​ 鉴于iotcloud的库是通用的，这里我们只说一下不同的注册即可，其他都是一样使用的，可以参考IOT_CLOUD系列文档之腾讯物联网云平台

设备注册

设备注册API

​ 注册的API只有一个但是支持了所有的注册方式，使用也很简单

iotcloud.new(cloud,iot_config,connect_config)

创建云平台对象

参数

返回值

设备注册分类

​ Tlink支持秘钥验证和证书验证两种方式

1. 秘钥验证

​ 我们点击添加设备

测试分组选择准备阶段新建的测试分组，设备名推荐使用imei，链接协议使用MQTT，剩下的按需添加

​ 创建成功后我们可以看到设备信息

记住序列号

接下来我们再来看下代码具体怎么用

produt_id为你的平台账号，product_secret为你的平台账号密码，device_name为序列号

    -- Tlink云
    -- iotcloudc = iotcloud.new(iotcloud.TLINK,{produt_id = "xxx",product_secret = "xxx",device_name = "xxx"})

​ 第一个参数表示我们使用的是Tlink，第二个参数我们将上面得到数据写入即可！

1. 证书验证

​ 注意：不推荐使用此方式，因为证书存在过期，需要定期升级维护

​ 创建方式和上方密钥方式一样，只不过认证方式需要在平台下载证书进行校验

​ 证书下载链接

1. 接下来我们再来看下代码具体怎么用

    -- Tlink云  
    -- iotcloudc = iotcloud.new(iotcloud.TLINK,{produt_id = "xxx",product_secret = "xxx",device_name = "xxx"},{tls={client_cert=io.readFile("/luadb/client_cert.crt")}})

​ 第一个参数表示我们使用的是Tlink云，第二个和第三个参数我们将上面得到数据写入即可！

效果演示

代码演示

​ 好了，接下来我们看下完整代码和效果，这里以动态注册为例，demo地址：demo/iotcloud/main.lua · 合宙Luat/LuatOS - 码云 - 开源中国 (gitee.com)

-- LuaTools需要PROJECT和VERSION这两个信息
PROJECT = "iotclouddemo"
VERSION = "1.0.0"

-- sys库是标配
_G.sys = require("sys")
--[[特别注意, 使用mqtt库需要下列语句]]
_G.sysplus = require("sysplus")

local iotcloud = require("iotcloud")

sys.taskInit(function()
    -- 等待联网
    sys.waitUntil("IP_READY")

    --------    以下接入方式根据自己需要修改,相关参数修改为自己的    ---------

-- Tlink云  
    iotcloudc = iotcloud.new(iotcloud.TLINK,{produt_id = "xxx",product_secret = "xxx",device_name = "xxx"})
    -- iotcloudc = iotcloud.new(iotcloud.TLINK,{produt_id = "xxx",product_secret = "xxx",device_name = "xxx"},{tls={client_cert=io.readFile("/luadb/client_cert.crt")}})


    if iotcloudc then
        iotcloudc:connect()
    end

end)

sys.subscribe("iotcloud", function(cloudc,event,data,payload)
    if event == iotcloud.CONNECT then -- 云平台联上了
            print("iotcloud","CONNECT", "云平台连接成功")
            -- iotcloud:subscribe("test") -- 定阅主题
    elseif event == iotcloud.RECEIVE then
            print("iotcloud","topic", data, "payload", payload)
            -- 用户处理代码
    elseif event ==  iotcloud.OTA then
        if data then
            rtos.reboot()
        end
    elseif event == iotcloud.DISCONNECT then -- 云平台断开了
            -- 用户处理代码
    end
end)

-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后后面不要加任何语句!!!!!

设备日志：

​ 可以看到我们的设备打印了连接成功，证明注册+连接流程已经完成

​ 至此，云平台已经连接成功，剩下的就是要根据自己的产品需求，自己的物模型上报/下发数据就可以了