Running Hardware Tests

This document provides instructions on running tests on hardware using the Unity framework. These tests call the Arduino APIs to execute and verify functionality.

Test Environment Setup

Note

The development environment setup is (currently) only supported on Linux 🐧.
As many tools and scripts are not cross-platform, some of them will not directly work on Windows 🔡 or macOS 🍎.

Important

To successfully run the tests, ensure that your development environment is properly configured.
See the section on Environment Setup.

Board Setup

  1. Connect your PSOC™ 6 board (e.g. CY8CKIT-062S2-AI) to your computer 💻 via USB.

  2. Make the board-to-board pin connections as described below:

    CY8CKIT-062S2-AI:

    Pin Connections for HIL Test Setup Between 2 Boards

    Test Name

    Board 1 Pin

    Board 2 Pin

    Description

    UART

    P10_1

    P10_0

    UART TX to RX

    P10_0

    P10_1

    UART RX to TX

    P9_4

    P9_4

    IO synch signal

    GND

    GND

    Common Ground

    Wire 1

    P0_2

    P0_2

    I2C SCL to SCL (with pullup)

    P0_3

    P0_3

    I2C SDA to SDA (with pullup)

    GND

    GND

    Common Ground

    SPI

    P9_0

    P9_0

    MOSI to MOSI

    P9_1

    P9_1

    MISO to MISO

    P9_2

    P9_2

    SCLK to SCLK

    P9_3

    P9_3

    GPIO pin as SPI SSEL

    P9_4

    P9_4

    IO synch signal

    GND

    GND

    Common Ground

    Advanced IO Pulse

    P9_5

    P9_5

    IO5 (Pulse Output) to

    IO5 (Pulse Input)

    P9_4

    P9_4

    IO synch signal

    Pin Connections for HIL Test Setup Between Board and Sensor

    Test Name

    Board Pin

    Sensor Pin

    Description

    One Wire DS18x20

    GND

    GND (DS18B20)

    Connects to the ground of the circuit

    3.3V

    VDD (DS18B20)

    Powers the sensor

    P9_0

    DQ Data (DS18B20)

    Data lines (with 4.7kΩ pull-up resistor to VDD)

    Pin Connections for HIL Test Setup on Single Board

    Test Name

    Board 1 Pin

    Board 1 Pin

    Description

    Digital IO

    P9_6

    P9_7

    IO6 to IO7

    Wire 2

    P0_2

    P9_0

    I2C SCL to SCL (with pullup)

    P0_3

    P9_1

    I2C SDA TO SDA (with pullup)

    SPI

    P9_0

    P9_1

    MOSI and MISO shorted

    P9_2

    NC

    SCLK to SCLK

    Analog IO ADC

    P10_0

    VDDA 3.3V

    A0 connected to VDDA 3.3V

    P10_1

    VoltageDivider

    A1 connected to Voltage

    divider circuit as below:

    VDDA (3.3V)

    :

    [R1] <– Resistor 220 Ohms

    :

    +——-> A1 (Mid-Point)

    :

    [R2] <– Resistor 220 Ohms

    :

    GND (0V)

    Analog IO PWM

    P9_6

    P9_7

    IO6 (PWM feedback) to

    IO7 (PWM Output)

    Advanced IO Tone

    P9_6

    P9_7

    IO6 (Tone feedback) to

    IO7 (Tone Output)

    CY8CPROTO-063-BLE:

    Pin Connections for HIL Test Setup Between 2 Boards

    Test Name

    Board 1 Pin

    Board 2 Pin

    Description

    UART

    P10_1

    P10_0

    UART TX to RX

    P10_0

    P10_1

    UART RX to TX

    P10_2

    P10_2

    IO synch signal

    GND

    GND

    Common Ground

    Wire 1

    P6_4

    P6_4

    I2C SCL to SCL (with pullup)

    P6_5

    P6_5

    I2C SDA to SDA (with pullup)

    GND

    GND

    Common Ground

    SPI

    P9_0

    P9_0

    MOSI to MOSI

    P9_1

    P9_1

    MISO to MISO

    P9_2

    P9_2

    SCLK to SCLK

    P9_3

    P9_3

    GPIO pin as SPI SSEL

    P10_2

    P10_2

    IO synch signal

    GND

    GND

    Common Ground

    Advanced IO Pulse

    P10_5

    P10_5

    IO5 (Pulse Output) to

    IO5 (Pulse Input)

    P10_2

    P10_2

    IO synch signal

    Pin Connections for HIL Test Setup Between Board and Sensor

    Test Name

    Board Pin

    Sensor Pin

    Description

    One Wire DS18x20

    GND

    GND (DS18B20)

    Connects to the ground of the circuit

    3.3V

    VDD (DS18B20)

    Powers the sensor

    P9_0

    DQ Data (DS18B20)

    Data lines (with 4.7kΩ pull-up resistor to VDD)

    Pin Connections for HIL Test Setup on Single Board

    Test Name

    Board 1 Pin

    Board 1 Pin

    Description

    Digital IO

    P12_6

    P12_7

    IO6 to IO7

    Wire 2

    P6_4

    P10_0

    I2C SCL to SCL (with pullup)

    P6_5

    P10_1

    I2C SDA TO SDA (with pullup)

    SPI

    P9_0

    P9_1

    MOSI and MISO shorted

    P9_2

    NC

    SCLK to SCLK

    Analog IO ADC

    P10_3

    VDDA 3.3V

    A0 connected to VDDA 3.3V

    P10_4

    VoltageDivider

    A1 connected to Voltage

    divider circuit as below:

    VDDA (3.3V)

    :

    [R1] <– Resistor 220 Ohms

    :

    +——-> A1 (Mid-Point)

    :

    [R2] <– Resistor 220 Ohms

    :

    GND (0V)

    Analog IO PWM

    P12_6

    P12_7

    IO6 (PWM feedback) to

    IO7 (PWM Output)

    Advanced IO Tone

    P12_6

    P12_7

    IO6 (Tone feedback) to

    IO7 (Tone Output)

Executing Test Cases Using make

The provided Makefile leverages arduino-cli for tasks such as compilation, uploading, and monitoring, while using Unity as a testing framework.

  1. Navigate to the Test Directory:

    cd extras/arduino-core-tests

  2. Run a Specific Test: To execute a specific test, for example, a digital I/O test:

    make FQBN= `FQBN` PORT= `PORT` test_digitalio_single monitor ENABLE_SYNC=0

    • FQBN: select the connected board (e.g., infineon:psoc6:cy8ckit_062s2_ai).

    • PORT: set the appropriate serial port (e.g., /dev/ttyUSB0).

    • monitor : opens the serial monitor to view the test results.

    • ENABLE_SYNC : disable synchronization as this feature is currently used only in CI/CD hil-checks

  3. List All Available Test Targets:

    make list_tests

  4. Display Help for Makefile Targets:

    make help

  5. Start Exploring Other Test Features 🛠️ ! Begin testing other board-specific features with ease!