SWSD004
v3.0.1
Lora边缘跟踪器参考设计演示应用程序说明了基于Lora Basics Modem和GeoLocation Middlewares的完整的跟踪器应用程序：
应用程序要求LR1110运行收发器固件版本0x0401或更高版本。要将LR1110更新为最新的固件版本，请使用此项目中包含的更新调制解调器固件应用程序。最新的固件可以从另一个存储库中获得。
应用程序启动时通常在串行控制台中显示检测到的LR1110固件版本。
LR11XX FW : 0x0401
INFO: ###### ===== LoRa Basics Modem Tracker application ==== ######
APP VERSION : 3.0.0
INFO: ###### ===== LoRa Basics Modem Version ==== ######
INFO: LoRaWAN version: 01.00.04.01
如果需要更新LR1110，则应用程序main_tracker_update_lr1110.c更新LR1110固件。新固件将从UART收到。
请阅读申请文档以获取更多详细信息。
本节提供了如何设置跟踪器并将其与关联的移动应用程序Lora Edge™配置连接的快速说明。有关其他详细信息，请参阅设置Semtech Lora Edge™跟踪器参考设计。
点击我接受接受软件许可协议。
在“年鉴URL弹出窗口”中，选择默认的年鉴URL或高级用户可能会更改为其他URL。年鉴自动下载。
要使用默认的年鉴URL（https://mgs.loracloud.com），请稍后单击。
要更改年鉴URL，请立即单击“更改”，然后输入要使用的年鉴的URL。
单击“开始扫描” 
（Android）或
（iOS），并允许Lora Edge配置访问移动设备的位置。
当红色LED眨眼时，Lora边缘跟踪器参考设计处于配对模式。它在此模式下保持30秒。
在移动应用程序中，打开扫描仪屏幕。显示了Lora边缘跟踪器参考设计的名称。最后四位数字是Deveui LSB。这必须与在跟踪器标签上打印的DEVEUI相同。
点击SMTC_TKR_XXXX，将Lora边缘跟踪器参考设计与移动应用程序连接。建立连接后，红色LED将停止闪烁并以实心切换。跟踪器会自动更新以下内容，如果有可用的情况：
固件更新完成后，消息跟踪器最新显示。
连接后，按以下步骤按顺序进行：
然后开始进行跟踪器操作。您可以从Lora边缘跟踪器参考设计中断开该应用程序。要断开连接，请单击左箭头图标： 
（安卓）， 
（ios）。
可以使用在兼容智能手机上运行的“ Lora Edge™配置” Android和iOS应用程序配置该应用程序。智能手机和跟踪器应用程序之间的通信使用蓝牙低能（BLE）无线技术。跟踪器应用程序开始在启动时开始广告，然后每当发现磁铁的存在时。不配对时，它会在30秒后停止广告。超时值由TRACKER_ADV_TIMEOUT_MS常数配置。
也可以通过Lorawan Downlink配置跟踪器。
可以配置以下参数：
| 范围 | ble | 洛万 |
|---|---|---|
LoRaWAN Device EUI | ✔️ | |
LoRaWAN Join EUI | ✔️ | |
LoRaWAN Application Key | ✔️ | |
Use Semtech Join Server mode | ✔️ | |
Update almanac | ✔️ | |
GNSS constellation | ✔️ | ✔️ |
GNSS antenna | ✔️ | ✔️ |
Airplane mode | ✔️ | |
Use accelerometer | ✔️ | ✔️ |
Scan interval when tracker is moving | ✔️ | ✔️ |
Scan interval when tracker is static | ✔️ | ✔️ |
Reset accumulative charge | ✔️ | ✔️ |
Reset board | ✔️ | ✔️ |
apps/common/lorawan_key_config.h头文件定义了几个常数以配置lorawan参数（区域，密钥）。
| 持续的 | 评论 |
|---|---|
LORAWAN_REGION | 选择监管区域 |
LORAWAN_CLASS | 选择要使用的洛万班 |
LORAWAN_REGION的支持值：
SMTC_MODEM_REGION_EU_868 (default)SMTC_MODEM_REGION_US_915SMTC_MODEM_REGION_AS_923_GRP1SMTC_MODEM_REGION_AU_915SMTC_MODEM_REGION_CN_470SMTC_MODEM_REGION_AS_923_GRP2SMTC_MODEM_REGION_AS_923_GRP3SMTC_MODEM_REGION_IN_865SMTC_MODEM_REGION_KR_920SMTC_MODEM_REGION_RU_864 LORAWAN_CLASS的支持值：
SMTC_MODEM_CLASS_ALR1110由chipeui/deveui和joineui预先提供。该应用程序将使用这些标识符，因为代码是用flag CRYPTO=LR11XX_WITH_CREDENTIALS编译的，并且默认情况下，参数Use Semtech Join Server mode设置为true。
要构建跟踪板的STM32WB55控制器的示例应用程序，您将需要：
该演示需要用两个二进制文件编程：
BLE_Ota.bintracker_application_autonomous.bin该演示可以通过GNU Make命令进行以下操作来构建：
# Navigate to the build folder
$ cd apps/tracker_application/makefile
# Execute the make call
$ make -jBootloader BLE_Ota.bin必须运行Tracker应用程序，Boot Loader的二进制文件位于apps/tracker_application/bin文件夹中，必须在0x08000000地址上对其进行编程。
例如（使用stm32_programmer_cli）：
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbinBLE_Ota.bin" 0x08000000
在Linux上
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/BLE_Ota.bin 0x08000000
应用程序tracker_application_autonomous.bin位于apps/tracker_application/makefile/build文件夹中，必须在0x08007000地址上对其进行编程
例如（使用stm32_programmer_cli）：在Windows上：
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbintracker_application_autonomous.bin" 0x08007000
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationmakefilebuildtracker_application_autonomous.bin" 0x08007000
在Linux上
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/tracker_application_autonomous.bin 0x08007000
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/makefile/build/tracker_application_autonomous.bin 0x08007000
注意：默认情况下，进行了演示，以使用LR1110预先提供的Chipeui/Deveui和Joineui。支持的应用程序名称为tracker_application_autonomous ， uart_firmware_update 。
在这里，演示的闪存扇区映射
| 部门 | 上下文类型 |
|---|---|
| 1至6 | 引导加载程序 |
| 7到应用程序闪光灯端 | 跟踪器应用程序 |
| 应用闪光灯到194 | 内部日志 |
| 164 | addr_flash_store_and_forward |
| 扇区闪存到193 | 存储和向前 |
| 194 | flash_user_internal_log_context |
| 195 | addr_flash_modem_key_context |
| 196 | flash_user_tracker_context |
| 197 | addr_flash_secure_element_context |
| 198 | addr_flash_devnonce_context |
| 199 | addr_flash_lorawan_context |
| 200 | addr_flash_modem_context |
| 201 | 未使用 |
| 202 | flash_user_modem_e_tracker_context |
擦除部门：
./STM32_Programmer_CLI.exe -c port=SWD -e [n m]
例如，删除完整的应用程序 +关联的上下文：
./STM32_Programmer_CLI.exe -c port=SWD -e [8 202]
设置静态配置选项后，该应用程序不需要用户干预。
使用具有以下设置配置的终端应用程序：
速度：921600波特数据位：8S停止位：1平价：无
信息消息显示在串行控制台上，从DEVEUI，APPEUI/JOINEUI和PIN开始，您可能需要将其注册到Lora Cloud Device Join Service中。
该应用程序需要运行的应用程序服务器才能执行GNSS和Wi-Fi求解。
自适应数据速率（ADR）是在自定义ADR配置文件中配置的，并具有数据分布和每个区域定义的重复数量。
实际的数据和重传值的数量是在main_tracker_application_autonomous.c文件中定义的。
必须仔细设置这些值，以与占空比限制，功耗目标等匹配...
这里遵循日志中应看到的步骤，以指示应用程序的预期行为。
默认情况下，设备应每两分钟发送一次位置。
INFO: Modem Initialization
###### ===== LoRa Basics Modem Tracker application ==== ######
遵循此打印后，您将找到应用程序和参数打印
起初不应该有时间可用
INFO: ###### ===== JOINED EVENT ==== ######
New scan group for assisted scan
INFO: RP_TASK_GNSS - new scan group - task queued at 461083 + 120000
---- internal scan start ----
---- internal scan start ----
INFO: ###### ===== MIDDLEWARE_1 EVENT ==== ######
INFO: GNSS middleware event - SCAN DONE
SCAN_DONE info:
-- token: 0x07
-- is_valid: 1
-- number of valid scans: 4
-- scan[0][1335796859] (10 SV): 8247EA010A01567378AFF1C58A85C9DAAC54199BD49A4C2245D6E833409C1A89B0020B00
SV_ID 26: 46dB
SV_ID 7: 45dB
SV_ID 15: 43dB
SV_ID 6: 42dB
SV_ID 9: 42dB
SV_ID 89: 42dB
SV_ID 20: 40dB
SV_ID 99: 39dB
SV_ID 92: 38dB
SV_ID 108: 37dB
-- scan[1][1335796883] (10 SV): 8249EA010A01567338BBF07532486A9F4CD31D5CD41D3D2205571672D2625627B2CDCD0D
SV_ID 26: 46dB
SV_ID 7: 46dB
SV_ID 15: 44dB
SV_ID 92: 43dB
SV_ID 9: 42dB
SV_ID 89: 42dB
SV_ID 98: 41dB
SV_ID 6: 41dB
SV_ID 108: 41dB
SV_ID 20: 40dB
-- power consumption: 16 uah
-- mode: 1
-- assisted: 1
-- aiding position: (45.131836, 5.888672)
-- almanac CRC: 0X6A820509
# (...Several TX...)
---- internal TX DONE ----
INFO: ###### ===== MIDDLEWARE_1 EVENT ==== ######
INFO: GNSS middleware event - TERMINATED
TERMINATED info:
-- number of scans sent: 2
INFO: RP_TASK_WIFI - new scan - task queued at 40097 + 30000
---- internal Wi-Fi scan start ----
INFO: start Wi-Fi scan
WARN: No time available.
INFO: ###### ===== MIDDLEWARE_2 EVENT ==== ######
INFO: Wi-Fi middleware event - SCAN DONE
SCAN_DONE info:
-- number of results: 3
-- power consumption: 0 uah
-- Timestamp: 0
64 70 02 D9 94 55 -- Channel: 1 -- Type: 1 -- RSSI: -78
3C 17 10 B7 CD 90 -- Channel: 6 -- Type: 1 -- RSSI: -88
74 B6 B6 42 B4 EB -- Channel: 1 -- Type: 2 -- RSSI: -87
---- internal TX DONE ----
INFO: ###### ===== MIDDLEWARE_2 EVENT ==== ######
INFO: Wi-Fi middleware event - TERMINATED
TERMINATED info:
-- number of scans sent: 1
INFO: ###### ===== DOWNLINK EVENT ==== ######
Rx window: 2
Rx port: 151
Rx RSSI: -66
Rx SNR: 11
INFO: Downlink received:
INFO: - LoRaWAN Fport = 151
INFO: - Payload size = 7
INFO: - RSSI = -66 dBm
INFO: - SNR = 11 dB
INFO: - Rx window = SMTC_MODEM_EVENT_DOWNDATA_WINDOW_RX2
Payload - (6 bytes):
4C 05 01 26 01 00 77
INFO: ###### ===== TRACKER CONFIGURATION SETTINGS PAYLOAD RECEIVED ==== ######
tx_max_payload 242
- Tracker settings (7 bytes) : Send data
初始默认配置使跟踪器设备处于飞机模式。在此模式下，该设备不会自动加入Lorawan网络。每次跟踪器检测运动时，也仅在短时间内启用霍尔传感器效应。可以使用Lora Edge™配置应用程序从飞机模式中取出该设备。
当电池耗尽时，将自动将设备放回飞机模式。
霍尔效应传感器用作启动广告的开关。当用户在附近放置磁铁时，它会被激活。在飞机模式下，当追踪器检测到运动时，HALL效应传感器仅在启动时和60秒间隔内活跃。激活持续时间由TRACKER_HALL_TIMEOUT_MS常数配置。
| ❗当霍尔效应传感器检测到屏蔽层时，它会重置跟踪器以启动BLE。 BLE并非与Lora Basics Modem并行运行 |
|---|
Lora边缘跟踪器参考设计板上有一个双色LED：
然后将黄色组件称为RX LED，红色组件是TX LED。
该应用程序使用Lora边缘跟踪器参考设计的LED显示以下事件：
LED_PERIOD_MS常数配置。LED_PERIOD_MS常数配置。 
