From d4ad9e55cb8e17a4a42b3a94c64e6bc48529b26e Mon Sep 17 00:00:00 2001 From: Mikael Olsson Date: Wed, 7 Feb 2024 11:22:26 +0100 Subject: Restructure kernel driver source tree As a first step to have a clearer separation of the different parts of the kernel driver, the source files have been placed into separate directories according to their purpose and the different parts are only allowed to use headers from another part in the include folder. Files have been renamed accordingly to namespace them by their purpose. Change-Id: I75e09ebf0002c99a22b6d4b09d34504d186c32b3 Signed-off-by: Mikael Olsson --- kernel/include/common/ethosu_buffer.h | 85 +++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 kernel/include/common/ethosu_buffer.h (limited to 'kernel/include/common/ethosu_buffer.h') diff --git a/kernel/include/common/ethosu_buffer.h b/kernel/include/common/ethosu_buffer.h new file mode 100644 index 0000000..868e783 --- /dev/null +++ b/kernel/include/common/ethosu_buffer.h @@ -0,0 +1,85 @@ +/* + * SPDX-FileCopyrightText: Copyright 2020, 2022-2024 Arm Limited and/or its affiliates + * SPDX-License-Identifier: GPL-2.0-only + * + * This program is free software and is provided to you under the terms of the + * GNU General Public License version 2 as published by the Free Software + * Foundation, and any use by you of this program is subject to the terms + * of such GNU licence. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, you can access it online at + * http://www.gnu.org/licenses/gpl-2.0.html. + */ + +#ifndef ETHOSU_BUFFER_H +#define ETHOSU_BUFFER_H + +/**************************************************************************** + * Includes + ****************************************************************************/ + +#include +#include + +/**************************************************************************** + * Types + ****************************************************************************/ + +struct ethosu_dma_mem; +struct ethosu_device; +struct device; + +/** + * struct ethosu_buffer - User data buffer + * @dev: Device + * @file: File + * @kref: Reference counting + * @dma_mem: DMA memory allocated for the buffer + */ +struct ethosu_buffer { + struct device *dev; + struct file *file; + struct kref kref; + struct ethosu_dma_mem *dma_mem; +}; + +/**************************************************************************** + * Functions + ****************************************************************************/ + +/** + * ethosu_buffer_create() - Create buffer + * + * This function must be called in the context of a user space process. + * + * Return: fd on success, else error code. + */ +int ethosu_buffer_create(struct device *dev, + size_t size); + +/** + * ethosu_buffer_get_from_fd() - Get buffer handle from fd + * + * This function must be called from a user space context. + * + * Return: Pointer on success, else ERR_PTR. + */ +struct ethosu_buffer *ethosu_buffer_get_from_fd(int fd); + +/** + * ethosu_buffer_get() - Put buffer + */ +void ethosu_buffer_get(struct ethosu_buffer *buf); + +/** + * ethosu_buffer_put() - Put buffer + */ +void ethosu_buffer_put(struct ethosu_buffer *buf); + +#endif /* ETHOSU_BUFFER_H */ -- cgit v1.2.1