Crear una aplicación de alto nivel

  • Artículo

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

  1. Inicia Visual Studio Code. Selecciona Ver>paleta de comandos y, a continuación, escribe Azure Sphere: Generate New Project.

    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, a continuación, se muestra una ventana Explorador de archivos. Vaya a la carpeta donde 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ía ver los 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 HL Blank no contiene definiciones de hardware. Puede encontrar definiciones de hardware de ejemplo en el repositorio de Azure Sphere Samples o crear una como se describe en Definiciones de hardware.

    A continuación se muestra cómo agregar las definiciones de hardware de muestra para el kit de desarrollo 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 de que comience azsphere_target_add_image_packageel comando final .

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

  1. Clone el repositorio de muestras si aún no lo ha hecho. Copie una de las carpetas de aplicación de alto nivel y cámbiele el nombre al proyecto.

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

    PROJECT(NewHLApp C)

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

  1. Inicia Visual Studio y selecciona Crear un nuevo proyecto.

  2. Escriba Azure Sphere en el cuadro de búsqueda buscar plantillas. Seleccione Azure Sphere HLCore Blank en la lista devuelta y, a continuación, 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ía ver los 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 HL Blank no contiene definiciones de hardware. Puede encontrar definiciones de hardware de ejemplo en el repositorio de Azure Sphere Samples o crear una como se describe en Definiciones de hardware.

    A continuación se muestra cómo agregar las definiciones de hardware de muestra para el kit de desarrollo 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 de que comience azsphere_target_add_image_packageel comando final .

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

  1. Clone el repositorio de muestras si aún no lo ha hecho. Copie una de las carpetas de aplicación de alto nivel y cámbiele el nombre al proyecto.

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

    PROJECT(NewHLApp C)

La forma más sencilla de crear una nueva aplicación de alto nivel es comenzar con cualquiera de las muestras de azure Sphere de alto nivel:

  1. Clone el repositorio de muestras si aún no lo ha hecho. Copie una de las carpetas de aplicación de alto nivel y cámbiele el nombre al proyecto.

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

    PROJECT(NewHLApp C)

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

No importa cómo cree su aplicación, todas las aplicaciones de Azure Sphere comparten los siguientes archivos principales:

  • Código fuente de la aplicación en uno o más archivos. Actualmente, solo se admite el código fuente del idioma C.
  • CHaga archivos de compilación. CMakeLists.txt es necesario. CMake, junto con la utilidad de compilación ligera ninja, se usa para controlar el proceso de compilación de la aplicación Azure Sphere.
  • Un archivo de manifiesto de la aplicación que describe las capacidades disponibles para la aplicación.

Las aplicaciones de alto nivel normalmente tendrán al menos otros 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 lenguaje C incluyen archivos generados a partir de él) que proporcionan una forma 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 la aplicación para hardware específico simplemente volver a dirigir el archivo de definición de hardware adecuado en su archivo de CMakeLists.txt.

Escribir el código

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

Si quieres implementar tu aplicación de alto nivel junto con una aplicación de partner compatible en tiempo real, agrega el id. de componente del partner al campo partnerComponents de la sección de configuraciones del archivo launch.vs.json (Visual Studio) o .vscode/launch.json (Visual Studio Code):

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

Consulte también