Radxa Wiki - User contributions [en]

RockpiE/dev/serial-console

2020-08-23T14:37:20Z

Masa: /* Setup minicom */ Correct configuration file name

{{rockpiE_header}}
{{Languages|rockpiE/dev/serial-console}}
[[rockpiE | ROCK Pi E]] > [[rockpiE/dev | Development]] > [[rockpiE/dev/serial-console | Serial Console]]

ROCK Pi E exports a dedicated serial console, which can access the low level debug message.

=== Requirement ===

* ROCK Pi E
* USB Type-C power adapter and USB Type-C cable
* Host PC with Windows or Linux
* USB to TTL serial cable
** The definition of each pin of USB to TTL cable is showing like this:

[[File:usb2ttl-cable-definition.jpeg | 500px ]]

==== Note ====

* The default baudrate of ROCK Pi E is 1500000(1.5Mbps), please check if your USB to TTL cable support 1.5Mbps baudrate. Some model of [https://www.silabs.com/products/interface/usb-bridges CP210X] and [http://www.prolific.com.tw/US/ShowProduct.aspx?pcid=41 PL2303x] have baudrate limitation, please check the specified model. We also tested that some cheap PL2303x based cable does not work well. Make sure choose a high quality one. The instructions below use a [http://www.ftdichip.com/Products/ICs/FT232R.htm FT232RL] based cable.

* It seems that the serial tool on macOS platform can not support custom baudrate such as 1.5Mbps due to driver restriction. If you know how to set custom baudrate on macOS, please add an item here to show your findings.

=== Connection ===

Connect the USB to TTL serial cable as below. '''Don't connect the red wire.'''

* ROCK Pi E V10 Board and later

{| class="wikitable"
|-
! ROCK Pi E || <---> || USB to TTL cable
|-
| RX(pin 10) || <---> || Green wire
|-
| TX(pin 8) || <---> || White wire
|-
| GND(pin 6) || <---> || Black wire
|}

=== Serial setting on host PC ===

The default serial setting for ROCK Pi E u-boot and kernel console is:

baudrate: 1500000
data bit: 8
stop bit: 1
parity : none
flow control: none

==== Linux ====

Minicom is the serial tool that supports wide range baud rate.

Install minicom:

sudo apt-get update
sudo apt-get install minicom

Plug in the USB to TTL cable, kernel `dmesg | tail` should show the following device:

[1036835.654076] usb 1-6.4.3: new full-speed USB device number 103 using xhci_hcd
[1036835.755730] usb 1-6.4.3: New USB device found, idVendor=0403, idProduct=6001
[1036835.755732] usb 1-6.4.3: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[1036835.755733] usb 1-6.4.3: Product: USB <-> Serial
[1036835.755734] usb 1-6.4.3: Manufacturer: FTDI
[1036835.756728] ftdi_sio 1-6.4.3:1.0: FTDI USB Serial Device converter detected
[1036835.756750] usb 1-6.4.3: Detected FT232BM
[1036835.757195] usb 1-6.4.3: FTDI USB Serial Device converter now attached to ttyUSB0

'''/dev/ttyUSB0''' is our device here.

===== Setup minicom=====

First add current user to plugdev group to use minicom without sudo or root.

sudo usermod -a -G plugdev $USER

Edit your '''~/.bashrc''' and add the following line with some default parameter

alias minicom='minicom -w -t xterm -l -R UTF-8'

Login to a new terminal to take effect.

Create and edit file '''~/.minirc.rockpiE''', add the following content:

pu port /dev/ttyUSB0
pu baudrate 1500000
pu bits 8
pu parity N
pu stopbits 1
pu rtscts No

Now run '''minicom rockpiE''' to use the config above and connects to the ROCK Pi E serial console.

==== Windows ====

Putty is also great serial tool that supports wide range baud rate.

Plug in the USB to TTL cable to you windows PC. Viewing the '''device manager''' you can find the '''COM number'''. Here it is '''COM3'''.

Launch the application Putty on your windows PC. And do the setting as follows:

For category '''Session''', set '''serial line''' as COM3, '''speed''' ad 1500000, '''connection type''' as Serial.

Write '''rockpiE''' in the '''Saved Sessions''' column and press '''Save'''.

[[File:putty-setting-session.jpg | 500px ]]

For category '''Connection---Serial''', do the setting:

[[File:putty-setting-serial.jpg | 500px ]]

Once finish the setting, press '''Open''' button to start.

=== FAQs ===

====1.While using debug console, there is system startup information on the screen, but the keyboard cannot be used to input text?====

One of the reason would be the wrong setting of the serial tool, such as the Hardware Flow Control, etc. Here we should disable the Hardware Flow Control.

=== Troubleshooting ===
* Post your issue at the forum: https://forum.radxa.com/c/dev

RockpiE/FAQs

2020-08-22T15:22:04Z

Masa: /* Some Bluetooth devices are discoveried, but failed to connect to them on ROCK Pi E? */ fix typo "discoveried" -> "discovered"

{{rockpiE_header}}

{{Languages|rockpiE}}

==OS==
=== What OS is ROCK Pi E running? ===
: Currently we have Debian Buster, Ubuntu Bionic, etc, running on ROCK Pi E.

=== Can I ssh to ROCK Pi E running official Debian/Ubuntu? ===
: Yes, you can. The ROCK Pi E is shown as '''rockpie.local''' in your local network. Check out the [[RockpiE/getting_started/troubleshooting#Using_SSH | Using SSH]] page.

=== Where is the Radxa APT sources list? ===
: Check file /etc/apt/sources.list.d/apt-radxa-com.list.

=== Some Bluetooth devices are discovered, but failed to connect to them on ROCK Pi E? ===
: One of the reason is the weak signal. To gain a stronger signal, you need an antenna attached to the antenna socket on board.

RockpiE/Ubuntu

2020-08-22T14:20:40Z

Masa: /* Introduction to ROCK Pi E Ubuntu */ fix a typo "UBuntu" -> "Ubuntu"

{{rockpiE_header}}

{{Languages|rockpiE/Ubuntu}}

[[rockpiE | ROCK Pi E]] > [[rockpiE/Ubuntu | Ubuntu]]

__TOC__

== Work with ROCK Pi E Ubuntu ==

=== Introduction to ROCK Pi E Ubuntu ===

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

ROCK Pi E Debian uses '''systemd''' to manage system.

Here Need one '''USB to TTL serial cable'''. Or use '''SSH'''.

=== UBuntu Default User Account ===

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

=== Install and update necessary packages ===

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

Install packages;

$ sudo apt-get update
$ sudo apt-get install -y rockchip-overlay
$ sudo apt-get install -y linux-4.4-rockpie-latest

=== Network Connection ===

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

==== Ethernet Connection ====

ROCK Pi E provides dual ethernets. You can use two network cables at the same time to connect your ROCK Pi E to the network. The ROCK Pi E 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 two network cards, eth0 and eth1, and the Ethernet IP address. Also, use tool, ping, to connect to a normal domain.

$ ifconfig
$ ping -I eth0 www.baidu.com
$ ping -I eth1 www.baidu.com

==== WiFi Connection ====

When there is not a network cable for your ROCK Pi E the WIFI connection is another good choice. ROCK Pi E supports 2.4G/5G 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 ===

To gain a stronger signal, you need an antenna attached to the antenna socket on board.

Update necessary packages

$ sudo apt-get update
$ sudp apt-get install -y rockchip-overlay
$ sudo apt-get install -y linux-4.4-rockpie-latest # kernel version(>=4.4.194-7-rockchip)
$ sudo apt-get install -y realtek-bt-firmware bluez

Check Bluetooth service

$ systemctl status bluetooth

Run Bluetooth service if the Bluetooth service is inactive.

$ systemctl start bluetooth

Start realtek-btfw-load service

$ systemctl start realtek-btfw-load

Check Bluetooth device

$ hciconfig
root@rockpie:~# hciconfig
hci0: Type: Primary Bus: USB
BD Address: 7C:A7:B0:22:82:C5 ACL MTU: 1021:8 SCO MTU: 255:12
UP RUNNING PSCAN
RX bytes:5120 acl:0 sco:0 events:100 errors:0
TX bytes:2904 acl:0 sco:0 commands:74 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, SPI, UART, etc ===

The ROCK Pi E system images use /boot/uEnv.txt to configure hardware interfaces.

Remember there is only one line including item "overlays=" in file /boot/uEnv.txt.

For more details about device tree overlays, see [[Device-tree-overlays | Device Tree Overlays]].

==== I2C ====

To enable I2C-1 (/dev/i2c-1), add item "rk3328-i2c1" to the "overlays=" line.

overlays=rk3328-i2c1

==== SPI ====

To enable SPI0, add item "rk3328-spi-spidev" to the "overlays=" line.

overlays=rk3328-spi-spidev
param_spidev_spi_bus=0
param_spidev_spi_cs=0
param_spidev_max_freq=10000000

==== UART ====

The debugger console baud rate options: 1500000n8 and 115200n8.

To set ttyS1 as debugger console, add item "rk3328-uart1" to the "overlays=" line. Also need to set console value.

console=ttyS1,1500000n8
overlays=rk3328-uart1

To set ttyS2 as debugger console, add item "rk3328-uart2" to the "overlays=" line. Also need to set console value.

console=ttyS2,1500000n8
overlays=rk3328-uart2

To set ttyS1 as common serial communication, add item "rk3328-uart1" to the "overlays=" line. The device /dev/ttyS1 is available.

overlays=rk3328-uart1

To set ttyS2 as common serial communication, add item "rk3328-uart2" to the "overlays=" line. The device /dev/ttyS2 is available.

overlays=rk3328-uart2

=== Changelogs ===

==== 2020.07.17 ====

'''rockpie_ubuntu_bionic_minimal_arm64_20200717_0225-gpt.img'''

* Rename Wi-Fi interface to wlan0

==== 2020.06.16 ====

'''rockpie_ubuntu_bionic_minimal_arm64_20200615_1238-gpt.img'''

* Fix the issue of failing to find root device. System boot log may show like this.

[ 3.345451] RAMDISK: incomplete write (3154 != 27844)
[ 3.345455] write error
[ 3.345526] Waiting for root device UUID=f19f09a0-c5b2-4753-853b-584c9e6c27c6...

* Update rockchip-overlay package

==== 2020.05.28 ====

'''rockpie_ubuntu_bionic_minimal_arm64_20200528_0711-gpt.img'''

* Automatically load Bluetooth firmware after system startup.
* Available for at least 256 MB DDR SDRAM
* Default non-root user: rock (password: rock)
* Default serial console: UART2
* Hostname: rockpie
* Kernel version: 4.4.194-12-rockchip-g615ae7431150
* Resize root filesystem to fit available disk space for the first boot
* System partitions: boot and rootfs
* Support SSH by default.
* Support uEnv and boot.scr
* The version of systemd: 237
* U-boot version: 2019.10-11661-g46695f4700

RockpiE/getting started

2020-08-22T14:10:10Z

Masa: /* 3. Boot the board */ fix a typo "dtorage" -> "storage"

{{rockpiE_header}}
{{Languages|rockpiE/getting_started}}

[[rockpiE | ROCK Pi E]] > [[rockpiE/getting_started | Getting started]]

__TOC__

This guide is designed for ROCK Pi E enthusiast. The purpose is to learn about the ROCK Pi E board as well as how to prepare and set up for basic use. When you get a board, you need to know what Pi model it is and which hardware version it is. The information is printed in the top side of the board. We will introduce the board information as much as possible.

== What you need ==

=== Necessary ===
* ROCK Pi E main board

* One of the Storage media below:
** μSD card, larger than 8GB.
** eMMC Module, larger than 8GB with eMMC to μSD converter board.

* Power supply
** The ROCK Pi E is powered by adapter with type C port and '''5V only'''. If you power adapter supports USB PD, it's safe to power ROCK Pi E.

*USB to TTL serial cable
**ROCK Pi E exports a dedicated serial console, which can access the low level debug message.

=== Optional ===
* ROCKPi eMMC USB Reader
** For flashing the system image to eMMC Module.

* μSD Card Reader with eMMC to uSD board
** For flashing the system image to μSD Card or eMMC Module.

* Ethernet cable
** ROCK Pi E supports Internet access via WiFi or Ethernet.
** One or two Ethernet cable are used to connect your ROCK Pi E to a local network and the Internet.

* Audio cable
** Audio can be played through speaker or headphones using a standard 3.5mm jack.

== Close look of ROCK Pi E ==
* ROCK Pi E front view
[[File:rockpie_view_front.jpg|700px]]
* ROCK Pi E front with an angle view
[[File:rockpie_view_angle.jpg|700px]]
* ROCK Pi E back view
[[File:rockpie_view_back.jpg|700px]]

== Features ==

{| class="wikitable"
! Model
! colspan="1" | ROCK Pi E
|-
! Processor
| colspan="2" | SoC RK3328 Quad Cortex-A53 ARM 64bits processor frequency up to 1.3GHz
|-
! Memory
| colspan="2" | 256MB / 512MB / 1GB / 2GB DDR3
|-
! Storage
| colspan="2" | MicroSD(TF) up to 128GB High performance eMMC module 16GB / 32GB / 64GB / 128GB
|-
! Wireless
| colspan="2" | 802.11 b/g/n wifi Bluetooth 4.0(rtl8723du/rtl8821cu) external antenna
|-
! USB
| colspan="2" | USB3.0 Type-A HOST x1
|-
!| Key
| colspan="2" | Reset key x1 Maskrom key x1
|-
! Ethernet
| colspan="2" | 1x 1000Mbit ethernet, optional PoE(additional HAT required) 1x 100Mbit ethernet
|-
! IO
| colspan="2" | 40-pin expansion header USB 2.0 x1 I2C x1 SPI x1 UART x2 I2S x1 5V DC power in x2 3.3V DC power in x2
|-
! Others
| colspan="2" | LEDs
|-
! Power
| colspan="2" | USB Type-C DC 5V
|-
! Size
| colspan="2" | 2.5x2.2 inch(56x65mm)
|}

__TOC__

== Starting the board for the first time ==

ROCK Pi E can be started with eMMC Module or μSD Card. Now, you are presented with three options when installing your new operating system onto your ROCK Pi E.

=== Prepare ===
* When starting system with eMMC Module
(Option a) Inster the eMMC Module into ROCK Pi eMMC USB Reader. Then plug the ROCK Pi eMMC USB Reader into host PC.

(Option b) Insert eMMC Module into eMMC to μSD card converter board. Insert the converter board into μSD Card Reader. Then plug the Card Reader into host PC.

* When starting system with μSD Card
(Option c) Insert the μSD Card into μSD Card Reader. Then plug the Card Reader into host PC.

=== Write Image ===

* Download the official Ubuntu/Debian system image from [[rockpiE/downloads | Downloads]].

* Download the flash tool, etcher, from [[rockpiE/downloads | Downloads]]. Choose the right version for your host operation system. Here we operate on host Ubuntu 16.04.

* After unpacking the package, we run the tool by executing the command

$ ./etcher-etcher-electron-1.4.5-x86_64.AppImage

If you get an error message: "No polkit authentication agent found" you can try and start it with sudo, but do know that this is running the tool as '''root'''.

* In the etcher window, click '''Select image'''.

[[File:linux_etcher_select_image.png]]

* In the etcher window, click '''Select Drive'''.

[[File:linux_etcher_select_driver.png]]

* In the etcher window, click '''Flash'''.

[[File:linux_etcher_select_flash_button.png]]

* In the etcher window, once it shows us Flash Complete! It is done and can be put into the RockPi.

[[File:linux_etcher_show_complete.png]]

=== 3. Boot the board ===

* Now insert the system storage media, uSD Card or eMMC Module into the socket on the board.

* (Optional) Use the USB to TTL serial cable to setup a connection between PC and ROCK Pi E board. See [[rockpiE/dev/serial-console | Serial Console]].

* Power on ROCK Pi E by adapter with type C port. The input voltage should be 5V.

* ROCK Pi E will boot with the green power Led on. And after a while, the another green Led starts blinking.

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

==== Option 1: Serial console ====

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

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

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

To access ROCK Pi E by SSH, try

ping rockpie.local
ssh rock@rockpie.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 E ip address.

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

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

=== 5.Network state ===

*Look at network configure:

$ sudo ifconfig

*Test network:

$ ping -c 5 www.google.com

=== 6.WIFI Connection ===

Check [[rockpiE/Debian#WIFI Connection| WIFI Connection]].

=== 7.Bluetooth ===

Check [[rockpiE/Debian#Bluetooth| Bluetooth]].

=== 8.LED ===

ROCK Pi E has Power LED and User LED.

* Power LED

The power LED is green. It is always on when ROCK Pi E is given power by default,

* User LED

The user LED is green. By default, its blink status shows the running kernel.

=== 9.GPIO ===

ROCK Pi E has one 40-pin expansion headers. Each pin is distinguished by color, more information click [https://wiki.radxa.com/RockpiE/hardware/gpio here]

Development for GPIO. ROCK Pi E supports libmraa GPIO library, click [[RockpiE/dev/libmraa | here]] to get more information.

== Next Step ==

* [[RockpiE/Debian | More Debian image usage and tips]]
* [[RockpiE/Ubuntu | More Ubuntu image usage and tips]]
* [[RockpiE/hardware | Checkout the hardware details]]
* Join the [https://forum.radxa.com/c/rockpie community] and the [https://t.me/rockpi4 discussion group]

== Troubleshooting ==

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