attribute_test_example.c File Reference

On-target integration test for the MAXM86161 driver. More...

#include <stdio.h>
#include <stdbool.h>
#include <errno.h>
#include "common_data.h"
#include "maxm86161.h"
#include "no_os_delay.h"
#include "no_os_print_log.h"

Include dependency graph for attribute_test_example.c:

Macros
#define	TEST_FAIL(fmt, ...)
#define	TEST_PASS()
#define	TEST_ASSERT_TRUE(cond)
#define	TEST_ASSERT_FALSE(cond)
#define	TEST_ASSERT_EQUAL(expected, actual)
#define	TEST_ASSERT_EQUAL_INT(expected, actual)
#define	TEST_ASSERT_NOT_NULL(ptr)
#define	RUN_TEST(dev, fn)

Typedefs
typedef void(*	maxm86161_test_fn) (struct maxm86161_dev *dev)

Functions
int	example_main (void)
	Basic example main executiont.

Detailed Description

On-target integration test for the MAXM86161 driver.

Author

Jan Carlo Roleda (janca.nosp@m.rlo..nosp@m.roled.nosp@m.a@an.nosp@m.alog..nosp@m.com)

Copyright 2026(c) Analog Devices, Inc.

SPDX-License-Identifier: BSD-3-Clause

Hardware-in-the-loop (HIL) integration test for the MAXM86161.

This example mirrors the offline unit-test suite in tests/maxm86161/test/test_maxm86161.c, but runs against a real device over the live I2C bus instead of CMock stubs. Where the unit tests assert the driver produced the right mock traffic, this harness performs full write-then-read-back round trips: every setter is followed by its matching getter, confirming the value actually reached the silicon and reads back unchanged. It also re-checks the parameter-validation and FIFO-decode logic that the unit tests cover, plus a short live acquisition sanity check that only a real sensor can exercise.

A tiny Unity-style assertion layer keeps the test bodies readable and prints a PASS/FAIL line per check followed by a summary, so the same test-case structure as the unit suite is preserved on-target. The run is non-destructive: the original device state is not restored, so re-flash or power-cycle before switching to a measurement example.

Macro Definition Documentation

RUN_TEST

#define RUN_TEST	(		dev,
			fn )

Value:

run_test(dev, fn, #fn)

TEST_ASSERT_EQUAL

#define TEST_ASSERT_EQUAL	(		expected,
			actual )

Value:

        do {            \
        long _e = (long)(expected);             \
        long _a = (long)(actual);               \
        if (_e == _a)                       \
            TEST_PASS();                    \
        else                            \
            TEST_FAIL("expected %ld, got %ld", _e, _a); \
    } while (0)

TEST_ASSERT_EQUAL_INT

#define TEST_ASSERT_EQUAL_INT	(		expected,
			actual )

Value:

    TEST_ASSERT_EQUAL(expected, actual)

TEST_ASSERT_FALSE

#define TEST_ASSERT_FALSE

(

cond

)

