diff --git a/topic/k2c-qli-build-ga/enable_dtb_overlay.rst b/topic/k2c-qli-build-ga/enable_dtb_overlay.rst index b1bcd5e..e713c18 100644 --- a/topic/k2c-qli-build-ga/enable_dtb_overlay.rst +++ b/topic/k2c-qli-build-ga/enable_dtb_overlay.rst @@ -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 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. 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. - 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 \ No newline at end of file + lsmod | grep venus + # Expected Output + # venus_enc 28672 0 + # venus_dec 28672 0 diff --git a/topic/k2c-qli-build-ga/flash_images.rst b/topic/k2c-qli-build-ga/flash_images.rst index e0355c9..8ff7939 100644 --- a/topic/k2c-qli-build-ga/flash_images.rst +++ b/topic/k2c-qli-build-ga/flash_images.rst @@ -571,7 +571,9 @@ Flash software using QDL To verify the updated software version, see `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 `. .. note:: If flashing fails, perform the following steps and retry the flashing procedure: @@ -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 `__. -.. 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 `. Related topics ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^