Tutorial: Compilación y depuración de aplicaciones de asociados

• Instale CMake y Ninja para Windows o para Linux.

• Instale Visual Studio Code para Windows o para Linux.
• Instale CMake y Ninja para Windows o para Linux.

• Instale Visual Studio y la extensión Azure Sphere .

Si usa Visual Studio, vaya a Set up hardware to display output (Configurar hardware para mostrar la salida). La cadena de herramientas se instala con la extensión Azure Sphere para Visual Studio. Sin embargo, si ha instalado la cadena de herramientas de GNU ARM Embedded manualmente, Visual Studio usará la versión que instaló.

Para instalar la cadena de herramientas:

• En el sitio web para desarrolladoresde Arm, busque la cadena de herramientas GNU Arm Embedded que incluye el compilador para el procesador Arm Cortex-M4. Siga las instrucciones para descargar e instalar el compilador para la plataforma del sistema operativo.

De forma predeterminada, Visual Studio Code busca la cadena de herramientas y debe encontrar la versión instalada. Si encuentra problemas de compilación relacionados con la cadena de herramientas, active Preferencias Configuración Extensiones de AzureSphere para asegurarse de que > > > "Azure Sphere: Ruta de acceso de Arm Gnu" identifica el directorio de instalación de la cadena de herramientas de GNU Arm Embedded.

1. Inicie Visual Studio. Seleccione Abrir una carpeta local y vaya a la carpeta donde extrajo las aplicaciones IntercoreComms.

2. Si no usa una RDB MT3620, actualice elapp_manifest.jsen los archivos de las aplicaciones y el archivo de definición de hardware y el archivo CMakeLists.txt para que la aplicación de alto nivel coincida con el hardware.

3. Si la generación de CMake no se inicia automáticamente, seleccione el archivo CMakeLists.txt.

4. En Visual Studio, Ver > salida > Mostrar salida de: La salida de CMake debe mostrar los mensajes CMake generation started y CMake generation finished .

5. Seleccione Build > Build All (Compilar todo). Si el menú no está presente, abra el Explorador de soluciones, haga clic en el archivo CMakeLists.txt y seleccione Compilar. La ubicación de salida de la HelloWorld_RTApp_MT3620_Baremetal aplicación aparece en la ventana Salida.

6. Seleccione Seleccionar elemento de inicio > IntercoreComms (Todos los núcleos).

7. Seleccione Depurar > depuración o presione F5 para implementar y depurar las aplicaciones.

8. En la ventana Salida, Seleccione la salida en el menú y seleccione Salida del dispositivo. La ventana Salida debe mostrar la salida de la aplicación de alto nivel:

   Remote debugging from host 192.168.35.1, port 58817
   High-level intercore comms application
   Sends data to, and receives data from a real-time capable application.
   Received 19 bytes: rt-app-to-hl-app-07
   Sending: hl-app-to-rt-app-00
   Sending: hl-app-to-rt-app-01
   

9. El emulador de terminal conectado debe mostrar la salida del programa compatible en tiempo real:

   Sender: 25025d2c-66da-4448-bae1-ac26fcdd3627
   Message size: 19 bytes:
   Hex: 68:6c:2d:61:70:70:2d:74:6f:2d:72:74:2d:61:70:70:2d:30:30
   Text: hl-app-to-rt-app-00
   Sender: 25025d2c-66da-4448-bae1-ac26fcdd3627
   Message size: 19 bytes:
   Hex: 68:6c:2d:61:70:70:2d:74:6f:2d:72:74:2d:61:70:70:2d:30:31
   Text: hl-app-to-rt-app-01
   

10. Use el depurador para establecer puntos de interrupción, inspeccionar variables y probar otras tareas de depuración.

1. En Visual Studio Code, abra la carpeta donde extrajo las aplicaciones IntercoreComms. Visual Studio Code detecta el archivo intercore.code-workspace y le pregunta si desea abrir el área de trabajo. Seleccione Abrir área de trabajo para abrir la aplicación en tiempo real y la aplicación de alto nivel a la vez.

2. Si no usa una RDB MT3620, actualice elapp_manifest.jsen los archivos de las aplicaciones y el archivo de definición de hardware y el archivo CMakeLists.txt para que la aplicación de alto nivel coincida con el hardware.

