摄像头使用方法
=================

本文档主要描述J6X开发板上摄像头通路的基本功能验证方法。

Matrix6 E/M硬件
---------------

图像传感器接口
^^^^^^^^^^^^^^^

此处以Matrix6 E/M硬件为目标开发板，MIPI HOST（RX）接口共3个，每个接口上连接有不同的I2C总线，如下：

============ ========== =================================
MIPI_RX#接口 I2C总线    备注
============ ========== =================================
MIPI_RX0     I2C0，I2C1 默认I2C0，MAX96712，CPHY最多3trio
MIPI_RX1     I2C2       使用I2C2，MAX96724，CPHY最多3trio
MIPI_RX4     I2C3       使用I2C3，MAX96724，DPHY最多4lane
============ ========== =================================

该Matrix6 E/M硬件上各RX固定连接相应的解串器，非子板形式，其基本信息如下：

========= =================== =========== ==== ==== ==== ======
MIPI_RX   解串器              描述        BUS  ADDR POC  备注
========= =================== =========== ==== ==== ==== ======
RX0       MAX96712            CPHY，3trio 0，1 0x29 0x28 2路I2C
RX1       MAX96724            CPHY，3trio 2    0x27 0x28 
RX4       MAX96724            DPHY，4lane 3    0x27 0x28 
========= =================== =========== ==== ==== ==== ======

端子连接器
^^^^^^^^^^

该硬件上共有3个4合1端子，其连接器定义如下：

|image22|

测试摄像头
----------

此处以几颗OV模组为接入使用示例，介绍摄像头接入与测试方法。

OVX8B
^^^^^

此处以2颗OVX8B接入为例（请按case要求插入对应Link端口）。

OVX8B Fov120模组：

|image23|

OVX8B Fov30模组：

|image24|

OVX3C
^^^^^

此处以多路OVX3C接入为例（请按case要求插入对应Link端口）。

OVX3C Fov60模组：

|image25|

OVX3C Fov100模组：

|image26|

测试连接说明
------------

本文档中的测试都使用上述摄像头模组，并通过以下方式连接：

|image27|

接入通路验证方法说明
--------------------

基础数据通路可使用camera sample工具进行测试，其部署于开发板内位于：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/
        # 测试入口脚本：
        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh

.. note::

        外设相关Case使用需要检查实际硬件环境与Case接入配置是否一致，如所用的RX与rx_index配置，所接的LINK与deserial_port配置等。

单路8M（OVX8B）接入通路验证
^^^^^^^^^^^^^^^^^^^^^^^^^^^

该通路验证用于验证单路OVX8B接入RX0，RAW数据从CIM下DDR，所用CASE：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/cfg/case_matrix/1V_OVX8B_RX0/

测试执行脚本：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 1V_OVX8B_RX0

2路8M（OVX8B）+1路2M（OVX3C）接入通路验证
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

该通路验证用于验证2路OVX8B加1路OVX3C接入RX0，RAW数据从CIM下DDR，所用CASE：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/cfg/case_matrix/3V_2xOVX8B_1xOVX3C_RX0/

测试执行脚本：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 3V_2xOVX8B_1xOVX3C_RX0

4路2M（OVX3C）接入通路验证
^^^^^^^^^^^^^^^^^^^^^^^^^^

该通路验证用于验证4路OVX3C接入RX1，RAW数据从CIM下DDR，所用CASE：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/cfg/case_matrix/4V_4xOVX3C_RX1/

测试执行脚本：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 4V_4xOVX3C_RX1

7路接入通路验证
^^^^^^^^^^^^^^^

该通路验证用于验证RX0接入3路（2xOVX8B+1xOVX3C）加RX1接入4路（4xOVX3C），RAW数据从CIM下DDR，所用CASE：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/cfg/case_matrix/7V_2xOVX8B_1xOVX3C_RX0_4xOVX3C_RX1/
        # 带同步功能：
        /app/sample/S83_Sample/S83E04_Module/camera_sample/cfg/case_matrix/7V_2xOVX8B_1xOVX3C_RX0_4xOVX3C_RX1_SYNC/

测试执行脚本：

.. code:: shell

        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 7V_2xOVX8B_1xOVX3C_RX0_4xOVX3C_RX1
        # 带同步功能：
        /app/sample/S83_Sample/S83E04_Module/camera_sample/scripts/camera_sample.sh matrix 7V_2xOVX8B_1xOVX3C_RX0_4xOVX3C_RX1_SYNC
		
全数据通路验证方法说明
----------------------

上述基础通路验证使用的是camera sample工具的基本功能，仅能验证到图像RAW数据输出到DDR，若要使用其更多功能，可参考: :doc:`camera sample <../sample_doc/platform_samples/sample_doc_platform_samples_camera_sample>`，全数据通路可参考: :doc:`vio scenario sample <../sample_doc/platform_samples/sample_doc_platform_samples_vio_scenario_sample>`。

.. |image22| image:: ./media/image23.jpg
   :width: 5.76806in
   :height: 2.56449in
.. |image23| image:: ./media/image24.jpg
   :width: 3.32836in
   :height: 2.49704in
.. |image24| image:: ./media/image25.jpg
   :width: 3.35031in
   :height: 2.51365in
.. |image25| image:: ./media/image26.jpg
   :width: 3.35in
   :height: 2.51342in
.. |image26| image:: ./media/image27.jpg
   :width: 3.33582in
   :height: 2.50278in
.. |image27| image:: ./media/image28.jpg
   :width: 5.76806in
   :height: 2.56449in
