Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



30 Commits

Repository files navigation


We will use this repo to contain the source code and config for Chipsee Raspberry Computer Module Hardware.

How to use this repo to add drivers and configrations on Supported Raspberry Official OS?

Supported Raspberry Official OS

This repository only support follow Raspberry Pi official system now:

  • 2019-04-08-raspbian-stretch (Not support CM4 products)
  • 2020-02-13-raspbian-buster
  • 2020-12-02-raspios-buster
  • 2021-10-30-raspios-bullseye
  • 2022-9-22-raspios-bullseye

If the system you are downloading not list in the above supported list, you also can try, use latest kernel branch to compile, maybe need to do some modification.

1. Prepare system

Install Raspberry Pi official system and boot, run follow commands in ssh or serial debug console. The Chipsee Industrial-Pi network and serial debug port is supported by Raspberry Pi official system default.

2. Download industrial-pi repository

This repository only supports tested kernel version listed in branches. If the kernel version of your system is not in the branches lists, you should select one closer kernel version that you had. If your kernel version is listed in the branches,use follow commands,

git clone --depth=1 --branch `uname -r`

If there is some error about branch, check if the kernel you are using is listed in the branchs, if not, check the following section, or ignore it.

ISSUE: The kernel version you are using is not listed in the branches?

If your kernel version is not listed in the branches, checkout the branches closer to your kernel, check your kernel,

uname -r

select one closer branches, for example your kernel version is 5.10.17-v71+, you can select 5.10.63-v71+ branches

git clone --depth=1 --branch 5.10.63-v71+

and do the following modification

1. modify Makefile
diff --git a/Makefile b/Makefile
index b98ad3c..98de440 100644
--- a/Makefile
+++ b/Makefile
@@ -28,7 +28,6 @@ help:
        @apt-get update
-       @dpkg -i $(TOPDIR)/tools/*.deb
        @make -C $(GT9XX_DIR)
        @echo "Install GT9XX success!!"
        @make -C $(LSM6DS3_DIR)

2. install raspberrypi-kernel-headers packages
sudo apt update
sudo apt install raspberrypi-kernel-headers

3. Compile and install

cd industrial-pi
sudo make install

If there is no error, reboot your board.

4. Uninstall

cd industrial-pi
sudo make uninstall

5. More commands

cd industrial-pi
make help

Supported Chipsee Board

This repository only support follow Chipsee Industrial Board, you can order them from the official Chipsee Web chipsee web site or from your nearest distributor.

  • AIO-CM4-101 / CS12800RA4101A
  • EPC/PPC-CM4-050 / CS12720RA4050 (from 2021-10-30 V2 image)
  • EPC/PPC-CM4-070 / CS10600RA4070
  • PPC-CM4-101 / CS12800RA4101P (from 2021-10-30 V2 image)
  • PPC-CM4-121 / CS10768RA4121P (from 2021-10-30 V2 image)
  • PPC-CM4-133 / CS19108RA4133P (from 2021-10-30 V2 image)
  • PPC-CM4-150 / CS10768RA4150P (from 2021-10-30 V2 image)
  • PPC-CM4-156 / CS19108RA4156P (from 2021-10-30 V2 image)
  • PPC-CM4-215 / CS19108RA4215P (from 2021-10-30 V2 image)
  • PPC-CM4-236 / CS19108RA4236P (from 2021-10-30 V2 image)
  • PPC-CM4-070-D / CS10600RA4070D (from 2022-09-22 V3 image)
  • CS-CM4-BOX / CSRA4BOX (from 2022-09-22 V3 image)

Latest system images

2022-09-22 V5 64bit

2021-10-30 V2 32bit

Release notes

2022-9-22 V5:

  • Add 170/190 product support.

2022-9-22 V2:

  • First released 64bit system
  • 32bit system will be released later.
  • Hold the kernel package, you can upgrade other software by using "apt-get upgrade" commands.

2021-10-30 V2:

  • Add CS12720RA4050 CS12800RA4101P CS19108RA4133P CS10768RA4150P CS19108RA4156P support.
  • Bug Fix: LCDTest of Hardwaretest application don't work.
  • Known bugs: CAN bus will fail to bring up if you don't add 120R resistor between CAN_H and CAN_L.

2021-10-30 V1:

  • First release for Debian 11(bullseye)
  • Known bugs: CAN bus will fail to bring up if you don't add 120R resistor between CAN_H and CAN_L.

2020-12-02 V4:

  • Disable Screen Blank Feature.
  • Add Chipsee Hardwaretest Applications.
  • Bug Fix: some 7" and 10.1" LCD display issue.

2020-12-02 V3:

  • Add PWM backlight support.
  • Add warning about updating system and disable updating system automatically on system fisrtboot.
  • Automatically load WiFi/Bt and disable SD slot as WiFi/Bt and SD slot can't be use at same time.

Older system images

2022-09-22 V3 64bit

2022-09-22 V2 64bit:

2021-10-30 V1:

The follow older buster release use old firmware, it doesn't support latest CM4 Rev1.1, for detailt product change note, refer to CM4 PCN

2020-12-02 V4:

2020-12-02 V3:

2020-12-02 V2:

Q & A

1. System is upgraded, the touchscreen driver is broken, how to fix it?

Solution One(recommend):

Use the upstream goodix touchscreen driver.

  1. comment the gt9xx line in /opt/chipsee/
$ sudo sed -i "s/^modprobe gt9xx/# modprobe gt9xx/g" /opt/chipsee/

The diffrence,

< modprobe gt9xx
> # modprobe gt9xx
  1. Replace gt9xx dtoverlay by using goodix in /boot/config.txt
$ sudo sed -i "s/^dtoverlay=gt9xx/dtoverlay=goodix/g" /boot/config.txt

The diffrence,

< dtoverlay=gt9xx,interrupt=20,reset=21
> dtoverlay=goodix,interrupt=20,reset=21
  1. reboot to check
$ sudo reboot

Solution two:

Rrecompile the Chipsee touchscreen driver.

$ git clone --depth=1 --branch 6.1.21
$ sudo apt update
$ sudo apt install raspberrypi-kernel-headers

if your kernel is updated to 64bit from 32bit, the above commands will install armhf version raspberrypi-kernel-headers. as the filesystem is 32bit, you should add "arm_64bit=0" to /boot/config.txt to switch the kernel to 32bit first. then reboot to compile touchscreen driver. you can use "uname -ra" to check the current kernel.

$ cd industrial-pi/gt9xx/
$ sudo make
$ sudo reboot