3. Presione F5 para iniciar el depurador. Si el proyecto no se ha compilado previamente, o si los archivos han cambiado y es necesario recompilar, Visual Studio Code compilará el proyecto antes de que se inicie la depuración.

4. La ventana de salida de Azure Sphere debe mostrar "Implementando imagen..." seguido de las rutas de acceso al SDK y al compilador.

5. La ventana de salida debe mostrar la salida de la aplicación de alto nivel:

   Remote debugging from host 192.168.35.1, port 58817
   High-level intercore comms application
   Sends data to, and receives data from a real-time capable application.
   Received 19 bytes: rt-app-to-hl-app-07
   Sending: hl-app-to-rt-app-00
   Sending: hl-app-to-rt-app-01
   

6. El emulador de terminal conectado debe mostrar la salida del programa compatible en tiempo real:

   Sender: 25025d2c-66da-4448-bae1-ac26fcdd3627
   Message size: 19 bytes:
   Hex: 68:6c:2d:61:70:70:2d:74:6f:2d:72:74:2d:61:70:70:2d:30:30
   Text: hl-app-to-rt-app-00
   Sender: 25025d2c-66da-4448-bae1-ac26fcdd3627
   Message size: 19 bytes:
   Hex: 68:6c:2d:61:70:70:2d:74:6f:2d:72:74:2d:61:70:70:2d:30:31
   Text: hl-app-to-rt-app-01
   

7. Use las características de depuración de Visual Studio Code para establecer puntos de interrupción, inspeccionar variables y probar otras tareas de depuración.

Solución de problemas

Es posible que la aplicación comience a ejecutarse antes de que OpenOCD realice una conexión. Como resultado, es posible que se pierdan los puntos de interrupción establecidos antes en el código. Una sencilla solución para esta situación es retrasar el inicio de la aplicación hasta que se conecte OpenOCD.

1. Inserte el siguiente código al principio del punto de entrada de la aplicación RTCoreMain. Esto hará que la aplicación entre en un bucle while y permanezca en él hasta que la variable f se establezca en true.

   static _Noreturn void RTCoreMain(void)
   {
     .
     .
     .
    volatile bool f = false;
    while (!f) {
       // empty.
    }
     .
     .
     .
   }
   

2. Presione F5 para iniciar la aplicación con depuración y, a continuación, interrumpir la ejecución.

3. En el panel de depuración Expresiones locales, cambie el valor de f de cero a uno.

4. Pase por el código como de costumbre.

Al compilar con la CLI, primero se compila e implementa la aplicación compatible en tiempo real y, a continuación, se compila e implementa la aplicación de alto nivel.

Compilación e implementación de la aplicación compatible en tiempo real

1. Vaya a la carpeta donde extrajo las aplicaciones IntercoreComms y, a continuación, seleccione la carpeta IntercoreComms/IntercoreComms_RTApp_MT3620_BareMetal.

2. Abra el app_manifest.jsen el archivo y compruebe que el identificador de componente de la aplicación de alto nivel se muestra en la funcionalidad AllowedApplicationConnections.

3. Cree o navegue hasta el directorio de compilación del proyecto para la aplicación compatible en tiempo real. Este es el directorio que contendrá los archivos .imagepackage de compilación que se generarán durante el proceso de compilación. Por ejemplo, para crear y abrir un nuevo directorio denominado "build", escribiría los siguientes comandos:

   mkdir build
   cd build
   

4. Abra una interfaz de línea de comandos mediante PowerShell, Windows símbolo del sistema o el shell de comandos de Linux. Vaya al directorio de compilación del proyecto.

