summaryrefslogtreecommitdiff
path: root/Documentation/environment_variables.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/environment_variables.rst')
-rw-r--r--Documentation/environment_variables.rst18
1 files changed, 18 insertions, 0 deletions
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 <HAL config_>`__).
+
+ 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 <https://git.libcamera.org/libcamera/libcamera.git/tree/src/android/data>`__