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）有线网络

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

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

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

* 点击 上网模式 选择 静态IP

* 进行设置

1.设置 ⇒ 网络和互联网 ⇒ 点击WLAN

2.点击开启

3.选择需要连接的WIFI，然后点击，输入密码

４.连接成功

１.测试４Ｇ网络

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

b）机器上电后有这个4G图标表示正常

2.测试5G网络

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

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

1.导出节点（编号为56、57、58、59）

echo 56 >/sys/class/gpio/export

2. IO 控制节点都在/sys/class/gpio/

3. IO 对应表如下：

4. IO控制方法：

• 输出低电平：

echo 0 >/sys/class/gpio/gpio56/value

*输出高电平：

echo 1 >/sys/class/gpio/gpio56/value

*查看输入电平：

cat /sys/class/gpio/gpio56/value

1. 串口定义参考：

• 主板接口定义

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

3. CuTecom 测试串口，以232_RX5\TX5回环测试为例

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

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

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

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

com_recv /dev/ttyS7 115200

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

com_send /dev/ttyS7 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.导出节点（编号为56、57、58、59）

echo 56 >/sys/class/gpio/export

2. IO 控制节点都在/sys/class/gpio/

3. IO 对应表如下：

4. IO控制方法：

• 输出低电平：

echo 0 >/sys/class/gpio/gpio56/value

*输出高电平：

echo 1 >/sys/class/gpio/gpio56/value

*查看输入电平：

cat /sys/class/gpio/gpio56/value

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

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

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

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

• 录音测试

arecord  -D hw:0,0 -d 5 -f cd -r 44100 -c 2 -t wav test.wav   
aplay test.wav  -D hw:0,0

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%s:\n",argv[1]);	
	if (gpio_get("direction"))
		exit(-1);
	if (gpio_get("value"))
		exit(-1);
	 exit(0); 
}

交叉编译源码：

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

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

使用方法：

1：./gpio 56 out 1

0：./gpio 56 out 0

系统下操作 UART 的测试串口，以 232_RX5\TX5 测试为例：

232_RX5\TX5 设备节点为：

/dev/ttyS7

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/ttyS7" //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 uart uart.c

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

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

/dev/input/event3

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/event3"
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 key key.c

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

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

* 主机环境推荐：Debian 10 x64 bit，

    
 本公司已配置好的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 进行固件在线升级