CM4-IO-BASE-B
| ||
| ||
Overview
CM4-IO-BASE-B is the basic IO board of the Raspberry Pi Compute Module 4. CM4-IO-BASE-B is a baseboard that can be used with the Raspberry Pi Compute Module 4. It is powered by a 5V/ 2.5A USB Type C interface.
Version Introduction
Version: CM4-IO-BASE-B V4
1: Repair BT-DIS and WIFI-DIS screen printing and actual pins are inconsistent. 2: The DSI interface is changed from DSI0 to DSI1, which already supports high resolution.
Version: CM4-IO-BASE-B V3
1: Fix the problem that some CM4s cannot be restarted. 2: Add a new set of RTC optional control circuits, U6, and Q8, with no soldering by default. 3: There are two versions of V3.1 and V3.0 in the V3 version. The difference between these two versions is not big, and it is described as one version here.
Version: CM4-IO-BASE-B V2.0
1: Modify the 5V to 3.3V DC-DC power supply scheme, change TLV62130RGT to MP1658 2: Change the BOOT jumper cap to a DIP switch
Version: CM4-IO-BASE-B V1.0
Note
1: Do not plug and unplug any device except USB and HDMI while the baseboard is working.
2: This model only supports a 5V fan and cannot work with a 12V fan. Please confirm the fan voltage before connecting.
3: The DSI Display Port is connecting the DSI0 interface of the CM4, and doesn't use the DSI1 display interface.
4: The Type C interface can be used for the power supply or the USB SLAVE interface for programming the image.
5: To ensure the normal power supply of CM4, please do not connect other devices when using the Type C interface to program the image.
6: It needs to use a 5V 2A power supply for CM4. Otherwise, it may occur some problems such as automatic shutdown, frequency reduction, etc.
7: When using the M.2 interface, please use the matching screws. Using screws of other lengths may cause the CM4 core to be damaged by the screws.
8: The module doesn't have any protection circuit, please do not short-circuit the power supply.
9: USB2.0 is closed by default, if you need to open it, you need to add dtoverlay=dwc2,dr_mode=host in config.txt.
10. The HDMI1 can be used by a flat cable output, if you need to use it, you can purchase an HDMI adapter.
11. If you need to use USB3/4 and HDMI1 ports at the same time, you can purchase a USB HDMI Adpter.
12. This expansion board does not support the POE function.
Dimension
CM4-IO-BASE-B
Compute_Module 4 Core board
What's on board
| No. | Component | Description | |
| 1 | CM4 connector | Suitable for all versions of Compute Module 4 | |
| 2 | DC power supply/programming interface | 5V/2.5A power supply, also can be used as an eMMC programming interface | |
| 3 | DISP0 interface | MIPI DSI Display Interface, DISP0 interface | |
| 4 | FAN header | For connecting cooling fan, allows speed adjustment and measurements, only supports 5V fan. | |
| 5 | CAM interface | Dual MIPI CSI camera interface | |
| 6 | HDMI0 interface | HDMI Interface, Support 4K 30fps output | |
| 7 | USB 2.0 interface | 2-channel USB 2.0 Interface, for connecting sorts of USB devices | |
| 8 | Gigabit Ethernet | Gigabit Ethernet RJ45 connector, with 10 / 100 / 1000M network support | |
| 9 | M.2 indicators | Indicating the operating status of the M.2 interface | |
| 10 | ACT indicators | Raspberry Pi operating status indicator | |
| 11 | PWR indicators | Raspberry Pi power indicator | |
| 12 | BOOT selection | jumper connected (ON): CM4 would be booted from USB-C interface jumper not connected (OFF): CM4 would be booted from eMMC or TF card | |
| 13 | 40PIN GPIO header | Conveniently connect various HAT modules | |
| 14 | TF card slot | For connecting a TF card with a pre-flashed image (Lite variant ONLY). | |
| 15 | HDMI1 port | HDMI1 port, Support 4K 30fps output | |
| 16 | USB 2.0 interface | Can be connected through an adapter | |
| 17 | FE1.1S | USB HUB chip, expanding one USB port to 4x ports | |
| 18 | M.2 connector | Supports sorts of NVME SSD or communication modules with PCI-E M.2 KEY-M interface | |
| 19 | RTC | PCF85063 chip, Allows RTC-related functions like wakeup, shutdown, reboot, and more | |
| 20 | RTC interrupt pin switch | PI-RUN: CM4 reboot on RTC interruption GN-EN: CM4 shutdown on RTC interruption D4: D4 pin is triggered on RTC interruption | |
| 21 | EMC2301 | Fan controller, for speed adjustment/measurement | |
| 22 | RTC battery socket | Can be connected to CR1220 button battery |
Precautions
Do not plug or unplug any devices while powered on
Image Programming
- Write Image for Compute Module Boards eMMC version
- Write Image for Compute Module Boards Lite version
USB2.0
The USB port is disabled by default on the CM4 to save power. If you need to start, you need to add the following to the config.txt file:
dtoverlay=dwc2,dr_mode=host
After restarting
If you use the latest Raspberry Pi OS (image after October 30, 2021) USB2.0 is OTG mode by default, CM4 will report an error:
config failed, hub doesn't have any ports! (err -19)
However, USB can still be used. If you want to remove this error, remove otg_mode=1 in [cm4] of config.txt, and add dtoverlay=dwc2, dr_mode=host (USB cannot be recognized without adding it).
M.2
The M.2 interface type is M KEY, which only supports PCIE channel devices (including NVME solid state, etc.), and does not support SATA hard disks.
Some adapter cards are supported, and the PCIE channel is used. Some devices cannot be driven by the official Raspberry Pi image, and the kernel needs to be recompiled.
RTC FAN
- Note: Please connect the fan before turning on the power of the base board and then complete the test. Please do not connect the fan after the base board is powered on, because the fan control chip has been powered on, otherwise, the chip will be flashed!
- Note: Before connecting, please confirm whether the rated voltage of the fan is consistent with the voltage actually connected to the fan.
Please note that DSI and CSI are prohibited when using RTC.
I2C-10 is used by default.
RTC (PCF85063a) on i2c-10, address is 0x51 (7-bit address)
FAN ( EMC2301 ) on i2c-10, address is 0x2f (7-bit address)
If you need to add it to your program instead of the kernel, you can refer to the C and Python demo reference click here.
RTC
sudo nano /boot/config.txt #Add the following lines at the end dtparam=i2c_vc=on dtoverlay=i2c-rtc,pcf85063a,i2c_csi_dsi #Add # in front of dtparam=audio=on #dtparam=audio=on #Save and exit, restart sudo reboot
How to use Hwclock
Synchronize system clock to hardware clock:
sudo hwclock -w
Synchronize hardware clock to system clock:
sudo hwclock -s #The network or the NTP needs to be closed, otherwise it will be changed back.
Set the hardware clock time:
sudo hwclock --set --date="9/8/2021 16:45:05"
View hardware clock:
sudo hwclock -r
Display version information:
sudo hwclock --verbose
Fan
1: Check whether the kernel version is higher than or equal to 6.1.31.
uname -a
2: Add the following commands at config.txt:
dtoverlay=i2c-fan,emc2301,i2c_csi_dsi,midtemp=45000,maxtemp=65000
3：For more configuration, you can refer to this link.
Troubleshooting
1：After adding configuration, you can use the command "i2cdetect -y 10" to check whether it takes effect. The I2C address should be "UU" rather than in numbers.
2：If the RTC value is wrong or invalid, you need to check whether RTC batteries are connected or whether the voltage of RTC batteries is normal.
3：After configuration, you need to reboot it to take effect.
4：If the fan does not rotate, you need to troubleshoot it. Check whether the configuration takes effect. If the kernel version lower than 6.1.31 (uname -a), the fan cannot work. For more details, you can refer to this link.
CSI DSI
New Version (Bookworm)
The DSI screen is 800x480 resolution screen by default, please refer to the corresponding WIKI for other resolution screens
When using the official base board Compute Module 4 IO Board, note that the J6 jumper cap needs to be connected
DSI
#Add the following to the config.txt file: sudo nano /boot/firmware/config.txt #DSI0 (V1~V3) dtoverlay=vc4-kms-dsi-7inch,dsi0 #DSI1 (V4) dtoverlay=vc4-kms-dsi-7inch,dsi1
CSI
| Mode | CAM0 setup statement | CAM1 setup statement |
|---|---|---|
| OV9281 | dtoverlay=ov9281,cam0 | dtoverlay=ov9281,cam1 |
| IMX290/IMX327 | dtoverlay=imx290,clock-frequency=37125000,cam0 | dtoverlay=imx290,clock-frequency=37125000,cam1 |
| IMX378 | dtoverlay=imx378,cam0 | dtoverlay=imx378,cam1 |
| IMX219 | dtoverlay=imx219,cam0 | dtoverlay=imx219,cam1 |
| IMX477 | dtoverlay=imx477,cam0 | dtoverlay=imx477,cam1 |
| IMX296 | dtoverlay=imx296,cam0 | dtoverlay=imx296,cam1 |
| IMX708 | dtoverlay=imx708,cam0 | dtoverlay=imx708,cam1 |
sudo reboot
Note:
1. The single-port camera can only work on CAM0, that is, it is not possible to use CAM1 port alone. But you can use the CAM0 port alone, or connect the dual cameras 2. If the device is recognized, and the startup prompt "Camera frontend has timed out!" appears, please update "sudo rpi-update"
Test Camera
- Enter the camera detection command, and you can see that the camera has been detected
libcamera-hello --list-cameras
- Display the camera screen to the desktop
libcamera-hello -t 0
- Take a photo
libcamera-jpeg -o test.jpg
- Record a 10s video
libcamera-vid -t 10000 -o test.h264
Other commands
Check if the camera is detected
libcamera-hello --list-cameras
Open the corresponding camera
libcamera-hello --camera 1 libcamera-hello --camera 0
Take a photo
libcamera-jpeg -o test.jpg #You can add --camera to specify the camera
#The new system uses dual cameras #Remove camera_auto_detect=1 in config.txt #camera_auto_detect=1 #Add dtoverlay=imx219,cam1 dtoverlay=imx219,cam0 #Where imx219 is the camera sensor model and other sensors are supported dtoverlay=ov5647,cam0 dtoverlay=imx219,cam0 dtoverlay=ov9281,cam0 dtoverlay=imx477,cam0 dtoverlay=imx519,cam0 #Then reboot reboot #Open camera libcamera-hello -t 0 or libcamera-hello #Other instructions: #Check if the camera is detected libcamera-hello --list-cameras #Open the corresponding camera, preview for 5 seconds libcamera-hello --camera 1 libcamera-hello --camera 0 #Take photos libcamera-jpeg -o test.jpg #Shoot video libcamera-vid -t 10000 -o test.h264 #You can add --camera to specify the camera #-t <duration> option allows the user to choose how long the window is displayed in milliseconds
For more commands, you can click here.
- Note: If using a DSI interface display there will be an HDMI disabled, even if just compiling the corresponding file without connecting a DSI screen.
- Connecting either HDMI port will allow output of an image, regardless of which HDMI port is used. If two HDMI screens are connected, only HDMI0 has an image output.
- To enable two HDMI ports, remove the configuration from config.txt:
- And then reboot it.
Please refer to Raspberry Pi manual.
Old System Version (Buster and Bullseye)
Configure Files
CSI and DSI are disabled by default. When using the camera and DSI, three I2C devices, I2C-10, I2C-11, and I2C-0 will be occupied.
Booting is performed as follows:
wget https://files.waveshare.com/upload/7/75/CM4_dt_blob_Source.zip unzip -o CM4_dt_blob_Source.zip -d ./CM4_dt_blob_Source sudo chmod 777 -R CM4_dt_blob_Source cd CM4_dt_blob_Source/ #Execute (for version V1~V3) sudo dtc -I dts -O dtb -o /boot/dt-blob.bin dt-blob-disp0-double_cam.dts #Execute (for version V4) sudo dtc -I dts -O dtb -o /boot/dt-blob.bin dt-blob-disp1-double_cam.dts Add the following to the config.txt file: sudo nano /boot/config.txt Change dtoverlay=vc4-kms-v3d to dtoverlay=vc4-fkms-v3d #When using any DSI, HDMI1 has no image output, even if you are not connected to the DSI screen, as long as you compile the corresponding file, then HDMI1 will have no output #If you need to restore, delete the corresponding dt-blob.bin: sudo rm -rf /boot/dt-blob.bin #After execution, turn off the power and restart
Record Test
Connect to the camera and the DSI display:
1. Please make sure it is connected under powering off.
2. Connect to the power.
3. The display will be booted after waiting for a few seconds.
4. If it fails to boot, check whether /boot/dt-blob.bin exists, and reboot it if it exists.
Old Version (Buster)
The camera needs to run raspi-config, select Interfacing Options -> Camera -> Yes -> Finish -> Yes, reboot the system, open enable camera, and then restart to save the changes.
Test the Raspberry Pi camera.
Check the screen of the first connected camera:
sudo raspivid -t 0 -cs 0
Check the screen of the second connected camera:
sudo raspivid -t 0 -cs 1
Resources
Documents
- CSI Camera Reference
- DSI Display Reference
- Raspberry Pi Compute Module 4 IO Board Brief
- Raspberry Pi Compute Module 4 IO Board Datasheet
Schematic Diagrams
3D Drawing
Demo
Software
FAQ
b) Check whether the /boot/dt-blob.bin file exists, if it cannot be used, delete it;
Yes, you can use GPIO for the power supply. Make sure the power supply voltage is 5V.
Please replace it with CM3*3*6 screw. It is M3 screws with 3mm length and the hat of the screws is 6mm.
{{{5}}}
Support
Technical Support
If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)