emul.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Nordic Semiconductor ASA
 * Copyright 2020 Google LLC
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_DRIVERS_EMUL_H_
#define ZEPHYR_INCLUDE_DRIVERS_EMUL_H_
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
struct device;
struct emul;
 
struct emul_link_for_bus {
        const char *label;
};
 
struct emul_list_for_bus {
        const struct emul_link_for_bus *children;
        unsigned int num_children;
};
 
typedef int (*emul_init_t)(const struct emul *emul,
                           const struct device *parent);
 
struct emul {
        emul_init_t init;
        const char *dev_label;
        const void *cfg;
        void *data;
};
 
extern const struct emul __emul_list_start[];
extern const struct emul __emul_list_end[];
 
/* Use the devicetree node identifier as a unique name. */
#define EMUL_REG_NAME(node_id) (_CONCAT(__emulreg_, node_id))
 
#define EMUL_DEFINE(init_ptr, node_id, cfg_ptr, data_ptr)                                          \
        static struct emul EMUL_REG_NAME(node_id) __attribute__((__section__(".emulators")))       \
        __used = {                                                                                 \
                .init = (init_ptr),                                                                \
                .dev_label = DT_LABEL(node_id),                                                    \
                .cfg = (cfg_ptr),                                                                  \
                .data = (data_ptr),                                                                \
        };
 
int emul_init_for_bus_from_list(const struct device *dev,
                                const struct emul_list_for_bus *list);
 
const struct emul *emul_get_binding(const char *name);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_EMUL_H_ */