Line 26: |
Line 26: |
| |Done | | |Done |
| |} | | |} |
| + | In addition, the driver for the Fpdlink connection mode has been finished on the Ubuntu system. |
| + | |
| === Hardware Setup === | | === 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-RK35xx-PC board. | | 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-RK35xx-PC board. |
Line 40: |
Line 42: |
| [[File:VEYE-MIPI-327S-ADP-Tfirefly 04.jpg|link=http://wiki.veye.cc/index.php/File:VEYE-MIPI-327S-ADP-Tfirefly%2004.jpg|center|thumb|800x800px|Firefly Board and VEYE camera overall]] | | [[File:VEYE-MIPI-327S-ADP-Tfirefly 04.jpg|link=http://wiki.veye.cc/index.php/File:VEYE-MIPI-327S-ADP-Tfirefly%2004.jpg|center|thumb|800x800px|Firefly Board and VEYE camera overall]] |
| | | |
| + | ==== FPD-Link III Camera Connection Diagram ==== |
| + | [[File:FPDLINK Camera to RK3588S.png|center|thumb|800x800px|FPDLINK Camera to RK3588S]] |
| + | <br /> |
| === Introduction to github repositories === | | === Introduction to github repositories === |
| https://github.com/veyeimaging/rk35xx_firefly | | https://github.com/veyeimaging/rk35xx_firefly |
Line 53: |
Line 58: |
| === Ubuntu === | | === Ubuntu === |
| | | |
− | ==== Upgrade Firefly Ubuntu system ==== | + | ==== Upgrade Firefly Ubuntu system(RK356x) ==== |
| | | |
| ===== Overview ===== | | ===== Overview ===== |
| This section describes how to update the RK35xx system to support our camera modules. | | 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. | + | For the kernel version 4.19, we provide a deb installation package that can be installed directly. |
| + | |
| + | For the kernel version 5.10, we provide a burning image. |
| + | |
| + | 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. | | 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===== | + | ===== kernel version 5.10 ===== |
| + | For the ROC-RK3588S-PC, we have provided an image of the release system. |
| + | |
| + | Download the latest released image file corresponding to the camera model you are using from https://github.com/veyeimaging/rk35xx_firefly/releases/ . |
| + | |
| + | Refer to the [https://wiki.t-firefly.com/en/ROC-RK3566-PC/03-upgrade_firmware.html Firefly documentation] to burn in a standard system. |
| + | |
| + | ===== kernel version 4.19 ===== |
| + | |
| + | ======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. | | 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 prebuilt Image and dtb file====== |
| Using the compiled debain installation package | | Using the compiled debain installation package |
| | | |
Line 73: |
Line 91: |
| <code>tar -xavf rk356x_firefly.tar.gz</code> | | <code>tar -xavf rk356x_firefly.tar.gz</code> |
| | | |
− | <code>cd cd rk356x_firefly/released_images/ROC-RK3566-PC/ubuntu/</code> | + | <code>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> | | <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. | | If the version does not match, it needs to be compiled from the source code. |
| + | |
| + | ==== Upgrade Firefly Ubuntu system(RK358x) ==== |
| + | For the ROC-RK3588S-PC, we have provided an image of the release system. |
| + | |
| + | Download the latest released image file corresponding to the camera model you are using from https://github.com/veyeimaging/rk35xx_firefly/releases/ . |
| + | |
| + | Refer to the [https://wiki.t-firefly.com/en/ROC-RK3588S-PC/upgrade_bootmode.html Firefly documentation] to burn in a standard system. |
| | | |
| ==== Check system status ==== | | ==== Check system status ==== |
Line 100: |
Line 125: |
| <code>video0</code> | | <code>video0</code> |
| | | |
− | The camera can be seen connected to the i2c-4.
| + | For ROC-RK3566-PC, the camera is connected to i2c-4, for ROC-RK3588S-PC to i2c-7. |
| | | |
− | ==== Samples ==== | + | ==== Application examples ==== |
| | | |
| ===== v4l2-ctl ===== | | ===== v4l2-ctl ===== |
Line 113: |
Line 138: |
| | | |
| ====== Snap YUV picture ====== | | ====== Snap YUV picture ====== |
| + | <code>v4l2-ctl --set-fmt-video=width=1920,height=1080,pixelformat='NV12' --stream-mmap --stream-count=100 --stream-to=nv12-1920x1080.yuv</code> |
| + | |
| + | For RK3566, also: |
| + | |
| <code>v4l2-ctl --set-fmt-video=width=1920,height=1080,pixelformat=UYVY --stream-mmap --stream-count=1 --stream-to=uyvy-1920x1080.yuv</code> | | <code>v4l2-ctl --set-fmt-video=width=1920,height=1080,pixelformat=UYVY --stream-mmap --stream-count=1 --stream-to=uyvy-1920x1080.yuv</code> |
− |
| |
− | <code>v4l2-ctl --set-fmt-video=width=1920,height=1080,pixelformat='NV12' --stream-mmap --stream-count=100 --stream-to=nv12-1920x1080.yuv</code>
| |
| | | |
| Play YUV picture | | Play YUV picture |
Line 129: |
Line 156: |
| <code>cd yavta;make</code> | | <code>cd yavta;make</code> |
| | | |
− | <code>./yavta -c1 -Fuyvy-1920x1080.yuv --skip 0 -f UYVY -s 1920x1080 /dev/video0</code> | + | <code>./yavta -c1 -Fnv12-1920x1080.yuv --skip 0 -f NV12 -s 1920x1080 /dev/video0</code> |
| | | |
| ===== gstreamer ===== | | ===== gstreamer ===== |
Line 143: |
Line 170: |
| In addition, this [https://wiki.t-firefly.com/en/Firefly-Linux-Guide/demo_OpenCV_support.html page] from Firefly has some reference value. | | In addition, this [https://wiki.t-firefly.com/en/Firefly-Linux-Guide/demo_OpenCV_support.html page] from Firefly has some reference value. |
| ==== Compile drivers and dtb from source code ==== | | ==== Compile drivers and dtb from source code ==== |
− | https://github.com/veyeimaging/rk356x_firefly/tree/main/linux/drivers
| |
| | | |
| + | * RK356x |
| + | |
| + | https://github.com/veyeimaging/rk35xx_firefly/tree/main/linux/drivers/rk356x |
| + | |
| + | * RK358x |
| + | |
| + | https://github.com/veyeimaging/rk35xx_firefly/tree/main/linux/drivers/rk358x |
| === i2c script for parameter configuration === | | === i2c script for parameter configuration === |
| Because of the high degree of freedom of our camera parameters, we do not use V4L2 parameters to control, but use scripts to configure parameters. | | Because of the high degree of freedom of our camera parameters, we do not use V4L2 parameters to control, but use scripts to configure parameters. |
| | | |
− | https://github.com/veyeimaging/rk356x_firefly/tree/main/i2c_cmd | + | https://github.com/veyeimaging/rk35xx_firefly/tree/main/i2c_cmd |
| | | |
| using -b option to identify which bus you want to use. | | using -b option to identify which bus you want to use. |
Line 163: |
Line 196: |
| | | |
| ==== Update Android system ==== | | ==== Update Android system ==== |
− | Download the latest rk356x_firefly_android.tar.gz from https://github.com/veyeimaging/rk356x_firefly/releases/ . | + | |
| + | * ROC-RK3566-PC |
| + | |
| + | Download the latest rk356x_firefly_android.tar.gz from https://github.com/veyeimaging/rk35xx_firefly/releases/ |
| + | |
| + | *ROC-RK3588S-PC |
| + | |
| + | Download the latest rk358x_firefly_android.tar.gz from https://github.com/veyeimaging/rk35xx_firefly/releases/ |
| | | |
| Burn the system refer to firefly's documentation. | | Burn the system refer to firefly's documentation. |
Line 194: |
Line 234: |
| | | |
| ====Compile system from source code==== | | ====Compile system from source code==== |
− | https://github.com/veyeimaging/rk356x_firefly/tree/main/android/drivers | + | |
| + | * RK356x |
| + | |
| + | https://github.com/veyeimaging/rk35xx_firefly/tree/main/android/rk356x/drivers |
| + | |
| + | * RK358x |
| + | |
| + | https://github.com/veyeimaging/rk35xx_firefly/tree/main/android/rk358x/drivers |
| + | |
| + | === Known issues === |
| + | |
| + | # The VICAP module of RK3588 does not support outputting the UYVY format, so please use the NV12 format instead. |
| + | |
| === References === | | === References === |
| | | |
Line 200: |
Line 252: |
| | | |
| https://wiki.t-firefly.com/en/ROC-RK3566-PC/ | | https://wiki.t-firefly.com/en/ROC-RK3566-PC/ |
| + | |
| + | *ROC-RK3588S-PC Manual |
| + | |
| + | https://wiki.t-firefly.com/en/ROC-RK3588S-PC/ |
| | | |
| * Firefly Linux User Guide | | * Firefly Linux User Guide |
Line 206: |
Line 262: |
| | | |
| === Document History === | | === Document History === |
| + | |
| + | * 2024-04-17 |
| + | |
| + | Support kernel v5.10 on RK3566. |
| + | |
| + | * 2023-05-22 |
| + | |
| + | Support Fpdlink-III on ubuntu system. |
| + | |
| + | *2022-12-28 |
| + | |
| + | Add support for RK358x. |
| | | |
| * 2022-12-06 | | * 2022-12-06 |