
This directory is intended for PlatformIO Test Runner and project tests.

Unit Testing is a software testing method by which individual units of
source code, sets of one or more MCU program modules together with associated
control data, usage procedures, and operating procedures, are tested to
determine whether they are fit for use. Unit testing finds problems early
in the development cycle.

More information about PlatformIO Unit Testing:
- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html

## How to Install

Make sure `gcc` is installed (run `gcc --version`).

Install relevant local platform for local tests `PIO Home > Platforms > Windows x86 > Install v1.2.0`.

Add to platformio.ini file

```ini
[env:windows_x86]
platform = windows_x86
```

Run tests with

`PlatformIO > Project Tasks > windows_x86 > Advanced > Test`

or

`pio test --environment windows_x86`

## Test display functions by running tests verbose

e.g.,

```bash
$ pio test --environment windows_x86 --verbose
Collected 1 tests (*)

Processing * in windows_x86 environment
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------Building...


Testing...
Bench sign...

##########  ##      ##  ##########                ######    ##      ##  ##########    ######    ##      ##    ######    ########    ##########              ########    ##########    ########    
##  ##  ##  ##      ##  ##                      ##      ##  ##      ##  ##          ##      ##  ##      ##      ##      ##      ##  ##                      ##      ##  ##          ##      ##    
    ##      ##      ##  ##                      ##          ##      ##  ##          ##          ##      ##      ##      ##      ##  ##                      ##      ##  ##          ##
    ##      ##########  ########                ##          ##########  ########      ######    ##########      ##      ########    ########                ########    ########    ##
    ##      ##      ##  ##                      ##          ##      ##  ##                  ##  ##      ##      ##      ##  ##      ##                      ##  ##      ##          ##    ####    
    ##      ##      ##  ##                      ##      ##  ##      ##  ##          ##      ##  ##      ##      ##      ##    ##    ##                      ##    ##    ##          ##      ##    
    ##      ##      ##  ##########                ######    ##      ##  ##########    ######    ##      ##    ######    ##      ##  ##########              ##      ##  ##########    ########    

  ######    ##      ##  ##########  ##      ##  ##########                  ##        ######      ######      ######      ######      ######        ##      ##########    ######      ######      
    ##      ####  ####  ##          ##      ##  ##  ##  ##                ##  ##    ##      ##  ##      ##  ##      ##  ##      ##      ##        ##  ##    ##  ##  ##      ##      ##      ##    
    ##      ##  ##  ##  ##          ####    ##      ##                  ##      ##  ##          ##          ##      ##  ##              ##      ##      ##      ##          ##      ##      ##    
    ##      ##  ##  ##  ########    ##  ##  ##      ##                  ##      ##    ######      ######    ##      ##  ##              ##      ##      ##      ##          ##      ##      ##    
    ##      ##  ##  ##  ##          ##    ####      ##                  ##########          ##          ##  ##      ##  ##              ##      ##########      ##          ##      ##      ##    
    ##      ##      ##  ##          ##      ##      ##                  ##      ##  ##      ##  ##      ##  ##      ##  ##      ##      ##      ##      ##      ##          ##      ##      ##    
  ######    ##      ##  ##########  ##      ##      ##                  ##      ##    ######      ######      ######      ######      ######    ##      ##      ##        ######      ######      

##      ##                          ##########  ##      ##    ######      ######                ##      ##  ##########  ##      ##    ######    ########      ######        ##      ##
##      ##                          ##  ##  ##  ##      ##      ##      ##      ##              ####  ####  ##          ####  ####  ##      ##  ##      ##      ##        ##  ##    ##
####    ##                              ##      ##      ##      ##      ##                      ##  ##  ##  ##          ##  ##  ##  ##      ##  ##      ##      ##      ##      ##  ##
##  ##  ##                              ##      ##########      ##        ######                ##  ##  ##  ########    ##  ##  ##  ##      ##  ########        ##      ##      ##  ##
##    ####                              ##      ##      ##      ##              ##              ##  ##  ##  ##          ##  ##  ##  ##      ##  ##  ##          ##      ##########  ##
##      ##                              ##      ##      ##      ##      ##      ##              ##      ##  ##          ##      ##  ##      ##  ##    ##        ##      ##      ##  ##
##      ##                              ##      ##      ##    ######      ######                ##      ##  ##########  ##      ##    ######    ##      ##    ######    ##      ##  ##########    

            ##      ##      ##        ######                ########    ##              ##        ######    ##########  ########                ##      ##  ##########  ########    ##########    
            ##      ##    ##  ##    ##      ##              ##      ##  ##            ##  ##    ##      ##  ##          ##      ##              ##      ##  ##          ##      ##  ##



---------------------------------------------------------------------------------- windows_x86:* [PASSED] Took 1.29 seconds ----------------------------------------------------------------------------------

=================================================================================================== SUMMARY ===================================================================================================Environment    Test    Status    Duration
-------------  ------  --------  ------------
uno            *       SKIPPED
windows_x86    *       SKIPPED   00:00:01.288
================================================================================== 0 test cases: 0 succeeded in 00:00:01.288 ==================================================================================
```
