Tracker, 跟踪器。是专门用于监控宿主的位置信息与运动状态, 以及对设备本身信息, 收集与整理后, 将设备信息与宿主信息通过无线网络传送至云端服务器的无线终端设备。
业务逻辑:
- 在云端设置好需要采集的数据信息, 报警信息和控制开关;
- 传感器或内置模块采集对应的数据信息, Quecpython整合好数据后, 通过MQTT协议发送至云端, 云端接收到数据可以进行分析、处理、显示、保存等操作;
- 云端可下发指令到设备模块, 控制模块的数据采集与上报的启用, 禁用和采集周期等。

功能模块

与云端的数据交互功能, 主要包括设备数据信息的上报与云端数据下发控制;
(GPS, 基站)定位位置信息的自动上报功能;
设备异常信息告警功能;
电池电量信息检测与提示功能;

应用场景

物流快递跟踪
生物跟踪定位

支持模组

目前支持Tracker的模组
EC600N_CNLA

Tracker API

Tracker

创建 Tracker 对象

导入Tracker模块
创建Tracker对象

例:

from usr.tracker import Tracker
tracker = Tracker()

alert 告警功能

该功能提供post_alert方法, 将定义好的报警编码与报警信息上报到云端。

tracker.alert.post_alert

例:

import utime
alert_code = 20000
alert_info = {
    'fault_code': 20001,
    'local_time': utime.mktime(utime.localtime())
}
tracker.alert.post_alert(alert_code, alert_info)

参数:

参数	参数类型	参数说明
alert_code	int	报警编码
alert_info	dict	报警信息, key为标识符, value为具体信息

返回值: 无

报警编码与标识符

20000: fault_alert

30002: low_power_alert

30003: over_speed_alert

30004: sim_out_alert

30005: disassemble_alert

40000: drive_behavior_alert

50001: sos_alert

fault_alert故障报警编码与标识符

20001: net_error

20002: gps_error

20003: temp_sensor_error

20004: light_sensor_error

20005: move_sensor_error

20006: mike_error

drive_behavior_alert驾驶行为异常报警编码与标识符

40001: quick_start

40002: quick_stop

40003: quick_turn_left

40004: quick_turn_right

battery 电池功能

改功能提供energy方法查询当前电池电量。

tracker.battery.energy

例:

battery_energy = tracker.battery.energy()

参数: 无

返回值:

返回数据类型	说明
int	电量百分比

locator 定位功能

该功能提供了read和trigger两个方法, 定位模式, 定位方式, 定位信息上报模式在settings模块中配置, 亦可通过云端远程进行消息控制。

read方法用于查询当前发送云端的定位信息。
trigger方法用于立即向云端报告设备定位信息功能。

tracker.locator.read

例:

location_info = tracker.locator.read()

参数: 无

返回值:

返回数据类型	元素	说明
tuple
	0	定位类型(int)
	1	定位信息(list)

tracker.locator.trigger

例:

tracker.locator.trigger()

参数: 无

返回值: 无

remote 信息通信功能

该功能提供了post_data和set_block_io方法向云端进行消息通信功能(目前暂时只支持移远云)。

tracker.remote.post_data

例:

import utime
data = {
    'power_switch': True,
    'energy': tracker.battery.energy(),
    'local_time': utime.mktime(utime.localtime())
}
tracker.remote.post_data(tracker.remote.DATA_NON_LOCA, data)

参数:

参数	参数类型	参数说明
data_type	int	数据类型
data	dict	数据信息

返回值:

返回数据类型	说明
Bool	True:发送成功;False:发送失败

tracker.remote.set_block_io

例:

tracker.remote.set_block_io(False)

参数:

参数	参数类型	参数说明
val	bool	是否阻塞发送消息, 默认True

post_data方法向云端进行消息发送功能。post_data发放支持阻塞和非阻塞两种消息发送模式, 默认为阻塞方式进行消息发送。
set_block_io方法可以设置消息发送的阻塞和非阻塞方式。
移远云目前的消息有三种模式
- DATA_NON_LOCA (非位置信息)
- DATA_LOCA_NON_GPS (非GPS位置信息)
- DATA_LOCA_GPS (GPS位置信息)
移远云物模型功能定义标识符(具体详述见quec_cloud_module.json)
- power_switch
- energy
- phone_num
- loc_method
- loc_mode
- loc_cycle_period
- local_time
- low_power_alert_threshold
- low_power_shutdown_threshold
- sw_ota
- sw_ota_auto_upgrade
- sw_voice_listen
- sw_voice_record
- sw_fault_alert
- sw_low_power_alert
- sw_over_speed_alert
- sw_sim_out_alert
- sw_disassemble_alert
- sw_drive_behavior_alert
- drive_behavior_code
- sos_alert
- fault_alert
- low_power_alert
- sim_out_alert
- drive_behavior_alert
- disassemble_alert
- power_restart
- over_speed_threshold
- over_speed_alert
- fault_code
- gps_mode

