theobroma systems RK3399-Q7 User Manual Download Page 28

Page: 28 / 52

cp rk3399

cortex

rk3399m0

bin arm

trusted

firmware

build

rk3399

debug

bl31

bin puma

boot

Then you are ready to compile U-Boot:

cd puma

boot

export ARCH

arm64

export CROSS_COMPILE

opt

gcc

linaro

6.3

2017.02

x86_64_aarch64

linux

gnu

bin

aarch64

linux

gnu

make puma

rk3399_defconfig

make

tools

mkimage

n rk3399

T rksd

d spl

boot

spl

bin spl

img

make u

boot

itb

The resulting bootloader consists of two files, “

spl.img

” and “

u-boot.itb

”.

4.6 Compile the Boot Script

The U-Boot boot sequence is controlled by a file called “

boot.scr

”. This file is generated from a plain-text file called

“

boot.cmd

”.

Download the repository containing the file using:

git clone https:

git

theobroma

systems

com

som

tools

git

Generate “

boot.scr

” using:

cd som

tools

make

C boot

script

boot

4.7 Compile the Linux Kernel

The kernel source code can be cloned with:

git clone https:

git

theobroma

systems

com

puma

linux

git

Compile using:

Release v0.2-3-g574c114

Page

Summary of Contents for RK3399-Q7

Page 1: ...featuring the Rockchip RK3399 application processor Hexa Core ARM Cortex A72 A53 RK3399 Q7 System on Module USER MANUAL Document revision Release v0 2 3 g574c114 Issue date Jun 02 2017 ...

Page 2: ......

Page 3: ...Board Overview 5 3 2 Power Supply 7 3 3 Control Buttons and Switches 7 3 4 CPU Fan 8 3 5 Booting from SD Card 8 3 6 USB Serial Console 9 3 7 RS 232 and RS 485 10 3 8 TTL UART 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 CAN Bus 19 RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c...

Page 4: ...nux Kernel 24 4 8 Building the root filesystem 25 4 9 Deploy on SD Card 27 4 10 Deploy on NOR flash 30 4 11 Deploy on On Board eMMC storage 31 4 12 Compiling Linux Applications 31 4 13 Serial Number 32 4 14 MAC Address 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 Specification 46 5 6 Mechanical Specifica...

Page 5: ...the next release of this manual 1 1 Device Overview The 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 These 64bit capable ARMv8 processors support both the ARM Crypographic Extension e g for wire rate AES encryption...

Page 6: ... 1 Required Tools PZ1 Pozidriv screwdriver 2 2 Mount Module and Heatsink Module and heatsink must be installed at the same time because the same mouting screws hold both the heatsink and the module in place The heatsink has the thermal pad attached on the bottom Peel off the protective foil Release v0 2 3 g574c114 Page 2 ...

Page 7: ... 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 The 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 Theobroma Systems Design und Con...

Page 8: ... Connect the power supply to the base board Press the Power button on the base board The 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 Release v0 2 3 g574c114 Page 4 ...

Page 9: ...s booting and how to configure and use I O peripherals e g serial console Ethernet 3 1 Evaluation Board Overview An overview of the available connectors and devices on the EVK is shown below RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c114 Page 5 ...

Page 10: ...12V Power Battery Buzzer PCIe 8x Display Connector Q7 Module LID SW BOOT SW NPW SW Batlow Sleep Wake Reset Power SD Card Slot SMBus CTRL I O Misc I O SPI I2C 1 wire GPIO FAN CAN JTAG I2S Fig 3 1 The base board for to RK3399 Q7 module Release v0 2 3 g574c114 Page 6 ...

Page 11: ...3 3 Control Buttons and Switches The 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 left LID is routed to a GPIO on the module simulates lid open close Normally On Normally Off as described above sets the state after pow...

Page 12: ...s 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 Software Guide On power up RK3399 Q7 module will normally try to boot from the internal flash If this fails it will attempt to boot from the SD card If this fails as well it will go into USB recovery mode The standard boot...

