Test cases to verify device objects. More...

Data Structures
struct	init_record

Functions
void	test_dummy_device (void)
	Test device object binding.

void	test_dynamic_name (void)
	Test device binding for existing device.

void	test_bogus_dynamic_name (void)
	Test device binding for non-existing device.

void	test_null_dynamic_name (void)
	Test device binding for passing null name.

static __pinned_func int	add_init_record (bool pre_kernel)

static __pinned_func int	pre1_fn (void)

static __pinned_func int	pre2_fn (void)

static int	post_fn (void)

static int	app_fn (void)

	SYS_INIT (pre1_fn, PRE_KERNEL_1, 0)

	SYS_INIT (pre2_fn, PRE_KERNEL_2, 0)

	SYS_INIT (post_fn, POST_KERNEL, 0)

	SYS_INIT (app_fn, APPLICATION, 0)

static int	null_driver_init (void)

	SYS_INIT (null_driver_init, POST_KERNEL, 0)

void	test_pre_kernel_detection (void)
	Test detection of initialization before kernel services available.

void	test_device_list (void)
	Test system device list query API.

static int	init_fn (void)

	SYS_INIT (init_fn, APPLICATION, 0)

	SYS_INIT_NAMED (init1, init_fn, APPLICATION, 1)

	SYS_INIT_NAMED (init2, init_fn, APPLICATION, 2)

	SYS_INIT_NAMED (init3, init_fn, APPLICATION, 2)

	SYS_INIT_NAMED (init4, init_fn, APPLICATION, 99)

	SYS_INIT_NAMED (init5, init_fn, APPLICATION, 999)

void	test_sys_init_multiple (void)

void	test_device_init_level (void)
	Test initialization level for device driver instances.

void	test_device_init_priority (void)
	Test initialization priorities for device driver instances.

void	test_device_init_sub_priority (void)
	Test initialization sub-priorities for device driver instances.

void	test_abstraction_driver_common (void)
	Test abstraction of device drivers with common functionalities.

void	test_deferred_init (void)

void	test_device_api (void)

void	test_deferred_init_user (void)

void *	user_setup (void)

void	test_mmio_single (void)
	Test DEVICE_MMIO_* macros.

void	test_mmio_multiple (void)
	Test DEVICE_MMIO_NAMED_* macros.

void	test_mmio_toplevel (void)
	Test DEVICE_MMIO_TOPLEVEL_* macros.

void	test_mmio_multireg (void)
	Test DEVICE_MMIO_NAMED_* macros.

Variables
static __pinned_bss struct init_record	init_records [4]

static __pinned_data struct init_record *	rp = init_records

static int	sys_init_counter

int	init_level_sequence [4]

int	init_priority_sequence [4]

int	init_sub_priority_sequence [3]

unsigned int	seq_level_cnt

unsigned int	seq_priority_cnt

Detailed Description

Test cases to verify device objects.

Verify zephyr device driver apis with different device types

Function Documentation

◆ add_init_record()

static __pinned_func int add_init_record ( bool pre_kernel )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ app_fn()

static int app_fn ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ init_fn()

static int init_fn ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ null_driver_init()

static int null_driver_init ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ post_fn()

static int post_fn ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ pre1_fn()

static __pinned_func int pre1_fn ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ pre2_fn()

static __pinned_func int pre2_fn ( void )

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [1/6]

