From Waveshare Wiki
Jump to: navigation, search
Compute Module 4

Industrial IoT Wireless Expansion Module Designed for Raspberry Pi Compute Module 4





This is an industrial expansion module based on Raspberry Pi CM4, which features common interfaces such as Gigabit Ethernet, HDMI, USB, and GPIO, allowing additional 4G / 5G / LoRa wireless communication modules to be connected via the M.2 or Mini-PCIe socket. There are also industrial interfaces/resources including RS485, CAN, and RTC.
Combined with the industrial rail-mount protection case, the module is an ideal choice for building an IoT gateway, 4G/5G router, IoT data acquisition, or even the PLC device in the industrial automatic control system, and more.


  1. DO NOT hot-plug any devices except the USB and HDMI.
  2. Please check the FAN voltage before connecting the cooling fan. The BASE board supports a 12V cooling fan by default, if you want to use a 5V cooling fan, please change the FAN_VCC resistor.
  3. DO NOT connect other devices while writing CM4 via Type C interface for stable working.
  4. 5V/2.5A or higher power supply is recommended for proper working.
  5. DO NOT power the Base board by 12V DC and the 5V Type C at the same time
  6. The USB2.0 is disabled by default, you need to add the line dtoverlay=dwc2,dr_mode=host to config.txt to enable it.


CM4 SOCKET suitable for all variants of Compute Module 4
NETWORKING Dual Gigabit Ethernet RJ45
M.2 B KEY / Mini-PCIe (via adapter), for connecting 5G / 4G / LoRa wireless module
Nano-SIM card slot supports standard Nano-SIM card for 5G/4G/3G/2G communication
USB USB 2.0 × 3
PIN HEADER Non-isolated RS485 × 2, Non-isolated CAN × 1, Partial GPIO pins
CAMERA MIPI CSI-2 × 1 (15pin 1.0mm FPC connector)
VIDEO HDMI × 1, supports 4K 30fps output
RTC Real-time clock with a battery socket and ability to wake Compute Module 4
STORAGRE MicroSD card socket for Compute Module 4 Lite (without eMMC) variants
FAN HEADER 5V/12V, allows speed adjustment and measurement
DIMENSIONS 145 × 90 × 40mm



Writing Image


The RS485 interface is disabled by default, if you want to enable it, please modify the config.txt file.

sudo nano /boot/config.txt

Add the following lines and save.


reboot the CM4

sudo reboot

The device ports in Raspberry of RS485 interfaces are.



The CAN interface is disabled by default, if you want to use it, please modify the config.txt file.

sudo nano /boot/config.txt

Add the following lines.


Reboot the CM4.

sudo reboot

Open a terminal and run the following command to check if the spi0 interface was initialized.

dmesg | grep spi0
Compute Module 4 PoE 4G Board 1.png

Run the following commands to config the can port.

sudo ip link set can0 up type can bitrate 1000000
sudo ifconfig can0 txqueuelen 65536
Compute Module 4 PoE 4G Board 2.png

Install can-utils:

sudo apt-get install can-utils

Test to receive can data:

candump can0

Test to send can data:

cansend can0 000#

M.2 B Key

The M.2 B Key port features PCIe, USB2.0, GPIO, I2C, and the SPI interface.
It supports to connect the following modules:

