Boardcon EM3399 User manual

EM3399 Android7.1 User Manual
V1.3
www.boardcon.com
Boardcon Embedded Design

1
Customize the embedded system based on YourIdea
1. Introduction
1.1. About this Manual
This manual is intended to provide the user with an overview of the board and benefits, complete
features specifications, and set up procedures. It contains important safety information as well.
1.2. Feedback and Update to this Manual
To help our customers make the most of our products, we are continually making additional and
updated resources available on the Boardcon website (www.boardcon.com , www.armdesigner.com).
These include manuals, application notes, programming examples, and updated software and
hardware. Check in periodically to see what’s new!
When we are prioritizing work on these updated resources, feedback from customers is the number
one influence, If you have questions, comments, or concerns about your product or project, please
no hesitate to contact us at [e-mail].
1.3. Limited Warranty
Boardcon warrants this product to be free of defects in material and workmanship for a period of one
year from date of buy. During this warranty period Boardcon will repair or replace the defective unit
in accordance with the following process:
A copy of the original invoice must be included when returning the defective unit to Boardcon. This
limited warranty does not cover damages resulting from lighting or other power surges, misuse,
abuse, abnormal conditions of operation, or attempts to alter or modify the function of the product.
This warranty is limited to the repair or replacement of the defective unit. In no event shall Boardcon
be liable or responsible for any loss or damages, including but not limited to any lost profits, incidental
or consequential damages, loss of business, or anticipatory profits arising from the use or inability
to use this product.
Repairs make after the expiration of the warranty period are subject to a repair charge and the cost
of return shipping. Please contact Boardcon to arrange for any repair service and to obtain repair
charge information.

2
Customize the embedded system based on YourIdea
Revision History
Ver
Description
Author
Date
V1.0
Initial version android7.1.2 industry
Qin Xueqin
2019-03-06
V1.1
Support 10.1 inch MIPI LCD
Qin Xueqin
2019-09-03
V1.2
Description update
Zhou Lijun
2019-10-17
V1.3
Compile update
Zhou Lijun
2019-11-25

3
Customize the embedded system based on YourIdea
Content
1 EM3399 Introduction ......................................................................................................................4
2 Compiler Environment....................................................................................................................5
2.1 Vmware7.0+ubuntu14.04 .....................................................................................................5
2.2 Install JDK ............................................................................................................................5
2.3 Install Tools...........................................................................................................................6
3 Compile Source..............................................................................................................................8
3.1 Compile Kernel.....................................................................................................................8
3.2 Compile Android...................................................................................................................8
4 Images Operation...........................................................................................................................9
4.1 Pack Image ..........................................................................................................................9
4.2 Unzip Firmware ..................................................................................................................10
5 Install Serial Terminal Tool............................................................................................................12
6 Burn Images .................................................................................................................................13
6.1 Install Driver .......................................................................................................................13
6.2 Upgrade Uniform Firmware ................................................................................................15
7 Android Application.......................................................................................................................18
7.1 Serial Terminal....................................................................................................................18
7.2 ADB ....................................................................................................................................19
7.3 HDMI Display .....................................................................................................................19
7.4 SD Card .............................................................................................................................19
7.5 USB Host ...........................................................................................................................20
7.6 Ethernet..............................................................................................................................21
7.7 WiFi ....................................................................................................................................22
7.8 Bluetooth ............................................................................................................................23
7.9 4G Network ........................................................................................................................23
7.10 GPS..................................................................................................................................25
7.11 Camera.............................................................................................................................26
7.12 HDMI IN ...........................................................................................................................27