Page 13: ...rivers The 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 The switch UART0 UART1 cross switches UART0 and UART1 between the RS232 RS485 jack and the onboard USB serial converter Switch Position RS232 RS485 jack connected to USB serial co...

Page 14: ...on the base board Fig 3 4 RS 232 connector The 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 effect in RS 232 mode which is always full duplex 3 8 TTL UART UART0 and UART1 are also available through the pin headers P12 UART0 and P30 UART1 next to the R...

Page 15: ...he SD card that is shipped with the EVK is configures to automatically retrieve an IP via DHCP and provides SSH login on port 22 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 RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c114 Page 11 ...

Page 16: ...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 Release v0 2 3 g574c114 Page 12 ...

Page 17: ... 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 The monitor will be automatically discovered and show a desktop environment once booting has finished RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g5...

Page 18: ... 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 first apt get install ntp Feel free to change the etc ntp conf file to use more local time sources change s...

Page 19: ...et install i2c tools 3 13 1 I2C Example Using a Touch Keyboard This example uses the Atmel AT42QT2160 touch keyboard see datasheet Make sure the Linux kernel driver is enable via menuconfig 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 Software Guide RK3399 Q7...

Page 20: ...nal 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 14 GPIOs Eight GPIOs are provided on the pin header labled GPIO The location on the board is displayed below Release v0 2 3 g574c114 Page 16 ...

Page 21: ...56 GPIO1 GPIO4_D1 153 GPIO2 GPIO4_D0 152 GPIO3 GPIO4_D5 157 GPIO4 GPIO4_D2 154 GPIO5 GPIO4_C4 148 GPIO6 GPIO4_C3 147 GPIO7 GPIO4_D3 155 To calculate the Linux GPIO for CPU pins that are not listed in this table use the following formula n block_number 32 sub_block_number 8 index Where block_number index of the block number sub_block_number the alphabetical index of the block name minus 1 index the...

Page 22: ...ite out in the GPIO s direction file echo out sys class gpio gpio156 direction echo 1 sys class gpio gpio156 value 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 13 Audio input output port Additionally an expansion connector for I2S audio is availabl...

Page 23: ...D Fig 3 14 Connecting to the audio expansion connector 3 16 CAN Bus The board provides a CAN connector on the bottom row GND CAN low level CAN high level Fig 3 15 CAN header RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c114 Page 19 ...

Page 24: ...tility signals for SD and GPIO0 3V3 GPIO0 SDIOWP THRM TRIP GND THRM Fig 3 16 MISC header 3 18 RF Module An additional RF Module for wireless communication can be soldered on the bottom right of the baseboard For more info s visit https www theobroma systems com rf modules 3815 Release v0 2 3 g574c114 Page 20 ...

Page 25: ...tex M0 power management firmware Cortex M ATF ARM Trusted Firmware Cortex A U Boot bootloader Cortex A The Linux kernel Cortex A Debian user space Cortex A The next section explains how to install suitable cross compilers for both instruction sets The section Compiling Linux Applications provides guidance for compiling user space applications for the RK3399 4 2 Prerequisites You need a recent x86_...

Page 26: ...date linux tar bz2 C opt 4 2 2 Cortex A Compiler The Linaro aarch64 linux gnu toolchain is suitable for compiling all other parts of the BSP It is also suitable for compiling user space applications You can download ready to use binaries from Linaro https releases linaro org components toolchain binaries 6 3 2017 02 aarch64 linux gnu Direct link to the file https releases linaro org components too...

Page 27: ...wk libncurses5 dev Then to use the internal toolchain specify USE_INTERNAL_TOOLCHAIN 1 as part of your invocation to make make USE_INTERNAL_TOOLCHAIN 1 4 4 Compile the ATF Download the source code and compile using export CROSS_COMPILE opt gcc linaro 6 3 1 2017 02 x86_64_aarch64 linux gnu bin aarch64 linux gnu git clone https git theobroma systems com arm trusted firmware git cd arm trusted firmwa...

