nvmem.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025 Basalte bv
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_NVMEM_H_
#define ZEPHYR_INCLUDE_NVMEM_H_

 
#include <sys/types.h>
#include <zephyr/device.h>
#include <zephyr/devicetree.h>
#include <zephyr/devicetree/nvmem.h>
 
#ifdef __cplusplus
extern "C" {
#endif

struct nvmem_cell {
        /* @cond INTERNAL_HIDDEN */

        const struct device *dev;
        off_t offset;
        size_t size;
        bool read_only;
 
        /* @endcond */
};

#define NVMEM_CELL_INIT(node_id)                                                                   \
        {                                                                                          \
                .dev = DEVICE_DT_GET(DT_MTD_FROM_NVMEM_CELL(node_id)),                             \
                .offset = DT_REG_ADDR(node_id),                                                    \
                .size = DT_REG_SIZE(node_id),                                                      \
                .read_only = DT_PROP(node_id, read_only),                                          \
        }

#define NVMEM_CELL_GET_BY_NAME(node_id, name) NVMEM_CELL_INIT(DT_NVMEM_CELL_BY_NAME(node_id, name))

#define NVMEM_CELL_INST_GET_BY_NAME(inst, name) NVMEM_CELL_GET_BY_NAME(DT_DRV_INST(inst), name)

#define NVMEM_CELL_GET_BY_NAME_OR(node_id, name, default_value)                                    \
        COND_CODE_1(DT_PROP_HAS_NAME(node_id, nvmem_cells, name),                                  \
                    (NVMEM_CELL_GET_BY_NAME(node_id, name)),                                       \
                    (default_value))

#define NVMEM_CELL_INST_GET_BY_NAME_OR(inst, name, default_value)                                  \
        NVMEM_CELL_GET_BY_NAME_OR(DT_DRV_INST(inst), name, default_value)

#define NVMEM_CELL_GET_BY_IDX(node_id, idx) NVMEM_CELL_INIT(DT_NVMEM_CELL_BY_IDX(node_id, idx))

#define NVMEM_CELL_INST_GET_BY_IDX(inst, idx) NVMEM_CELL_GET_BY_IDX(DT_DRV_INST(inst), idx)

#define NVMEM_CELL_GET_BY_IDX_OR(node_id, idx, default_value)                                      \
        COND_CODE_1(DT_PROP_HAS_IDX(node_id, nvmem_cells, idx),                                    \
                    (NVMEM_CELL_GET_BY_IDX(node_id, idx)),                                         \
                    (default_value))

#define NVMEM_CELL_INST_GET_BY_IDX_OR(inst, idx, default_value)                                    \
        NVMEM_CELL_GET_BY_IDX_OR(DT_DRV_INST(inst), idx, default_value)

int nvmem_cell_read(const struct nvmem_cell *cell, void *data, off_t off, size_t len);

int nvmem_cell_write(const struct nvmem_cell *cell, const void *data, off_t off, size_t len);

static inline bool nvmem_cell_is_ready(const struct nvmem_cell *cell)
{
        return cell != NULL && device_is_ready(cell->dev);
}

static inline bool nvmem_cell_is_read_only(const struct nvmem_cell *cell)
{
        return cell->read_only;
}
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_NVMEM_H_ */