From 870a3bde3d1fd8fe416b6d1d3dd5e7b92fbde174 Mon Sep 17 00:00:00 2001 From: Jacopo Mondi Date: Tue, 6 Dec 2022 14:02:30 +0100 Subject: android: Allow to override config file path from env The HAL config file is assumed to be in the LIBCAMERA_SYSCONF_DIR directory, which is defined by the meson build system at compile time. As the filesystem layout on Android installations might be device/build specific, allow to override such assumption using the LIBCAMERA_HAL_CONFIG_PATH environment variable and document its usage. While at it, remove quotes from the error message, as the file path doesn't contain any space. Signed-off-by: Jacopo Mondi --- Documentation/environment_variables.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) (limited to 'Documentation/environment_variables.rst') diff --git a/Documentation/environment_variables.rst b/Documentation/environment_variables.rst index f092cbbd..ef2794f0 100644 --- a/Documentation/environment_variables.rst +++ b/Documentation/environment_variables.rst @@ -37,6 +37,12 @@ LIBCAMERA_IPA_MODULE_PATH Example value: ``${HOME}/.libcamera/lib:/opt/libcamera/vendor/lib`` +LIBCAMERA_HAL_CONFIG_PATH + Define custom search location for the Android HAL config file + ``camera_hal.yaml`` (`more `__). + + Example value: ``/system/etc/libcamera``, ``/vendor/etc/libcamera`` + Further details --------------- @@ -149,3 +155,15 @@ operation are the installed system path (for example on Debian: ``/usr/local/x86_64-pc-linux-gnu/libcamera``) and the build directory. With the ``LIBCAMERA_IPA_MODULE_PATH``, you can specify a non-default location to search for IPA modules. + +HAL config +~~~~~~~~~~ + +The Android camera HAL requires a configuration file where all built-in cameras +and their properties are enumerated (pluggable cameras, such as UVC cameras do +not need to be described there). The HAL configuration file has to be named +`camera_hal.yaml` and its default location is ``LIBCAMERA_SYSCONF_DIR`` which +can be overridden by using the ``LIBCAMERA_HAL_CONFIG_PATH`` environment +variable. + +`Examples `__ -- cgit v1.2.1