1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Greybus operations
4  *
5  * Copyright 2015-2016 Google Inc.
6  */
7 
8 #ifndef _GB_AUDIO_MANAGER_H_
9 #define _GB_AUDIO_MANAGER_H_
10 
11 #include <linux/kobject.h>
12 #include <linux/list.h>
13 
14 #define GB_AUDIO_MANAGER_NAME "gb_audio_manager"
15 #define GB_AUDIO_MANAGER_MODULE_NAME_LEN 64
16 #define GB_AUDIO_MANAGER_MODULE_NAME_LEN_SSCANF "63"
17 
18 struct gb_audio_manager_module_descriptor {
19 	char name[GB_AUDIO_MANAGER_MODULE_NAME_LEN];
20 	int vid;
21 	int pid;
22 	int intf_id;
23 	unsigned int ip_devices;
24 	unsigned int op_devices;
25 };
26 
27 struct gb_audio_manager_module {
28 	struct kobject kobj;
29 	struct list_head list;
30 	int id;
31 	struct gb_audio_manager_module_descriptor desc;
32 };
33 
34 /*
35  * Creates a new gb_audio_manager_module_descriptor, using the specified
36  * descriptor.
37  *
38  * Returns a negative result on error, or the id of the newly created module.
39  *
40  */
41 int gb_audio_manager_add(struct gb_audio_manager_module_descriptor *desc);
42 
43 /*
44  * Removes a connected gb_audio_manager_module_descriptor for the specified ID.
45  *
46  * Returns zero on success, or a negative value on error.
47  */
48 int gb_audio_manager_remove(int id);
49 
50 /*
51  * Removes all connected gb_audio_modules
52  *
53  * Returns zero on success, or a negative value on error.
54  */
55 void gb_audio_manager_remove_all(void);
56 
57 /*
58  * Retrieves a gb_audio_manager_module_descriptor for the specified id.
59  * Returns the gb_audio_manager_module_descriptor structure,
60  * or NULL if there is no module with the specified ID.
61  */
62 struct gb_audio_manager_module *gb_audio_manager_get_module(int id);
63 
64 /*
65  * Decreases the refcount of the module, obtained by the get function.
66  * Modules are removed via gb_audio_manager_remove
67  */
68 void gb_audio_manager_put_module(struct gb_audio_manager_module *module);
69 
70 /*
71  * Dumps the module for the specified id
72  * Return 0 on success
73  */
74 int gb_audio_manager_dump_module(int id);
75 
76 /*
77  * Dumps all connected modules
78  */
79 void gb_audio_manager_dump_all(void);
80 
81 #endif /* _GB_AUDIO_MANAGER_H_ */
82