Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Chipsee Manuals
  4. Industrial PC
  5. Raspberry Pi OS
  6. User manual

Chipsee Raspberry Pi OS User Manual

Hide thumbs

Advertisement

Quick Links

Download this manual
Industrial PC
Raspberry Pi OS on
Raspberry Pi CM5 User
Manual
For Raspberry Pi CM5 Products
Content can change at anytime, check our website for latest information of this product.
www.chipsee.com

Advertisement

loading
Need help?

Need help?

Do you have a question about the Raspberry Pi OS and is the answer not in the manual?

Questions and answers

Related Manuals for Chipsee Raspberry Pi OS

Summary of Contents for Chipsee Raspberry Pi OS

  • Page 1 Industrial PC Raspberry Pi OS on Raspberry Pi CM5 User Manual For Raspberry Pi CM5 Products Content can change at anytime, check our website for latest information of this product. www.chipsee.com...

  • Page 2: Table Of Contents

    Contents Raspberry Pi OS 1. Prepare for Developing 1.1. Prepare the Hardware 1.2. Prepare the Software 2. Connect to the Device 2.1. Connect From Serial Port 2.1.1. Enable/Disable Serial Debug Port 2.1.2. Connect the Wire 2.1.3. Linux and MacOS 2.1.4. Windows 2.2.
  • Page 3 4. Flashing an image to the Compute Module 4.1. Prerequisites 4.2. Usbboot 4.2.1. For Window 4.2.2. For Linux 4.2.3. For MacOS 4.3. Flash the eMMC 5. Hailo AI 6. FAQ 7. Disclaimer 8. Technical Support Chipsee Page 3 of 65...

  • Page 4: Raspberry Pi Os

    This is the software manual for Chipsee Raspberry Pi CM5 industrial PC. If you’ve never developed on this hardware with a Raspberry Pi OS, this manual can get you started quickly. Supported Chipsee PCs: all Chipsee Raspberry Pi CM5 based industrial PCs, including but not limited to: •...
  • Page 5 Raspberry Pi OS on Raspberry Pi CM5 User Manual • AIO-CM5-156 (CS19108RA5156A) Chipsee Page 5 of 65...

  • Page 6: Prepare For Developing

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Prepare for Developing Prepare for Developing To power on the Chipsee industrial PC, you need a power adapter; then you may want to connect to this PC from your laptop or computer. Let’s prepare some hardware and software.
  • Page 7 Raspberry Pi OS on Raspberry Pi CM5 User Manual Prepare the Software To use a remote desktop, you can download VNC Viewer on your laptop or PC. 7zip for firmware image decompression, you could use your workstation’s stock unzip program as well.

  • Page 8: Connect To The Device

    Connect the Wire In our pre-built Raspberry Pi OS, the RS232_0 serves as a serial debug port. We can connect a RS232 cable between the Chipsee industrial PC and our workstation, allowing us to control the Chipsee industrial PC from our workstation.
  • Page 9 RS232_0 (RX and TX) pins of my Chipsee industrial PC. Use a USB to Serial Cable to Connect the Chipsee Industrial PC with Your Workstation Take a look at the image below, this is the 10.1” product, if your product has a different screen size, check out the hardware document to find out which pins are RS232_0 TX and ...

  • Page 10: Linux And Macos

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Serial Port Connect 3 Pins with Dupont Wires (or with a phoenix connector) Linux and MacOS For MacOS and Linux users, you will need a program called screen. It should be already installed on most MacOS and Linux distributions(if the screen program is not installed on your computer, you can search how to install it, for example, “apt install...
  • Page 11 Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Serial Port Find Out Which Device is Your USB to Serial Cable You can put the device name you found to the screen program as an argument. To connect to the device (115200 is the default baud rate of the device): screen /dev/tty.usbserial-10...

  • Page 12: Windows

    For Windows users, you don’t need to install a specific “driver” kind of thing for Windows to recognize a Chipsee PC, but before proceeding, you should see a COM port appear/disappear when plug/unplug your USB to serial cable in Windows.
  • Page 13 Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Serial Port Input your-com in the Serial Line field, in our case COM3 Now you should be able to connect from your workstation to the device through the serial port. You can try to hit Enter, or type some commands, like ls , to see if the device replies to your commands.

  • Page 14: Connect From Network (Ssh)

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Network (SSH) Connect From Network (SSH) [Cheatsheet for experienced developers: username: pi, password: raspberry] By default SSH and VNC are disabled for security reasons, you could enable them through: •...
  • Page 15 Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Network (SSH) Hit Enter and Confirm to Enable SSH You can SSH to the device when it’s connected to the network, either through Wi-Fi or Ethernet. First make sure you’re connected through WiFi or Ethernet (to learn how, jump to the Network section below.
  • Page 16 Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Network (SSH) Hit Enter and Confirm to Enable SSH 1 pi@raspberrypi:~ $ ifconfig 2 eth0: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500 ether 2c:cf:67:b8:84:5c txqueuelen 1000 (Ethernet) RX packets 0 bytes 0 (0.0 B)

  • Page 17: Linux / Macos

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Network (SSH) 29 wlan0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.50.159 netmask 255.255.255.0 broadcast 192.168.50.255 inet6 fe80::99ba:18c8:40a8:8fc3 prefixlen 64 scopeid 0x20<link> ether 2c:cf:67:b8:84:5d txqueuelen 1000 (Ethernet) RX packets 189 bytes 53162 (51.9 KiB)
  • Page 18 Raspberry Pi OS on Raspberry Pi CM5 User Manual Connect From Network (SSH) should remain 22, choose SSH as the connection type in the radio buttons, click “Open”. The password is raspberry. Input username@your-ip in the Host Name field, in our case pi@192.168.50.159 Now you have connected to the device through the network.

  • Page 19: Connect With Vnc Remote Desktop

    VNC port: 5900 (default port).] We can have a graphical user interface if we use VNC to connect to our Chipsee industrial PC. This is handy if you’re developing an HMI and want to test from your own laptop or computer.
  • Page 20 After enabling the VNC service, refer to the previous section to learn how to use ifconfig to find out your Chipsee industrial PC’s IP address. In our case we get 192.168.50.159. Then, for either Windows, macOS or Linux users, please open the VNC Viewer software on your laptop or PC.
  • Page 21 And then continue, VNC Viewer might tell you the connection is not encrypted, it’s OK if you’re in your local network. Now we should see our Chipsee industrial PC’s desktop GUI in the VNC Viewer software. Chipsee...

  • Page 22: Hardware Resources

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Hardware Resources Hardware Resources When you develop software for the Chipsee industrial PC, you can open the hardware document beside this software document, to aid you in wiring your devices. Network ...

  • Page 23: Lte (Cat4 Module)

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Network wlan0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> 1500 inet 192.168.50.159 netmask 255.255.255.0 broadcast 192.168.50.255 inet6 fe80::99ba:18c8:40a8:8fc3 prefixlen scopeid 0x20<link> ether 2c:cf:67:b8:84:5d txqueuelen 1000 (Ethernet) You can find your ipv4 address of each interface after the inet line.
  • Page 24 Raspberry Pi OS on Raspberry Pi CM5 User Manual Network Checking Modem with mmcli If your product has a 4G modem, after inserting a SIM card, you can test the 4G/LTE with the Chipsee Hardware Test program first: Chipsee Page 24 of 65...
  • Page 25 Raspberry Pi OS on Raspberry Pi CM5 User Manual Network In the Hardware Test program, click 4G Enable , then Refresh to check your connection information, you can also open the browser to test you’re connected to the Internet. To programmatically enable 4G: In QMI mode you can use quectel-CM to enable 4G/LTE to connect to Internet: sudo quectel-CM &...
  • Page 26 Raspberry Pi OS on Raspberry Pi CM5 User Manual Network Run quectel-CM to Enable 4G and Connect to the Internet The quectel-CM program doesn’t persist across reboot, you may consider creating a systemd service to auto start the quectel-CM program on boot, or run the sudo quectel-CM &...
  • Page 27 Raspberry Pi OS on Raspberry Pi CM5 User Manual Network [Install] WantedBy=multi-user.target Reload the systemd after creating or modifying quectel-cm.service : sudo systemctl daemon-reload Manually start/stop the service (enable/disable 4G): sudo systemctl start quectel-cm.service sudo systemctl stop quectel-cm.service Check status and logs: sudo systemctl status quectel-cm.service...

  • Page 28: Lte (Cat1 Module)

    The product uses RNDIS (Remote Network Driver Interface Specification) for 4G modem. If you still have problems connecting with 4G, you can take a look at /opt/chipsee/test folder, unzip the /opt/chipsee/test/simcom-linux-4g with sudo tar -xzf simcom-linux-4g.tar.gz , there is a README file along with some scripts used to connect 4G.
  • Page 29 Raspberry Pi OS on Raspberry Pi CM5 User Manual Network System device: /sys/devices/platform/axi/1000480000.usb/ usb5/5-1 ports: eth1 (net), ttyACM0 (at), ttyACM1 (ignored), ttyACM2 (at) ----------------------------- Status state: failed failed reason: sim-missing power state: on ----------------------------- Modes supported: allowed: any; preferred: none...

  • Page 30: Ethernet And Wifi

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Network Ethernet and WiFi When you plug your Ethernet cable to the device, Ethernet should be connected automatically. For connecting to WiFi, it’s the same as normal Raspberry Pi’s, you can refer to the Raspberry Pi’s official documentation to learn how to use WiFi and Ethernet in the...
  • Page 31 From the terminal, you can use nmcli to configure the network, nmcli is the new default of Raspberry Pi OS. If the examples in the official Pi’s documentation is not enough, you can also refer to the documents of the nmcli program.

  • Page 32: Gnss/Gps

    CAT-4 module, and a GPS antenna, you can enable the GPS feature. You can test with the Chipsee hardware test program, click GPS Enable button, you should see some random code(GPS information) in the text box. Wait a few minutes for GPS to become stable.
  • Page 33 Raspberry Pi OS on Raspberry Pi CM5 User Manual GNSS/GPS $ microcom –s 9600 -p /dev/ttyUSB2 ATE1 # Enable displaying. Hit Enter after you type ATE1 AT+QGPSCFG="gpsnmeatype",31 # Turn on all output type, GGA/RMC/GSV/GSA/VTG, this setting will be saved to NVRAM, persists after reboot AT+QGPS=1 # enable GPS, wait some minutes, you can get data from terminal.

  • Page 34: Buzzer

    Raspberry Pi OS on Raspberry Pi CM5 User Manual BUZZER BUZZER The Chipsee industrial PC has one buzzer. We have created one symbol link to /dev/buzzer . You can control it as follows: echo > /dev/buzzer # enable buzzer echo >...

  • Page 35: Backlight

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Backlight Backlight You can turn on or off backlight: $ pinctrl get # get current backlight status # 18: op dh pd | hi // GPIO18 = output $ pinctrl op dh...

  • Page 36: Serial Port Rs232 And Rs485

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Serial Port RS232 and RS485 Serial Port RS232 and RS485 Check the table below of the RS232/RS485 pin definition to wire your ports: 5 inch product • PPC-CM5-050(CS12720RA5050P): Pin Number Definition...
  • Page 37 Raspberry Pi OS on Raspberry Pi CM5 User Manual Serial Port RS232 and RS485 RS232 / RS485 / CAN Pin Definition: Definition Description OS Node Number Pin 16 CAN_H CPU SPI0, CAN BUS “H” signal CAN0 Pin 15 CAN_L CPU SPI0, CAN BUS “L” signal...
  • Page 38 Raspberry Pi OS on Raspberry Pi CM5 User Manual Serial Port RS232 and RS485 10.1 inch and above products • PPC-CM5-101 (CS12800RA5101P) • PPC-CM5-133 (CS19108RA5133) • PPC-CM5-150 (CS10768RA5150) • PPC-CM5-156 (CS19108RA5156) • PPC-CM5-170 (CS12102RA5170) • PPC-CM5-190 (CS12102RA5190) • PPC-CM5-215 (CS19108RA5215) •...
  • Page 39 Raspberry Pi OS on Raspberry Pi CM5 User Manual Serial Port RS232 and RS485 Pin Number Definition Description OS Node System +5V Power Output, No more than Pin 12 1A Current output Table 485 RS232 / RS485 / CAN Pin Definition for 10.1 inch and above products...
  • Page 40 Apart from cutecom, you can also use the pre-installed HardwareTest program developed by Chipsee to test serial ports, for example, you’ve wired the serial cable on the RS232_0_RX, RS232_0_TX on the 10.1 inch product, then you can select “ttyAMA0” in “COM”, click “SerialOpen”.
  • Page 41 Raspberry Pi OS on Raspberry Pi CM5 User Manual Serial Port RS232 and RS485 If you’re an experienced engineer, you can also use a programming language to test the serial ports, like C, C++, Python, Javascript. They have their libraries for controlling serial port devices.

  • Page 42: Can Bus

    CAN Bus CAN Bus There is one CAN bus on the Raspberry Pi CM5 based Chipsee industrial PC. You can install can-utils and use them to test CAN. But you must add one 120Ω resistor between CAN_H and CAN_L on one of the two Boards, as shown on the figure below.
  • Page 43 Raspberry Pi OS on Raspberry Pi CM5 User Manual CAN Bus Make sure to mount the 120Ω matched resistor. • Bring up the device using the command: $ sudo ip link can0 up • Transfer packets $ sudo cansend can0 5A1#11.2233.44556677.88 •...

  • Page 44: Gpio

    Raspberry Pi OS on Raspberry Pi CM5 User Manual GPIO GPIO There are 8 GPIOs, 4 output and 4 input. They are all optical isolated. You can control the output or input pin voltage by feeding the VDD_ISO suite voltage. The pin voltage should be from 5V to 24V, while testing we usually use an external power supply to apply to GND_ISO and VDD_SIO.

  • Page 45: Chipsee Gpio

    # value 1 indicates high, value 0 indicates low GPIOD By default the product is set to use Chipsee GPIO, to use libgpiod to control the GPIO, first open /opt/chipsee/chipsee-init.sh and comment the following lines to disable Chipsee-GPIO: # comment out the following lines in /opt/chipsee/chipsee-init.sh first...
  • Page 46 Raspberry Pi OS on Raspberry Pi CM5 User Manual GPIO ln -sf /sys/class/gpio/gpio$i/value /dev/chipsee-gpio$num ln -sf /sys/class/gpio/gpio$i/value /dev/gpio-out$nnum num=`expr $num nnum=`expr $nnum done sleep nnum=1 "x$IN" "x" then $IN; [ ! -d /sys/class/gpio/gpio$i ] && echo > /sys/class/gpio/export echo > /sys/class/gpio/gpio$i/direction...
  • Page 47 Raspberry Pi OS on Raspberry Pi CM5 User Manual GPIO libgpiod includes several tools that are available in Raspberry Pi OS, such as: gpiodetect # list gpiochips gpioinfo # list GPIO lines gpiomon # wait for edge events on GPIO lines...

  • Page 48: Camera

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Camera Camera The camera connector(if your product has one) is compatible with the official Raspberry Pi. Please refer to the following link to learn how to attach a camera: https:// www.raspberrypi.com/documentation/computers/compute-module.html#attach-a-camera- module The camera connector uses a 22-pin socket, you can check your product’s hardware...

  • Page 49: Chipsee-Init Shell

    Do a backup first before you modify anything. This script will generaged one log file which is located on /var/log/chipsee-init.sh.log. ® If your device has booting issues, you can send Chipsee the file to help you find out what happened. Chipsee...

  • Page 50: Flashing An Image To The Compute Module

    In short, we will run a Raspberry Pi usbboot program on the host, it will recognize the Chipsee industrial Pi as a storage. After that we press the PROG button on the device before supplying power, while pressing we plug the power cable, the device will boot as a storage, such that our host’s usbboot program can recognize it.
  • Page 51 Raspberry Pi OS on Raspberry Pi CM5 User Manual Usbboot Reboot Windows. Connect the USB-C on the device to your host device. Run the rpiboot program installed by the Windows installer in the Windows Start menu. Run the rpiboot-CM4-CM5 program Press and hold the PROG button, then supply power to the device, keep holding the PROG button for 5 seconds, until you see the host machine’s command line has new...

  • Page 52: For Linux

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Usbboot Successfully Configured eMMC as USB mass storage Then you can enter the Flash the eMMC section below. For Linux To set up software on a Linux host device: Run the following command to install rpiboot (or, alternatively,...
  • Page 53 Raspberry Pi OS on Raspberry Pi CM5 User Manual Usbboot  Note Whether or not to build rpiboot from source depends on your OS version, for example, on Ubuntu 24, the Ubuntu apt source’s rpiboot program is outdated, in this case you need to build from source to recognize CM5.
  • Page 54 Raspberry Pi OS on Raspberry Pi CM5 User Manual Usbboot Has 2712, supports CM5 Connect the USB-C on the device to your host device. Then, run rpiboot: sudo rpiboot # if using OS apt source sudo ./rpiboot -d mass-storage-gadget64 # if you built from source You should see: Loading: mass-storage-gadget64/bootfiles.bin...

  • Page 55: For Macos

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Usbboot For MacOS To set up software on a macOS host device: First, build macOS rpiboot from source. Connect the USB-C on the device to your host device. Then, run the rpiboot executable with the following command: $ sudo ./rpiboot -d mass-storage-gadget64...

  • Page 56: Flash The Emmc

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Flash the eMMC Flash the eMMC After the device’s eMMC has been detected as a USB mass storage, you can use Raspberry Pi Imager Balena Etcher to flash an operating system image to a Compute Module.
  • Page 57 Raspberry Pi OS on Raspberry Pi CM5 User Manual Flash the eMMC Flash OS with Raspberry Pi Imager Clear Settings and Select No Customization Unless You Need Customization Chipsee Page 57 of 65...
  • Page 58 Raspberry Pi OS on Raspberry Pi CM5 User Manual Flash the eMMC Successfully Flash OS with Raspberry Pi Imager • If using Balena Etcher, choose Flash from File and select the decompress .img file; select the appeared mmcblk0 (or similar capacity of your Compute Module) in Select Target , click Flash! .

  • Page 59: Hailo Ai

    Raspberry Pi Hailo documentation, or follow the guide below. As of the time writing (Apr 30, 2025), the Hailo 8L module has been tested on the Chipsee CM5 products, it works pretty much out of the box with only a few commands to install the driver and software kit.
  • Page 60 Raspberry Pi OS on Raspberry Pi CM5 User Manual Hailo AI Version 3.31.0 License unknown Source module gst-hailo-tools Binary package gst-hailo-tools Origin URL https://hailo.ai/ hailoaggregator: hailoaggregator - Cascading hailocounter: hailocounter - postprocessing element hailocropper: hailocropper hailoexportfile: hailoexportfile - export element...
  • Page 61 Raspberry Pi OS on Raspberry Pi CM5 User Manual Hailo AI git clone https://github.com/hailo-ai/hailo-rpi5-examples.git hailo-rpi5-examples ./install.sh Running the examples: source setup_env.sh Setting up the environment... Setting up the environment hailo-tappas-core... TAPPAS_VERSION is 3.31.0. Proceeding... You are not the venv_hailo_rpi5_examples virtual environment.

  • Page 62: Faq

    Raspberry Pi OS on Raspberry Pi CM5 User Manual Hailo 8L on Chipsee PPC-CM5-101 Object Detection Running with USB camera input (webcam): python basic_pipelines/detection.py --input usb How to rotate the screen? Click top left menu, Preferences -> Screen Configuration. Then right click (or long press if using touch screen) HDMI-A-1 grey area, Choose orientation, then select the rotate option.
  • Page 63 Raspberry Pi OS on Raspberry Pi CM5 User Manual How to enable the on screen virtual keyboard? Select Raspberry Pi Configuration, choose “Display”, in On-screen keyboard, select “Enabled Always”, then click OK to save. Chipsee Page 63 of 65...
  • Page 64 Raspberry Pi OS on Raspberry Pi CM5 User Manual The keyboard will automatically pop up when entering text. Chipsee Page 64 of 65...

  • Page 65: Disclaimer

    If you cannot find the solution you’re looking for, feel free to contact us. Please email Chipsee Technical Support at support@chipsee.com, providing all relevant information. We value your queries and suggestions and are committed to providing you with the assistance you require.

This manual is also suitable for:

Raspberry pi cm5