theobroma systems RK3399-Q7 User manual

featuring the Rockchip RK3399 application processor
Hexa-Core ARM Cortex-A72/A53
RK3399-Q7 System-on-Module
USER MANUAL
Document revision:Releasev0.2-3-g574c114
Issue date: Jun 02,2017

CONTENTS
1 Introduction 1
1.1 Device Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2 First Steps 2
2.1 Required Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.2 Mount Module and Heatsink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.3 Mount the Fan (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.4 Insert SD Card & Power Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Using the EVK 5
3.1 Evaluation Board Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 PowerSupply ...................................................... 7
3.3 Control Buttons and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.4 CPUFan......................................................... 8
3.5 Booting from SD Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.6 USB Serial Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.7 RS-232 and RS-485 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.8 TTLUART........................................................ 10
3.9 Ethernet ......................................................... 11
3.10 USB Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.11 HDMI .......................................................... 13
3.12 RTC............................................................ 14
3.13 SPI, I2C and 1-Wire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.14 GPIOs .......................................................... 16
3.15 Audio........................................................... 18
3.16 CANBus......................................................... 19
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Pagei

3.17 MISC Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.18 RF-Module........................................................ 20
4 Soware Guide 21
4.1 Architecture Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.2 Prerequisites....................................................... 21
4.3 Compile the Cortex-M0 power management rmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.4 Compile the ATF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.5 Compile U-Boot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.6 Compile the Boot Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.7 Compile the Linux Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.8 Building the root lesystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.9 Deploy on SD Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.10 Deploy on NOR-ash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.11 Deploy on On-Board eMMC storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.12 Compiling Linux Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.13 Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.14 MACAddress...................................................... 32
5 Hardware Guide 33
5.1 Qseven Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.2 Q7 Connector Pinout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.3 Signal Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.4 On-board Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.5 Electrical Specication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.6 Mechanical Specication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6 Revision History 48
Releasev0.2-3-g574c114
Pageii

CHAPTER
ONE
INTRODUCTION
Congratulations for acquiring our new agship product, combining best-in-class performance with a rich set of peripherals.
Note: e latest version of this manual and related resources can always be found on our website at the following address:
https://www.theobroma-systems.com/rk3399-q7/
is is a PRELIMINARY VERSION of the RK3399-Q7 user manual. e hardware description is complete. e soware
chapter will be nished in the next release of this manual.
1.1 Device Overview
e RK3399 is a low power, high performance processor for computing, personal mobile internet devices and other smart
device applications. Based on a big.LITTLE architecture, it integrates a dual-core Cortex-A72 and a quad-core Cortex-A53.
ese 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
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page1

CHAPTER
TWO
FIRST STEPS
is chapter provides instructions for getting the RK3399-Q7 EVK running aer opening the box.
2.1 Required Tools
• PZ1 (Pozidriv) screwdriver
2.2 Mount Module andHeatsink
Module and heatsink must be installed at the same time because the same mouting screws hold both the heatsink and the
module in place.
e heatsink has the thermal pad attached on the bottom. Peel o the protective foil.
Releasev0.2-3-g574c114
Page2

Fig. 2.1: ermal pad protective foil
Insert the RK3399-Q7 module at a 45-degree angle into the connector in the base board. Once fully inserted, push it down
until it rests on the standos.
Place the heatsink on the module and screw it down very gently using four screws of 10mm length.
Fig. 2.2: Screws used for mounting heatsink and RK3399-Q7 module.
2.3 Mount the Fan (optional)
Note: e fan is only necessary in exceptionally high ambient temperatures. Under normal conditions, the RK3399-Q7
operates passively cooled.
Place the fan on the heatsink and screw it down using four 19 mm long screws.
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page3

Fig. 2.3: Screws used for mounting the fan
2.4Insert SD Card & Power Up
Insert the enclosed SD card into the slot on the base board. e slot is marked with the SD logo.
Connect the power supply to the base board.
Press the “Power” button on the base board. e module will boot up. You will see the boot progress and get a login prompt
on the RS-232 interface and on an HDMI monitor (if connected).
For further details, see the sections 3.5 Booting from SD Card,3.2 Power Supply and 3.1 Evaluation Board Overview.
Releasev0.2-3-g574c114
Page4

CHAPTER
THREE
USING THE EVK
is chapter provides instructions for using the EVK, such as booting and how to congure and use I/O peripherals (e.g.
serial console, Ethernet).
3.1 Evaluation BoardOverview
An overview of the available connectors and devices on the EVK is shown below.
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page5

RS 232
HDMI
USB OTG
USB UART
USB 2.0
2x USB 3.0
Ethernet
Audio
+12V Power
Battery
Buzzer
PCIe 8x
Display Connector
Q7 Module
LID SW BOOT SW
NPW SW
Batlow Sleep
Wake
Reset Power
SD-Card
Slot
SMBusCTRL I/O
Misc I/O
SPI+I2C+1-wire
GPIO
FAN
CAN
JTAG
I2S
Fig. 3.1: e base board for to RK3399 Q7 module.
Releasev0.2-3-g574c114
Page6

3.2 Power Supply
e 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 3.1 Evaluation Board Overview).
Depending on the setting of “ Normally On / Normally Off ” switch the board will boot as soon as it receives power.
3.3 Control Buttons andSwitches
e control buttons provide the following functionality:
• “ Power ” toggles the module power supply
• “ Reset ” triggers a module reset
• “ Batlow ”, “ Sleep ” and “ Wake ” are routed to GPIOs on the Q7 module
Several slide switches are located on the lower le:
• “ LID ” is routed to a GPIO on the module, simulates lid open/close.
• “ Normally On / Normally Off ”, as described above, sets the state aer power loss.
• “ BIOS Disable / Normal Boot ” forces SD card boot or the normal boot order, respectively.
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page7

