entropy.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016 ARM Ltd.
 * Copyright (c) 2017 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_ENTROPY_H_
#define ZEPHYR_INCLUDE_DRIVERS_ENTROPY_H_

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

#define ENTROPY_BUSYWAIT  BIT(0)


typedef int (*entropy_get_entropy_t)(const struct device *dev,
                                     uint8_t *buffer,
                                     uint16_t length);

typedef int (*entropy_get_entropy_isr_t)(const struct device *dev,
                                         uint8_t *buffer,
                                         uint16_t length,
                                         uint32_t flags);

__subsystem struct entropy_driver_api {
        entropy_get_entropy_t     get_entropy;
        entropy_get_entropy_isr_t get_entropy_isr;
};


static inline const struct device *entropy_get_default_device(void)
{
        const struct device *device = DEVICE_DT_GET_OR_NULL(DT_CHOSEN(zephyr_entropy));
 
#ifdef CONFIG_ARCH_HAS_ENTROPY
        if (device == NULL) {
                extern const struct device *const z_arch_entropy_dev;
 
                device = z_arch_entropy_dev;
        }
#endif
 
        return device;
}

__syscall int entropy_get_entropy(const struct device *dev,
                                  uint8_t *buffer,
                                  uint16_t length);
 
static inline int z_impl_entropy_get_entropy(const struct device *dev,
                                             uint8_t *buffer,
                                             uint16_t length)
{
        const struct entropy_driver_api *api = DEVICE_API_GET(entropy, dev);
 
        __ASSERT(api->get_entropy != NULL,
                "Callback pointer should not be NULL");
        return api->get_entropy(dev, buffer, length);
}

static inline int entropy_get_entropy_isr(const struct device *dev,
                                          uint8_t *buffer,
                                          uint16_t length,
                                          uint32_t flags)
{
        const struct entropy_driver_api *api = DEVICE_API_GET(entropy, dev);
 
        if (unlikely(api->get_entropy_isr == NULL)) {
                return -ENOSYS;
        }
 
        return api->get_entropy_isr(dev, buffer, length, flags);
}
 
 
#ifdef __cplusplus
}
#endif

 
#include <zephyr/syscalls/entropy.h>
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_ENTROPY_H_ */