Related Manuals for Cherry PUMA SOM-RK3399-Q7
Summary of Contents for Cherry PUMA SOM-RK3399-Q7
- Page 1 PUMA SOM-RK3399-Q7 Powerful System-on-Module for versatile applications featuring the Rockchip RK3399 application processor USER MANUAL Document revision: v1.6 Issue date: Dec 22, 2023...
-
Page 3: Table Of Contents
Mechanical Specification ........RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page i... - Page 4 6 Revision History v1.6 Page ii...
-
Page 5: Introduction
Cortex-A53. These 64bit-capable ARMv8 processors support both the ARM Crypographic Extension (e.g. for wire-rate AES encryption) and AdvSIMD vector processing. A dual-channel memory interface sustains the memory bandwidths required by even the most demanding embedded applications. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 1... -
Page 6: First Steps
2 First Steps This chapter provides instructions for getting the RK3399-Q7 EVK running after opening the box. 2.1 Required Tools • PZ1 (Pozidriv) screwdriver 2.2 Insert the Module Insert the RK3399-Q7 module at a 30-degree angle into the connector in the base board. Once fully inserted , push it down until it rests on the standoffs and check alignment of the mounting holes. -
Page 7: Mount The Fan (Optional)
Power Button (6) to power the board. You will see the boot progress and later on a login prompt on the serial interface. If a HDMI display is connected video output will follow shortly after. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 3... - Page 8 HDMI USB UART Power RS232 v1.6 Page 4...
-
Page 9: Using The Evk
An overview of the available connectors and devices on the EVK is shown below. Buzzer Battery CTRL I/O SMBus Misc I/O GPIO SPI+I2C+1-wire JTAG SD-Card Slot Fig. 3.1: The base board for to RK3399-Q7 module. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 5... -
Page 10: Power Supply
3.2 Power Supply The baseboard can operate with a single 12V DC power supply. Fig. 3.2: 12V Power connector Power can be controlled manually from the board using the Power control buttons and switches, located on the lower right side of the board (see Evaluation Board Overview). Depending on the setting of Normally On / Normally Off switch the board will boot as soon as it receives power. -
Page 11: Boot Order
USB device on the USB-OTG port. The electrical state of the BIOS_DISABLE# signal for both slider positions is shown below: BIOS_DISABLE# signal Slider Position Normal Boot Floating (on-module pull-up to 1.8V) BIOS Disable RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 7... -
Page 12: Usb Serial Console
3.6 USB Serial Console The evaluation board contains an on-board Silicon Labs CP2102N USB-serial converter. Connect the included Micro-USB cable to the Micro-USB jack labeled USB-UART Bridge: Fig. 3.4: USB UART The serial converter does not require additional drivers on Windows and Linux. For Mac OS, drivers are available from Silicon Labs: http://www.silabs.com/products/development-tools/ software/usb-to-uart-bridge-vcp-drivers The Q7 modules has two external UARTs:... -
Page 13: Rs-232 And Rs-485
Fig. 3.6: Ethernet jack The SD card that is shipped with the EVK is configures to automatically retrieve an IP via DHCP and provides SSH login on port 22. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 9... -
Page 14: Usb Interfaces
3.10 USB Interfaces The RK3399-Q7 provides four USB ports: • 1x USB 3.0 OTG • 2x USB 3.0 Host • 1x USB 2.0 Host Fig. 3.7: USB 3.0 OTG port (dual-role port: can be used as a host or device interface) Fig. -
Page 15: Video
For eDP and MIPI-DSI the Qseven LVDS pins are used which are routed to the Display connect. This expansion slot uses a PCIe connector as mechanical connection, which allows easy development of adapter boards for various different display types. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 11... -
Page 16: Rtc
Display Port on LVDS A rk3399-puma-hdmi+mipidsi.dtb HDMI MIPI-DSI on LVDS A See https://git.embedded.cherry.de/som-hardware.git/ for video adapter reference designs. 3.12 RTC the RK3399-Q7 contain a real-time clock (RTC) on-module. The RTC is read by the kernel on bootup and used to set the system clock. -
Page 17: Spi, I2C And 1-Wire
Navigate to Device Drivers -> Input device support -> Keyboards and check the ATMEL AT42QT2160 Touch Sen- sor Chip. You must recompile the kernel and deploy it to the SD card (see Software Guide). RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 13... -
Page 18: Gpios
3.13.2 SMBus The board provides communication through SMBus. It is basically like I2C with an additional line for interrupt and is used for connecting sensors and power peripherals. Fig. 3.14: SMBUS header 3.13.3 Linux Bus Numbering Linux identifies each I2C bus using a bus number. The table below shows the mapping between Q7 names, Linux bus number and EVK header. - Page 19 > /sys/class/gpio/export ls /sys/class/gpio/gpio156 cat /sys/class/gpio/gpio156/direction cat /sys/class/gpio/gpio156/value To set the direction to output, write out in the GPIO’s direction file: echo out > /sys/class/gpio/gpio156/direction echo > /sys/class/gpio/gpio156/value RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 15...
-
Page 20: Audio
The GPIO will be set to a value of 1 (high at 3.3V). 3.15 Audio The board provides two audio connectors for input and output. Line-in is on top and Headphones is on bottom of the audio connector. Fig. 3.16: Audio input/output port Additionally, an expansion connector for I2S audio is available on the bottom row of the board: 3V3 LDO I2S_RST#... -
Page 21: Can Bus
Fig. 3.19: CTRL I/O header 3.18 MISC Connector The board provides signals for thermal overheat of external hardware and the processor, utility signals for SD and GPIO0. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 17... - Page 22 Fig. 3.20: MISC header v1.6 Page 18...
-
Page 23: Software Guide
For this manual, it is assumed that version 6-2017-q1 is used. Direct link to the file: https://developer.arm.com/-/media/Files/downloads/gnu-rm/6_1-2017q1/gcc-arm-none-eabi-6-2017-q1-update-linux. tar.bz2 Extract the tar.bz2 archive to /opt: sudo tar -xf gcc-arm-none-eabi-6-2017-q1-update-linux.tar.bz2 -C /opt RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 19... -
Page 24: Compile The Cortex-M0 Power Management Firmware
Set up environment variables to make use of the ARMv6-M compiler, then download the source code and com- pile: export ARCH=arm64 export CROSS_COMPILE=/opt/gcc-arm-none-eabi-6-2017-q1-update/bin/arm-none-eabi- git clone https://git.embedded.cherry.de/rk3399-cortex-m0.git cd rk3399-cortex-m0 make 4.3.1 Optional: Compile the cross-compiler As an alternative to using a ready-made compiler, the firmware repository has a mechanism to compile the ARMv6-M-compiler as a part of the build process. -
Page 25: Compile U-Boot
ARCH=arm64 export CROSS_COMPILE=/opt/gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu- make puma-rk3399_defconfig make -j4 rockchip/rk3399-puma.dtb Image This will create the two files needed for booting with U-Boot (paths are relative to the puma-linux directory): RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 21... -
Page 26: Building The Root Filesystem
• The device tree: arch/arm64/boot/dts/rockchip/rk3399-puma.dtb • The kernel image: arch/arm64/boot/Image 4.8 Building the root filesystem A filesystem can be created using Debootstrap, specifying arm64 as architecture in the command line. Supposing the target dir is called rk3399-rootfs and the chosen distribution is Debian 9 “Stretch” (recom- mended): export targetdir=/opt/rk3399-rootfs sudo mkdir -p $targetdir... -
Page 27: Deploy On Sd Card
The required partition can be created with the command n, then accepting the defaults, except for First sector, where we use 4096: > Partition type: primary primary, extended, free) extended (continues on next page) RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 23... - Page 28 (continued from previous page) Select (default p): <ENTER> Partition number (1-4, default 1): <ENTER> First sector (2048-7774207, default 2048): 4096 Last sector, +sectors +size{K,M,G} (...): <ENTER> This will create a primary partition at offset 2MiB. Enter w to write the new partition table to the disk: >...
-
Page 29: Deploy On Spi Nor-Flash
$kernel_addr_r 0 $filesize load mmc 1 $kernel_addr_r root/u-boot.itb sf erase 0x40000 +$filesize sf write $kernel_addr_r 0x40000 $filesize From Linux: dd if=spl_spi.img of=/dev/mtdblock0 bs=256k seek=0 conv=nocreat dd if=u-boot.itb of=/dev/mtdblock0 bs=256k seek=1 conv=nocreat RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 25... -
Page 30: Deploy On On-Board Emmc Storage
4.11 Deploy on On-Board eMMC storage As the eMMC storage is only accessible from the module itself, you must first boot the RK3399-Q7 from SD card. Partition and format the eMMC storage as described in Partition Setup, but using the device /dev/mmcblk1. Mount the eMMC partition and copy the contents of the SD card to the eMMC storage. - Page 31 XX:XX:XX:XX:XX:XX saveenv The MAC address can be queried from the U-Boot prompt using: printenv ethaddr To reset the MAC address to the default value, run: env delete ethaddr saveenv RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 27...
-
Page 32: Hardware Guide
5 Hardware Guide This Hardware Guide provides information about the features, connectors and signals available on the RK3399-Q7 module. 5.1 Qseven Implementation Qseven has mandatory and optional features. Following table shows the feature set of the RK3399-Q7 module compared to the minimum ARM/RISC based and maximum configuration according to the Q7 standard. System I/O Interface Q7 Minimum RK3399-Q7... -
Page 33: Q7 Connector Pinout
USB_SSRX0- USB_SSTX0+ USB_SSRX0+ USB_SSTX2- USB_SSRX2- USB_SSTX2+ USB_SSRX2+ USB_2_3_OC# USB_0_1_OC# USB_P3- USB_P2- USB_P3+ USB_P2+ USB_CC USB_ID USB_P1- USB_P0- USB_P1+ USB_P0+ LVDS_A0+ LVDS_B0+ LVDS_A0- LVDS_B0- LVDS_A1+ LVDS_B1+ continues on next page RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 29... - Page 34 Table 5.1 – continued from previous page Signal Signal LVDS_A1- LVDS_B1- LVDS_A2+ LVDS_B2+ LVDS_A2- LVDS_B2- LVDS_PPEN LVDS_BLEN LVDS_A3+ LVDS_B3+ LVDS_A3- LVDS_B3- LVDS_A_CLK+ LVDS_B_CLK+ LVDS_A_CLK- LVDS_B_CLK- LVDS_BLT_CTRL / GP_PWM_OUT0 GP_1-Wire_Bus GP2_I2C_DAT / LVDS_DID_DAT LVDS_BLC_DAT / eDP0_HPD# GP2_I2C_CLK / LVDS_DID_CLK LVDS_BLC_CLK CAN0_TX CAN0_RX TMDS_CLK+ USB_SSTX1-...
-
Page 35: Mipi-Csi Feature Interface Pinout
62684-36210E9ALF connector with top-side contacts is used. Empty cells are not connected (NC) pins. CAM_PWR CAM_PWR CAM0_CSI_D0+ CAM0_CSI_D0- CAM0_CSI_D1+ CAM0_CSI_D1- CAM0_CSI_D2+ CAM0_CSI_D2- CAM0_RST# CAM0_CSI_D3+ CAM0_CSI_D3- CAM0_CSI_CLK+ CAM0_CSI_CLK- CAM0_I2C_CLK CAM0_I2C_DAT CAM0_ENA# MCLK CAM0_GPIO CAM1_GPIO RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 31... -
Page 36: Signal Details
5.4 Signal Details 5.4.1 Ethernet Signal Type Signal Description Level GBE_MDI[0:3]+ Analog Gigabit Ethernet Controller: Media Dependent Interface Differ- GBE_MDI[0:3]- ential Pairs 0,1,2,3. The MDI can operate in 1000, 100 and 10 Mbit/sec modes GBE_ACT# 3.3V Gigabit Ethernet Controller activity indicator, active low GBE_LINK# 3.3V Gigabit Ethernet Controller link indicator, active low... - Page 37 The RK3399-Q7 does not feature LVDS as the CPU lacks this interface. Instead the Qseven LVDS pins are used for MIDI-DSI. These signals are electrical compatible but are not defined in the Qseven standard. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 33...
- Page 38 Q7 Pin Function Alternate Function LVDS_A0_P MIPI_TX0_D0P EDP_TX0_P LVDS_A0_N MIPI_TX0_D0N EDP_TX0_N LVDS_A1_P MIPI_TX0_D1P EDP_TX1_P LVDS_A1_N MIPI_TX0_D1N EDP_TX1_N LVDS_A2_P MIPI_TX0_D2P EDP_TX2_P LVDS_A2_N MIPI_TX0_D2N EDP_TX2_N LVDS_A3_P MIPI_TX0_D3P EDP_TX3_P LVDS_A3_N MIPI_TX0_D3N EDP_TX3_N LVDS_A_CLK_P MIPI_TX0_CLKP EDP_AUX_P LVDS_A_CLK_N MIPI_TX0_CLKN EDP_AUX_N LVDS_B0_P MIPI_TX1/RX1_D0P LVDS_B0_N MIPI_TX1/RX1_D0N LVDS_B1_P MIPI_TX1/RX1_D1P LVDS_B1_N MIPI_TX1/RX1_D1N...
- Page 39 Signal Description Level UART0_TX 3.3V Serial data transmit UART0_RX 3.3V Serial data receive UART0_CTS# 3.3V Handshake signal: ready to send data UART0_RTS# 3.3V Handshake signal: ready to receive data RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 35...
- Page 40 5.4.12 Misc Signal Type Signal Description Level WDTRIG# 3.3V Watchdog trigger signal WDOUT 3.3V Watchdog event indicator SMB_CLK 3.3V Clock line of System Management Bus. Alternate function I2C GP1_I2C_CLK Bus clock line SMB_DAT 3.3V Data line of System Management Bus. Alternate function I2C GP1_I2C_DAT Bus data line SMB_ALERT#...
-
Page 41: On-Board Devices
The STM32-microcontroller can be flashed from the CPU by taking it into DFU mode (USB recovery). Pull BOOT0 low and cycle reset (GPIOs listed below). The microcontroller will appear as a new USB device in Linux. Function CPU Pin Linux GPIO # NRST GPIO1_D0 BOOT0 GPIO2_B4 RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 37... - Page 42 5.5.6 Ethernet PHY The Micrel KSZ9031RNX is connected to the CPU via RGMII and MDIO. Further connections are shown below. PHY signal Connected to Linux GPIO # RESET CPU pin GPIO3_C0 MDIO CPU pin GPIO3_B5 CPU pin GPIO3_B0 LED1 Qseven GBE_LINK1000 and GBE_LINK100 and GBE_LINK (tied together) LED2 Qseven GBE_ACT 5.5.7 Test points...
-
Page 43: Usb
The USB hub can be held in reset, if required. This disables all USB ports connected to the hub. The reset signal routing is shown below: Hub signal CPU Pin Linux GPIO # USBHUB_RESETn GPIO4_A3 RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 39... -
Page 44: Using Qseven Signals As Gpio
5.7 Using Qseven Signals as GPIO Most Qseven signals can be reused as general purpose pin. Following table shows the mapping and the possible direction between the edge connector and the SoC. Qseven Signal CPU Pin Linux Direction GPIO SUS_S5# GPIO1_A1 Output WAKE#... - Page 45 GPIO2_C7 Output SPI_MISO GPIO2_C4 Input SPI_CS1# GPIO2_D0 Output SPI_SCK GPIO2_C6 Output CAM0_RST# GPIO3_D4 Bidirectional CAM0_I2C_CLK GPIO2_B2 Bidirectional CAM0_I2C_DAT GPIO2_B1 Bidirectional CAM0_ENA# GPIO4_C5 Bidirectional CAM0_GPIO GPIO3_D1 Bidirectional CAM1_GPIO GPIO4_A4 Bidirectional RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 41...
-
Page 46: Electrical Specification
5.8 Electrical Specification 5.8.1 Power Supply 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 v1.6 Page 42... -
Page 47: Mechanical Specification
Fig. 5.1: Module dimensions (all values in mm) 5.9.2 Baseboard Dimensions The mechanical dimensions of the baseboard are conform with the form factor for Mini-ITX and it can be mounted in a standard Mini-ITX PC Case. RK3399-Q7 User Manual v1.6 © Cherry Embedded Solutions GmbH Page 43... - Page 48 6 Revision History Date Revision Changes Dec 18, 2023 v1.6 Switch to Cherry Corporate Identity Oct 25, 2021 v1.5 Add missing picture for CTRL I/O header Add pin description of CSI feature connector Apr 11, 2018 v1.4 Add heatsink spacer instructions...