Merge branch 'docs/update_camera_mipi_docs' into 'master'

docs(cam): add ldo initialization note when use MIPI camera

Closes DOC-11987

See merge request espressif/esp-idf!41316
This commit is contained in:
Gao Xu
2025-08-25 10:10:37 +08:00
2 changed files with 11 additions and 0 deletions

View File

@@ -69,6 +69,11 @@ Camera controller driver can be implemented in one of following ways:
esp_cam_ctlr_handle_t handle = NULL; esp_cam_ctlr_handle_t handle = NULL;
ESP_ERROR_CHECK(esp_cam_new_csi_ctlr(&csi_config, &handle)); ESP_ERROR_CHECK(esp_cam_new_csi_ctlr(&csi_config, &handle));
The CSI in {IDF_TARGET_NAME} requires stable 2.5V power supply. Please refer to the schematic diagram to ensure that the power supply pins are connected to 2.5V power before using the MIPI CSI driver.
.. only:: SOC_GP_LDO_SUPPORTED
In {IDF_TARGET_NAME}, the CSI can be powered by the internal adjustable LDO. Please connect the LDO channel output pin to the CSI power supply pin. Then, before initializing the CSI driver, use the API provided in :doc:`/api-reference/peripherals/ldo_regulator` to configure the LDO to output 2.5 V voltage.
.. only:: SOC_ISP_DVP_SUPPORTED .. only:: SOC_ISP_DVP_SUPPORTED
A camera controller driver can be implemented by the ISP DVP peripheral, which requires the configuration that specified by :cpp:type:`esp_cam_ctlr_isp_dvp_cfg_t`. A camera controller driver can be implemented by the ISP DVP peripheral, which requires the configuration that specified by :cpp:type:`esp_cam_ctlr_isp_dvp_cfg_t`.

View File

@@ -69,6 +69,12 @@
esp_cam_ctlr_handle_t handle = NULL; esp_cam_ctlr_handle_t handle = NULL;
ESP_ERROR_CHECK(esp_cam_new_csi_ctlr(&csi_config, &handle)); ESP_ERROR_CHECK(esp_cam_new_csi_ctlr(&csi_config, &handle));
{IDF_TARGET_NAME} 中的 CSI 控制器需要稳定的 2.5V 电源供电,请查阅原理图,确保在使用 MIPI CSI 驱动之前,已将其供电管脚连接至 2.5V 电源。
.. only:: SOC_GP_LDO_SUPPORTED
在 {IDF_TARGET_NAME} 中CSI 控制器可以使用内部的可调 LDO 供电。请将 LDO 通道的输出管脚连接至 CSI 控制器的供电管脚。然后在初始化 CSI 驱动之前,使用 :doc:`/api-reference/peripherals/ldo_regulator` 中提供的 API 配置 LDO 输出 2.5 V 电压。
.. only:: SOC_ISP_DVP_SUPPORTED .. only:: SOC_ISP_DVP_SUPPORTED
摄像头控制器驱动程序可以通过 ISP 外设实现,需要应用 :cpp:type:`esp_cam_ctlr_isp_dvp_cfg_t` 指定的配置。 摄像头控制器驱动程序可以通过 ISP 外设实现,需要应用 :cpp:type:`esp_cam_ctlr_isp_dvp_cfg_t` 指定的配置。