.. | .. |
---|
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__*/ |
---|