feat: nio-12l: add ubuntu user guide

docs/nio/nio12l/ubuntu/README.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 9
+---
+
+# Ubuntu 系统
+
+介绍 Ubuntu 系统使用等。
+
+<DocCardList />

docs/nio/nio12l/ubuntu/ubuntu-user-guide.md

@@ -0,0 +1,96 @@
+---
+sidebar_position: 5
+---
+
+# Ubuntu 用户指南
+
+## 默认用户名和密码
+
+```
+username : ubuntu
+password : ubuntu
+```
+
+## 访问设备
+
+### 选项一：使用 HDMI 显示器，USB 键盘和鼠标
+
+可以在 HDMI 显示器看到桌面系统。
+
+### 选项二：SSH
+
+SSH 服务默认是使能的。
+可以在路由器管理界面查看设备的 IP；或者是通过电脑主机的 [angryip](https://angryip.org/) 来找到设备的 IP。
+
+```
+$ ping ip-of-device
+$ ssh ubuntu@ip-of-device
+```
+
+第一次登陆，会强制让用户修改密码。请按照提示操作。
+
+### 选项三：串口
+
+可以参照 [NIO 12L 串口使用](/nio/nio12l/low-level-dev/serial)。
+
+## 添加源并安装视频硬件包
+
+```
+$ sudo apt-add-repository ppa:mediatek-genio/genio-public
+$ sudo apt update
+$ sudo apt install mediatek-vpud-genio1200
+$ sudo apt install gstreamer1.0-plugins-base
+$ sudo apt install gstreamer1.0-plugins-good
+$ sudo apt install gstreamer1.0-plugins-bad
+$ sudo rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
+```
+
+## 更新内核
+
+下载最新的 kernel 包，并安装
+
+```
+$ wget https://dl.radxa.com/nio12l/images/ubuntu/radxa-nio-12l-kernel-5.15.0-1029.33-packages.tar.gz
+$ tar zxvf radxa-nio-12l-kernel-5.15.0-1029.33-packages.tar.gz
+$ sudo dpkg -i radxa-nio-12l-kernel-5.15.0-1029.33-packages/*.deb
+```
+
+安装完内核后，需要重启才生效。
+
+## 使用触摸屏 Radxa Display 8HD
+
+### 步骤一：更新内核到最新
+
+最新的内核版本是 5.15.0-1029.33。
+
+### 步骤二：添加 radxa-nio-12l-radxa-display-8hd dt overlay
+
+进入主机中存放 ubuntu 镜像文件的顶层目录。
+修改文件 `u-boot-initial-env`。
+找到 `list_dtbo=` 行，追加写入 `radxa-nio-12l-radxa-display-8hd.dtbo` 字符串。如：
+
+```
+list_dtbo= gpu-mali.dtbo video.dtbo ddr-8g.dtbo radxa-nio-12l-radxa-display-8hd.dtbo
+```
+
+### 步骤三：执行命令 `genio-flash board-assets`
+
+```
+$ genio-flash board-assets
+```
+
+### 步骤四：板子进入下载模式
+
+参照[NIO 12L 进入烧录模式](/nio/nio12l/installation/install-ubuntu-image-on-linux-pc#enter-download-mode)
+
+这样主机将会把新的 `u-boot-initial-env` 更新到设备中。
+
+断电重启设备后，将会看到 8HD 触摸屏显示桌面。
+
+## 安装 QT
+
+安装 qtcreator。
+
+```
+$ sudo apt update && sudo apt install -y qtcreator
+```

i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/README.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 9
+---
+
+# Ubuntu
+
+We will introduce the usage of Ubuntu and so on.
+
+<DocCardList />

i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md

@@ -0,0 +1,96 @@
+---
+sidebar_position: 5
+---
+
+# Ubuntu User guide
+
+## Default user name and password
+
+```
+username : ubuntu
+password : ubuntu
+```
+
+## Access the device
+
+### Option one: Use HDMI monitor, USB keyboard and mouse
+
+You can view the Desktop on the monitor.
+
+### Option two: SSH
+
+ssh service is enabled by default.
+You can find the IP from the router management windows or [angryip](https://angryip.org/).
+
+```
+$ ping ip-of-device
+$ ssh ubuntu@ip-of-device
+```
+
+The first login will force the user to change their password. Please follow the prompts.
+
+### Option three: Serial port
+
+Please refer to [NIO 12L serial port usage](/nio/nio12l/low-level-dev/serial).
+
+## Add APT source and install video hardware packages
+
+```
+$ sudo apt-add-repository ppa:mediatek-genio/genio-public
+$ sudo apt update
+$ sudo apt install mediatek-vpud-genio1200
+$ sudo apt install gstreamer1.0-plugins-base
+$ sudo apt install gstreamer1.0-plugins-good
+$ sudo apt install gstreamer1.0-plugins-bad
+$ sudo rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
+```
+
+## Update kernel
+
+Download the latest kernel packages and install them.
+
+```
+$ wget https://dl.radxa.com/nio12l/images/ubuntu/radxa-nio-12l-kernel-5.15.0-1029.33-packages.tar.gz
+$ tar zxvf radxa-nio-12l-kernel-5.15.0-1029.33-packages.tar.gz
+$ sudo dpkg -i radxa-nio-12l-kernel-5.15.0-1029.33-packages/*.deb
+```
+
+After installing the kernel, a restart is required for it to take effect.
+
+## Use Radxa Display 8HD Touchscreen
+
+### Step one: Update the kernel to the latest version
+
+The latest kernel version is 5.15.0-1029.33.
+
+### Step two: Add radxa-nio-12l-radxa-display-8hd dt overlay
+
+Navigate to the top level of directory including ubuntu system files.
+Modify file `u-boot-initial-env`.
+Find the line `list_dtbo=` and write `radxa-nio-12l-radxa-display-8hd.dtbo` at the end of the line. Like this:
+
+```
+list_dtbo= gpu-mali.dtbo video.dtbo ddr-8g.dtbo radxa-nio-12l-radxa-display-8hd.dtbo
+```
+
+### Step three: Execute the command `genio-flash board-assets`
+
+```
+$ genio-flash board-assets
+```
+
+### Step four: Boot the device to download mode
+
+Please refer to [NIO 12L Download mode](/en/nio/nio12l/installation/install-ubuntu-image-on-linux-pc#enter-download-mode)
+
+The Host PC will update the `u-boot-initial-env` to the device OS.
+
+Power cycle the device and you will see the Desktop on the 8HD touchscreen.
+
+## Install QT
+
+Install qtcreator.
+
+```
+$ sudo apt update && sudo apt install -y qtcreator
+```