Radxa Wiki - User contributions [en]

RockpiS/dev/libmraa

2020-05-12T08:24:01Z

SimenZhor: /* Install essential packages */ Added "install compiler" since gcc is not preinstalled in the March 2020 image

{{rockpiS_header}}

{{Languages|rockpiS/dev/libmraa}}

[[rockpiS | ROCK Pi S]] > [[rockpiS/dev | Development]] > [[rockpiS/dev/libmraa | Install Libmraa ]]

=== Libmraa on ROCK Pi S ===

This guide describes how to use libmraa on ROCK Pi S.

==== Install essential packages ====

Package libmraa is in the Radxa APT bionic-stable and buster-stable repositories.

Execute the following commands to add Radxa APT

rock@rockpis:~$ export DISTRO=bionic-stable # for Bionic

or

rock@rockpis:~$ export DISTRO=buster-stable # for Buster
rock@rockpis:~$ echo "deb http://apt.radxa.com/$DISTRO/ ${DISTRO%-*} main" | sudo tee -a /etc/apt/sources.list.d/apt-radxa-com.list

Get the pub key

rock@rockpis:~$ wget -O - apt.radxa.com/buster-testing/public.key | sudo apt-key add -

Install essential packages:

rock@rockpis:~$ sudo apt-get update
rock@rockpis:~$ sudo apt-get install -y rockchip-overlay rockpis-dtbo libmraa # libmraa version: >=0.4
rock@rockpis:~$ sudo apt-get install -y linux-4.4-rockpis-latest # ROCK Pi S kernel version: >= 4.4.143-47

Install compiler:
rock@rockpis:~$ sudo apt install -y build-essential

==== Enable interface ====

See ROCK Pi S [[rockpiS/hardware/gpio | GPIO pintout]]. ROCK Pi S has a 26-pin colorful expansion header. Each pin is distinguished by color. mraa define is shown below:

===== Hardware V12 =====

16 GPIO:
PIN03 GPIO2_A2
PIN05 GPIO2_B0
PIN07 GPIO2_B3
PIN09 GPIO4_C4
PIN11 GPIO4_C2
PIN12 GPIO4_A3
PIN13 GPIO4_C6
PIN15 GPIO4_C5
PIN16 GPIO4_D2
PIN18 GPIO4_D4
PIN19 GPIO1_B0
PIN21 GPIO1_A7
PIN22 GPIO4_D5
PIN23 GPIO1_B1
PIN24 GPIO1_B2
PIN26 GPIO1_B2

3 I2C:
PIN23 I2C'''0'''_SDA
PIN24 I2C'''0'''_SCL
PIN3 I2C'''1'''_SCL
PIN5 I2C'''1'''_SDA
PIN13 I2C'''3'''_SDA
PIN15 I2C'''3'''_SCL

1 SPI:
PIN19 SPI'''2'''TX //must disable i2c0
PIN21 SPI'''2'''RX //must disable i2c0
PIN23 SPI'''2'''CLK
PIN24 SPI'''2'''CSN

3 UART:
PIN8 UART'''0'''_TX
PIN10 UART'''0'''_RX
PIN23 UART'''1'''_TX
PIN24 UART'''1'''_RX
PIN19 UART'''2'''_RX
PIN21 UART'''2'''_TX

2 PWM:
PIN11 PWM'''2'''
PIN13 PWM'''3'''

1 ADC:
PIN26 ADC_IN0 //the measure voltage must lower than 1.8v

