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 Content

3.2.1 Desktop Layout

After connecting to VNC, the system desktop is as pictured:

(1) Double-click this icon and click Execution.

This tool is used to adjust color threshold parameters and debug the pan-tilt servo.

(2) Click Connect to display the real-time image transmitted by the current camera. Then you can click “Disconnect” to close the camera.

(3) The tool interface can be divided into three parts as follows:

No. Name Function
Camera feedback area Used to display the transmitted image, with the processed image on the left and the original image on the right.
Adjust color threshold parameters button Used for adjusting color thresholds, selecting the colors to be adjusted for recognition, adding or removing color categories, and saving the effects.
Servo control area Used to adjust the initial position of the sixth servo of the pan-tilt and save the modified values.

You can go to “Quick User Experience\2.3 Adjust Color Threshold” to learn the specific usage method of tool and the color threshold parameter.

3.2.2 Program Structure Instruction

(1) Press “Ctrl+Alt+T” to open the command line terminal. And input “ls” command to list all the current files. Take following contents as example.

Content Function
hiwonder-toolbox WiFi management tool
uhandpi Program source code for all game modes and associated functions.
uhandpi_software Color threshold debugging tool and palm-sized PC.

(2) Next, enter the game and program source content. Then input the following command.

cd uhandpi/

(3) After that, input “tree-L1” command. List all folders and files in the directory in the form of a tree diagram. We mainly need to understand several directories indicated by the red box in the diagram.

Content/File Instruction
action_groups Action group files storage path
action_groups Expansion board related routine
camera_calibration_sdk Camera underlying file and calibration files
common_sdk Underlying driver library
common.txt Detect and game command
config Color threshold and servo deviation configuration file
mjpg_server.py Video stream program
rpc_server.py Rpc communication service program
uHandPi.py APP service starting file

(4) Input the command below, and open the directory containing the AI vision game program directly through the tree diagram.

tree -l 1 functions
Content/File Instruction
color_classification.py Color sorting program
color_tracking.py Color tracking program
face_detection.py Face detection program
gesture_recognition.py Gesture recognition program
remote_control.py APP remote control image transmission program
rock_paper_scissors.py Rock-scissors-paper program
running.py APP calling program