forked from espressif/esp-idf
Merge branch 'docs/update_cn_peripheral_docs' into 'master'
docs: Update CN translation for three docs in peripherals Closes DOC-9610 See merge request espressif/esp-idf!35243
This commit is contained in:
@@ -23,6 +23,7 @@ Terminology
|
|||||||
- AE: Auto exposure
|
- AE: Auto exposure
|
||||||
- HIST: Histogram
|
- HIST: Histogram
|
||||||
- BF: Bayer noise filter
|
- BF: Bayer noise filter
|
||||||
|
- LSC: Lens Shading Correction
|
||||||
- CCM: Color correction matrix
|
- CCM: Color correction matrix
|
||||||
|
|
||||||
ISP Pipeline
|
ISP Pipeline
|
||||||
@@ -541,7 +542,7 @@ Calling :cpp:func:`esp_isp_lsc_configure` to configure the LSC module to do the
|
|||||||
}
|
}
|
||||||
ESP_ERROR_CHECK(esp_isp_lsc_configure(isp_proc, &lsc_config));
|
ESP_ERROR_CHECK(esp_isp_lsc_configure(isp_proc, &lsc_config));
|
||||||
|
|
||||||
After calling :cpp:func:`esp_isp_lsc_configure`, you need to enable the ISP LSC controller, by calling :cpp:func:`esp_isp_lsc_enable`. The LSC can be disabled by calling :cpp:func:`esp_isp_lsc_disable`. It's allowed to call :cpp:func:`esp_isp_lsc_configure` when the LSC isn't enabled, but the LSC function will only take effect when it's enabled.
|
After calling :cpp:func:`esp_isp_lsc_configure`, you need to enable the ISP LSC controller by calling :cpp:func:`esp_isp_lsc_enable`. The LSC can be disabled by calling :cpp:func:`esp_isp_lsc_disable`. It is allowed to call :cpp:func:`esp_isp_lsc_configure` when the LSC is not enabled, but the LSC function will only take effect when it is enabled.
|
||||||
|
|
||||||
|
|
||||||
.. _isp-color:
|
.. _isp-color:
|
||||||
|
@@ -51,10 +51,6 @@ I2C 从机设备需要 :cpp:type:`i2c_slave_config_t` 指定的配置:
|
|||||||
|
|
||||||
如果不再需要之前安装的 I2C 总线,建议调用 :cpp:func:`i2c_del_slave_device` 来回收资源,以释放底层硬件。
|
如果不再需要之前安装的 I2C 总线,建议调用 :cpp:func:`i2c_del_slave_device` 来回收资源,以释放底层硬件。
|
||||||
|
|
||||||
I2C 从机控制器
|
|
||||||
^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
通过调用 :cpp:func:`i2c_new_slave_device` 安装好 I2C 从机驱动程序后,{IDF_TARGET_NAME} 就可以作为从机与其他 I2C 主机进行通信了。
|
|
||||||
|
|
||||||
I2C 从机写入
|
I2C 从机写入
|
||||||
~~~~~~~~~~~~~
|
~~~~~~~~~~~~~
|
||||||
|
@@ -10,6 +10,12 @@ I2S
|
|||||||
|
|
||||||
I2S(Inter-IC Sound,集成电路内置音频总线)是一种同步串行通信协议,通常用于在两个数字音频设备之间传输音频数据。
|
I2S(Inter-IC Sound,集成电路内置音频总线)是一种同步串行通信协议,通常用于在两个数字音频设备之间传输音频数据。
|
||||||
|
|
||||||
|
.. only:: SOC_LP_I2S_SUPPORTED
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
LP I2S 文档请参阅 :doc:`Low Power Inter-IC Sound <./lp_i2s>`.
|
||||||
|
|
||||||
{IDF_TARGET_NAME} 包含 {IDF_TARGET_I2S_NUM} 个 I2S 外设。通过配置这些外设,可以借助 I2S 驱动来输入和输出采样数据。
|
{IDF_TARGET_NAME} 包含 {IDF_TARGET_I2S_NUM} 个 I2S 外设。通过配置这些外设,可以借助 I2S 驱动来输入和输出采样数据。
|
||||||
|
|
||||||
标准或 TDM 通信模式下的 I2S 总线包含以下几条线路:
|
标准或 TDM 通信模式下的 I2S 总线包含以下几条线路:
|
||||||
|
@@ -23,6 +23,7 @@
|
|||||||
- AE:自动曝光
|
- AE:自动曝光
|
||||||
- HIST:直方图
|
- HIST:直方图
|
||||||
- BF:拜耳域降噪
|
- BF:拜耳域降噪
|
||||||
|
- LSC:镜头阴影校正
|
||||||
- CCM:色彩校正矩阵
|
- CCM:色彩校正矩阵
|
||||||
|
|
||||||
ISP 流水线
|
ISP 流水线
|
||||||
@@ -45,9 +46,9 @@ ISP 流水线
|
|||||||
isp_chs [label = "对比度 &\n 色调 & 饱和度", width = 150, height = 70];
|
isp_chs [label = "对比度 &\n 色调 & 饱和度", width = 150, height = 70];
|
||||||
isp_yuv [label = "YUV 限制\n YUB2RGB", width = 120, height = 70];
|
isp_yuv [label = "YUV 限制\n YUB2RGB", width = 120, height = 70];
|
||||||
|
|
||||||
isp_header -> BF -> 去马赛克 -> CCM -> gamma 校正 -> RGB 转 YUV -> 锐化 -> isp_chs -> isp_yuv -> isp_tail;
|
isp_header -> BF -> LSC -> 去马赛克 -> CCM -> gamma 校正 -> RGB 转 YUV -> 锐化 -> isp_chs -> isp_yuv -> isp_tail;
|
||||||
|
|
||||||
BF -> HIST
|
LSC -> HIST
|
||||||
去马赛克 -> AWB
|
去马赛克 -> AWB
|
||||||
去马赛克 -> AE
|
去马赛克 -> AE
|
||||||
去马赛克 -> HIST
|
去马赛克 -> HIST
|
||||||
@@ -69,6 +70,7 @@ ISP 驱动程序提供以下服务:
|
|||||||
- :ref:`isp-ae-statistics` - 涵盖如何单次或连续获取 AE 统计信息。
|
- :ref:`isp-ae-statistics` - 涵盖如何单次或连续获取 AE 统计信息。
|
||||||
- :ref:`isp-hist-statistics` - 涵盖如何单次或连续获取直方图统计信息。
|
- :ref:`isp-hist-statistics` - 涵盖如何单次或连续获取直方图统计信息。
|
||||||
- :ref:`isp-bf` - 涵盖如何启用和配置 BF 功能。
|
- :ref:`isp-bf` - 涵盖如何启用和配置 BF 功能。
|
||||||
|
- :ref:`isp-lsc` - 涵盖如何启用和配置 LSC 功能。
|
||||||
- :ref:`isp-ccm-config` - 涵盖如何配置 CCM。
|
- :ref:`isp-ccm-config` - 涵盖如何配置 CCM。
|
||||||
- :ref:`isp-demosaic` - 涵盖如何配置去马赛克功能。
|
- :ref:`isp-demosaic` - 涵盖如何配置去马赛克功能。
|
||||||
- :ref:`isp-gamma-correction` - 涵盖如何启用和配置 gamma 校正。
|
- :ref:`isp-gamma-correction` - 涵盖如何启用和配置 gamma 校正。
|
||||||
@@ -509,6 +511,40 @@ ISP BF 控制器
|
|||||||
|
|
||||||
调用 :cpp:func:`esp_isp_bf_disable` 函数会执行相反的操作,即将驱动程序恢复到 **init** 状态。
|
调用 :cpp:func:`esp_isp_bf_disable` 函数会执行相反的操作,即将驱动程序恢复到 **init** 状态。
|
||||||
|
|
||||||
|
|
||||||
|
.. _isp-lsc:
|
||||||
|
|
||||||
|
ISP LSC 控制器
|
||||||
|
~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
镜头阴影校正 (LSC) 旨在解决因相机镜头中光线折射不均而引起的问题。
|
||||||
|
|
||||||
|
可调用 :cpp:func:`esp_isp_lsc_configure` 函数配置 LSC 模块以进行校正。硬件进行校正相关计算时需要用到 :cpp:type:`esp_isp_lsc_gain_array_t` 类型的数据结构。:cpp:func:`esp_isp_lsc_allocate_gain_array` 是一个辅助函数,为增益值分配大小合适的系统存储。
|
||||||
|
|
||||||
|
.. code-block:: c
|
||||||
|
|
||||||
|
esp_isp_lsc_gain_array_t gain_array = {};
|
||||||
|
size_t gain_size = 0;
|
||||||
|
ESP_ERROR_CHECK(esp_isp_lsc_allocate_gain_array(isp_proc, &gain_array, &gain_size));
|
||||||
|
|
||||||
|
esp_isp_lsc_config_t lsc_config = {
|
||||||
|
.gain_array = &gain_array,
|
||||||
|
};
|
||||||
|
isp_lsc_gain_t gain_val = {
|
||||||
|
.decimal = 204,
|
||||||
|
.integer = 0,
|
||||||
|
};
|
||||||
|
for (int i = 0; i < gain_size; i++) {
|
||||||
|
gain_array.gain_r[i].val = gain_val.val;
|
||||||
|
gain_array.gain_gr[i].val = gain_val.val;
|
||||||
|
gain_array.gain_gb[i].val = gain_val.val;
|
||||||
|
gain_array.gain_b[i].val = gain_val.val;
|
||||||
|
}
|
||||||
|
ESP_ERROR_CHECK(esp_isp_lsc_configure(isp_proc, &lsc_config));
|
||||||
|
|
||||||
|
调用 :cpp:func:`esp_isp_lsc_configure` 后,需要通过调用 :cpp:func:`esp_isp_lsc_enable` 来启用 ISP LSC 控制器。可以通过调用 :cpp:func:`esp_isp_lsc_disable` 来禁用 LSC。此外,即使未启用 LSC 控制器,也可以调用 :cpp:func:`esp_isp_lsc_configure`,但 LSC 功能仅在启用后才会生效。
|
||||||
|
|
||||||
|
|
||||||
.. _isp-color:
|
.. _isp-color:
|
||||||
|
|
||||||
ISP 色彩控制器
|
ISP 色彩控制器
|
||||||
@@ -815,6 +851,7 @@ API 参考
|
|||||||
.. include-build-file:: inc/isp_ae.inc
|
.. include-build-file:: inc/isp_ae.inc
|
||||||
.. include-build-file:: inc/isp_awb.inc
|
.. include-build-file:: inc/isp_awb.inc
|
||||||
.. include-build-file:: inc/isp_bf.inc
|
.. include-build-file:: inc/isp_bf.inc
|
||||||
|
.. include-build-file:: inc/isp_lsc.inc
|
||||||
.. include-build-file:: inc/isp_ccm.inc
|
.. include-build-file:: inc/isp_ccm.inc
|
||||||
.. include-build-file:: inc/isp_demosaic.inc
|
.. include-build-file:: inc/isp_demosaic.inc
|
||||||
.. include-build-file:: inc/isp_sharpen.inc
|
.. include-build-file:: inc/isp_sharpen.inc
|
||||||
|
Reference in New Issue
Block a user