3.4 CPU Fan
Operation in high environmental temperatures may require a CPU fan. e fan connector is located next to the bottom
right corner of the Q7 expansion area (see board overview).
.
FAN_TACHON
+12V
GND
FAN_PWMOUT
Fig. 3.3: Fan connector
Note: e fan is only necessary in high ambient temperatures. Under normal conditions, the RK3399 Q7 operates passively
cooled.
3.5 Booting from SD Card
For information on preparing an SD card for the RK3399 Q7 board, have a look at the :ref: Soware Guide. On power up,
RK3399-Q7 module will normally try to boot from the internal ash. If this fails, it will attempt to boot from the SD card.
If this fails as well, it will go into USB recovery mode. e standard boot order of the RK3399-Q7 is
1. SPI
2. eMMC
3. SD-Card
4. USB Recovery
Releasev0.2-3-g574c114
Page8

e board can be forced to boot from the SD card by setting the “ BIOS Disable / Normal Boot ” slider to the “ BIOS
Disable ” position. is will force the RK3399-Q7 module to boot from the SD card.
3.6 USBSerialConsole
e 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 ”:
e 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/soware/
usb-to-uart-bridge-vcp-drivers
e Q7 modules 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.
e switch “ UART0 / UART1 ” cross-switches UART0 and UART1 between the “ RS232 / RS485 ” jack and the onboard
USB-serial converter:
Switch Position RS232 / RS485 jackconnected to:USB-serialconverterconnected to:
UART0 UART0 (interactive console) UART1
UART1 UART1 UART0 (interactive console)
For interactive login through the USB-serial converter, make sure the switch is on the “ UART1 ” position
Picocom can be used to connect via the serial line (assuming the USB-serial converter is USB0):
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page9