Value:

        do {                    \
        if (!(cond))                        \
            TEST_PASS();                    \
        else                            \
            TEST_FAIL("expected false: %s", #cond);     \
    } while (0)

TEST_ASSERT_NOT_NULL

#define TEST_ASSERT_NOT_NULL

(

ptr

)

Value:

        do {                    \
        if ((ptr) != NULL)                  \
            TEST_PASS();                    \
        else                            \
            TEST_FAIL("expected non-NULL: %s", #ptr);   \
    } while (0)

TEST_ASSERT_TRUE

#define TEST_ASSERT_TRUE

(

cond

)

Value:

        do {                    \
        if (cond)                       \
            TEST_PASS();                    \
        else                            \
            TEST_FAIL("expected true: %s", #cond);      \
    } while (0)

TEST_FAIL

#define TEST_FAIL	(		fmt,
			... )

Value:

        do {                    \
        checks_failed++;                    \
        current_test_failed = true;             \
        pr_err("    ASSERT FAIL (%s:%d): " fmt "\n",        \
               __func__, __LINE__, ##__VA_ARGS__);      \
    } while (0)

TEST_PASS

#define TEST_PASS

(

)

Value:

        do {                        \
        checks_passed++;                    \
    } while (0)

Typedef Documentation

maxm86161_test_fn

typedef void(* maxm86161_test_fn) (struct maxm86161_dev *dev)

Function Documentation

example_main()

int example_main

(

void

)

Basic example main executiont.

Basic example main execution.

Returns

ret - Result of the example execution. If working correctly, will execute continuously the while(1) loop and will not return.

Basic example main executiont.

• 50 ADC readings with delay.
• Threshold event (non-blocking).

  Returns

  ret - Result of the example execution. If working correctly, will execute continuously the while(1) loop and will not return.

  Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute print the sample data.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute continuously the while(1) loop and will not return.

Basic example main executiont.

Returns

ret - 0 on success.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute continuously function iio_app_run and will not return.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute continuously the iio_app_run and will not return.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will measure active and reactive energy and RMS for channel A and for voltage stopping whenever an interrupt occurs and resulting in a stoppage of the measurement.

Basic example main executiont.

Returns

ret - Result of the example execution.

Basic example main executiont.

This example demonstrates basic ADMT4000 functionality by continuously reading sensor values and displaying them on the console.

Returns

0 in case of success, negative error code otherwise.

Basic example main executiont.

Returns

status - Result of the example execution.

Basic example main executiont.

Brings up the full JESD204 link between the FPGA and the ADRV903X:

1. AD9528 clock synthesizer setup (DEVCLK + SYSREF)
2. SYSREF_REQ GPIO configuration
3. ADXCVR initialization (TX and RX)
4. AXI JESD204 TX and RX controller initialization
5. ADRV903X initialization (firmware load up to PreMcsInit_NonBroadcast)
6. AXI clkgen setup (lane_rate / 66 for JESD204C)
7. JESD204 topology initialization and FSM start FSM drives: MCS (LINK_SETUP/OPT_SETUP_STAGE1/2) + link enable
8. JESD204 link status readback

Returns

0 on success, negative error code on failure.

Basic example main executiont.

Brings up the full JESD204 link and demonstrates DMA data transfer:

1. AD9528 clock synthesizer setup (DEVCLK + SYSREF)
2. SYSREF_REQ GPIO configuration
3. ADXCVR initialization (TX and RX)
4. AXI JESD204 TX and RX controller initialization
5. ADRV903X initialization (firmware load up to PreMcsInit_NonBroadcast)
6. AXI clkgen setup (lane_rate / 66 for JESD204C)
7. AXI DAC core init — load sine wave LUT into TX DMA buffer
8. AXI ADC core init — reset TPL ADC core + IQ correction
9. TX and RX DMAC initialization
10. JESD204 topology initialization and FSM start FSM drives: MCS (LINK_SETUP/OPT_SETUP_STAGE1/2) + link enable
11. Start TX DMA (continuous sine wave to DAC)
12. Wait 1 s then capture RX DMA samples
13. Print buffer addresses for inspection

Returns

0 on success, negative error code on failure.

Basic example main executiont.

Brings up the full JESD204 link and starts the IIO application loop:

1. AD9528 clock synthesizer setup (DEVCLK + SYSREF)
2. SYSREF_REQ GPIO configuration
3. ADXCVR initialization (TX and RX)
4. AXI JESD204 TX and RX controller initialization
5. ADRV903X initialization (firmware load up to PreMcsInit_NonBroadcast)
6. AXI clkgen setup (lane_rate / 66 for JESD204C)
7. AXI DAC core init — DDS mode (IIO Oscilloscope controls tones)
8. AXI ADC core init — reset TPL + IQ correction
9. RX data offload — normal mode + per-capture XFER_LENGTH + RESETN
10. TX and RX DMAC initialization
11. JESD204 topology initialization and FSM start
12. IIO application init and run (blocking)

Returns

0 on success, negative error code on failure.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute continuously function iio_app_run_with_trigs and will not return.

Basic example main executiont.

Returns

0 in case of success, negative error code otherwise.

Basic example main executiont.

The platform main.c is the real program entry point. It performs platform startup, then calls this no-OS example entry.

Returns

0 on pass, first test/runtime error otherwise.

Basic example main executiont.

Returns

ret - Result of the enabled examples execution.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will execute the code and end at error statement.

Basic example main executiont.

Returns

int

Basic example main executiont.

Returns

0 in case of success, negative error code otherwise

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will turn the status led's on and off in the while loop, set some values in the config 2 register, and then return 0.

Basic example main executiont.

Returns

ret - Result of the example execution. If working correctly, will show the user for each channels if there is digital input present or not. It also changes delay values for channel 3 and sets the state for channel 0 to OFF. If all these operations were performed correctly 0 will be returned.

Basic example main executiont.

Returns

ret - Result for the main execution of the example. If working correctly the device's channel 0 will be set to SOURCE mode and also have delay values changed. Counter values for channel 0 will be changed as well and printed afterwards. 0 will be returned at the end in case of succes.

Basic example main executiont.

IIO descriptor and initialization parameter.

IIO app.

Declaring iio_devices structure

Initializing IIO app init param.

Initializing IIO app.

Running the IIO app (use iio_info or osc in terminal).

Set the threshold voltage to 5V

The comparator output will be available on the GPO_A pin

Set the DAC output on channel C to 5V

Measure input current on channel D

GPIO Pin Interrupt Controller

UART init params

IIO application descriptor

IIO application initialization parameters

iio axi adc configurations.

iio axi dac configurations.

iio instance descriptor.

iio instance descriptor.

iio device instance descriptor.

UART init params

IIO application descriptor

IIO application initialization parameters

iio axi adc configurations.

iio axi dac configurations.

iio instance descriptor.

iio instance descriptor.

iio device instance descriptor.

Negative temperature

Positive temperature

Negative temperature

Positive temperature

Switch to APG mode

Switch to AWG mode

Parameter to be passed when the callback is called.

GPIO Pin Interrupt Controller

MAX14906 Initialization

Setting SLED set bit 1 in the config register.

Turning the Status LEDs on, then off.

Setting a current limit for channel 0.

Read current limit for all channels.

Setting the on state for channel 0, and then verifying it.

IIO descriptor and initialization parameter.

Channel configuration to be used in the example.

IIO app.

Declaring iio_devices structure

Initializing IIO app init param.

Initializing IIO app.

Running the IIO app (use iio_info or osc in terminal).

Maximum value of 3V.

The increment of the AO1 to be used (needs to be smaller then the SR step-size).

Frequency of the signal.

Initializing GPIO 0 of MAX22017.

Setting its value to HIGH.

Changing operation mode of MAX22017.

Changing configuration of MAX22017.

Changing slew-rate configuration of MAX22017.

Reading the GAIN correction.