1、下载烧录工具：

• 请务必先安装驱动，烧录工具链接含有驱动DriverAssitant压缩包，解压后点击DriverInstall.exe安装驱动

2、开始烧录：

• 将数据线一端与主板OTG连接，另一端连接电脑。注意烧录前，需关闭电源，开电源时按住boot_key按键进行烧入。

• 打开压缩包中开发工具 » 升级固件 » 点击固件并选择好固件 » 点升级开始烧录

• 烧录过程中的状态，会有进度显示

• 更换系统平台(例如安卓切换到Linux)时，可能出现无法烧录的情况，此时打开开发工具 » 高级功能 » 点击进入Maskrom切换烧录模式后烧录系统

3、完成烧录：

• 烧录过程不需要任何操作，烧录成功后右框会显示设备自动重启，烧录完成。

1、通过串口进入系统后台，需要利用板子的Debug接口，接口位置和定义如图：

* 接口只需要用到3个引脚，TX、RX、GND

2、需要用到串口小板工具

• A部分需要接入TX、RX、GND
• B部分连接电脑USB口

3、硬件部分连接效果图

4、在电脑的设备管理器→端口 中看有没有串口信息

5、打开Xshell新建一个会话，在连接下选择协议为SERIAL,操作如图：

6、点击串口，端口号为设备管理器看到的串口号，波特率为：1500000

7、最后点击连接，串口进入后台

1. 将网线连接到主板LAN1接口上

2. 查看网卡IP地址

a）点击设置 ⇒ 点击更多

b）点击Ethernet

c）查看IP地址，一般系统默认动态获取IP地址

3. 连接上网络后，打开浏览器浏览网页查看是否连接上网络

4.设置以太网静态IP地址

* 点击 Ethernet IP mode 选择 static

* 进行设置

1.打开设置，点击WLAN

2.点击开启

3.浏览可用的WIFI路由，然后点击，输入密码

４.连接成功右上角状态栏图标变为这样

１.测试４Ｇ网络

a）给板子断电，接上4G模块与天线，插入5G电话卡

b）打开设置，点击更多

c）点击4G路由设置

d）开启路由

状态栏右上角显示该图标，则为开启成功

2.测试5G网络

a）给板子断电，插入5G电话卡，接上5G模块与一根天线，天线接在模线帽接口

b）打开设置，点击更多

c)点击4G路由设置

d）开启路由

状态栏右上角显示该图标，则为开启成功

1. 串口定义参考：

• 主板接口定义

2. 串口设备节点系统对应表：

3. CuTecom 测试串口，以/dev/ttysWK2回环测试为例

• 参考步骤1~2短接/dev/ttysWK2的 TX & RX （2~3 pin);
• 双击桌面CuteCom图标，打开APP，Device选择测试端口对应的设备节点(见步骤2);
• 点击Settings，设置串口参数，如下图所示:

• 设置好以后点击Open 打开串口,在input 文本输入框中输入字符，按回车发送数据：

4. 命令行方式测试串口，同样以J_RS232 RX3\TX3回环测试为例

打开终端输入如下指令接收数据：

com_recv /dev/ttysWK2 115200

打开另一个终端发送数据：

com_send /dev/ttysWK2 115200

测试结果如下：

1. 查看网卡IP地址，系统默认都为动态获取IP地址

#ifconfig -a 

2. 设置网卡静态IP地址

• 方法1 – 使用图形界面工具设置

双击桌面图标Advanced Network Configuration

• 方法2 – 修改配置文件的方式:

vim /etc/network/interfaces

• 修改完成后输入重启生效。

1. 点击右下角网络图标，浏览可用WIFI路由：

• 输入WIFI密码，点击connect

2. 方法2 – 命令行连接wifi

nmcli d wifi connect "SSID" password "PASSWROD"

1. 系统已带自动拨号，打开终端，输入命令4g 即可自动拨号：

root@rk3399:~# 4g

2. 拨号完成后，查看IP地址：

3. 打开浏览器，浏览任意网站。

4. 5G测试方法与4G类似，输入命令5g即可自动拨号:

root@rk3399:~# 5g

1. IO 控制节点都在/sys/class/io_control/

2. IO 对应表如下：

