aboutsummaryrefslogtreecommitdiffstats
path: root/lib/4a-hal-utilities/4a-hal-utilities-data.h
blob: c0513736cd09e1b9d4e243f977e96ec3fc6eaf10 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
/*
 * Copyright (C) 2018 "IoT.bzh"
 * Author Jonathan Aillet <jonathan.aillet@iot.bzh>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef _HAL_UTILITIES_DATA_INCLUDE_
#define _HAL_UTILITIES_DATA_INCLUDE_

#include <stdio.h>

#include <wrap-json.h>

#include <afb/afb-binding.h>

#include <ctl-config.h>

#include "4a-hal-utilities-alsa-data.h"

#define HAL_UNKNOWN_DEVICE	-1

#define HAL_STREAM_UPDATES_EVENT_NAME		"stream-updates"

// Enum for hal status
enum HalStatus {
	HAL_STATUS_UNAVAILABLE = 0,
	HAL_STATUS_AVAILABLE = 1,
	HAL_STATUS_READY = 2
};

// Enum for probed devices (dependencies) class
enum ProbedDeviceClasses {
	INVALID_PROBED_DEVICE = 0,
	STATIC_PROBED_DEVICE = 1,
	DYNAMIC_PROBED_DEVICE = 2,
	MANDATORY_PROBED_DEVICE = 3
};

// Enum for probed devices (dependencies) info format requested
enum DependencyInfoJsonFormat {
	DEPENDENCY_COMPACT_JSON = 0,
	DEPENDENCY_FULL_JSON = 1
};

// Enum for probed devices (dependencies) info format requested
enum DependencyStatus {
	UNAVAILABLE_DEPENDENCY = 0,
	AVAILABLE_DEPENDENCY = 1,
	ALL_DEPENDENCY = 2
};

// Structure to store data for audio devices validated by dependencies
struct InternalHalDeviceData {
	int cardNb;
	char *cardId;
	char *cardShortName;
	char *cardLongName;
	char *cardDriver;
	char *cardMixerName;
	char *cardComponents;
	int playbackDeviceNb;
	char *playbackDeviceId;
	char *playbackDeviceName;
	char *extendedCardNb;
};

// Structure to store one provided dependency
struct InternalHalProbedDevice {
	char *uid;
	enum ProbedDeviceClasses deviceClass;
	json_object *requestedDeviceJ;

	struct InternalHalDeviceData *deviceData;

	struct InternalHalProbedDevice *next;
};

// Structure to store stream data
struct InternalHalMixerData {
	char *verb;
	char *verbToCall;
	char *streamCardId;
	afb_event_t event;

	struct InternalHalMixerData *next;
};

// Structure to store specific internal hal data
struct InternalHalData {
	char *mixerApiName;
	char *prefix;
	json_object *halMixerJ;

	struct InternalHalProbedDevice *probedDevicesList;

	struct InternalHalMixerData *streamsData;
	afb_event_t streamUpdates;

	struct InternalHalAlsaMapT *alsaMapT;

	afb_api_t apiHandle;
	CtlConfigT *ctrlConfig;
};

// Structure to store specific hal (internal or external) data
struct HalData {
	char *apiName;
	enum HalStatus status;
	char *sndCardPath;
	int sndCardId;
	char *uid;
	char *info;
	unsigned int internal;

	char *author;
	char *version;
	char *date;
	// Can be beefed up if needed

	struct InternalHalData *internalHalData;		// Can be NULL if external api

	struct HalData *next;
};

// Structure to store hal manager data
struct HalMgrData {
	char *apiName;
	char *info;

	afb_api_t apiHandle;

	struct HalData *halDataList;
};

// Internal Hal - Probed devices structure handling functions
enum ProbedDeviceClasses HalUtlGetProbedDeviceClassFromString(char *probedDeviceString);
char *HalUtlGetProbedDeviceClassString(enum ProbedDeviceClasses deviceClass);
struct InternalHalProbedDevice *HalUtlAddProbedDeviceToProbedDeviceList(struct InternalHalProbedDevice **probedDevicesList);
int HalUtlRemoveSelectedProbedDeviceFromList(struct InternalHalProbedDevice **probedDevicesList,
					     struct InternalHalProbedDevice *probedDeviceToRemove);
int HalUtlRemoveAllProbedDevicesFromList(struct InternalHalProbedDevice **probedDevicesList);
int HalUtlGetNumberOfProbedDevicesInList(struct InternalHalProbedDevice **probedDevicesList);
struct InternalHalProbedDevice *HalUtlSearchProbedDeviceDataById(struct InternalHalProbedDevice **probedDevicesList,
								 char *uid);
struct InternalHalDeviceData *HalUtlAllocateAndFillProbedDeviceDataUsingInfoGetResponse(json_object *responseJ);
json_object *HalUtlGetJsonForSpecificDependencies(afb_api_t apiHandle,
						  struct InternalHalProbedDevice *requestedProbedDevice,
						  enum DependencyInfoJsonFormat jsonFormat);
json_object *HalUtlGetJsonForSpecificDependenciesUsingUid(afb_api_t apiHandle,
							  struct InternalHalProbedDevice **probedDevicesList,
							  char *uid,
							  enum DependencyInfoJsonFormat jsonFormat);
json_object *HalUtlGetJsonArrayForAvailableDependencies(afb_api_t apiHandle,
							struct InternalHalProbedDevice **probedDevicesList,
							enum DependencyInfoJsonFormat jsonFormat);
json_object *HalUtlGetJsonArrayForAllDependencies(afb_api_t apiHandle,
						  struct InternalHalProbedDevice **probedDevicesList,
						  enum DependencyInfoJsonFormat jsonFormat);

// Internal Hal - Streams data handling functions
struct InternalHalMixerData *HalUtlAddMixerDataToMixerDataList(struct InternalHalMixerData **mixerDataList);
int HalUtlRemoveSelectedMixerData(struct InternalHalMixerData **mixerDataList,
				  struct InternalHalMixerData *mixerDataToRemove);
int HalUtlRemoveAllMixerData(struct InternalHalMixerData **mixerDataList);
int HalUtlGetNumberOfMixerDataInList(struct InternalHalMixerData **mixerDataList);
struct InternalHalMixerData *HalUtlSearchMixerDataByProperties(struct InternalHalMixerData **mixerDataList,
							       char *verb, char *verbToCall,
							       char *streamCardId);
json_object *HalUtlGetJsonArrayForSpecificMixerData(afb_api_t apiHandle, struct InternalHalMixerData *mixerData);
json_object *HalUtlGetJsonArrayForAllMixersData(afb_api_t apiHandle, struct InternalHalMixerData **mixerDataList);

// Hal data handling functions
struct HalData *HalUtlAddHalToHalList(struct HalData **halDataList);
int HalUtlRemoveSelectedHalFromList(struct HalData **halDataList, struct HalData *halToRemove);
int HalUtlRemoveAllHalFromList(struct HalData **halDataList);
int HalUtlGetNumberOfHalInList(struct HalData **halDataList);
struct HalData *HalUtlSearchHalDataByApiName(struct HalData **halDataList, char *apiName);
struct HalData *HalUtlSearchReadyHalDataByCardId(struct HalData **halDataList, int cardId);

// Hal Manager data handling functions
int HalUtlInitializeHalMgrData(afb_api_t apiHandle, struct HalMgrData *halMgrData, char *apiName, char *info);
void HalUtlRemoveHalMgrData(struct HalMgrData *halMgrData);

#endif /* _HAL_UTILITIES_DATA_INCLUDE_ */