

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# UI para IDT para el conjunto de calificación FreeRTOS 2.0 (FRQ 2.0)
<a name="lts-device-tester-ui"></a>

AWS IoT Device Tester for FreeRTOS  (IDT for FreeRTOS) incluye una interfaz de usuario (UI) basada en la web en la que puede interactuar con la aplicación de línea de comandos de IDT y los archivos de configuración relacionados. Utilice la IU de IDT para FreeRTOS para crear una nueva configuración o modificar una existente para el dispositivo. También puede usar la IU para llamar a la aplicación de IDT y ejecutar las pruebas de FreeRTOS en su dispositivo.

Para obtener información sobre cómo utilizar la línea de comandos para ejecutar pruebas de calificación, consulte [Primera prueba de su placa de microcontrolador](lts-qual-steps.md).

En esta sección se describen los requisitos previos de la IU de IDT para FreeRTOS y cómo ejecutar las pruebas de calificación desde la IU.

**Topics**
+ [Configurar los requisitos previos de IDT](#lts-dev-tester-ui-prereqs)
+ [Configure las credenciales para usar la interfaz de usuario de IDT AWS](lts-configure-aws-credentials.md)
+ [Apertura de la IU de IDT para FreeRTOS](lts-open-idt-ui.md)
+ [Creación de una nueva configuración](lts-create-new-configuration.md)
+ [Modificación de una configuración existente](lts-modify-existing-configuration.md)
+ [Ejecución de pruebas de calificación](lts-run-tests-from-ui.md)

## Configurar los requisitos previos de IDT
<a name="lts-dev-tester-ui-prereqs"></a>

Para realizar pruebas a través de la interfaz de usuario AWS IoT Device Tester (IDT) para FreeRTOS, debe cumplir los requisitos previos de la página de IDT FreeRTOS [Configurar los requisitos previos de calificación LTS](lts-idt-dev-tester-prereqs.md) Qualification (FRQ) 2.x.

# Configure las credenciales para usar la interfaz de usuario de IDT AWS
<a name="lts-configure-aws-credentials"></a>

Debe configurar las credenciales de usuario de IAM para el AWS usuario en [Crea una AWS cuenta](lts-idt-dev-tester-prereqs.md#lts-config-aws-account) el que creó. Puede especificar sus credenciales de una de las dos formas siguientes:
+ En un archivo de credenciales
+ Como variables de entorno.

## Configure AWS las credenciales con un archivo de credenciales
<a name="lts-config-cred-file"></a>

IDT utiliza el mismo archivo de credenciales que la AWS CLI. Para obtener más información, consulte [Configuración y archivos de credenciales](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).

La ubicación del archivo de credenciales varía en función del sistema operativo que utilice:
+ **macOS y Linux**: `~/.aws/credentials`
+ **Windows**: `C:\Users\UserName\.aws\credentials`

Añada sus AWS credenciales al `credentials` archivo en el siguiente formato:

```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```

**nota**  
Si no usa el `default` AWS perfil, debe especificar el nombre del perfil en la interfaz de usuario de IDT para FreeRTOS. Para obtener más información sobre los perfiles, consulte [Opciones de los archivos de configuración y credenciales](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).

## Configure AWS las credenciales con variables de entorno
<a name="lts-config-env-vars"></a>

Las variables de entorno son las variables que mantiene el sistema operativo y utilizan los comandos del sistema. No se guardan si cierra la sesión de SSH. La interfaz de usuario de IDT para Freertos usa `AWS_ACCESS_KEY_ID` las variables de entorno `AWS_SECRET_ACCESS_KEY` y para almacenar AWS sus credenciales.

Para establecer estas variables en Linux, MacOS, o Unix, utilice **export**:

```
export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key
```

Para establecer estas variables en Windows, utilice **set**:

```
set AWS_ACCESS_KEY_ID=your_access_key_id
set AWS_SECRET_ACCESS_KEY=your_secret_access_key
```

# Apertura de la IU de IDT para FreeRTOS
<a name="lts-open-idt-ui"></a>

En este tema se explica cómo abrir la IU de IDT para FreeRTOS para usar el conjunto de calificación de FreeRTOS.

**Para abrir la IU de IDT para FreeRTOS**

1. Descargue una versión compatible de IDT para FreeRTOS. A continuación, extraiga el archivo descargado a un directorio para el que tenga permisos de lectura y escritura.

1. Vaya al directorio de instalación de IDT para FreeRTOS:

   ```
   cd devicetester-extract-location/bin 
   ```

1. Ejecute el siguiente comando para abrir la IU de IDT para FreeRTOS:

------
#### [ Linux ]

   ```
   .devicetester_ui_linux_x86-64
   ```

------
#### [ Windows ]

   ```
   ./devicetester_ui_win_x64-64
   ```

------
#### [ macOS ]

   ```
   ./devicetester_ui_mac_x86-64
   ```

**nota**  
En macOS, para permitir que su sistema ejecute la IU, vaya a **Preferencias del sistema -> Seguridad y privacidad**. Cuando ejecute las pruebas, es posible que tenga que hacerlo tres veces más. 

------

   La IU de IDT para FreeRTOS se abre en el navegador predeterminado. Las tres últimas versiones principales de los siguientes navegadores son compatibles con la IU:
   + Google Chrome
   + Mozilla Firefox
   + Microsoft Edge
   + Apple Safari para macOS
**nota**  
Para una mejor experiencia, recomendamos Google Chrome o Mozilla Firefox para acceder a la IU de IDT para FreeRTOS. La IU no admite Microsoft Internet Explorer. 
**importante**  
Debe configurar sus AWS credenciales antes de abrir la interfaz de usuario. Si no ha configurado sus credenciales, cierre la ventana del navegador de la IU de IDT para FreeRTOS, siga los pasos que se indican en [Configure las credenciales para usar la interfaz de usuario de IDT AWS](lts-configure-aws-credentials.md) y, a continuación, vuelva a abrir la IU de IDT para FreeRTOS.

# Creación de una nueva configuración
<a name="lts-create-new-configuration"></a>

Si es la primera vez que lo usa, debe crear una nueva configuración para configurar los archivos de configuración JSON que IDT para FreeRTOS necesita para ejecutar las pruebas. A continuación, puede ejecutar pruebas o modificar la configuración creada.

Para ver ejemplos de los archivos `config.json`, `device.json` y `userdata.json`, consulte [Primera prueba de su placa de microcontrolador](lts-qual-steps.md).

**Para crear una nueva configuración**

1. En la IU de IDT para FreeRTOS, abra el menú de navegación y elija **Crear nueva configuración**.  
![\[Interfaz Device Tester for FreeRTOS con el botón “Crear nueva configuración” e información sobre la autocomprobación automática de los microcontroladores.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-create-configuration.png)

1. Siga las instrucciones del asistente de configuración para introducir los ajustes de configuración de IDT que se utilizan para ejecutar las pruebas de calificación. El asistente configura los siguientes ajustes en los archivos de configuración JSON ubicados en el directorio `devicetester-extract-location/config`.
   + **Configuración de dispositivos**: la configuración del grupo de dispositivos para los dispositivos que se van a probar. Estos ajustes se configuran en los campos `id` y `sku`, y el bloque de **dispositivos** para el grupo de dispositivos en el archivo `config.json`.  
![\[Pantalla de configuración de Device Tester for FreeRTOS con campos de identificador y SKU para configurar un grupo de dispositivos, opciones de configuración de dispositivos como el método de conectividad, el aprovisionamiento de claves, la configuración de PKCS #11, los campos de entrada de detalles del dispositivo y controles para añadir dispositivos o identificadores.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-device-settings.png)
   + **AWS configuración de la cuenta**: la Cuenta de AWS información que IDT for FreeRTOS utiliza para AWS crear recursos durante las pruebas. Estos ajustes se configuran en el archivo `config.json`.  
![\[Cuenta de AWS página de configuración con campos para la región de la cuenta, las credenciales, la ubicación como archivo o entorno y el nombre del perfil\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-account-settings.png)
   + **Implementación de FreeRTOS**: la ruta absoluta al repositorio y al código portado de FreeRTOS, y a la versión de FreeRTOS en la que desea ejecutar IDT FRQ. Las rutas a los archivos de cabecera de ejecución y configuración de parámetros del `FreeRTOS-Libraries-Integration-Tests` GitHub repositorio. Los comandos build y flash de su hardware que permiten a IDT crear e instalar las pruebas en su placa automáticamente. Estos ajustes se configuran en el archivo `userdata.json`.   
![\[Sección de configuración de implementación de FreeRTOS con rutas de repositorio, rutas de ejecución de pruebas, versión de FreeRTOS, detalles de la herramienta de compilación y configuración de la herramienta flash.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-implementation-settings.png)
   + **Etiquetas PKCS 11 y servidor Echo**: las etiquetas [PKCS 11](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html) que corresponden a las claves aprovisionadas en su hardware según la funcionalidad de las clave y el método de aprovisionamiento de claves. Los ajustes de configuración del servidor echo para las pruebas de la interfaz de transporte. Estos ajustes se configuran en los archivos `userdata.json` y `device.json`.   
![\[Etiquetas PKCS #11 y configuraciones de servidores de Eco con campos de entrada para las etiquetas clave, el método de generación de claves y el número de puerto del servidor\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-pkcs11-settings.png)
   + **Over-the-air Actualizaciones (OTA)**: la configuración que controla las pruebas de funcionalidad de las OTA. Estos ajustes se configuran en el bloque de `features` de los archivos `device.json` y `userdata.json`.   
![\[Opciones de configuración de actualización de OTA: omitir pruebas, protocolos de datos, rutas de firmware, ruta de certificación PAL, firma de código, hash/sign algoritmos, certificados de trusted/untrusted firmante, archivo de certificado de firmante, compilación de certificados de firmante, plataforma de firmante.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-ota-settings.png)

1. En la página **Revisar**, compruebe la información de configuración.  
![\[La configuración creó un cuadro de diálogo para Device Tester for FreeRTOS, que muestra detalles sobre la creación de una nueva configuración de prueba con opciones para editar o ejecutar pruebas.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/gsg-configuration-created.png)

Cuando termine de revisar la configuración, para ejecutar las pruebas de calificación, elija **Ejecutar pruebas**.

# Modificación de una configuración existente
<a name="lts-modify-existing-configuration"></a>

Si ya ha configurado los archivos de configuración de IDT para FreeRTOS, puede utilizar la IU de IDT para FreeRTOS para modificar la configuración existente. Los archivos de configuración existentes deben estar ubicados en el directorio `devicetester-extract-location/config`.

**Para modificar una configuración**

1. En la IU de IDT para FreeRTOS, abra el menú de navegación y elija **Editar configuración existente**.

   El panel de configuración muestra información sobre los ajustes de configuración existentes. Si una configuración es incorrecta o no está disponible, el estado de esa configuración es `Error validating configuration`.   
![\[Pantalla de configuración con el dispositivo Cuenta de AWS, la implementación de Freertos, las etiquetas PKCS y el servidor echo, las over-the-air actualizaciones y las secciones de configuración de ejecución de pruebas que muestran el estado válido.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/modify-existing-configuration.png)

1. Complete los siguientes pasos para modificar un ajuste de configuración existente:

   1. Seleccione el nombre de un ajuste de configuración para abrir su página de ajustes.

   1. Modifique los ajustes y, a continuación, seleccione **Guardar** para volver a generar el archivo de configuración correspondiente.

1. Para modificar la configuración de ejecución de pruebas de IDT para FreeRTOS, elija **Configuración de ejecución de pruebas de IDT** en la vista de edición:  
![\[Cuadro de diálogo de configuración de la prueba de IDT con opciones para seleccionar la prueba, omitir grupos de pruebas, multiplicar el tiempo de espera y detener la prueba en caso de que se produzca el primer error.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/idt-testrun-settings.png)

Cuando termine de modificar la configuración, compruebe que todas las opciones de configuración pasen la validación. Si el estado de cada parámetro de configuración es `Valid`, puede ejecutar las pruebas de calificación con esta configuración.

# Ejecución de pruebas de calificación
<a name="lts-run-tests-from-ui"></a>

Después de crear una configuración para la IU de IDT para FreeRTOS, puede ejecutar las pruebas de calificación.

**Para ejecutar pruebas de calificación**

1. En el menú de navegación, elija **Ejecutar pruebas**.

1. Seleccione **Iniciar pruebas** para iniciar la ejecución de la prueba. De forma predeterminada, todas las pruebas aplicables se ejecutan para la configuración del dispositivo. IDT para FreeRTOS genera un informe de calificación cuando finalizan todas las pruebas.   
![\[La interfaz de Device Tester for FreeRTOS muestra que aún no se ha realizado ninguna prueba, con opciones para crear una nueva configuración, editar la configuración existente y ejecutar pruebas.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/idt-run-tests.png)

IDT para FreeRTOS ejecuta las pruebas de calificación. A continuación, muestra el resumen de la ejecución de la prueba y cualquier error en la consola de **Ejecutor de prueba**. Una vez finalizada la ejecución de la prueba, puede ver los resultados y los registros de la prueba desde las siguientes ubicaciones: 
+ Los resultados de las pruebas se encuentran en el directorio `devicetester-extract-location/results/execution-id`.
+ Los registros de las pruebas se encuentran en el directorio `devicetester-extract-location/results/execution-id/logs`.

Para obtener más información sobre los resultados y registros de las pruebas, consulte [Vea el IDT de forma gratuita RTOSresults](view-results-lts.md) y [Vea el IDT de forma gratuita RTOSlogs](view-logs-lts.md).

![\[Registro de ejecución de Device Tester para FreeRTOS que muestra las pruebas superadas, los grupos de pruebas y las rutas de archivos de los registros e informes.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/idt-results.png)
