Pruebas de escritura de WinRT de I2C (se requiere EEPROM)
Las pruebas de I2C realizan pruebas funcionales y de esfuerzo de los controladores I2C expuestos al modo de usuario a través de las API de WinRT Windows.Devices.I2c. Las pruebas se dividen en dos partes: pruebas funcionales básicas y de esfuerzo, y pruebas funcionales avanzadas. El ámbito de las pruebas de las pruebas funcionales básicas incluye:
- Comprobación de que un controlador I2C con el nombre descriptivo especificado es accesible desde el modo de usuario.
- Compruebe que los datos se escriben correctamente en un intervalo de velocidades de reloj y longitudes de búfer de hasta 8 bytes (tamaño de página EEPROM).
- Compruebe que los datos se leen correctamente en un intervalo de velocidades de reloj y longitudes de búfer.
- Comprobación de que las secuencias de lectura de reinicio de escritura (WriteRead) se ejecutan correctamente en un intervalo de velocidades de reloj y longitudes de búfer.
- Compruebe que, cuando se intenta escribir, leer o EscribirRead en una dirección subordinada que no se reconoce, el controlador devuelve STATUS_NO_SUCH_DEVICE. Esto se notifica mediante I2cDevice::Write/Read/WriteRead() como HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) y se notifica mediante I2cDevice::WritePartial/ReadPartial/WriteReadPartial() como I2cTransferStatus::SlaveAddressNotAcknowledged.
- Compruebe que las API y los controladores funcionan correctamente en condiciones de estrés. Las pruebas de esfuerzo escriben y leen de dos EEPROM simultáneamente con identificadores de dispositivo independientes durante una duración prolongada.
El ámbito de las pruebas de las pruebas funcionales avanzadas incluye:
- Compruebe que los datos se escriben correctamente para las longitudes de búfer de hasta 16384 bytes.
- Compruebe que se genera una condición de reinicio de I2C en respuesta a una secuencia WriteRead.
- Comprobación de que cuando el dispositivo esclavo NAK está mientras el maestro sigue escribiendo bytes, el controlador completa la solicitud con STATUS_SUCCESS e informa del número real de bytes escritos a través de la información de solicitud. Esto se denomina transferencia parcial y se notifica mediante WritePartial() y WriteReadPartial() como I2cTransferStatus::P artialTransfer.
- Comprobación de que el reloj se extiende hasta 500 ms se permite y no hace que se produzca un error en la transferencia.
- Comprobación de que cuando el dispositivo subordinado contiene la línea de reloj baja durante una duración prolongada (10+ segundos), el controlador completa la transferencia en un máximo de 10 segundos con un código de error. El código de error debe ser STATUS_IO_TIMEOUT, pero esto no se comprueba por motivos de compatibilidad.
Las pruebas funcionales básicas y las pruebas de esfuerzo se ejecutan en dos EEPROM conectados externamente. Las pruebas funcionales avanzadas se ejecutan en un firmware personalizado mbed LPC1768 . El mbed LPC1768 es una popular plataforma de prototipos de microcontrolador que se puede comprar de una variedad de minoristas en línea, como Sparkfun, Digikey y Adafruit. Actualizar el firmware del mbed es tan sencillo como arrastrar y colocar un archivo. El código fuente del firmware está disponible en github. A continuación se proporcionan instrucciones sobre cómo preparar el mbed y ejecutar las pruebas.
Detalles de las pruebas
| Especificaciones |
|
| Plataformas | |
| Versiones admitidas |
|
| Tiempo de ejecución esperado (en minutos) | 5 |
| Categoría | Desarrollo |
| Tiempo de espera (en minutos) | 10 |
| Requiere reinicio | false |
| Requiere una configuración especial | true |
| Tipo | automatic |
Documentación adicional
Las pruebas de este área de características pueden tener documentación adicional, incluidos los requisitos previos, la configuración y la información de solución de problemas, que se pueden encontrar en los temas siguientes:
Ejecución de la prueba
Ejecución de las pruebas funcionales y de esfuerzo básicas
Necesitará el siguiente hardware para ejecutar las pruebas:
- Atmel AT24HC serie EEPROMs qt. 2
- 10 000 resistor qt. 2
- Placa de pruebas
- Cables
Conecte los EEPROM como se muestra en el diagrama siguiente y conecte SDA y SCL al dispositivo en prueba.
Ahora puede programar las pruebas funcionales y de esfuerzo básicas del administrador de HLK.
Ejecución de las pruebas funcionales avanzadas
Las pruebas funcionales avanzadas comprueban el comportamiento de NACKing, las condiciones de autobús colgadas, el ajuste del reloj y los inicios repetidos. Las pruebas requieren que un firmware personalizado mbed LPC1768 se conecte al dispositivo en prueba. Antes de ejecutar las pruebas, debe cargar el firmware HLK en el LPC1768 mbed. A continuación se muestra cómo actualizar el firmware:
- Conecta el LPC1768 mbed a través de USB a tu PC. Se mostrará como una unidad quitable en su PC.
- Abrir la unidad en el Explorador de archivos
- Copie c:\Archivos de programa (x86)\Windows Kits\10\Hardware Lab Kit\Tests\x86\iot\busses-tester-mbed_LPC1768.bin en mbed
- Presione el botón en el mbed para restablecer el microcontrolador.
A continuación, conecte el mbed al dispositivo en prueba. Conecte el mbed a través de USB al dispositivo en prueba. A continuación, realice las conexiones I2C (pinout mbed),
- Conectar el pin mbed 9 (P0.0/SDA) al pin de SDA en el dispositivo sometido a prueba
- Conectar el pin mbed 10 (P0.1/SCL) al pin de SCL del dispositivo en prueba
- Conexión de mbed GND a un pin de GND en el dispositivo en prueba
El mbed tiene resistencias de extracción internas habilitadas en las líneas SDA y SCL y no requiere resistencias de extracción externas.
Ahora puede programar las pruebas funcionales avanzadas desde el administrador de HLK.
Solución de problemas
Para solucionar problemas genéricos de errores de prueba de HLK, consulte Solución de problemas de errores de prueba de HLK de Windows.
Se recomienda ejecutar las pruebas en la línea de comandos para obtener información sobre los errores y para iterar rápidamente en las soluciones. A continuación se muestra cómo ejecutar las pruebas en la línea de comandos:
Copiar %programfiles(x86)%\Windows Kits\10\Testing\Runtimes\TAEF\<arch>\MinTe a c:\data\minte
Copie Windows.Devices.LowLevel.UnitTests.dll de %programfiles(x86)%\Windows Kits\10\Hardware Lab Kit\Tests\arch>\<iot a c:\data en el dispositivo.
Telnet o ssh en el dispositivo
Cambio de directorios a c:\data
Ejecute las pruebas:
minte\te windows.devices.lowlevel.unittests.dll /name:I2c*
Uso de la prueba de línea de comandos:
minte\te windows.devices.lowlevel.unittests.dll [/name:test_name] [/select:select_clause] [/p:I2cFriendlyName=friendly_name] [/p:Duration=duration]
- test_name: el nombre de la prueba que se va a ejecutar, que puede incluir caracteres comodín. Ejemplos: /name:I2c*, /name:I2cEepromWriteTests#metadataSet0::VerifyWrite#metadataSet0
- select_clause: una cláusula de selección de TAEF. Ejemplo: /select:"@name='I2c*' y not(@name='I2cTestsEx*')"
- friendly_name: el nombre descriptivo del controlador I2C sometido a prueba. Si se omite, se usa el primer controlador enumerado. Ejemplos: /p:I2cFriendlyName=I2C0
- duration: cuánto tiempo se ejecutan las pruebas de esfuerzo. Ejemplos: /p:Duration=10s (10 segundos), /p:Duration=1m (1 minuto), /p:Duration=2h (2 horas), /p:Duration=1d (1 día)
Ejemplos:
Para ejecutar las pruebas funcionales básicas,
minte\te windows.devices.lowlevel.unittests.dll /select:"@name='I2c*' and not(@name='I2cTestsEx*')"
Para ejecutar las pruebas funcionales avanzadas,
minte\te windows.devices.lowlevel.unittests.dll /name:I2cTestsEx::*
Para ejecutar las pruebas en una instancia específica del controlador I2C, pase el nombre descriptivo al parámetro de prueba I2cFriendlyName,
minte\te windows.devices.lowlevel.unittests.dll /name:I2c* /p:I2cFriendlyName=I2C0
Para ejecutar una prueba específica, pase el nombre completo de la prueba al parámetro /name:
minte\te windows.devices.lowlevel.unittests.dll /name:I2cNonexistentSlaveAddressTests::TestWriteRead
Para ejecutar las pruebas de esfuerzo durante la duración recomendada de 8 horas, ejecute
minte\te windows.devices.lowlevel.unittests.dll /name:I2cStressTests::StressIoConcurrent /p:Duration=8h
Una herramienta que puede ayudar con la solución manual de problemas es I2cTestTool. I2cTestTool es una utilidad sencilla para interactuar con I2C desde la línea de comandos.
Más información
Parámetros
| Nombre de parámetro | Descripción de los parámetros |
|---|---|
| I2cFriendlyName | Nombre descriptivo del controlador I2C sometido a prueba (por ejemplo, I2C0). |