Emulator interface

Emulators used to test drivers and higher-level code that uses them. More...

Modules
	I2C Emulation Interface
	I2C Emulation Interface.
	SPI Emulation Interface
	SPI Emulation Interface.
	eSPI Emulation Interface
	eSPI Emulation Interface

Data Structures
struct	emul_link_for_bus
struct	emul_list_for_bus
struct	emul

Macros
#define	EMUL_REG_NAME(node_id)   (_CONCAT(__emulreg_, node_id))
#define	EMUL_DEFINE(init_ptr, node_id, cfg_ptr)

Typedefs
typedef int(*	emul_init_t) (const struct emul *emul, const struct device *parent)

Functions
int	emul_init_for_bus_from_list (const struct device *dev, const struct emul_list_for_bus *list)

Detailed Description

Emulators used to test drivers and higher-level code that uses them.

Macro Definition Documentation

EMUL_DEFINE

#define EMUL_DEFINE	(		init_ptr,
			node_id,
			cfg_ptr
	)

#include <include/drivers/emul.h>

Value:

        static struct emul EMUL_REG_NAME(node_id)               \
        __attribute__((__section__(".emulators"))) __used = {   \
                .init = (init_ptr),                             \
                .dev_label = DT_LABEL(node_id),                 \
                .cfg = (cfg_ptr),                               \
        };

Define a new emulator

This adds a new struct emul to the linker list of emulations. This is typically used in your emulator's DT_INST_FOREACH_STATUS_OKAY() clause.

Parameters

init_ptr	function to call to initialise the emulator (see emul_init typedef)
node_id	Node ID of the driver to emulate (e.g. DT_DRV_INST(n))
cfg_ptr	emulator-specific configuration data

EMUL_REG_NAME

#define EMUL_REG_NAME

(

node_id

)

(_CONCAT(__emulreg_, node_id))

#include <include/drivers/emul.h>

Typedef Documentation

emul_init_t

typedef int(* emul_init_t) (const struct emul *emul, const struct device *parent)

#include <include/drivers/emul.h>

Standard callback for emulator initialisation providing the initialiser record and the device that calls the emulator functions.

Parameters

emul	Emulator to init
parent	Parent device that is using the emulator

Function Documentation

emul_init_for_bus_from_list()

int emul_init_for_bus_from_list	(	const struct device *	dev,
		const struct emul_list_for_bus *	list
	)

#include <include/drivers/emul.h>

Set up a list of emulators

Parameters

dev	Device the emulators are attached to (e.g. an I2C controller)
list	List of devices to set up

Returns

0 if OK

negative value on error