From bd20730b802b1220fe67062c541eea35f6c93731 Mon Sep 17 00:00:00 2001 From: gaoxu Date: Mon, 25 Aug 2025 09:21:05 +0800 Subject: [PATCH] docs(cam): add ldo initialization note when use MIPI camera --- docs/en/api-reference/peripherals/camera_driver.rst | 5 +++++ docs/zh_CN/api-reference/peripherals/camera_driver.rst | 6 ++++++ 2 files changed, 11 insertions(+) diff --git a/docs/en/api-reference/peripherals/camera_driver.rst b/docs/en/api-reference/peripherals/camera_driver.rst index e86e9d8294..c02b6937f7 100644 --- a/docs/en/api-reference/peripherals/camera_driver.rst +++ b/docs/en/api-reference/peripherals/camera_driver.rst @@ -69,6 +69,11 @@ Camera controller driver can be implemented in one of following ways: esp_cam_ctlr_handle_t handle = NULL; 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 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`. diff --git a/docs/zh_CN/api-reference/peripherals/camera_driver.rst b/docs/zh_CN/api-reference/peripherals/camera_driver.rst index 7cfafc968b..e9b920d60f 100644 --- a/docs/zh_CN/api-reference/peripherals/camera_driver.rst +++ b/docs/zh_CN/api-reference/peripherals/camera_driver.rst @@ -69,6 +69,12 @@ esp_cam_ctlr_handle_t handle = NULL; 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 摄像头控制器驱动程序可以通过 ISP 外设实现，需要应用 :cpp:type:`esp_cam_ctlr_isp_dvp_cfg_t` 指定的配置。