Rbian OS

Description

Rbian is based on Debian and is very stable but since a lot of changes are made for ease of customer use and to make it compatible with Raspbian .This page will guide you with basic usage of Rbian. It covers most commonly used System functions and how they work on Rbian. we see it as prototyping os. Post prototyping for large scale deployments we support customised os creation with enterprise and security features.

INFO

This documentation is for Rbian OS version: 0.7.2-beta

To check the version of Rbian run the command in terminal

				
					os-version

Note: If the command fails or gives error then Rbian version is < 0.7.2-beta.

Configuration on first Boot
Set Account password and root password
Using Chromium
USB Webcam
- Accessing USB Webcam through GUI
- Accessing USB Webcam through OpenCV
Changing Timezone
Setting up Locale
Setting up Keyboard
Changing Wallpaper
Changing Display resolution
- Fixing HDMI overscan
Sending/Receiving files using Bluetooth
- Sending files using Bluetooth
- Receiving files from Bluetooth
Changing default Audio output device
- Set HDMI as the default audio output device
- Set 3.5mm Audio Jack as default audio output device
Chainging Chromium flags for improved performance

Configuration on first Boot

Connect to Internet via Ethernet

Automatic IP (DCHP)

Static IP

Automatic IP (DCHP)

Static IP

Edit the file /etc/dhcpcd.conf using command sudo nano /etc/dhcpcd.conf

Add the below lines to the end of the file

interface eth0 
static ip_address=<STATIC_IP>/24
static routers=<ROUTER_IP> 
static domain_name_servers=<DNS_IP>

For example :

interface eth0 
static ip_address=192.168.1.240/24
static routers=192.168.1.1 
static domain_name_servers=192.168.1.243

Reboot device
```
sudo reboot 
```

Connect to Internet via WiFi

Automatic IP (DCHP)

Static IP

Automatic IP (DCHP)

Graphical

Terminal

Config Tool

Graphical

Terminal

nmcli connect wifi <SSID> password <PASS>

for example :

nmcli connect wifi myWifi password secretPassword

Config Tool

Open up the raspi-config tool, by running the command

sudo raspi-config

Navigate to System Options –> Wireless LAN
Choose the Country you are in.

Enter the Wifi SSID and password.

Restart networking to connect
```
sudo systemctl restart networking 
```

Static IP

Edit the file /etc/dhcpcd.conf using command sudo nano /etc/dhcpcd.conf

Add the below lines to the end of the file

interface p2p0 
static ip_address=<STATIC_IP>/24
static routers=<ROUTER_IP> 
static domain_name_servers=<DNS_IP>

For example :

interface p2p0 
static ip_address=192.168.1.240/24
static routers=192.168.1.1 
static domain_name_servers=192.168.1.243

Connect to the Wifi

nmcli connect wifi <SSID> password <PASS>

for example :

 nmcli connect wifi myWifi password secretPassword

Updating software packages

To update software packages, run commands

sudo apt update && sudo apt upgrade

Set Account password and root password

User : pi
Password : brainy

Terminal

Config Tool

Terminal

To change the password of default user run command

sudo passwd pi

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

2. Navigate to System Options –> Password

3. Tool will ask you to enter the new password

4. Now your password should be changed.

Root Account and password

By default Root account is disabled in Rbian OS.

Enabling Root account

sudo passwd root

This command will ask you to set root password, once set the root account will be enabled.

Using Chromium

Start up chromium by, Going to the System Menu –> Internet –> Chromium Browser
Browser will open up, now visit your favourite sites and surf the internet.

USB Webcam

Connect USB webcam to one of the USB ports.

Accessing USB Webcam through GUI

Install webcamoid

sudo apt update && sudo apt install webcamoid

Go to System menu –> Sound & Video –> Webcamoid

It will show you the webcam output on the screen

Accessing USB Webcam through OpenCV

Connect USB webcam to one of the USB ports.

Install OpenCV

sudo apt update
sudo apt install python3-opencv

Write the code for capturing from webcam and save it in the file `capture.py`

import cv2 
#cv2 is module import name for opencv-python 
webcam = cv2.VideoCapture(5) 

# Capture frame 
check, frame = webcam.read() 
if check: 
cv2.imwrite('image.jpg', frame) 
# If the capture is successful, the frame is saved in a file called image.jpg 
webcam.release()

TIP

Video devices 0 to 4 are reserved for CSI camera, so Webcam devices connected is assigned to Video device 5. So the program uses `cv2.VideoCapture(5)` for webcam.

Run the program by running command

sudo python3 capture.py

Changing Timezone

Terminal

Config Tool

Terminal

Check the current time zone
```
timedatectl
```

List all available time zones
```
timedatectl list-timezones
```

Set the correct timezone

sudo timedatectl set-timezone Asia/Kolkata