3. IO控制方法：

• 输出低电平：

echo 0 >/sys/class/io_control/gpio_op0

*输出高电平：

echo 1 >/sys/class/io_control/gpio_op0

*查看输入电平：

cat /sys/class/io_control/gpio_ip0

• 将喇叭连接板子上的 SPK 端口

1. 方法① – 使用系统自带SMPayer播放器，以及音频测试文件，可以做简单音频功能测试

2. 方法② – 使用命令方式播放:

aplay  /nodka_test/LR_audio.wav  -D  hw:0,0

• 录音测试

arecord -d 5 -f cd -r 44100 -c 2 -t wav test.wav  
aplay test.wav

1. U盘自动挂载/media/disk

root@rk3399:~# df -h
文件系统        容量  已用  可用 已用% 挂载点
/dev/root        15G  3.6G   10G   27% /
devtmpfs        980M     0  980M    0% /dev
tmpfs           981M     0  981M    0% /dev/shm
tmpfs           981M  8.8M  972M    1% /run
tmpfs           5.0M  4.0K  5.0M    1% /run/lock
tmpfs           981M     0  981M    0% /sys/fs/cgroup
tmpfs           197M   16K  197M    1% /run/user/0
/dev/sda1        57G  2.7G   54G    5% /media/disk

* SDcard 自动挂载：

root@rk3399:~# df -h
文件系统        容量  已用  可用 已用% 挂载点
/dev/root        15G  3.6G   10G   27% /
devtmpfs        980M     0  980M    0% /dev
tmpfs           981M     0  981M    0% /dev/shm
tmpfs           981M  8.8M  972M    1% /run
tmpfs           5.0M  4.0K  5.0M    1% /run/lock
tmpfs           981M     0  981M    0% /sys/fs/cgroup
tmpfs           197M   16K  197M    1% /run/user/0
/dev/mmcblk0p8   30G  3.8G   25G   14% /media/3699f79c-f05d-4948-89c9-04dc4b132a1f

解除挂载：

umount /dev/mmcblk0p8

挂载：

mount /dev/mmcblk0p8 /sdcard

1. 打开蓝牙管理器，搜索附近蓝牙设备：

2. 选中蓝牙设备，配对然后选择信任：

3. 设置蓝牙连接类型：

1. 输入命令evtest 查看系统下所有按键、输入设备：

root@rk3399:~# evtest 
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0:	ff420030.pwm
/dev/input/event1:	USB Optical Wheel Mouse
/dev/input/event2:	SIGMACH1P USB Keyboard
/dev/input/event3:	rk29-keypad
/dev/input/event4:	SIGMACH1P USB Keyboard
Select the device event number [0-4]: 

2. 按照上面提示选择测试按键，如RK3399 boot按键为 /dev/input/event3: rk29-keypad

则event number 为3：按下按键会打印value 1,松开按键则会打印value 0,如下图：

3. 自定义按键功能，配置文件为

/etc/triggerhappy/triggers.d/example.conf

如下为定义按键为reboot功能，亦为系统默认配置，用户可以根据需要自定义。

KEY_VOLUMEUP    1   reboot

1. 系统支持使用APP切换不同的LCD屏，输入dis命令打开APP如下图：

• 选择对应的eDP/LVDS 屏分辨率，然后点击保存，系统自动重启后即可切换到指定的LCD:

2. 背光亮度调节:

• 方法①：点击右下角系统托盘如下图标，打开背光调节APP

• 方法②：控制驱动应用层接口：

 echo 100 > /sys/class/backlight/backlight1/brightness  

(注：写入数值越大亮度越大，max_brightness 为250)

1. 电源管理设置：

休眠后按POWER键唤醒 2. 电源管理功能非所有产品支持，需定制系统请联系业务窗口人员。

1.查看当前系统时间：

[root@rk3399:~]# date
Wed Jun  8 15:54:09 CST 2022

2. 设置同步硬件时钟：

[root@rk3399:/]# date -s "2022-06-08 17:01:01"
Wed Jun  8 17:01:01 CST 2022
[root@rk3399:/]# hwclock -w
[root@rk3399:/]# hwclock -r
Wed Jun  8 17:01:09 2022  0.000000 seconds