4
Customize the embedded system based on Your Idea
1 EM3399 Introduction
Feature
Specifications
CPU
· Rockchip RK3399. Big.Little architecture: Dual Cortex-A72 + Quad Cortex-A53,
64-bit CPU. Frequency is over 1.8GHz (Big cluster)
·28nm HKMG process
·1MB unified L2 Cache for Big cluster, 512KB unified L2 Cache for Little cluster
GPU
· Mali-T864 GPU, OpenGL ES1.1/2.0/3.0/3.1, OpenVG1.1, OpenCL, DX11
· Supports AFBC (ARM Frame Buffer Compression)
Memory
4GB
Flash
8GB eMMC Flash
Power
DC 12V/3A
USB
2x USB2.0 Host, 1x USB3.0 Host, 1x USB Type-C
UART
1x 3pin connector. For debug.
LCD
1x eDP LCD via 40-pin header interface, 1x 2-CH MIPI
Ethernet
1000M High performance Ethernet (RTL8211E), RJ45 interface
HDMI IN
Adopt Toshiba TC358749XBG bridge device
HDMI OUT
HDMI 1.4 /2.0
MIPI Camera
2-CH MIPI RX, Support 3-D video capture
Audio codec
Adopt ALC5651 Audio chip, 3.5mm Audio I / O interface
RTC
Real Time Clock, powered by external lithium battery
SD card
1x T-Flash card slot
Power in Headphone
HDMI_in HDMI_out
Type_C Dual
USB Host Ethernet
WiFi&BT
WiFi antenna
PCIE X4
MIPI_LCD
eDP
Camera
MIPI_RX
USB3.0 Host
DebugControl Fun
Reset
Power
Recover
PCIE(SSD/3G/4G)
optional
Micro SD
RTC
SIM

5
Customize the embedded system based on Your Idea
SIM card
1x SIM card slot
Buttons
3x User Buttons, for Recover, Power, Reset
PCI-E x4
Can be used to connect adapter, such as USB, Network card, Disk array, etc.
WIFI&BT
AP6356S, Module. 2.4/5G WiFi, Bluetooth 4.1
3G/4G/ SSD
PCI-E connector
GPIO
5 groups of GPIO (GPIO0~GPIO4), total 122 GPIOs
Dimension
100mm x 145mm
2 Compiler Environment
2.1 Vmware7.0+ubuntu14.04
Install Vmware7.0 in windows OS, and then install ubuntu14.04 in VMware to compile. Please visit the
official website http://www.ubuntu.com/ to download and install ubuntu operating system.
Note: Android7.1 should be complied on ubuntu 64bit OS, Ubuntu 14.04 is recommended.
2.2 Install JDK
JDK: openjdk-8-jdk
PC OS: ubuntu system
Network: online
Permission: root
# sudo apt-get update
# sudo apt-get install openjdk-8-jdk
For example, the installation path is /usr/lib/jvm/java-8-openjdk-amd64.
Configure the environment variable at the terminal by executing commands
# export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
# export PATH=$JAVA_HOME/bin:$PATH
# export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
Execute the command to check if the jdk has been installed successfully and view the revised
version
# java -version
openjdk version "1.8.0_121"
OpenJDK Runtime Environment (build 1.8.0_121-8u121-b13-0ubuntu1.16.04.2-b13)
OpenJDK 64-Bit Server VM (build 25.121-b13, mixed mode)

6
Customize the embedded system based on Your Idea
2.3 Install Tools
Root user execute the commands to install necessary tools.
# sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl
# sudo apt-get install zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386
# sudo apt-get install lib32ncurses5-dev x11proto-core-dev libx11-dev

7
Customize the embedded system based on Your Idea
# sudo apt-get install lib32z-dev ccache libgl1-mesa-dev libxml2-utils
# sudo apt-get install xsltproc unzip

8
Customize the embedded system based on Your Idea
3 Compile Source
Unzip the source.
# tar zxvf em3399-android7.1-industry.tar.gz
3.1 Compile Kernel
# cd em3399-android7.1-industry/kernel/
# make ARCH=arm64 boardcon_defconfig -j8
# make ARCH=arm64 em3399-boardcon.img -j12
kernel.img and resource.img are generated in current directory.
3.2 Compile Android
# cd em3399-android7.1-industry /
# source build/envsetup.sh
# lunch em3399-userdebug
# make -j12
# ./mkimages.sh
Generated image file
# cd rockdev/Image-em3399
# ls
Images are generated in current directory.

