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常數配置。 
