如何绑定 NB 模组?
-
绑定 NB 模组前,请确保 NB 模组已搭载好最小系统电路。供电稳定,天线合规信号强度良好,且已插上 NB 专用物联网 SIM 卡。
-
NB 模组在出厂后首次使用前是未激活的,此时使用涂鸦智能 App 绑定会失败,必须完成首次入网才可完成激活。
-
模组激活步骤
- 模组供电,MCU 与模组进行交互
- 模组会向 MCU 发送 01 命令字查询产品 PID
- MCU 回复模组发送的产品信息查询指令
- 模组收到了产品信息会以此上传到云端进行模组激活
- 模组回复网络状态 03(已连接到电信平台,设备未绑定)
- 此时可使用涂鸦智能 App,扫描模组短码标签才绑定设备
-
涂鸦 MCU 仿真助手测试数据:
-
涂鸦智能 App 绑定操作。更多详情,请参考 App 使用手册。
说明:模组短码标签为涂鸦 NB 模组唯一识别码,非模组自带生产标签,一般贴于整机外包装,方便终端客户绑定使用。此标签必须使用涂鸦标签打印工具才可生成标签,工具可从涂鸦工作人员处获得。在研发阶段,可手动输入模组 IMEI 绑定。
- App 绑定成后,设备端必须要和涂鸦云进行一次交互后,才可同步绑定消息。可通过主动上报一条数据或 MCU 发送重置指令给模组来与涂鸦云进行交互。同步成功的模组会发出已绑定的网络状态通知,
- NB 模组具有强绑定性,一旦被某个用户绑定,必须通过 App 端移除设备,才可使其他用户绑定。设备端本地重置指令无法解绑。
模组如何上报数据?
- PSM 类型模组上报数据时,必须要退出 PSM 模式。可通过拉低 PSM_EINT 5 ms(具体时间以实测为准)以上来唤醒模组。此时便可使用 05 命令字-实时数据上报 或 08 命令字-记录型数据上报(推荐使用)。
- DRX类型模组可实时响应 MCU 的上报指令。
- 模组在未绑定情况下,上报数据是会在本地过滤掉的,不会上传到云端,并返回给 MCU 上报失败。
- 05 与 08 命令字使用详情可看通用协议。
如何查看设备上下发日志?
- 配网成功后,如果想看该设备上下发的后台数据,可登录 开发者平台产品管理 ,根据设备ID 、模组 SN 号、设备名称等途径查询。
- 设备ID,在配网后,设备日志页面 可查看。
关于组合上报,我需要注意哪些?
- NB 模组支持组合上报,格式请查看对接协议。上报一帧数据不超过 255 字节。
- 建议每次上报数据超过 2 个 DP,使用组合上报,可节省上报时间和功耗。
下发数据收不到,怎么办?
PSM 型终端非业务期间深度休眠,不接收下行数据,只有终端主动发送上行数据(MO Data)时可接收开发者平台缓存的下行数据。
- App 面板操作下发指令,但模组没有发出下发的数据。这是因为 NB模组 处于 PSM 低功耗模式,关闭了射频接收等外设,无法接收到数据。必须要模组主动上报一次数据与涂鸦云进行一次交互,上次操作滞留的下发指令便会发出。多个 DP 点操作,会下发多个数据,同一个 DP 点只下发最新的操作。
- 模组设定的心跳间隔周期到,模组会自动和与平台进行一次交互,维持心跳,此时缓存的数据下发。
- 设备若是离线了,平台缓存的所有下发指令会被清除。
App 每次操作,数据都能下发,可以做到吗?
- 可以,使用 DRX 模式的 NB 模组,且使用办理了 DRX 业务的 SIM 卡。
- DRX 类型的 NB 模组是不会进入 PSM 状态的,所以下发数据实时接收。
- PSM 类型的 NB 模组是不支持实时下发,由 NB 特性决定。
NB 模组如何解绑?
- 云端:App 端主动移除设备后,即可被其他账号绑定,设备端不同步也没关系。
- 设备端:设备移除后,模组的网络状态还是显示已绑定,需要和涂鸦云进行一次交互,才可同步解绑信息。
- 可使用下列方式同步:
- 上报一次数据,与平台进行一次交互。模组即显示上报失败,网络从已绑定变为未绑定(推荐) 。
- MCU 发送重置指令,重置 NB 模组。
关于重置指令的使用?
- 重置指令,用于恢复出厂设置,会将模组本地心跳间隔重置为默认 8h。MCU发送此指令给模组,模组会去云端重新下载产品信息(仅限设备在未绑定状态时)。
- 若更换产品PID,或对某些DP点进行修改后,需要模组更新产品信息。因此需要MCU发送重置指令给模组,模组会执行恢复出厂设置,同时去云端更新当前的产品信息。需要设备在未绑定的情况下才会生效。
- MCU在程序中尽量不要调用此指令,此指令会使模组上报当前的产品 pid 及从云端更新产品信息。交互数据多,影响功耗和流量。模组在下载产品信息相关数据过程有些长,大约十几秒,在这过程中上报数据给模组会判定失败。
- 可在设备端加上实体按键,用于按键触发mcu发送重置指令给模组,用以更新产品信息。
睡眠锁如何使用?
- 睡眠锁功能开启后,模组将关闭进入 PSM 的功能,即处于 idel 的状态。模组不进入低功耗状态,可实时响应 MCU 发送的指令,不需要通过 PSM_EINT 唤醒模组后才能响应 MCU 发送的指令。
- PSM 类型的 SIM 卡:若模组每次唤醒都有大量数据上报,且数据包间隔周期长。为避免数据还没发送完模组就进入 PSM 低功耗状态,可在模组唤醒后,就打开睡眠锁,待数据都发送后再关闭睡眠锁(根据实际需求选用)。
- DRX 类型的 SIM 卡: MCU 与模组完成基本交互后要打开睡眠锁,可防止模组进入轻睡眠(必须)。
App 如何才会显示设备离线?
- 云端逻辑默认超过 24 小时未上报数据,即判定设备离线(与电信云逻辑一致)。
- 检测周期时间未满,或设备断电,云端还是显示在线的。
- 若是有特殊需求,需要更改云端离线检测时间,可与项目经理沟通,云端重新设置此产品的云端离线检测时间(比较使用于 DRX 类型的需求)。
关于模组心跳间隔,我需要注意哪些?
- 此心跳为模组与平台的交互心跳周期,模组的心跳间隔默认是 8 小时,最小为 1 分钟,设置低于 1 分钟会有问题。
- 此心跳可替代数据上报,维持设备在线状态。
- 模组心跳一次,与云端交互所耗流量约为 96 Byte。
- 若想避免心跳频繁上报导致流量损耗,可将心跳间隔设置成几十天,几百天,或者设置为 0 关闭。
- 当网络非常差时,模组发送失败会进入深度睡眠(非 PSM 模式),此时心跳功能将关闭,必须通过下拉 PSM_eINT 唤醒模组。
NB 模组唤醒后多久重新进入 PSM 模式?
NB 唤醒后,需要至少 20 秒时间再次进入低功耗状态。具体时间和信号强度、SIM 卡所办理的 APN 类型相关。
说明:当终端上传数据完成后,无线基站启动“不活动计时器”(默认20秒),如果终端在这个定时器时间内一直没有接收和发送数据,基站将释放终端无线连接(核心网用户会话信息保持,终端IP地址不变),终端进入Idle状态并启动激活定时器(Active-Timer),当激活定时器超时后,终端进入PSM状态。
NB 唤醒 20 多秒后进入 PSM,这个时间过长,可设置吗?
- 不可设置,此时间是按芯片原厂建议设计的,20 秒可保障网络链路稳定,标准 NB 都固定为 20 多秒,这是由基站核心网与模组固件共同决定的。
- 可定制固件适当改小,但可能会导致进入不了下行速率和数据发送不完整。比较使用于没有下行控制类设备。具体请咨询项目经理。
NB 的信号强度有哪些注意事项?
- MCU可通过指令查询 NB 模组的信号强度,若是信号强度在 10 以内,表示信号强度很差,有概率是无法连上运营商基站。
- 请检查 SIM 卡是否激活、是否办理 NB 业务、资费未超过标注、安装正确
- 信号强度由基站覆盖于设备端天线性能有关。信号强度若是很差,请检查天线是否是匹配过的优良天线,接触是否不良。
NB 模组的功耗情况如何?
| 终端状态 | 功耗消耗 | 某环境实测结果|
| — | — | — | — |
| PSM 状态 | 3 uA | 2.7 uA |
| eDRX 空闲态 | xxuA~2 mA | 1 mA |
| DRX空闲态 | 1~4mA | 1mA|
| 连接状态 | 发送 200 mA,接收 65 mA |发送 189 mA,接收 161 mA |
NB 模组如何选 SIM 卡?
- 涂鸦的 NB 模组支持三网,涂鸦的商用平台为电信,因此建议 SIM 卡首选电信,次之为移动(有隐患)。
- 可自行去运营商购买 NB 物联网卡,购买时请确定好 APN 是支持 PSM 的还是 DRX 的卡。也可从涂鸦购买,资费套餐详情请联系项目经理。
NB 模组的业务类型有哪些?
- 涂鸦的 NB 模组分为 PSM 类型及 DRX 类型。两种类型对应两种不同的云端逻辑。申请模组前请确定好产品的业务类型。
- PSM 类型的模组,会将进入 PSM 模式以降低功耗,常用于电池供电设备,固定上报通知类型,不可实时响应下发指令。
- DRX 类型的模组,不会进入低功耗,实时响应上下发数据,常用于对功耗不敏感设备,实时控制类型。
如何使用 DRX 类型 NB 模组?
- 使用支持 DRX 类型的物联网 SIM 卡
- 开发者平台创建 DRX 类型的产品
- 使用 DRX 类型的模组固件
- 模组在唤醒后必须调用睡眠锁指令,防止进入 lightsleep,若不打开睡眠锁,在这个状态通讯会有问题。
NB 平台,支持短信和电话等告警通知信息吗?
支持,但这是增值服务,需要额外收费,收费详情请联系您的客户经理。
NM1 模组可以在全球范围内使用吗?
不可以,此模组只能在中国大陆地区使用。
NB 模组支持定位吗?
涂鸦模组支持 R14 协议标准,运营商暂时不支持定位功能,待运营商后续开放。