Unit tests for Direct Memory Access controller driver.

#include <stdint.h>
#include <stdbool.h>
#include <board.h>
#include <sysclk.h>
#include <dma.h>
#include <pmic.h>
#include <tc.h>
#include <sleepmgr.h>
#include <string.h>
#include <unit_test/suite.h>
#include <stdio_serial.h>
#include <conf_test.h>
#include <conf_board.h>

Functions
int	main (void)

Callback functions
static void	dma_transfer_is_complete (enum dma_channel_status status)
	DMA transfer complete callback. More...

static void	timer_overflow_callback (void)
	Timer overflow callback. More...

DMA module test functions
static void	run_dma_memory_copy_burst_length_test (const struct test_case *test)
	Test the different burst lengths by copying on all channels. More...

static void	run_dma_direction_test (const struct test_case *test)
	Test different directions on all channels. More...

static void	run_dma_config_interface_test (const struct test_case *test)
	Set DMA configuration, and read it back. More...

static void	run_dma_triggered_with_callback (const struct test_case *test)
	Test read from fixed location, trigger from timer and callback. More...

static void	run_dma_error_handling_test (const struct test_case *test)
	Test the error handling of the module. More...

static void	run_dma_double_buffering_test (const struct test_case *test)
	Test double buffering mode. More...

Variables
Variables
uint8_t	memory_block_src [MEMORY_BLOCK_SIZE]
	Memory block to read from. More...

uint8_t	memory_block_dest [MEMORY_BLOCK_SIZE]
	Memory block to write to. More...

uint8_t	dest_block_tc [DEST_BLOCK_TC_SIZE]
	Memory block to write to, used by run_dma_triggered_with_callback. More...

uint8_t	expected_result_tc [DEST_BLOCK_TC_SIZE]
	Expected result from trigger/interrupt copy. More...

volatile bool	dma_has_completed = false
	Whether DMA has finished copying, used by run_dma_triggered_with_callback. More...

volatile uint8_t	timer_overflow_counter = 0
	Counter incremented by timer overflow. More...

Helper functions
#define	set_buffer(buffer, value) memset(buffer, value, sizeof(buffer))
	Set all bytes in buffer to value. More...

static void	block_fill (uint8_t *block, uint16_t size)
	Fill a block with a certain pattern. More...

static bool	block_compare (const uint8_t block_1, const uint8_t block_2, uint16_t block_size)
	Compare two 8-bit data blocks of given size. More...

static bool	block_compare_reverse (const uint8_t block_1, const uint8_t block_2, uint16_t block_size)
	Compare two 8-bit data blocks of given size in reverse. More...

static void	dma_transfer_block (dma_channel_num_t channel_num)
	Trigger and wait for a successful transfer. More...

#define set_buffer	(	buffer,
		value
	)	memset(buffer, value, sizeof(buffer))

Set all bytes in buffer to value.

Referenced by run_dma_direction_test(), run_dma_double_buffering_test(), run_dma_memory_copy_burst_length_test(), and run_dma_triggered_with_callback().

static bool block_compare	(	const uint8_t *	block_1,
		const uint8_t *	block_2,
		uint16_t	block_size
	)

static

Compare two 8-bit data blocks of given size.

Note: Compares two blocks of equal size to see if they are equal.

Parameters

block_1	Pointer to first block.
block_2	Pointer to second block.
block_size	Size of blocks to compare.

Referenced by run_dma_direction_test(), run_dma_memory_copy_burst_length_test(), and run_dma_triggered_with_callback().

static bool block_compare_reverse	(	const uint8_t *	block_1,
		const uint8_t *	block_2,
		uint16_t	block_size
	)

static

Compare two 8-bit data blocks of given size in reverse.

Note: Compares two blocks of equal size in reverse to see if they are equal.

Parameters

block_1	Pointer to first block.
block_2	Pointer to second block.
block_size	Size of blocks to compare.

Referenced by run_dma_direction_test().

static void block_fill	(	uint8_t *	block,
		uint16_t	size
	)

static

Fill a block with a certain pattern.

Parameters

block_1	Pointer to block.
block_size	Size of block to fill.

Referenced by run_dma_direction_test(), run_dma_double_buffering_test(), and run_dma_memory_copy_burst_length_test().

static void dma_transfer_block ( dma_channel_num_t channel_num )

static

Trigger and wait for a successful transfer.

Parameters

channel_num Channel number

References DMA_CH_TRANSFER_COMPLETED, dma_channel_trigger_block_transfer(), and dma_get_channel_status().

Referenced by run_dma_direction_test(), and run_dma_memory_copy_burst_length_test().

static void dma_transfer_is_complete ( enum dma_channel_status status )

static

DMA transfer complete callback.

Parameters

status Status of transfer

References DMA_CH_TRANSFER_COMPLETED, dma_has_completed, and tc_disable().

Referenced by run_dma_triggered_with_callback().

static void run_dma_config_interface_test ( const struct test_case * test )

static

Set DMA configuration, and read it back.

Note: This function writes a configuration to the DMA controller, and reads it back to verify settings have been correctly set.

Parameters

test	Current test case

