# 3. Remote Desktop Installation and Connection

## 3.1 Remote Desktop Installation and Connection

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

### 3.1.1 Preparation

* **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](https://store.hiwonder.com.cn/docs/common/Remote_connection_tool/VNC/VNC-Viewer-6.17.731-Windows.exe)**" in the same directory as this section. Select the installation language as "**English**" and lick "**OK**".

<img class="common_img" src="../_static/media/6.remote/1.1/image2.png"  />

(2)  Click "**Next**".

<img class="common_img" src="../_static/media/6.remote/1.1/image3.png"  />

(3) Tick "**I accept the terms in the License Agreement**". Then click "**Next**".

<img class="common_img" src="../_static/media/6.remote/1.1/image4.png"  />

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

<img class="common_img" src="../_static/media/6.remote/1.1/image5.png"  />

(5)  When the installation completes, click "**Finish**".

<img class="common_img" src="../_static/media/6.remote/1.1/image6.png"  />

(6)  Click <img src="../_static/media/6.remote/1.1/image7.png" style="width:45px;" alt="image" /> 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.

<img src="../_static/media/6.remote/1.1/image8.png"  alt="image" class="common_img" />

(2)  Input password. The password is "**hiwonder**".

<img class="common_img" src="../_static/media/6.remote/1.1/image9.png"  alt="image" />

<img class="common_img" src="../_static/media/6.remote/1.1/image10.png"  alt="image" />

(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**".

<img src="../_static/media/6.remote/1.1/image11.png" class="common_img"  alt="image" />

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

<img class="common_img" src="../_static/media/6.remote/1.1/image12.png"  />

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

<img class="common_img" src="../_static/media/6.remote/1.1/image13.png"  />

### 3.1.3 Introduction to Desktop

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

<img class="common_img" src="../_static/media/6.remote/1.1/image14.png" />

The following table demonstrates common functions:

<table class="docutils-nobg" border="1">
<colgroup>
<col style="width: 50%" />
<col style="width: 50%" />
</colgroup>
<tbody>
<tr>
<td style="text-align: center;">Icon</td>
<td style="text-align: center;">Function</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image15.png" style="width:0.625in;height:0.52083in" alt="2" /></td>
<td style="text-align: left;"><p>Application menu. Click to select different applications.</p>
<p><img src="../_static/media/6.remote/1.1/image16.png" style="width:0.80139in;height:1.41111in" /></p></td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image17.png" style="width:0.62569in;height:0.56806in" alt="3" /></td>
<td style="text-align: left;">Browser.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image18.png" style="width:0.62569in;height:0.52708in" alt="4" /></td>
<td style="text-align: left;">File manager.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image19.png" style="width:0.625in;height:0.42708in" alt="5" /></td>
<td style="text-align: left;">LX terminal. Click to input command line in the opened interface.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image20.png" style="width:0.66667in;height:0.79167in" /></td>
<td style="text-align: left;">Trash. You can find the files deleted here.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image21.png" style="width:0.62569in;height:0.60833in" alt="" /></td>
<td style="text-align: left;">PC software. You can adjust pan tilt and adjust color threshold on it.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image22.png" style="width:0.30208in;height:0.42708in" alt="8" /></td>
<td style="text-align: left;">Full screen or exit full screen.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image23.png" style="width:0.35417in;height:0.35417in" alt="9" /></td>
<td style="text-align: left;">Exit full screen.</td>
</tr>
<tr>
<td style="text-align: center;"><img src="../_static/media/6.remote/1.1/image24.png" style="width:0.35417in;height:0.45347in" alt="10" /></td>
<td style="text-align: left;"><p>Shut down, reboot and logout</p>
<p><img src="../_static/media/6.remote/1.1/image25.png" style="width:2.28472in;height:1.19583in" /></p></td>
</tr>
</tbody>
</table>

## 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:

<img class="common_img" src="../_static/media/6.remote/2.1/image3.png"  />

|                        **Directory**                         |                           Function                           |
| :----------------------------------------------------------: | :----------------------------------------------------------: |
| <img src="../_static/media/6.remote/2.1/image4.png" style="width:0.72917in;height:0.875in" /> | TonyPi PC software which includes action programming, debugging etc. |
| <img src="../_static/media/6.remote/2.1/image5.png" style="width:1.20833in;height:1.11458in" /> |               Chinese-English switching tool.                |
| <img src="../_static/media/6.remote/2.1/image6.png" style="width:1.04167in;height:0.78125in" /> |            Color model parameter adjustment tool.            |
| <img src="../_static/media/6.remote/2.1/image7.png" style="width:0.98958in;height:0.96875in" /> | Terminator terminal, which is used to input command to proceed operation. |
| <img src="../_static/media/6.remote/2.1/image8.png" style="width:0.40625in;height:0.33333in" alt="image" /> | File manager is a visual file directory interface.Recommended for beginner users who are not familiar with the command line. |

### 3.2.2 Programming Instruction

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

(1)  Click <img src="../_static/media/6.remote/2.1/image9.png" style="width:0.41667in;height:0.29167in" /> icon and enter "**Is**" command and then press Enter to list all the documents. As shown in the figure below:

<img class="common_img" src="../_static/media/6.remote/2.1/image10.png"  />

|   **Directory**    |                    **Function**                     |
|:------------------:|:---------------------------------------------------:|
|       TonyPi       | Store all the games and related program source code |
| TonyPi_PC_Software |    TonyPi 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 "**TonyPi**".
:::

(2)  Enter `cd TonyPi` to open all the games and program source code. In the TonyPi, enter "**ls**" command in the following three main directories. As shown below:

```bash
cd TonyPi
```

```bash
ls
```

<img class="common_img" src="../_static/media/6.remote/2.1/image11.png"  />

|  Directory  |                         **Function**                         |
|:-----------:|:------------------------------------------------------------:|
|  Functions  |  The directory where the AI vision game program is located.  |
|  TonyPi.py  | Main program for running the games (auto-start has been set) |
| HiwonderSDK |         Underlying file path (for hardware control)          |

(3)  Enter the `cd Functions` and "**ls**" instructions in turn again. Let's take a look at the corresponding games of the program:

```bash
cd Functions
```

```bash
ls
```

|   Program Name    |               Game                |
|:-----------------:|:---------------------------------:|
| RemoteControl.py  | Model control (only for learning) |
|    KickBall.py    |           Auto shooting           |
|  ColorDetect.py   |         Color recognition         |
|  VisualPatrol.py  |            Line follow            |
|   ColorTrack.py   |         Color recognition         |
|   FaceDetect.py   |        Facial recognition         |
| ApriltagDetect.py |          Tag recognition          |

### 3.2.3 Game in Advanced Tutorial

:::{Note}
You can go to "**[Intelligent Transport Course](https://docs.hiwonder.com/projects/TonyPi/en/latest/docs/11.voice_interaction_and_intelligent_handling_course.html)**" to learn the advanced tutorial.
:::

| **Program**  |       **Game**       |
| :----------: | :------------------: |
| Transport.py | Intelligent Handling |
|  Follow.py   |   Object Tracking    |