Getting Started
Vicharak provides all necessary accessories and information for setting up Vaaman. This section guides you through the initial setup.
What’s in the box?
- Vaaman
Single-board computer with on-board FPGA support.
Powered by Rockchip RK3399 SoC (dual-core Cortex-A72 and quad-core Cortex-A53).
4GB LPDDR4 RAM, 16GB eMMC storage, 40-pin GPIO header.
Pre-installed with Ubuntu 22 (
Jammy
).
- PD Cable
Supplies power to Vaaman.
Ensures stable and efficient power delivery via USB-C with Power Delivery technology.
- Wi-Fi and Bluetooth Antennas
Includes antennas for both Wi-Fi and Bluetooth connectivity.
These antennas ensure greater signal range and reliable connectivity for both Wi-Fi and Bluetooth devices.
What else do you need?
12V/5A Power Adapter
Micro HDMI to HDMI cable or adapter
USB Keyboard and Mouse
Monitor with HDMI input
USB-C to USB-A Male cable (optional)
SD-card (optional)
Internet Connection (optional)
USB to UART Serial Cable (optional)
Note
Warning
- Connections:
Wi-Fi Antenna: Connect to Wi-Fi antenna connector on reset key side.
Bluetooth Antenna: Connect to BLE antenna connector on MIPI-DSI connector side.
Getting Started with Vaaman
Turning the Board On
- Connect Power:
Connect the PD cable to the Vaaman board.
Plug the PD adapter into a power socket.
- Power Source:
Ensure you use the provided 12V/5A Power Adapter with PD cable.
Do not use a 5V power input.
Danger
12V Power Input only! Do not use 5V power input.Using a 12V power input is crucial for the proper functioning of the Vaaman.The board is designed to operate with a 12V power supply, and using a 5V powerinput may lead to instability and potential damage.
- Automatic Power On:
Once the power is connected, the board will automatically turn on.
- Boot Priority:
NVMe: Highest precedence. If an NVMe drive is connected, the board boots from it.
SD-card: If no NVMe drive, the board attempts to boot from an SD-card.
eMMC: Default. If no NVMe drive or SD-card, the board boots from eMMC storage.
Warning
Remove SD-card if insertedThis ensures the board boots from the eMMC storage.
Vaaman is pre-installed with Ubuntu 22 (Jammy
) on its eMMC storage, so it will boot from the eMMC storage by default.
Verify the Power LED
Red LED: Indicates that Vaaman is receiving power.
Check the red LED for immediate visual confirmation of successful power connection.
Verify the Status LED
Blue LED: Blinks to indicate the completion of the booting process.
Check the blue LED to ensure Vaaman has successfully booted and is ready for configuration.
Warning
Available Boot Modes
Booting from SD card
To boot from SD card, please follow the below document.
Booting from NVMe drive
To boot from NVMe, please follow the below document.
How to Access Your Vaaman Board?
There are multiple ways to access your Vaaman board:
Connect to a monitor using the micro HDMI port.
Connect headless to your computer using SSH or serial console.
For the initial setup process, we recommend connecting the Vaaman to a monitor using the micro HDMI port. Once the initial setup is complete, you can connect the Vaaman to your computer using the USB-C port.
Note
If you want to access the serial console, Skip to the Serial Console section.
If you want to access the Vaaman using SSH, Skip to the SSH section.
1. Using Micro HDMI Port
Micro HDMI Port: Connect Vaaman to a monitor or TV using a micro HDMI to HDMI cable or adapter.
Benefits: Provides direct visual access to the graphical user interface (GUI) or command-line interface (CLI).
Caution
Steps:
Connect the micro HDMI to HDMI cable to the Vaaman and the monitor.
The Vaaman will automatically detect the monitor and display the output.
Check out Linux Start Guide
Once the Vaaman is connected to the monitor, you can follow the Linux Start Guide to complete the initial setup.
2. Using Serial Console
Serial Console: Access the system’s console or terminal interface via UART (Universal Asynchronous Receiver-Transmitter) pins.
Use Case: Often used for debugging, troubleshooting, or accessing the system when other interfaces are not available.
Steps:
Connect to the serial pins using a serial cable or adapter.
Access the system’s console through the connected serial interface.
Default Login Credentials
Username: vicharak
Password: 12345
These credentials are used for initial login via any access method (HDMI, SSH, Serial Console).
3. Using SSH
SSH Access: Securely access Vaaman over a network.
Steps:
Ensure Vaaman is connected to the network.
Open a terminal on your computer.
Use the following command to connect: ssh vicharak@<Vaaman_IP_address>
Enter the default password 12345 when prompted.
Preparation
To access Vaaman through the serial interface, you will need:
A computer with a serial terminal application installed, such as PuTTY or minicom.
A USB to UART serial cable or adapter (e.g., FTDI or PL2303).
A Micro USB or USB-C cable.
A 4-pin jumper wire.
Hardware Setup
Connect the USB to UART serial cable or adapter to your computer.
Connect the serial cable or adapter to Vaaman using the following pin configurations:
Serial FTDI Pin |
Header GPIO Pin |
Schematic Name |
---|---|---|
GND |
Pin 6 |
GND |
TX |
Pin 8 (GPIO4_C4) |
UART2DBG_TX |
RX |
Pin 10 (GPIO4_C3) |
UART2DBG_RX |
Configuration
When accessing Vaaman through the serial interface, ensure the following serial parameters are set correctly for RK3399-based systems:
Baud rate: 1500000
Data bit: 8
Stop bit: 1
Parity check: none
Flow control: none
Warning
During the first boot, a warning may appear on your serial console. Allow the system to complete its reboot before proceeding. This ensures that the system is fully set up for subsequent tasks.
Running the Serial Console Program
Download and install the PuTTY program.
- Open the PuTTY program and configure the serial parameters as shown
in the image below.
Click on the Open button to open the serial console.
You will now be able to access the serial console.
- Download and install the
TeraTerm program.
Open the TeraTerm program and configure the serial parameters.
On the Setup menu, click on Serial port.
Select the serial port number and configure the serial parameters as shown in the image below.
Click on the OK button to open the serial console.
You will now be able to access the serial console.
Install the GTK-Term program using the following command:
sudo apt-get install gtkterm
Open the GTK-Term program and configure the serial parameters.
On the File menu, click on Port.
Select the serial port number and configure the serial parameters as shown in the image below.
Click on the OK button to open the serial console.
You will now be able to access the serial console.
Note
Read minicom configuration from Linux Minicom guide.
3. Using SSH
Vaaman supports SSH (Secure Shell), enabling secure remote access to the system. By establishing an SSH connection, users can remotely connect to Vaaman from another device over a network, such as a computer or smartphone. This method provides a secure command-line interface to administer, configure, and execute commands on Vaaman.
You can install both OpenSSH components on Windows devices using the Windows Settings.
To install the OpenSSH components, follow these steps:
Open the Settings menu and click on Apps, then select Optional Features.
Check if OpenSSH is already installed. If not, at the top of the page, click on Add a feature, then:
Find OpenSSH Client and click on Install.
Find OpenSSH Server and click on Install.
After installation, verify that OpenSSH is listed in Apps and Optional Features.
Open the Services desktop app (Start > type services.msc in the search box > click on the Service app or press ENTER).
In the details pane, double-click on OpenSSH SSH Server.
On the General tab, choose Automatic from the Startup type drop-down menu.
To start the service, click on Start.
Once installed, you can connect to the OpenSSH Server from a Windows device with the OpenSSH client installed.
From a PowerShell prompt, run the following command:
ssh username@ip_address
Example:
ssh vicharak@192.168.29.69
Tip
To find your IP address on Windows, use the following command: ipconfig
.
For Linux users, use the following command: ip a
.
Accessing Vaaman through SSH
To access Vaaman via SSH, you can use either of the following commands:
SSH using the IP address
Replace ip_address with the actual IP address assigned to Vaaman on the network.
ssh vicharak@ip_address
SSH using the PC name (hostname)
Replace “pc-name” with the actual PC name assigned to Vaaman on the network.
ssh vicharak@pc-name.local
Tip
The default username is “vicharak” and the default password is “12345”.
4. Set up automatic Wi-Fi connection on boot
Edit the
/usr/lib/vicharak-config/conf.d/before.txt
file.Add the following line: `` connect-wi-fi <network name> <password> ``
Example: `` connect-wi-fi vicharak_5g vcaa_g123 ``
Reboot the system.
Vaaman Boot modes
Boot Mode |
Description |
---|---|
Normal Mode |
Normal boot mode is the default boot mode. In this mode, the board boots from the eMMC or SD-card. Each partition loads in order and enters the system normally. |
Loader Mode |
Loader mode is used to upgrade the bootloader. In this mode, the bootloader will wait for the host command for firmware upgrade. On success, the board boots from the eMMC or SD-card, and the board enters the system normally. |
Maskrom Mode |
Maskrom mode is used to repair the board. In a situation where the
bootloader is damaged, the board can enter the maskrom mode.
In general, there is no need to enter Maskrom mode.
In this mode, the bootrom code waits for the host to transmit the
bootloader code through the USB-C port, load and run it.
|
See also
vaaman-fpga