Creación de aplicaciones de alto nivel

  • Artículo
  • 5 minutos para leer

La forma más fácil de crear una nueva aplicación de alto nivel es comenzar con la plantilla en blanco de la extensión de Visual Studio Code Azure Sphere y ajustar la configuración al proyecto siguiendo estos pasos:

  1. Inicie Visual Studio Code. Seleccione Ver > paleta de comandos y, a continuación, escriba Azure Sphere: generar nuevo proyecto.

    Barra de comandos en Visual Studio Code

  2. Elija HL en blanco en el menú plantillas.

    menú emergente con nombres de plantilla

  3. Visual Studio Code muestra una ventana del explorador de archivos. Navegue hasta la carpeta en la que desea colocar la aplicación en blanco y especifique un nombre para el proyecto, por ejemplo, NewHLApp. Visual Studio Code crea la carpeta NewHLApp en la ubicación seleccionada y genera los archivos de compilación para la aplicación en blanco. Deberían aparecer mensajes de CMake.

  4. Abra el archivo de CMakeLists.txt y especifique la carpeta que contiene las definiciones del hardware que está usando. De forma predeterminada, la aplicación en blanco HL no contiene definiciones de hardware. Puede encontrar definiciones de hardware de ejemplo en el repositorio de ejemplos de Azure Sphere o crear uno como se describe en definiciones de hardware.

    A continuación se muestra cómo agregar las definiciones de hardware de ejemplo para el kit de desarrollo de Seeed Azure Sphere MT3620:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Esta línea debe insertarse antes del inicio del comando final azsphere_target_add_image_package .

También puede crear una nueva aplicación de alto nivel desde cualquiera de los ejemplos de Azure Sphere de alto nivel:

  1. Clone el repositorio de ejemplos si aún no lo ha hecho. Copie una de las carpetas de la aplicación de alto nivel y cambie su nombre por el proyecto.

  2. En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:

    PROJECT(NewHLApp C)

La forma más fácil de crear una nueva aplicación de alto nivel es comenzar con la plantilla en blanco de la extensión de Azure Sphere de Visual Studio y ajustar la configuración a su proyecto siguiendo estos pasos:

  1. Inicie Visual Studio y seleccione Crear un proyecto.

  2. Escriba Azure Sphere en el cuadro de búsqueda con la etiqueta buscar plantillas. Seleccione Azure Sphere HLCore en blanco en la lista devuelta y luego seleccione siguiente.

  3. Especifique un nombre de proyecto (por ejemplo, NewHLApp), una ubicación de archivo de proyecto y un nombre de solución (que puede ser el mismo que el nombre del proyecto) y, a continuación, seleccione crear. Visual Studio crea la carpeta NewHLpp en la ubicación seleccionada y genera los archivos de compilación para la aplicación en blanco. Deberían aparecer mensajes de CMake.

  4. Abra el archivo de CMakeLists.txt y especifique la carpeta que contiene las definiciones del hardware que está usando. De forma predeterminada, la aplicación en blanco HL no contiene definiciones de hardware. Puede encontrar definiciones de hardware de ejemplo en el repositorio de ejemplos de Azure Sphere o crear uno como se describe en definiciones de hardware.

    A continuación se muestra cómo agregar las definiciones de hardware de ejemplo para el kit de desarrollo de Seeed Azure Sphere MT3620:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Esta línea debe insertarse antes del inicio del comando final azsphere_target_add_image_package .

También puede crear una nueva aplicación de alto nivel desde cualquiera de los ejemplos de Azure Sphere de alto nivel:

  1. Clone el repositorio de ejemplos si aún no lo ha hecho. Copie una de las carpetas de la aplicación de alto nivel y cambie su nombre por el proyecto.

  2. En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:

    PROJECT(NewHLApp C)

La forma más fácil de crear una nueva aplicación de alto nivel es comenzar con cualquiera de los ejemplos de Azure Sphere de alto nivel:

  1. Clone el repositorio de ejemplos si aún no lo ha hecho. Copie una de las carpetas de la aplicación de alto nivel y cambie su nombre por el proyecto.

  2. En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:

    PROJECT(NewHLApp C)

Estructura básica de archivos de una aplicación de alto nivel

Independientemente de cómo cree la aplicación, todas Azure Sphere aplicaciones comparten los archivos principales siguientes:

  • Código fuente de la aplicación en uno o varios archivos. Actualmente, solo se admite el código fuente del lenguaje C.
  • Archivos de compilación de CMake. CMakeLists.txt es obligatorio. CMake, junto con la utilidad de compilación ligera Ninja, se utiliza para controlar el proceso de compilación de Azure Sphere aplicación.
  • Un archivo de manifiesto de aplicación que describe las capacidades disponibles para la aplicación.

Las aplicaciones de alto nivel normalmente tendrán al menos tres archivos:

  • Un archivo applibs-Versions. h para especificar los niveles de versión de varias API de Azure Sphere
  • Dos archivos de definición de hardware (una versión editable en formato JSON y un archivo de inclusión de lenguaje C generado a partir de él) que proporcionan una manera cómoda de hacer referencia a los componentes de hardware del código. Con un conjunto coherente de archivos de definición de hardware, puede escribir código fuente independiente del hardware y, a continuación, crear imágenes de aplicación para hardware específico simplemente redestinando el archivo de definición de hardware adecuado en el archivo de CMakeLists.txt.

Escritura del código

  1. Escriba el código de aplicación mediante los ejemplos de aplicaciones de alto nivel de Azure Sphere como guías. Los temas siguientes describen escenarios de aplicación específicos:
  2. En el archivo deCMakeLists.txt:
    • Especificar Azure Sphere revisión de las herramientas del SDK
    • Especificación de un conjunto de API de destino
    • Especificar el hardware de destino
  3. En el archivo app_manifest.json:
    • Establezca Name en el nombre del proyecto.
    • Agregue cualquier funcionalidad específica de la aplicación que requiera el código, como las conexiones o los recursos de hardware. Si la aplicación de alto nivel se comunica con un RTApp, agregue el identificador de componente de la aplicación de alto nivel a la AllowedApplicationConnections funcionalidad.

Si desea implementar la aplicación de alto nivel junto con una aplicación de asociadocompatible en tiempo real, agregue el identificador de componente del asociado al campo partnerComponents de la sección de configuraciones del archivo launch.vs.jsen (Visual Studio) o. vscode/launch.jsen (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Vea también