Cat.X 设备开发包

更新时间:2024-06-25 05:49:31下载pdf

Cat.X 设备开发包是基于 TuyaOS 系统裁剪得到的适用于 LTE Cat.1、Cat.M、Cat.4 协议产品的开发包。

概述

Cat.X 设备开发包支持设备配网、设备激活、安全通信、云端连接、设备控制、固件 OTA 升级等核心能力,并提供相关函数。您无需关心各 LTE Cat.X 芯片平台的设备功能的具体实现方式,只需要按照开发包提供的标准 API 进行适配,即可实现接入 涂鸦开发者平台,完成设备智能化。

适用范围

Cat.X 设备开发包适用于基于 LTE 蜂窝物联网技术的产品开发。

能力地图

设备管理

能力
说明
初始化 初始化是指设备上电、启动之后,调用一系列接口,完成设备硬件环境的初始化、TuyaOS 软件的初始化、应用功能初始化等工作。应用初始化的时候,您需要根据自己的产品形态,提供一些回调函数,用于处理 TuyaOS 内部的状态变化、控制操作、升级等工作。
重置 设备重置是把设备恢复到配网、激活之前状态的操作。根据触发源不同,可以分为本地重置和 App 重置。根据重置后设备所处的状态,又可细分为普通重置(解除绑定)和恢复出厂重置(解绑并清除数据)。
授权 授权是通过将涂鸦产生的设备标识信息写入到设备的不易失存储期间之中,用于后续设备正常运行时的设备认证。授权方式有通过代码的方式授权和通过工具的方式授权,前者主要在调试阶段使用,后者主要在量产生成时使用。

配网和激活

能力
说明
扫码绑定 设备在连接到路由器之后,App 通过扫码设备上粘贴的二维码或者屏幕上显示的二维码,获取设备相关的信息,并通过云端向已经连接到云端端激活服务器的设备推送激活 Token。设备在获取到激活 Token 之后,使用授权信息和 Token,向云端进行设备认证、激活操作。
蓝牙配网 App 发现设备后通过蓝牙推送激活 Token 给设备,设备在获取 token 后,使用授信信息和 Token,向云端进行设备认证、激活的操作。

设备控制

能力
说明
DP 模型或控制协议 TuyaOS 设备模型描述,通过设备模型可以对设备进行控制。
蓝牙控制 当 App 位于设备附近,且设备处于离线状态,可以通过蓝牙协议对设备进行控制。
控制通道优先级 不同类型的设备使用场景不同,可以根据产品的需求,调整 蜂窝、蓝牙的控制的优先级,默认优先级。

基础服务

能力
说明
安全存储 TuyaOS 提供的,使用键值对(Key-Value)形式的,加密的数据存储功能,以及文件形式的,明文的数据存储功能。
健康检测 TuyaOS 提供的,定期执行对设备内存、无线信号、任务状态进行检测的功能,并支持应用自定义的检测指标。
日志服务 TuyaOS 提供的,用于记录设备运行过程的本地日志、记录异常并编码上报的日志序功能。
事件服务 TuyaOS 提供的,事件发布、订阅功能,通过订阅事件,可以感知内部变化的发送,并做相应的处理。
时间服务(时区、夏令时) TuyaOS 提供的,时间管理和维护功能,支持 UTC 时间和本地时间,本地时间由 UTC 时间、时区、夏令时等因素综合得来。
定时队器 TuyaOS 提供的,软件定时功能。
工作队列 TuyaOS 提供的,一种工作队列功能,用于处理低优先级的,可能存在阻塞的异步任务。
连接管理 TuyaOS 提供的,管理设备上各种连接方式的功能,如蜂窝、蓝牙之类的。维护设备和网络直接的连接状态。
线程管理 TuyaOS 提供的,线程管理功能。
BLE+Cat.X 服务 TuyaOS 提供的以低功耗蓝牙为主,蜂窝为辅的设备模型。该设备模型中,蜂窝共享蓝牙模组激活信息。

蜂窝服务

能力
说明
数据连接 蜂窝提供的拨号功能。
电话 蜂窝提供的电话功能。
短信 蜂窝提供的短信功能。
音频播放 蜂窝提供的音频功能。支持内存播放和文件播放、包括音量控制等功能。
DTMF 侦测 蜂窝提供的通话过程中,侦测对方的发送的 DTMF 值
LBS 蜂窝提供基站定位数据
Wi-Fi 定位 蜂窝提供的 Wi-Fi 扫描到的热点的 MAC 地址
GNSS 蜂窝提供的 GPS 定位功能
虚拟 AT 蜂窝提供的虚拟的 AT(ATtention)命令服务

设备驱动

连接驱动

能力
说明
Bluetooth 蓝牙驱动

外设驱动

能力
说明
GPIO GPIO 驱动
ADC ADC 驱动
UART UART 驱动
SPI SPI 驱动
PMU PMU 驱动
LCD LCD 驱动
FLASH 外置的 NAND Flash 驱动

功耗管理

能力
说明
蜂窝 低功耗 蜂窝低功耗管理

定时服务

能力
说明
本地定时 将定时任务规则下载到设备,本地计时并到期执行任务。
天文定时 本地定时的一种,通过设备所处区域日出日落时间规则设置定时任务。
日历定时 本地定时的一种,更加丰富的定时规则选择,可以使用周循环、奇偶日、隔天、隔小时等规则设置定时任务。

升级服务

能力
说明
静默升级 设备自动扫描云端升级配置,在不需要 App 感知的情况下对设备固件进行升级。
提醒升级/强制升级 云端配置升级,在 App 通过之后,通知设备对固件进行升级。
附属固件升级 对设备上的各种固件进行升级。

设备安全

能力
说明
安全体系(安全级别,安全能力) 设备身份认证、安全存储、安全通信、隐私数据合规。

网络

能力
说明
iot-dns 服务域名配置、证书管理服务、域名解析服务
https HTTPS 库
mqtt over tls MQTT 库
mbedTLS mbedTLS 库

系统服务

能力
说明
内存管理(Tuya heap6) TuyaOS 自研堆管理功能。
modbus master 服务 TuyaOS 自维护的 ModBus Master 组件

支持与帮助

在开发过程遇到问题,您可以登录 TuyaOS 开发者论坛 TuyaOS-蜂窝设备开发 进行沟通咨询。