From 207c4217ac549f97b46412e8b8eaac488de2625f Mon Sep 17 00:00:00 2001 From: Stephen Chen Date: Fri, 20 Sep 2024 12:00:50 +0800 Subject: [PATCH 1/3] feat: nio-12l: add ubuntu user guide Signed-off-by: Stephen Chen --- docs/nio/nio12l/ubuntu/README.md | 9 ++ docs/nio/nio12l/ubuntu/ubuntu-user-guide.md | 88 +++++++++++++++++++ .../current/nio/nio12l/ubuntu/README.md | 9 ++ .../nio/nio12l/ubuntu/ubuntu-user-guide.md | 88 +++++++++++++++++++ 4 files changed, 194 insertions(+) create mode 100644 docs/nio/nio12l/ubuntu/README.md create mode 100644 docs/nio/nio12l/ubuntu/ubuntu-user-guide.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/README.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md diff --git a/docs/nio/nio12l/ubuntu/README.md b/docs/nio/nio12l/ubuntu/README.md new file mode 100644 index 00000000..a0842f2b --- /dev/null +++ b/docs/nio/nio12l/ubuntu/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 9 +--- + +# Ubuntu 系统 + +介绍 Ubuntu 系统使用等。 + + diff --git a/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md new file mode 100644 index 00000000..35c3010b --- /dev/null +++ b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -0,0 +1,88 @@ +--- +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 进入烧录模式](/en/nio/nio12l/installation/install-ubuntu-image-on-linux-pc#enter-download-mode) + +这样主机将会把新的 `u-boot-initial-env` 更新到设备中。 + +断电重启设备后，将会看到 8HD 触摸屏显示桌面。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/README.md b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/README.md new file mode 100644 index 00000000..a9e5237d --- /dev/null +++ b/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. + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md new file mode 100644 index 00000000..bd4827f1 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -0,0 +1,88 @@ +--- +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. From bb08556d51aed08c528fee9815c3d42a590c7a6f Mon Sep 17 00:00:00 2001 From: Stephen Chen Date: Mon, 23 Sep 2024 17:05:21 +0800 Subject: [PATCH 2/3] feat: nio-12l: add qt installation for ubuntu Signed-off-by: Stephen Chen --- docs/nio/nio12l/ubuntu/ubuntu-user-guide.md | 8 ++++++++ .../current/nio/nio12l/ubuntu/ubuntu-user-guide.md | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md index 35c3010b..020cfb38 100644 --- a/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md +++ b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -86,3 +86,11 @@ $ genio-flash board-assets 这样主机将会把新的 `u-boot-initial-env` 更新到设备中。 断电重启设备后，将会看到 8HD 触摸屏显示桌面。 + +## 安装 QT + +安装 qtcreator。 + +
+$ sudo apt update && sudo apt install -y qtcreator
+
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md index bd4827f1..1ca40357 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -86,3 +86,11 @@ Please refer to [NIO 12L Download mode](/en/nio/nio12l/installation/install-ubun 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
+
From 57940f32bf050546f2014145875e9c11fd060dc1 Mon Sep 17 00:00:00 2001 From: Peter Date: Wed, 25 Sep 2024 15:55:11 +0800 Subject: [PATCH 3/3] fix: broken link --- docs/nio/nio12l/ubuntu/ubuntu-user-guide.md | 30 +++++++++---------- .../nio/nio12l/ubuntu/ubuntu-user-guide.md | 28 ++++++++--------- 2 files changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md index 020cfb38..fb7bb9ef 100644 --- a/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md +++ b/docs/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -6,10 +6,10 @@ sidebar_position: 5 ## 默认用户名和密码 -
+```
 username : ubuntu
 password : ubuntu
-
+``` ## 访问设备 @@ -22,10 +22,10 @@ password : ubuntu SSH 服务默认是使能的。 可以在路由器管理界面查看设备的 IP；或者是通过电脑主机的 [angryip](https://angryip.org/) 来找到设备的 IP。 -
+```
 $ ping ip-of-device
 $ ssh ubuntu@ip-of-device
-
+``` 第一次登陆，会强制让用户修改密码。请按照提示操作。 @@ -35,7 +35,7 @@ $ ssh ubuntu@ip-of-device ## 添加源并安装视频硬件包 -
+```
 $ sudo apt-add-repository ppa:mediatek-genio/genio-public
 $ sudo apt update
 $ sudo apt install mediatek-vpud-genio1200
@@ -43,17 +43,17 @@ $ 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
-
+``` 安装完内核后，需要重启才生效。 @@ -69,19 +69,19 @@ $ sudo dpkg -i radxa-nio-12l-kernel-5.15.0-1029.33-packages/*.deb 修改文件 `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 进入烧录模式](/en/nio/nio12l/installation/install-ubuntu-image-on-linux-pc#enter-download-mode) +参照[NIO 12L 进入烧录模式](/nio/nio12l/installation/install-ubuntu-image-on-linux-pc#enter-download-mode) 这样主机将会把新的 `u-boot-initial-env` 更新到设备中。 @@ -91,6 +91,6 @@ $ genio-flash board-assets 安装 qtcreator。 -
+```
 $ sudo apt update && sudo apt install -y qtcreator
-
+``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md index 1ca40357..969b46a3 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/nio/nio12l/ubuntu/ubuntu-user-guide.md @@ -6,10 +6,10 @@ sidebar_position: 5 ## Default user name and password -
+```
 username : ubuntu
 password : ubuntu
-
+``` ## Access the device @@ -22,10 +22,10 @@ You can view the Desktop on the monitor. 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. @@ -35,7 +35,7 @@ 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
@@ -43,17 +43,17 @@ $ 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. @@ -69,15 +69,15 @@ 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 @@ -91,6 +91,6 @@ Power cycle the device and you will see the Desktop on the 8HD touchscreen. Install qtcreator. -
+```
 $ sudo apt update && sudo apt install -y qtcreator
-
+```