Page 28: ... cd The resulting bootloader consists of two files spl img and u boot itb 4 6 Compile the Boot Script The U Boot boot sequence is controlled by a file called boot scr This file is generated from a plain text file called boot cmd Download the repository containing the file using git clone https git theobroma systems com som tools git Generate boot scr using cd som tools make C boot script boot cd 4...

Page 29: ...rt targetdir opt rk3399 rootfs export distro xenial sudo mkdir p targetdir sudo debootstrap arch arm64 foreign distro targetdir Next copy the qemu arm static binary into the right place for the binfmt packages to find it and copy the resolv conf file from the host system sudo cp usr bin qemu aarch64 static targetdir usr bin sudo cp etc resolv conf targetdir etc This will provide a very basic arm64...

Page 30: ...package might be needed as well apt get update apt get install locales dialog dpkg reconfigure locales Install any additional packages inside the chroot An ssh server and sudo are recommended apt install openssh server sudo Set the root password for logging in via console or ssh passwd root login over ssh is not permitted by default set to no or permitted only with public key set to without passwo...

Page 31: ...it sudo rm targetdir etc resolv conf sudo rm targetdir usr bin qemu aarch64 static umount l xenial dev pts dev null 2 1 umount l xenial dev dev null 2 1 umount l xenial proc dev null 2 1 umount l xenial sys dev null 2 1 We now have a root filesystem which can be deployed to the SD card 4 9 Deploy on SD Card 4 9 1 Partition Setup Both U Boot and Linux will be located on the same SD card The layout ...

Page 32: ...23 heads 62 sectors track 1019 cylinders total 7774208 sectors Units sectors of 1 512 512 bytes Sector size logical physical 512 bytes 512 bytes I O size minimum optimal 512 bytes 512 bytes Disk identifier 0xdbbd45c7 Device Boot Start End Blocks Id System If there are partitions on the sdcard they can be deleted with d The required partition can be created with the command n then accepting the def...

Page 33: ...g that the rootfs is located at opt rk3399 rootfs and the sd card at dev sdX1 sudo mkdir p mnt sdcard sudo mount dev sdX1 mnt sdcard sudo cp av opt rk3399 rootfs mnt sdcard Copy kernel image device tree and boot script into the boot directory sudo cp r som tools boot script boot boot scr puma_rk3399 mnt sdcard boot sudo cp rockchip_linux arch arm64 boot dts rockchip rk3399 puma dtb mnt sdcard boot...

Page 34: ...ot rk3399 puma dtb bootm 0x40008000 0x40000000 setenv bootcmd run boot_sd saveenv To reset the U Boot settings to default execute env default f a saveenv 4 10 Deploy on NOR flash To have a reliable boot sequence even if eMMC and or SD card fail U Boot can be written in to the onboard NOR flash The file spl img for this has to be built differently than before Compile using cd puma u boot export CRO...

Page 35: ...p is copying the bootloader to the eMMC dd if spl img of dev mmcblk1 bs 1k seek 32 dd if u boot itb of dev mmcblk1 bs 1k seek 256 Shut down the board poweroff command and remove the SD card Make sure the boot selector switch is set to Normal Boot The next boot will run U Boot off the internal eMMC storage 4 12 Compiling Linux Applications The easiest option is to compile your applications directly...

Page 36: ...from the serial number The properties of this default MAC address are It is a Locally Administered Address The U L bit of the MAC address is set to 1 It is not guaranteed to be globally unique The address is fixed for each RK3399 Q7 module It stays constant across reboots as it is deterministically derived from the serial number To set your own Universally Administered Address you overwrite the U ...

Page 37: ...9 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 RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c114 Page 33 ...