References dma_channel_config::addrctrl, dma_channel_config::ctrla, dma_channel_config::destaddr16, dma_channel_read_config(), dma_channel_reset(), dma_channel_set_burst_length(), dma_channel_set_dest_dir_mode(), dma_channel_set_dest_reload_mode(), dma_channel_set_destination_address(), dma_channel_set_interrupt_level(), dma_channel_set_repeats(), dma_channel_set_single_shot(), dma_channel_set_source_address(), dma_channel_set_src_dir_mode(), dma_channel_set_src_reload_mode(), dma_channel_set_transfer_count(), dma_channel_set_trigger_source(), dma_channel_unset_single_shot(), dma_channel_write_burst_length(), dma_channel_write_config(), dma_channel_write_destination(), dma_channel_write_repeats(), dma_channel_write_source(), dma_channel_write_transfer_count(), dma_disable(), dma_enable(), DMA_NUMBER_OF_CHANNELS, HUGEMEM_NULL, hugemem_write32(), PMIC_LVL_HIGH, dma_channel_config::repcnt, dma_channel_config::srcaddr16, test_assert_true, dma_channel_config::trfcnt, and dma_channel_config::trigsrc.

Referenced by main().

static void run_dma_direction_test ( const struct test_case * test )

static

Test different directions on all channels.

Note: This test copies the source memory block into the destination block in different ways.

Parameters

test	Current test

Referenced by main().

static void run_dma_double_buffering_test ( const struct test_case * test )

static

Test double buffering mode.

Note: This function tests the double buffering feature of the DMA controller by configuring channel 0 and 1 to do the same copy, and verify that the channels enable each other according to the double buffering process.

Parameters

test	Current test case

Referenced by main().

static void run_dma_error_handling_test ( const struct test_case * test )

static

Test the error handling of the module.

Note: Test error handling by disabling a channel which is in use

Parameters

test	Current test

References DMA_CH_TRANSFER_ERROR, dma_channel_disable(), dma_channel_enable(), dma_channel_is_busy(), dma_channel_reset(), dma_channel_trigger_block_transfer(), dma_channel_write_burst_length(), dma_channel_write_destination(), dma_channel_write_source(), dma_channel_write_transfer_count(), dma_disable(), dma_enable(), dma_get_channel_status(), memory_block_dest, memory_block_src, and test_assert_true.

Referenced by main().

static void run_dma_memory_copy_burst_length_test ( const struct test_case * test )

static

Test the different burst lengths by copying on all channels.

Note: This test copies a memory block using different burst lengths, and verifies that they have been copied correctly, thereby testing both burst lengths and memory transfer.

Parameters

test	Current test

Referenced by main().

static void run_dma_triggered_with_callback ( const struct test_case * test )

static

Test read from fixed location, trigger from timer and callback.

Note: This test sets up a timer to trigger the DMA module, which in turn reads the timer_overflow_counter variable and writes it to memory sequentially. It then checks to see that the memory block written is sequential according to the overflow count.

Parameters

test	Current test

References block_compare(), dest_block_tc, dma_channel_enable(), dma_channel_reset(), dma_channel_set_burst_length(), dma_channel_set_dest_dir_mode(), dma_channel_set_dest_reload_mode(), dma_channel_set_destination_address(), dma_channel_set_interrupt_level(), dma_channel_set_single_shot(), dma_channel_set_source_address(), dma_channel_set_src_dir_mode(), dma_channel_set_src_reload_mode(), dma_channel_set_transfer_count(), dma_channel_set_trigger_source(), dma_channel_write_config(), dma_disable(), dma_enable(), dma_has_completed, dma_set_callback(), dma_transfer_is_complete(), expected_result_tc, PMIC_LVL_LOW, set_buffer, success, tc_enable(), tc_set_direction(), tc_set_overflow_interrupt_callback(), tc_set_overflow_interrupt_level(), tc_set_resolution(), TC_UP, tc_write_period(), test_assert_true, timer_overflow_callback(), and timer_overflow_counter.

Referenced by main().

static void timer_overflow_callback ( void )

static

Timer overflow callback.

Note: The callback increments the overflow counter

References timer_overflow_counter.

Referenced by run_dma_triggered_with_callback().

uint8_t dest_block_tc[DEST_BLOCK_TC_SIZE]

Memory block to write to, used by run_dma_triggered_with_callback.

Referenced by run_dma_triggered_with_callback().

volatile bool dma_has_completed = false

Whether DMA has finished copying, used by run_dma_triggered_with_callback.

Referenced by dma_transfer_is_complete(), and run_dma_triggered_with_callback().

uint8_t expected_result_tc[DEST_BLOCK_TC_SIZE]

Initial value:

= {
    0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07,
    0x08, 0x09, 0x0a, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f
}

Expected result from trigger/interrupt copy.

Referenced by run_dma_triggered_with_callback().

uint8_t memory_block_dest[MEMORY_BLOCK_SIZE]

Memory block to write to.

Referenced by run_dma_direction_test(), run_dma_double_buffering_test(), run_dma_error_handling_test(), and run_dma_memory_copy_burst_length_test().

uint8_t memory_block_src[MEMORY_BLOCK_SIZE]

Memory block to read from.

Referenced by run_dma_direction_test(), run_dma_double_buffering_test(), run_dma_error_handling_test(), and run_dma_memory_copy_burst_length_test().

volatile uint8_t timer_overflow_counter = 0

Counter incremented by timer overflow.

Referenced by run_dma_triggered_with_callback(), and timer_overflow_callback().

Microchip® Advanced Software Framework

Functions

Variables

Helper functions