View source for VEYE CS Camera on Firfly Boards

'''<big>How to use VEYE and CS series cameras on Firefly's RK35XX board (Ubuntu)</big>'''

=== Overview ===
VEYE series and CS series cameras are the video streaming mode MIPI cameras we designed. This article takes Firefly's ROC-RK3566-PC board as an example to introduce how to connect VEYE and CS series cameras to RK3566/RK3568/RK3588 system.

==== Camera Module List ====
{| class="wikitable"
!Series
!Model
!Status
|-
|VEYE Series
|VEYE-MIPI-IMX327S
|Done
|-
|VEYE Series
|VEYE-MIPI-IMX462
|Done
|-
|VEYE Series
|VEYE-MIPI-IMX385
|Done
|}
=== Hardware Setup ===
VEYE series and CS series cameras are provided with Raspberry Pi compatible 15Pin FFC connector. An [[ADP-Tfirefly]] adapter board is required to adapt to the ROC-RK3566-PC board.

==== Connection of camera and ADP-Tfirefly ====
The two are connected using 1.0 mm pitch*15P FFC cable with opposite direction. The cable must be inserted with the silver contacts facing outside.

==== Connection of ADP-Tfirefly and Firefly Board ====
The two are connected using 0.5 mm pitch*30P FFC cable with same direction. The cable must be inserted with the silver contacts facing inside.

==== Overall connection ====
TODO

=== Introduction to github repositories ===
https://github.com/veyeimaging/rk356x_firefly

includes：

* driver source code
* i2c toolkits
* application demo

In addition, a compiled linux kernel installation package is provided in the [https://github.com/veyeimaging/rk356x_firefly/releases releases].

=== Upgrade Firefly Ubuntu system ===

==== Overview ====
This section describes how to update the RK35xx system to support our camera modules.

For some versions, we provide a deb installer that can be installed directly. For versions where no installer is provided, you will need to refer to later chapters to compile from the driver source code.

Although we are now using Ubuntu system as an example to introduce, other Linux distributions can also refer to this article.

====Burn Firefly standard system====
Refer to the [https://wiki.t-firefly.com/en/ROC-RK3566-PC/01-bootmode.html Firefly documentation] to burn in a standard system.
====Using prebuilt Image and dtb file====
Using the compiled debain installation package

On the RK35xx board, execute :

<code>wget <nowiki>https://github.com/veyeimaging/rk356x_firefly/releases/latest/download/rk356x_firefly.tar.gz</nowiki></code>

<code>tar -xavf rk356x_firefly.tar.gz</code>

<code>cd cd rk356x_firefly/released_images/ROC-RK3566-PC/ubuntu/</code>

<code>sudo dpkg -i linux-image-4.19.232_4.19.232-21_arm64.deb</code>

If the version does not match, it needs to be compiled from the source code.

=== Check system status ===

=== Samples ===

==== v4l2-ctl ====

==== yavta ====

==== gstreamer ====

==== Import to OpenCV ====

=== i2c script for parameter configuration ===

=== Compile drivers and dtb from source code ===

=== References ===

* ROC-RK3566-PC Manual

https://wiki.t-firefly.com/en/ROC-RK3566-PC/

* Firefly Linux User Guide

https://wiki.t-firefly.com/en/Firefly-Linux-Guide/index.html

=== Document History ===

* 2022-10-22

Release 1st version.