228
edits
Changes
Jump to navigation
Jump to search
Created page with "{{GD Template Impl}} <span class="tb_red">This guide depends on the version of the official Raspberry Pi OS you are using; instructions vary by OS version. Please contact us i..."
{{GD Template Impl}}
<span class="tb_red">This guide depends on the version of the official Raspberry Pi OS you are using; instructions vary by OS version. Please contact us if you encounter any issues during use.</span>
==Preparation==
For kernel driver usage, ensure your system is updated. As the 5.4 kernel included key changes, these guidelines are valid for kernel 5.4 and newer releases. Verify your kernel version with <code>uname -a</code>; if it is below 5.4, fix this before continuing.
<pre>
pi@raspberrypi:~ $ uname -a
Linux raspberrypi 5.10.63-v7l+ #1459 SMP Wed Oct 6 16:41:57 BST 2021 armv7l GNU/Linux
</pre>
<mark>1.</mark> Update and upgrade your Raspberry Pi system (time required varies by country/region).
<pre>
sudo apt-get update
sudo apt-get upgrade
</pre>
<mark>2.</mark> Enable the camera module (enabled by default on Raspberry Pi Bullseye OS).
<pre>
sudo raspi-config
sudo reboot
</pre>
<mark>3.</mark> Go to '''Interface Options''', select '''Camera''' and enable it. Select '''Finish''', then reboot your Raspberry Pi. <span class="tb_red">(Reboot is required!)</span>
----
'''<span class="tb_red">As the Pi 5B lacks hardware encoding support, the software instructions for Raspberry Pi platforms are currently split into two sections:</span>'''
*For other Raspberry Pi platforms (Pi Zero, Zero 2, Pi3B, Pi4B…)
*For Pi 5B & CM5
==Demo for All Pi Models Except Pi 5B & CM5==
'''<span class="tb_red">The HDMI to CSI Module Example for Zero, Zero 2, Pi 3B, Pi 4B…</span>'''
'''[STEP1]'''
Edit the <code>/boot/firmware/config.txt</code> file (sudo privileges required):
<pre>
sudo nano /boot/firmware/config.txt
</pre>
'''[STEP2]'''
Add the line:
<pre>
dtoverlay=tc358743
</pre>
*Add the line if your shield support audio like C790 or C792：
<pre>
dtoverlay=tc358743-audio
</pre>
*Add the line '''only if''': your device (e.g., C790/C792) supports a 22-pin connector with all 4 lanes connected, and the compute module has the '''CAM1 interface''' with all 4 lanes connected:
<pre>
dtoverlay=tc358743,4lane=1
</pre>
'''[STEP3]'''
Use the following command to check the amount of memory allocated to the CMA heap:
<pre>
dmesg | grep cma
</pre>
*The first line should look like:
<pre>
pi@raspberrypi:~ $ dmesg | grep cma
[0.000000] cma: Reserved 256 MiB at 0x000000001ec00000
</pre>
*If the reported CMA allocated memory is less than 96MB, edit the <code>/boot/cmdline.txt</code> file and add the following at the start of the line <span class="tb_red">(do not add a newline character)</span>:
<pre>
cma=96M
</pre>
'''[STEP4]'''
Reboot the device. If everything works properly, you should see the <code>/dev/video0</code> device, and running the following command will show it is provided by Unicam:
<pre>
v4l2-ctl --list-devices
</pre>
'''[STEP5]'''
After connecting all cables, power on the Raspberry Pi and enter the commands below：
<pre>
pi@raspberrypi:~ $ ls /dev/video0
/dev/video0
pi@raspberrypi:~ $ v4l2-ctl --list-devices
bcm2835-codec-decode (platform:bcm2835-codec):
/dev/video10
/dev/video11
/dev/video12
/dev/video18
/dev/media1
bcm2835-isp (platform:bcm2835-isp):
/dev/video13
/dev/video14
/dev/video15
/dev/video16
/dev/media0
unicam (platform:fe801000.csi):
/dev/video0
/dev/video1
/dev/media2
</pre>
'''NOTE: This driver gives full control to the user or the user's applications. By default, no EDID (Extended Display Identification Data) is loaded in the chip, so it cannot inform the HDMI source of the supported resolutions.'''
*Several EDID editors are available on the market. You need to first create an edid.txt file (you can use the <code>command nano edid.txt</code> to create and edit the file), then copy the content below into the edid.txt file:
<pre>
00ffffffffffff005262888800888888
1c150103800000780aEE91A3544C9926
0F505400000001010101010101010101
010101010101011d007251d01e206e28
5500c48e2100001e8c0ad08a20e02d10
103e9600138e2100001e000000fc0054
6f73686962612d4832430a20000000FD
003b3d0f2e0f1e0a2020202020200100
020321434e041303021211012021a23c
3d3e1f2309070766030c00300080E300
7F8c0ad08a20e02d10103e9600c48e21
0000188c0ad08a20e02d10103e960013
8e210000188c0aa01451f01600267c43
00138e21000098000000000000000000
00000000000000000000000000000000
00000000000000000000000000000000
</pre>
*After the edid.txt file is created, execute the command <code>v4l2-ctl --set-edid=file=edid.txt --fix-edid-checksums</code> in the terminal, and you will see output similar to the following:
<pre>
pi@raspberrypi:~ $ v4l2-ctl --set-edid=file=edid.txt --fix-edid-checksums
CTA-861 Header
IT Formats Underscanned: yes
Audio: yes
YCbCr 4:4:4: no
YCbCr 4:2:2: no
HDMI Vendor-Specific Data Block
Physical Address: 3.0.0.0
YCbCr 4:4:4 Deep Color: no
30-bit: no
36-bit: no
48-bit: no
CTA-861 Video Capability Descriptor
RGB Quantization Range: yes
YCC Quantization Range: no
PT: Supports both over- and underscan
IT: Supports both over- and underscan
CE: Supports both over- and underscan
</pre>
'''[STEP6]'''
Detect the presence of HDMI signal input at present via command：
<pre>
pi@raspberrypi:~ $ v4l2-ctl --query-dv-timings
Active width: 1280
Active height: 720
Total width: 1650
Total height: 750
Frame format: progressive
Polarities: -vsync -hsync
Pixelclock: 74250000 Hz (60.00 frames per second)
Horizontal frontporch: 0
Horizontal sync: 370
Horizontal backporch: 0
Vertical frontporch: 0
Vertical sync: 30
Vertical backporch: 0
Standards:
Flags:
</pre>
*Use the command <code>v4l2-ctl --set-dv-bt-timings query</code> to make the driver automatically set the video timing parameters (such as resolution and frame rate) based on the current HDMI input signal, ensuring the capture card correctly recognizes and processes the current HDMI signal.
<span class="tb_red"></span>
<code></code>
<pre>
</pre>
==Packing List==
==User Manual==
* Hardware Installation:
* How to make it work:
==FAQ==
<!-- 这里提供了一个Q&A的模板，增加Q&A时按照下面的格式写就可以了 -->
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.0;">
Q1: Question 1
</div>
<div class="mw-collapsible-content">
A: Place the answer here.
</div>
</div>
<!--Add review function! -->
<comments />
<!--Please choose the -->
<!--Remove other categories, just keep the appropriate categories -->
<span class="tb_red">This guide depends on the version of the official Raspberry Pi OS you are using; instructions vary by OS version. Please contact us if you encounter any issues during use.</span>
==Preparation==
For kernel driver usage, ensure your system is updated. As the 5.4 kernel included key changes, these guidelines are valid for kernel 5.4 and newer releases. Verify your kernel version with <code>uname -a</code>; if it is below 5.4, fix this before continuing.
<pre>
pi@raspberrypi:~ $ uname -a
Linux raspberrypi 5.10.63-v7l+ #1459 SMP Wed Oct 6 16:41:57 BST 2021 armv7l GNU/Linux
</pre>
<mark>1.</mark> Update and upgrade your Raspberry Pi system (time required varies by country/region).
<pre>
sudo apt-get update
sudo apt-get upgrade
</pre>
<mark>2.</mark> Enable the camera module (enabled by default on Raspberry Pi Bullseye OS).
<pre>
sudo raspi-config
sudo reboot
</pre>
<mark>3.</mark> Go to '''Interface Options''', select '''Camera''' and enable it. Select '''Finish''', then reboot your Raspberry Pi. <span class="tb_red">(Reboot is required!)</span>
----
'''<span class="tb_red">As the Pi 5B lacks hardware encoding support, the software instructions for Raspberry Pi platforms are currently split into two sections:</span>'''
*For other Raspberry Pi platforms (Pi Zero, Zero 2, Pi3B, Pi4B…)
*For Pi 5B & CM5
==Demo for All Pi Models Except Pi 5B & CM5==
'''<span class="tb_red">The HDMI to CSI Module Example for Zero, Zero 2, Pi 3B, Pi 4B…</span>'''
'''[STEP1]'''
Edit the <code>/boot/firmware/config.txt</code> file (sudo privileges required):
<pre>
sudo nano /boot/firmware/config.txt
</pre>
'''[STEP2]'''
Add the line:
<pre>
dtoverlay=tc358743
</pre>
*Add the line if your shield support audio like C790 or C792：
<pre>
dtoverlay=tc358743-audio
</pre>
*Add the line '''only if''': your device (e.g., C790/C792) supports a 22-pin connector with all 4 lanes connected, and the compute module has the '''CAM1 interface''' with all 4 lanes connected:
<pre>
dtoverlay=tc358743,4lane=1
</pre>
'''[STEP3]'''
Use the following command to check the amount of memory allocated to the CMA heap:
<pre>
dmesg | grep cma
</pre>
*The first line should look like:
<pre>
pi@raspberrypi:~ $ dmesg | grep cma
[0.000000] cma: Reserved 256 MiB at 0x000000001ec00000
</pre>
*If the reported CMA allocated memory is less than 96MB, edit the <code>/boot/cmdline.txt</code> file and add the following at the start of the line <span class="tb_red">(do not add a newline character)</span>:
<pre>
cma=96M
</pre>
'''[STEP4]'''
Reboot the device. If everything works properly, you should see the <code>/dev/video0</code> device, and running the following command will show it is provided by Unicam:
<pre>
v4l2-ctl --list-devices
</pre>
'''[STEP5]'''
After connecting all cables, power on the Raspberry Pi and enter the commands below：
<pre>
pi@raspberrypi:~ $ ls /dev/video0
/dev/video0
pi@raspberrypi:~ $ v4l2-ctl --list-devices
bcm2835-codec-decode (platform:bcm2835-codec):
/dev/video10
/dev/video11
/dev/video12
/dev/video18
/dev/media1
bcm2835-isp (platform:bcm2835-isp):
/dev/video13
/dev/video14
/dev/video15
/dev/video16
/dev/media0
unicam (platform:fe801000.csi):
/dev/video0
/dev/video1
/dev/media2
</pre>
'''NOTE: This driver gives full control to the user or the user's applications. By default, no EDID (Extended Display Identification Data) is loaded in the chip, so it cannot inform the HDMI source of the supported resolutions.'''
*Several EDID editors are available on the market. You need to first create an edid.txt file (you can use the <code>command nano edid.txt</code> to create and edit the file), then copy the content below into the edid.txt file:
<pre>
00ffffffffffff005262888800888888
1c150103800000780aEE91A3544C9926
0F505400000001010101010101010101
010101010101011d007251d01e206e28
5500c48e2100001e8c0ad08a20e02d10
103e9600138e2100001e000000fc0054
6f73686962612d4832430a20000000FD
003b3d0f2e0f1e0a2020202020200100
020321434e041303021211012021a23c
3d3e1f2309070766030c00300080E300
7F8c0ad08a20e02d10103e9600c48e21
0000188c0ad08a20e02d10103e960013
8e210000188c0aa01451f01600267c43
00138e21000098000000000000000000
00000000000000000000000000000000
00000000000000000000000000000000
</pre>
*After the edid.txt file is created, execute the command <code>v4l2-ctl --set-edid=file=edid.txt --fix-edid-checksums</code> in the terminal, and you will see output similar to the following:
<pre>
pi@raspberrypi:~ $ v4l2-ctl --set-edid=file=edid.txt --fix-edid-checksums
CTA-861 Header
IT Formats Underscanned: yes
Audio: yes
YCbCr 4:4:4: no
YCbCr 4:2:2: no
HDMI Vendor-Specific Data Block
Physical Address: 3.0.0.0
YCbCr 4:4:4 Deep Color: no
30-bit: no
36-bit: no
48-bit: no
CTA-861 Video Capability Descriptor
RGB Quantization Range: yes
YCC Quantization Range: no
PT: Supports both over- and underscan
IT: Supports both over- and underscan
CE: Supports both over- and underscan
</pre>
'''[STEP6]'''
Detect the presence of HDMI signal input at present via command：
<pre>
pi@raspberrypi:~ $ v4l2-ctl --query-dv-timings
Active width: 1280
Active height: 720
Total width: 1650
Total height: 750
Frame format: progressive
Polarities: -vsync -hsync
Pixelclock: 74250000 Hz (60.00 frames per second)
Horizontal frontporch: 0
Horizontal sync: 370
Horizontal backporch: 0
Vertical frontporch: 0
Vertical sync: 30
Vertical backporch: 0
Standards:
Flags:
</pre>
*Use the command <code>v4l2-ctl --set-dv-bt-timings query</code> to make the driver automatically set the video timing parameters (such as resolution and frame rate) based on the current HDMI input signal, ensuring the capture card correctly recognizes and processes the current HDMI signal.
<span class="tb_red"></span>
<code></code>
<pre>
</pre>
==Packing List==
==User Manual==
* Hardware Installation:
* How to make it work:
==FAQ==
<!-- 这里提供了一个Q&A的模板，增加Q&A时按照下面的格式写就可以了 -->
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.0;">
Q1: Question 1
</div>
<div class="mw-collapsible-content">
A: Place the answer here.
</div>
</div>
<!--Add review function! -->
<comments />
<!--Please choose the -->
<!--Remove other categories, just keep the appropriate categories -->