| .. | .. |
|---|
| 1 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
|---|
| 2 | | -/* Copyright (C) 2012-2018 ARM Limited or its affiliates. */ |
|---|
| 2 | +/* Copyright (C) 2012-2019 ARM Limited (or its affiliates). */ |
|---|
| 3 | 3 | |
|---|
| 4 | 4 | #ifndef __CC_SRAM_MGR_H__ |
|---|
| 5 | 5 | #define __CC_SRAM_MGR_H__ |
|---|
| .. | .. |
|---|
| 10 | 10 | |
|---|
| 11 | 11 | struct cc_drvdata; |
|---|
| 12 | 12 | |
|---|
| 13 | +#define NULL_SRAM_ADDR ((u32)-1) |
|---|
| 14 | + |
|---|
| 13 | 15 | /** |
|---|
| 14 | | - * Address (offset) within CC internal SRAM |
|---|
| 15 | | - */ |
|---|
| 16 | | - |
|---|
| 17 | | -typedef u64 cc_sram_addr_t; |
|---|
| 18 | | - |
|---|
| 19 | | -#define NULL_SRAM_ADDR ((cc_sram_addr_t)-1) |
|---|
| 20 | | - |
|---|
| 21 | | -/*! |
|---|
| 22 | | - * Initializes SRAM pool. |
|---|
| 16 | + * cc_sram_mgr_init() - Initializes SRAM pool. |
|---|
| 23 | 17 | * The first X bytes of SRAM are reserved for ROM usage, hence, pool |
|---|
| 24 | 18 | * starts right after X bytes. |
|---|
| 25 | 19 | * |
|---|
| 26 | | - * \param drvdata |
|---|
| 20 | + * @drvdata: Associated device driver context |
|---|
| 27 | 21 | * |
|---|
| 28 | | - * \return int Zero for success, negative value otherwise. |
|---|
| 22 | + * Return: |
|---|
| 23 | + * Zero for success, negative value otherwise. |
|---|
| 29 | 24 | */ |
|---|
| 30 | 25 | int cc_sram_mgr_init(struct cc_drvdata *drvdata); |
|---|
| 31 | 26 | |
|---|
| 32 | | -/*! |
|---|
| 33 | | - * Uninits SRAM pool. |
|---|
| 27 | +/** |
|---|
| 28 | + * cc_sram_alloc() - Allocate buffer from SRAM pool. |
|---|
| 34 | 29 | * |
|---|
| 35 | | - * \param drvdata |
|---|
| 36 | | - */ |
|---|
| 37 | | -void cc_sram_mgr_fini(struct cc_drvdata *drvdata); |
|---|
| 38 | | - |
|---|
| 39 | | -/*! |
|---|
| 40 | | - * Allocated buffer from SRAM pool. |
|---|
| 41 | | - * Note: Caller is responsible to free the LAST allocated buffer. |
|---|
| 42 | | - * This function does not taking care of any fragmentation may occur |
|---|
| 43 | | - * by the order of calls to alloc/free. |
|---|
| 30 | + * @drvdata: Associated device driver context |
|---|
| 31 | + * @size: The requested bytes to allocate |
|---|
| 44 | 32 | * |
|---|
| 45 | | - * \param drvdata |
|---|
| 46 | | - * \param size The requested bytes to allocate |
|---|
| 33 | + * Return: |
|---|
| 34 | + * Address offset in SRAM or NULL_SRAM_ADDR for failure. |
|---|
| 47 | 35 | */ |
|---|
| 48 | | -cc_sram_addr_t cc_sram_alloc(struct cc_drvdata *drvdata, u32 size); |
|---|
| 36 | +u32 cc_sram_alloc(struct cc_drvdata *drvdata, u32 size); |
|---|
| 49 | 37 | |
|---|
| 50 | 38 | /** |
|---|
| 51 | 39 | * cc_set_sram_desc() - Create const descriptors sequence to |
|---|
| .. | .. |
|---|
| 54 | 42 | * |
|---|
| 55 | 43 | * @src: A pointer to array of words to set as consts. |
|---|
| 56 | 44 | * @dst: The target SRAM buffer to set into |
|---|
| 57 | | - * @nelements: The number of words in "src" array |
|---|
| 45 | + * @nelement: The number of words in "src" array |
|---|
| 58 | 46 | * @seq: A pointer to the given IN/OUT descriptor sequence |
|---|
| 59 | 47 | * @seq_len: A pointer to the given IN/OUT sequence length |
|---|
| 60 | 48 | */ |
|---|
| 61 | | -void cc_set_sram_desc(const u32 *src, cc_sram_addr_t dst, |
|---|
| 62 | | - unsigned int nelement, struct cc_hw_desc *seq, |
|---|
| 63 | | - unsigned int *seq_len); |
|---|
| 49 | +void cc_set_sram_desc(const u32 *src, u32 dst, unsigned int nelement, |
|---|
| 50 | + struct cc_hw_desc *seq, unsigned int *seq_len); |
|---|
| 64 | 51 | |
|---|
| 65 | 52 | #endif /*__CC_SRAM_MGR_H__*/ |
|---|