Inicio rápido: Compilación de la aplicación de Blink con Visual StudioQuickstart: Build the Blink application with Visual Studio

En este inicio rápido se muestra cómo habilitar el desarrollo de aplicaciones en un dispositivo de Azure Sphere y cómo compilar y depurar una aplicación de alto nivel.This quickstart shows how to enable application development on an Azure Sphere device and how to build and debug a high-level application. Se usa el ejemplo de Blink, que forma parte de la versión preliminar del SDK de Azure Sphere para Visual Studio.It uses the Blink sample, which is part of the Azure Sphere SDK Preview for Visual Studio. En el ejemplo de Blink se hace parpadear un LED, con el fin de que pueda verificar que las herramientas y el dispositivo de Azure Sphere están instalados y configurados correctamente.The Blink sample blinks an LED, so that you can verify that the Azure Sphere device and tools are installed and set up correctly.

PrerequisitesPrerequisites

Para poder realizar los pasos descritos en este tutorial de inicio rápido se supone que:The steps in this quickstart assume that:

  • El dispositivo de Azure Sphere está conectado a su equipoYour Azure Sphere device is connected to your PC
  • Ha completado todos los pasos para instalar Azure SphereYou have completed all the steps to install Azure Sphere

Importante

En estas instrucciones se supone que usa hardware que sigue el diseño de la placa de referencia MT3620, como el kit de desarrollo MT3620 de Seeed.These instructions assume that you are using hardware that follows the MT3620 reference board design, such as the Seeed MT3620 Development Kit. Si usa otro hardware de Azure Sphere, consulte la documentación del fabricante para averiguar si el GPIO está expuesto y cómo acceder a él.If you are using different Azure Sphere hardware, consult the manufacturer's documentation to find out whether the GPIO is exposed and how to access it. Es posible que deba actualizar el código de ejemplo y el campo "Gpio" del archivo app_manifest.json para usar un GPIO diferente.You might need to update the sample code and the "Gpio" field of the app_manifest.json file to use a different GPIO.

Preparación del dispositivo para desarrollo y depuraciónPrepare your device for development and debugging

Antes de poder compilar una aplicación de ejemplo en el dispositivo de Azure Sphere o desarrollar nuevas aplicaciones para él, debe habilitar el desarrollo y la instalación de prueba.Before you can build a sample application on your Azure Sphere device or develop new applications for it, you must enable development and sideloading. De forma predeterminada, los dispositivos de Azure Sphere están "bloqueados"; es decir, no permiten la carga de las aplicaciones en desarrollo desde un equipo, y no permiten la depuración de aplicaciones.By default, Azure Sphere devices are "locked"; that is, they do not allow applications under development to be loaded from a PC, and they do not allow debugging of applications. Preparar el dispositivo para la instalación de prueba quita esta restricción.Preparing the device for sideloading removes this restriction.

El comando azsphere device enable-development configura el dispositivo para que acepte las aplicaciones desde un equipo para la depuración y carga el servidor de depuración en el dispositivo.The azsphere device enable-development command configures the device to accept applications from a PC for debugging and loads the debugging server onto the device. Además, asigna el dispositivo a un grupo de dispositivos que no permite las actualizaciones de la aplicación en la nube.It also assigns the device to a device group that does not allow cloud application updates. Durante el desarrollo y la depuración de aplicaciones, debe dejar el dispositivo en este grupo para que las actualizaciones de las aplicaciones en la nube no sobrescriban la aplicación en desarrollo.During application development and debugging, you should leave the device in this group so that cloud application updates do not overwrite the application under development.

Para preparar el dispositivoTo prep your device

  1. Asegúrese de que el dispositivo de Azure Sphere esté conectado al equipo y de que el equipo esté conectado a Internet.Make sure that your Azure Sphere device is connected to your PC, and your PC is connected to the internet.

  2. En la ventana del Símbolo del sistema para desarrolladores de Azure Sphere, escriba los comandos siguientes:In an Azure Sphere Developer Command Prompt window, type the following command:

    azsphere device enable-development
    

    Debería ver un resultado similar al siguiente:You should see output similar to the following:

    Getting device capability configuration for application development.
    Downloading device capability configuration for device ID '<device ID>'.
    Successfully downloaded device capability configuration.
    Successfully wrote device capability configuration file 'C:\Users\user\AppData\Local\Temp\tmpD732.tmp'.
    Setting device group ID 'a6df7013-c7c2-4764-8424-00cbacb431e5' for device with ID '<device ID>'.
    Successfully disabled over-the-air updates.
    Enabling application development capability on attached device.
    Applying device capability configuration to device.
    Successfully applied device capability configuration to device.
    The device is rebooting.
    Installing debugging server to device.
    Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
    Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
    Application development capability enabled.
    Successfully set up device '<device ID>' for application development, and disabled over-the-air updates.
    Command completed successfully in 00:00:38.3299276.
    

