SWSD004
v3.0.1
Die Lora Edge Tracker-Referenzdesign Demonstrationsanwendung zeigt eine vollwertige Tracker-Anwendung, die auf LORA-Basics-Modem und Geolocation Middlewares basiert:
Die Anwendungen erfordern, dass der LR1110 die Transceiver -Firmware -Version 0x0401 oder höher ausführt. Um den LR1110 auf die neueste Firmware -Version zu aktualisieren, verwenden Sie bitte die in diesem Projekt enthaltene Aktualisierungsmodem -Firmware -Anwendung. Die neueste Firmware kann von einem anderen Repository erhalten werden.
Anwendungen zeigen normalerweise die erkannte LR1110 -Firmware -Version in der seriellen Konsole zu Beginn an.
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
Wenn das LR1110 aktualisiert werden muss, aktualisiert die Anwendungen main_tracker_update_lr1110.c die Firmware LR1110. Die neue Firmware wird von der UART empfangen.
Bitte lesen Sie die Bewerbungsdokumentation für weitere Informationen.
Dieser Abschnitt enthält eine kurze Erläuterung, wie Sie den Tracker einrichten und mit der zugehörigen mobilen Anwendung Lora Edge ™ -Konfiguration verbinden. Weitere Details finden Sie auf dem Semtech Lora Edge ™ Tracker -Referenzdesign.
Tippen Sie auf Ich akzeptiere, um die Softwarelizenzvereinbarung zu akzeptieren.
Wählen Sie im Pop-up-Fenster von Almanac URL die Standard-Almanach-URL aus, oder erweiterte Benutzer können sich in eine andere URL ändern. Der Almanach wird automatisch heruntergeladen.
Um die Standard -Almanac -URL (https://mgs.loracloud.com) zu verwenden, klicken Sie später.
Klicken Sie jetzt, um die Almanach -URL zu ändern, jetzt auf Änderung und geben Sie die URL des Almanac ein, die Sie verwenden möchten.
Klicken Sie auf Start Scan 
(Android) oder 
(iOS) und erlauben Sie die Lora Edge -Konfiguration, auf den Speicherort Ihres mobilen Geräts zuzugreifen.
Wenn das rote LED blinkt, befindet sich das Lora Edge Tracker -Referenzdesign im Paarungsmodus. Es bleibt 30 Sekunden in diesem Modus.
Öffnen Sie in der mobilen App den Scannerbildschirm. Der Name Ihres Lora Edge Tracker -Referenzdesigns wird angezeigt. Die letzten vier Ziffern sind die Deveui LSB. Dies muss mit dem auf dem Tracker -Etikett gedruckten Deveui übereinstimmen.
Tippen Sie auf SMTC_TKR_XXXX, um das LORA Edge Tracker -Referenzdesign mit der mobilen Anwendung zu verbinden. Sobald eine Verbindung hergestellt ist, blinzelt die rote LED stoppt und schaltet fest. Der Tracker aktualisiert automatisch die folgenden, wenn Updates verfügbar sind:
Wenn das Firmware -Update abgeschlossen ist, wird der Message Tracker aktuell angezeigt.
Sobald Sie verbunden sind, machen Sie die folgenden Schritte in der Reihenfolge:
Die Trackeroperation startet dann. Sie können die App vom Lora Edge Tracker -Referenzdesign trennen. Um zu trennen, klicken Sie auf das linke Wüschungssymbol: 
(Android), 
(iOS).
Die Anwendung kann mit 'LORA Edge ™ -Konfiguri' Android und iOS -App auf einem kompatiblen Smartphone konfiguriert werden. Die Kommunikation zwischen dem Smartphone und der Tracker -Anwendung verwendet die drahtlose Bluetooth Low Energy (BLE). Die Tracker -Anwendung beginnt mit der Werbung beim Start und dann, wenn sie dann das Vorhandensein eines Magneten erkennt. Es stoppt die Werbung nach 30 Sekunden, wenn es nicht gepaart wird. Der Zeitüberschreitungswert wird durch die Konstante TRACKER_ADV_TIMEOUT_MS konfiguriert.
Der Tracker kann auch von Lorawan Downlink konfiguriert werden.
Die folgenden Parameter können konfiguriert werden:
| Parameter | Bloß | Lorawan |
|---|---|---|
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 | ✔️ | ✔️ |
Die apps/common/lorawan_key_config.h -Header -Datei definiert mehrere Konstanten, um die Lorawan -Parameter (Region, Schlüssel) zu konfigurieren.
| Konstante | Kommentare |
|---|---|
LORAWAN_REGION | Wählt die Regulierungsregion aus |
LORAWAN_CLASS | Wählt die zu verwendende Lorawan -Klasse aus |
Unterstützte Werte für 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 Unterstützte Werte für LORAWAN_CLASS :
SMTC_MODEM_CLASS_A Der LR1110 ist mit einem Chipeui/Deveui und einem JOINEUI vorbereitet. Die Anwendung verwendet diese Kennungen, da der Code mit dem Flag CRYPTO=LR11XX_WITH_CREDENTIALS zusammengestellt wird und der Parameter Use Semtech Join Server mode standardmäßig auf true eingestellt ist.
Um die Beispielanwendung für den STM32WB55 -Controller der Tracker -Karte zu erstellen, benötigen Sie:
Die Demo muss mit zwei Binärdateien programmiert werden:
BLE_Ota.bintracker_application_autonomous.binDie Demo kann durch GNU Make -Befehl erstellt werden, indem Sie Folgendes erstellen:
# Navigate to the build folder
$ cd apps/tracker_application/makefile
# Execute the make call
$ make -j Der Bootloader BLE_Ota.bin ist für die Ausführung der Tracker -Anwendung obligatorisch. Die Binärdatei des Bootloaders befindet sich in apps/tracker_application/bin -Ordner und muss unter der Adresse 0x08000000 programmiert werden.
Zum Beispiel (mit STM32_Programmer_Cli):
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbinBLE_Ota.bin" 0x08000000
unter Linux
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/BLE_Ota.bin 0x08000000
Die Anwendungs tracker_application_autonomous.bin befindet sich in apps/tracker_application/makefile/build -Ordner, sie muss unter der Adresse 0x08007000 programmiert werden
Zum Beispiel (mit STM32_Programmer_Cli): unter 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
unter 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
HINWEIS: Standardmäßig wird die Demonstration für den vorverwalteten LR1110-Chipeui/Deveui und Joineui zusammengestellt. Die unterstützten Anwendungsnamen sind tracker_application_autonomous , uart_firmware_update .
Hier die Abbildung der Flash -Sektor der Demonstration
| Sektor | Kontexttyp |
|---|---|
| 1 bis 6 | Bootloader |
| 7 zum Anwendung Flash End | Tracker -Anwendung |
| Anwendung Flash End bis 194 | Internes Protokoll |
| 164 | Addr_flash_store_and_forward |
| Sektor Flash End bis 193 | Speicher und vorwärts |
| 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 | Nicht benutzt |
| 202 | Flash_user_modem_e_tracker_context |
Sektor (en) zu löschen:
./STM32_Programmer_CLI.exe -c port=SWD -e [n m]
Zum Beispiel zum Löschen der vollständigen Anwendung + zugehörige Kontexte:
./STM32_Programmer_CLI.exe -c port=SWD -e [8 202]
Die Anwendung erfordert keine Benutzerintervention, nachdem die statische Konfigurationsoption festgelegt wurde.
Verwenden Sie eine Terminalanwendung, die mit den folgenden Einstellungen konfiguriert ist:
Geschwindigkeit: 921600 Baud Data Bits: 8S Stopp -Bits: 1 Parität: Keine
Informationsnachrichten werden auf der seriellen Konsole angezeigt, beginnend mit Deveui, Appeui/Joineui und PIN, die Sie möglicherweise benötigen, um Ihr Gerät mit dem LORA Cloud -Geräte -Join -Dienst zu registrieren.
Diese Anwendung benötigt einen Anwendungsserver zum Ausführen, um die GNSS- und Wi-Fi-Lösung durchzuführen.
Die adaptive Datenrate (ADR) ist im benutzerdefinierten ADR -Profil mit der Datenaratverteilung und der Anzahl der pro Regionen definierten Wiederholungen konfiguriert.
Das tatsächliche Datenarat und die Anzahl der Übertragungswerte sind in der Datei main_tracker_application_autonomous.c definiert.
Die Werte müssen sorgfältig festgelegt werden, um mit den Einschränkungen des Arbeitszyklus, den Stromverbrauchszielen usw. übereinzustimmen.
Hier folgen Sie den Schritten, die in den Protokollen zu sehen sind, um das erwartete Verhalten der Anwendung anzuzeigen.
Standardmäßig sollte das Gerät eine Position alle zwei Minuten, unabhängig von der ausgewählten Region, senden.
INFO: Modem Initialization
###### ===== LoRa Basics Modem Tracker application ==== ######
Nach diesem Druck finden Sie Bewerbungs- und Parameterdrucke
Zuerst soll keine Zeit verfügbar sein
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
In der anfänglichen Standardkonfiguration wird das Tracker -Gerät in den Flugzeugmodus gesteckt. In diesem Modus verbindet das Gerät nicht automatisch dem Lorawan -Netzwerk. Der Hall -Sensor -Effekt ist auch nur für kurze Zeit aktiviert, wenn der Tracker eine Bewegung erkennt. Das Gerät kann mit der LORA Edge ™ -Konfigurationsanwendung aus dem Flugzeugmodus herausgenommen werden.
Wenn die Batterien erschöpft sind, wird das Gerät automatisch im Flugzeugmodus wieder eingesetzt.
Der Hall -Effect -Sensor wird als Schalter verwendet, um die BLE -Werbung zu starten. Es wird aktiviert, wenn der Benutzer einen Magneten in der Nähe platziert. Im Flugzeugmodus ist der Hall-Effekt-Sensor nur beim Start aktiv und während eines 60-Sekunden-Intervalls aktiv, wenn der Tracker eine Bewegung erkennt. Die Aktivierungsdauer wird durch die Konstante TRACKER_HALL_TIMEOUT_MS konfiguriert.
| ❗ Wenn der Hall -Effekt -Sensor einen Schild erkennt, setzt er den Tracker zurück, um den BLE zu starten. Der Ble läuft nicht parallel zum Lora -Grundlagenmodem |
|---|
Auf der Lora Edge Tracker-Referenzdesign-Karte befindet sich eine Bi-Farb-LED:
Die gelbe Komponente wird dann als RX -LED bezeichnet und die rote Komponente ist die TX -LED.
Die Anwendung verwendet die LED des Lora Edge Tracker -Referenzdesigns, um die folgenden Ereignisse anzuzeigen:
LED_PERIOD_MS konfiguriert werden.LED_PERIOD_MS konfiguriert werden. 
