1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
4  *
5  * @File	ctresource.h
6  *
7  * @Brief
8  * This file contains the definition of generic hardware resources for
9  * resource management.
10  *
11  * @Author	Liu Chun
12  * @Date 	May 13 2008
13  */
14 
15 #ifndef CTRESOURCE_H
16 #define CTRESOURCE_H
17 
18 #include <linux/types.h>
19 
20 enum RSCTYP {
21 	SRC,
22 	SRCIMP,
23 	AMIXER,
24 	SUM,
25 	DAIO,
26 	NUM_RSCTYP	/* This must be the last one and less than 16 */
27 };
28 
29 struct rsc_ops;
30 
31 struct rsc {
32 	u32 idx:12;	/* The index of a resource */
33 	u32 type:4;	/* The type (RSCTYP) of a resource */
34 	u32 conj:12;	/* Current conjugate index */
35 	u32 msr:4;	/* The Master Sample Rate a resource working on */
36 	void *ctrl_blk;	/* Chip specific control info block for a resource */
37 	struct hw *hw;	/* Chip specific object for hardware access means */
38 	const struct rsc_ops *ops;	/* Generic resource operations */
39 };
40 
41 struct rsc_ops {
42 	void (*master)(struct rsc *rsc); /* Move to master resource */
43 	void (*next_conj)(struct rsc *rsc); /* Move to next conjugate resource */
44 	int (*index)(const struct rsc *rsc); /* Return the index of resource */
45 	/* Return the output slot number */
46 	int (*output_slot)(const struct rsc *rsc);
47 };
48 
49 int
50 rsc_init(struct rsc *rsc, u32 idx, enum RSCTYP type, u32 msr, struct hw *hw);
51 int rsc_uninit(struct rsc *rsc);
52 
53 struct rsc_mgr {
54 	enum RSCTYP type; /* The type (RSCTYP) of resource to manage */
55 	unsigned int amount; /* The total amount of a kind of resource */
56 	unsigned int avail; /* The amount of currently available resources */
57 	unsigned char *rscs; /* The bit-map for resource allocation */
58 	void *ctrl_blk; /* Chip specific control info block */
59 	struct hw *hw; /* Chip specific object for hardware access */
60 };
61 
62 /* Resource management is based on bit-map mechanism */
63 int rsc_mgr_init(struct rsc_mgr *mgr, enum RSCTYP type,
64 		 unsigned int amount, struct hw *hw);
65 int rsc_mgr_uninit(struct rsc_mgr *mgr);
66 int mgr_get_resource(struct rsc_mgr *mgr, unsigned int n, unsigned int *ridx);
67 int mgr_put_resource(struct rsc_mgr *mgr, unsigned int n, unsigned int idx);
68 
69 #endif /* CTRESOURCE_H */
70