For those ROCK Pi S system images released after March 1st, 2020, the configuration file is /boot/uEnv.txt. For more details, follow this guide, [https://wiki.radxa.com/Device-tree-overlays Device tree overlays].

For those ROCK Pi S system images released before March 1st, 2020, the configuration file is /boot/hw_intfc.conf.

==== Test ====

Package libmraa provides some examples for testing spi, uart, i2c, gpio, etc. We way use the c files in /usr/local/share/mraa/examples/c.

And we copy them to home directory.

rock@rockpis:~/mraa-examples$ cp -av /usr/local/share/mraa/examples/c /home/rock/mraa-examples

You should pay more attention to the Black Bold words when modifying configuration file /boot/uEnv.txt.

===== GPIO test =====

Use '''mraa-gpio tool''' to test

root@rockpis:~# mraa-gpio list
01 3V3:
02 5V:
03 I2C_SDA: GPIO I2C
04 5V:
05 I2C_SCL: GPIO I2C
06 GND:
07 I2S0_8CH_MC: GPIO
08 UART0_TX: GPIO UART
09 GND:
10 UART0_RX: GPIO UART
11 PWM2,I2C3_S: GPIO I2C PWM
12 I2S0_8CH_SC: GPIO
13 PWM3,I2C3_S: GPIO I2C PWM
14 GND:
15 SPDIF_TX: GPIO
16 I2S0_8CH_SD: GPIO
17 3V3:
18 I2S0_8CH_SD: GPIO
19 UART1_RTSN,: GPIO SPI UART
20 GND:
21 UART1_CTSN,: GPIO SPI UART
22 I2S0_8CH_LR: GPIO
23 UART1_RX,I2: GPIO I2C SPI UART
24 UART1_TX,I2: GPIO I2C SPI UART
25 GND:
26 ADC_IN0: AIO
root@rockpis:~# mraa-gpio set 15 1 #pin15 pull high
root@rockpis:~# mraa-gpio set 15 0 #pin15 pull high

===== PWM test =====

ROCK Pi S V1.2 provides 2 PWM, PWM2 and PWM3. It is necessary to enable PWM1, PWM2 and PWM3 at the same time if you need PWM function.

Firstly, modify the /boot/uEnv.txt file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-pwm1 rk3308-pwm2 rk3308-pwm3'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

Modify the macro PWM in /home/rock/mraa-examples/pwm.c as follows to test PWM2. To test PWM3, change '''#define PWM 11''' to '''#define PWM 13'''.

'''/* PWM declaration */'''
'''#define PWM 11'''

Save and compile pwm.c
rock@rockpis:~/mraa-examples$ gcc -o pwm pwm.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./pwm
PWM value is 0.010015
PWM value is 0.019985
PWM value is 0.030000
PWM value is 0.040014
PWM value is 0.049984
PWM value is 0.059999

===== I2C test =====
ROCK Pi S V1.2 provides 3 I2C,There are I2C0 ,I2C1, I2C3. If you need the I2C function, you can turn on one or more of them.

Firstly, modify the /boot/uEnv.txt file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-i2c0 rk3308-i2c1 rk3308-i2c3'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

We use MPU6050 tets i2c.
Modify the macro MPU6050 in '''/home/rock/mraa-examples/i2c_mpu6050.c''' ,as follows to test I2C0. To test I2C1 and I2C3, change '''#define I2C_BUS 0''' to '''#define I2C_BUS 1''' or'''#define I2C_BUS 3''' .

/* mraa header */
#include "mraa/i2c.h"
'''#define I2C_BUS 0'''

Save and compile pwm.c
rock@rockpis:~/mraa-examples$ gcc -o i2c_mpu6050 i2c_mpu6050.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./i2c_mpu6050
accel: x:0 y:0 z:0
gyro: x:-10 y:1 z:7

accel: x:0 y:0 z:0
gyro: x:107 y:-12 z:69

accel: x:0 y:0 z:0
gyro: x:6 y:136 z:-50

accel: x:0 y:0 z:0
gyro: x:-5 y:48 z:-103

accel: x:0 y:0 z:0
gyro: x:3 y:3 z:5

===== UART test =====
ROCK Pi S V1.2 provides 3 UART,There are '''uart0''' ,'''uart1''', '''uart2'''. If you need the uatr function, you can turn on one or more of them.

Firstly, Disable console and enable '''uart0''' for uart test.modify the '''/boot/uEnv.txt''' file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
'''overlays=rk3308-uart0 rk3308-uart1 rk3308-uart2'''
'''console='''
rootuuid=c3800af9-fa58-4fb3-bb56-e52fd04837ba
initrdsize=0x5c96c3
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

Here set console to NULL value.

then reboot . use ssh connect to rockpis,we must have 2 windows,one is for send data,anothor is for receive.

send command follow:
rock@rockpis:~$ sudo mraa-uart dev 0 baud 1500000 send radxa

Another window sets the baud 1500000 and receives the data

radxa

receive command follow:
rock@rockpis:~$ sudo mraa-uart dev 0 baud 1500000 recv 1000
radxa

===== SPI test =====

Firstly, modify the '''/boot/uEnv.txt''' file.

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-spi-spidev'''
'''param_spidev_spi_bus=2'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

then execute command, sync, followed by '''reboot'''.

Create file test-spi.c and add the following contents.

rock@rockpis:~/mraa-examples$ cat test-spi.c
#include <signal.h>
#include <stdlib.h>
#include <unistd.h>

/* mraa header */
#include "mraa/spi.h"

/* SPI declaration */
'''#define SPI_BUS 2'''

/* SPI frequency in Hz */
#define SPI_FREQ 10000000
int
main(int argc, char** argv)
{
mraa_result_t status = MRAA_SUCCESS;
mraa_spi_context spi;
int i, j;

/* initialize mraa for the platform (not needed most of the times) */
mraa_init();

//! [Interesting]
/* initialize SPI bus */
spi = mraa_spi_init(SPI_BUS);
if (spi == NULL) {
fprintf(stderr, "Failed to initialize SPI\n");
mraa_deinit();
return EXIT_FAILURE;
}

/* set SPI frequency */
status = mraa_spi_frequency(spi, SPI_FREQ);
if (status != MRAA_SUCCESS)
goto err_exit;

/* set big endian mode */
status = mraa_spi_lsbmode(spi, 0);
if (status != MRAA_SUCCESS) {
goto err_exit;
}

j = 10;
while(j) {
j--;
printf("0x%x\n",mraa_spi_write(spi, 0xaa));
}
err_exit:
mraa_result_print(status);

/* stop spi */
mraa_spi_stop(spi);

/* deinitialize mraa for the platform (not needed most of the times) */
mraa_deinit();

return EXIT_FAILURE;
}
rock@rockpis:~/mraa-examples$ gcc -o test-spi test-spi.c -lmraa

Then short pin19 and pin21 and run test-spi

rock@rockpis:~/mraa-examples$ sudo ./test-spi
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
MRAA: SUCCESS

===== ADC test =====

connect signal you want to measure, and then compile mraa example c file, aio.c, to test.

<pre>
rock@rockpis:~/mraa-examples$ gcc -o aio aio.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./aio
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
</pre>

==== Development ====

More introduction of libmraa can look at [http://iotdk.intel.com/docs/master/mraa/index.html libmraa official website].

==== Troubleshooting ====

* Refer [[RockpiS/getting_started/troubleshooting | Troubleshooting page]]
* Post your issue on the forum: https://forum.radxa.com/c/rockpiS

RockpiS/Ubuntu

2020-05-12T08:04:46Z

SimenZhor: /* Update necessary packages */ Added apt install of "apt-utils" without this, the adb connection might break during installation of "rockchip-adb" on the newest kernel image (March 2020)

{{rockpiS_header}}

{{Languages|rockpiS/Ubuntu}}

[[rockpiS | ROCK Pi S]] > [[rockpiS/Ubuntu | Ubuntu]]

__TOC__

== Work with ROCK Pi S Ubuntu ==

=== Introduction to ROCK Pi S Ubuntu ===

ROCK Pi S Ubuntu is an easy to use system. While working with ROCK Pi S Ubuntu, you will find it do well on playing music, Internet, Bluetooth and so on.

ROCK Pi S Ubuntu uses '''systemd''' to manage system.

=== Access from the Host PC/Laptop ===

==== Option 1: USB access(adb) ====
By default, the ROCK Pi S Linux image enables adbd services, which is a debug bridge from Android now ported on Linux. With one USB A to C cable you can power and access the board, very handy.

To use adb, you need to install adb tool on the PC/Laptop. Check instructions for [[Rock/windows_adb | Windows]] and [[Rock/linux_adb | Linux]].

After you have adb installed successfully, run the following command on console to login the shell of ROCK Pi S:

adb shell

Check [[rockpiS/dev/adb | Using adb]].

==== Option 2: Serial console ====

Check [[rockpiS/dev/serial-console | Serial Console]]

==== Option 3: SSH ====
SSH server is enabled on port 22 of ROCK Pi S default image.

Please use [https://angryip.org/ angryip] to find your board IP address.

To access ROCK Pi S by SSH, try

ping rockpis.local
ssh rock@rockpis.local

or if your router/network doesn't support Local Domain, you need to check your network/router administrator page and look for the ROCK Pi S ip address.

ping ip-of-device
ssh rock@ip-of-device

Note: You can also get the IP of ROCK Pi S from option 1 or option 2 if you can not access network administrator page.

=== Default User Account ===

Non-root User:
User Name : rock
Password : rock

=== Update necessary packages ===

Add Radxa APT, see [[rockpiS/radxa-apt | Radxa APT]].

Install packages:

$ sudo apt-get update
$ sudo apt-get install -y apt-utils # without this, the adb connection might break during installation of rockchip-adb
$ sudo apt-get install -y rockchip-overlay
$ sudo apt-get install -y linux-4.4-rockpis-latest rockpis-dtbo
$ sudo apt-get install -y rtl8723ds-firmware rockchip-adb resize-assistant
$ sudo apt-get install -y rockpis-dtbo # For those ROCK Pi S system images released before March 1st, 2020

=== Network Connection ===

There are two methods for network connection. One is Ethernet and the other is WIFI.

==== Ethernet Connection ====
You can use a network cable (one end connected to the external network port or route) to connect your ROCK Pi S to the network. The ROCK Pi S will automatically configure the network for your surfing on the Internet.

===== To test the Ethernet, we need to follow the steps: =====
* Switch to super user mode by command
$ sudo su

* Check whether the Ethernet is normal by command, ifconfig, which would show us a network card, eth0, and the Ethernet IP address. Also, use tool, ping, to connect to a normal domain.

$ ifconfig
$ ping www.baidu.com

* If failed to connect to a normal domain. , try

$ sudo dhclient eth0

==== WIFI Connection ====

When there is not a network cable for your ROCK Pi S the WIFI connection is another good choice. ROCK Pi S supports 2.4G WIFI wireless network.

=====To test the WIFI performance, we need to follow the steps:=====

* Switch to super user mode
$ sudo su

* Open the WIFI
$ nmcli r wifi on

* Scan WIFI
$ nmcli dev wifi

* Connect to WIFI network
$ nmcli dev wifi connect "wifi_name" password "wifi_password"

* Test WIFI perpormance by tool iperf.

=== Bluetooth ===

Update necessary packages

$ sudo apt-get update
$ sudp apt-get install -y rockchip-overlay
$ sudo apt-get install -y linux-4.4-rockpis-latest # kernel version(>=4.4.143.27)
$ sudo apt-get install -y rtl8723ds-firmware bluez

Check Bluetooth service

$ systemctl status bluetooth

Run Bluetooth service if the Bluetooth service is inactive.

$ systemctl start bluetooth

Check Bluetooth device

$ hciconfig
hci0: Type: Primary Bus: UART
BD Address: 22:22:AA:25:49:1E ACL MTU: 1021:8 SCO MTU: 255:12
UP RUNNING
RX bytes:4424 acl:0 sco:0 events:81 errors:0
TX bytes:3820 acl:0 sco:0 commands:52 errors:0

Example: Connect to Bluetooth Speaker.

Change to root mode.

$ sudo su

Install pulseaudio packages

# apt-get install -y pulseaudio-module-bluetooth pulseaudio

Run pulseaudio

# pulseaudio --start

Connect using bluetoothctl

# bluetoothctl
[bluetooth]# default-agent
[bluetooth]# power on
[bluetooth]# scan on
[bluetooth]# trust 77:EC:79:4F:6B:AC
[bluetooth]# pair 77:EC:79:4F:6B:AC
[bluetooth]# connect 77:EC:79:4F:6B:AC

Play songs and enjoy it.

=== Common Hardware Interfaces, I2C, UART, SPI, etc ===

The ROCK Pi S system images released before March 1st, 2020 use hw_intfc.conf to configure interfaces while those which released after March 1st, 2020 use uEnv.txt. We suggest that you use the latest system images.

To use common hardware interfaces like I2C, UART, SPI, etc, we provides DTBO and libmraa. See https://wiki.radxa.com/Device-tree-overlays and https://wiki.radxa.com/RockpiS/dev/libmraa.

=== Use USB Camera ===

Check [[RockpiS/hardware/camera/ | ROCK Pi S Camera module]].

=== Use USB Device Network ===

Check [[rockpiS/dev/usbnet | ROCK Pi S USB Device Network]].

=== Display ===

See [[rockpiS/hardware/display | ROCK Pi S Display]].

=== Use Array Microphones with ROCK Pi S PoE ===

=== Storage Device ===

* uSD Card: /dev/mmcblk0

* SD Nand: /dev/mmcblk1

=== Boot Device Order ===

SD Nand -> uSD Card

=== Changelogs ===

==== 2020.03.16 ====

'''rockpis_debian_buster_minimal_arm64_20200315_1123-gpt.img'''

* Available for at least 256 MB DDR SDRAM
* Kernel version: 4.4.143-39-rockchip-gdaf243b9655a
* Support uEnv and boot.scr
* The version of systemd: 237
* U-boot version: 2017.09-02377-gc3d3bc84be

==== 2019.12.19 ====

'''rockpis_ubuntu_bionic_minimal_arm64_191219_0410-gpt.img'''

* U-boot version: 2017.09-02370-g6d65a50f1e
* Kernel version: 4.4.143-34-rockchip-g3c9d2019dba7
* System partitions: boot and rootfs
* Default serial console: UART0
* Default non-root user: rock (password: rock)
* Hostname: rockpis
* Support adb by default.
* Support SSH by default.
* Resize root filesystem to fit available disk space for the first boot
* Automatically load Bluetooth firmware after system startup.

RockpiS/dev/libmraa

2020-05-11T12:42:45Z

SimenZhor: /* ADC test */ missing -o in compile call

{{rockpiS_header}}

{{Languages|rockpiS/dev/libmraa}}

[[rockpiS | ROCK Pi S]] > [[rockpiS/dev | Development]] > [[rockpiS/dev/libmraa | Install Libmraa ]]

=== Libmraa on ROCK Pi S ===

This guide describes how to use libmraa on ROCK Pi S.

==== Install essential packages ====

Package libmraa is in the Radxa APT bionic-stable and buster-stable repositories.

Execute the following commands to add Radxa APT

rock@rockpis:~$ export DISTRO=bionic-stable # for Bionic

or

rock@rockpis:~$ export DISTRO=buster-stable # for Buster
rock@rockpis:~$ echo "deb http://apt.radxa.com/$DISTRO/ ${DISTRO%-*} main" | sudo tee -a /etc/apt/sources.list.d/apt-radxa-com.list

Get the pub key

rock@rockpis:~$ wget -O - apt.radxa.com/buster-testing/public.key | sudo apt-key add -

Install essential packages:

rock@rockpis:~$ sudo apt-get update
rock@rockpis:~$ sudo apt-get install -y rockchip-overlay rockpis-dtbo libmraa # libmraa version: >=0.4
rock@rockpis:~$ sudo apt-get install -y linux-4.4-rockpis-latest # ROCK Pi S kernel version: >= 4.4.143-47

==== Enable interface ====

See ROCK Pi S [[rockpiS/hardware/gpio | GPIO pintout]]. ROCK Pi S has a 26-pin colorful expansion header. Each pin is distinguished by color. mraa define is shown below:

===== Hardware V12 =====

16 GPIO:
PIN03 GPIO2_A2
PIN05 GPIO2_B0
PIN07 GPIO2_B3
PIN09 GPIO4_C4
PIN11 GPIO4_C2
PIN12 GPIO4_A3
PIN13 GPIO4_C6
PIN15 GPIO4_C5
PIN16 GPIO4_D2
PIN18 GPIO4_D4
PIN19 GPIO1_B0
PIN21 GPIO1_A7
PIN22 GPIO4_D5
PIN23 GPIO1_B1
PIN24 GPIO1_B2
PIN26 GPIO1_B2

3 I2C:
PIN23 I2C'''0'''_SDA
PIN24 I2C'''0'''_SCL
PIN3 I2C'''1'''_SCL
PIN5 I2C'''1'''_SDA
PIN13 I2C'''3'''_SDA
PIN15 I2C'''3'''_SCL

1 SPI:
PIN19 SPI'''2'''TX //must disable i2c0
PIN21 SPI'''2'''RX //must disable i2c0
PIN23 SPI'''2'''CLK
PIN24 SPI'''2'''CSN

3 UART:
PIN8 UART'''0'''_TX
PIN10 UART'''0'''_RX
PIN23 UART'''1'''_TX
PIN24 UART'''1'''_RX
PIN19 UART'''2'''_RX
PIN21 UART'''2'''_TX

2 PWM:
PIN11 PWM'''2'''
PIN13 PWM'''3'''

1 ADC:
PIN26 ADC_IN0 //the measure voltage must lower than 1.8v

For those ROCK Pi S system images released after March 1st, 2020, the configuration file is /boot/uEnv.txt. For more details, follow this guide, [https://wiki.radxa.com/Device-tree-overlays Device tree overlays].

For those ROCK Pi S system images released before March 1st, 2020, the configuration file is /boot/hw_intfc.conf.

==== Test ====

Package libmraa provides some examples for testing spi, uart, i2c, gpio, etc. We way use the c files in /usr/local/share/mraa/examples/c.

And we copy them to home directory.

rock@rockpis:~/mraa-examples$ cp -av /usr/local/share/mraa/examples/c /home/rock/mraa-examples

You should pay more attention to the Black Bold words when modifying configuration file /boot/uEnv.txt.

===== GPIO test =====

Use '''mraa-gpio tool''' to test

root@rockpis:~# mraa-gpio list
01 3V3:
02 5V:
03 I2C_SDA: GPIO I2C
04 5V:
05 I2C_SCL: GPIO I2C
06 GND:
07 I2S0_8CH_MC: GPIO
08 UART0_TX: GPIO UART
09 GND:
10 UART0_RX: GPIO UART
11 PWM2,I2C3_S: GPIO I2C PWM
12 I2S0_8CH_SC: GPIO
13 PWM3,I2C3_S: GPIO I2C PWM
14 GND:
15 SPDIF_TX: GPIO
16 I2S0_8CH_SD: GPIO
17 3V3:
18 I2S0_8CH_SD: GPIO
19 UART1_RTSN,: GPIO SPI UART
20 GND:
21 UART1_CTSN,: GPIO SPI UART
22 I2S0_8CH_LR: GPIO
23 UART1_RX,I2: GPIO I2C SPI UART
24 UART1_TX,I2: GPIO I2C SPI UART
25 GND:
26 ADC_IN0: AIO
root@rockpis:~# mraa-gpio set 15 1 #pin15 pull high
root@rockpis:~# mraa-gpio set 15 0 #pin15 pull high

===== PWM test =====

ROCK Pi S V1.2 provides 2 PWM, PWM2 and PWM3. It is necessary to enable PWM1, PWM2 and PWM3 at the same time if you need PWM function.

Firstly, modify the /boot/uEnv.txt file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-pwm1 rk3308-pwm2 rk3308-pwm3'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

Modify the macro PWM in /home/rock/mraa-examples/pwm.c as follows to test PWM2. To test PWM3, change '''#define PWM 11''' to '''#define PWM 13'''.

'''/* PWM declaration */'''
'''#define PWM 11'''

Save and compile pwm.c
rock@rockpis:~/mraa-examples$ gcc -o pwm pwm.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./pwm
PWM value is 0.010015
PWM value is 0.019985
PWM value is 0.030000
PWM value is 0.040014
PWM value is 0.049984
PWM value is 0.059999

===== I2C test =====
ROCK Pi S V1.2 provides 3 I2C,There are I2C0 ,I2C1, I2C3. If you need the I2C function, you can turn on one or more of them.

Firstly, modify the /boot/uEnv.txt file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-i2c0 rk3308-i2c1 rk3308-i2c3'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

We use MPU6050 tets i2c.
Modify the macro MPU6050 in '''/home/rock/mraa-examples/i2c_mpu6050.c''' ,as follows to test I2C0. To test I2C1 and I2C3, change '''#define I2C_BUS 0''' to '''#define I2C_BUS 1''' or'''#define I2C_BUS 3''' .

/* mraa header */
#include "mraa/i2c.h"
'''#define I2C_BUS 0'''

Save and compile pwm.c
rock@rockpis:~/mraa-examples$ gcc -o i2c_mpu6050 i2c_mpu6050.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./i2c_mpu6050
accel: x:0 y:0 z:0
gyro: x:-10 y:1 z:7

accel: x:0 y:0 z:0
gyro: x:107 y:-12 z:69

accel: x:0 y:0 z:0
gyro: x:6 y:136 z:-50

accel: x:0 y:0 z:0
gyro: x:-5 y:48 z:-103

accel: x:0 y:0 z:0
gyro: x:3 y:3 z:5

===== UART test =====
ROCK Pi S V1.2 provides 3 UART,There are '''uart0''' ,'''uart1''', '''uart2'''. If you need the uatr function, you can turn on one or more of them.

Firstly, Disable console and enable '''uart0''' for uart test.modify the '''/boot/uEnv.txt''' file to add the following

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
'''overlays=rk3308-uart0 rk3308-uart1 rk3308-uart2'''
'''console='''
rootuuid=c3800af9-fa58-4fb3-bb56-e52fd04837ba
initrdsize=0x5c96c3
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

Here set console to NULL value.

then reboot . use ssh connect to rockpis,we must have 2 windows,one is for send data,anothor is for receive.

send command follow:
rock@rockpis:~$ sudo mraa-uart dev 0 baud 1500000 send radxa

Another window sets the baud 1500000 and receives the data

radxa

receive command follow:
rock@rockpis:~$ sudo mraa-uart dev 0 baud 1500000 recv 1000
radxa

===== SPI test =====

Firstly, modify the '''/boot/uEnv.txt''' file.

root@rockpis:~# cat /boot/uEnv.txt
verbosity=7
overlay_prefix=rockchip
rootfstype=ext4
fdtfile=rockchip/rk3308-rock-pi-s.dtb
overlays=rk3308-console-on-uart0 '''rk3308-spi-spidev'''
'''param_spidev_spi_bus=2'''
rootuuid=37055840-4ec4-444f-979b-9e47ee4bd848
initrdsize=0x64d1d4
kernelversion=4.4.143-47-rockchip-g495ff574976c
initrdimg=initrd.img-4.4.143-47-rockchip-g495ff574976c
kernelimg=vmlinuz-4.4.143-47-rockchip-g495ff574976c

then execute command, sync, followed by '''reboot'''.

Create file test-spi.c and add the following contents.

rock@rockpis:~/mraa-examples$ cat test-spi.c
#include <signal.h>
#include <stdlib.h>
#include <unistd.h>

/* mraa header */
#include "mraa/spi.h"

/* SPI declaration */
'''#define SPI_BUS 2'''

/* SPI frequency in Hz */
#define SPI_FREQ 10000000
int
main(int argc, char** argv)
{
mraa_result_t status = MRAA_SUCCESS;
mraa_spi_context spi;
int i, j;

/* initialize mraa for the platform (not needed most of the times) */
mraa_init();

//! [Interesting]
/* initialize SPI bus */
spi = mraa_spi_init(SPI_BUS);
if (spi == NULL) {
fprintf(stderr, "Failed to initialize SPI\n");
mraa_deinit();
return EXIT_FAILURE;
}

/* set SPI frequency */
status = mraa_spi_frequency(spi, SPI_FREQ);
if (status != MRAA_SUCCESS)
goto err_exit;

/* set big endian mode */
status = mraa_spi_lsbmode(spi, 0);
if (status != MRAA_SUCCESS) {
goto err_exit;
}

j = 10;
while(j) {
j--;
printf("0x%x\n",mraa_spi_write(spi, 0xaa));
}
err_exit:
mraa_result_print(status);

/* stop spi */
mraa_spi_stop(spi);

/* deinitialize mraa for the platform (not needed most of the times) */
mraa_deinit();

return EXIT_FAILURE;
}
rock@rockpis:~/mraa-examples$ gcc -o test-spi test-spi.c -lmraa

Then short pin19 and pin21 and run test-spi

rock@rockpis:~/mraa-examples$ sudo ./test-spi
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
0xaa
MRAA: SUCCESS

===== ADC test =====

connect signal you want to measure, and then compile mraa example c file, aio.c, to test.

<pre>
rock@rockpis:~/mraa-examples$ gcc -o aio aio.c -lmraa
rock@rockpis:~/mraa-examples$ sudo ./aio
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
ADC A0 read 1A5 - 421
ADC A0 read float - 0.41153
</pre>

==== Development ====

More introduction of libmraa can look at [http://iotdk.intel.com/docs/master/mraa/index.html libmraa official website].

==== Troubleshooting ====

* Refer [[RockpiS/getting_started/troubleshooting | Troubleshooting page]]
* Post your issue on the forum: https://forum.radxa.com/c/rockpiS

Talk:Rockpi4/contribute

2020-05-11T09:36:13Z

SimenZhor:

I have just made a copy of this wiki page for the Rock Pi S wiki, but that's probably not the best idea. Can this entire page be moved to https://wiki.radxa.com/contribute as a general introduction to Wiki contributions? If it's moved there I think there needs to be a section describing the syntax for various wikis, for example:
<pre>
For Rock Pi 4 the template page (and other links) are on the following syntax: "Rockpi4", but in the wiki itself the syntax is "rockpi4".
For Rock Pi S the template page (and other links) are on the following syntax: "RockpiS", but in the wiki itself the syntax is "rockpiS".
</pre>

Any thoughts?
----

: I think we only need one contribution page and no need to duplicate the content since most of them are the same. Maybe we should add url/template of difference board in contribution page. Thanks for the contribution to the wiki btw. --[[User:hipboi| Tom Cubie]] @Shenzhen 9:13, 26 March 2020 (UTC)
----
:: I totally agree. That does sound like a good way to go. --[[User:SimenZhor| SimenZhor]] @Oslo 09:35, 11 May 2020 (UTC)

Talk:RockpiS/getting started

2020-05-11T09:32:52Z

SimenZhor: The described problem has been fixed

Talk:RockpiS/getting started

2020-03-26T09:01:15Z

SimenZhor: Created page with "The images at the top do not show the current hardware version of Rock Pi S (V12 / V1.2). Most notably the colored pin header is rotated 180 degrees, which can be confusing. D..."

The images at the top do not show the current hardware version of Rock Pi S (V12 / V1.2). Most notably the colored pin header is rotated 180 degrees, which can be confusing. Does anyone have high quality pictures of the V12 board?

Talk:Rockpi4/contribute

2020-03-26T08:57:29Z

SimenZhor: Created page with "I have just made a copy of this wiki page for the Rock Pi S wiki, but that's probably not the best idea. Can this entire page be moved to https://wiki.radxa.com/contribute as..."

RockpiS

2020-03-26T08:48:18Z

SimenZhor:

{{rockpiS_header}}

{{Languages|rockpiS}}

__NOTOC__

<div class="col-md-12 ">
<div class="col-md-8">

= ROCK Pi S=

S is for Small Square.

This is the documentation for ROCK Pi S, written by Radxa Team with community contributions.

ROCK Pi S is a Rockchip RK3308 based SBC(Single Board Computer) by Radxa. It equips a 64bits quad core processor, USB, ethernet, wireless connectivity and voice detection engine at the size of 1.7 inch, make it perfect for IoT and voice applications. ROCK Pi S comes in two ram sizes 256MB or 512MB DDR3, and uses uSD card for OS and storage. Optionally, ROCK Pi S can provide on board storage version with 1Gb/2Gb/4Gb/8Gb [[RockpiS/hardware/SDNAND |NAND flash]].

</div>

<div class="col-md-4">
[[File:Rockpi_s_yellow_1200px.png | 400px ]]
</div>
</div>

<div class="col-md-12 ">

<div class="col-md-6">
<div class="panel panel-mango-white">
<div class="panel-heading"> <h3 class="panel-title"><i class="fa fa-star"></i> [[community_updates | What's new]]</h3> </div>
<div class="panel-body">
{{community_updates}}
</div>
</div>
</div>

<div class="col-md-6">
<div class="panel panel-hearts-white">
<div class="panel-heading"> <h3 class="panel-title"><i class="fa fa-hand-o-up"></i> [[RockpiS/getting_started | Setup/Quick start ]]</h3> </div>
<div class="panel-body">
* [[RockpiS/getting_started | Getting started with ROCK Pi S]]
* [[RockpiS/hardware/rockpiS#gpio | GPIO pinout]]
* [[RockpiS/ssh | Connected ROCK Pi S via SSH]]
</div>
</div>
</div>

</div><div class="clearfix"></div>

<div class="col-md-12 ">

<div class="col-md-6 ">
<div class="panel panel-midnight-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-download"></i> [[RockpiS/install | Installation]]</h3></div>
<div class="panel-body">
Installing an operating system on your ROCK PI S, including microSD card, USB drive, etc.

* [[RockpiS/install/microSD | Install on microSD card]]
* [[RockpiS/dev/sdnand-install | Install on SD NAND Flash]]
* [[RockpiS/radxa-apt | Update from Radxa Apt]]
* [[RockpiS/partitions | Partition table]]

</div>
</div>
</div>

<div class="col-md-6 ">
<div class="panel panel-mango-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-cog"></i> [[RockpiS/dev | Development]]</h3></div>
<div class="panel-body">
Information about Linux development
* [[RockpiS/dev/sdnand-install | Install images to SD NAND flash]]
* [[RockpiS/dev/Debian | Build Debian]]
* [[RockpiS/dev/kernel-4.4 | Build vendor kernel(Rockchip 4.4)]]
* [[RockpiS/dev/serial-console | Serial Console]]
[[RockpiS/dev| > More...]]
</div>
</div>
</div>

</div><div class="clearfix"></div>

<div class="col-md-12 ">

<div class="col-md-6 ">
<div class="panel panel-cello-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-hdd-o"></i> [[RockpiS/hardware|Hardware]] </h3></div>
<div class="panel-body">
Technical specifications about the ROCK Pi S hardware, including WI-FI module, LCD module, etc.

* [[RockpiS/hardware/rockpiS | Main board]] - Hardware introduction of the ROCK Pi S
* [[RockpiS/hardware/gpio | GPIO]] - GPIO pinout&numbers
* [[rockpiS/hardware/models | Models and SKU]]

* [[RockpiS/hardware/display | Display]]

[[RockpiS/hardware| > More...]]

</div>
</div>
</div>

<div class="col-md-6 ">
<div class="panel panel-gunmetal-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-linux"></i> [[RockpiS/Debian Working With Linux | Working With Linux ]]</h3></div>
<div class="panel-body">
Fundamental Linux usage for beginners and more advanced information for power users.
* [[RockpiS/Debian | Debian]]
* [[RockpiS/Ubuntu | Ubuntu]]
* [[RockpiS/radxa-apt | Radxa APT]]
* [[RockpiS/downloads | Images official/3rd party/community]]
</div>
</div>
</div>

</div><div class="clearfix"></div>

<div class="col-md-12 ">

<div class="col-md-6 ">
<div class="panel panel-cocktail-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-question"></i> [[RockpiS/FAQs | FAQs]]</h3></div>
<div class="panel-body">
* Answers to frequently asked technical questions
* Answers to sale of ROCK Pi S
</div>
</div>
</div>

<div class="col-md-6 ">
<div class="panel panel-cocktail-white">
<div class="panel-heading"><h3 class="panel-title"><i class="fa fa-users"></i> Community</h3></div>
<div class="panel-body">
* Forum: http://forum.radxa.com
* Telegram Group: https://t.me/rockpi4
* Wiki contributions: [[RockpiS/contribute | How to contribute]]
</div>
</div>
</div>

</div><div class="clearfix"></div>

RockpiS/contribute

2020-03-26T08:43:33Z

SimenZhor: case sensitivity error in /* 3. Breadcrumb */

{{rockpiS_header}}
{{Languages|rockpiS/contribute}}

==About this wiki==

Radxa wiki is the place gathering info, guides and tutorial of Radxa products. The wiki is open to register and maintained by the community and Radxa team. Feel free to add/edit radxa product's related info on the wiki page. Most of the pages can be edited without permission, some pages the team think important are protected.

==How to edit==
# You must create an account to edit, check the top menu '''[https://wiki.radxa.com/mw/index.php?title=Special:UserLogin&returnto=RockpiS%2Fcontribute&type=signup Edit -> Personal -> Create account]'''. The forum account won't work.
# After logging in, you can edit the wiki page by clicking '''Edit -> Edit''' in the top menu.
# For the wiki syntax, please refer to [https://www.mediawiki.org/wiki/Help:Formatting wiki formatting]
# Always '''preview''' your edit before saving

==Special templates==

===1. Nav Bar===
Each product has its own nav bar for the user to find the content easier. To add that, include the following at the first line of the page:

<pre>
{{rockpiS_header}}
</pre>

The content of [[Template:RockpiS_header | rockpiS_header template]] is as below:

<pre>
<div class="col-md-12">
<div class="col-sm-12">
<ul class="nav nav-pills nav-tabs-lighter">
<li>[[rockpiS| Main]]</li>
<li>[[rockpiS/getting_started | Getting Started]]</li>
<li>[[rockpiS/hardware | Hardware]]</li>
<li>[[rockpiS/downloads | Downloads]]</li>
<li>[[rockpiS/FAQs | FAQs]]</li>
</ul>
</div>
</div>
</pre>

It looks like below:
----
{{rockpiS_header}}
----

You can also add the nav bar for other language by adding a new template, [[Template:RockpiS_header_es]] and [[Template:RockpiS_header_zh_cn]] is an example.

=== 2. Multiple Language ===
The wiki supports multiple language by using the [[Template:Languages | language template]]. If you want to add your language, edit [[Template:Languages | language template]] first. It's content as below:

<pre>
<div class="col-md-12">
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}|{{#language:en}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/zh_cn|{{#language:zh-cn}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/es_es|{{#language:es}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/de_DE|{{#language:de}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/pt_BR|{{#language:pt-br}}]]</div>
<div class="box-Title"></div>
</div>
</pre>

Add your language code as above and save the template.

Each page with multiple language support must include the template at the second line, next to the Nav Bar. The page name must be passed to the template after the | sign, example of the getting started page of ROCK Pi S:

<pre>
{{Languages|rockpi4/getting_started}}
</pre>

It will looks like this:
----
{{Languages|rockpi4/getting_started}}
----
Then click the language button to create/goto the ROCK Pi S getting started page of corresponding language.

'''Note:'''

When you translate a page, which has link to other page on the same wiki, you should add the country code in the url, so that the user will always jump to the destination page of the same language.

<pre>In English version, link to getting started page is [[RockpiS/getting_started]]</pre>
<pre>For the Simplified Chinese version, the link should be changed to [[RockpiS/getting_started/zh_cn]].</pre>

'''Remember:'''

* Germany content page url always ends with de_DE
* Simplified Chinese content page url always ends with zh_cn
* Spanish content page url always ends with es_es
* ...

===3. Breadcrumb===
If the page depth is deeper than 2, a breadcrumb should be added to the beginning of the page for the user to go back to the upper level page.

<pre>
[[rockpiS | ROCK Pi S]] > [[rockpiS/install | Install]] > [[rockpiS/install/microSD | Install on MicroSD]]
</pre>
It looks like this:

[[rockpiS | ROCK Pi S]] > [[rockpiS/install | Install]] > [[rockpiS/install/microSD | Install on MicroSD]]

==Community Contributions==
* HANLLEL translated the Spanish page.
* Beachtier translated the Germany page.

RockpiS/contribute

2020-03-26T08:41:36Z

SimenZhor: Copy of the contribution page of Rock Pi 4 - with changes necessary to make it relevant for Rock Pi S. It doesn't seem to me like the Rock Pi S wiki has any Template headers for other languages than English at the moment, so there are two links not workin

{{rockpiS_header}}
{{Languages|rockpiS/contribute}}

==About this wiki==

Radxa wiki is the place gathering info, guides and tutorial of Radxa products. The wiki is open to register and maintained by the community and Radxa team. Feel free to add/edit radxa product's related info on the wiki page. Most of the pages can be edited without permission, some pages the team think important are protected.

==How to edit==
# You must create an account to edit, check the top menu '''[https://wiki.radxa.com/mw/index.php?title=Special:UserLogin&returnto=RockpiS%2Fcontribute&type=signup Edit -> Personal -> Create account]'''. The forum account won't work.
# After logging in, you can edit the wiki page by clicking '''Edit -> Edit''' in the top menu.
# For the wiki syntax, please refer to [https://www.mediawiki.org/wiki/Help:Formatting wiki formatting]
# Always '''preview''' your edit before saving

==Special templates==

===1. Nav Bar===
Each product has its own nav bar for the user to find the content easier. To add that, include the following at the first line of the page:

<pre>
{{rockpiS_header}}
</pre>

The content of [[Template:RockpiS_header | rockpiS_header template]] is as below:

<pre>
<div class="col-md-12">
<div class="col-sm-12">
<ul class="nav nav-pills nav-tabs-lighter">
<li>[[rockpiS| Main]]</li>
<li>[[rockpiS/getting_started | Getting Started]]</li>
<li>[[rockpiS/hardware | Hardware]]</li>
<li>[[rockpiS/downloads | Downloads]]</li>
<li>[[rockpiS/FAQs | FAQs]]</li>
</ul>
</div>
</div>
</pre>

It looks like below:
----
{{rockpiS_header}}
----

You can also add the nav bar for other language by adding a new template, [[Template:RockpiS_header_es]] and [[Template:RockpiS_header_zh_cn]] is an example.

=== 2. Multiple Language ===
The wiki supports multiple language by using the [[Template:Languages | language template]]. If you want to add your language, edit [[Template:Languages | language template]] first. It's content as below:

<pre>
<div class="col-md-12">
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}|{{#language:en}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/zh_cn|{{#language:zh-cn}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/es_es|{{#language:es}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/de_DE|{{#language:de}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/pt_BR|{{#language:pt-br}}]]</div>
<div class="box-Title"></div>
</div>
</pre>

Add your language code as above and save the template.

Each page with multiple language support must include the template at the second line, next to the Nav Bar. The page name must be passed to the template after the | sign, example of the getting started page of ROCK Pi S:

<pre>
{{Languages|rockpi4/getting_started}}
</pre>

It will looks like this:
----
{{Languages|rockpi4/getting_started}}
----
Then click the language button to create/goto the ROCK Pi S getting started page of corresponding language.

'''Note:'''

When you translate a page, which has link to other page on the same wiki, you should add the country code in the url, so that the user will always jump to the destination page of the same language.

<pre>In English version, link to getting started page is [[RockpiS/getting_started]]</pre>
<pre>For the Simplified Chinese version, the link should be changed to [[RockpiS/getting_started/zh_cn]].</pre>

'''Remember:'''

* Germany content page url always ends with de_DE
* Simplified Chinese content page url always ends with zh_cn
* Spanish content page url always ends with es_es
* ...

===3. Breadcrumb===
If the page depth is deeper than 2, a breadcrumb should be added to the beginning of the page for the user to go back to the upper level page.

<pre>
[[rockpiS | ROCK Pi S]] > [[rockpiS/install | Install]] > [[rockpiS/install/MicroSD | Install on MicroSD]]
</pre>
It looks like this:

[[rockpiS | ROCK Pi S]] > [[rockpiS/install | Install]] > [[rockpiS/install/MicroSD | Install on MicroSD]]

==Community Contributions==
* HANLLEL translated the Spanish page.
* Beachtier translated the Germany page.

Rockpi4/contribute

2020-03-26T08:26:59Z

SimenZhor: Added a bit more information to /* How to edit */

{{rockpi4_header}}
{{Languages|rockpi4/contribute}}

==About this wiki==

Radxa wiki is the place gathering info, guides and tutorial of Radxa products. The wiki is open to register and maintained by the community and Radxa team. Feel free to add/edit radxa product's related info on the wiki page. Most of the pages can be edited without permission, some pages the team think important are protected.

==How to edit==
# You must create an account to edit, check the top menu '''[https://wiki.radxa.com/mw/index.php?title=Special:UserLogin&returnto=Rockpi4%2Fcontribute&type=signup Edit -> Personal -> Create account]'''. The forum account won't work.
# After logging in, you can edit the wiki page by clicking '''Edit -> Edit''' in the top menu.
# For the wiki syntax, please refer [https://www.mediawiki.org/wiki/Help:Formatting wiki fomatting]
# Always '''preview''' your edit bebfore save

==Special templates==

===1. Nav Bar===
Each product has its own nav bar for the user to find the content easier. To add that, include the following at the first line of the page:

<pre>
{{rockpi4_header}}
</pre>

The content of [[Template:Rockpi4_header | rockpi4_header template]] is as below:

<pre>
<div class="col-md-12">
<div class="col-sm-12">
<ul class="nav nav-pills nav-tabs-lighter">
<li>[[rockpi4| Main]]</li>
<li>[[rockpi4/getting_started | Getting Started]]</li>
<li>[[rockpi4/hardware | Hardware]]</li>
<li>[[rockpi4/downloads | Downloads]]</li>
<li>[[rockpi4/FAQs | FAQs]]</li>
</ul>
</div>
</div>
</pre>

It looks like below:
----
{{rockpi4_header}}
----

You can also add the nav bar for other language by adding a new template, [[Template:Rockpi4_header_es]] and [[Template:Rockpi4_header_zh_cn]] is an example.

=== 2. Multiple Language ===
The wiki supports multiple language by using the [[Template:Languages | language template]]. If you want to add your language, edit [[Template:Languages | language template]] first. It's content as below:

<pre>
<div class="col-md-12">
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}|{{#language:en}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/zh_cn|{{#language:zh-cn}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/es_es|{{#language:es}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/de_DE|{{#language:de}}]]</div>
<div class="btn btn-primary pull-right"><i class="fa fa-language"></i> [[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}/pt_BR|{{#language:pt-br}}]]</div>
<div class="box-Title"></div>
</div>
</pre>

Add your language code as above and save the template.

Each page with multiple language support must include the template at the second line, next to the Nav Bar. The page name must be passed to the template after the | sign, example of the getting started page of ROCK Pi 4:

<pre>
{{Languages|rockpi4/getting_started}}
</pre>

It will looks like this:
----
{{Languages|rockpi4/getting_started}}
----
Then click the language button to create/goto the ROCK Pi 4 getting started page of corresponding language.

'''Note:'''

When you translate a page, which has link to other page on the same wiki, you should add the country code in the url, so that the user will always jump to the destination page of the same language.

<pre>In English version, link to getting started page is [[Rockpi4/getting_started]]</pre>
<pre>For the Simplified Chinese version, the link should be changed to [[Rockpi4/getting_started/zh_cn]].</pre>

'''Remember:'''

* Germany content page url always ends with de_DE
* Simplified Chinese content page url always ends with zh_cn
* Spanish content page url always ends with es_es
* ...

===3. Breadcrumb===
If the page depth is deeper than 2, a breadcrumb should be added to the beginning of the page for the user to go back to the upper level page.

<pre>
[[rockpi4 | ROCK Pi 4]] > [[rockpi4/install | Install]] > [[rockpi4/install/eMMC | Install on eMMC module]]
</pre>
It looks like this:

[[rockpi4 | ROCK Pi 4]] > [[rockpi4/install | Install]] > [[rockpi4/install/eMMC | Install on eMMC module]]

==Community Contributions==
* HANLLEL translated the Spanish page.
* Beachtier translated the Germany page.

RockpiS/hardware/gpio

2020-03-26T08:15:15Z

SimenZhor: I added a note in the IO Voltage section about ADC input voltage

{{rockpiS_header}}
{{Languages|rockpi4/hardware/gpio}}

[[rockpiS | ROCK Pi S]] > [[rockpiS/hardware | Hardware]] > [[rockpiS/hardware/gpio | GPIO]]

== <span id="gpio">General purpose input-output (GPIO) connector</span> ==

ROCK Pi S has two 26-pin expansion header. Each pin is distinguished by color.

<div class="col-md-12 ">
<div class="panel panel-midnight-white">
<div class="panel-heading"><h3>Hardware V10</h3></div>
<div class="panel-body">

==== 26-pin Header 1 ====

{| class="mw-collapsible mw-collapsed wikitable"
! GPIO number || Func4 || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || Func4 || GPIO number
|-
| || || || || +3.3V || style="background:yellow"| 1 || ||style="background:red"| 2 || +5.0V || || ||| ||
|-
| 12 || || || I2C1_SCL || GPIO0_B4 || style="background:green; color:white"| 3 || || style="background:red"| 4 || +5.0V || || || ||
|-
| 11 || || || I2C1_SDA || GPIO0_B3 || style="background:green; color:white"| 5 || || style="background:black; color:white"| 6 || GND || || || ||
|-
| 69 || || || I2S0_SCLK_TX || GPIO2_A5 || style="background:green; color:white"| 7 || || style="background:green; color:white"| 8 || GPIO4_D3 || SDMMC_D3 || UART2_TX_M1 || PMU_ST3 || 155
|-
| 64 || || SPI0_MISO || style="background:orange"| UART0_RX || GPIO2_A0 || style="background:green; color:white"| 9 || || style="background:green; color:white"|10 || GPIO4_D2 || SDMMC_D2 || UART2_RX_M1 || PMU_ST2 || 154
|-
| 65 || || SPI0_MOSI || style="background:orange"|UART0_TX || GPIO2_A1 || style="background:green; color:white"|11 || || style="background:green; color:white"|12 || GPIO0_C0 || PWM3 || I2C3_SCL_M0 || || 16
|-
| 66 || I2C2_SDA || SPI0_CLK || UART0_CTSN || GPIO2_A2 || style="background:green; color:white"|13 || || style="background:black; color:white"|14 || GND || || || ||
|-
| 67 || I2C2_SCL || SPI0_CSN0 || UART0_RTSN || GPIO2_A3 || style="background:green; color:white"|15 || || style="background:green; color:white"|16 || GPIO2_A7 || I2S0_8CH_LRCK_TX || || || 71
|-
| || || || || +3.3V || style="background:yellow"|17 || || style="background:green; color:white"|18 || GPIO2_B1 || I2S0_8CH_SDO0 || || || 73
|-
| 55 || SPI2_MOSI || UART2_TX_M0 || UART1_RTSN || GPIO1_C7 || style="background:green; color:white"|19 || ||style="background:black; color:white"|20 || GND || || || ||
|-
| 54 || SPI2_MISO || UART2_RX_M0 || UART1_CTSN || GPIO1_C6 || style="background:green; color:white"|21 || || style="background:green; color:white"|22 || GPIO0_B6 || PWM1 || || || 14
|-
| 56 || SPI2_CLK || I2C0_SDA || UART1_RX || GPIO1_D0 || style="background:green; color:white"|23 || || style="background:green; color:white"|24 || GPIO1_D1 || UART1_TX || I2C0_SCL || SPI2_CSN0 || 57
|-
| || || || || GND || style="background:black; color:white"|25 || || style="background:green; color:white"|26 || GPIO0_B7 || PWM2 || I2C3_SDA_M0 || || 15
|}

'''Warning'''
* Pin#8 and Pin#10 cannot be used as GPIO, UART function pins since they are the data pins of SDMMC.

==== 26-pin Header 2 ====

{| class="mw-collapsible mw-collapsed wikitable"
! GPIO number || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || GPIO number
|-
| || || || GND || style="background:black; color:white"| 1 || ||style="background:black; color:white"| 2 || GPIO2_A6 || I2S0_8CH_SCLK_RX || PDM_CLK_S_M2 ||| 70
|-
| || || || ADC_KEY_IN1 || style="background:black; color:white"| 3 || || style="background:black; color:white"| 4 || GPIO2_B5 || I2S0_8CH_SDI0 || PDM_SDI0_M2 || 77
|-
| || || || MICBIAS2 || style="background:black; color:white"| 5 || || style="background:black; color:white"| 6 || GPIO2_B6 || I2S0_8CH_SDI1 || PDM_SDI1_M2 || 78
|-
| || || || MICBIAS1 || style="background:black; color:white"| 7 || || style="background:black; color:white"| 8 || GPIO2_B7 || I2S0_8CH_SDI2 || PDM_SDI2_M2 || 79
|-
| || || || MICN8 || style="background:black; color:white"| 9 || || style="background:black; color:white"|10 || MCIP8 || || ||
|-
| || || || MICN7 || style="background:black; color:white"|11 || || style="background:black; color:white"|12 || MCIP7 || || ||
|-
| || || || MICN6 || style="background:black; color:white"|13 || || style="background:black; color:white"|14 || MCIP6 || || ||
|-
| || || || MICN5 || style="background:black; color:white"|15 || || style="background:black; color:white"|16 || MCIP5 || || ||
|-
| || || || MICN4 || style="background:black; color:white"|17 || || style="background:black; color:white"|18 || MCIP4 || || ||
|-
| || || || MICN3 || style="background:black; color:white"|19 || ||style="background:black; color:white"|20 || MCIP3 || || ||
|-
| || || || MICN2 || style="background:black; color:white"|21 || || style="background:black; color:white"|22 || MCIP2 || || ||
|-
| || || || MICN1 || style="background:black; color:white"|23 || || style="background:black; color:white"|24 || MCIP1 || || ||
|-
| || || || LINEOUT_R || style="background:black; color:white"|25 || || style="background:black; color:white"|26 || LINEOUT_L || || ||
|}
</div>
</div>
</div>

<div class="clearfix"></div>

==== More details about V10 Headers ====

* Pins marked with color orange are designed for default debug console.
* PWM: x3, PWM1/PWM2/PWM3
* SPI: x2, SPI0/SPI2
* I2C: x4, I2C0/I2C1/I2C2/I2C3
* UART: x3, UART0/UART1/UART2

<div class="col-md-12 ">
<div class="panel panel-midnight-white">
<div class="panel-heading"><h3>Hardware V11</h3></div>
<div class="panel-body">

==== 26-pin Header 1 ====

{| class="mw-collapsible mw-collapsed wikitable"
! GPIO number || Func4 || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || Func4 || GPIO number
|-
| || || || || +3.3V || style="background:yellow"| 1 || ||style="background:red"| 2 || +5.0V || || ||| ||
|-
| 11 || || || I2C1_SDA || GPIO0_B3 || style="background:green; color:white"| 3 || || style="background:red"| 4 || +5.0V || || || ||
|-
| 12 || || || I2C1_SCL || GPIO0_B4 || style="background:green; color:white"| 5 || || style="background:black; color:white"| 6 || GND || || || ||
|-
| 69 || || || I2S0_SCLK_TX || GPIO2_A5 || style="background:green; color:white"| 7 || || style="background:green; color:white"| 8 || GPIO2_A1 || style="background:orange"|UART0_TX || SPI0_MOSI || || 65
|-
| || || || || GND || style="background:black; color:white"| 9 || || style="background:green; color:white"|10 || GPIO2_A0 || style="background:orange"|UART0_RX || SPI0_MISO || || 64
|-
| 15 || || I2C3_SDA_M0 || PWM2 || GPIO0_B7 || style="background:green; color:white"|11 || || style="background:green; color:white"|12 || GPIO2_A2 || UART0_CTSN || SPI0_CLK || I2C2_SDA || 66
|-
| 16 || || I2C3_SCL_M0 || PWM3 || GPIO0_C0 || style="background:green; color:white"|13 || || style="background:black; color:white"|14 || GND || || || ||
|-
| 17 || || || SPDIF_TX || GPIO0_C1 || style="background:green; color:white"|15 || || style="background:green; color:white"|16 || GPIO2_A3 || UART0_RTSN || SPI0_CSN0 || I2C2_SCL || 67
|-
| || || || || +3.3V || style="background:yellow"|17 || || style="background:green; color:white"|18 || GPIO2_B1 || I2S0_8CH_SDO0 || || || 73
|-
| 55 || SPI2_MOSI || UART2_TX_M0 || UART1_RTSN || GPIO1_C7 || style="background:green; color:white"|19 || ||style="background:black; color:white"|20 || GND || || || ||
|-
| 54 || SPI2_MISO || UART2_RX_M0 || UART1_CTSN || GPIO1_C6 || style="background:green; color:white"|21 || || style="background:green; color:white"|22 || GPIO0_B6 || PWM1 || || || 14
|-
| 56 || SPI2_CLK || I2C0_SDA || UART1_RX || GPIO1_D0 || style="background:green; color:white"|23 || || style="background:green; color:white"|24 || GPIO1_D1 || UART1_TX || I2C0_SCL || SPI2_CSN0 || 57
|-
| || || || || GND || style="background:black; color:white"|25 || || style="background:green; color:white"|26 || ADC_IN0 || || || ||
|}

==== 26-pin Header 2 ====

{| class="mw-collapsible mw-collapsed wikitable"
! GPIO number || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || GPIO number
|-
| || || || GND || style="background:black; color:white"| 1 || ||style="background:black; color:white"| 2 || GPIO2_A6 || I2S0_8CH_SCLK_RX || PDM_CLK_S_M2 ||| 70
|-
| || || || ADC_KEY_IN1 || style="background:black; color:white"| 3 || || style="background:black; color:white"| 4 || GPIO2_B5 || I2S0_8CH_SDI0 || PDM_SDI0_M2 || 77
|-
| || || || MICBIAS2 || style="background:black; color:white"| 5 || || style="background:black; color:white"| 6 || GPIO2_B6 || I2S0_8CH_SDI1 || PDM_SDI1_M2 || 78
|-
| || || || MICBIAS1 || style="background:black; color:white"| 7 || || style="background:black; color:white"| 8 || GPIO2_B7 || I2S0_8CH_SDI2 || PDM_SDI2_M2 || 79
|-
| || || || MICN8 || style="background:black; color:white"| 9 || || style="background:black; color:white"|10 || MCIP8 || || ||
|-
| || || || MICN7 || style="background:black; color:white"|11 || || style="background:black; color:white"|12 || MCIP7 || || ||
|-
| || || || MICN6 || style="background:black; color:white"|13 || || style="background:black; color:white"|14 || MCIP6 || || ||
|-
| || || || MICN5 || style="background:black; color:white"|15 || || style="background:black; color:white"|16 || MCIP5 || || ||
|-
| || || || MICN4 || style="background:black; color:white"|17 || || style="background:black; color:white"|18 || MCIP4 || || ||
|-
| || || || MICN3 || style="background:black; color:white"|19 || ||style="background:black; color:white"|20 || MCIP3 || || ||
|-
| || || || MICN2 || style="background:black; color:white"|21 || || style="background:black; color:white"|22 || MCIP2 || || ||
|-
| || || || MICN1 || style="background:black; color:white"|23 || || style="background:black; color:white"|24 || MCIP1 || || ||
|-
| || || || LINEOUT_R || style="background:black; color:white"|25 || || style="background:black; color:white"|26 || LINEOUT_L || || ||
|}
</div>
</div>
</div>

<div class="clearfix"></div>

==== More details about V11 Headers ====

* Pins marked with color orange are designed for default debug console.
* PWM: x3, PWM1/PWM2/PWM3
* SPI: x2, SPI0/SPI2
* I2C: x4, I2C0/I2C1/I2C2/I2C3
* UART: x3, UART0/UART1/UART2
* ADC: x1, ADC_IN0. The max input voltage is 1.8V.

<div class="col-md-12 ">
<div class="panel panel-midnight-white">
<div class="panel-heading"><h3>Hardware V12</h3></div>
<div class="panel-body">

==== 26-pin Header 1 ====

{| class="mw-collapsible wikitable"
! GPIO number || Func4 || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || Func4 || GPIO number
|-
| || || || || +3.3V || style="background:yellow"| 1 || ||style="background:red"| 2 || +5.0V || || ||| ||
|-
| 11 || || || I2C1_SDA || GPIO0_B3 || style="background:green; color:white"| 3 || || style="background:red"| 4 || +5.0V || || || ||
|-
| 12 || || || I2C1_SCL || GPIO0_B4 || style="background:green; color:white"| 5 || || style="background:black; color:white"| 6 || GND || || || ||
|-
| 68 || || PDM_CLK_M_M2 || I2S0_8CH_MCLK || GPIO2_A4 || style="background:green; color:white"| 7 || || style="background:green; color:white"| 8 || GPIO2_A1 || style="background:orange"|UART0_TX || SPI0_MOSI || || 65
|-
| || || || || GND || style="background:black; color:white"| 9 || || style="background:green; color:white"|10 || GPIO2_A0 || style="background:orange"|UART0_RX || SPI0_MISO || || 64
|-
| 15 || || I2C3_SDA_M0 || PWM2 || GPIO0_B7 || style="background:green; color:white"|11 || || style="background:green; color:white"|12 || GPIO2_A5 || I2S0_8CH_SCLK_TX || || || 69
|-
| 16 || || I2C3_SCL_M0 || PWM3 || GPIO0_C0 || style="background:green; color:white"|13 || || style="background:black; color:white"|14 || GND || || || ||
|-
| 17 || || || SPDIF_TX || GPIO0_C1 || style="background:green; color:white"|15 || || style="background:green; color:white"|16 || GPIO2_B2 || I2S0_8CH_SDO1 || || || 74
|-
| || || || || +3.3V || style="background:yellow"|17 || || style="background:green; color:white"|18 || GPIO2_B1 || I2S0_8CH_SDO0 || || || 73
|-
| 55 || SPI2_MOSI || UART2_TX_M0 || UART1_RTSN || GPIO1_C7 || style="background:green; color:white"|19 || ||style="background:black; color:white"|20 || GND || || || ||
|-
| 54 || SPI2_MISO || UART2_RX_M0 || UART1_CTSN || GPIO1_C6 || style="background:green; color:white"|21 || || style="background:green; color:white"|22 || GPIO2_A7 || I2S0_8CH_LRCK_TX || || || 71
|-
| 56 || SPI2_CLK || I2C0_SDA || UART1_RX || GPIO1_D0 || style="background:green; color:white"|23 || || style="background:green; color:white"|24 || GPIO1_D1 || UART1_TX || I2C0_SCL || SPI2_CSN0 || 57
|-
| || || || || GND || style="background:black; color:white"|25 || || style="background:green; color:white"|26 || ADC_IN0 || || || ||
|}

==== 26-pin Header 2 ====

{| class="mw-collapsible wikitable"
! GPIO number || Func3 || Func2 || Func1 || Pin# || || Pin# || Func1 || Func2 || Func3 || GPIO number
|-
| || || || GND || style="background:black; color:white"| 1 || ||style="background:black; color:white"|2 || GPIO2_B5 || I2S0_8CH_SDI0 || PDM_SDI0_M2 ||| 77
|-
| || || || ADC_KEY_IN1 || style="background:black; color:white"| 3 || || style="background:black; color:white"|4 || GPIO2_B6 || I2S0_8CH_SDI1 || PDM_SDI1_M2 || 78
|-
| || || || MICBIAS2 || style="background:black; color:white"| 5 || || style="background:black; color:white"|6 || GPIO2_B7 || I2S0_8CH_SDI2 || PDM_SDI2_M2 || 79
|-
| || || || MICBIAS1 || style="background:black; color:white"| 7 || || style="background:black; color:white"|8 || GPIO2_C0 || I2S0_8CH_SDI3 || PDM_SDI3_M2 || 80
|-
| || || || MICN8 || style="background:black; color:white"| 9 || || style="background:black; color:white"|10 || MCIP8 || || ||
|-
| || || || MICN7 || style="background:black; color:white"|11 || || style="background:black; color:white"|12 || MCIP7 || || ||
|-
| || || || MICN6 || style="background:black; color:white"|13 || || style="background:black; color:white"|14 || MCIP6 || || ||
|-
| || || || MICN5 || style="background:black; color:white"|15 || || style="background:black; color:white"|16 || MCIP5 || || ||
|-
| 76 || || I2S0_8CH_SDO3 || GPIO2_B4 || style="background:black; color:white"|17 || || style="background:black; color:white"|18 || GPIO2_B3 || I2S0_8CH_SDO2 || || 75
|-
| 72 || || I2S0_8CH_LRCK_RX || GPIO2_B0 || style="background:black; color:white"|19 || ||style="background:black; color:white"|20 || GPIO2_A6 || I2S0_8CH_SCLK_RX || PDM_CLK_S_M2 || 70
|-
| || || || MICN2 || style="background:black; color:white"|21 || || style="background:black; color:white"|22 || MCIP2 || || ||
|-
| || || || MICN1 || style="background:black; color:white"|23 || || style="background:black; color:white"|24 || MCIP1 || || ||
|-
| || || || LINEOUT_R || style="background:black; color:white"|25 || || style="background:black; color:white"|26 || LINEOUT_L || || ||
|}

</div>
</div>
</div>

==== More details about V12 Headers ====

* Pins marked with color orange are designed for default debug console.
* PWM: x2, PWM2/PWM3
* SPI: x1, SPI2
* I2C: x3, I2C0/I2C1/I2C3
* UART: x3, UART0/UART1/UART2
* ADC: x1, ADC_IN0. The max input voltage is 1.8V.

== IO Voltage ==
RK3308 have two IO voltages, '''1.8V/3.3V'''. For ROCK Pi S, the voltage level of GPIOs showed in the tables above are '''3.3V''' and tolerance of those are '''3.63V'''. For hardware V11 and V12, an ADC input is included (ADC_IN0). This ADC has an input voltage range of '''0-1.8V'''.

== GPIO number ==
Rockchip RK3308 GPIO has 5 banks, GPIO0 to GPIO4, each bank has 32pins, naming as below:

GPIO0_A0 ~ A7
GPIO0_B0 ~ B7
GPIO0_C0 ~ C7
GPIO0_D0 ~ D7

GPIO1_A0 ~ A7
....
GPIO1_D0 ~ D7

For Rockchip 4.4 kernel, the GPIO number can be calculated as below, take GPIO4_D3(PIN8 on 26PIN GPIO) as an example:

GPIO4_D3 = 32*4 + 8*3 + 3 = 155

To set GPIO4_D3 output

cd /sys/class/gpio
echo 155 > export
cd gpio155
echo out > direction
echo 1 > value # output high
echo 0 > value # output low