Merge pull request #595 from wu-yue-yu/main

Update lpi3h docs

docs/hardware/en/longan/h618/lpi3h/1_intro.md

@@ -0,0 +1,84 @@
+---
+title: Board Introduction
+keywords: Linux, Longan, H618, SBC, ARM
+update:
+  - date: 2023-12-08
+    version: v1.0
+    author: ztd
+    content:
+      - Release docs
+---
+
+## Board Introduction
+Longan Pi 3H is an ARM Linux development board based on the Longan Module 3H core board. It is powered by the H618 (Quad-core ARM Cortex-A53 @ 1.5GHz, 64-bit) as the main control core and has a maximum onboard 4GB 64-bit LPDDR4 memory. It supports HDMI 4K display output and features a Gigabit Ethernet port. Additionally, it comes with onboard Wi-Fi 6 and Bluetooth capabilities.
+
+## Basic Specifications
+
+<table>
+<thead>
+<tr>
+  <th colspan=2>Specifications</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+  <td>Main Chip</td>
+  <td>H618</td>
+</tr>
+<tr>
+  <td>CPU </td>
+  <td>ARM [email protected] <br>· Each core supports a 32 KB L1 I-cache and a 32 KB L1 D-cache. <br>· The quad-core configuration shares a 1MB L2 cache.</td>
+</tr>
+<tr>
+  <td>GPU</td>
+  <td>Arm Mali-G31 <br>· OpenCL 2.0<br>· OpenGL ES 1.0/2.0/3.2<br>· Vulkan 1.1</td>
+</tr>
+<tr>
+  <td>Video Decoder</td>
+  <td>· Supports H.264 BP/MP/[email protected] decoding, with a maximum resolution of 4K<br>· Supports AVS2 JiZhun 10-bit decoding, with a maximum resolution of 4K <br>· The maximum decoding performance is 4K@60fps </td>
+</tr>
+<tr>
+  <td>Video Encoder</td>
+  <td>· Supports H.264 BP/MP/HP encoding, with a maximum resolution of 4K<br>· Only supports I-frames and P-frames for video encoding<br>· The maximum encoding performance is 4K@25fps </td>
+</tr>
+<tr>
+  <th colspan=2>Hardware Specifications</th>
+</tr>
+<tr>
+  <td>RAM</td>
+  <td>· 1/2/4 GB 64bits LPDDR4<br></td>
+</tr>
+<tr>
+  <td>Storage</td>
+  <td>· eMMC: empty/32G<br>· Supports TF (microSD) card</td>
+</tr>
+<tr>
+  <td>Ethernet</td>
+  <td>· Gigabit Ethernet interface</td>
+</tr>
+<tr>
+  <td>USB</td>
+  <td>· 2 x USBA Host <br>· 1 x USBC OTG</td>
+</tr>
+<tr>
+  <td>Display Interface</td>
+  <td>· 1 x Standard HDMI interface </td>
+</tr>
+<tr>
+  <td>GPIO</td>
+  <td>· UART<br>· IIC<br>· SPI</td>
+</tr>
+</tbody>
+</table>
+
+### Hardware Documentation Download
+
+[LonganPi3H Hardware Documentation](https://dl.sipeed.com/shareURL/LONGAN/LonganPi3H)
+
+## Other links
+
+[Github](https://github.com/sipeed/LonganPi-3H-SDK)  
+[Aliexpress](https://www.aliexpress.us/item/3256806204597847.html)  
+
+Forum：Maixhub.com/discussion  
+Email：[email protected]

docs/hardware/en/longan/h618/lpi3h/3_images.md

@@ -0,0 +1,36 @@
+---
+title: Images
+keywords: Linux, Longan, H618, SBC, ARM, image
+update:
+  - date: 2023-12-08
+    version: v1.0
+    author: ztd
+    content:
+      - Release docs
+---
+
+## Sipeed official images
+
+### Debian
+
+Sipeed Official Image is based on the modified and adapted Debian system.
+
+The default account and password configuration for the image are as follows:
+Account: `root`, Password: `root`;
+Account: `sipeed`, Password: `licheepi`.
+
+**Please note that it is not recommended to log in to the desktop environment using the root user.**
+
+![debian](./../../../../zh/longan/h618/lpi3h/assets/images/debian.png)  
+![debian_neofetch](./../../../../zh/longan/h618/lpi3h/assets/images/debian_neofetch.png)  
+
+Download:
+
+百度网盘：[Click me](https://pan.baidu.com/s/1VGaARAq6dbicFy4VOytRuw) 提取码: cd68
+Mega：[Click me](https://mega.nz/folder/gt50zDoC#LgRvHVCzWTUgGohKoMtlqA)
+
+<!--
+### Android 12
+
+TBD
+-->

docs/hardware/en/longan/h618/lpi3h/4_burn_image.md

@@ -0,0 +1,38 @@
+---
+title: Burn images
+keywords: Linux, Longan, H618, SBC, ARM, image
+update:
+  - date: 2023-12-08
+    version: v1.0
+    author: ztd
+    content:
+      - Release docs
+---
+
+## Preparation
+
+### Get the Image
+
+Refer to the previous section[images](https://wiki.sipeed.com/hardware/en/longan/H618/lpi3h/3_images.html), and download the desired image.
+
+### Get the Flashing Tool
+
+The commonly used tools for flashing images to an SD card are balenaEtcher, Rufus, etc. Here, we'll use balenaEtcher as an example. First, go to the [balenaEtcher official website](https://etcher.balena.io/#download-etcher) to download and install the software.
+For Linux, you can also use the dd command to write the image directly.
+
+## Flashing the Image
+
+After preparing the image to be flashed, open balenaEtcher. First, select the image file you want to flash:
+
+![select_image](./../../../../zh/longan/h618/lpi3h/assets/burn_image/select_image.png)
+
+Then, select the target device:
+
+![select_device](./../../../../zh/longan/h618/lpi3h/assets/burn_image/select_device.png)
+
+Finally, click on "Flash" and wait for the flashing process to complete. Once it's done, you'll have an SD card with the bootable image:
+
+![flash_image](./../../../../zh/longan/h618/lpi3h/assets/burn_image/flash_image.png)
+
+
+The steps for Windows and Linux are similar.

docs/hardware/en/longan/h618/lpi3h/5_desktop.md

@@ -0,0 +1,217 @@
+---
+title: Desktop
+keywords: Linux, Longan, H618, SBC, ARM, Debian, Desktop
+update:
+  - date: 2023-12-08
+    version: v1.0
+    author: ztd
+    content:
+      - Release docs
+---
+
+## Logging into the System
+
+In this document, we'll use the default Debian desktop system as an example to explain basic system usage.
+
+The default credentials for the image are as follows:
+User: `sipeed`, Password: `licheepi`;
+User: `root`, licheepi `root`;
+
+The image has automatic login enabled, and the user sipeed is automatically logged in. If you don't want automatic login, you can comment out the line `autologin-user=sipeed` in the file `/usr/share/lightdm/lightdm.conf.d/01_debian.conf`.
+
+## Opening the Command Line
+
+In the Debian graphical system of LonganPi 3H, you can open the command line terminal quickly and conveniently by pressing the key combination Ctrl + Alt + T.
+
+## Connecting to the Network
+
+The desktop system uses ConnMan to manage network connections by default.
+
+You can find `ConnMan Settings` in the application menu at the top-left corner. After clicking it, a network icon will appear at the top-right corner of the desktop. Clicking the network icon allows you to create new network connections and view network connection information:
+
+![connman_enable](./../../../../zh/longan/h618/lpi3h/assets/desktop/connman_enable.png)
+
+### Connecting to Wired Network
+
+In the terminal, you can enable a wired network connection and view related information using:
+```shell
+connmanctl enable ethernet
+```
+
+LonganPi 3H has a Gigabit Ethernet interface. To connect to a wired network, plug in an Ethernet cable that is already connected to the network into the network interface of LonganPi 3H. You can see the connection information by clicking the network icon at the top-right corner:
+
+![connman_connect_eth](./../../../../zh/longan/h618/lpi3h/assets/desktop/connman_connect_eth.png)
+
+### Connecting to Wireless Network
+
+LonganPi 3H has an onboard wireless module that supports Bluetooth and Wi-Fi.
+
+Graphical Interface Method:
+
+Click the network icon at the top-right corner and switch to the Wi-Fi connection page. Select the desired Wi-Fi network and click "Connect":
+
+![connman_connect_wifi](./../../../../zh/longan/h618/lpi3h/assets/desktop/connman_connect_wifi.png)
+
+Commandline Interface Method:
+We can use connmanctl to enable wifi connections and other information:
+```shell
+connmanctl enable wifi
+```
+
+Open the command line and use wpa_supplicant to connect to Wi-Fi. The following steps need to be executed as the root user:
+```shell
+sudo -i
+nano /etc/wpa_supplicant.conf
+```
+
+Create the wpa_supplicant.conf file and enter the SSID and passphrase of the Wi-Fi network. After filling in the information, run the following command to connect to Wi-Fi:
+```shell
+wpa_supplicant -D nl80211 -i 网卡名 -c /etc/wpa_supplicant.conf &
+```
+
+
+## Connecting to Bluetooth
+
+In the terminal, you can enable Bluetooth connection and view related information using:
+```shell
+connmanctl enable bluetooth
+```
+
+The desktop system uses `blueman` to manage Bluetooth connections by default.
+
+Find the Bluetooth icon at the top-right corner of the desktop and make sure that Bluetooth is turned on. If it's not, right-click the Bluetooth icon to turn it on:
+
+![bluetooth_icon.png](./../../../../zh/longan/h618/lpi3h/assets/desktop/bluetooth_icon.png)
+
+After turning it on, left-click the Bluetooth icon to see the Bluetooth device scanning interface.
+Click the "Search" button in the top-left corner of that interface to search for Bluetooth devices. Make sure that Bluetooth devices such as keyboards, mice, and headphones are in pairing mode and can be discovered.
+Right-click the desired device and select "Connect" to establish the connection. After a successful connection, you can also right-click the device and click "Trust" to enable automatic connection in the future.
+
+![bluetooth_devices.png](./../../../../zh/longan/h618/lpi3h/assets/desktop/bluetooth_devices.png)
+
+If the Bluetooth graphical management interface cannot find devices, you can use `bluetoothctl` in the command line interface to pair devices. The steps are as follows:
+
+```shell
+bluetoothctl
+scan on
+# Find the MAC address of the device you want to pair with
+pair MAC_address_of_target_deviceconnect
+connect MAC_address_of_target_device
+```
+
+## Software Installation
+
+ After connected to the network, you can update and install software packages.
+
+### Software Sources
+
+ In Debian, apt (Advanced Packaging Tool) can be used to install software.
+
+ When installing software, it will search and download the target software from the system-specified software website. When the target website is difficult to access (such as the server is too far away or the server network is not good), you can manually set up and edit the software source website to change it to the nearest source to reduce the download time.
+
+ The default software source is the content of the `/etc/apt/sources.list` file, which can be changed by yourself if there is additional need.
+
+### Upgrading Software
+
+Using `sudo apt update` can update the software list, which is generally needed after changing the software source.
+
+Before using this command, use the `date` command to check the time. If the system time is wrong or there is no automatic update time after connecting to the network, you can update it manually to ensure that the software package in the software source is the latest version:
+```shell
+sudo date -s "20230717 12:00:00"
+```
+
+Then you can update the software named `package_name` with `sudo apt upgrade package_name`.
+
+### Install
+
+Software can be installed with the apt command;for example, `sudo apt install package_name` to install `package_name`, replacing `package_name` with the name of the software package you want to install. 
+
+## SSH
+
+If you don't have ssh or sshd in your image, you can install them first with the following command:
+
+```bash
+sudo apt install ssh openssh-server
+```
+
+Once installed, you can use ssh to log in to other machines or log in to the LicheePi 4A from other machines.
+You can also use scp to transfer files:
+
+```bash
+scp demo.zip [email protected]:~/
+```
+
+## Input Languages
+
+If you need to input non-ascii characters, you need to install input languages. Here I use Chinese input language as an example, please find related tutorials for other languages.
+
+First, install ibus-libpinyin:
+
+```bash
+sudo apt install -y ibus-libpinyin
+```
+
+> Note that this will consume about 200MB of disk space
+
+After installation, reboot the board, you will see the `IBus Preference` option under Applications, click to enter the settings.
+
+![pinyin_cfg0](./../../../../zh/longan/h618/lpi3h/assets/desktop/pinyin_cfg0.png)
+
+Click `Input Method` in the appearing interface, click `Add`, select `Chinese`, select `Intelligent Pinyin`, click `Add` to add Chinese Pinyin input method.
+
+![pinyin_cfg1](./../../../../zh/longan/h618/lpi3h/assets/desktop/pinyin_cfg1.png) 
+
+Click the input icon in the upper right corner, you will see the following options, select `Chinese - Intelligent Pinyin`. 
+
+![pinyin_cfg2](./../../../../zh/longan/h618/lpi3h/assets/desktop/pinyin_cfg2.png)
+
+At this point, you can input Chinese successfully in the system.
+
+## Browser
+
+The system has built-in Firefox browser, which can be used by clicking the browser icon at the bottom of the desktop: 
+
+![browser_location](./../../../../zh/longan/h618/lpi3h/assets/desktop/browser_location.png)
+
+The effect is as follows:
+
+![firefox_usage](./../../../../zh/longan/h618/lpi3h/assets/desktop/firefox_usage.png)
+
+## Player
+
+You can install the VLC player by using the command: 
+
+```shell
+sudo apt install vlc
+```
+
+After installation, the video playback effect is as follows:
+
+![vlc_player_usage](./../../../../zh/longan/h618/lpi3h/assets/desktop/vlc_player_usage.png)
+
+
+## Programming Development 
+
+### Python
+
+The python3 environment is installed in the system, so you can run `python3` directly in the terminal:
+
+![python_usage](./../../../../zh/longan/h618/lpi3h/assets/desktop/python_usage.png)
+
+If you need to install Python packages, use: `sudo apt install python3-XXX`
+For example, to install the pyserial package: `sudo apt install python3-serial`. 
+
+### C
+
+The `build-essential` package needs to be installed, which takes up about 800MB of disk space.
+
+```bash
+sudo apt install build-essential
+```
+
+Then you can use gcc to do the relevant operations:
+
+![gcc_usage](./../../../../zh/longan/h618/lpi3h/assets/desktop/gcc_usage.png)
+
+## More
+Welcome to submit your submissions! You can get ¥5~150 ($1~20) coupons after your submissions are accepted!