3. 关机断电5秒以上，再开机查看系统时间是否保存：

[root@rk3399:/]# date 
 Wed Jun  8 17:02:30 CST 2022

注：系统默认为网络时间同步，以上RTC测试需要在断外网情况下测试。

4. 时区设置

• 方法① – 修改link文件,如改为中国、上海:

ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
reboot

设置其他时区只需将上面命令中的Asia/Shanghai改为对应的时区城市即可。

• 方法② – 在图形界面依次打开首选项→时间和日期,选择时区如下图：

选择完成后关闭窗口，使用date命令查看时区变化:

查看CPU信息：

cat /proc/cpuinfo

查看内存容量大小：

free -h

查看EMMC可用容量大小

df -h

C参考代码如下：

#include <stdio.h> 
#include <stdlib.h> 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <fcntl.h> 
#include <unistd.h> 
#include <string.h> 
static char gpio_path[100];
//设置GPIO方向、高低电平
static int gpio_config(const char *file, const char *value) 
{ 
	char config_path[100]; 
	int len; 
	int fd; 
	sprintf(config_path, "%s/%s", gpio_path, file); 
	if (0 > (fd = open(config_path, O_WRONLY))) 
	{
		perror("open error"); 
		return fd; 
	} 
	len = strlen(value); 
	if (len != write(fd, value, len))
	{ 
		perror("write error"); 
		close(fd); 
		return -1; 
	} 
	close(fd); 
	return 0; 
} 
//获取GPIO的方向、电平
static int gpio_get(const char *file)
{ 
	char get_path[100]; 
	char buf[10]={"\0"};
	int len; 
	int fd; 
	sprintf(get_path, "%s/%s", gpio_path, file);
	if (0 > (fd = open(get_path, O_RDWR)))
	{
		perror("open error"); 
		return fd; 
	}
	if ( 0 > read(fd,buf,10))
	{
		perror("read error"); 
		return fd; 
	}
	printf("  %s : %s",file,buf);
	close(fd); 
	return 0; 
}
int main(int argc, char *argv[]) 
{ 
	 if (4 != argc) 
	{ 
		if (3 != argc)
		{
			fprintf(stderr, "set gpio out : %s <gpio> <out> <value>\n", argv[0]); 
			fprintf(stderr, "set gpio in  : %s <gpio> <in>\n", argv[0]); 
			exit(-1); 
		}
	}	 
	sprintf(gpio_path, "/sys/class/gpio/gpio%s", argv[1]); 
	if (access(gpio_path, F_OK)) 
	{ 
		printf("%s inexistence,export %s... \n",gpio_path,argv[1]);
		int fd; 
		int len; 
		if (0 > (fd = open("/sys/class/gpio/export", O_WRONLY))) 
		{
			perror("open error"); exit(-1); 
		} 
		len = strlen(argv[1]); 
		if (len != write(fd, argv[1], len)) 
		{
			perror("write error"); 
			close(fd);
			exit(-1); 
		} 
		close(fd);
	} 
	if (gpio_config("direction", argv[2])) 
		exit(-1);	
	if ( 0 == strcmp("out",argv[2] ) && argc == 4 )
	{
		if(gpio_config("value", argv[3]))
		exit(-1); 
	}
	printf("gpio_op%s:\n",argv[1]);	
	if (gpio_get("direction"))
		exit(-1);
	if (gpio_get("value"))
		exit(-1);
	 exit(0); 
}

交叉编译源码：

aarch64-linux-gnu-gcc -o a.out gpio.c

将编译好的gpio程序使用scp拷贝到 r39s2 主板上，执行测试：

使用方法：

0：./gpio 1 out 0

1：./gpio 1 out 1

系统下操作 UART 的测试串口，以 J_RS232 TX3\RX3 测试为例：

J_RS232 TX3\RX3 设备节点为：

/dev/ttysWK2

C参考UART高低电平输入代码如下：

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <termios.h>
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
 
#define UART_DEVICE     "/dev/ttysWK2" //uart设备文件名称
 
