Skip to content

Add instructions to enable video overlay #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sjakki88 merged 2 commits into from
Feb 25, 2026
Merged

Add instructions to enable video overlay #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0d099c
rework enable overlays section for visual clarity
abinjose-qualcomm Feb 25, 2026
96a55ef
add instructions to enable video driver
abinjose-qualcomm Feb 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 58 additions & 21 deletions topic/k2c-qli-build-ga/enable_dtb_overlay.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,31 +1,68 @@
.. _enable_dtb_overlay:

Enable camera overlays
^^^^^^^^^^^^^^^^^^^^^^

.. note::
This section applies only to QCS6490, IQ-9075 and IQ-8275.

When you flash and boot ``qcom-multimedia-proprietary-image``, the upstream
camera stack is enabled by default. You can change this by updating the
EFI variable setting.

EFI variable setting must be updated at runtime, after booting the device.
On the first boot, set the EFI variable using the sysfs node and reboot to get
CAMX enabled in subsequent boots.

Run the following commands to apply the DTB Overlay:

.. container:: nohighlight

::

# The -n option is mandatory for EFI variables
# Expect the exact data without trailing newline characters.
echo -n "camx" > /tmp/overlay

# The EFI variable used to control the overlays loaded during UEFI
# boot is 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays.
# Use efivar to write the data into the runtime EFI variable
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /tmp/overlay

# Print the EFI variable for confirmation
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p

# Reboot to reflect the changes
sync
reboot

Enable upstream video driver
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Comment thread
abinjose-qualcomm marked this conversation as resolved.
Resolved
.. note::
This section applies only to the IQ‑615‑EVK.

IQ‑615‑EVK supports only the upstream video driver ``venus``. The video overlay functionality is
not supported.

@sbanerjeeqc sbanerjeeqc Feb 25, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we please add the driver name here to be clear which is the upstream drive module.

@abinjose-qualcomm abinjose-qualcomm Feb 25, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clarified upstream video driver name as venus


When you flash and boot ``qcom-multimedia-proprietary-image``, the upstream
camera stack is enabled by default. You can change this by updating the
EFI variable setting.
When you flash and boot ``qcom-multimedia-proprietary-image`` the upstream video driver is
not enabled by default. This can be changed by updating the kernel module configuration.

EFI variable setting must be updated at runtime, after booting the device.
On the first boot, set the EFI variable using the sysfs node and reboot to get
CAMX enabled in subsequent boots.
Run the following command to enable the upstream video driver:

Run the following commands to apply the DTB Overlay:
.. container:: nohighlight

.. container:: nohighlight
::

::
update-alternatives --install /etc/modprobe.d/blacklist-video.conf blacklist-video /etc/modprobe.d/blacklist-video.conf.vidc 200

# The -n option is mandatory for EFI variables
# Expect the exact data without trailing newline characters.
echo -n "camx" > /tmp/overlay
After rebooting the device, you can run ``lsmod`` to confirm if the changes have been applied.

# The EFI variable used to control the overlays loaded during UEFI
# boot is 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays.
# Use efivar to write the data into the runtime EFI variable
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /tmp/overlay
.. container:: nohighlight

# Print the EFI variable for confirmation
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
::

# Reboot to reflect the changes
sync
reboot
lsmod | grep venus
# Expected Output
# venus_enc 28672 0
# venus_dec 28672 0
8 changes: 6 additions & 2 deletions topic/k2c-qli-build-ga/flash_images.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -571,7 +571,9 @@ Flash software using QDL

To verify the updated software version, see `Verify the Qualcomm Linux version <https://docs.qualcomm.com/bundle/publicresource/topics/80-80020-251/set_up_the_device.html#verify-the-qualcomm-linux-version>`__.

.. include:: enable_dtb_overlay.rst
.. note::
The correct camera driver and video driver may not be enabled by default for certain kits. To enable
them, see :doc:`this document <enable_dtb_overlay>`.

.. note:: If flashing fails, perform the following steps and retry the flashing procedure:

Expand Down Expand Up @@ -690,7 +692,9 @@ Flash software using PCAT

The device reboots after the flashing procedure completes successfully. To verify the updated software version, see `Verify the Qualcomm Linux version <https://docs.qualcomm.com/bundle/publicresource/topics/80-80020-251/set_up_the_device.html#verify-the-qualcomm-linux-version>`__.

.. include:: enable_dtb_overlay.rst
.. note::
The correct camera driver and video driver may not be enabled by default for certain kits. To enable
them, see :doc:`this document <enable_dtb_overlay>`.

Related topics
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down
Loading