9
Customize the embedded system based on Your Idea
4 Images Operation
4.1 Pack Image
Step 1, unzip AndroidTool.rar in windows.
Step 2, copy all the files in the Android root directory rockdev/Image-em3399 to the development
tools rockdev/Image directory.
Step 3, enter the directory AndroidTool/rockdev/Image, and then double-click to run
mkupdate.bat.

10
Customize the embedded system based on Your Idea
Step 4, update.img will be generated in rockdev directory.
Note: If an error occurs, it may be in the script is not the same bootloader version, follow the prompts
to modify the file mkupdate.bat and package-file the same version of the current directory.
4.2 Unzip Firmware
Step 1, enter the directory AndroidTool \rockdev in CMD, unzip update.img.
Enter the following command
RKImageMaker.exe -unpack ./update.img ./
Then unzip the file to get the files boot.bin and firmware.img.

11
Customize the embedded system based on Your Idea
Step 2, unzip firmware.img.
Execute the command
AFPTool.exe -unpack firmware.img ./
The unzip files will be generated in the directory AndroidTool\rockdev\Image.

12
Customize the embedded system based on Your Idea
5 Install Serial Terminal Tool
The serial terminal SecureCRT is used for debugging. It can be used directly after decompression.
Open SecureCRT.exe after copy to PC (path: tools\windows\SecureCRT.exe), then click the icon
Quick Connect to config.
Set the parameters as follow:
Protocol: Serial
Port: To be specified by user PC
Baud rate: 1500000
Please check XON/XOFF but not RTS/CTS
Check Save session

13
Customize the embedded system based on Your Idea
After all, click connect
Illusion1: If open more than one serial terminal tools, and they use the same serial port, there will
be reported the port is busy.
Solution: Turn off the serial tool that unnecessary.
6 Burn Images
6.1 Install Driver
Step 1, Install CP2102 driver.
Plug the USB-to-UART cable CP2102 to the PC, unzip CP2102WIN7.rar on Windows, then click
preInstaller.exe to install

14
Customize the embedded system based on Your Idea
Now the device will be listed under Device Manager -> PORTS with unique serial port assigned
Step 2, Install Rockchip Driver Assistant（ Path: Release_DriverAssitant/DriverInstall.exe）

15
Customize the embedded system based on Your Idea
Step 3, After the installation is complete, connect the board and PC with USB Type-C cable, then
power on, in Computer Management can see the following information:
6.2 Upgrade Uniform Firmware
Step 1, unzip AndroidTool_Release_v2.63 on Windows.
Step 2, open AndroidTool.exe (Path: AndroidTool\AndroidTool_Release_v2.63\AndroidTool.exe)
Step 3, connect PC and development board with USB Type-C cable, keep pressing the Recover Key
and power on, until the windows PC shows Found one LOADER Device.
3

16
Customize the embedded system based on Your Idea
Step 4, click Upgrade Firmware -> Firmware, select update.img. Click Upgrade to flash.

17
Customize the embedded system based on Your Idea
Download completed.
If necessary, user can choose to update the firmware separating.
Step 1, Click the column on the right side for the path of the file want to flash.
Step 2, Select the checkbox on the left.
Step 3, Click “run” to flash the image.
1
23

18
Customize the embedded system based on Your Idea
7 Android Application
7.1 Serial Terminal
Connect the board and PC with USB Serial cable, then power on, the terminal will output startup
information.

19
Customize the embedded system based on Your Idea
7.2 ADB
Execute the follow commands to turn off verity of system partition before enable ADB.
# adb root
# adb disable-verity
# adb reboot (reboot the board)
# adb root (after boot system)
# adb remount
Now you can use adb to push file to the board.
7.3 HDMI Display
Connect HDMI-OUT and monitor with a HDMI cable, then start up the board.
7.4 SD Card
EM3399 supports SD Hot-plug.