5. Desde el directorio de compilación del proyecto, en el símbolo del sistema, ejecute CMake con los parámetros siguientes:

   • -G Establezca este parámetro en "Ninja" para indicar que CMake debe usar el generador Ninja para crear los archivos de compilación, ya que Ninja se usará para completar la compilación.

   • -DCMAKE_TOOLCHAIN_FILE

     Establezca este parámetro en la ruta de acceso al archivo de cadena de herramientas del compilador en el equipo. Por Windows, el CMAKE_TOOLCHAIN_FILE debe apuntar a C:\Archivos de programa (x86) \ <path to SDK> \CMakeFiles\AzureSphereRTCoreToolchain.cmake. Para Linux, especifique /opt/azurespheresdk/CMakeFiles/AzureSphereRTCoreToolchain.cmake.

   • -DARM_GNU_PATH

     Establezca este parámetro en la ruta de acceso al directorio de la máquina que contiene arm-none-eabi-gcc y no la ruta de acceso al propio compilador. Si usa las herramientas GNU de Visual Studio, la ruta de acceso ARM_GNU_PATH estaría en la subcarpeta \ \Linux\gcc_arm\bin de la edición 2019 de la instalación de Visual Studio, en lugar de la ruta de acceso del ejemplo.

   • -DCMAKE_BUILD_TYPE

     Establezca este parámetro en el tipo de compilación. Los valores posibles son Debug y Release.

   • El parámetro final es la ruta de acceso al directorio de la máquina que contiene los archivos de origen de la aplicación de ejemplo. En el ejemplo, el repositorio de ejemplos de Azure Sphere se descargó en un directorio denominado AzSphere.

   Los parámetros de CMake se separan mediante espacios. El carácter de continuación de línea ("^" para Windows línea de comandos o "" para la línea de comandos de Linux) se puede usar para mejorar la legibilidad, pero \ no es necesario.

   En los ejemplos siguientes se muestran los comandos de CMake para IntercoreComms RTApp:

   • Windows
   • Linux

   Windows Símbolo del sistema

    cmake ^
    -G "Ninja" ^
    -DCMAKE_TOOLCHAIN_FILE="C:\Program Files (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereRTCoreToolchain.cmake" ^
    -DARM_GNU_PATH:STRING="C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin" ^
    -DCMAKE_BUILD_TYPE="Debug" ^
    "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_RTApp_MT3620_BareMetal"
   

   Windows PowerShell

    cmake `
    -G "Ninja" `
    -DCMAKE_TOOLCHAIN_FILE="C:\Program Files (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereRTCoreToolchain.cmake" `
    -DARM_GNU_PATH:STRING="C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin" `
    -DCMAKE_BUILD_TYPE="Debug" `
    "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_RTApp_MT3620_BareMetal"
   

6. Desde el directorio de compilación del proyecto, en el símbolo del sistema, ejecute ninja para compilar la aplicación y crear el archivo de paquete de imagen.

   Para solucionar problemas, especialmente después de realizar cambios en los comandos de CMake, elimine la compilación completa e inténtelo de nuevo.

7. Elimine las aplicaciones que ya están implementadas en el dispositivo:

   azsphere device sideload delete
   

8. Desde el directorio de compilación del proyecto, en el símbolo del sistema, cargue el paquete de imagen que ninja creó:

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere device sideload deploy --image-package <path-to-imagepackage>
   

   La aplicación comenzará a ejecutarse poco después de que se cargue.

9. Obtención del identificador del componente para la imagen:

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere image-package show --image-package <path-to-imagepackage>
   

   El comando devuelve todos los metadatos del paquete de imágenes. El identificador de componente de la aplicación aparece en la sección Identidad del tipo de imagen de aplicación. Por ejemplo:

   Image package metadata:
   Section: Identity
   Image Type:           Application
   Component ID:         <component id>
   Image ID:             <image id>
   

Compilación e implementación de la aplicación de alto nivel

1. Vaya a la carpeta donde extrajo las aplicaciones IntercoreComms y, a continuación, seleccione la carpeta IntercoreComms/IntercoreComms_HighLevelApp.

2. Abra el app_manifest.jsen el archivo y compruebe que el identificador de componente de rtapp se muestra en la funcionalidad AllowedApplicationConnections.

3. Cree o navegue hasta el directorio de compilación del proyecto para la aplicación de alto nivel. Este es el directorio que contendrá los archivos .imagepackage de compilación que se generarán durante el proceso de compilación. Por ejemplo, para crear y abrir un nuevo directorio denominado "compilación", debe escribir los siguientes comandos:

   mkdir build
   cd build
   

4. Abra una interfaz de línea de comandos mediante PowerShell, Windows símbolo del sistema o el shell de comandos de Linux. Vaya al directorio de compilación del proyecto.

5. Desde el directorio de compilación del proyecto, en el símbolo del sistema, ejecute CMake con los parámetros siguientes:

   • -G Establezca este parámetro en "Ninja" para indicar que CMake debe usar el generador Ninja para crear los archivos de compilación, ya que Ninja se usará para completar la compilación.

   • -DCMAKE_TOOLCHAIN_FILE

     Establezca este parámetro en la ruta de acceso al archivo de cadena de herramientas del compilador en el equipo. Por Windows, el CMAKE_TOOLCHAIN_FILE debe apuntar a C:\Archivos de programa (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereRTCoreToolchain.cmake. Para Linux, especifique /opt/azurespheresdk/CMakeFiles/AzureSphereRTCoreToolchain.cmake.

   • -DAZURE_SPHERE_TARGET_API_SET

     Establezca este parámetro en el valor Azure Sphere API que se va a usar. En el ejemplo, se establece en "latest-lts", que selecciona el conjunto más reciente de API designadas para soporte técnico a largo plazo.

   • -DCMAKE_BUILD_TYPE

     Establezca este parámetro en el tipo de compilación. Los valores posibles son Debug y Release.

   • El parámetro final es la ruta de acceso al directorio de la máquina que contiene los archivos de origen de la aplicación de ejemplo. En el ejemplo, el repositorio de ejemplos de Azure Sphere se descargó en un directorio denominado AzSphere.

   Los parámetros de CMake se separan mediante espacios. El carácter de continuación de línea ("^" para Windows línea de comandos o " " para la línea de comandos de Linux) se puede usar para mejorar la \ legibilidad, pero no es necesario.

   En los ejemplos siguientes se muestran los comandos de CMake para la aplicación de alto nivel IntercoreComms.

   • Windows
   • Linux

   Windows Símbolo del sistema

    cmake ^
    -G "Ninja" ^
    -DCMAKE_TOOLCHAIN_FILE="C:\Program Files (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereToolchain.cmake" ^
    -DAZURE_SPHERE_TARGET_API_SET="latest-lts" ^
    -DCMAKE_BUILD_TYPE="Debug" ^
    "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_HighLevelApp"
   

   Windows PowerShell

    cmake `
    -G "Ninja" `
    -DCMAKE_TOOLCHAIN_FILE="C:\Program Files (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereToolchain.cmake" `
    -DAZURE_SPHERE_TARGET_API_SET="latest-lts" `
    -DCMAKE_BUILD_TYPE="Debug" `
    "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_HighLevelApp"
   

