Creación de una aplicación con respuesta en tiempo real
Importante
Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).
La manera más fácil de crear una nueva aplicación con respuesta en tiempo real es empezar con la plantilla Blank de la extensión de Azure Sphere de Visual Studio Code y ajustar la configuración al proyecto siguiendo estos pasos:
Inicie Visual Studio Code. Seleccione Ver>paleta de comandos y escriba Azure Sphere: Generar nuevo proyecto.
Elija RTCore En blanco en el menú Plantillas.
Después, Visual Studio Code muestra una ventana de Explorador de archivos. Vaya a la carpeta donde desea colocar la aplicación En blanco y especifique un nombre para el proyecto, por ejemplo, NewRTApp. Visual Studio Code crea la carpeta NewRTApp en la ubicación seleccionada y genera los archivos de compilación para la aplicación en blanco. Deberían aparecer mensajes de CMake.
También puede crear una nueva aplicación con respuesta en tiempo real a partir de cualquiera de los ejemplos de Azure Sphere compatibles en tiempo real:
Clone el repositorio de ejemplos si aún no lo ha hecho. Copie una de las carpetas de aplicaciones de alto nivel y cámbiela por el proyecto.
En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:
PROJECT(NewRTApp C)
La manera más fácil de crear una nueva aplicación con respuesta en tiempo real es empezar con la plantilla Blank de la extensión de Azure Sphere de Visual Studio y ajustar la configuración al proyecto siguiendo estos pasos:
Inicia Visual Studio y selecciona Crear un proyecto.
Escriba
Azure Sphere
el cuadro de búsqueda con la etiqueta Buscar plantillas. Seleccione Azure Sphere RTCore En blanco en la lista devuelta y, a continuación, seleccione Siguiente.Especifique un nombre de proyecto (por ejemplo, NewRTApp), 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 NewRTApp en la ubicación seleccionada y genera los archivos de compilación para la aplicación en blanco. Deberían aparecer mensajes de CMake.
También puede crear una nueva aplicación con respuesta en tiempo real a partir de cualquiera de los ejemplos de Azure Sphere de alto nivel:
Clone el repositorio de ejemplos si aún no lo ha hecho. Copie una de las carpetas de aplicaciones compatibles en tiempo real y cámbiela por el proyecto.
En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:
PROJECT(NewRTApp C)
La manera más fácil de crear una nueva aplicación con respuesta en tiempo real es comenzar con el ejemplo HelloWorld_RTApp_MT3620_BareMetal y ajustar la configuración al proyecto mediante estos pasos:
Clone el repositorio de ejemplos si aún no lo ha hecho. Copie la carpeta HelloWorld_RTApp_MT3620_BareMetal y cámbiele el nombre para su proyecto.
En el archivo CMakeLists.txt, cambie el nombre del proyecto al nombre de la nueva carpeta. Por ejemplo:
PROJECT(NewRTApp C)
Estructura básica de archivos de una aplicación con respuesta en tiempo real
Independientemente de cómo cree la aplicación, todas las aplicaciones de Azure Sphere comparten los siguientes archivos principales:
- 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 usa para controlar el proceso de compilación de aplicaciones de Azure Sphere.
- Un archivo app-manifest que describe las funcionalidades disponibles para la aplicación.
Las aplicaciones compatibles en tiempo real agregan al menos otro archivo: un archivo linker.ld para especificar exactamente dónde se cargarán varios componentes de la aplicación en el núcleo en tiempo real.
Escritura del código
- Escriba el código de la aplicación mediante los ejemplos de RTApp de Azure Sphere como guías. En los temas siguientes se describen escenarios de implementación específicos:
- En el archivo app_manifest.json:
- Establezca
Name
en el nombre del proyecto. - Establezca
ApplicationType
en"RealTimeCapable"
. - Agregue cualquier funcionalidad específica de la aplicación que requiera el código, como las conexiones o los recursos de hardware. Si la RTApp se comunica con una aplicación de alto nivel, agregue el identificador del componente de la aplicación de alto nivel para la función
AllowedApplicationConnections
.
- Establezca
Si desea implementar la RTApp junto con una aplicación asociada de alto nivel, agregue el identificador de componente del asociado al campo partnerComponents de la sección configurations del archivo launch.vs.json (Visual Studio) o .vscode/launch.vs.json (Visual Studio Code):
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]