int main(int argc, char *argv[])
{
 
    int fd, res;
    struct termios  oldtio, newtio;
    char  ch;
    char buf[256] = {0};
 
//-----------打开uart设备文件------------------
    fd = open(UART_DEVICE, O_RDWR|O_NOCTTY);//没有设置O_NONBLOCK。所以这里read和write是堵塞操作
    if (fd < 0) {
        perror(UART_DEVICE);
        exit(1);
    }
    else
    	printf("Open %s successfully\n", UART_DEVICE);
 
//-----------设置操作參数-----------------------	
    tcgetattr(fd, &oldtio);//获取当前操作模式參数
    memset(&newtio, 0, sizeof(newtio));
 
	//波特率=115200 数据位=8 使能数据接收 
    newtio.c_cflag = B115200|CS8|CLOCAL|CREAD;
    newtio.c_iflag = IGNPAR; 
 
    tcflush(fd, TCIFLUSH);//清空输入缓冲区和输出缓冲区
    tcsetattr(fd, TCSANOW, &newtio);//设置新的操作參数
 
//------------向urat发送数据-------------------
    res=write(fd, "Begin Uart tx", 16);
    while(1) {
    	//从控制台终端获取数据，然后通过uart发送出去，直到接收到！字符
        while((ch=getchar()) != '!') {
            buf[0]=ch;
            res=write(fd, buf, 1);
        }
 
        buf[0]=ch;
        buf[1]=' ';
        res = write(fd, buf, 2);
        break;
    }
//-------------从uart接收数据-------------------
    while(1) {
    	res = read(fd, buf, 255);//程序将在这里挂起，直到从uart接收到数据（堵塞操作）
    	if (res == 0) 
  			continue;
 
  		buf[res] = ' ';
  		printf("res = %d, buf = %s\n", res, buf);//将uart接收到的字符打印出来
  		if (buf[0] == '!')//uart接收到！字符后退出while
  			break;
  	}
//------------关闭uart设备文件，恢复原先參数--------
    close(fd);
    printf("Close %s\n", UART_DEVICE);
    tcsetattr(fd, TCSANOW, &oldtio); //恢复原先的设置
 
    return 0;
}
 
}

交叉编译源码：

aarch64-linux-gnu-gcc -o a.out uart.c

将编译好的程序使用 scp 拷贝到 3399 主板上，执行测试:

参考系统下操作Key的方法，获取到key的设备节点为

/dev/input/event2

C参考代码如下：

#include <unistd.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <linux/input.h>
#include <sys/select.h>
#define INPUT_DEVICE "/dev/input/event2"
int main(int argc, char **argv){
	int fd;
	struct input_event event;
	ssize_t bytesRead;
	int ret;
	fd_set readfds;
	if ( 0 > (fd = open(INPUT_DEVICE,O_RDONLY)))
	{
		perror("open error"); 
		return fd; 
	}
	while(1){
		FD_ZERO(&readfds);
		FD_SET(fd,&readfds);
		ret = select(fd + 1, &readfds, NULL, NULL, NULL);
		if (ret == -1){
			fprintf(stderr,"select call on%s : an error ocurred",argv[1]);
		break;
		}	
		if(FD_ISSET(fd,&readfds)){
			bytesRead = read(fd, &event,sizeof(struct input_event));
			if(bytesRead == -1 )
				fprintf(stderr,"bytesRead :%ld : an error ocurred",bytesRead);
			}	
		if(event.type == EV_KEY && (event.value == 0 || event.value == 1))
		{
			printf("key %s\n",(event.value) ? "pressed" : "released");
		}
	}
	close(fd);
	return EXIT_SUCCESS;
}

交叉编译源码：

 
aarch64-linux-gnu-gcc -o key1 key.c

将编译好的程序使用 scp 拷贝到 r39s2 主板上，执行测试，按动 key 打印如下：

• 按下按键时显示：key pressed
• 松开按键时显示：key released

* 主机环境推荐：Debian 10 x64 bit， 可以直接导入配置好的虚拟机镜像: QT编译环境virtualbox

或者使用QT编译环境 Docker image: QT编译环境Docker

 ### load docker image 
 sudo docker load <nodka_docker_qt_build_20230223.tar
 
 ### 运行docker image,注意 : /home/APP_PATH为QT应用程序所在目录
 sudo docker run --rm --mount type=bind,source=/home/APP_PATH,target=/mnt/ -i -t 09a37c1b2fc3 /bin/bash 

 ###  编译QT 应用程序
 cd  /mnt
 qmake
 make