6. Desde el directorio de compilación del proyecto, en el símbolo del sistema, ejecute ninja para compilar la aplicación y crear el archivo de paquete de imagen.

   Para solucionar problemas, especialmente después de realizar cambios en los comandos de CMake, elimine la compilación completa e inténtelo de nuevo.

7. Desde el directorio de compilación del proyecto, en el símbolo del sistema, cargue el paquete de imagen que ninja creó:

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere device sideload deploy --image-package <package-name>
   

   La aplicación comenzará a ejecutarse poco después de que se cargue.

8. Obtención del identificador del componente para la imagen:

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere image-package show --image-package <path-to-imagepackage>
   

   El comando devuelve todos los metadatos del paquete de imágenes. El identificador de componente de la aplicación aparece en la sección Identidad del tipo de imagen de aplicación. Por ejemplo:

   Image package metadata:
     Section: Identity
       Image Type:           Application
       Component ID:         <component id>
       Image ID:             <image id>
   

Ejecución de las aplicaciones asociadas con la depuración habilitada

1. Detenga la aplicación en tiempo real si se está ejecutando.

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere device app stop --component-id <component id>
   

2. Vuelva a iniciar la aplicación para la depuración.

   • CLI de Azure Sphere
   • Azure Sphere CLI clásica

   azsphere device app start --component-id <component id>
   

   Este comando devuelve el núcleo en el que se ejecuta la aplicación.

     <component id>
     App state: running
     Core        : Real-time 0
   

3. Vaya a la carpeta Openocd para el sysroot con que se compiló la aplicación. Los sysroot se instalan en la carpeta de instalación del SDK de Azure Sphere. Por ejemplo, en Windows, la carpeta se instala de manera predeterminada en C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\openocd y en Linux, en /opt/azurespheresdk/Sysroots/*sysroot*/tools/sysroots/x86_64-pokysdk-linux.

4. Ejecute openocd como se muestra en el ejemplo siguiente. En el ejemplo se da por supuesto que la aplicación se ejecuta en el núcleo 0. Si la aplicación se ejecuta en el núcleo 1, reemplace "targets io0" por "targets io1".

   • Windows
   • Linux

      openocd -f mt3620-rdb-ftdi.cfg -f mt3620-io0.cfg -c "gdb_memory_map disable" -c "gdb_breakpoint_override hard" -c init -c "targets io0" -c halt -c "targets"
   