Check if the timezone is set
```
timedatectl
```

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

Navigate to Localization Options –> Timezone
Tool will ask you to choose the Timezone according to your geographic area and city.
Your chosen timezone should be set.

Setting up Locale

Terminal

Config Tool

Terminal

Run command and choose the required Locale.

sudo dpkg-reconfigure locales

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

Navigate to Localization Options –> Locale
Tool will ask you to choose the Locale.
Your chosen Locale should be set.

Setting up Keyboard

Terminal

Config Tool

Terminal

Run command and choose the correct keyboard model
```
dpkg-reconfigure keyboard-configuration
```

Apply the keyboard configuration

sudo systemctl restart keyboard-setup.service

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

Navigate to Localization Options –> Keyboard
Tool will ask you to choose the Keyboard layout.
Your chosen Keyboard layout should be set.

Changing Wallpaper

Right Click and select “Desktop preferences”
Change wallpaper
Click on Close to save and exit.

Changing Display resolution

Graphical

Config Tool

Graphical

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

2. Navigate to Display Options –> Resolution

3. Tool will ask you to choose the Display resolution.

4. Your chosen Display resolution should be set.

Fixing HDMI overscan

Check all resolutions that the display supports
```
xrandr -q
```

Set the desired resolution

xrandr --output HDMI-1 --mode <resolution> --refresh <referesh-rate>

For example: for 1920×1080@60 Hz

xrandr --output HDMI-1 --mode 1920x1080 --refresh 60

Adjust the HDMI overscan

xrandr --output HDMI-1 --transform <h-scale>,0,<right-adjust>,0,<v-scale>,<left-adjust>,0,0,1

For example: To scale horizontal coordinates by 0.8, vertical coordinates by 1.04 and moving the screen by 35 pixels right and 19 pixels down:
```
xrandr --output HDMI-1 --transform 0.80,0,-35,0,1.04,-19,0,0,1
```

Autoset display settings at boot

4.1 Edit file ~/.config/autostart/hdmioversxan-autostart.desktop make the changes given below

[Desktop Entry]
Type=Application
Name=HDMI overscan autostart
Comment=Set HDMI overscan 
Exec=sh -c 'xrandr --output HDMI-1 --mode 1920x1080 --refresh 60 --transform 1.04,0,-35,0,1.05,-30,0,0,1'
OnlyShowIn=LXDE

Sending/Receiving files using Bluetooth

Sending files using Bluetooth

Open System Menu –> Preferences –> Bluetooth Manager
Search for the Bluetooth device and Pair.
Click on Send File to send any file from Brainy Pi to Mobile.

Receiving files from Bluetooth

Open System Menu –> Preferences –> Bluetooth Manager
Search for the Bluetooth device and Pair.
Send file using Mobile and the request will get shown in the Bluetooth manager
Accept to start the file transfer. Once the file transfer is complete the bluetooth manager will notify you.

Changing default Audio output device

Default audio device is set to 3.5mm Jack on Brainy Pi.

Set HDMI as the default audio output device

Terminal

Config Tool

Terminal

Run the command to set HDMI as default audio device

pactl set-default-sink alsa_output.platform-hdmi-codec.stereo-fallback

Check if the HDMI is default audio device
```
pactl info -vv
```
The output should show alsa_output.platform-hdmi-codec.stereo-fallback in

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

Navigate to System Options –> Audio
Tool will ask you to choose the Audio device. For HDMI choose ff8a0000.i2s-i2s-hifi i2s-hifi-0
Audio should be set to HDMI output.

Set 3.5mm Audio Jack as default audio output device

Terminal

Config Tool

Terminal

Run the command to set 3.5mm Audio Jack as default device

pactl set-default-sink alsa_output.platform-es8316-sound.stereo-fallback

Check if the Audio Jack is default device
```
pactl info -vv
```
The output should show alsa_output.platform-es8316-sound.stereo-fallback in

Config Tool

Open up the raspi-config tool, by running the command
```
sudo raspi-config
```

https://brainypi.com/wp-content/uploads/2023/03/config-tool_1.png

Navigate to System Options –> Audio
Tool will ask you to choose the Audio device. For 3.5mm jack choose https://brainypi.com/wp-content/uploads/2023/03/config-tool_3.pngff880000.i2s-ES8316 HiFi es8316.1-0011-0
Audio should be set to 3.5mm jack output.

Changing Chromium flags for improved performance

Visit the site chrome://flags
Search and enable these flags
- Override software rendering list
- GPU rasterization
Visit the site chrome://gpu and it should show you the below output
This will improve the video playing performance of chromium.

NEED SUPPORT ?

First, Ensure version of OS installed and the version this document is intended for match. If they match and yet problem persists. Please use this Forum link for community help.
If you are an enterprise customer please use the ticketing system login provided to you for priority support.

Previous

