Para que la introducción a la tecnología de radio LoRa sea lo más fácil posible, casi todo en nuestra solución está listo para su uso. Todas las tarjetas son probadas por nosotros antes de la entrega y cargadas con un programa de prueba del software RadioShuttle. Son sólo unos pocos pasos para las primeras pruebas propias de alcance de radio.
Le aconsejamos que lea el capítulo anterior La Tarjeta Turtle y su Técnología. Allí encontrará explicaciones de los componentes individuales de la tarjeta, que se discutirán a continuación.
Para la puesta en servicio de la tarjeta Turtle se requieren los siguientes preparativos:
- Conecte la antena SMA incluida
- Conecte la tarjeta Turtle al ordenador usando el cable micro-USB
Además, el software RadioShuttle debe ser compilado y flasheado en la tarjeta. Este procedimiento se describe en las siguientes secciones.
Vídeo: Turtle Board First Steps – Getting Started
Vídeo: RadioShuttle »Turtle« LoRa board programming with Mbed OS using sample applications
Entorno de desarrollo Arm Mbed
Arm ofrece un entorno de desarrollo de software profesional gratuito. Incluye un IDE basado en web fácil de usar, y es gratuito. Ofrece los siguientes beneficios:
- Compilador Arm C/C++ (genera código altamente optimizado)
- Mbed OS (biblioteca de programación integrada fácil de usar)
- Editor de programación
- Desarrollo multiusuario en un proyecto
- Control de versiones para código de programación y proyectos
- Gestión de bibliotecas (suscripción y publicación de bibliotecas)
- Potente compilador en línea (también son posibles los compiladores fuera de línea)
- Portal de soporte (para preguntas/discusiones)
- Amplio soporte de tarjetas (Mbed soporta más de 130 tarjetas de desarrollo diferentes). La tarjeta Turtle es compatible con la tarjeta STM NUCLEO-L432KC
Hemos elegido Arm Mbed para nuestras tarjetas Turtle porque ofrece un entorno de desarrollo muy profesional para las MCU basadas en Arm. Sin ninguna instalación de software local, unos pocos clics permiten importar y compilar el software de RadioShuttle.
Todos nuestros ejemplos están basados en el compilador en línea de Mbed. Los compiladores comerciales fuera de línea con Keil MDK, sistemas IAR o el compilador/depurador GCC gratuito también se pueden utilizar exportando el proyecto Mbed a un entorno de desarrollo local. Sin embargo, este procedimiento no se describe aquí.
Para empezar, el software RadioShuttle debe estar compilado y flasheado en la tarjeta. Este procedimiento se describe en las siguientes secciones.
Instalación de RadioShuttle STM32 Utility
Para descargar aplicaciones (archivos “.bin”) en la tarjeta, se requiere una herramienta especial. RadioShuttle proporciona estas herramientas STM32 para Mac, Windows y Linux como una versión de línea de comandos, y como una versión GUI para Mac y Windows. Las herramientas STM32 se pueden descargar aquí (véase la documentación).
Instalación en Windows
Para trabajar con la tarjeta Turtle, se necesita un emulador de terminal. Para Windows recomendamos usar “Tera Term” que se puede descargar aquí.
Para ambos programas, RadioShuttle STM32 Utility y Tera Term, se requieren controladores de Windows. Consulte la sección “7. Instalar controladores en Windows” de la página RadioShuttle STM32 Utility.
Instalación en macOS
Los usuarios de macOS no necesitan más preparación porque ya se incluyen un emulador de terminal y controladores.
Crear una cuenta de Mbed
- Introduzca la dirección https://os.mbed.com/account/signup/ en un navegador web y regístrese para crear una cuenta gratuita en Mbed.
Esta cuenta le permite acceder a las herramientas y servicios de Mbed que necesitará para compilar el software RadioShuttle para la tarjeta Turtle.
Importar el software de ejemplo RadioShuttle
Un enlace le lleva al software RadioShuttle que puede ser importado en el IDE de Mbed.
- Inicie el Online Compiler de Mbed
- Haga clic en “Import”
- Haga clic en “Click here to import from URL” y introduzca
https://github.com/RadioShuttle/MBED_Turtle_RadioShuttle
en el campo “Source URL” - Introduzca un nombre en el campo “Import Name”, por ejemplo Turtle-Test
- No actives la opción “Update all libraries to the latest revision”; ¡no se han probado todas las combinaciones!
- Haga clic en el botón “Import”
Probablemente recibirá una advertencia de que aún no ha añadido ninguna plataforma a su cuenta de Mbed. Si este es el caso, proceda de la siguiente manera:
- Haga clic en “Add Platform”
- Seleccione “NUCLEO-L432KC” y haga clic en “Add to your Mbed Compiler”
- Después de seleccionar la plataforma, haga clic en el botón “Import”
Se ha creado un nuevo proyecto. Incluye software para la tarjeta Turtle y el protocolo RadioShuttle con su aplicación de ejemplo RadioTest (véase illustr. 1).
Ahora la tarjeta ha sido añadida a su cuenta, y todos los objetos que componen el proyecto deberían ser listados en la ventana “Program Workspace”.
Objetos en el proyecto “Turtle_RadioShuttle”
| Nombre | Descripción |
|---|---|
| BufferedSerial | Una biblioteca serie con búfer que proporciona E/S asíncrona cuando se utiliza la tarjeta con un depurador en serie o una conexión UART |
| NVProperty | Una memoria de propiedad no volátil (permanente) que utiliza la memoria flash interna de la MCU para guardar los ajustes que se conservan al instalar un nuevo software |
| RadioShuttle-STM32L4 | El software de protocolo inalámbrico LoRa RadioShuttle nodo a nodo para las MCU STM32L4 |
| RadioShuttle.h* | API de protocolo RadioShuttle para desarrolladores *en la carpeta “RadioShuttle-STM32L4” |
| SX1276GenericLib | El controlador de serie SX127x para el chip de radio LoRa |
| USBDeviceHT | Una biblioteca de dispositivos USB para conexiones en serie CDC con búfer (puertos COM virtuales) |
| Utils | Código de ayuda para depuración de impresión (dprintf), configuración de la consola serie, etc. |
| main.cpp/main.h | El bucle principal del programa RadioShuttle |
| xPinMap.h | Asignación de pines de la MCU de la tarjeta Turtle y definiciones de las características |
| RadioTestSample.cpp | Un ejemplo de demostración inalámbrica nodo a nodo de LoRa (“RadioTest”) |
| mbed | La biblioteca de desarrollo Mbed |
Compilar el software RadioShuttle
- Abra el sitio web de Mbed y haga clic en “Compiler”
- En la sección “Program Workspace”, en “My Programs”, seleccione el proyecto “Turtle_RadioShuttle”
- Haga clic en el botón “Compile” en la barra de navegación
- Guarde el archivo generado “Turtle_RadioShuttle.NUCLEO_L432KC.bin” en su ordenador
Cargar el software RadioShuttle en la tarjeta
- Asegúrese de que la tarjeta Turtle esté conectada al ordenador
- Inicie el programa STM32 Utility
Primero, la tarjeta debe ponerse en modo de arranque DFU (Device Firmware Upgrade). La línea de estado dice "STM32 DFU Target not available (enable via User and Reset button)":
- Mantenga pulsada el pulsador “User” y pulse una vez el pulsador “Reset”
La línea de estado debería ser la siguiente STM32 (ID:0) Flash: 256 kB. La tarjeta está en modo DFU.
- Arrastre y suelte el archivo generado “Turtle_RadioShuttle.NUCLEO_L432KC.bin” en la ventana “RadioShuttle STM32 Utility”
Encontrará instrucciones detalladas en el capítulo RadioShuttle STM32 Utility.
Continuar con la página Instalación del Programa RadioShuttle para Turtle