SYS_INIT	(	app_fn	,
		APPLICATION	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [2/6]

SYS_INIT	(	init_fn	,
		APPLICATION	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [3/6]

SYS_INIT	(	null_driver_init	,
		POST_KERNEL	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [4/6]

SYS_INIT	(	post_fn	,
		POST_KERNEL	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [5/6]

SYS_INIT	(	pre1_fn	,
		PRE_KERNEL_1	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT() [6/6]

SYS_INIT	(	pre2_fn	,
		PRE_KERNEL_2	,
		0	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT_NAMED() [1/5]

SYS_INIT_NAMED	(	init1	,
		init_fn	,
		APPLICATION	,
		1	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT_NAMED() [2/5]

SYS_INIT_NAMED	(	init2	,
		init_fn	,
		APPLICATION	,
		2	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT_NAMED() [3/5]

SYS_INIT_NAMED	(	init3	,
		init_fn	,
		APPLICATION	,
		2	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT_NAMED() [4/5]

SYS_INIT_NAMED	(	init4	,
		init_fn	,
		APPLICATION	,
		99	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ SYS_INIT_NAMED() [5/5]

SYS_INIT_NAMED	(	init5	,
		init_fn	,
		APPLICATION	,
		999	)

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ test_abstraction_driver_common()

void test_abstraction_driver_common ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test abstraction of device drivers with common functionalities.

Abstraction of device drivers with common functionalities shall be provided as an intermediate interface between applications and device drivers, where such interface is implemented by individual device drivers. We verify this by following step:

Define a subsystem api for drivers.
Define and create two driver instances.
Two drivers call the same subsystem API, and we verify that each driver instance will call their own implementations.

◆ test_bogus_dynamic_name()

void test_bogus_dynamic_name ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test device binding for non-existing device.

Validates binding of a random device driver(non-defined driver) named "ANOTHER_BOGUS_NAME".

See also: device_get_binding(), DEVICE_DEFINE()

◆ test_deferred_init()

void test_deferred_init ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ test_deferred_init_user()

void test_deferred_init_user ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ test_device_api()

void test_device_api ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ test_device_init_level()

void test_device_init_level ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test initialization level for device driver instances.

After the defined device instances have initialized, we check the sequence number that each driver stored during initialization. If the sequence of initial level stored is corresponding with our expectation, it means assigning the level for driver instance works.

◆ test_device_init_priority()

void test_device_init_priority ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test initialization priorities for device driver instances.

After the defined device instances have initialized, we check the sequence number that each driver stored during initialization. If the sequence of initial priority stored is corresponding with our expectation, it means assigning the priority for driver instance works.

◆ test_device_init_sub_priority()

void test_device_init_sub_priority ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test initialization sub-priorities for device driver instances.

After the defined device instances have initialized, we check the sequence number that each driver stored during initialization. If the sequence of initial priority stored is corresponding with our expectation, it means using the devicetree for sub-priority sorting works.

◆ test_device_list()

void test_device_list ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test system device list query API.

It queries the list of devices in the system, used to suspend or resume the devices in PM applications.

See also: z_device_get_all_static()

◆ test_dummy_device()

void test_dummy_device ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test device object binding.

Validates device binding for an existing and a non-existing device object. It creates a dummy_driver device object with basic init and configuration information and validates its binding.

Validates three kinds situations of driver object:

A non-existing device object.
An existing device object with basic init and configuration information.
A failed init device object.

See also: device_get_binding(), DEVICE_DEFINE()

◆ test_dynamic_name()

void test_dynamic_name ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test device binding for existing device.

Validates device binding for an existing device object.

See also: device_get_binding(), DEVICE_DEFINE()

◆ test_mmio_multiple()

void test_mmio_multiple ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/mmio.c>

Test DEVICE_MMIO_NAMED_* macros.

We show that we can make mapping calls and that the address returned by DEVICE_MMIO_NAMED_GET() is not NULL, indicating that the kernel mapped stuff somewhere.

We show that this works for a device instance that has two named regions, 'corge' and 'grault' that respectively come from DTS instances 1 and 2.

We also perform some checks depending on configuration:

If MMIO addresses are maintained in RAM, check that the ROM struct was populated correctly.
If MMIO addresses are maintained in ROM, check that the DTS info, the ROM region, and the result of DEVICE_MMIO_NAMED_GET() all point to the same address. We show that no extra memory is used in dev_data.

◆ test_mmio_multireg()

void test_mmio_multireg ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/mmio_multireg.c>

Test DEVICE_MMIO_NAMED_* macros.

This is the same as the test_mmio_multiple test but in this test the memory regions are created by the named DT property 'reg'.

See also: test_mmio_multiple

◆ test_mmio_single()

void test_mmio_single ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/mmio.c>

Test DEVICE_MMIO_* macros.

We show that we can make mapping calls and that the address returned by DEVICE_MMIO_GET() is not NULL, indicating that the kernel mapped stuff somewhere.

We also perform some checks depending on configuration:

If MMIO addresses are maintained in RAM, check that the ROM struct was populated correctly.
If MMIO addresses are maintained in ROM, check that the DTS info, the ROM region, and the result of DEVICE_MMIO_GET() all point to the same address. We show that no extra memory is used in dev_data.

◆ test_mmio_toplevel()

void test_mmio_toplevel ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/mmio.c>

Test DEVICE_MMIO_TOPLEVEL_* macros.

We show that we can make mapping calls and that the address returned by DEVICE_MMIO_TOPLEVEL_GET() is not NULL, indicating that the kernel mapped stuff somewhere.

We do this for two different MMIO toplevel instances; one declared statically and one not.

We also perform some checks depending on configuration:

If MMIO addresses are maintained in RAM, check that the ROM struct was populated correctly.
If MMIO addresses are maintained in ROM, check that the DTS info, the ROM region, and the result of DEVICE_MMIO_TOPLEVEL_GET() all point to the same address

◆ test_null_dynamic_name()

void test_null_dynamic_name ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test device binding for passing null name.

Validates device binding for device object when given dynamic name is null.

See also: device_get_binding(), DEVICE_DEFINE()

◆ test_pre_kernel_detection()

void test_pre_kernel_detection ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Test detection of initialization before kernel services available.

Confirms check is correct.

See also: k_is_pre_kernel()

◆ test_sys_init_multiple()

void test_sys_init_multiple ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ user_setup()

void * user_setup ( void )

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Variable Documentation

◆ init_level_sequence

int init_level_sequence[4]

extern

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ init_priority_sequence

int init_priority_sequence[4]

extern

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ init_records

__pinned_bss struct init_record init_records[4]

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ init_sub_priority_sequence

int init_sub_priority_sequence[3]

extern

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ rp

__pinned_data struct init_record* rp = init_records

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ seq_level_cnt

unsigned int seq_level_cnt

extern

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ seq_priority_cnt

unsigned int seq_priority_cnt

extern

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

◆ sys_init_counter

int sys_init_counter

static

#include </home/runner/work/safety-doc/zephyr/tests/kernel/device/src/main.c>

Data Structures

Functions

Variables

Detailed Description

Function Documentation

◆ add_init_record()

◆ app_fn()

◆ init_fn()

◆ null_driver_init()

◆ post_fn()

◆ pre1_fn()

◆ pre2_fn()

◆ SYS_INIT() [1/6]

◆ SYS_INIT() [2/6]

◆ SYS_INIT() [3/6]

◆ SYS_INIT() [4/6]

◆ SYS_INIT() [5/6]

◆ SYS_INIT() [6/6]

◆ SYS_INIT_NAMED() [1/5]

◆ SYS_INIT_NAMED() [2/5]

◆ SYS_INIT_NAMED() [3/5]

◆ SYS_INIT_NAMED() [4/5]

◆ SYS_INIT_NAMED() [5/5]

◆ test_abstraction_driver_common()

◆ test_bogus_dynamic_name()

◆ test_deferred_init()

◆ test_deferred_init_user()

◆ test_device_api()

◆ test_device_init_level()

◆ test_device_init_priority()

◆ test_device_init_sub_priority()

◆ test_device_list()

◆ test_dummy_device()

◆ test_dynamic_name()

◆ test_mmio_multiple()

◆ test_mmio_multireg()

◆ test_mmio_single()

◆ test_mmio_toplevel()

◆ test_null_dynamic_name()

◆ test_pre_kernel_detection()

◆ test_sys_init_multiple()

◆ user_setup()

Variable Documentation

◆ init_level_sequence

◆ init_priority_sequence

◆ init_records

◆ init_sub_priority_sequence

◆ rp

◆ seq_level_cnt

◆ seq_priority_cnt

◆ sys_init_counter