3. Remote Desktop Installation and Connection

3.1 VNC Installation and Connection

3.1.1 Preparation

  • Hardware

Prepare a computer. If you are using desktop computer, wireless network card is required.The network card should support 5G band.

  • Install VNC

VNC is a graphical remote desktop control software. Through connecting your computer to the WiFi generated by Raspberry Pi, you can control Raspberry Pi. Installation of VNC is as below.

(1) Double-click the installation program “VNC-Viewer-6.17.731-Windows” in the same directory as this section. Select the installation language as “English” and lick “OK”.

(2) Click “Next”.

(3) Tick “I accept the terms in the License Agreement”. Then click “Next”.

(4) Remain default location where the software is installed. Click “Next” to proceed next interface. Then directly click “Install”.

(5) When the installation completes, click “Finish”.

(6) Click to open VNC.

  • Start Robot

Start Robot When LED1 on expansion board starts flickering and buzzer emits one beep, robot boots up successfully.

3.1.2 Connect to Robot

(1) After turning Robot on successfully, the default mode is AP direct connection mode. Robot generates a WiFi starting with HW. Connect your computer to this WiFi.

(2) Input password. The password is “hiwonder”.

(3) After connection, open VNC Viewer. Input the default IP address of Raspberry Pi, 192.168.149.1, and then press Enter. If you receive security warning, select “Continue”.

(4) Input username and password. (Username: pi;Password: raspberrypi). Click “OK” to enter Raspberry Pi desktop.

(5) The desktop is as pictured. If black screen occurs or only cursor leaves on the screen, restart Raspberry Pi.

3.1.3 Introduction to Desktop

The desktop is as pictured after connecting Robot through VNC successfully.

The following table demonstrates common functions:

Icon Function

Application menu. Click to select different applications.

Browser.
File manager.
LX terminal. Click to input command line in the opened interface.
Trash. You can find the files deleted here.
PC software. You can adjust pan tilt and adjust color threshold on it.
Full screen or exit full screen.。
Exit full screen.

Shut down, reboot and logout

3.2 System Introduction

3.2.1 Desktop Instruction

After remote connection via VNC, the Raspberry Pi system desktop is as shown in the figure below:

Icon Function
SpiderPi PC software which includes action editing, calling, and etc.
Color model parameter adjustment tool.
Color model parameter adjustment tool.
Terminator terminal, which is used to input command to proceed operation.
Raspberry Pi menu bar.
image System file folder.

3.2.2 Programming Instruction

The input command must be case sensitive and space, and the keyword supports “TAB” key to fill.

(1) Click or press “Ctrl+Alt+T” to open LX terminal.

(2) Enter “ls” command and then press “Enter” to list all the documents. As shown in the figure below:

Directory Function
SpiderPi Store all the games and related program source code.
SpiderPi_PC_Software SpiderPi PC software source code (based on Qt).
hiwonder-toolbox Wi-Fi management tool.

Note

For AI vision games, you only need to check the folder “SpiderPi”.

(3) Enter “cd SpiderPi” to open all the games and program source code. In the SpiderPi, enter “ls” command in the following three main directories. As shown below:

cd SpiderPi
ls
Directory Function
Functions The directory where the AI vision game program is located.
SpiderPi.py Main program for running the games (auto-start has been set)
spiderpi_sdk Underlying file path (for hardware control)

(4) Enter the “cd functions” and “ls” instructions in turn again. Let’s take a look at the corresponding games of the program:

cd functions
ls
Program Name Game
RemoteControl.py Body remote control
color_detect.py Color recognition
color_track.py Color tracking
face_detect.py Facial recognition
visual_patrol.py Line following
avoidance.py Obstacle avoidance
apriltag_detect.py Tag recognition

3.2.3 Game in Advanced Tutorial

Program Game
transport_cleaning.py Intelligent object cleaning
self_transport.py Intelligent transport
apriltag_follow.py Tag tracking