# 数据手册
智能工卡基于 GNSS、BLE 和 LoRa 技术设计。与传统的基于 GPRS 的解决方案相比，该智能工卡拥有超长的待机时间，采用了先进的 LoRa 技术和内置的加速度传感器。支持利用 BLE 技术的室内定位和利用 GNSS 技术的室外定位。定位周期、心跳周期、LoRa 工作模式可根据用户情况在线设定。
特点
- 兼容 LoRaWAN1.0.3
- 智能省电，超长待机 6 个月
- 支持 BLE 在线升级，批量升级
- 支持 BLE，LORA 在线配置参数
- 800mAh 可充电锂电池
- 本安设计，可用于多种场合
当前版本：V1.7
发布时间：2024/08/10
# 产品规格
产品尺寸
| 参数 | 值 |
|---|---|
| 长 | 98 毫米 |
| 宽 | 61 毫米 |
| 厚 | 7.7~9.1 毫米 |
| 重量 | 50 克 |
产品指标
| 参数 | 值 |
|---|---|
| 工作频率 | 470M~510M |
| 发送功率 | 17dbm |
| 灵敏度 | -130dbm |
| 待机电流 | 20 微安 |
| 工作温度 | -20~60℃ |
| 存储温度 | -40~85℃ |
| 通信距离 | 市区大于 1.5 公里 |
# 上行消息
上行消息指设备通过 Lora 发送给基站的数据。
| 消息类型 | 需要应用服务器确认 | 需要网路服务器确认 | 端口 |
|---|---|---|---|
| 心跳 | 否 | 是 | 10 |
| GNSS 坐标 | 否 | 是 | 11 |
| BLE 消息 | 否 | 可配置 | 12 |
| 报警消息 | 只有 SOS | 非 SOS | 13 |
| 确认消息 | 否 | 是 | 14 |
| 定位信标 UUID | 否 | 是 | 15 |
| 资产信标 UUID | 否 | 是 | 16 |
| 透传蓝牙过滤器 | 否 | 是 | 17 |
| 需确认信标配置列表 | 否 | 是 | 18 |
| 历史信标列表 | 否 | 是 | 19 |
| 历史室外坐标列表 | 否 | 是 | 20 |
| 透传消息 | 否 | 否 | 21~25 |
应用服务器确认表示客户服务器需要确认上行消息，否则设备将重试，直到确认。网络服务器确认表示网络服务器需要确认上行消息，否则设备将重试一次。端口是 LoRa 消息的帧端口，用于有效载荷解析前的消息识别。
# 心跳消息
| 字节数 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 2 | 4 | 1 | 2 | 1 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 内容 | VER | RSSI | SNR | STATUS | VOL | COM | BLE | OPTION | WARN | PERIOD | SLEEP | TIME | THRES | STEP | TEMP |
心跳消息保持周期性发送，向服务器上报设备当前状态及配置参数。 VER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~6 | 硬件类型 | 0~3 | 硬件类型。 0：工卡 1：蓝牙网关 2：车载终端 3：保留 |
| 5~4 | 大版本 | 0~3 | 软件大版本 |
| 3~0 | 小版本 | 0~15 | 软件小版本 |
RSSI
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | RSSI | -128~127 | 由设备检测和计算的下行链路接收信号强度指示。 单位：dbm 实际值需减去 20。如上报值为-110，实际值则为-130。 |
SNR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | SNR | -128~127 | 下行链路信噪比 |
STATUS
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | GNSS | 0：关闭 1：定位中 2：定位成功 3：无信号 | 模块将试图在 60 秒内获取坐标，如果失败，将停止搜索。 |
| 4~3 | 充电 | 0：充电线断开 1：充电中 2：充电完成 | 电池充电状态 |
| 2 | 运动状态 | 0：静止 1：运动 | 指示设备在上一心跳期间运动状态 |
| 1 | 工作模式 | 0：定位器 1：蓝牙网关 | 仅在硬件类型为工卡时适用 |
| 0 | 保留 | 0 |
VOLTAGE
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | VOL | 0~255 | 实际电池电压等于 VOL/100+2 |
COM
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~6 | 发射功率 | 0：17 1：15 2：13 3：11 | 单位：dbm，默认值为 0 |
| 5~3 | 速率 | 0：DR5 1：DR4 2：DR3 | 默认值为 DR5 |
| 2~0 | 工作模式 | 0~7 | CN470 版为固定值 3 |
BLE
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7 | 自动上报 | 0：关闭 1：开启 | 指示工卡是否启动 BLE 自动扫描，即使设备是静止的。 默认值为 0，在这种情况下，只有检测到运动时才开启蓝牙扫描。 |
| 6~3 | 蓝牙上报周期 | 0：BLE 不工作 1：5 秒 2：10 秒 3：20 秒 4：30 秒 5：1 分钟 6：2 分钟 7：5 分钟 8：10 分钟 9：15 分钟 10：20 分钟 11：30 分钟 12：1 小时 13：2 小时 14：6 小时 15：12 小时 | BLE 扫描周期。默认值为 10 秒。 如果工卡在没有外部电源的情况下作为 BLE 网关工作，可以设置较长的 BLE 扫描周期来节省电量。 若设为 0，GNSS 将不依赖蓝牙扫描结果，只要检测到运动就工作 |
| 2~0 | 扫描时间 | 0：1 秒 1：2 秒 2：3 秒 3：6 秒 4：9 秒 5：12 秒 6：15 秒 7：一直扫描 | 一个周期内的连续 BLE 扫描时间。该值由信标发送周期决定，如果信标每 500 毫秒广播一次，1 秒是合适的。 在某些情况下，为了节省信标的功率，可以将信标的间隔延长到 1 秒，然后扫描需要改为 2 秒来覆盖信标。默认值为 1s。 该值应设置为小于 BLE 扫描发送周期，如果它大于 BLE，设备会将其更改为 BLE-1。 |
BLE OPTION
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~6 | 信标扫描类型 | 0~3 | 该位指示将扫描哪种信标。 如果工卡作为追踪器工作： 0：仅扫描定位和危险信标 1：扫描定位、资产和危险信标 2：仅扫描邻近工卡 3：扫描各种信标和工卡 如果设备用于人员追踪，则 SCALE 可以设置为 0。 如果只是为了保持安全的社交距离，可以设置 2。 如果工卡用作 BLE 网关或硬件类型为 BLE 网关： 0：仅扫描资产信标 1：仅扫描邻近工卡 2：扫描所有类型的信标和工卡 |
| 5~3 | STEPSOFF | 0~7 | 当 BLE 扫描周期到达，但移动步数小于此值时，它将不会开始 BLE 扫描。 单位：5 步。 如果 BLEOFF 为 0，STEPSOFF 将不生效。 例如：如果 STEPSOFF 为 4，则阈值为 20 步。当 BLE 扫描周期到达时，设备发现增加的步数少于 20，BLE 扫描将不会启动。 |
| 2~0 | BLEOFF | 0~7 | 如果扫描的信标与上次相同，将不会上报 BLE 数据，直到 BLEOFF 个周期以后即使相同也上报。 默认值为 3。 BLEOFF 和 STEPSOFF 配合使用可以降低设备功耗。 示例：如果 BLEOFF 为 3，则在每个 BLE 扫描周期，设备发现新增加的步数小于阈值，则不启动蓝牙扫描，若大于阈值，则启动，启动扫描后发现扫到的信标和上次相同则不上报，在 3 个周期之后，即使仍然小于阈值，设备仍然开始 BLE 扫描，扫描到信标后即使相同也上报。 |
WARN
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~6 | 保留 | 0 | |
| 5 | 蜂鸣器 | 0：禁用 1：开启 | 仅在侦测相邻工卡功能启用时有效。 正常开关机、报警时触发的蜂鸣器发声不受此标志位影响 |
| 4 | 振动器 | 0：禁用 1：开启 | 仅在侦测相邻工卡功能启用时有效。 470M 设备不包含振动器 |
| 3~1 | 距离 | 0：2 米 1：4 米 2：6 米 3：8 米 4：10 米 5：15 米 6：大于 15 米 | 当两个工卡距离达到此值时，蜂鸣器会发出蜂鸣声或振动器会振动。 |
| 0 | 相邻工卡侦测 | 0：禁用 1：开启 | 是否启用相邻工卡侦测功能，如果启用，设备将定期广播 BLE 信号，同时它还将检测其它工卡的 BLE 信号。 默认值为 0。 功能启用时，建议将 BLE 设置为 5 秒，扫描设置为 1 秒，以进行实时检测；或者将 BLE 设置为 10 秒，扫描设置为 2 秒，以实现精确检测；或者将 BLE 设置为 5 秒，将扫描设置为 2 秒，以实现实时和精确，但功耗较高。 |
PERIOD
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | GNSS | 0：GPS 关闭 1：5 秒 2：10 秒 3：15 秒 4：30 秒 5：60 秒 6：150 秒 7：5 分钟 8：15 分钟 9：30 分钟 10：1 小时 11：1.5 小时 12：3 小时 13：6 小时 | GPS 坐标报告的周期。 默认值为 1 分钟。 对于工卡，此参数被禁用，ALREPORT 被设置为 1，STEPSOFF 被设置为 0，工卡将作为蓝牙网关工作，此后心跳消息中的工作模式将被设置为 1。 客户服务器可以在将定位器更改为网关之前设置这些参数。 |
| 3~0 | 心跳消息 | 0：1 分钟 1：5 分钟 2：10 分钟 3：20 分钟 4：30 分钟 5：1 小时 6：2 小时 7：6 小时 8：12 小时 9：24 小时 | 发送心跳消息的周期。 默认值为 10 分钟 |
SLEEP
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~13 | 保留 | 0 | |
| 12~10 | 睡眠程度 | 0~7 | 设备睡眠程度。 0 表示完全睡眠，1 表示不睡眠，其它值为睡眠因子。 如当前心跳周期为 10 分钟，睡眠因子为 2，则在此休眠时间段内，心跳周期将为 20 分钟。 为了省电，在特殊时间，工卡可以停止工作或降低信息频率。 默认值为 0。 |
| 9~5 | 开始时间 | 0~23 | 从此时起，设备将进入睡眠模式。 默认值为 0。 |
| 4~0 | 结束时间 | 0~23 | 从此时起，设备将从睡眠模式中唤醒。 如果开始等于结束，设备将不会进入睡眠模式。 默认值为 0。 例如： 1.若 Start 为 23，End 为 7，则睡眠时间为每晚 11 点到第二天早上 7 点。 2.若 Start 为 7，End 为 18，则从早上 7 点到下午 6 点为睡眠时间。 |
TIME
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 31~0 | 时间 | 自1970/01/01 00:00:00的秒数，如果启用休眠模式，设备需要知道确切的时间。设备无法通过GNSS获取时间，因为GNSS功能可能没有启用。在这种情况下，设备周期性上报设备时间。如果服务器检测到一个大的时间错误，服务器发送命令调整设备时间。建议时间误差超过10秒时进行调整。如果Start等于End，说明休眠模式未开启，则设备不上报TIME |
THRES
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | 保留 | 0 | |
| 3 | BLEACK | 0：Disable 1：Enable | 指示蓝牙消息是否需要网络服务器确认，此配置将对所有蓝牙生效。若应用中所有的蓝牙消息都很重要，不能丢失，可将此选项打开。 |
| 2~0 | 蓝牙扫描范围 | 0：无限制 1：-90dbm 2：-87dbm 3：-84dbm 4：-81dbm 5：-78dbm 6：-75dbm 7：-72dbm | 扫描信标的信号范围，低于此值的信标将被忽略。 |
STEP
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | 步数 | 0~65535 | 步数。 工卡始终报告自工卡启动以来的总步数。 若设备重启将清 0。 |
TEMP
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 温度 | 0~255 | 指示当前环境温度，需要从报告值中减去50才能得到实际温度。 例如，如果报告值为40，则实际温度为-10度。 |
# GNSS
| 字节 | 4 | 4 | 4 | 1 |
|---|---|---|---|---|
| 内容 | 经度 | 纬度 | 高程 | 定位时间 |
经度
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 31 | 东西经指示 | 0：东经 1：西经 | |
| 30~0 | 经度 | 0~1800,000,000 | 实际值计算公式为： (经度/10^7)+(经度 % 10^7) /(100000.0×60)。 |
纬度
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 31 | 南北纬指示 | 0：北纬 1：南纬 | |
| 30~0 | 纬度 | 0~900,000,000 | 实际值计算公式为： (纬度/10^7)+(纬度 % 10^7) /(100000.0×60)。 |
高程
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 31~0 | 高程 | 0~2,147,483,647 | 实际值计算公式为： 高程/100。 |
定位时间
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 定位时间 | 0~60 | 定位所花费时间。 如果工卡在 60 秒内未能获取坐标，将停止获取坐标，并上报定位失败告警。 单位：秒 |
# 蓝牙信息
| 字节 | 1 | 1 | 1 | 2 | 2 | 1 | 1 | 2 | 1 | 2 | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 内容 | TYPES | M1NUM | M2NUM | ... | MAJOR1 | MINOR11 | RSSI11 | BAT | MINOR12 | RSSI12 | ... | MAJOR2 |
TYPE
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | 保留 | 0 | |
| 3~0 | 数量 | 1~15 | 此消息中包含的不同信标类型个数，以 Major 号区分。 |
M1NUM
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~6 | 保留 | 0 | |
| 5~0 | 数量 | 1~63 | 与 Major1 具有相同 Major 号的信标数量。 |
MAJOR1
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MAJOR1 | 0~65535 | BLE 信标 Major 号 |
MINOR11
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MINOR11 | 0~65535 | Major 号为 Major1 的 BLE 信标的 Minor 号。 |
MINOR11 和 MINOR12 是与 MAJOR1 具有相同 MAJOR 的信标。
RSSI11
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7 | BATIND | 0~1 | RSSI 字段后是否添加电池电量。 0：无电池电量 |
| 6~5 | TYPE | 0~3 | 0：定位信标。 1：用于资产管理的 Beacon。 2：危险提示告警信标。 3：用于相邻工卡检测的工卡。 |
| 4~0 | RSSI11 | 0~31 | 接收信号强度指示，服务器可以利用它来计算距离。 实际值为(RSSI11 + 59) * (-1) dbm。 如果工卡计算的 RSSI 小于-90dbm，它总是报告 31。如果工卡计算的 RSSI 大于-59dbm，总是报告 0。 |
如果危险信标被扫描到，蜂鸣器将响三次。
BAT：
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7 | 保留 | 0~1 | |
| 6~0 | 电池电量 | 0~100 | 剩余电量 单位：百分比。 如果信标不支持电池检测，则设置为 0。 对于 RCT 生产的信标，广播消息中 RSSI@1 米表示电池剩余容量。只有 RCT 生产的信标支持。 |
假设有如下信标，工卡步数是 50。
Major：0x0101 Minor：0x1101 RSSI：-60dbm BAT： 90% 类型：资产
Major：0x0101 Minor：0x1102 RSSI：-65dbm BAT：未知 类型：定位
Major：0x0101 Minor：0x1103 RSSI：-70dbm BAT： 80% 类型：告警
Major：0x0201 Minor：0x2101 RSSI：-59dbm BAT： 80% 类型：工卡
Major：0x0201 Minor：0x2102 RSSI：-60dbm BAT： 90% 类型：工卡
Major：0x0101 Minor：0x3101 RSSI：-75dbm BAT： 90% 类型：定位
Major：0x0101 Minor：0x3102 RSSI：-80dbm BAT： 80% 类型：资产
Major：0x0301 Minor：0x3101 RSSI：-65dbm BAT：未知 类型：资产
Major：0x0301 Minor：0x4102 RSSI：-60dbm BAT： 90% 类型：工卡
Major：0x0401 Minor：0x5101 RSSI：-60dbm BAT： 90% 类型：告警
Major：0x0401 Minor：0x5102 RSSI：-65dbm BAT： 80% 类型：定位
Major：0x0401 Minor：0x5103 RSSI：-75dbm BAT： 90% 类型：资产
信息应该是： 0x000032 04 05020203 0101 11018A15A 110206 1103CB50 3101905A 3102B550 0201 2101D050 2102D15A 0301 310126 4102D15A 0401 5101C15A 51028650 5103B05A
在一条信息中，最多可以报告 50 个信标，如果该设备是定位器，扫描信标时，工卡具有最高优先级，然后是告警、定位和资产。如果设备是蓝牙网关，工卡优先级最高，然后是资产。信标通过以下 UUID 进行区分。
| 类型 | UUID | 可扩展 |
|---|---|---|
| 工卡 | 531811F50CAE4341BEBAF6B16B651D6C | 否 |
| 告警 | 545EF5EE26B747D2AE0CAD65659E1BAC | B5DDA367F36945FB95B4453EDAABD |
| 定位 | EFE49FA5F2BF48FF89F1AFCD8A7B5E81 | 可配，最多5个 |
| 资产 | DBE091B9EE34421BB3EDD274C045D9A3 | 可配，最多5个 |
在这四种信标中，工卡和告警类型的 UUID 不可更改。对于定位和资产，除了表中的 UUID，也可以配置其它 UUID 来支持第三方信标。
注意
对于报警、定位器和资产信标，如果是第三方信标，设备不会尝试报告电池电量信息，如果第三方信标支持电池电量上报，应设置与表中列出的UUID相同的UUID，并将电量信息设置在iBeacon消息的RSSI@1m字段中。对于告警信标，如果是第三方信标，不支持电量上报，UUID必须设置为B5DDA367F36945FB95B4453EDAABDC90，否则跟踪器可以将RSSI@1m作为电量信息。对于特殊的部署目的，工卡可以转换为一个信标，由iBeacon使用特殊的UUID触发901514132b14da796f6d85ba68811cb。当这种信标被扫描时，工卡会每秒广播一次，广播UUID为DBE091B9EE34421BB3EDD274C045D9A3，与资产信标相同。
# 报警消息
| 字节 | 1 | 1 |
|---|---|---|
| 内容 | MSGID | ALARM |
ALARM
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4 | ACK | 0~1 | 0：不需要客户服务器的确认。 1：需要客户服务器的确认，否则将重新发送，直到收到确认。 |
| 3~0 | ALARM | 0：紧急呼救 1：解除搜索 2：关机 3：BLE 关闭 4：LoRa 关闭 5：GNSS 定位失败 6：越界告警 7：GNSS精度低 | 报警类型 0：3 秒内按 3 次按钮触发 SOS。对于紧急呼救，需要客户服务器的确认，否则将每 10 秒报告一次。 1：长按按钮重置工卡，紧急呼救解除。 2：工卡已关闭。工卡不能通过按钮关闭。电源关闭由远程命令或 BLE 命令触发。 3：由于扫描了特殊信标，蓝牙广播关闭。 4：由于扫描了特殊信标，LoRa 关闭。BLE 扫描改为每 1 分钟一次，在三个周期内没有扫描到特殊信标的情况下，尽量恢复 LoRa。 5：由于 GNSS 信号持续微弱，GNSS 定位失败。 6：扫描到部署在危险区域的告警信标。如果停留在该区域，警报将始终每 10 秒报告一次，蜂鸣器开始时发出 3 次蜂鸣声。 7：GNSS精度低于门限，忽略。 注意：目前不支持 3 和 4。 |
MSGID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 消息编号 | 0~255 | 上行消息的序列号，若消息需要确认，应用服务器应该用该序列号响应确认，否则工卡将重新发送消息。 |
# 确认消息
| 字节 | 1 | 1 |
|---|---|---|
| 内容 | MSGID | RESULT |
MSGID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 消息编号 | 0~255 | 对应下行消息的 MSGID。 |
RESULT
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | 保留 | 0 | |
| 3~0 | RESULT | 0~2 | 0：下行消息已收到，处理正常。 1：参数不支持。 2：参数超出范围。 |
# 定位信标 UUID
工卡最多只报告三个信号最强的定位信标。默认情况下，工卡可以解析 iBeacon 格式的标准信标，UUID 必须是 EFE49fa5F2BF48ff89f1afcd8a7b5e81。如果客户有其他种类的标准 iBeacon，但 UUID 不同，客户可以在工卡中配置此 UUID。支持的最大 UUID 个数是 5，此消息用于报告已配置的 UUID 列表。此消息必须由服务器请求，工卡不会主动报告。
| 字节 | 1 | 1 | 16 |
|---|---|---|---|
| 内容 | 数量 | 索引 | UUID |
数量
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 0~5 | 配置的 UUID 数。目前最多支持五个 UUID。 |
索引
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 0~4 | 列表中 UUID 的索引 |
UUID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 127~0 | UUID | 32 位 16 进制数 |
# 资产信标 UUID
这种信标用于资产管理，它可以被定位器和网关扫描。默认情况下，支持的 UUID 是 DBE091b9ee34421bb3ed274c045d9a3。此消息用于报告已配置的第三方信标的 UUID。此消息必须由服务器请求，工卡不会主动报告。
| 字节 | 1 | 1 | 16 |
|---|---|---|---|
| 内容 | 数量 | 索引 | UUID |
数量
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 0~5 | 配置的 UUID 数。目前最多支持五个 UUID。 |
索引
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 0~4 | 列表中 UUID 的索引 |
UUID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 127~0 | UUID | 32 位 16 进制数 |
# 透传信标过滤器
有时用户用到一些信标，格式不是标准的 iBeacon 协议，定位器不能直接解析，然后定位器可以根据配置扫描、过滤、传递数据。需要在定位器中配置消息的过滤器、起点和终点。定位器根据蓝牙设备广播消息中和过滤器匹配的内容识别消息，过滤器是固定数据的字节，与其他蓝牙设备相比必须是唯一的。此消息用于报告定位器的配置，必须由服务器请求，否则工卡不会报告。
| 字节 | 1 | 1 | 1 | 1 | 1 | 1 | FILTERLEN | |
|---|---|---|---|---|---|---|---|---|
| 内容 | NUMBER | PORT | START | END | FILTERSTART | FILTERLEN | FILTER | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 0~5 | 已配置过滤器的数量。目前支持的最大过滤器是 5。 |
PORT
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 端口 | 21~25 | 数据通过 Lora 上传的端口号。该过滤器的数据将从该端口上报。 |
START
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 开始位置 | 0~255 | 从广播消息的此字节开始上报数据。广播消息起始字节为 0。 |
END
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 结束位置 | 0~255 | 广播消息上报的结束字节。 |
FILTERSTART
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 匹配起始地址 | 0~255 | 从广播消息哪个字节开始匹配过滤器。 |
FILTERLEN
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 过滤器长度 | 4~15 | 过滤器长度 |
FILTER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 过滤器 | 4~15 | 用于匹配广播消息的过滤器 |
# 需确认信标配置列表
默认情况下，蓝牙消息是不需要服务器确认的，通过 BLEACK 参数可将所有蓝牙设为需确认。在某些应用场景中，只有部分蓝牙消息非常重要，不能丢失，这时可以通过此消息设置需要重传的信标信息，若设备未收到服务器的确认，将会缓存消息并在信号良好时重发。
| 字节 | 1 | 1 | 2 | 2 | 1 | 2 | 2 | |
|---|---|---|---|---|---|---|---|---|
| 内容 | 数量 | 索引 | MAJOR | MINOR | 索引 | MAJOR | MINOR | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4~0 | 数量 | 0~20 | 已配置信标的数量。最大支持 20。 |
INDEX
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4~0 | 索引 | 0~19 |
MAJOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MAJOR | 0~65535 | 所配置信标的 MAJOR 号 |
MINOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MINOR | 0~65535 | 所配置信标的 MINOR 号 |
# 历史信标列表
需确认信标若未收到网络服务器确认将缓存在本地，等设备检查到信号良好后重发。
提示
若设备一次扫到多个信标，设备只保存信号最强的一个信标。
| 字节 | 1 | 2 | 2 | 1 | 2 | 2 | 2 | 2 |
|---|---|---|---|---|---|---|---|---|
| 内容 | 数量 | MAJOR | MINOR | RSSI | FRMOFF | TIMEOFF | MAJOR | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | 保留 | 0 | |
| 3~0 | 数量 | 1~10 | 一次最多上传 10 个历史数据。 |
MAJOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MAJOR | 0~65535 | 所配置信标的 MAJOR 号 |
MINOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MINOR | 0~65535 | 所配置信标的 MINOR 号。 |
RSSI
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4~0 | RSSI | 0~31 | 实际值为(RSSI+59) * -1 |
FRMOFF
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | 帧偏移 | 0~65535 | 丢失的消息的帧号和当前消息的帧号的差值 |
TIMEOFF
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | 时间偏移 | 0~65535 | 丢失的消息的时间和当前消息的时间的差值，单位为秒 |
# 历史室外坐标列表
若设备超出 Lora 基站范围，设备将缓存位置数据，等信号良好时重发。最大可缓存 100 组数据，数据循环保存。
提示
若设备连续 20 个心跳周期未收到服务器确认，设备将重启，此时保存的历史数据将丢失。设备默认心跳周期为 10 分钟，所以在脱离基站环境下，设备最多支持 200 分钟，超过此门限，设备数据将丢失。
| 字节 | 1 | 4 | 4 | 2 | 2 | 4 | |
|---|---|---|---|---|---|---|---|
| 内容 | 数量 | 经度 | 纬度 | FRMOFF | TIMEOFF | 经度 | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~4 | 保留 | 0 | |
| 3~0 | 数量 | 1~8 | 一次最多上传 8 个历史数据。 |
# 透传蓝牙消息
| 字节 | 1 | 数量 * 单个消息长度 |
|---|---|---|
| 内容 | NUMBER | DATA |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 数量 | 1~5 | 传递数据的数量 |
DATA
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 过滤器 | 消息内容，用户平台负责对透传消息进行解析。 |
# 下行数据
所有下行消息都需要设备确认。
| 消息类型 | 端口 |
|---|---|
| 参数设置 | 10 |
| 蓝牙扫描开始时间 | 11 |
| 控制命令 | 12 |
| 确认消息 | 13 |
| 配置定位信标 UUID | 14 |
| 配置资产信标 UUID | 15 |
| 配置透传信标过滤器 | 16 |
| 配置需确认信标列表 | 17 |
# 参数设置
| 字节 | 1 | 1 | 1 | 1 | |
|---|---|---|---|---|---|
| 内容 | MSGID | TYPE | VALUE | TYPE | ... |
可以同时配置多个参数，TYPE 从 1 到 17。例如：要将发送功率设置为 15dbm，数据速率设置为 DR3，消息可以是：0x000101022。 所有支持的类型如下所示：
TX Power Type：1
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 1~0 | 发送功率 | 0~3 | 配置发射功率。 0：17dbm 1：15dbm 2：13dbm 3：11dbm 其它值将被忽略。 |
Data Rate Type：2
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 1~0 | 通信速率 | 0：DR5 1：DR4 2：DR3 | 工卡为运动型设备，运动时低速率通信容易引起丢包，所以低速率的 DR2 到 DR0 未开启，速率自适应也未打开。 设备默认按 DR5 工作，若设备与基站距离较远，信号较差，可以将速率设成 DR3，但相应的功耗会增加。 |
AUREPORT Type：3
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 0 | 自动上报 | 0：关闭 1：开启 | 指示工卡是否在静态情况下扫描蓝牙。 |
BLE Type：4
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 3~0 | 蓝牙上报周期 | 0：关闭 BLE 1：5 秒 2：10 秒 3：20 秒 4：30 秒 5：1 分钟 6：2 分钟 7：5 分钟 8：10 分钟 9：15 分钟 10：20 分钟 11：30 分钟 12：1 小时 13：2 小时 14：6 小时 15：12 小时 | 更改 BLE 扫描的周期。 |
SCAN Type：5
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 2~0 | 扫描时长 | 0：1 秒 1：2 秒 2：3 秒 3：6 秒 4：9 秒 5：12 秒 6：15 秒 7：持续 | 一个周期内的连续 BLE 扫描时间。 如果设备是网关并由外部电源供电，则扫描可以设置为 7。 |
SCALE Type：6
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 1~0 | 扫描类型 | 0~3 | 指示将扫描哪种信标类型。 具体请参考上行心跳消息中的字段说明。 |
STEPSOFF Type：7
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 2~0 | 步数门限 | 0~7 | 当 BLE 扫描周期已达到，但移动步数小于此值时，将不会启动 BLE 扫描。 单位：5 步。 如果 BLEOFF 为 0，STEPSOFF 将不生效。 |
BLEOFF Type：8
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 2~0 | 蓝牙门限 | 0~7 | 如果扫描的信标与上一次相同，将停止报告 BLE 数据，直到 BLEOFF 次周期后。 |
BUZZER Type：9
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 0 | 蜂鸣器 | 0：禁用 1：启用 | 禁用或启用蜂鸣器。 只影响相邻工卡检测时的行为，不影响告警或开关机时蜂鸣器的工作。 |
VIBRATOR Type：10
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 0 | 振动器 | 0：禁用 1：启用 | 禁用或启用振动器。470M 工卡不含振动器。 |
DISTANCE Type：11
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 3~0 | 距离 | 0：2 米 1：4 米 2：6 米 3：8 米 4：10 米 5：15 米 6：>15 米 | 当两个工卡接近这个距离时，蜂鸣器会发出蜂鸣声或振动器会振动。 |
PROXIMITY Type：12
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 0 | 工卡检测 | 0：禁用 1：启用 | 是否启用相邻工卡检测功能，如果启用，它将定期广播 BLE 信号，同时它还将检测其它工卡的 BLE 信号。 |
GNSS Type：13
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 3~0 | 周期 | 0：禁用 GPS/北斗 1：5 秒 2：10 秒 3：15 秒 4：30 秒 5：60 秒 6：150 秒 7：5 分钟 8：15 分钟 9：30 分钟 10：1 小时 11：1.5 小时 12：3 小时 13：6 小时 | GPS/北斗定位周期。 |
HEARTBEAT Type：14
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 3~0 | 心跳周期 | 0：1 分钟 1：5 分钟 2：10 分钟 3：20 分钟 4：30 分钟 5：1 小时 6：2 小时 7：6 小时 8：12 小时 9：24 小时 | 心跳消息周期，心跳消息不受运动或静止影响，始终上报 |
TIME Type：15
废弃。用户服务器发送时间同步命令，由设备向网络服务器发起时间同步。
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 23~16 | 小时 | 0~23 | 设置设备当前时间 |
| 15~8 | 分钟 | 0~59 | 设置设备当前时间 |
| 7~0 | 秒 | 0~59 | 设置设备当前时间 |
SLEEP Type：16
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 23~16 | 睡眠程度 | 0~7 | 休眠程度 |
| 15~8 | 开始时间 | 0~23 | 休眠开始时间 |
| 7~0 | 结束时间 | 0~23 | 休假结束时间 |
当设备启动时，即使配置了开始和结束，它也不会立即进入睡眠模式，这些参数只在启动后 10 分钟才生效。这种策略使服务器有机会通过重新启动设备并发送新配置将设备从睡眠模式恢复到活动模式。
THRES Type：17
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 2~0 | 蓝牙扫描范围 | 0：无限制 1：-90dbm 2：-87dbm 3：-84dbm 4：-81dbm 5：-78dbm 6：-75dbm 7：-72dbm | 若信标信号强度小于该值，将被忽略。 |
BLEACK Type：18
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~1 | 保留 | ||
| 0 | 需确认 | 0：Disable 1：Enable |
# BLE 扫描开始时间
该命令用于让设备提前启动 BLE 扫描。
| 字节 | 1 | 2 |
|---|---|---|
| 内容 | MSGID | TIME |
TIME
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | 秒 | 0~65535 | 指示设备应提前多少秒发送数据。 |
# 控制命令
| 字节 | 1 | 2 |
|---|---|---|
| 内容 | MSGID | CMD |
工卡收到命令后，将向应用服务器发送带有相同 MSGID 的确认。应用服务器应该保持一个定时器来重新发送以保证终端收到命令，定时器间隔应该根据上行消息的周期来设置。下行消息能够在接收到若干上行消息之后被发送到工卡，如果此后没有从工卡接收到确认，则下行消息可能丢失。
CMD
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 3~0 | 控制命令 | 0~9 | 请求命令。 0：用于请求定位器发送位置，即使设备是静态的。 1：用于重启设备。 2：用于关闭设备。 3：用于触发蜂鸣发声。 4：用于停止蜂鸣器发声。 5：用于获取扩展的定位信标 UUID。 6：用于获取扩展的资产信标 UUID 列表。 7：用于获取透传蓝牙的配置信息。 8：用于获取需确认蓝牙信息列表。 9：用于触发设备时间同步。 |
# 确认消息
用于确认上行消息。
| 字节 | 1 |
|---|---|
| 内容 | MSGID |
MSGID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | MSGID | 0~255 | 消息标识 |
# 配置定位信标 UUID
用于配置第三方定位信标 UUID，可以同时设置多个。要重置相应位置的配置，UUID 可以设置为 0xffffff…或 0x000000。
| 字节 | 1 | 1 | 1 | 16 | |
|---|---|---|---|---|---|
| 内容 | MSGID | NUMBER | INDEX | UUID | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 1~5 | 配置的 UUID 数。最多支持五个。 |
INDEX
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 索引 | 0~4 | 列表中 UUID 更改的位置。 |
UUID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 127~0 | UUID | 32 位 16 进制数 | UUID |
# 配置资产信标 UUID
用于配置第三方资产信标 UUID，可以同时设置多个。要重置相应位置的配置，UUID 可以设置为 0xffffff…或 0x000000。
| 字节 | 1 | 1 | 1 | 16 | |
|---|---|---|---|---|---|
| 内容 | MSGID | NUMBER | INDEX | UUID | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 数量 | 1~5 | 配置的 UUID 数。最多支持五个。 |
INDEX
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~3 | 保留 | 0 | |
| 2~0 | 索引 | 0~4 | 列表中 UUID 更改的位置。 |
UUID
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 127~0 | UUID | 32 位 16 进制数 | UUID |
# 透传蓝牙过滤器
用于设置定位器的配置，每个消息只能设置一个过滤器。要设置过滤器，结束必须大于开始。要重置过滤器，开始和结束必须设置为 0。
| 字节 | 1 | 1 | 1 | 1 | 1 | 1 | FILTERLEN |
|---|---|---|---|---|---|---|---|
| 内容 | MSGID | PORT | START | END | FILTERSTART | FILTERLEN | FILTER |
PORT
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 端口 | 21~25 | 数据通过 Lora 上传的端口号。该过滤器的数据将从该端口上报。 |
START
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 开始位置 | 0~255 | 从广播消息的此字节开始上报数据。广播消息起始字节为 0。 |
END
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 结束位置 | 0~255 | 广播消息上报的结束字节。 |
FILTERSTART
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 匹配起始地址 | 0~255 | 从广播消息哪个字节开始匹配过滤器。 |
FILTERLEN
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 过滤器长度 | 4~15 | 过滤器长度 |
FILTER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~0 | 过滤器 | 4~15 | 用于匹配广播消息的过滤器 |
# 配置需确认信标列表
| 字节 | 1 | 1 | 2 | 2 | 1 | 2 | 2 | |
|---|---|---|---|---|---|---|---|---|
| 内容 | 数量 | 索引 | MAJOR | MINOR | 索引 | MAJOR | MINOR | ... |
NUMBER
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4~0 | 数量 | 1~20 | 已配置信标的数量。最大支持 20。 |
INDEX
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 7~5 | 保留 | 0 | |
| 4~0 | 索引 | 0~19 |
MAJOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MAJOR | 0~65535 | 所配置信标的 MAJOR 号 |
MINOR
| Bit | 名称 | 取值 | 说明 |
|---|---|---|---|
| 15~0 | MINOR | 0~65535 | 所配置信标的 MINOR 号。 若 MINOR 设为 0，MAJOR 不为 0，则所有为此 MAJOR 号的信标都将被重传。 若 MINOR 和 MAJOR 均为 0，则清除此索引号下的配置。 |
提示
若用户需要在网络服务器下配置解析消息，可联系我们获得 JS 解析脚本，support@edwei.cn