Pruebas de lectura de I2C WinRT (eeprom obligatorio)
Las pruebas I2C realizan pruebas funcionales y de esfuerzo de 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 y de esfuerzo básicas y pruebas funcionales avanzadas. El ámbito de las pruebas de las pruebas funcionales básicas incluye:
- Compruebe que se puede acceder a un controlador I2C con el nombre descriptivo especificado 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. I2cDevice::Write/Read/WriteRead() se notifica 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 esfuerzo. 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.
- Compruebe que cuando el dispositivo subordinado 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 escribe WritePartial() y WriteReadPartial() como I2cTransferStatus::P artialTransfer.
- Compruebe que el reloj se extiende hasta 500 ms y no hace que se produzca un error en la transferencia.
- Compruebe que, cuando el dispositivo subordinado contiene la línea de reloj baja durante una duración prolongada (más de 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 microcontroladores que se puede comprar de una variedad de minoristas en línea, como Sparkfun, Digikey y Adafruit. Actualizar el firmware de 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 esta á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 resistencia 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 del bus colgado, el extendido 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:
- Conecte el LPC1768 mbed a través de USB a su 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 sometido a prueba. A continuación, realice las conexiones I2C (pinout mbed),
- Conecte el pin mbed 9 (P0.0/SDA) al pin SDA en el dispositivo sometido a prueba.
- Conectar el pin mbed 10 (P0.1/SCL) al pin de SCL en el dispositivo sometido a prueba
- Conectar mbed GND a un pin de GND en el dispositivo sometido a prueba
El mbed tiene resistencias internas de extracción habilitadas en las líneas SDA y SCL y no requiere resistencias externas de extracción.
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 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
Cambiar los 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 de controlador I2C específica, 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 de prueba completo 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 de problemas manual 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). |