类型开发包

更新时间:2024-06-25 06:07:25下载pdf

NB-IoT 类型开发包是基于 TuyaOS 系统裁剪的适用于涂鸦蜂窝 NB-IoT 产品的开发包,同时内置多种运营商平台接入的网络通信协议栈(LwM2M 及 OneNET)和丰富的库函数,符合各类型低功耗产品的开发。

概述

NB-IoT 类型开发包将设备配网、上下行数据通信、产测授权、固件 OTA 升级、文件下载等接口进行封装,并提供了标准 API。您无需关心各芯片平台相关功能的具体实现,只需要基于 TuyaOS 提供的标准 API 进行产品开发,即可接入涂鸦开发者平台,完成设备的智能化。

开发包特性

  • 多种协议平台接入支持:支持不同运营商平台接入自适应。可以根据插入的不同 SIM 卡自动接入平台,例如电信 AEP、移动 OneNet 等。您也可以手动配置涂鸦直接接入模式。
  • 全功耗模式支持:支持 PSM、DRX、EDRX 及用户配置模式。
  • 数据交互:简易的数据上报及收发接口。
  • 文件下载:文件下载功能。
  • OTA 升级:差分包下载升级功能。
  • 周边接口:丰富的硬件平台接口控制,支持 GPIO、UART、ADC、SPI、I2C 等。

资源需求

NB-IoT 设备开发包代码体积约占 1700K 的 ROM 空间,正常运行需要约 250K RAM 空间。开发包根据不同芯片平台的占用情况不同,内存占用情况也差异较大。

能力地图

设备管理

能力
说明
初始化 初始化是指设备上电、启动之后,调用一系列接口,完成设备硬件环境的初始化、TuyaOS 软件的初始化、应用功能初始化等工作。应用初始化的时候,您需要根据自己的产品形态,提供一些回调函数,用于处理 TuyaOS 内部的状态变化、控制操作、升级等工作。
重置 设备重置是把设备状态恢复为未绑定状态,重新激活等操作。目前主要可通过本地重置和云端下发重置。
授权 授权是通过将涂鸦产生的设备标识信息写入到设备的不易失存储期间之中,用于后续设备正常运行时的设备认证。授权通过工具的方式授权。

配网和激活

设备连接上基站后,自动完成配网及激活过程。

设备控制

能力
说明
DP 模型&控制协议 TuyaOS 设备模型描述,通过设备模型可以对设备进行控制。

基础服务

能力
说明
安全存储 TuyaOS 提供的,使用 Key-Value 形式的,加密的数据存储功能,以及文件形式的,明文的数据存储功能。
日志服务 TuyaOS 提供的,用于记录设备运行过程的本地日志、记录异常并编码上报的日志序功能。
定时队器 TuyaOS 提供的,软件定时功能。
工作队列 TuyaOS 提供的,一种工作队列功能,用于处理低优先级的,可能存在阻塞的异步任务。
连接管理 TuyaOS 提供的,管理设备上各种连接方式(LwM2M 及 OneNET 等)的功能。
任务管理 TuyaOS 提供的,任务管理功能。

设备驱动

能力
说明
GPIO GPIO 驱动
ADC ADC 驱动
I2C I2C 驱动
UART UART 驱动
SPI SPI 驱动

功耗管理

能力
说明
低功耗 PSM、DRX、EDRX 功耗管理

定时服务

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

升级服务

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

网络

能力
说明
lwm2m LwM2M(Lightweight M2M)库
onenet 移动 OneNET 库
mbedTLS mbedTLS 库

支持与帮助

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