bitarray.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_SYS_BITARRAY_H_
#define ZEPHYR_INCLUDE_SYS_BITARRAY_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stddef.h>
#include <stdint.h>
 
#include <kernel.h>
 
struct sys_bitarray {
        /* Number of bits */
        uint32_t num_bits;
 
        /* Number of bundles */
        uint32_t num_bundles;
 
        /* Bundle of bits */
        uint32_t *bundles;
 
        /* Spinlock guarding access to this bit array */
        struct k_spinlock lock;
};
 
typedef struct sys_bitarray sys_bitarray_t;
 
#define SYS_BITARRAY_DEFINE(name, total_bits)                           \
        uint32_t _sys_bitarray_bundles_##name                           \
                [(((total_bits + 8 - 1) / 8) + sizeof(uint32_t) - 1)    \
                 / sizeof(uint32_t)] = {0U};                            \
        sys_bitarray_t name = {                                         \
                .num_bits = total_bits,                                 \
                .num_bundles = (((total_bits + 8 - 1) / 8)              \
                                + sizeof(uint32_t) - 1)                 \
                               / sizeof(uint32_t),                      \
                .bundles = _sys_bitarray_bundles_##name,                \
        }
 
int sys_bitarray_set_bit(sys_bitarray_t *bitarray, size_t bit);
 
int sys_bitarray_clear_bit(sys_bitarray_t *bitarray, size_t bit);
 
int sys_bitarray_test_bit(sys_bitarray_t *bitarray, size_t bit, int *val);
 
int sys_bitarray_test_and_set_bit(sys_bitarray_t *bitarray, size_t bit, int *prev_val);
 
int sys_bitarray_test_and_clear_bit(sys_bitarray_t *bitarray, size_t bit, int *prev_val);
 
int sys_bitarray_alloc(sys_bitarray_t *bitarray, size_t num_bits,
                       size_t *offset);
 
int sys_bitarray_free(sys_bitarray_t *bitarray, size_t num_bits,
                      size_t offset);
 
bool sys_bitarray_is_region_set(sys_bitarray_t *bitarray, size_t num_bits,
                                size_t offset);
 
bool sys_bitarray_is_region_cleared(sys_bitarray_t *bitarray, size_t num_bits,
                                    size_t offset);
 
int sys_bitarray_set_region(sys_bitarray_t *bitarray, size_t num_bits,
                            size_t offset);
 
int sys_bitarray_clear_region(sys_bitarray_t *bitarray, size_t num_bits,
                              size_t offset);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_SYS_BITARRAY_H_ */