Illustrated C/C++ source sheets, symbol index, API relationship graph, compiler console and debug trace

LIVE AI / FLEXIBLE SENSING / FLIGHT CONTEXT

Sensoraia API

Live AI and sensing, connected to the flight.
See, listen, inspect and return supported results while airborne.

Loading...
Searching...
No Matches
ear_camera_backend.h
Go to the documentation of this file.
1/*
2 * Copyright 2026 OpenUAS
3 * SPDX-License-Identifier: Apache-2.0
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18/**
19 * @file ear_camera_backend.h
20 * @brief EAR-specific startup configuration behind USHER's generic backend interface.
21 * @details Lifecycle hooks are serial-owner-only. The backend owns bounded
22 * finalization and sensor-to-point conversion; USHER owns transport/correlation.
23 */
24#ifndef USHER_EAR_CAMERA_BACKEND_H
25#define USHER_EAR_CAMERA_BACKEND_H
26
27#include "camera_backend.h"
28
29/**
30 * @brief Return the EAR backend descriptor by value; its session hook table has static lifetime.
31 * @return Descriptor advertising point-session capability, not optical still capture.
32 */
34/**
35 * @brief Copy an ALSA PCM name before initialization or worker startup.
36 * @param device Nonempty bounded ALSA name, such as default or plughw:CARD=USB,DEV=0.
37 * @return True when copied; false for invalid input or active lifecycle state.
38 * @details Caller memory may be released on return. Simulation is selected separately.
39 */
40bool ear_camera_backend_set_device(const char *device);
41/**
42 * @brief Select deterministic synthetic audio before initialization, bypassing ALSA.
43 * @param lat_deg Fixed source latitude, degrees.
44 * @param lon_deg Fixed source longitude, degrees.
45 * @param level_db_at_1m Simulated level at one metre; a test model, not measured calibration.
46 */
47void ear_camera_backend_set_simulated_source(double lat_deg, double lon_deg, double level_db_at_1m);
48/**
49 * @brief Forward startup tone-band selection to the audio adapter.
50 * @param low_cut_hz Lower band edge, hertz.
51 * @param high_cut_hz Upper band edge, hertz; valid ordering is the CLI caller's responsibility.
52 */
53void ear_camera_backend_set_band(double low_cut_hz, double high_cut_hz);
54
55#endif
Shared capability and lifecycle contract for USHER camera backends.
struct camera_backend ear_camera_backend_get(void)
Return the EAR backend descriptor by value; its session hook table has static lifetime.
void ear_camera_backend_set_band(double low_cut_hz, double high_cut_hz)
Forward startup tone-band selection to the audio adapter.
bool ear_camera_backend_set_device(const char *device)
Copy an ALSA PCM name before initialization or worker startup.
void ear_camera_backend_set_simulated_source(double lat_deg, double lon_deg, double level_db_at_1m)
Select deterministic synthetic audio before initialization, bypassing ALSA.
Function table describing one backend's owned camera operations.