Cherry TIGER SOM-RK3588-Q7 User Manual

Power efficient system-on-module with octa-core arm featuring the rockchip rk3588 application processor

Advertisement

Quick Links

TIGER SOM-RK3588-Q7
Power efficient System-on-Module with Octa-Core ARM
featuring the Rockchip RK3588 application processor
USER MANUAL
Document revision:
Issue date:
v1.2.0
Apr 07, 2024

Advertisement

Table of Contents
loading

Summary of Contents for Cherry TIGER SOM-RK3588-Q7

  • Page 1 TIGER SOM-RK3588-Q7 Power efficient System-on-Module with Octa-Core ARM featuring the Rockchip RK3588 application processor USER MANUAL Document revision: v1.2.0 Issue date: Apr 07, 2024...
  • Page 3: Table Of Contents

    Insert TIGER SOM-RK3588-Q7 ........
  • Page 4 On-board Devices ..........Using GPIOs .
  • Page 5: Introduction

    It features an Arm Mali-G610 MP4 quad-core GPU which enables complex use cases from gaming graphics to machine learning (ML). The TIGER SOM-RK3588-Q7 also features an Neural Process Unit (NPU) with computing power up to 6 TOPS with an ability to receive camera sensor input through a MIPI-CSI interface and to process the resulting imagestream in real-time with the powerful ARM processor and NPU cores which enables AI, vision and image-analytics applications.
  • Page 6: First Steps

    2.1 Insert TIGER SOM-RK3588-Q7 Insert the TIGER SOM-RK3588-Q7 module at a 30-degree angle into the HAIKOU CB-MINI-ITX Qseven con- nector. Once fully inserted, push it down until it rests on the standoffs and check alignment of the mounting holes.
  • Page 7: Mount The Fan

    2.3 Mount the Fan Using the module for short scripts and a couple of commands does not require a mounted fan. However, as TIGER SOM-RK3588-Q7 is designed for computationally intensive use cases a fan is recommended. 2.4 Power Up For bootloader configuration and Linux console, the serial interface can be used. Connect either a Micro-USB or RS-232 cable to the corresponding port.
  • Page 8 UART RS-232 +12V RS-485 Power Power Fig. 2.3: Serial console and boot configuration v1.2.0 Page 4...
  • Page 9: Using The Devkit

    Power USB 3.0 Battery Buzzer CTRL I/O SMBus microSD-Card Misc I/O SPI + I2C GPIO UPDI Reset Power Batlow Sleep Wake Fig. 3.1: HAIKOU CB-MINI-ITX with TIGER SOM-RK3588-Q7 TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 5...
  • Page 10: Power Supply

    3.2 Power Supply HAIKOU CB-MINI-ITX can operate with a single 12V DC power supply. The 12V DC connector is highlighted below. +12V Power Power Fig. 3.2: 12V Power connector Power can be controlled manually from the carrier board using the control buttons and switches, located Power on the lower right side of the carrier board (see Section 3.1 HAIKOU CB-MINI-ITX Overview).
  • Page 11: Control Buttons And Switches

    3.3 Control Buttons and Switches The control buttons (see Fig. 3.1 HAIKOU CB-MINI-ITX with TIGER SOM-RK3588-Q7) provide the following func- tionality: • toggles the module power supply. Power • triggers a module reset. Reset • are routed to GPIOs on the Q7 module.
  • Page 12 Fig. 3.3: Fan connector Note: TIGER SOM-RK3588-Q7 is designed for highly intensive tasks, so it normally emits heat. In normal use-cases and normal conditions, TIGER SOM-RK3588-Q7 emits heat while operating. v1.2.0 Page 8...
  • Page 13: Boot Order

    SD card USB loader USB loader If no bootloader is found on any storage device, TIGER SOM-RK3588-Q7 module will go into USB loader mode, showing up as a USB device on the USB-OTG port. The electrical state of the signal for both slider positions is shown below:...
  • Page 14 For macOS, drivers are available from Silicon Labs: https://www.silabs.com/products/development-tools/ software/usb-to-uart-bridge-vcp-drivers TIGER SOM-RK3588-Q7 has two external UARTs: • UART0 is, by default, used for the serial console for interactive login. • UART1 is unused by default and can be freely used for machine-to-machine communications or other purposes.
  • Page 15: Rs-232 And Rs-485

    You can log in as with password root root 3.7 RS-232 and RS-485 To connect via RS-232 or RS-485, connect to the jack on HAIKOU CB-MINI-ITX. RS232 / RS485 TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 11...
  • Page 16 Full-Duplex RS-232 Half-Duplex RS-485 Fig. 3.5: RS-232 connector The switch labeled selects between RS-232 and RS-485 mode on the jack. RS-232 / RS-485 In RS-485 mode, the switch labeled selects full- or half-duplex mode, respec- Full Duplex / Half Duplex tively.
  • Page 17: Ttl Uart

    SSH login on port 22. 3.10 SD-Card TIGER SOM-RK3588-Q7 supports UHS SD cards and maximum writing speed on the SD card is 50 MB/s. The practical writing and reading speeds depend on the capabilities of the inserted SD card.
  • Page 18 USB-OTG Fig. 3.6: USB 3.0 OTG port (dual-role port: can be used as a host or device interface) v1.2.0 Page 14...
  • Page 19 Check the kernel log to find the device name: dmesg -f You will be able to mount its partitions (assuming mapping to /dev/sdb1 mkdir /mnt/usb1 mount /dev/sdb1 /mnt/usb1 ls /mnt/usb1 TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 15...
  • Page 20: Display And Camera

    3.12 Display and Camera TIGER SOM-RK3588-Q7 supports display output on the eDP0/LVDS A interface and the camera on the eDP1/LVDS B interface. For MIPI-DSI and MIPI-CSI, the Qseven LVDS pins are used. Those pins are routed to the . This expansion slot uses a PCIe connector as mechanical connection, which allows Video connector easy development of adapter boards for various different display types.
  • Page 21: Ffc Expansion Connectors

    3.13 FFC Expansion Connectors Fig. 3.9: Top FFC expansion connector. The second connecter is right below on the bottom of the PCB. TIGER SOM-RK3588-Q7 has two FFC connectors that enables it to support multiple cameras.. 3.14 RTC TIGER SOM-RK3588-Q7 contains a real-time clock (RTC) on-module.
  • Page 22: Spi And I2C

    3.15 SPI and I2C SPI and I2C interfaces are both available on the pin header labeled . TIGER SOM-RK3588-Q7 SPI+I2C+1-Wire does not support 1-Wire Fig. 3.10: I2C and SPI header Additional I2C buses are available on the header. (shown in thin font in Fig. 3.11).
  • Page 23 Fig. 3.11: SMBUS header For I2C, the i2c-tools package is available in Debian: apt-get install i2c-tools TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 19...
  • Page 24: Gpios

    3.15.1 Linux I2C Bus Numbering Linux identifies each I2C bus by a bus number. The table below shows the mapping between Q7 names, Linux bus number and HAIKOU CB-MINI-ITX header. Q7 signal Linux bus connections/headers Q7_I2C_CLK, Q7_I2C_DAT SPI+I2C+1-Wire Q7_SMB_CLK, Q7_SMB_DAT SMBus Q7_HDMI_CTRL_CLK, Q7_HDMI_CTRL_Dat HDMI...
  • Page 25: Audio

    Note: The codec on HAIKOU CB-MINI-ITX only supports a sample rate 48kHz . This restriction only applies to this specific codec on HAIKOU CB-MINI-ITX. The I2S bus on TIGER SOM-RK3588-Q7 supports a sample rate up to 192kHz. TIGER SOM-RK3588-Q7 User Manual v1.2.0...
  • Page 26 Additionally, an expansion connector for I2S audio is available on the bottom row of the carrier board: 3V3_LDO I2S_RST# I2S_CLK I2S_WS I2S_SDO I2S_SDI I2S_DAT I2S_CLK Fig. 3.13: Audio jacks and I2S header v1.2.0 Page 22...
  • Page 27: Can Bus

    3.18 CAN Bus HAIKOU CB-MINI-ITX provides a CAN connector on the bottom row. Fig. 3.14: CAN header TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 23...
  • Page 28: Ctrl I/O Connector

    3.19 CTRL I/O Connector HAIKOU CB-MINI-ITX provides signals for watchdog trigger in- and output, SoM PMIC power-on input, reset and external display power enable. Fig. 3.15: CTRL I/O header v1.2.0 Page 24...
  • Page 29: Misc Connector

    3.20 MISC Connector HAIKOU CB-MINI-ITX provides signals for thermal overheat of external hardware and the processor, utility signals for SD and GPIO0. Fig. 3.16: MISC header TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 25...
  • Page 30: Software Overview

    4 Software Overview This chapter provides instructions for compiling and deploying the BSP (Board Support Package) software to TIGER SOM-RK3588-Q7. 4.1 Supported Distributions Two of the most popular embedded systems distributions are supported. The following chapters describe how to build a disk image for: •...
  • Page 31: Debian Image Guide

    This chapter will go through all neccessary steps, finally building a complete image using the debos Debian image builder. The result will be a fully-functional Debian system. Alternatively, prebuilt images can be downloaded from https://downloads.embedded.cherry.de/tiger/ At the time of writing this document, the following Debian image variants are available for TIGER SOM-RK3588-Q7: •...
  • Page 32: Compile U-Boot

    Get the source code and compile the U-Boot bootloader as follows: # Set up cross-compilation export ARCH=arm64 export CROSS_COMPILE=aarch64-linux-gnu- # Download the source code git clone https:^//git.embedded.cherry.de/tiger-u-boot.git tiger-u-boot return # Load u-boot config make tiger-rk3588_defconfig # Build idbloader.img make spl/u-boot-spl.bin -j"$(nproc)"...
  • Page 33: Building The Debos Image

    ^--archive "$TIGER_LINUX_DIR"/overlay/lib/modules/ tiger/overlay/lib/ ^## Remove known problematic symlinks as debos would dereference them rm tiger/overlay/lib/modules/*/build rm tiger/overlay/lib/modules/*/source # Copy U-Boot binaries into the ``tiger`` folder (continues on next page) TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 29...
  • Page 34 (continued from previous page) cp "$TIGER_UBOOT_DIR"/idbloader.img tiger/ cp "$TIGER_UBOOT_DIR"/u-boot.itb tiger/ 5.5.2 Build a complete image Both bookworm and bookworm-phosh Debian images are available. You can build one of your choice or both of them. Default variant is Debian 12 Bookworm. The other variant can be chosen by setting the debos_variant environment variable when running build.sh...
  • Page 35: Deploy A Disk Image

    # Download miniloaders used for flashing git clone https:^//github.com/rockchip-linux/rkbin.git tools/rk_tools # Build miniloader binaries tools/rk_tools/ return # Tag linux-5.10-gen-rkr4.1 git checkout "1356c978" ./tools/boot_merger RKBOOT/RK3588MINIALL.ini (continues on next page) TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 31...
  • Page 36 (continued from previous page) # Make the resulting files available to later steps export RKDEVELOPTOOL_DIR="$PWD/tools/rk_tools/" This step should take about 1 minute total. 6.2.2 Enter USB flashing mode To enter the USB flashing mode, make sure the slider (see Fig. 3.1 HAIKOU CB-MINI-ITX with TIGER BOOT SW SOM-RK3588-Q7) is in mode and there’s no SD card inserted in HAIKOU CB-MINI-ITX.
  • Page 37: Companion Controller Features

    This chapter describes the companion controller (Mule ATtiny) features. 7.1 How to flash Mule-ATtiny The ATtiny can be flashed through the UPDI lines, from the running system on TIGER SOM-RK3588-Q7 (No additional hardware required). For convenience, tool is available for flashing the Mule ATtiny mule-attiny.sh...
  • Page 38: Serial Number

    8 Serial Number 8.1 Serial Number Each TIGER SOM-RK3588-Q7 has a unique serial number that can be read by software. In U-Boot, the serial number is contained in the environment variable . You can print it using the serial# command:...
  • Page 39: Hardware Guide

    This Hardware Guide provides information about the features, connectors and signals available on TIGER SOM-RK3588-Q7, as TIGER SOM-RK3588-Q7 has 2 different connectors; the main connection is Q7 and the sub connection is the FFC Connector, and so the FFC Connector will be discussed in related sections.
  • Page 40: Q7 Connector Pinout

    9.2 Q7 Connector Pinout The following table shows the signals on the edge connector of the TIGER SOM-RK3588-Q7 module. Empty cells are simply not connected pins. Q7 name CPU Pin name Q7 name CPU Pin name GBE_MDI3 (ETH PHY) GBE_MDI2...
  • Page 41 HDMI_TX0_D3N USB_SSTX1+ TYPEC0_SSTX1P TMDS_CLK DP_LANE1+/ HDMI_TX0_D1P DP_AUX+ EDP_TX0_AUXP TMDS_LANE1+ DP_LANE1/ HDMI_TX0_D1N DP_AUX EDP_TX0_AUXN TMDS_LANE1 DP_LANE2+/ HDMI_TX0_D0_P USB_SSRX1 TYPEC0_SSRX1N TMDS_LANE0+ DP_LANE2/ HDMI_TX0_D0_N USB_SSRX1+ TYPEC0_SSRX1P TMDS_LANE0 continues on next page TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 37...
  • Page 42 Table 9.1 – continued from previous page Q7 name CPU Pin name Q7 name CPU Pin name DP_LANE0+/ HDMI_TX0_D2P HDMI_CTRL_DAT GPIO0_D4 TMDS_LANE2+ DP_LANE0/ HDMI_TX0_D2N HDMI_CTRL_CLK GPIO0_D5 TMDS_LANE2 DP_HDMI_HPD# GPIO1_A5 DP_HPD# GPIO4_B5 PCIE_CLK_REF+ PCIE_WAKE# GPIO4_A4 PCIE_CLK_REF PCIE_RST# GPIO3_B6 PCIE3_TX+ PCIE30_PORT1_TX1P PCIE3_RX+ PCIE30_PORT1_RX1P PCIE3_TX PCIE30_PORT1_TX1N...
  • Page 43: Ffc Expansion Connector Pinout

    9.3 FFC Expansion Connector Pinout The following table shows the signals on the FFC connectors of the TIGER SOM-RK3588-Q7 module. Empty cells are simply not connected pins. P2-(Top-FFC) Sig- P2-(Top-FFC) P3-(bottom-FFC) P3-(bottom-FFC) Display-Name nal_Name CPU_Pin/function Signal-Name CPU_Pin/function VCC3V3_S3 VCC3V3_S3 VCC3V3_S3...
  • Page 44: Signal Details

    Table 9.2 – continued from previous page P2-(Top-FFC) Sig- P2-(Top-FFC) P3-(bottom-FFC) P3-(bottom-FFC) Display-Name nal_Name CPU_Pin/function Signal-Name CPU_Pin/function RST# CSI1_RST GPIO4_C6 HDMI_RX_SDA_M0 HDMI_RX_SDA_M0/ GPIO0_D1 CAM1D1_P MIPI_DPHY1_RX_D1P/ HDMIRX_D1_P HDMIRX_D1P MIPI_CPHY1RX_TRIO1_A CAM1D1_N MIPI_DPHY1_RX_D1N/ HDMIRX_D1_N HDMIRX_D1N MIPI_CPHY1RX_TRIO0_C CAM0_GPIO CSI0_GPIO0 GPIO2_B5 CSI2_GPIO0 SPI4MISO_M0/ UART3RX_M0/ I2C3_SDA_M0/ GPIO1_C0 CAM1_GPIO CSI1_GPIO1 GPIO0_B2...
  • Page 45 I2C signals on P3 (Bottom FFC) Signal Type Signal Level Description I2C3_SCL_M0 1.8V I2C bus data line connected to RK3588_Q7 I2C3_SDA_M0 1.8V I2C bus data line connected to RK3588_Q7 TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 41...
  • Page 46 DSI_TX3- eDP0_AUX+/ LVDSA_CLK+ DSI_CLK+ eDP0_AUX/ LVDSA_CLK DSI_CLK- The TIGER SOM-RK3588-Q7 supports MIPI-CSI. • MIPI CSI D_PHY v1.0 • Up to four data lanes • Up to 1.0 Gbps per lane The signal function mapping for Q7 is shown below: Q7 Signal...
  • Page 47 FFC connector is meant for use with cameras however its pins can also be used as an additional UART (not simultaneously): on FFC P2 (Top FFC Connector) Signal Type Signal Level CPU/Linux Pin CSI0_ENA 1.8V UART7_RX_M0 CSI0_GPIO0 1.8V UART7_TX_M0 TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 43...
  • Page 48 9.4.10 Misc Signal Type Signal Description Level WDTRIG# 3.3V Watchdog trigger signal WDOUT 3.3V Watchdog event indicator SPKR 3.3V ATtiny pin PB5 used for external buzzer control BIOS_DISABLE# 3.3V Disables the onboard bootloader and uses the one the SD card /BOOT_ALT# instead.
  • Page 49: On-Board Devices

    PHY signal Connected to RESET CPU pin GPIO4_C3 MDIO CPU pin GPIO4_C5 CPU pin GPIO4_C4 LED1 Qseven GBE_LINK1000 and GBE_LINK100 and GBE_LINK (tied together) LED2 Qseven GBE_ACT TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 45...
  • Page 50: Using Gpios

    9.5.5 Test points TIGER SOM-RK3588-Q7 Test point Connected to VCCA_1V8_S0 VDD_DDR_S0 VDD_GPU_S0 VCC_1V8_S0 VDDA_1V2_S0 VCCA_3V3_S0 VCCIO_SD_S0 VDD2_DDR_S3 VDD_CPU_LIT_S0 TP10 VDD_0V75_S3 TP11 VDDA_DDR_PLL_S0 TP12 VDDA_0V75_S0 TP13 VDDA_0V85_S0 TP14 VDD_0V75_S0 TP15 VDDQ_DDR_S0 TP16 VDD_LOG_S0 TP17 VCC_3V3_S3 TP18 VDD_VDENC_S0 TP19 VCC_1V8_S3 TP20 VCC_2V0_PLDO_S3...
  • Page 51 GPIO3_D1 SPI_CS1# GPIO4_B1 SPI_SCK GPIO3_D3 The FFC expansion connectors are meant for use with cameras however it’s pins can also be used as GPIOs: P3 (Bottom FFC connector): TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 47...
  • Page 52 Signal Type Signal Level CPU Pin Linux GPIO# I2C3_SCL_M0 1.8V GPIO1_C1 I2C3_SDA_M0 1.8V GPIO1_C0 CSI2_RST 1.8V GPIO1_D5 CSI2_ENA 1.8V GPIO2_C5 CSI2/3_MCLK 1.8V GPIO1_B7 HDMI_RX_HPD 3.3V GPIO3_D4 HDMI_RX_SDA 3.3V GPIO0_D1 HDMI_RX_SCL 3.3V GPIO0_D2 CSI2_GPIO0 1.8V GPIO0_A0 P2 (Top FFC connector): Signal Type Signal Level CPU Pin...
  • Page 53: Electrical Specification

    The power supply requirements are listed in the table below and are identical to the Qseven specification. Rail Description Nominal voltage Tolerance Main power supply 4.75 … 5.25V VCC_RTC Backup battery 2.4 … 3.3V TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 49...
  • Page 54: Mechanical Specification

    9.8 Mechanical Specification 9.8.1 Module Dimensions The mechanical dimensions of the module are shown below. Fig. 9.1: Module dimensions (all values in mm) 9.8.2 HAIKOU CB-MINI-ITX Dimension The mechanical dimensions of HAIKOU CB-MINI-ITX match the Mini-ITX form factor and can be mounted in a standard Mini-ITX PC Case.
  • Page 55: Contact

    10 Contact Cherry Embedded Solutions GmbH Seestadtstraße 27 1220 Vienna Austria Inquiries: sales-es@cherry.de Technical Support: support-es@cherry.de TIGER SOM-RK3588-Q7 User Manual v1.2.0 © Cherry Embedded Solutions GmbH Page 51...
  • Page 56: Revision History

    Updates for Tiger v1.1 Mar 07, 2024 v1.1.1 debos build instructions corrections Apr 02, 2024 v1.2.0 Add instructions on how to use kernel modules in debos Made shell code snippets pass shellcheck Theobroma Systems is now CHERRY Embedded Solutions v1.2.0 Page 52...

Table of Contents