A Mini-PCIe adapter is provided for connecting devices that use the Mini PCIe package interface. (Note that it is just the Mini PCIe interface but not pinout real PCIe pins, it doesn't support PCIe devices)


To work with 4G/5G, you need to connect a wireless module to the M.2 B KEY for featuring corresponding functions. M.2 B KEY only extends USB3.0 interfaces, it doesn't support PCIe devices.
SIM card is required to work with the 4G/5G module
If you want to disable the 4G/5G module, you can set the GPIO6 to High and enable it again by setting the GPIO6 to Low.
The module requires about 30s to enable/disable the 4G/5G modules.


ON OFF Shutdown or Stating
ON ON Searching network
ON Flash Working
OFF Flash/ON Shutting down

Before you configure the 4G/5G module, please make sure that the module is working normally.

Configure 5G Modules

Configure 4G Modules

  • Install minicom
sudo apt-get install minicom
  • Run the minicom to configure moudules
sudo minicom -D /dev/ttyUSB2
  • Configure the modules with the following command
  • Exit from the minicom and run the following command to assign IP for the usb0 (it maybe different if you connect other USB adapter)
sudo dhclient -v usb0
  • If the network cannot connected properly, pleaes run theone of the following AT command to change the frequency and test it again.

AT commands

If your 4G modules cannot connect to network properly, please try to trobuleshoot by minicom and the AT commands.

sudo minicom -D /dev/ttyUSB2
Common AT commands
Command Description Return
AT AT test OK
ATE ATE1 enable echo
ATE0 disable echo
AT+CGMI Check manfacture OK
AT+CGMM Check module type OK
AT+CSUB Check module version OK
AT+CGMR Check firmware version OK
AT+IPREX Configure hardwara baud rate +IPREX:
AT+CRESET Reset module OK
AT+CSQ Check signal quanlity +CSQ: 17,99
AT+CPIN? Check SIM status +CPIN: READY
AT+COPS? CHeck the current supplier +COPS:
AT+CREG? Check network status +CREG:
AT+CPSI? Check UE information
AT+CNMP Configure network mode:
13:GSM only
38:LTE only
48 : Any modes but LTE
... ....

For more AT commands, please refer to: AT_Command_V2.00
You can also refer to:SIMCom


  • Note 1: Please connect the cooling fan before you power the whole device, otherwise, the control chip will be damaged!
  • Note 2: Please check the voltage before you connect the cooling fan, it is default 12V.

To use the RTC, you need to disable DSI or CSI interfaces.
Or modify the RTC/FAN resitors for changing the I2C to I2C1 (right side).
You need to modify codes if you change the i2c.


To enable the I2C for controling the fan and the RTC, you need to add the line "dtparam=i2c_vc=on" on thw config.txt file
RTC is connected to i2c-10 with address 0x51(7bits)
FAN is connected to i2c-10 with address 0x2f(7bits)

sudo nano /boot/config.txt

Add the following lines to the end of the config.txt


And then comment out the line dtparam=audio=on


Save the file and reboot the system

sudo reboot

RTC test

1.Download the test demo.

Open the terminal of the Raspberry Pi, enter the following command:

sudo apt-get install p7zip-full
sudo wget
7z x PCF85063_code.7z -O./
cd PCF85063_code

2. Run the demo


Execute the following commands to compile and execute the test demo:

cd c
sudo make clean
sudo make -j 8
sudo ./main

And then you can check the running result as below:

RTC PCF85063 c test.png


Enter the python/example directory:

cd python/example

And then run the python demo, the demo can support python2/3

# python2
sudo python
# python3
sudo python3

The running result is as below:

RTC PCF85063 python test.png

Using Hwclock

  • Synchronize the system clock and the RTC
sudo hwclock -w
  • Synchronize the hardware clock and the RTC
sudo hwclock  -s

Note that it will be restore if the network is diabled

  • Set hardware clock
sudo hwclock --set --date="9/8/2021 16:45:05"
  • Check the hardware clock
sudo hwclock -r
  • Check the version
sudo hwclock --verbose

FAN test

【Note】Please connect the fan first before connecting the power to the Board to complete! Please do not connect the fan to the Board when the board is powered on(the fan control chip is powered on), otherwise, it will be damaged!
There is not official seting method for the cooling, there is a third-party project for reference.

mkdir -p ~/src
cd ~/src
git clone
cd cm4io-fan
sudo chmod 777
sudo  ./


CSI and DSI are disabled by default. When using the camera and DSI, it will occupy three I2C devices: I2C-10, I2C-11, and I2C-0.

  • Open a terminal and run the following commands:
sudo apt-get install p7zip-full
 7z x CM4_dt_blob.7z -O./CM4_dt_blob
 sudo chmod 777 -R CM4_dt_blob
 cd CM4_dt_blob/
 #If you want to use both cameras and DSI0
 sudo  dtc -I dts -O dtb -o /boot/dt-blob.bin dt-blob-disp0-double_cam.dts
 #If you want to ue both cameras and DSI1
 sudo  dtc -I dts -O dtb -o /boot/dt-blob.bin dt-blob-disp1-double_cam.dts
  • And then connect the cameras and DSI display

1: Please power off the IO Board first before your connection.
2: Connect the power adapter after connecting the cameras and DSI display
3: Wait a few seconds before the screen boot up.
4: If the DSI LCD cannot display, please check if you have added /boot/dt-blob.bin. If there already has the dt-blob.bin, just try to reboot.
5: The camera needs to be enabled by raspi-config, enter sudo raspi-config on the terminal, choose Interfacing Options->Camera->Yes->Finish-Yes and reboot the system

  • Test the Cameras:

Test camera0:

sudo raspivid -t 0 -cs 0

Test camera1:

sudo raspivid -t 0 -cs 1

For more information about the CSI camera and DSI display, please refer to:


1. Please remove the line dtparam -audio - on from /boot/config.txt file
2. Remove dt-blob.bin file from boot direcotry if it exist.




If you require technical support, please go to the Support page and open a tickets.