Page 38: ...re Digital I O 0 1 1 System Management Bus 0 1 1 I2 C Bus 1 4 4 SPI Bus 0 1 1 CAN Bus 0 1 1 Watchdog Trigger 1 1 1 Power Button 1 1 1 Power Good 1 1 1 Reset Button 1 1 1 LID Button 0 1 1 Sleep Button 0 1 1 Suspend to RAM S3 mode 0 1 1 Wake 0 1 1 Battery low alarm 0 1 1 Thermal control 0 1 1 FAN control 0 1 1 Note The RK3399 Q7 module is available in different variants This document describes the m...

Page 39: ..._S5 17 WAKE 18 SUS_S3 19 GP0 20 PWRBTN 21 SLP_BTN 22 LID_BTN 23 GND 24 GND 25 GND 26 PWGIN 27 BATLOW 28 RSTBTN 29 30 31 32 33 34 GND 35 36 37 38 39 GND 40 GND 41 BIOS_DISABLE BOOT_ALT 42 SDIO_CLK 43 SDIO_CD 44 SDIO_LED 45 SDIO_CMD 46 SDIO_WP 47 SDIO_PWR 48 SDIO_DAT1 49 SDIO_DAT0 50 SDIO_DAT3 51 SDIO_DAT2 52 53 54 55 56 USB_OTG_PEN 57 GND 58 GND 59 I2S_WS 60 SMB_CLK GP1_I2C_CLK 61 I2S_RST 62 SMB_DA...

Page 40: ...P1 94 USB_P0 95 USB_P1 96 USB_P0 97 GND 98 GND 99 LVDS_A0 100 LVDS_B0 101 LVDS_A0 102 LVDS_B0 103 LVDS_A1 104 LVDS_B1 105 LVDS_A1 106 LVDS_B1 107 LVDS_A2 108 LVDS_B2 109 LVDS_A2 110 LVDS_B2 111 LVDS_PPEN 112 LVDS_BLEN 113 LVDS_A3 114 LVDS_B3 115 LVDS_A3 116 LVDS_B3 117 GND 118 GND 119 LVDS_A_CLK 120 LVDS_B_CLK 121 LVDS_A_CLK 122 LVDS_B_CLK 123 LVDS_BLT_CTRL GP_PWM_OUT0 124 GP_1 Wire_Bus 125 GP2_I2...

Page 41: ...163 PCIE3_TX 164 PCIE3_RX 165 GND 166 GND 167 PCIE2_TX 168 PCIE2_RX 169 PCIE2_TX 170 PCIE2_RX 171 UART0_TX 172 UART0_RTS 173 PCIE1_TX 174 PCIE1_RX 175 PCIE1_TX 176 PCIE1_RX 177 UART0_RX 178 UART0_CTS 179 PCIE0_TX 180 PCIE0_RX 181 PCIE0_TX 182 PCIE0_RX 183 GND 184 GND 185 GPIO0 186 GPIO1 187 GPIO2 188 GPIO3 189 GPIO4 190 GPIO5 191 GPIO6 192 GPIO7 193 VCC_BAT 194 SPKR GP_PWM_OUT2 195 FAN_TACHOIN GP_...

Page 42: ...ion GBE_MDI 0 3 GBE_MDI 0 3 I O Analog Gigabit Ethernet Controller Media Dependent Interface Differential Pairs 0 1 2 3 The MDI can operate in 1000 100 and 10 Mbit sec modes GBE_ACT OC 3 3V Gigabit Ethernet Controller activity indicator active low GBE_LINK OC 3 3V Gigabit Ethernet Controller link indicator active low GBE_LINK100 OC 3 3V Internally connected to GBE_LINK GBE_LINK1000 OC 3 3V Interna...

Page 43: ...nd 3 USB_ID I 3 3V Configures the mode of the USB Port 1 If the signal is active high the Port will be configured as USB Client USB_VBUS I 5 0V USB VBUS pin 5V tolerant USB_OTG_PEN O 3 3V USB Power enable for OTG port USB 1 5 3 3 SDIO Signal Type Signal Level Description SDIO_CD I 3 3V SDIO Card Detect This signal indicates when a SDIO MMC card is present SDIO_CLK O 3 3V SDIO Clock SDIO_CMD I O 3 ...

