Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
Jake-Carter committed Oct 4, 2024
1 parent 8a3de52 commit ab65373
Showing 1 changed file with 25 additions and 18 deletions.
43 changes: 25 additions & 18 deletions Examples/MAX32690/Unity_Test/README.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,46 @@
## Description

A basic example showing unit testing.
A basic unit testing example that leverages the Unity Test Project. In this example, a function that adds two `uint8_t` is tested. The tests can be run on the target microcontroller, or from the developer's host PC.

## Software

Unity is configure to work both on target and your local PC.
By running make test you will trigger the test files to be ran on the PC, the compiler can be overwritten, but defaults to gcc.
Additional documentation on the Unity Test Project and its integration with the MSDK can also be found in the [MSDK User Guide](https://analogdevicesinc.github.io/msdk/USERGUIDE/).

## Software

### Project Usage

Universal instructions on building, flashing, and debugging this project can be found in the **[MSDK User Guide](https://analogdevicesinc.github.io/msdk/USERGUIDE/)**.

Alternatively, the unit tests can be run from the developer's host PC with `make test`.

### Project-Specific Build Notes

* This project comes pre-configured for the MAX32655EVKIT. See [Board Support Packages](https://analogdevicesinc.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
- Run `make test` to run the host-side unit tests. This will pull from the `test` folder inside the project and run them on the developer's host PC.

## Required Connections
If using the MAX32655EVKIT (EvKit\_V1):
- Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
- Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0 header.
- Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
- Close jumper JP2 (LED0 EN).
- Close jumper JP3 (LED1 EN).

If using the MAX32655FTHR (FTHR\_Apps\_P1):
- Connect a USB cable between the PC and the J4 (USB/PWR) connector.
- Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
If using the MAX32690EVKIT:
- Connect a USB cable between the PC and the CN2 (USB/PWR) connector.
- Install JP7(RX_EN) and JP8(TX_EN) headers.
- Open a terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
- Close jumper JP5 (LED1 EN).
- Close jumper JP6 (LED2 EN).

If using the MAX32690FTHR:
- Connect a USB cable between the PC and the J5 (USB/PWR) connector.
- Open a terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.

If using the AD-APARD32690-SL:
- Connect a USB cable between the PC and the P10 (USB-C) connector.
- Connect a MAXPICO Debug adapter to P9 (SWD Connector)
- Open a terminal application on the PC and connect to the MAXPICO's console UART at 115200, 8-N-1.

## Expected Output

The Console UART of the device will output these messages:

```
Running Tests
:49::FAIL: Expected 8 Was 7
-----------------------
2 Tests 0 Failures 0 Ignored
OK
```

0 comments on commit ab65373

Please sign in to comment.