SWSD004
v3.0.1
L'application de démonstration de conception de référence LORA Edge Tracker illustre une application de tracker complète basée sur le modem Lora Basics et Geolocation Middlewares:
Les applications exigent que le LR1110 exécute la version du micrologiciel de l'émetteur-récepteur 0x0401 ou ultérieure. Pour mettre à jour le LR1110 vers la dernière version du firmware, veuillez utiliser l'application de micrologiciel de mise à jour incluse dans ce projet. Le dernier firmware peut être obtenu à partir d'un autre référentiel.
Les applications affichent généralement la version détectée du micrologiciel LR1110 dans la console série lorsqu'elles commencent.
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
Si le LR1110 doit être mis à jour, les applications main_tracker_update_lr1110.c mettent à jour le firmware LR1110. Le nouveau firmware est reçu de l'UART.
Veuillez lire la documentation de la demande pour plus de détails.
Cette section fournit une explication rapide de la façon de configurer le tracker et de le connecter avec l'application mobile associée, Lora Edge ™ Config. Pour plus de détails, voir Configurer la conception de référence du tracker Semtech Lora Edge ™.
Appuyez sur j'accepte d'accepter le contrat de licence logicielle.
Dans la fenêtre pop-up URL Almanac, sélectionnez l'URL almanac par défaut ou les utilisateurs avancés peuvent passer à une URL différente. L'almanac est téléchargé automatiquement.
Pour utiliser l'URL Almanac par défaut (https://mgs.loracloud.com) cliquez plus tard.
Pour modifier l'URL de l'almanach, cliquez sur Modifier maintenant et entrez l'URL de l'almanac que vous souhaitez utiliser.
Cliquez sur Démarrer la numérisation 
(Android) ou 
(iOS) et permettez à Lora Edge Config d'accéder à l'emplacement de votre appareil mobile.
Lorsque la LED rouge clignote, la conception de référence LORA Edge Tracker est en mode jumelage. Il reste dans ce mode pendant 30 secondes.
Dans l'application mobile, ouvrez l'écran du scanner. Le nom de votre conception de référence Lora Edge Tracker s'affiche. Les quatre derniers chiffres sont le Deveui LSB. Cela doit être le même que le Deveui imprimé sur l'étiquette du tracker.
Appuyez sur SMTC_TKR_XXXX pour connecter la conception de référence LORA Edge Tracker avec l'application mobile. Une fois qu'une connexion est établie, la LED rouge est censée clignoter et changer de solide. Le tracker met automatiquement à jour les éléments suivants, si des mises à jour sont disponibles:
Une fois la mise à jour du firmware terminé, le tracker de messages à jour s'affiche.
Une fois connecté, prenez les mesures suivantes, dans l'ordre:
L'opération de tracker démarre alors. Vous pouvez déconnecter l'application de la conception de référence LORA Edge Tracker. Pour déconnecter, cliquez sur l'icône de la flèche gauche: 
(Androïde), 
(iOS).
L'application peut être configurée à l'aide de l'application Android «Lora Edge ™ Config» et iOS fonctionnant sur un smartphone compatible. La communication entre le smartphone et l'application Tracker utilise la technologie sans fil Bluetooth Low Energy (BLE). L'application Tracker commence à faire de la publicité au démarrage, puis chaque fois qu'elle détecte la présence d'un aimant. Il cesse de publicité après 30 secondes lorsqu'il n'est pas jumelé. La valeur de délai d'expiration est configurée par la constante de TRACKER_ADV_TIMEOUT_MS .
Le tracker peut également être configuré par Lorawan.
Les paramètres suivants peuvent être configurés:
| Paramètre | Bordel | 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 | ✔️ | ✔️ |
Le fichier d'en-tête apps/common/lorawan_key_config.h définit plusieurs constantes pour configurer les paramètres Lorawan (région, clés).
| Constante | Commentaires |
|---|---|
LORAWAN_REGION | Sélectionne la région réglementaire |
LORAWAN_CLASS | Sélectionne la classe Lorawan à utiliser |
Valeurs prises en charge pour 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 Valeurs prises en charge pour LORAWAN_CLASS :
SMTC_MODEM_CLASS_A Le LR1110 est pré-provisoire avec un chipeui / deveui et un joineui. L'application utilisera ces identificateurs car le code est compilé avec le drapeau CRYPTO=LR11XX_WITH_CREDENTIALS et le Use Semtech Join Server mode est défini sur true par défaut.
Pour créer l'exemple d'application pour le contrôleur STM32WB55 de la carte des tracker, vous aurez besoin:
La démo doit être programmée avec deux binaires:
BLE_Ota.bintracker_application_autonomous.binLa démo peut être construite via la commande de GNU en faisant ce qui suit:
# Navigate to the build folder
$ cd apps/tracker_application/makefile
# Execute the make call
$ make -j Le chargeur de démarrage BLE_Ota.bin est obligatoire pour exécuter l'application Tracker, le binaire du chargeur de démarrage est situé dans le dossier apps/tracker_application/bin , il doit être programmé à l'adresse 0x08000000.
Par exemple (avec STM32_Programmer_Cli):
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbinBLE_Ota.bin" 0x08000000
sur Linux
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/BLE_Ota.bin 0x08000000
L'application tracker_application_autonomous.bin est située dans apps/tracker_application/makefile/build , il doit être programmé à l'adresse 0x08007000
Par exemple (avec stm32_programmer_cli): sur 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
sur 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
Remarque: Par défaut, la démonstration est compilée pour utiliser le Chipeui / Deveui et Joineui pré-provisible LR1110. Les noms d'applications pris en charge sont tracker_application_autonomous , uart_firmware_update .
Ici, la cartographie du secteur flash de la démonstration
| Secteur | Type de contexte |
|---|---|
| 1 à 6 | Chargeur de démarrage |
| 7 à l'application Flash End | Application du tracker |
| Application Flash End à 194 | Journal interne |
| 164 | Addr_flash_store_and_forward |
| Flash sectoriel à 193 | Stocker et avancer |
| 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 | Non utilisé |
| 202 | Flash_user_modem_e_tracker_context |
Pour effacer le (s) secteur:
./STM32_Programmer_CLI.exe -c port=SWD -e [n m]
par exemple pour effacer l'application complète + contextes associés:
./STM32_Programmer_CLI.exe -c port=SWD -e [8 202]
L'application ne nécessite aucune intervention de l'utilisateur après la définition de l'option de configuration statique.
Utilisez une application de terminal configurée avec les paramètres suivants:
Vitesse: 921600 Bauds Data Bits: 8s Bits d'arrêt: 1 Parité: Aucun
Les messages d'information sont affichés sur la console série, en commençant par les Deveui, Appeui / Joineui et PIN dont vous pourriez avoir besoin pour enregistrer votre appareil avec le service de jointure de périphérique LORA Cloud.
Cette application a besoin d'un serveur d'applications à exécuter afin d'effectuer la résolution GNSS et Wi-Fi.
Le débit de données adaptatif (ADR) est configuré dans le profil ADR personnalisé avec la distribution de données et le nombre de répétitions définies par régions.
Le données et le nombre réels de valeurs de retransmission sont définis dans le fichier main_tracker_application_autonomous.c .
Les valeurs doivent être soigneusement définies pour correspondre aux contraintes de cycle de service, aux cibles de consommation d'énergie, etc.
Suivez ici les étapes qui doivent être vues dans les journaux pour indiquer le comportement attendu de l'application.
Par défaut, l'appareil doit envoyer une position toutes les deux minutes dans la région sélectionnée.
INFO: Modem Initialization
###### ===== LoRa Basics Modem Tracker application ==== ######
Suite à cette impression, vous trouverez des impressions d'application et de paramètre
À première vue, un moment n'est pas censé être disponible
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
La configuration par défaut initiale met le dispositif de tracker en mode avion. Dans ce mode, l'appareil ne rejoint pas automatiquement le réseau Lorawan. L'effet du capteur Hall n'est également activé que pendant une courte période à chaque fois que le tracker détecte un mouvement. L'appareil peut être retiré du mode avion à l'aide de l'application LORA Edge ™ Config.
Lorsque les batteries sont épuisées, l'appareil est automatiquement remis en mode avion.
Le capteur d'effet Hall est utilisé comme commutateur pour démarrer la publicité BLE. Il est activé lorsque l'utilisateur met un aimant à proximité. En mode avion, le capteur d'effet Hall n'est actif qu'au démarrage et pendant un intervalle de 60 secondes lorsque le tracker détecte un mouvement. La durée d'activation est configurée par la constante TRACKER_HALL_TIMEOUT_MS .
| ❗ Lorsque le capteur à effet Hall détecte un bouclier, il réinitialise le tracker pour démarrer le BLE. Le BLE ne fonctionne pas dans le modem de base de Lora Basics |
|---|
Il y a une LED bi-couleur sur la carte de conception de référence Lora Edge Tracker:
Le composant jaune est ensuite appelé LED Rx et le composant rouge est la LED Tx.
L'application utilise la LED de la conception de référence LORA Edge Tracker pour afficher les événements suivants:
LED_PERIOD_MS .LED_PERIOD_MS . 