<< Getting Started

Next

RaspberryPi Compatibility >>

Index

Rbian OS

Description

INFO

This documentation is for Rbian OS version: 0.7.2-beta

To check the version of Rbian run the command in terminal

Note: If the command fails or gives error then Rbian version is < 0.7.2-beta.

Configuration on first Boot

Connect to Internet via Ethernet

No configuration needed, just connect the Ethernet cable and DHCP should work.

Edit the file /etc/dhcpcd.conf using command sudo nano /etc/dhcpcd.conf

Add the below lines to the end of the file

For example :

Reboot device

Connect to Internet via WiFi

for example :

Open up the raspi-config tool, by running the command

Navigate to System Options –> Wireless LAN

Choose the Country you are in.

Enter the Wifi SSID and password.

Restart networking to connect

Edit the file /etc/dhcpcd.conf using command sudo nano /etc/dhcpcd.conf

Add the below lines to the end of the file

For example :

Connect to the Wifi

for example :

Updating software packages

To update software packages, run commands

Set Account password and root password

Default Login Account and password

User : pi

Password : brainy

Changing Login password for default user pi

To change the password of default user run command

Open up the raspi-config tool, by running the command

2. Navigate to System Options –> Password

<img decoding="async" src="https://brainypi.com/wp-content/uploads/2023/03/config-tool_8.png" />4. Now your password should be changed.

Root Account and password

By default Root account is disabled in Rbian OS.

Enabling Root account

This command will ask you to set root password, once set the root account will be enabled.

Using Chromium

Start up chromium by, Going to the System Menu –> Internet –> Chromium Browser

<img decoding="async" src="https://brainypi.com/wp-content/uploads/2023/03/2022-09-23-234701_1280x720_scrot.jpg" />

Browser will open up, now visit your favourite sites and surf the internet.

<img decoding="async" src="https://brainypi.com/wp-content/uploads/2023/03/2022-09-23-234712_1280x720_scrot.jpg" />

USB Webcam

Connect USB webcam to one of the USB ports.

Accessing USB Webcam through GUI

Install webcamoid

Go to System menu –> Sound & Video –> Webcamoid

It will show you the webcam output on the screen<img decoding="async" src="https://brainypi.com/wp-content/uploads/2023/03/2022-09-24-091240_1280x720_scrot.jpg" />

Accessing USB Webcam through OpenCV

Connect USB webcam to one of the USB ports.

Install OpenCV

Write the code for capturing from webcam and save it in the file capture.py

TIP

Video devices 0 to 4 are reserved for CSI camera, so Webcam devices connected is assigned to Video device 5. So the program uses cv2.VideoCapture(5) for webcam.

Run the program by running command

Changing Timezone

Check the current time zone

List all available time zones

Set the correct timezone

Check if the timezone is set

Open up the raspi-config tool, by running the command

Navigate to Localization Options –> Timezone

Tool will ask you to choose the Timezone according to your geographic area and city.

Setting up Locale

Run command and choose the required Locale.

Open up the raspi-config tool, by running the command

Navigate to Localization Options –> Locale

Tool will ask you to choose the Locale.

Your chosen Locale should be set.

Setting up Keyboard

Run command and choose the correct keyboard model

Apply the keyboard configuration

Open up the raspi-config tool, by running the command

Navigate to Localization Options –> Keyboard

Tool will ask you to choose the Keyboard layout.

Your chosen Keyboard layout should be set.

Changing Wallpaper

Edit the file `/etc/dhcpcd.conf` using command `sudo nano /etc/dhcpcd.conf`

Open up the `raspi-config` tool, by running the command

Edit the file `/etc/dhcpcd.conf` using command `sudo nano /etc/dhcpcd.conf`

User : `pi`

Password : `brainy`

Open up the `raspi-config` tool, by running the command

4. Now your password should be changed.

It will show you the webcam output on the screen

Write the code for capturing from webcam and save it in the file `capture.py`

Video devices 0 to 4 are reserved for CSI camera, so Webcam devices connected is assigned to Video device 5. So the program uses `cv2.VideoCapture(5)` for webcam.

Open up the `raspi-config` tool, by running the command

Open up the `raspi-config` tool, by running the command

Open up the `raspi-config` tool, by running the command

Right Click and select “Desktop preferences”

Open up the `raspi-config` tool, by running the command

3. Tool will ask you to choose the Display resolution.

4. Your chosen Display resolution should be set.

4.1 Edit file `~/.config/autostart/hdmioversxan-autostart.desktop` make the changes given below

Click on Send File to send any file from Brainy Pi to Mobile.

Send file using Mobile and the request will get shown in the Bluetooth manager

Accept to start the file transfer. Once the file transfer is complete the bluetooth manager will notify you.

The output should show `alsa_output.platform-hdmi-codec.stereo-fallback` in