El dispositivo permanecerá habilitado para la depuración y cerrado a actualizaciones de la aplicación en la nube hasta que lo cambie explícitamente.The device remains enabled for debugging and closed to cloud application updates until you explicitly change it. Para deshabilitar la depuración y permitir las actualizaciones de la aplicación, use el comando azsphere device enable-cloud-test.To disable debugging and allow application updates, use the azsphere device enable-cloud-test command.

  1. Si no está familiarizado con Visual Studio, consulte el Inicio rápido o el Tour guiado para obtener información sobre cómo navegar por él y utilizarlo.If you are new to Visual Studio, consider the Quickstart or Guided Tour to learn about navigating and using it.

  2. En Visual Studio, cree un nuevo proyecto basado en la plantilla de Blink para Azure Sphere.In Visual Studio, create a new project based on the Azure Sphere Blink template. Escriba un nombre y una ubicación para el proyecto y seleccione Aceptar.Enter a name and location for the project and select OK. El proyecto se abre con main.c en el editor.The project opens with main.c in the editor.

  3. Si usa un hardware en el que no se puede acceder a GPIO 9, cambie el GPIO.If you are using hardware on which GPIO 9 is not accessible, change the GPIO. Por ejemplo, en la placa Mini Dev de Seeed, cambie de GPIO 9 a GPIO 7:For example, on the Seeed Mini Dev Board, change GPIO 9 to GPIO 7:

    • En app_manifest.json, cambie de "Gpio": [ 9 ], a "Gpio": [ 7 ],.In app_manifest.json, change "Gpio": [ 9 ], to "Gpio": [ 7 ],
    • En main.c, edite la llamada a GPIO_OpenAsOutput para especificar GPIO 7 en lugar de GPIO 9:In main.c, edit the call to GPIO_OpenAsOutput to specify GPIO 7 instead of GPIO 9:
      int fd = GPIO_OpenAsOutput(7, GPIO_OutputMode_PushPull, GPIO_Value_High);
  4. En Visual Studio, seleccione Ver>Salida para mostrar la ventana de salida.In Visual Studio, select View>Output to display the Output window.

  5. Asegúrese de que el dispositivo esté conectado al equipo mediante USB.Ensure that your device is connected to your PC by USB. A continuación, seleccione Depurador GDB remoto (HLCore) en la barra de menús o presione F5.Then select GDB Debugger (HLCore) from the menu bar or press F5.

    Botón Depurador GDB remoto

  6. Si se le solicita que compile el proyecto, seleccione .If you are prompted to build the project, select Yes. Visual Studio compila la aplicación, crea un paquete de imágenes, lo transfiere localmente a la placa y lo inicia en modo de depuración.Visual Studio compiles the application, creates an image package, sideloads it onto the board, and starts it in debug mode. Por transferencia local se entiende que la aplicación se entrega directamente desde el equipo mediante una conexión con cable, en lugar de entregarse mediante la nube.Sideloading means that the application is delivered directly from the PC over a wired connection, rather than delivered through the cloud.

    Sugerencia

    Anote la ruta de acceso en la salida de compilación, que indica la ubicación del paquete de imágenes de salida en el equipo.Note the path in the Build output, which indicates the location of the output image package on your PC. Usará el paquete de imágenes más adelante en el tutorial de inicio rápido de implementación.You'll use the image package later in the Deployment Quickstart.

  7. De forma predeterminada, la ventana Salida muestra la salida Salida del dispositivo.By default, the Output window shows output from Device Output. Para ver los mensajes del depurador, seleccione Depurar desde el menú desplegable Mostrar resultados desde: .To see messages from the debugger, select Debug from the Show output from: dropdown menu. También puede inspeccionar el desensamblado del programa, los registros o la memoria a través del menú Depurar>Windows.You can also inspect the program disassembly, registers, or memory through the Debug>Windows menu.

  8. Al ejecutar el programa, verá que un LED parpadea.When you run the program, you should see an LED blink.

Pasos siguientesNext steps

En este tutorial de inicio rápido se mostró cómo preparar el dispositivo de Azure Sphere para la depuración, y cómo compilar y depurar una aplicación de alto nivel.This quickstart showed how to prepare your Azure Sphere device for debugging and how to build and debug a high-level application.

A continuación:Next: