Linux Usage guide

Interface function test

GPIO

1.IO The control nodes are all present:/sys/class/io_control

2.IO corresponds to the following table:

function Screen printing of motherboard Node name
input IO1 gpio_ip0
IO2 gpio_ip1
IO3 gpio_ip2
IO4 gpio_ip3
IO5 gpio_ip4
IO6 gpio_ip5
output IO7 gpio_op0
IO8 gpio_op1
IO9 gpio_op2
IO10 gpio_op3
IO11 gpio_op4
IO12 gpio_op5

3.IO control method:

  • Output low level:
echo 0 >/sys/class/io_control/gpio_op0

*Output high level:

echo 1 >/sys/class/io_control/gpio_op0

*View input level:

cat /sys/class/io_control/gpio_ip0
UART

1. Serial port definition reference:

2. Serial port device node system mapping table:

Screen printing of motherboard Device node
COM1 /dev/ttyXRUSB0
COM2 /dev/ttyXRUSB1
COM3 /dev/ttyXRUSB2
COM4 /dev/ttyXRUSB3

3. CuTecom tests the serial port, The COM2 loopback test is used as an example

  • Refer to Steps 1 to 2 to short the TX & RX (2 to 3 pin) of COM2.
  • Double-click the CuteCom icon on the desktop, open APP, Device select the device node corresponding to the test port (see Step 2).
  • Click Settings to set the serial port parameters, as shown in the picture below:

  • Click Open to open the serial port, input characters in the input text box, and press Enter to send data:

4. Test the serial port on the CLI, The COM2 loopback test is used as an example

Open the terminal and enter the following command to receive data:

com_recv /dev/ttyXRUSB1 115200

Open another terminal to send data:

com_send /dev/ttyXRUSB1 115200

The test results are as follows:

LAN

1. Check the IP address of the network adapter, The system dynamically obtains an IP address by default

#ifconfig -a 

2. Set a static IP address for a network adapter

  • Method 1 – Use graphical tool Settings

Double-click the desktop icon:Advanced Network Configuration

  • Method 2 – How to modify the configuration file:
vim /etc/network/interfaces

  • After the modification is complete, enter restart to take effect.
WIFI

1. Click the network icon in the lower right corner to browse the available WIFI routes:

  • Enter your WIFI password and tap connect

2. Method 2 – Connect to wifi from the command line

nmcli d wifi connect "SSID" password "PASSWROD"
4G/5G

1. The system has automatic dialing, Open the terminal and enter the command 4g to dial automatically:

root@rk3399:~# 4g

2. After the dial-up is complete, view the IP address:

3.Open a browser and browse any website.

4. The test method of 5G is similar to that of 4G, Input the command 5g to dial automatically:

root@rk3399:~# 5g
Can

Not support

GPIO/DIO

1.IO - The control nodes are all present:/sys/class/io_control

2.IO - corresponds to the following table:

function Screen printing of motherboard Node name
input IO1 gpio_ip0
IO2 gpio_ip1
IO3 gpio_ip2
IO4 gpio_ip3
IO5 gpio_ip4
IO6 gpio_ip5
output IO7 gpio_op0
IO8 gpio_op1
IO9 gpio_op2
IO10 gpio_op3
IO11 gpio_op4
IO12 gpio_op5

3.IO control method:

  • Output low level:
echo 0 >/sys/class/io_control/gpio_op0

*Output high level:

echo 1 >/sys/class/io_control/gpio_op0

*View input level:

cat /sys/class/io_control/gpio_ip0
Audio
  • Connect the horn to the SPK port on the board

1. Method ① – Use the SMPayer player delivered with the system and the audio test file to test the audio function

2. Method 2 – Using commands to play:

aplay  /nodka_test/LR_audio.wav  -D  hw:0,0
Mic
  • Recording test
arecord -d 5 -f cd -r 44100 -c 2 -t wav test.wav  
aplay test.wav
USB

1. The USB flash drive is automatically mounted to /media/disk

root@rk3399:~# df -h
File system        capacity  used  available used% Mount point
/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

* SDcard Automatic mounting:

root@rk3399:~# df -h
File system        capacity  used  available used% Mount point
/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:

umount /dev/mmcblk0p8

mount:

mount /dev/mmcblk0p8 /sdcard
Bluetooth

1. Open the Bluetooth manager and search for nearby Bluetooth devices:

2. Select Bluetooth device, pair and then select Trust:

3. To set the Bluetooth connection type:

WatchDog
Key

1. Run the evtest command to view all keys and input devices in the system:

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. Select a test key as prompted. For example, the RK3399 boot key is /dev/input/event3: rk29-keypad

The event number is 3:Pressing the key prints a value of 1,Releasing the key prints a value of 0,As shown below:

3. Customize the key function. The configuration file is

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

The key is the reboot function. It is also the default configuration of the system. You can customize the key as required。

KEY_VOLUMEUP    1   reboot
LCD/Backlight

1. The system supports switching between different LCD screens using APP. Run the dis command to open the APP as shown in the following figure:

  • Select the corresponding eDP/LVDS screen resolution and click Save. After the system restarts automatically, you can switch to the specified LCD:

2. Backlight brightness adjustment:

  • Method 1: Click the following icon in the system tray at the lower right corner to open the backlight adjustment APP

  • Method 2: Control driver application layer interface:
 echo 100 > /sys/class/backlight/backlight1/brightness  

(Note: The larger the value written, the greater the brightness,max_brightness 为250)

PowerManager

1. Power management Settings:

Press POWER to wake up after sleep 2. The power management function is not supported by all products. To customize the system, contact the service window personnel.

RTC/Timezone

1.View the current system time:

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

2. To set the synchronization hardware clock:

[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. Power off for more than 5 seconds, and then turn it on to check whether the system time is saved:

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

Note: The system uses network time synchronization by default. The above RTC test needs to be conducted when the external network is disconnected. 4. Time zone setting

  • Method 1 – Modify the link file, such as China, Shanghai:
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
reboot

To set other time zones, simply change Asia/Shanghai in the preceding command to the corresponding time zone city.

  • Method 2 – Open preferences -&gt in sequence on the graphical interface; Time and date, select the time zone as shown below:

Close the window and run the date command to view the time zone change:

CPU

To view CPU information:

cat /proc/cpuinfo
Memory

Check the memory capacity:

free -h
EMMC

View the available capacity of the EMMC

df -h

Linux Programming guide

GPIO Application programming

C The reference code is as follows:

#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];
//Set the GPIO direction and high and low level
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; 
} 
//Get the direction and level of 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); 
}

Cross-compiled source code:

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

Copy the compiled gpio program to rk3399 motherboard using scp and perform the test:How to use:

0:./gpio 0 out 0

1:./gpio 0 out 1

UART Application programming

Operating the test serial port of the UART in the system, using the COM2 test as an example:

COM2 The device node is:

/dev/ttyXRUSB1

C Reference UART high and low level input codes are as follows:

#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/ttyXRUSB1" //UART Device file name
 
int main(int argc, char *argv[])
{
 
    int fd, res;
    struct termios  oldtio, newtio;
    char  ch;
    char buf[256] = {0};
 
//-----------Open the uart device file------------------
    fd = open(UART_DEVICE, O_RDWR|O_NOCTTY);//No setting O_NONBLOCK。So here read and write are blocking operations
    if (fd < 0) {
        perror(UART_DEVICE);
        exit(1);
    }
    else
    	printf("Open %s successfully\n", UART_DEVICE);
 
//-----------Set operating parameters-----------------------	
    tcgetattr(fd, &oldtio);//Gets the current operation mode parameters
    memset(&newtio, 0, sizeof(newtio));
 
	//Baud rate =115200 Data bits =8 Enable data receiving 
    newtio.c_cflag = B115200|CS8|CLOCAL|CREAD;
    newtio.c_iflag = IGNPAR; 
 
    tcflush(fd, TCIFLUSH);//Clear the input and output buffers
    tcsetattr(fd, TCSANOW, &newtio);//Set a new operation parameter
 
//------------Send data to urat-------------------
    res=write(fd, "Begin Uart tx", 16);
    while(1) {
    	// Get the data from the console terminal and send it through the uart until it is received! Character
        while((ch=getchar()) != '!') {
            buf[0]=ch;
            res=write(fd, buf, 1);
        }
 
        buf[0]=ch;
        buf[1]=' ';
        res = write(fd, buf, 2);
        break;
    }
//-------------Receive data from the uart-------------------
    while(1) {
    	res = read(fd, buf, 255);//Here the program will hang until data is received from the uart (blocking operation)
    	if (res == 0) 
  			continue;
 
  		buf[res] = ' ';
  		printf("res = %d, buf = %s\n", res, buf);//Print out the characters received by the uart
  		if (buf[0] == '!')//uart received! Exit the while after the character
  			break;
  	}
//------------Close the uart device file and restore the original parameters--------
    close(fd);
    printf("Close %s\n", UART_DEVICE);
    tcsetattr(fd, TCSANOW, &oldtio); //Restore the original Settings
 
    return 0;
}
 
}

Cross-compile source code:

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

Copy the compiled program to 3399 motherboard using scp, and perform the test:

KEY application programming

For details, see the method of operating a key in the system

/dev/input/event2

C The reference code is as follows:

#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;
}

Cross-compile source code:

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

Copy the compiled program to the r39s2 motherboard using scp, perform the test, press the key to print as follows:

  • Display when the key is pressed:key pressed
  • Display when the key is released:key released

Linux Application support

QT Cross-compilation environment

QT Creator

Hd hard decoding

Docker

OpenCL

  • OpenCL is already supported by the system. Enter clinfo to view the support details:

Linux OTA Online upgrade

Terminal input ota for firmware online upgrade

打印/导出