SWSD004
v3.0.1
La aplicación Lora Edge Tracker Reference Demosation ilustra una aplicación de rastreador de funciones completa basada en el módem básico de Lora y Geolocation MiddleWares:
Las aplicaciones requieren que el LR1110 ejecute la versión de firmware del transceptor 0x0401 o posterior. Para actualizar el LR1110 a la última versión de firmware, utilice la aplicación de firmware del módem de actualización incluida en este proyecto. El último firmware se puede obtener de otro repositorio.
Las aplicaciones generalmente muestran la versión de firmware LR1110 detectada en la consola serie cuando comienzan.
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 el LR1110 necesita ser actualizado, las aplicaciones main_tracker_update_lr1110.c actualiza el firmware LR1110. El nuevo firmware se recibe del UART.
Lea la documentación de la aplicación para obtener más detalles.
Esta sección proporciona una explicación rápida de cómo configurar el rastreador y conectarlo con la aplicación móvil asociada, la configuración Lora Edge ™. Para obtener detalles adicionales, consulte Configurar el diseño de referencia Semtech Lora Edge ™ Tracker.
Toque Acepto para aceptar el Acuerdo de Licencia de Software.
En la ventana emergente de URL AlmanaC, seleccione la URL de almanaque predeterminada o los usuarios avanzados pueden cambiar a una URL diferente. El almanaque se descarga automáticamente.
Para usar la URL AlmanaC predeterminada (https://mgs.loracloud.com), haga clic más tarde.
Para cambiar la URL de AlmanaC, haga clic en Cambiar ahora e ingrese la URL del Almanaque que desea usar.
Haga clic en Iniciar escaneo 
(Android) o 
(iOS) y permita que Lora Edge Config acceda a la ubicación de su dispositivo móvil.
Cuando el LED rojo parpadea, el diseño de referencia del rastreador de Lora Edge está en modo de emparejamiento. Permanece en este modo durante 30 segundos.
En la aplicación móvil, abra la pantalla del escáner. Se muestra el nombre de su diseño de referencia de rastreador Lora Edge. Los últimos cuatro dígitos son el Deveui LSB. Esto debe ser lo mismo que el Deveui impreso en la etiqueta del rastreador.
Toque SMTC_TKR_XXXX para conectar el diseño de referencia del rastreador de borde Lora con la aplicación móvil. Una vez que se establece una conexión, el LED rojo deja de parpadear y cambia en sólido. El rastreador actualiza automáticamente lo siguiente, si hay actualizaciones disponibles:
Cuando se completa la actualización del firmware, se muestra el rastreador de mensajes actualizado.
Una vez conectado, tome los siguientes pasos, en orden:
La operación del rastreador luego comienza. Puede desconectar la aplicación del diseño de referencia del rastreador Lora Edge. Para desconectar, haga clic en el icono de la flecha izquierda: 
(Androide), 
(iOS).
La aplicación se puede configurar utilizando la aplicación 'Lora Edge ™ Config' Android e iOS que se ejecuta en un teléfono inteligente compatible. La comunicación entre el teléfono inteligente y la aplicación Tracker utiliza la tecnología inalámbrica Bluetooth Low Energy (BLE). La aplicación Tracker comienza a anunciar al inicio y luego cada vez que detecta la presencia de un imán. Deja de publicidad después de 30 segundos cuando no se combina. El valor del tiempo de espera está configurado por el TRACKER_ADV_TIMEOUT_MS constante.
El rastreador se puede configurar también por Lorawan Downlink.
Se pueden configurar los siguientes parámetros:
| Parámetro | Bolle | 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 | ✔️ | ✔️ |
El archivo de encabezado apps/common/lorawan_key_config.h define varias constantes para configurar los parámetros de Lorawan (región, claves).
| Constante | Comentario |
|---|---|
LORAWAN_REGION | Selecciona la región reguladora |
LORAWAN_CLASS | Selecciona la clase Lorawan para usar |
Valores compatibles para 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 Valores compatibles para LORAWAN_CLASS :
SMTC_MODEM_CLASS_A El LR1110 se propone preprovisión con un Chipeui/Deveui y un Joineui. La aplicación usará estos identificadores porque el código se compila con el indicador CRYPTO=LR11XX_WITH_CREDENTIALS y el parámetro Use Semtech Join Server mode se establece en verdadero de forma predeterminada.
Para crear la aplicación de ejemplo para el controlador STM32WB55 de la placa de rastreador, necesitará:
La demostración debe programarse con dos binarios:
BLE_Ota.bintracker_application_autonomous.binLa demostración se puede construir a través del comando GNU Make haciendo lo siguiente:
# Navigate to the build folder
$ cd apps/tracker_application/makefile
# Execute the make call
$ make -j El gestor de arranque BLE_Ota.bin es obligatorio para ejecutar la aplicación Tracker, el binario del cargador de arranque se encuentra en la carpeta apps/tracker_application/bin , debe programarse en la dirección 0x08000000.
Por ejemplo (con stm32_programmer_cli):
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbinBLE_Ota.bin" 0x08000000
en Linux
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/BLE_Ota.bin 0x08000000
La aplicación tracker_application_autonomous.bin se encuentra en la carpeta apps/tracker_application/makefile/build , debe programarse en la dirección 0x08007000
Por ejemplo (con STM32_Programmer_cli): en 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
en 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
Nota: Por defecto, la demostración se compila para usar el Chipeui/Deveui y Joineui preprovisionados LR1110. Los nombres de aplicaciones compatibles son tracker_application_autonomous , uart_firmware_update .
Aquí el mapeo del sector flash de la demostración
| Sector | Tipo de contexto |
|---|---|
| 1 a 6 | Cargador de arranque |
| 7 para la aplicación Flash End | Aplicación de rastreador |
| Aplicación Flash Fin a 194 | Registro interno |
| 164 | Adr_flash_store_and_forward |
| final del sector Flash a 193 | Almacenar y avanzar |
| 194 | Flash_user_internal_log_context |
| 195 | Adr_flash_modem_key_context |
| 196 | Flash_user_tracker_context |
| 197 | Adr_flash_secure_element_context |
| 198 | Adr_flash_devnonce_context |
| 199 | Adr_flash_lorawan_context |
| 200 | Adr_flash_modem_context |
| 201 | No utilizado |
| 202 | Flash_user_modem_e_tracker_context |
Para borrar el sector (s):
./STM32_Programmer_CLI.exe -c port=SWD -e [n m]
Por ejemplo, para borrar la aplicación completa + contextos asociados:
./STM32_Programmer_CLI.exe -c port=SWD -e [8 202]
La aplicación no requiere intervención de usuario después de que se haya establecido la opción de configuración estática.
Use una aplicación terminal configurada con la siguiente configuración:
Velocidad: 921600 bits de datos de baudios: 8s bits de parada: 1 paridad: ninguno
Los mensajes de información se muestran en la consola serie, comenzando con Deveui, Appeui/Joineui y PIN que puede necesitar para registrar su dispositivo con el servicio de unión del dispositivo Lora Cloud.
Esta aplicación necesita un servidor de aplicaciones para ejecutar para realizar la resolución GNSS y Wi-Fi.
La velocidad de datos adaptativa (ADR) se configura en el perfil ADR personalizado con distribución dataRate y número de repetición definida por regiones.
El datarate real y el número de valores de retransmisión se definen en el archivo main_tracker_application_autonomous.c .
Los valores deben establecerse cuidadosamente para que coincidan con las limitaciones del ciclo de trabajo, los objetivos de consumo de energía, etc.
Aquí siga los pasos que se verán en los registros para indicar el comportamiento esperado de la aplicación.
Por defecto, el dispositivo debe enviar una posición cada dos minutos, sea cual sea la región seleccionada.
INFO: Modem Initialization
###### ===== LoRa Basics Modem Tracker application ==== ######
Después de esta impresión, encontrará impresiones de aplicación y parámetros
Al principio corriendo no se supone que no hay tiempo 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 configuración predeterminada inicial coloca el dispositivo rastreador en modo avión. En este modo, el dispositivo no se une automáticamente a la red Lorawan. El efecto del sensor Hall también solo se habilita durante un corto período de tiempo cada vez que el rastreador detecta un movimiento. El dispositivo se puede sacar del modo de avión utilizando la aplicación de configuración Lora Edge ™.
Cuando las baterías están agotadas, el dispositivo se vuelve a colocar automáticamente en modo avión.
El sensor de efecto Hall se usa como un interruptor para comenzar la publicidad BLE. Se activa cuando el usuario coloca un imán cerca. En el modo de avión, el sensor de efecto Hall solo está activo al inicio y durante un intervalo de 60 segundos cuando el rastreador detecta un movimiento. La duración de la activación está configurada por el TRACKER_HALL_TIMEOUT_MS constante.
| ❗ Cuando el sensor de efecto Hall detecta un escudo, restablece el rastreador para comenzar la BLE. El BLE no se ejecuta en paralelo de módem básico de Lora |
|---|
Hay un LED bicolor en la placa de diseño de referencia del rastreador de Lora Edge:
El componente amarillo se llama LED RX y el componente rojo es el LED TX.
La aplicación utiliza el LED del diseño de referencia del rastreador de Lora Edge para mostrar los siguientes eventos:
LED_PERIOD_MS .LED_PERIOD_MS . 