5. Abra un nuevo símbolo del Azure Sphere de comandos (Windows Azure Sphere cli clásica), símbolo del sistema estándar o PowerShell (CLI Windows Azure Sphere) o ventana de terminal (Linux).

6. Vaya a la carpeta que contiene el archivo .out de la aplicación compatible en tiempo real e inicie , que forma parte de la cadena de herramientas arm-none-eabi-gdb de GNU Arm Embedded:

   • Windows
   • Linux

   Windows Símbolo del sistema

   "C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin\arm-none-eabi-gdb" IntercoreComms_RTApp_MT3620_BareMetal.out
   

   Windows PowerShell

    & "C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin\arm-none-eabi-gdb" IntercoreComms_RTApp_MT3620_BareMetal.out
   

7. El servidor OpenOCD proporciona una interfaz de servidor GDB en :4444. Establezca el destino para la depuración.

   target remote :4444

8. Ahora puede emitir comandos gdb a la aplicación compatible en tiempo real. Agregue un punto de interrupción en la función HandleSendTimerDeferred:

   break HandleSendTimerDeferred

9. El emulador de terminal conectado debe mostrar la salida de la aplicación compatible en tiempo real.

10. Abra un nuevo símbolo del Azure Sphere de comandos (Windows Azure Sphere cli clásica), símbolo del sistema estándar o PowerShell (CLI Windows Azure Sphere) o ventana de terminal (Linux).

11. Vaya a la carpeta que contiene el archivo .imagepackage de aplicación de alto nivel.

12. Detenga la aplicación de alto nivel si se está ejecutando.

    • CLI de Azure Sphere
    • Azure Sphere CLI clásica

    azsphere device app stop --component-id <component id>
    

13. Vuelva a iniciar la aplicación de alto nivel con la depuración.

    • CLI de Azure Sphere
    • Azure Sphere CLI clásica

    azsphere device app start --component-id <component id> --debug-mode
    

14. Abra un emulador de terminal y establezca una conexión Telnet o TCP a 192.168.35.2 en el puerto 2342 para ver la salida de la aplicación de alto nivel.

15. Inicie gdb con el siguiente comando:

    • Windows
    • Linux

    Windows Símbolo del sistema

    "C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\gcc\arm-poky-linux-musleabi-gdb.exe" IntercoreComms_HighLevelApp.out
    

    Windows PowerShell

    & "C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\gcc\arm-poky-linux-musleabi-gdb.exe" IntercoreComms_HighLevelApp.out
    

16. Establezca el destino de depuración remota en la dirección IP 192.168.35.2 en el puerto 2345:

    target remote 192.168.35.2:2345

17. Agregue un punto de interrupción en la función SendMessageToRTApp:

    break SendMessageToRTApp

18. Escriba para continuar, observe la salida en el terminal Telnet/TCP y, a continuación, cambie al símbolo del sistema o a la ventana de terminal que contiene la sesión de depuración c de la aplicación en tiempo real.

19. Escriba c para continuar y observar la salida en la sesión serie conectada.

Puede trabajar entre sesiones de depuración y cambiar entre la aplicación compatible en tiempo real y la aplicación de alto nivel. Debería ver una salida similar a la siguiente en las dos ventanas de salida:

Starting debugger....
                     Process /mnt/apps/25025d2c-66da-4448-bae1-ac26fcdd3627/bin/app created; pid = 40
                     Listening on port 2345
                                           Remote debugging from host 192.168.35.1, port 56522
              High-level intercore comms application
                                                    Sends data to, and receives data from a real-time capable application.
                                          Sending: hl-app-to-rt-app-00
                                                                      Sending: hl-app-to-rt-app-01

IntercoreComms_RTApp_MT3620_BareMetal
App built on: Nov 17 2020, 09:25:19
Sender: 25025d2c-66da-4448-bae1-ac26fcdd3627
Message size: 19 bytes:
Hex: 68:6c:2d:61:70:70:2d:74:6f:2d:72:74:2d:61:70:70:2d:30:30
Text: hl-app-to-rt-app-00

Para finalizar cada sesión de depuración, escriba q en el símbolo del sistema gdb.