Page 44: ... Alternate function I2C Bus clock line SMB_DAT GP1_I2C_DAT I O 3 3V Data line of System Management Bus Alternate function I2C Bus data line LVDS_BLC_DAT O 3 3V I2C bus clock line connected to RK3399 Kerkey and baseboard EEP ROM LVDS_BLC_CLK I O 3 3V I2C bus data line connected to RK3399 Kerkey and baseboard EEP ROM 5 3 5 I2S Signal Type Signal Level Description I2S_RST O 3 3V I2S Codec Reset I2S_W...

Page 45: ...e inputs outputs 0 to 7 5 3 8 CAN Signal Type Signal Level Description CAN0_TX O 3 3V CAN Controller Area Network TX output for CAN Bus channel 0 CAN0_RX I 3 3V CAN Controller Area Network RX input for CAN Bus channel 0 5 3 9 SPI Signal Type Signal Level Description SPI_MOSI O 3 3V Master serial output Slave serial input signal SPI_MISO I 3 3V Master serial input Slave serial output signal SPI_SCK...

Page 46: ...BIOS_DISABLE BOOT_ALT I 3 3V Disables the onboard bootloader and uses the one the SD card instead If no bootloader is available on the SD card it falls back to USB recovery mode GP_1 Wire_Bus I O 3 3V General Purpose 1 Wire bus interface THRM I 3 3V Thermal Alarm active low signal generated by the external hardware to indicate an over temperature situation This signal can be used to initiate therm...

Page 47: ...ake from a sleep state LID_BTN I 3 3V LID button Low active signal to detect a LID switch to transition into sleep or wake from a sleep state 5 3 13 Power Signal Nominal Input Description VCC 5V Main supply for the module VCC_RTC 3V Backup supply for the RTC If not used it can be left unconnected 5 4 On board Devices 5 4 1 Power Manager The Rockchip RK808 is connected to the CPU via RSB and an int...

Page 48: ... Linux Feature CPU Connection Emulated IC Qseven Pins RTC I2C ISL1208 none Temperature sensor and fan controller I2C AMC6821 FAN_TACHOIN FAN_PWMOUT CAN USB UCAN CAN0_TX CAN0_RX 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 L...

Page 49: ...CPU Pin Linux GPIO USBHUB_RESETn GPIO4_A3 128 5 4 7 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 112 MDIO CPU pin GPIO3_B5 107 MDC CPU pin GPIO3_B0 102 LED1 Qseven GBE_LINK1000 and GBE_LINK100 and GBE_LINK tied together LED2 Qseven GBE_ACT 5 4 8 Test points Test point Conn...

Page 50: ...he power supply requirements are listed in the table below and are identical to the Qseven specification Rail Description Nominal voltage Tolerance VCC Main power supply 5V 4 75 5 25V VCC_RTC Backup battery 3V 2 4 3 3V Release v0 2 3 g574c114 Page 46 ...

Page 51: ...ig 5 1 Module dimensions all values in mm 5 6 2 Baseboard Dimensions The mechanical dimensions of the baseboard are conform with the form factor for Micro ATX and it can be mounted in a standard Micro ATX PC Case RK3399 Q7 User Manual Theobroma Systems Design und Consulting GmbH Release v0 2 3 g574c114 Page 47 ...

Page 52: ...CHAPTER SIX REVISION HISTORY Date Revision Changes Jun 2 2017 v0 2 Preliminary public release May 30 2017 v0 1 First internal release Release v0 2 3 g574c114 Page 48 ...

Search results

Summary of Contents for RK3399-Q7

Reviews:

Brands by name

Popular brands

theobroma systems RK3399-Q7, User Manual

Search results

Summary of Contents for RK3399-Q7

Reviews:

Brands by name

Popular brands