* 主机交叉编译环境配置参考步骤：

1. 安装交叉编译工具链：

  apt install -y crossbuild-essential-arm64
  

2. 拷贝平板系统内的/usr & /lib 到主机 /home/nodka/qt5/qt_sysroot 目录下

3. 配置以下环境变量

QTSYSROOT="/home/nodka/qt5/qt_sysroot"
QTPATH=$QTSYSROOT/usr/local/qt5.12-arm
  
LD_LIBRARY_PATH=$QTPATH/lib:$LIBRARY_PATH
LIBRARY_PATH=$QTPATH/lib:$LIBRARY_PATH
C_INCLUDE_PATH=$QTPATH/include:$C_INCLUDE_PATH
PATH=$QTPATH/bin:$PATH
  
PKG_CONFIG_PATH=$QTPATH/lib/pkgconfig:$PKG_CONFIG_PATH
  
export LD_LIBRARY_PATH
export LIBRARY_PATH
export C_INCLUDE_PATH
export CPLUS_INCLUDE_PATH
  
export PKG_CONFIG_PATH
export PATH

4. 编译APP

qmake
make

1. 安装

进入Qt官方下载页面，选择一个版本下载 qt-creator-opensource-linux-x86_64-x.x.x.run，下载完成之后，在终端执行 ./xxxx.run 运行安装，注意文件需要有执行权限。

2.配置

安装完成后，启动 Qt Creator，打开菜单 Tools → Option ,找到Kits。

• 配置 Qt Versions

点击右侧 add 按钮添加，选择 Qt 环境安装位置中的 qmake 即可

qmake：

/usr/local/qt5.12-arm/bin/qmake

• 配置 Compilers

点击右侧 add 按钮添加 gcc 和 g++ 交叉编译器的位置

如果主机安装了 crossbuild-essential-arm64，则编译器就在 /usr/bin/ 下

如果使用了第三方的交叉编译器，找到安装位置并添加即可

如果目标平台是 Buildroot ，则需要使用 Buildroot Qt 环境包中的编译器

g++：/usr/bin/aarch64-linux-gnu-g++

gcc：/usr/bin/aarch64-linux-gnu-gcc

为方便调试，配置 Debeggers 和 Devices 用于在线调试：

• 配置 Debuggers

点击右侧 add 按钮添加 gbd-multiarch: apt install -y gdb-multiarch

检查目标机上是否存在 /usr/bin/gdbserver, 没有的话需要安装：apt install -y gdbserver，没有的话需要安装：apt install -y gdbserver (Buildroot 自带，无需安装)

回到主机的 Qt Creator,点击右侧 add 按钮添加 gdb

选择主机中的 gdb-multiarch : /usr/bin/gdb-multierch

• 配置 Devices

设置好设备的 IP 、用户名（root）。为了方便调试，可以在设备上设置静态 IP。

• 配置Kits

将前面设置的配置项添加到 Kits。

如果目标平台是 Ubuntu 系统，这一步也需要添加 sysroot 的路径

Docker English-Community 支持以下的 Ubuntu 版本：

• Xenial 16.04(LTS)
• Bionic 18.04(LTS)
• Cosmic 18.04
• Disco 19.04
• 其他更新的版本…

安装命令如下：

curl -fsSL https://get.docker.com | bash -s docker --miror Aliyun

也可以使用国内 daocloud 一键安装命令：

curl -sSL https://get.daocloud.io/docker | sh

测试 Docker 是否安装成功，输入以下指令，打印出以下信息则安装成功：

sudo docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete                                                                                                                                  
Digest: sha256:c3b4ada4687bbaa170745b3e4dd8ac3f194ca95b2d0518b417fb47e5879d9b5f
Status: Downloaded newer image for hello-world:latest


Hello from Docker!
This message shows that your installation appears to be working correctly.


To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.


To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash


Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/


For more examples and ideas, visit:
 https://docs.docker.com/get-started/

• 系统已经支持OpenCL,输入命令clinfo即可查看支持详情:

终端输入 ota 进行固件在线升级