tracker_timer 定时器功能

该模块为tracker定时器模块, 该模块实现了三个定时任务

周期性循环发送设备位置信息(此处发送周期和是否周期发送可在settings模块中设置, 可以通过云端下发指令远程控制);
每60秒循环获取当前电池电量进行电量提示, 低电量报警, 地点了关机等检测;
GPS位置信息循环获取, 此功能只针对内置GPS模块, 外置GPS模块该功能不启动。

machine_info_report 机器信息上报功能

该模块实现了机器信息的汇总上报功能, 会将机器的位置信息, 开机状态, 电池电量等相关设置信息全部实时上报云端。

例:

tracker.machine_info_report()

参数: 无

返回值: 无

machine_check 机器自检功能

该功能用于检测设备相关功能是否正常, 主要包括网络状态, GPS模组, 各类传感器, 麦克风是否正常工作(目前暂不支持各类传感器麦克风等外设检测)。如异常会上报远端异常信息。检查完毕后不论异常与否都会调用machine_info_report功能上报云端设备所有信息。

例:

tracker.machine_check()

参数: 无

返回值: 无

settings

该模块为配置参数模块, 该模块主要有app和sys两种类型的参数。并提供settings方法对app类型参数进行修改, 从而实现远程下发指令控制模块功能。

settings 导入

例:

from usr.settings import settings

init 初始化

例:

settings.init()

参数: 无

返回值: 无

get 获取配置参数

例:

current_settings = settings.get()

参数: 无

返回值:

返回数据类型	说明
dict	字典参数(见下方备注)

query 发送设置参数至云端

例:

from usr.remote import Remote
remote = Remote()
set_type = 'app'
set_key = 'phone_num'
settings.query(remote, set_type, set_key)

参数:

参数	参数类型	参数说明
remote	object	Remote对象
set_type	str	app或sys
set_key	str	配置参数标识符

返回值: 无

set 设置配置参数

例:

opt = 'phone_num'
val = '123456789'
settings.set(opt, val)

参数:

参数	参数类型	参数说明
opt	str	配置参数标识符
val	str/bool/int	配置参数属性值

返回值: 无

save 持久化保存配置参数

例:

settings.save()

参数: 无

返回值: 无

reset 重置配置参数

例:

settings.reset()

参数: 无

返回值: 无

备注

app为可修改控制相关参数;
sys为系统默认参数, 不可修改。
配置参数都已集成到一个字典中, 可通过settings.get()方式获取到具体配置参数
app配置参数具体含义见quec_cloud_module.json(导入移远云产品功能定义中)

settings.get() 返回值

{
    "app": {
        "loc_cycle_period": 1,
        "phone_num": "",
        "loc_method": 1,
        "loc_mode": 0,
        "low_power_alert_threshold": 20,
        "low_power_shutdown_threshold": 5,
        "sw_over_speed_alert": true,
        "over_speed_threshold": 120,
        "sw_disassemble_alert": true,
        "sw_fault_alert": true,
        "sw_low_power_alert": true,
        "sw_voice_record": false,
        "sw_voice_listen": false,
        "sw_sim_out_alert": true,
        "gps_mode": 2,
        "sw_drive_behavior_alert": true,
        "sw_ota": true,
        "sw_ota_auto_upgrade": true
    },
    "sys": {
        "cloud": 1,
        "profile_idx": 1,
        "cloud_init_params": {
            "DK": "XXXXX",
            "DS": "XXXXX",
            "PK": "XXXXX",
            "PS": "XXXXX"
        },
        "locator_init_params": {
            "gps_cfg": {
                "parity": 0,
                "stopbits": 1,
                "flowctl": 0,
                "UARTn": 1,
                "buadrate": 115200,
                "databits": 8
            }
        }
    }
}