View source for Rock5/5b/getting started

{{rock5_header}}
{{Languages|rock5/3a/getting_started}}

    [[rock5 | ROCK 5]] > [[Rock5/5b | ROCK 5 Model b]] > [[Rock5/5b/getting_started | Getting started]]

__TOC__

= Getting Started =

This guide is designed for ROCK 5B enthusiast. The purpose is to learn about ROCK 5B as well as how to prepare and set up for basic use.
When you get a board, you need to know what 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.

== Close look of ROCK 5B ==
* ROCK 5B front view

[[File:rock-5b-front.png|500px]]

* ROCK 5B front with an angle view

[[File:rock-5b-angle.jpeg|500px]]

* ROCK 5B back view

[[File:rock-5b-back.png|500px]]

== <span id="get_start_specs"></span> Features ==


== What you need ==

=== Necessary ===
* ROCK 5B main board

* One of the Storage media below:
** microSD, larger than 8GB
** eMMC module, larger than 8GB

* Power supply
** The ROCK 5B is powered by Type-C port and has a wide range of input voltage, from 5V to 21V. ROCK 5B supports USB Type-C PD 2.0 with 9V/2A, 12V/2A, 15V/2A and 20V/2A.
** The Type-C cable you using needs to support data communication. We call it USB Type-C charging data cable.

* USB Keyboard and Mouse
** With four USB-A connectors, ROCK 5B can be equipped with a full sized keyboard and mouse.

* Monitor and HDMI Cable
** ROCK 5B is equipped with a full sized HDMI connector. HDMI capable monitor is recommended.
** HDMI EDID display data is used to determine the best display resolution. On monitors and TVs that support 1080p (or 4K/8K) this resolution will be selected. If 1080p is not supported the next available resolution reported by EDID will be used. This selected mode will work with MOST but not all monitors/TVs.

*USB to TTL serial cable
**ROCK 5B exports a dedicated serial console for CPU, which can access the low level debug message.

*USB type A to typec C cable
**If you want to write image on ROCK 5B from USB OTG port or use fastboot/adb commands you need an USB typec A to type C cable to connect ROCK 5B and PC.

=== Optional ===
* microSD Card Reader
** For flashing the image into microSD Card 

* USB type A to type C cable
** This is needed for fastboot/adb commands.

*  USB to TTL serial cable
** This is needed for serial console.

*  Ethernet cable
** ROCK 5B supports Internet access via Ethernet.
** An Ethernet cable is used to connect your ROCK 5B to a local network and  the Internet.

* Camera Module
** ROCK 5B supports  camera function.

* LCD Module
** ROCK 5B supports LCD display function.

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

* [[rock5/hardware/wifi | WiFi/BT Cards]]

== Starting the board for the first time ==

ROCK 5B 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 5B. 

===  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 [[rock5/downloads | Downloads]].

* Download the flash tool, etcher, from [[rock5/downloads | Downloads]]. Choose the right version for your host operation system. Here we operate on host Ubuntu 20.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:etcher-rock-5b-1.png]]

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

[[File:etcher-rock-5b-2.png]]

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

[[File:etcher-rock-5b-3.png]]

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

[[File:etcher-rock-5b-4.png]]

===  3. Boot the board ===

* Now insert the system storage media, μSD 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 5B board. See [[rock5/dev/serial-console | Serial Console]].

* Power on ROCK 5B by adapter with type C port.

* ROCK 5B will boot with the green power LED on. And after a while, another blue LED starts blinking.

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

==== Option 1: HDMI monitor and Mouse ====

You would see Desktop on HDMI monitor. 

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

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

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

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

To access ROCK 5B by SSH, try 
  
 ping rock-5b.local
 ssh rock@rock-5b.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 5B ip address.

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

Note: You can also get the IP of ROCK 5B 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 [[rock5/linux/debian#wifi-connection | WIFI Connection]].

=== 7.Bluetooth ===

Check [[rock5/linux/debian#bluetooth | Bluetooth]].

=== 8.LED ===

ROCK 5B has Power LED and User LED.

* Power LED

The power LED is green. It is always on when ROCK 5B is given power by default,

* User LED

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

=== 9.GPIO ===

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

Development for GPIO. ROCK 5B supports libmraa GPIO library, click [[Rock3/dev/libmraa | here]] to get more information.

== Next Step ==

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