picocom -b115200 /dev/ttyUSB0
Aer system bootup, the login console appears on the terminal:
rk3399-q7 login:
You can log in as root with password root or as user user with password user .
3.7 RS-232 andRS-485
To connect via RS-232 or RS-485, connect to the “ RS232 / RS485 ” jack on the base board.
Fig. 3.4: RS-232 connector
e switch labeled “ RS-232 / RS-485 ” selects between RS-232 and RS-485 mode on the jack.
In RS-485 mode, the switch labeled “ Full Duplex / Half Duplex ” selects full- or half-duplex mode, respectively. It
has no eect in RS-232 mode, which is always full-duplex.
3.8TTL UART
UART0 and UART1 are also available through the pin headers “ P12 UART0 ” and “ P30 UART1 ” next to the “ RS232 /
RS485 ” jack. e signal level is 3.3V.
Releasev0.2-3-g574c114
Page10

3.9 Ethernet
e RK3399-Q7 has built-in Gigabit Ethernet routed to a standard jack on the evaluation board.
Fig. 3.5: Ethernet jack
e SD card that is shipped with the EVK is congures to automatically retrieve an IP via DHCP and provides SSH login
on port 22.
3.10USBInterfaces
e RK3399-Q7 provides four USB ports:
• 1x USB 3.0 OTG
• 2x USB 3.0 Host
• 1x USB 2.0 Host
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page11

Fig. 3.6: USB 3.0 OTG port (dual-role port: can be used as a host or device interface)
Fig. 3.7: USB 3.0 host ports
Releasev0.2-3-g574c114
Page12

Fig. 3.8: USB 2.0 host port
3.10.1 Connecting anExternal USB Drive
To connect a USB drive, plug it into one of the USB ports. e system should recognize the drive immediately. Check the
kernel log to nd the device name:
journalctl -k-10
You will be able to mount its partitions (assuming mapping to /dev/sdb1 ):
mkdir /mnt/usb1
mount /dev/sdb1 /mnt/usb1
ls /mnt/usb1
3.11 HDMI
Before powering the board, connect a monitor to the HDMI port. e monitor will be automatically discovered and show
a desktop environment once booting has nished.
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page13

Fig. 3.9: HDMI port
3.12 RTC
the RK3399-Q7 contain a real-time clock (RTC) on-module. e RTC is read by the kernel on bootup and used to set the
system clock.
To check the RTC value, use hwclock :
hwclock
Thu 30 Apr 2015 03:51:20 PM CEST -0.826662 seconds
e RTC will be set automatically to the system clock on shutdown, so you can set the system clock using the date command
and reboot to update the RTC:
date --set 2015-04-20
date --set 03:51:30
You can also update the RTC immediately, again with hwclock :
hwclock -v
You can set up an NTP client so the time will always be updated from the Internet. Install the client rst:
apt-get install ntp
Feel free to change the /etc/ntp.conf le to use more local time sources (change servers from pool.ntp.org to use a
server from your country, such as at.pool.ntp.org ).
Releasev0.2-3-g574c114
Page14

3.13 SPI,I2C and1-Wire
e I2C (i2c-0), 1-wire-bus and SPI interfaces are both available on the connector labeled SPI+I2C+1-Wire .
.
3V3
SPIMOSI SPICLK SPICS0#
GND
SPICS1#
SPIMOSI
1-Wire
I2C_CLK
I2C_DAT
Fig. 3.10: I2C and SPI header
For I2C, there is the package i2c-tools available in Debian:
apt-get install i2c-tools
3.13.1 I2C Example- Using aTouch Keyboard
is example uses the Atmel AT42QT2160 touch keyboard (see datasheet).
Make sure the Linux kernel driver is enable via menucong:
make menuconfig
Navigate to Device Drivers -> Input device support -> Keyboards and check the ATMEL AT42QT2160 Touch Sensor Chip.
You must recompile the kernel and deploy it to the SD card (see Soware Guide).
RK3399-Q7 User Manual
©TheobromaSystems Design und Consulting GmbHReleasev0.2-3-g574c114 Page15

3.13.2 SMBUS
e 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.
.
3V3
SMB_CLK SMB_DAT SMB_ALERT#
GND
GND
GND
GND
RSTBTN#
GND
Fig. 3.11: SMBUS header
3.14GPIOs
Eight GPIOs are provided on the pin header labled GPIO .
e location on the board is displayed below:
Releasev0.2-3-g574c114
Page16