I2c bus number and video node
1 I2c bus number on different boards
For camera modules with MIPI CSI-2 interface, the i2c bus is commonly provided as the communication channel for parameter configuration. Users use the i2c protocol to access the camera registers. A series of shell scripts are provided to facilitate this operation, such as VEYE-MIPI-X I2C.sh,CS-MIPI-X I2C.sh,VEYE-MIPI-IMX335 i2c script.
Generally, there is a matching i2c bus for each MIPI CSI-2 interface on each motherboard. For all our scripts, we can use the -b [bus numer] option to indicate which i2c bus is targeted for this operation. Below, we have summarized the i2c bus serial numbers for commonly used motherboards.
1.1 Raspberry pi
1.1.1 General
For a Raspberry Pi with only one mipi csi-2 interface, the i2c bus is 10. If your piOS is very old, then maybe it is 0.
Special, for the Computer module series. Make the following description.
1.1.2 Raspberry Pi 5
| i2c bus num | description |
|---|---|
| 6 | CAM0 |
| 4 | CAM1 |
1.1.3 CM3
CM3 use I2C-1 to control 2 cameras，It is time-sharing multiplexing.
./camera_i2c_config [cameranum]
| i2c bus num | description |
|---|---|
| 0 | CAM0 |
| 1 | CAM1 |
1.1.4 CM4
The CM4 module uses two I2C to communicate with two cameras respectively.
./camera_i2c_config
| i2c bus num | description |
|---|---|
| 0 | CAM0 |
| 10 | CAM1 |
1.2 Nvidia Jetson
The following description is only for official Nvidia development boards, third party board need to be confirmed with the manufacturer.
1.2.1 AGX-Xavier,AGX-Orin,TX2 Devkit
ADP-N1-V2.0 has 6 MIPI CSI-2 interfaces, corresponding to the i2c bus numbers 30-35.
| cam index | i2c number |
|---|---|
| 0 | 30 |
| 1 | 31 |
| 2 | 32 |
| 3 | 33 |
| 4 | 34 |
| 5 | 35 |
1.2.1.1 AGX-Orin @ Jetpack6.0+
| cam index | i2c number |
|---|---|
| 0 | 9 |
| 1 | 10 |
| 2 | 11 |
| 3 | 12 |
| 4 | 13 |
| 5 | 14 |
1.2.2 Xavier NX , TX2 NX, Orin Nano,Orin NX
| cam index | i2c number |
|---|---|
| 0 | 10 |
| 1 | 9 |
OR：
| cam index | i2c number |
|---|---|
| 0 | 9 |
| 1 | 10 |
1.2.3 Orin Nano , Orin NX
| cam index | i2c number |
|---|---|
| 0 | 9 |
| 1 | 10 |
1.2.4 Nano B01
| cam index | i2c number |
|---|---|
| 0 | 7 |
| 1 | 8 |
1.2.5 Nano A02, Nano 2GB
i2c bus number is 6.
1.3 NXP i.MX platform
1.3.1 AVNET Maaxboard(mini)
i2c bus number is 0.
1.3.2 MYIR i.MX8 board
| cam index | i2c number |
|---|---|
| 0 | 0 |
| 1 | 1 |
1.3.3 google Coral board
i2c bus number is 1.
1.4 Rockchip platform
1.4.1 ROC-RK3566-PC
i2c bus number is 4.
1.4.2 ROC-RK3588S-PC
i2c bus number is 7.
1.5 Tools
The following two tools can assist in understanding and finding problems.
1.5.1 i2cdetect
Under linux command, execute the following command to probe all the i2c device addresses on the i2c bus. Usually our module address is 0x3b.
i2cdetect -y -r [busnumber]
1.5.2 dmesg
dmesg prints out the logs of the linux kernel boot phase and also the driver logs of our camera modules. It shows the i2c probe process during the boot phase and whether it was successful or not.
2 Description of video nodes
In general, we have implemented v4l2 standard drivers for mipi modules on different platforms. The Linux kernel will find the corresponding driver and probe the camera according to the dts when booting. After success, the /dev/videoX device node is generated, where X is a number based on the order of the probe to.
This tends to cause a common misunderstanding, which is explained here.
For motherboards that support multiple mipi cameras, the i2c bus number of each camera is determined by the camera installation location, but the generated /dev/videoX node name cannot be determined in advance.
For example, if we install two cameras on the agx board, mounted to cam2 and cam4 positions, then:
| camera number | location | i2c bus | /dev/video node |
|---|---|---|---|
| 1 | cam2 | 32 | /dev/video0 |
| 2 | cam4 | 34 | /dev/video1 |