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
 
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;
};
 
__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 =
                (const struct entropy_driver_api *)dev->api;
 
        __ASSERT(api->get_entropy != NULL,
                "Callback pointer should not be NULL");
        return api->get_entropy(dev, buffer, length);
}
 
/* Busy-wait for random data to be ready */
#define ENTROPY_BUSYWAIT  BIT(0)
 
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 =
                (const struct entropy_driver_api *)dev->api;
 
        if (unlikely(!api->get_entropy_isr)) {
                return -ENOTSUP;
        }
 
        return api->get_entropy_isr(dev, buffer, length, flags);
}
 
 
#ifdef __cplusplus
}
#endif
 
#include <syscalls/entropy.h>
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_ENTROPY_H_ */