Difference between revisions of "RockpiS/getting started"

Revision as of 09:07, 4 February 2020

    ROCK Pi S >  Getting started

This guide is designed for ROCK Pi S enthusiast. The purpose is to learn about the ROCK Pi S board as well as how to prepare and set up for basic use. We will introduce the board information as much as possible.

What you need

Necessary

• ROCK Pi S main board

• One of the Storage media below:
  • μSD card, larger than 8GB.

• USB type C to type A cable
  • For both power and USB communication(adb/fastboot) with HOST PC.

• PC/Laptop which has USB ports
  • The ROCK Pi S can be powered from the PC/Laptop USB ports directly

Optional

• Power adapter
  • If you want to power ROCK Pi S standalone, you can use 5V/1A or 5V/2A power adapter with USB C ports. You can also use the USB PD/QC power adapter without worrying damage the board because the PD/QC adapter will detect ROCK Pi S only supports 5V so the adapter will output 5V.

• μSD Card Reader
  • For flashing the image into μSD Card.

• USB to TTL serial cable
  • For serial console, low level troubleshooting, development etc.

• Ethernet cable
  • ROCK Pi S supports Internet access via WIFI or Ethernet.
  • An Ethernet cable is used to connect your ROCK Pi S to a local network and the Internet.

Close look of ROCK Pi S

• ROCK Pi S front view

• ROCK Pi S front with an angle view

• ROCK Pi S back view

Features

Starting the board for the first time

ROCK Pi S can be started with μSD Card.

1. Prepare the image

• When start system with μSD Card

Insert the μSD Card into μSD Card Reader, which connects to host computer.

2. Write Image to uSD card

• Download the flash tool, etcher, from 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.

• In the etcher window, click Select Drive.

• In the etcher window, click Flash.

• In the etcher window, once it shows us Flash Complete! It is done and can be put into the ROCK Pi S.

3. Boot the board

• Now insert the uSD card to the board.

• Use a USB C to USB A cable, connect the board to your PC

• ROCK Pi S will boot, the green power led is on, and after a while, the blue led start blinking

• (Optional)Use a USB to TTL serial cable to make a connection between your PC and ROCK Pi S. See Serial Console

4. 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 Windows and Linux.

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

   adb shell

Check Using adb.

Option 2: Serial console

Check Serial Console

Option 3: SSH

SSH server is enabled on port 22 of ROCK Pi S default image.

Please use 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.

Troubleshooting

• Refer Troubleshooting page
• Post your issue on the forum: https://forum.radxa.com/c/rockpiS

Network state

• Look at network configure:

  $ sudo ifconfig

• Test network:

  $ ping -c 5 www.google.com

WIFI Connection

Check WIFI Connection.

Bluetooth

Check Bluetooth.

Buttons

ROCK Pi S have reset key and maskrom key:

• Reset key:

Push this key ROCK Pi S can reset hardware.

• Maskrom key:

ROCK Pi S support boot on SD NAND flash,SD NAND was booting before TF card on default,push maskrom key can ignore the SD NAND flash.

LED

ROCK Pi S has Power LED and User LED.

• Power LED

Power LED is green, which can be configured by sysfs.

The related directory is /sys/class/leds/rockpis:green:power

It is always on when ROCK Pi S is given power by default,

• User LED

User LED is blue, which can be configured by sysfs.

The related directory is /sys/class/leds/rockpis:blue:user

By default, it is blink, which shows the kernel is running.

GPIO

ROCK Pi S has two 26-pin expansion headers. Each pin is distinguished by color, more information click here

Development for GPIO ROCK Pi S support libmraa GPIO library, click here to get more information.

Using OTG

ROCK Pi S has an USB type-C OTG connector, which you can use to write(or read) data by PC to (or from) ROCK Pi S, more help click here

Next Step

• More Debian image usage and tips
• Install image to SD Nand if your board has
• Checkout the hardware details
• Join the community and the discussion group