Wely

sunxi_d1 设备树文件定位报告

Sat, 11 Jul 2026 00:00:00 GMT

sunxi_d1 设备树文件定位报告

结论

在开源鸿蒙系统源码的根目录 OpenHarmony 中，使用以下命令构建内核时：

./build.sh --product-name sunxi_d1 --ccache

需要修改的 Linux 内核设备树源文件是：

device/sunxi/config/chips/d1/configs/nezha/linux-5.4/board.dts

该文件会被构建脚本复制到内核源码树并参与设备树编译。请修改此文件，不要直接修改 out/ 目录中生成的 DTS/DTB 中间产物。

若硬件改动还影响 U-Boot 阶段（例如启动介质、早期供电、启动显示），还应检查并按需修改：

device/sunxi/config/chips/d1/configs/nezha/uboot-board.dts

确认依据

1. 产品选择了 sunxi 的 D1 设备包

productdefine/common/products/sunxi_d1.json 定义产品 sunxi_d1，并在 parts 中引入 sunxi_products:sunxi_products。

随后，device/sunxi/build/BUILD.gn 的 products_group 在设备类型为 sunxi_d1 时，依赖 //device/sunxi/sunxi_d1:sunxi_d1_group。

2. D1 设备包构建内核目标

device/sunxi/sunxi_d1/BUILD.gn 的 sunxi_d1_group 依赖 kernel:kernel。

device/sunxi/sunxi_d1/kernel/BUILD.gn 将内核源码设为 //kernel/linux-5.4，并通过 build_kernel.sh 调用内核构建流程，设备类型参数为 sunxi_d1。

3. D1 内核构建流程选用 kernel-5.4.mk

kernel/linux/patches/kernel_module_build.sh 对 sunxi_d1 设置 TARGET_PRODUCT=sunxi_d1 和 Linux 5.4 输出目录；随后执行：

make -f kernel-5.4.mk

4. 构建规则明确复制并编译 nezha 的 board.dts

kernel/linux/patches/kernel-5.4.mk 第 98 行包含以下复制规则：

cp $(OHOS_BUILD_HOME)/device/sunxi/config/chips/d1/configs/nezha/linux-5.4/board.dts \
   $(KERNEL_SRC_TMP_PATH)/arch/riscv/boot/dts/sunxi/

这说明项目源目录中的 device/sunxi/config/chips/d1/configs/nezha/linux-5.4/board.dts 会进入内核的 RISC-V sunxi DTS 编译目录，因此它是上述构建命令所使用的 Linux 内核板级设备树源文件。

为什么不是其他 board.dts

其他芯片或板型目录下的 board.dts 不在 sunxi_d1 的上述复制规则中。
out/ 中的文件是构建生成的中间产物，下一次构建可能被覆盖，不能作为源文件修改。
uboot-board.dts 属于 U-Boot 板级配置；只有在执行 device/sunxi/build/pack 打包并需要改变 U-Boot 行为时才需要同步修改。

用途	路径
Linux 内核设备树（本次构建应修改）	`device/sunxi/config/chips/d1/configs/nezha/linux-5.4/board.dts`
U-Boot 设备树（按硬件改动需要同步）	`device/sunxi/config/chips/d1/configs/nezha/uboot-board.dts`
Linux 设备树复制规则	`kernel/linux/patches/kernel-5.4.mk`
内核构建入口	`kernel/linux/patches/kernel_module_build.sh`

开源鸿蒙系统配置 USB 转网口驱动

Sat, 10 Jan 2026 00:00:00 GMT

哪吒 D1 开发板可通过 USB 转网口模块实现网络连接。但在开源鸿蒙系统中，内核默认并未配置该驱动。本文将介绍如何为开源鸿蒙系统内核添加 USB 转网口驱动支持。

修改内核配置

内核配置文件位于以下位置：

OpenHarmony/device/sunxi/config/chips/d1/configs/nezha/linux-5.4/config-5.4

其中 OpenHarmony 是开源鸿蒙系统源码的根目录。

打开该文件，在文件末尾添加以下配置选项：

CONFIG_USB_NET_DRIVERS=y
CONFIG_USB_USBNET=y
CONFIG_USB_RTL8152=y
CONFIG_USB_NET_AX8817X=y
CONFIG_USB_NET_CDCETHER=y
CONFIG_USB_NET_RNDIS_HOST=y
CONFIG_USB_NET_CDC_NCM=y
CONFIG_USB_NET_CDC_MBIM=y
CONFIG_USB_NET_CDC_EEM=y

保存文件后，重新构建系统。

构建系统

在开源鸿蒙系统源码根目录 OpenHarmony 下，首先删除已有的构建内容 out：

rm -rf out

然后执行以下命令进行构建：

./build.sh --product-name sunxi_d1 --ccache

后续参考构建适用于哪吒开发板的开源鸿蒙系统进行系统构建和生成镜像文件并烧写。参考开源鸿蒙系统配置网络进行网络配置。

解决 WPS 的 libdbus-1 问题

Wed, 03 Dec 2025 00:00:00 GMT

在给树莓派 5 上 arm64 架构的 Debian 13 系统安装 WPS 365 后，会出现打不开的问题，运行 wps 命令后终端输出如下错误信息：

wely@pi500:/opt/kingsoft/wps-office/office6 $ ./wps
qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in ""
QFont::fromString: Invalid description '苹方-简,10,-1,5,400,0,0,0,0,0,0,0,0,0,0,1,常规体'
QFont::fromString: Invalid description 'Consolas,10,-1,5,400,0,0,0,0,0,0,0,0,0,0,1'
QFont::fromString: Invalid description '苹方-简,10,-1,5,400,0,0,0,0,0,0,0,0,0,0,1,常规体'
QFont::fromString: Invalid description '苹方-简,10,-1,5,400,0,0,0,0,0,0,0,0,0,0,1,常规体'
Cannot find libdbus-1 in your system to resolve symbol 'dbus_get_local_machine_id'.
段错误（核心已转储）

解决方案

在四处搜寻解决方案无果后，GPT-5.1 给出了一个可行的解决方案（不得不说还得是 ChatGPT 厉害）：

cd /opt/kingsoft/wps-office/office6/addons/cef
sudo mv libm.so.6 libm.so.6.bak

执行完上述命令后，再次运行 wps，WPS 成功启动。

原因

从报错来看，貌似是 WPS 找不到 libdbus-1 库，但此时系统里是有安装 libdbus-1 库的，运行以下命令可以看到：

wely@pi500:~ $ ls -l /usr/lib/*/libdbus-1.so*
lrwxrwxrwx 1 root root     19 2025年 3月 9日 /usr/lib/aarch64-linux-gnu/libdbus-1.so.3 -> libdbus-1.so.3.38.3
-rw-r--r-- 1 root root 395416 2025年 3月 9日 /usr/lib/aarch64-linux-gnu/libdbus-1.so.3.38.3

手动抓一份调试日志来查找原因：

cd /opt/kingsoft/wps-office/office6
./wps 2> /tmp/wps-ld.log

查看日志内容，发现一行致命错误：

/opt/kingsoft/wps-office/office6/addons/cef/libm.so.6: error: version lookup error:
version `GLIBC_2.39' not found (required by /lib/aarch64-linux-gnu/libsystemd.so.0) (fatal)

意思是：

WPS 自带了一份旧的 libm.so.6：
/opt/kingsoft/wps-office/office6/addons/cef/libm.so.6
系统里的 libsystemd.so.0 是用 glibc 2.39 编译的，需要 GLIBC_2.39 版本的符号；
结果动态链接器优先加载了 WPS 目录里的这个旧 libm.so.6，它没有 GLIBC_2.39 版本的符号，于是报错 (fatal)，后面一连串找 libdbus-1 也就全都失败了。

所以是 WPS 自带的旧 C 运行库（libm.so.6）跟系统太新（glibc 2.39）的库冲突，把整个动态链接过程搞崩了，Qt 最后只能说“找不到 libdbus-1”。

解决办法：让 WPS 用系统的 libm，而不是自带那份

直接把 WPS 自带的 libm.so.6 改名，让它加载系统的 /lib/aarch64-linux-gnu/libm.so.6：

cd /opt/kingsoft/wps-office/office6/addons/cef
sudo mv libm.so.6 libm.so.6.bak

再次运行 wps，WPS 成功启动。

开源鸿蒙哪吒开发板使用gdbserver调试程序

Wed, 29 Oct 2025 00:00:00 GMT

gdb 与 gdbserver 是 GNU 提供的远程调试工具，gdb 运行在主机上，gdbserver 运行在目标设备上，通过网络连接实现远程调试。本文介绍如何为开源鸿蒙哪吒开发板配置 gdbserver 进行程序调试，并在 vscode 中进行可视化调试。

[!NOTE] 被调试的程序需要是 debug 模式编译的可执行文件，以包含调试信息，在编译时需要加入 -g 参数。

编译 `gdbserver`

首先依照为开源鸿蒙哪吒开发板编写程序中的步骤，下载并解压 剑池开发工具集 中的 GCC工具链-900系列。本文以 Linux 系统为例，使用 Xuantie-900-gcc-elf-newlib-x86_64-V3.2.0-20250627.tar.gz。

打开终端，首先下载并解压 gdb 源码：

wget https://ftp.gnu.org/gnu/gdb/gdb-16.3.tar.xz
tar -xvf gdb-16.3.tar.xz

[!NOTE] 也可以从 GNU FTP 站点直接下载 gdb 源码。下载速度较慢时，可以使用国内镜像站点，例如清华大学开源软件镜像站。

因为 gdb 在之前下载的编译工具链中已经包含，我们只需要编译 gdbserver 部分。进入解压后的 gdb-16.3 目录，并新建 build 文件夹：

cd gdb-16.3
mkdir build
cd build

使用以下命令进行编译，注意替换 TOOL 路径为实际的编译器路径：

export TRIPLE=riscv64-unknown-linux-musl
export TOOL=/home/wely/Xuantie-900-gcc-linux-6.6.0-musl64-x86_64-V3.2.0/bin/
export CC="$TOOL$TRIPLE-gcc"
export CXX="$TOOL$TRIPLE-g++"
export AR="$TOOL$TRIPLE-ar"
export RANLIB="$TOOL$TRIPLE-ranlib"
export CFLAGS="-O2 -DELF_NFPREG=33"
export CXXFLAGS="-O2 -DELF_NFPREG=33"
export LDFLAGS="-static -Wl,--gc-sections -static-libgcc -static-libstdc++"
../configure --host="$TRIPLE" --disable-gdb --disable-werror --without-python --without-guile --disable-inprocess-agent
make -j"$(nproc)" all-gdbserver

编译完成后，gdbserver 可执行文件位于 gdb-16.3/build/gdbserver/gdbserver。

将 gdbserver 可执行文件传输到开源鸿蒙哪吒开发板上，作为服务端运行。建议复制到 /bin/ 目录下，以便全局使用。

使用 `gdb` 连接 `gdbserver` 进行调试

首先在开源鸿蒙哪吒开发板上启动 gdbserver，监听指定端口（例如 23456）：

gdbserver --multi :23456

在主机上，使用编译工具链中的 riscv64-unknown-linux-musl-gdb，连接到哪吒开发板上的 gdbserver，注意将 /host/test-cpp-debug 替换为主机实际的可执行文件路径，将 x.x.x.x 替换为哪吒开发板的实际 IP 地址，并设置远程执行文件路径为哪吒开发板上的实际路径 /remote/test-cpp-debug：

./riscv64-unknown-linux-musl-gdb /host/test-cpp-debug
(gdb) target extended-remote x.x.x.x:23456
(gdb) set remote exec-file /remote/test-cpp-debug

现在可以使用 gdb 命令进行调试，例如设置断点、单步执行等：

(gdb) break main
(gdb) continue
(gdb) step
(gdb) print variable_name

在 `vscode` 中配置可视化调试

首先在开源鸿蒙哪吒开发板上启动 gdbserver，监听指定端口（例如 23456）：

gdbserver --multi :23456

在主机上，在 vscode 中安装 C/C++ 扩展，然后创建或修改项目中的 .vscode/launch.json 文件，添加以下配置，注意替换 program 为实际的主机可执行文件路径，替换 miDebuggerPath 为实际的 riscv64-unknown-linux-musl-gdb 路径，替换 -target-select extended-remote x.x.x.x:23456 中的 IP 地址和端口号为实际的哪吒开发板地址和端口号，替换 set remote exec-file /remote/test-cpp-debug 为实际的哪吒开发板可执行文件路径：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 远程",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/test-cpp-debug",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "riscv64-unknown-linux-musl-gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                },
                { "text": "-target-select extended-remote x.x.x.x:23456" },
                { "text": "set remote exec-file /remote/test-cpp-debug" },
                { "text": "skip file /musl/" },
                { "text": "skip function exit" },
                { "text": "skip function _Exit" }
            ]
        }
    ]
}

保存后，在 vscode 中启动调试，即可通过图形界面进行断点设置、单步执行和变量查看等操作。

进阶：在 `vscode` 中一键编译、上传与调试

可以在开发板上运行 ssh 服务，使 vscode 能够通过 scp 自动上传编译后的可执行文件，实现一键调试。

编译 `dropbear`

dropbear 是一个轻量级的 ssh 服务器，适合资源受限的嵌入式设备。

还是依照为开源鸿蒙哪吒开发板编写程序中的步骤，下载并解压 剑池开发工具集 中的 GCC工具链-900系列。本文以 Linux 系统为例，使用 Xuantie-900-gcc-elf-newlib-x86_64-V3.2.0-20250627.tar.gz。

获取 dropbear 源码：

git clone https://github.com/mkj/dropbear.git
cd dropbear

创建 build 目录并进入：

mkdir build
cd build

使用以下命令进行编译，注意替换 TOOL 路径为实际的编译器路径：

export TRIPLE=riscv64-unknown-linux-musl
export TOOL=/home/wely/Xuantie-900-gcc-linux-6.6.0-musl64-x86_64-V3.2.0/bin/
export CC="$TOOL$TRIPLE-gcc"
export CXX="$TOOL$TRIPLE-g++"
export AR="$TOOL$TRIPLE-ar"
export RANLIB="$TOOL$TRIPLE-ranlib"
export CFLAGS="-O2 -DELF_NFPREG=33"
export CXXFLAGS="-O2 -DELF_NFPREG=33"
export LDFLAGS="-static -Wl,--gc-sections -static-libgcc -static-libstdc++"
../configure --host=riscv64-linux-musl --disable-pam --disable-zlib --disable-shadow --disable-lastlog --disable-wtmp --disable-utmp
make MULTI=1 PROGRAMS="dropbear dbclient dropbearkey scp" LDFLAGS="-static" -j$(nproc)

编译完成后，dropbearmulti 可执行文件位于 dropbear/build/dropbearmulti，它是一个多合一可执行文件，包含 dropbear、dbclient、dropbearkey 和 scp 四个程序。

将 dropbearmulti 可执行文件传输到开源鸿蒙哪吒开发板上，作为 ssh 服务器运行。建议复制到 /bin/ 目录下，以便全局使用。

配置 `dropbear` 服务器

为方便使用，创建符号链接：

ln -s /bin/dropbearmulti /bin/dropbear
ln -s /bin/dropbearmulti /bin/dbclient
ln -s /bin/dropbearmulti /bin/dropbearkey
ln -s /bin/dropbearmulti /bin/scp

生成主机密钥：

mkdir -p /etc/dropbear
dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key
dropbearkey -t ecdsa -f /etc/dropbear/dropbear_ecdsa_host_key

修改 root 用户配置使其可登录：

cp /etc/passwd /etc/passwd.bak
sed -i '/^root:/c root:x:0:0:root:/root:/bin/sh' /etc/passwd

配置 root 用户密码，此时在本地生成密码的哈希值（注意不是在开发板上）：

openssl passwd -6

按提示输入两次你想要的密码，得到一串形如 $6$6$xxxxx$yyyy 的哈希，复制备用。在开发板上将此哈希值设置为变量：HASH='$6$......'（以下回到开发板上运行）：

HASH='$6$......'

将密码写入 /etc/passwd 文件：

sed -i "s#^root:[^:]*:#root:${HASH}:#" /etc/passwd

创建 root 用户的家目录：

mkdir -p /root && chmod 700 /root

创建 .ssh 目录并设置权限：

mkdir -p /root/.ssh && chmod 700 /root/.ssh

此时可启动 dropbear 服务器，测试密码登录：

dropbear -E -F -R -p 22

可在主机上使用 ssh 连接到哪吒开发板，输入密码测试登录。

配置密钥登录

在主机上生成 ssh 密钥对（注意不是在开发板上）：

sh-keygen -t rsa

运行后会提示输入文件名和密码，可直接回车使用默认文件名且不设置密码。生成的公钥文件为 ~/.ssh/id_rsa.pub，私钥文件为 ~/.ssh/id_rsa。

使用 ssh-copy-id 将公钥复制到哪吒开发板的 root 用户下（注意替换 x.x.x.x 为实际 IP 地址）：

ssh-copy-id -i ~/.ssh/id_rsa.pub root@x.x.x.x

注：也可以手动将公钥内容追加到哪吒开发板的 /root/.ssh/authorized_keys 文件中。

# 在客户端查看公钥
cat ~/.ssh/id_rsa.pub

# 在服务器上添加到 authorized_keys
mkdir -p root/.ssh
chmod 700 root/.ssh
echo "粘贴公钥内容" >> root/.ssh/authorized_keys
chmod 600 root/.ssh/authorized_keys

上传完成后，即可使用密钥登录：

ssh -i ~/.ssh/id_rsa root@x.x.x.x

在 `vscode` 中配置一键上传与调试

配置 .vscode/launch.json 文件，注意修改 miDebuggerPath、x.x.x.x 以及 set remote exec-file 中的 IP 地址和可执行文件路径：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 远程",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}-debug",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "riscv64-unknown-linux-musl-gdb",
            "preLaunchTask": "build+upload",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                },
                { "text": "-target-select extended-remote x.x.x.x:23456" },
                { "text": "set remote exec-file ${fileBasenameNoExtension}-debug" },
                { "text": "skip file /musl/" },
                { "text": "skip function exit" },
                { "text": "skip function _Exit" }
            ]
        }
    ]
}

配置 .vscode/tasks.json 文件，添加编译与上传任务，注意修改 riscv64-unknown-linux-musl-g++ 编译器路径与 scp 使用的 id_rsa 私钥、x.x.x.x IP 和 / 上传路径：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build-static-riscv",
      "type": "shell",
      "command": "riscv64-unknown-linux-musl-g++",
      "args": [
        "${fileBasename}",
        "-static",
        "-g",
        "-o",
        "${fileBasenameNoExtension}-debug"
      ],
      "options": {
        "cwd": "${fileDirname}"
      },
      "group": "build",
      "problemMatcher": ["$gcc"]
    },
    {
      "label": "upload-to-target",
      "type": "shell",
      "command": "scp",
      "args": [
        "-i",
        "id_rsa",
        "-O",
        "${fileDirname}/${fileBasenameNoExtension}-debug",
        "root@x.x.x.x:/"
      ]
    },
    {
      "label": "build+upload",
      "dependsOrder": "sequence",
      "dependsOn": [
        "build-static-riscv",
        "upload-to-target"
      ]
    }

    // 可选：调试结束后清理远端文件
    // {
    //   "label": "cleanup-remote",
    //   "type": "shell",
    //   "command": "ssh",
    //   "args": ["root@192.168.31.200", "rm -f /test/${fileBasenameNoExtension}-debug"]
    // }
  ]
}

在开发板上启动 dropbear 和 gdbserver：

dropbear -p 22 -R
gdbserver --multi :23456

现在在 vscode 中启动调试，选择 (gdb) 远程，即可实现一键编译、上传与调试功能，大大提升开发效率。

为开源鸿蒙哪吒开发板编写程序

Sat, 18 Oct 2025 00:00:00 GMT

使用 C 语言为开源鸿蒙编写第一个程序 Hello NeZha。

下载编译工具链

前往玄铁资源中心，在 资源目录 中选择 剑池开发工具集 - 编译工具 - GCC工具链-900系列。若在 Windows 系统下进行编译，则下载 Xuantie-900-gcc-linux-6.6.0-musl64-mingw-V3.2.0-20250627.tar.gz；若在 Linux 系统下进行编译，则下载 Xuantie-900-gcc-linux-6.6.0-musl64-x86_64-V3.2.0-20250627.tar.gz。

以 Windows 系统为例，下载完成后解压，Xuantie-900-gcc-linux-6.6.0-musl64-mingw-V3.2.0\bin\riscv64-unknown-linux-musl-gcc.exe 即为将要使用的编译器。

编写程序

创建 hello_word.c 文件，内容如下：

#include <stdio.h>
int main(int argc, char const *argv[])
{
    printf("Hello NeZha\n");
    return 0;
}

编译程序

使用以下命令进行编译，其中 riscv64-unknown-linux-musl-gcc.exe 替换为实际的编译器路径：

.\Xuantie-900-gcc-linux-6.6.0-musl64-mingw-V3.2.0\bin\riscv64-unknown-linux-musl-gcc.exe hello_word.c -static -o hello_word

[!NOTE] -static 参数用于生成静态链接的可执行文件，避免在目标设备上运行时出现缺少动态库的问题。此处使用 gcc 编译 C 语言程序，后续也可以使用 g++ 编译 C++ 语言程序。默认生成的是 release 模式的可执行文件，若需要包含调试信息以便调试程序，可以添加 -g 参数以生成 debug 模式的可执行文件。

编译成功后会在 hello_word.c 同目录下生成 hello_word 可执行文件。

传输程序

[!NOTE] 由于哪吒开发板上的开源鸿蒙系统目前不支持通过 hdc 传输文件，此处使用 U 盘进行传输。为保证兼容性，使用 FAT32 格式化 U 盘。

将 U 盘插入电脑，复制 hello_word 文件到 U 盘根目录。然后将 U 盘插入哪吒开发板的 USB 接口。

查看哪吒开发板是否识别到 U 盘：

ls /dev/block/

识别到的 U 盘应类似于 sda 或 sda1 等。若有多个 sda，挂载数字最大的那个。

使用以下命令在哪吒开发板上挂载 U 盘：

mkdir -p /mnt/sda
mount -t vfat /dev/block/sda /mnt/sda

[!NOTE] 后续可以使用 umount /mnt/sda 命令卸载 U 盘。

将程序复制到 /bin 目录下：

cp -v /mnt/sda/hello_word /bin/
chmod +x /bin/hello_word

运行程序

输入命令 hello_word 即可运行程序，程序运行如下：

# hello_word
Hello NeZha
#

参考

开源鸿蒙开发板连接集成开发环境

Fri, 10 Oct 2025 00:00:00 GMT

在为哪吒 D1 开发板构建开源鸿蒙系统并配置网络后，可将开发板通过 hdc 工具连接至华为 DevEco Studio 集成开发环境进行应用开发与调试。

开发板设置

首先将开发板连接至有线网络，并与 PC 处于同一局域网内。PC 通过 USB 转串口线连接至开发板，为开发板配置网络。

网络配置好后，通过串口使用以下命令打开开发板的 hdcd 服务：

hdcd -t -l4 &

[!NOTE] 由于开源鸿蒙系统适配尚不完全，hdcd 服务启动时会有三个报错，但不影响使用。

开发板的串口输出如下：

# hdcd -t -l4 &
[1] 343
# 
# Option TCP enabled
[  325.104766] [pid=345][param_request.c:136][Init][ERROR] Can not get param for persist.hdc.root
[[1;36mD[0m][0:5:26] HdcDaemon main run
[[1;36mD[0m][0:5:26] loopMain init
[[1;36mD[0m][0:5:26] HdcDaemon InitMod
[  325.177150] [pid=346][param_request.c:136][Init][ERROR] Can not get param for persist.hdc.port
[[1;36mD[0m][0:5:27] HdcDaemonTCP init
[[1;32mI[0m][0:5:27] TCP listen on port:[44643]
[[1;36mD[0m][0:5:27] JdwpListen begin
[  325.248777] [pid=347][param_request.c:136][Init][ERROR] Can not get param for ro.hdc.secure

[!IMPORTANT] hdcd 服务启动后，注意查看串口输出中的 TCP listen on port，记录下端口号，后续在 PC 端连接时需要用到。注意端口号在每次启动 hdcd 服务时可能会变化。

PC 设置

首先下载 hdc 工具，访问 https://ci.openharmony.cn/workbench/cicd/dailybuild/dailyList，项目选择 openharmony，然后在流水线名称中找到 ohos-sdk-public，点击 下载链接，选择 全量包 的 下载链接 进行下载。

下载完成后解压，进入解压后文件夹内寻找 windows 平台对应的 windows 文件夹，将其中的 toolchains 文件夹复制到任意目录下，例如 C:\toolchains，该目录即为 hdc 工具所在目录，并将其添加到系统 PATH 环境变量中。

打开终端，输入 hdc -v 查看 hdc 工具版本，验证是否配置成功，若成功则会输出版本信息，例如：

Ver: 1.2.0a

接下来使用 hdc 工具连接开发板，输入以下命令，注意将 x.x.x.x 替换为开发板的 IP 地址，port 替换为前面记录的端口号：

hdc tconn x.x.x.x:port

此时终端中会输出类似如下信息：

PS C:\Users\wely> hdc tconn 192.168.31.200:44643
Connect OK

Connect OK 表示连接成功。

此时可在终端中输入 hdc shell 进入开发板的 shell 环境，输入 hdc kill 可以断开与开发板的连接。

连接成功后，即可在 DevEco Studio 中选择该开发板设备，进行应用开发与调试。

[!WARNING] 由于开源鸿蒙系统适配尚不完全，hdc 工具目前仍存在无法传输文件等问题。

开源鸿蒙系统配置网络

Tue, 30 Sep 2025 00:00:00 GMT

[!NOTE] 为哪吒 D1 开发板构建适配的开源鸿蒙系统后，默认情况下系统不带 dhcp 服务，连接网线后无法自动配置 IP 地址，需要手动进行配置。

查看网口信息

输入 ifconfig -a 命令查看网口信息。

ifconfig -a

输出示例：

eth0      Link encap:Ethernet  HWaddr 56:22:6c:6a:59:9b  Driver sunxi-gmac
          BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
          collisions:0 txqueuelen:1000 
          RX bytes:0 TX bytes:0 
          Interrupt:62 

sit0      Link encap:IPv6-in-IPv4  
          NOARP  MTU:1480  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
          collisions:0 txqueuelen:1000 
          RX bytes:0 TX bytes:0 

lo        Link encap:Local Loopback  
          inet addr:127.0.0.1  Mask:255.0.0.0 
          inet6 addr: ::1/128 Scope: Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
          collisions:0 txqueuelen:1000 
          RX bytes:0 TX bytes:0

从返回的信息可以看到默认有 eth0 有线网口，下面对其进行配置。

配置有线网络

配置 IP 地址

使用以下命令配置 IP 地址，注意将 x.x.x.x 替换为实际的 IP 地址：

ifconfig eth0 x.x.x.x netmask 255.255.255.0 up

配置默认网关

使用以下命令配置默认网关，注意将 x.x.x.x 替换为实际的网关地址：

route add default gw x.x.x.x

配置 DNS 服务器

编辑 /etc/resolv.conf 文件，添加 DNS 服务器地址：

echo "nameserver 223.5.5.5" > /etc/resolv.conf

开放 ping 权限

[!IMPORTANT] 默认情况下，系统未开放 ping 权限，直接使用 ping 命令会提示 Permission denied 错误。

直接使用 ping 会出现错误：

# ping www.baidu.com
ping: socket SOCK_DGRAM 1: Permission denied
Kernel bug workaround (as root):
echo 0 9999999 > /proc/sys/net/ipv4/ping_group_range

报错提示可用以下命令开放 ping 权限：

echo "0 9999999" > /proc/sys/net/ipv4/ping_group_range

测试网络连接

使用 ping 命令测试网络连接：

ping www.baidu.com

出现类似输出即表示网络配置成功：

# ping www.baidu.com
Ping www.baidu.com (183.2.172.17): 56(84) bytes.
64 bytes from 183.2.172.17: icmp_seq=1 ttl=0 time=27 ms
64 bytes from 183.2.172.17: icmp_seq=2 ttl=0 time=27 ms
64 bytes from 183.2.172.17: icmp_seq=3 ttl=0 time=26 ms

--- 183.2.172.17 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss
round-trip min/avg/max = 0/0/26 ms

参考

【OH 干货】给 OpenHarmony 开发板配置网络

vim 拟人配置

Wed, 24 Sep 2025 00:00:00 GMT

大部分 Linux 发行版自带的 vim 都是精简版的，无法正常使用方向键和退格键，本文介绍如何配置 vim 使其可以正常使用。

修改配置文件

首先使用 vim 打开 /etc/vim/vimrc.tiny 配置文件。

sudo vi /etc/vim/vimrc.tiny

打开后内容如下：

" Vim configuration file, in effect when invoked as "vi". The aim of this
" configuration file is to provide a Vim environment as compatible with the
" original vi as possible. Note that ~/.vimrc configuration files as other
" configuration files in the runtimepath are still sourced.
" When Vim is invoked differently ("vim", "view", "evim", ...) this file is
" _not_ sourced; /etc/vim/vimrc and/or /etc/vim/gvimrc are.

" Debian system-wide default configuration Vim
set runtimepath=~/.vim,/var/lib/vim/addons,/usr/share/vim/vimfiles,/usr/share/vim/vim91,/usr/share/vim/vimfiles/after,/var/lib/vim/addons/after,~/.vim/after

set compatible

" vim: set ft=vim:

找到 set compatible 这一行，将其修改为 set nocompatible。

首先使用方向键下键移动光标到 set compatible 这一行，然后使用方向键右键移动光标到 c 字母上，即 set compatible，此时按 i 进入编辑模式，输入 no，使这一行变为 set nocompatible，按 Esc 退出插入模式，最后输入 :wq 保存并退出。

再次打开这个配置文件：

sudo vi /etc/vim/vimrc.tiny

按 i 进入编辑模式，使用方向键移动光标到set nocompatible 这一行末尾，按下回车键换行，输入以下内容：

set backspace=2

按 Esc 退出插入模式，输入 :wq 保存并退出。

此时 vim 即可正常使用方向键和退格键了。

修改后配置文件

修改后的 /etc/vim/vimrc.tiny 文件内容如下：

" Vim configuration file, in effect when invoked as "vi". The aim of this
" configuration file is to provide a Vim environment as compatible with the
" original vi as possible. Note that ~/.vimrc configuration files as other
" configuration files in the runtimepath are still sourced.
" When Vim is invoked differently ("vim", "view", "evim", ...) this file is
" _not_ sourced; /etc/vim/vimrc and/or /etc/vim/gvimrc are.

" Debian system-wide default configuration Vim
set runtimepath=~/.vim,/var/lib/vim/addons,/usr/share/vim/vimfiles,/usr/share/vim/vim91,/usr/share/vim/vimfiles/after,/var/lib/vim/addons/after,~/.vim/after

set nocompatible
set backspace=2

" vim: set ft=vim:

简单来说就是修改了如下两行：

set nocompatible
set backspace=2

构建适用于哪吒开发板的开源鸿蒙系统

Fri, 01 Aug 2025 00:00:00 GMT

[!NOTE] 由于官方给出的示例文档写的实在太烂，故在此对构建过程进行逐步记录。所有构建过程均于 Ubuntu 系统中进行，并通过 Docker 获取编译环境，请确保已提前安装好 Docker，参考官方文档以安装。

目前的适配进度止步于进入控制台，即可通过串口连接开发板进入命令行，未适配图形化界面。

[!IMPORTANT] 构建时必要的 llvm-riscv 工具链 llvm-riscv-1124.tar.gz 目前仅可通过百度网盘下载，链接为 https://pan.baidu.com/s/19JVNwFrl5ISOAsruW_y9hA?pwd=chds，提取码为 chds。

安装 Repo 工具

构建前需要使用 Repo 工具来获取源码和 SDK。

sudo apt update
sudo apt install repo

需要设置 git 的用户名和邮箱，将以下命令中的 your_name 和 your_email 替换为你的用户名和邮箱。

git config --global user.name "your_name"
git config --global user.email "your_email"

更换镜像源

每次运行时 Repo 会尝试访问官方的 git 源检查更新，更换镜像源可以提高下载速度。

echo export REPO_URL='https://mirrors.bfsu.edu.cn/git/git-repo' >> ~/.bashrc
source ~/.bashrc

创建工作目录

为便于进行文件管理，创建工作目录，文件夹关系如下。

nezha/                  # 总文件夹
├── OpenHarmony/        # OpenHarmony 源码
└── tina-d1/            # Tina-D1 SDK

通过以下命令创建这些文件夹。

mkdir -p nezha/OpenHarmony nezha/tina-d1
cd nezha

获取 SDK

[!IMPORTANT] 需要提前注册全志在线开发者论坛账号，并达到 LV2 等级，参考这个链接升级。

初始化仓库

进入刚才创建的 tina-d1 文件夹，使用 Repo 工具初始化仓库。

cd tina-d1
repo init -u https://sdk.aw-ol.com/git_repo/D1_Tina_Open/manifest.git -b master -m tina-d1-h.xml

如果提示 Username for 'https://sdk.aw-ol.com'，请输入全志在线开发者论坛的用户名和密码，需要全志在线开发者论坛 LV2 等级以上用户才有权限拉取 SDK。

[!TIP] 如果出现 git requires authentication, but repo cannot perform interactive authentication. Check git credentials. 错误导致无法拉取，需要手动设置用户名和密码。

git config --global credential.helper store
git ls-remote https://sdk.aw-ol.com/git_repo/D1_Tina_Open/manifest.git

此时会触发输入用户名和密码，输入后重新执行 repo init -u https://sdk.aw-ol.com/git_repo/D1_Tina_Open/manifest.git -b master -m tina-d1-h.xml 即可。

拉取 SDK

repo sync

由于 SDK 体积普遍较大，拉取可能需要一定的时间，此时可同步进行源码的获取。

获取源码

进入之前创建的 OpenHarmony 文件夹，使用 Repo 工具拉取源码。

cd ../OpenHarmony
repo init -u https://gitee.com/allwinnertech-d1/manifest-sunxi-d1.git -b master -m sunxi_d1.xml --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

源码体积较大，拉取时间较长，此时可提前下载编译工具链。

[!TIP] 若报类似于 Syncing: 25% (63/248) 0:44 | 4 jobs | 0:04 update_packaging_tools @ base/update/packaging_toolserror.GitError: Cannot checkout update_packaging_tools: Cannot initialize work tree for update_packaging_tools 的错误，可能是因为 git-lfs 未安装，使用 sudo apt install git-lfs && git lfs install 安装 git-lfs 后重新运行 repo sync -c 即可。

获取编译工具链

通过百度网盘下载 llvm-riscv 工具链 llvm-riscv-1124.tar.gz，链接为 https://pan.baidu.com/s/19JVNwFrl5ISOAsruW_y9hA?pwd=chds，提取码为 chds。

可将 llvm-riscv-1124.tar.gz 文件放入 nezha 文件夹中，此时文件夹结构如下。

nezha/
├── OpenHarmony/
├── tina-d1/
└── llvm-riscv-1124.tar.gz

构建系统

构建前准备

进入 OpenHarmony 文件夹，修改 ./build/prebuilts_download.sh 文件中的 npm 镜像源，将所有的 http://registry.npm.taobao.org 修改为 https://mirrors.huaweicloud.com/repository/npm/。

cd OpenHarmony
sed -i 's|http://registry.npm.taobao.org|https://mirrors.huaweicloud.com/repository/npm/|g' build/prebuilts_download.sh

运行 ./build/prebuilts_download.sh，下载相关编译工具链与 host 端工具。注意需要提前安装 bzip2，使用 sudo apt update && sudo apt install bzip2 命令以安装。

./build/prebuilts_download.sh

复制编译工具

回到 nezha 文件夹，将 tina-d1/prebuilt/gcc/linux-x86/riscv/toolchain-thead-glibc/riscv64-glibc-gcc-thead_20200702 复制到 OpenHarmony/prebuilts/gcc/linux-x86/riscv/riscv64-glibc-gcc-thead_20200702。

cd nezha
mkdir -p OpenHarmony/prebuilts/gcc/linux-x86/riscv/riscv64-glibc-gcc-thead_20200702
cp -rv tina-d1/prebuilt/gcc/linux-x86/riscv/toolchain-thead-glibc/riscv64-glibc-gcc-thead_20200702/* OpenHarmony/prebuilts/gcc/linux-x86/riscv/riscv64-glibc-gcc-thead_20200702/

解压编译工具链

还是在 nezha 文件夹，将之前下载的 llvm-riscv-1124.tar.gz 工具链解压到 OpenHarmony/prebuilts/clang/ohos/linux-x86_64/llvm-riscv/ 目录下。

tar -xzvf llvm-riscv-1124.tar.gz -C OpenHarmony/prebuilts/clang/ohos/linux-x86_64/

获取 Docker 编译环境

使用预搭建好的 Docker 镜像来构建 OpenHarmony 系统，其中 nezha 文件夹的路径 /path/to/nezha 根据你的实际路径进行替换。

docker pull welyfun/nezha
docker run -dit --name nezha -v /path/to/nezha:/root welyfun/nezha

[!TIP] 若报 docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers) 的错误，为网络问题，可自行搜索配置 Docker 代理地址。

构建系统

进入 Docker 容器。

docker exec -it nezha /bin/bash

进入 OpenHarmony 文件夹并构建系统。

cd /root/OpenHarmony
./build.sh --product-name sunxi_d1 --ccache

构建过程可能需要较长时间（接近一小时），具体取决于你的计算机性能，此时可以去喝杯茶。

出现以下信息时，表示构建成功。

=====build sunxi_d1 successful.
2025-08-01 11:08:37
++++++++++++++++++++++++++++++++++++++++

若报错，大多数错误可通过重复运行 ./build.sh --product-name sunxi_d1 --ccache 来解决。

生成镜像文件

还是在 Docker 容器的 OpenHarmony 文件夹中，运行以下命令生成镜像文件。

./device/sunxi/build/pack

生成的镜像文件位于 ./out/d1-nezha/ 目录下，文件名为 tina_d1-nezha_uart0.img，成功信息如下。

Dragon execute image.cfg SUCCESS !
----------image is for nand/emmc----------
----------image is at----------

/root/OpenHarmony/out/d1-nezha/tina_d1-nezha_uart0.img

pack finish

生成可写镜像文件

默认打包的 rootfs 是 squashfs 类型，只读，不可写。执行: ./device/sunxi/build/pack -e，可生成 ext4 格式（可写）的 rootfs，此时固件大小会超过 256M（D1 开发板 flash 总大小），无法直接烧写，需使用 TF 卡烧写方式，并修改 ./device/sunxi/config/chips/d1/configs/nezha/sys_partition.fex 文件，调大对应分区的 size。

首先打开 ./device/sunxi/config/chips/d1/configs/nezha/sys_partition.fex 文件，找到以下内容。

[partition]
    name         = rootfs
    size         = 258048
    downloadfile = "rootfs.fex"
    user_type    = 0x8000

将 size 的值改为 819200，修改后的内容如下。

[partition]
    name         = rootfs
    size         = 819200
    downloadfile = "rootfs.fex"
    user_type    = 0x8000

随后在 OpenHarmony 文件夹中运行以下命令生成可写镜像文件。

./device/sunxi/build/pack -e

成功后同样显示如下信息。

Dragon execute image.cfg SUCCESS !
----------image is for nand/emmc----------
----------image is at----------

/root/OpenHarmony/out/d1-nezha/tina_d1-nezha_uart0.img

pack finish

生成的可写镜像文件位于 ./out/d1-nezha/ 目录下，文件名为 tina_d1-nezha_uart0.img。

烧写镜像

此处记录烧写镜像至 TF 卡的过程，若要烧写至开发板的 flash 中，请参考官方文档。

烧写工具 PhoenixCard （仅适用于 Windows）于此处下载，注意需要先登录才能下载，下载 PhoenixCardv4.2.7.7z 文件，解压后运行 PhoenixCard.exe，以 启动卡 模式烧写镜像至 TF 卡。

启动系统

将烧写好的 TF 卡插入 D1 开发板，连接好串口线，使用串口工具连接开发板的串口，波特率设置为 115200。最后连接电源线，即可通过串口进入命令行界面。

参考

树莓派 Pico 驱动墨水屏显示信息

Sun, 18 Aug 2024 00:00:00 GMT

墨水屏

显示屏为 2.13 寸黑白电子墨水屏，于微雪电子购买，并利用树莓派 Pico 驱动以显示信息。

树莓派 Pico 环境搭建

于树莓派 5 上进行环境搭建。

创建 pico 文件夹并进入。

mkdir pico
cd pico

Raspberry Pi Pico SDK

参考 GitHub 页面。

安装依赖

安装 CMake 和 GCC 编译器及其相关依赖。

sudo apt install cmake gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib

克隆存储库

git clone https://github.com/raspberrypi/pico-sdk.git

添加环境变量

vi ~/.bashrc

添加 PICO_SDK_PATH 路径。

export PICO_SDK_PATH=/home/ubuntu/pico/pico-sdk

使环境变量立即生效。

source ~/.bashrc

picotool

参考 GitHub 页面。

首先于 pico-sdk 路径下克隆相关库。

cd /home/ubuntu/pico/pico-sdk
git submodule update --init lib/mbedtls
git submodule update --init

若因为网络原因无法完成克隆，可参考错误信息手动克隆至相关目录下。

Submodule 'lib/mbedtls' (https://github.com/Mbed-TLS/mbedtls.git) registered for path 'lib/mbedtls'
Submodule 'lib/btstack' (https://github.com/bluekitchen/btstack.git) registered for path 'lib/btstack'
Submodule 'lib/cyw43-driver' (https://github.com/georgerobotics/cyw43-driver.git) registered for path 'lib/cyw43-driver'
Submodule 'lib/lwip' (https://github.com/lwip-tcpip/lwip.git) registered for path 'lib/lwip'
Submodule 'tinyusb' (https://github.com/hathach/tinyusb.git) registered for path 'lib/tinyusb'

安装依赖

sudo apt install build-essential pkg-config libusb-1.0-0-dev cmake

克隆存储库

cd ~/pico
git clone https://github.com/raspberrypi/picotool.git

编译安装

cd picotool
mkdir build
cd build
cmake ..
make -j8
sudo make install

去除 `sudo` 权限

cd ~/pico/picotool
sudo cp udev/99-picotool.rules /etc/udev/rules.d/

树莓派 Pico 部分程序

例程下载

cd ~/pico
wget  https://www.waveshare.net/w/upload/2/27/Pico_ePaper_Code.zip
unzip Pico_ePaper_Code.zip -d Pico_ePaper_Code
cd Pico_ePaper_Code

编写程序

cd c
mv main.c main.c.bak
vi main.c

程序为以下内容。

#include "DEV_Config.h"
#include "GUI_Paint.h"
#include "ImageData.h"
#include "Debug.h"
#include <stdlib.h>
#include "EPD_2in13_V4.h"
#include "string.h"

int main(void)
{
    stdio_init_all();
    unsigned char data[100]={0};
    unsigned char cpu[100]={0};
    unsigned char cpu_i[100]={0};
    unsigned char cpu_o[100]={0};
    unsigned char mem_p[100]={0};
    unsigned char mem_u[100]={0};
    unsigned char mem_t[100]={0};
    unsigned char disk_p[100]={0};
    unsigned char disk_u[100]={0};
    unsigned char disk_t[100]={0};
    unsigned char ipv4[100]={0};
    unsigned char ipv6[100]={0};

    if(DEV_Module_Init()!=0){
        return -1;
    }

    EPD_2in13_V4_Init();
    EPD_2in13_V4_Clear();

    UBYTE *BlackImage;
    UWORD Imagesize = ((EPD_2in13_V4_WIDTH % 8 == 0)? (EPD_2in13_V4_WIDTH / 8 ): (EPD_2in13_V4_WIDTH / 8 + 1)) * EPD_2in13_V4_HEIGHT;
    if((BlackImage = (UBYTE *)malloc(Imagesize)) == NULL) {
        return -1;
    }
    Paint_NewImage(BlackImage, EPD_2in13_V4_WIDTH, EPD_2in13_V4_HEIGHT, 90, WHITE);
        Paint_Clear(WHITE);

    int n=0;
    int count=0;

    while(1){
    
    n+=1;

    printf("input name: ");
    scanf("%s", data);
    printf("\nHello, %s\n\n", data);
    sscanf(data, "%[^,],%[^,],%[^,],%[^,],%[^,],%[^,],%[^,],%[^,],%[^,],%[^,],%s", &cpu, &cpu_i, &cpu_o, &mem_p, &mem_u, &mem_t, &disk_p, &disk_u, &disk_t, &ipv4, &ipv6);
    printf("%s\n",cpu);
    printf("%s\n\n",cpu_i);

    EPD_2in13_V4_Init_Fast();
    Paint_NewImage(BlackImage, EPD_2in13_V4_WIDTH, EPD_2in13_V4_HEIGHT, 90, WHITE);
    Paint_SelectImage(BlackImage);
    
    Paint_ClearWindows(70, 20, 70 + Font20.Width * 4, 20 + Font20.Height, WHITE);
    Paint_ClearWindows(151, 24, 151 + Font16.Width *4, 24 + Font16.Height, WHITE);
    Paint_ClearWindows(206, 24, 206 + Font16.Width *4, 24 + Font16.Height, WHITE);
    Paint_ClearWindows(70, 40, 70 + Font20.Width * 4, 40 + Font20.Height, WHITE);
    Paint_ClearWindows(151, 44, 151 + Font16.Width *4, 44 + Font16.Height, WHITE);
    EPD_2in13_V4_Display_Partial(BlackImage);
    //DEV_Delay_ms(500);
    Paint_DrawString_EN(70, 20, &cpu, &Font20, WHITE, BLACK);
    Paint_DrawString_EN(151, 24, &cpu_i, &Font16, WHITE, BLACK);
    Paint_DrawString_EN(206, 24, &cpu_o, &Font16, WHITE, BLACK);
    Paint_DrawString_EN(70, 40, &mem_p, &Font20, WHITE, BLACK);
    Paint_DrawString_EN(151, 44, &mem_u, &Font16, WHITE, BLACK);
    EPD_2in13_V4_Display_Partial(BlackImage);
    DEV_Delay_ms(500);
    EPD_2in13_V4_Sleep();
    DEV_Delay_ms(4000);
    
    if(n>=50 || count==0){
        count=1;
        n=0;
        EPD_2in13_V4_Init_Fast();
        Paint_NewImage(BlackImage, EPD_2in13_V4_WIDTH, EPD_2in13_V4_HEIGHT, 90, WHITE);
        Paint_Clear(WHITE);

        Paint_DrawString_EN(27, 0, "Raspberry Pi 5", &Font20, WHITE, BLACK);
        Paint_DrawString_EN(0, 20, "CPU:     %", &Font20, WHITE, BLACK);
        Paint_DrawString_EN(195, 24, "|", &Font16, WHITE, BLACK);
        Paint_DrawString_EN(0, 40, "Mem:     %", &Font20, WHITE, BLACK);
        Paint_DrawString_EN(195, 44, "/", &Font16, WHITE, BLACK);
        Paint_DrawString_EN(206, 44, &mem_t, &Font16, WHITE, BLACK);
        Paint_DrawString_EN(0, 60, "Disk:    %", &Font20, WHITE, BLACK);
        Paint_DrawString_EN(195, 64, "/", &Font16, WHITE, BLACK);
        Paint_DrawString_EN(70, 60, &disk_p, &Font20, WHITE, BLACK);
        Paint_DrawString_EN(151, 64, &disk_u, &Font16, WHITE, BLACK);
        Paint_DrawString_EN(206, 64, &disk_t, &Font16, WHITE, BLACK);
        Paint_DrawString_EN(0, 82, "IPv4:", &Font16, WHITE, BLACK);
        Paint_DrawString_EN(55, 80, &ipv4, &Font20, WHITE, BLACK);
        Paint_DrawString_EN(0, 102, "IPv6:", &Font16, WHITE, BLACK);
        Paint_DrawString_EN(55, 106, &ipv6, &Font8, WHITE, BLACK);
        EPD_2in13_V4_Display_Base(BlackImage);
        DEV_Delay_ms(3000);
    }

    }

    EPD_2in13_V4_Sleep();
    free(BlackImage);
    BlackImage = NULL;
    DEV_Delay_ms(2000);
    return 0;
}

加入头文件路径

编辑 ~/pico/Pico_ePaper_Code/c/CMakeLists.txt 文件。

# add a header directory
include_directories(./lib/e-Paper)

编译程序

mkdir build
cd build
cmake ..
make -j8

运行程序

按住树莓派 Pico 上的 BOOTSEL 按键，同时使用 Micro USB 数据线将 树莓派 Pico 连接至 树莓派 5，连接后放开按键，即可看到树莓派 Pico 的存储空间。

挂载树莓派 Pico 存储。

sudo mount /dev/sda1 /mnt/pico

复制 epd.uf2 文件。

sudo cp -v epd.uf2 /mnt/pico/

释放树莓派 Pico 存储。

sudo umount /mnt/pico

此时树莓派 Pico 将自动运行程序。

树莓派 5 部分程序

树莓派 5 部分为 Python 程序。

安装完整版 `Python`

sudo apt update
sudo apt install python3-full

编写程序

cd ~
mkdir python
cd python
vi pico.py

添加以下程序。

import psutil
import serial
import time

pico=serial.Serial("/dev/ttyACM0",115200)

while True:

    print("Raspberry Pi 5")

    cpu=psutil.cpu_percent(1)
    cpu_temp=psutil.sensors_temperatures()
    print(f"CPU: {cpu}% {cpu_temp['cpu_thermal'][0].current}C/{cpu_temp['rp1_adc'][0].current}C")
    cpu_i=round(cpu_temp['cpu_thermal'][0].current,1)
    cpu_o=round(cpu_temp['rp1_adc'][0].current,1)


    mem=psutil.virtual_memory()
    print(f"Mem: {mem.percent}%({((mem.total-mem.available)/1024**3):.2f}GB/{(mem.total/1024**3):.2f}GB)")
    mem_p=mem.percent
    mem_u=round(((mem.total-mem.available)/1024**3),2)
    mem_t=round((mem.total/1024**3),2)

    disk=psutil.disk_usage('/')
    print(f"Disk: {disk.percent}%({(disk.used/1024**3):.2f}GB/{(disk.total/1024**3):.2f}GB)")
    disk_p=disk.percent
    disk_u=round((disk.used/1024**3),1)
    disk_t=round((disk.total/1024**3),1)

    net=psutil.net_if_addrs()
    print(f"IPv4: {net['eth0'][0].address}")
    print(f"IPv6: {net['eth0'][1].address}")
    ipv4=net['eth0'][0].address
    ipv6=net['eth0'][1].address

    data=str(cpu)+','+str(cpu_i)+','+str(cpu_o)+','+str(mem_p)+','+str(mem_u)+','+str(mem_t)+','+str(disk_p)+','+str(disk_u)+','+str(disk_t)+','+str(ipv4)+','+str(ipv6)+'\n'
    print(data)
    pico.write(data.encode("utf-8"))

    time.sleep(5)

虚拟环境

创建虚拟环境。

python3 -m venv venv

进入虚拟环境。

source venv/bin/activate

安装第三方库。

pip install psutil pyserial

添加执行权限。

chmod +x pico.py

运行程序。

python3 pico.py

退出虚拟环境。

deactivate

开机自动运行

利用 bash 脚本与 systend 服务使其成为守护进程。

编写 `bash` 脚本

vi pico.sh

添加以下内容。

#!/usr/bin/bash
source /home/ubuntu/python/venv/bin/activate
python3 /home/ubuntu/python/pico.py

添加执行权限。

chmod +x pico.sh

添加系统服务。

cd /etc/systemd/system
sudo vi pico.service

添加以下内容。

[Unit]
Description=pico e-Paper
After=network-online.target
Wants=network-online.target

[Service]
TimeoutStartSec=0
ExecStart=/home/ubuntu/python/pico.sh
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

添加开机启动服务。

sudo systemctl enable pico

启动服务。

sudo systemctl start pico

查看服务状态。

sudo systemctl status pico

至此墨水屏可以正常显示树莓派 5 系统信息。

参考

树莓派 5 安装 Ubuntu Server 24.04 LTS 记录

Fri, 31 May 2024 00:00:00 GMT

使用树莓派 5 安装 Ubuntu Server 24.04 LTS 作为小型服务器使用，并部署包括 docker 在内的各项服务，在此进行记录。

安装 Ubuntu Server 24.04 LTS

此时需要准备一个 TF 卡。

刷入系统

先到 Ubuntu 官网下载系统镜像文件，这里我选择的是 Ubuntu 服务器 24.04 LTS 64 位镜像。

然后到树莓派官网下载系统刷入工具 Raspberry Pi Imager。运行后选择刚才下载的镜像并选择对应的 TF 卡进行刷入。

刷写配置可选择修改主机名、用户名和密码，并记住勾选使用 SSH 连接，如果需要连接无线网络也可以选择配置。

刷写结束 TF 卡会自动弹出，将其插入断电状态的树莓派，然后接通电源，系统启动。

登录系统

使用 ssh 工具登录系统，若没有配置主机名、用户名和密码，默认主机名为 ubuntu，默认用户名为 ubuntu，默认密码为 ubuntu。第一次登录时会要求修改默认密码。

安装中文语言包

Ubuntu Server 系统安装时默认语言为英语，现在将其修改为中文。

首先安装简体中文语言包。

sudo apt update
sudo apt install language-pack-zh-hans

将区域语言设置为简体中文。

localectl set-locale LANG=zh_CN.UTF-8

重启以应用更改。

sudo reboot

查看当前区域语言设置。

locale

测试是否为中文输出。

sudo apt update

删除 Snap 商店

sudo apt autoremove --purge snapd

创建 `Swap` 交换空间

开启 `Swap`

创建一个 swap 文件。

sudo dd if=/dev/zero of=/swapfile bs=1M count=8192

设置文件权限。

sudo chmod 600 /swapfile

把文件设置为 Swap 空间。

sudo mkswap /swapfile

启用 Swap 空间。

sudo swapon /swapfile

开机自动挂载 Swap 空间。

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

最后，检查 Swap 空间是否已启用。

free -h

关闭 `Swap`

关闭 Swap 空间。

sudo swapoff /swapfile

停止开机自动挂载。

sudo sed -i '/swapfile/d' /etc/fstab

删除 swap 文件。

sudo rm /swapfile

挂载移动硬盘

查看当前磁盘情况。

lsblk

首先，创建需要挂载的文件夹。

sudo mkdir /mnt/sda1

开机磁盘挂载文件保存于 /etc/fstab。

sudo vi /etc/fstab

加入这一行命令来挂载磁盘。

/dev/sda1 /mnt/sda1 ntfs defaults,nofail 0 0

挂载磁盘。

sudo mount -av

再次查看当前磁盘情况。

lsblk

配置 SMB 文件共享

安装 Samba 服务。

sudo apt update
sudo apt install samba

要共享的目录必须存在才能被共享，给共享目录赋予权限。

sudo chmod 777 -R /mnt/sda1

配置共享设置。

sudo vi /etc/samba/smb.conf

在 [global] 下加入以兼容 iOS 文件应用。

vfs objects = acl_xattr catia fruit streams_xattr

加入共享目录。

[share]
  path = /mnt/sda1
  writable = yes
  read only = no
  guest ok = yes
  guest only = yes
  public = yes
  browseable = yes
  available = yes
  create mode = 0777
  directory mode = 0777

重启 Samba 服务守护进程，查看服务运行状态。

sudo systemctl restart smbd
sudo systemctl status smbd

使用 Cloudflared 建立隧道

curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64.deb && 

sudo dpkg -i cloudflared.deb && 

sudo cloudflared service install <token>

部署 Docker

首先卸载可能已经存在的旧版本 docker。

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

加入 docker 仓库。

# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

安装 docker。

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

修改镜像源，编辑 /etc/docker/daemon.json 文件，在其中添加以下内容。

{
  "registry-mirrors": ["https://mirror"]
}

然后重启 docker 服务。

sudo systemctl restart docker

验证安装。

sudo docker run hello-world

加入用户组以避免权限问题。

# 添加 docker 用户组，一般已存在，不需要执行

sudo groupadd docker

# 将用户加入到docker用户组中

sudo gpasswd -a $USER docker

# 更新用户组

newgrp docker

# 测试 docker 命令是否可以直接使用

docker version

小雅 5678

查看小雅使用文档。

sudo bash -c "$(curl --insecure -fsSL https://ddsrem.com/xiaoya_install.sh)"

sudo vi /etc/xiaoya/myruntime.txt

sudo bash -c "$(curl http://docker.xiaoya.pro/update_data.sh)"

ddns-go

docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go

在浏览器中打开 http://主机IP:9876，并修改你的配置。

Portainer 9000

首先，创建 Portainer Server 将用于存储其数据库的卷。

sudo docker volume create portainer_data

然后，下载并安装 Portainer Server 容器。

sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Dashdot 3001

sudo docker run -dit \
  --restart always \
  --privileged \
  --name dashdot \
  -p 3001:3001 \
  -v /:/mnt/host:ro \
  -e DASHDOT_ENABLE_CPU_TEMPS=true \
  -e DASHDOT_ALWAYS_SHOW_PERCENTAGES=true \
  -e DASHDOT_PAGE_TITLE="Raspberry Pi 5" \
  -e DASHDOT_SHOW_HOST=true \
  -e DASHDOT_CUSTOM_HOST="Raspberry Pi 5" \
  mauricenino/dashdot:latest

Aria2 + AriaNg + Filebrowser 8000

首先查看该项目的 GitHub 页面来创建必要的文件。

sudo docker run -d --name ariang \
  --restart always \
  -p 8000:80 \
  -p 6800:6800 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e ENABLE_AUTH=false \
  -e ENABLE_RCLONE=false \
  -e ARIA2_SSL=false \
  -e ARIA2_EXTERNAL_PORT=6800 \
  -e CADDY_LOG_LEVEL=ERROR \
  -v /mnt/sda1/download:/data \
  -v /home/ubuntu/docker-v/aria2/app/.cache:/app/.cache \
  -v /home/ubuntu/docker-v/aria2/app/a.db:/app/filebrowser.db \
  -v /home/ubuntu/docker-v/aria2/app/conf/key:/app/conf/key \
  -v /home/ubuntu/docker-v/aria2/app/conf:/app/conf \
  wahyd4/aria2-ui

Aria2: http://ubuntu:8000

FileManger: http://ubuntu:8000/files

默认用户名和密码均为 admin。

Rclone: http://ubuntu:8000/rclone

Excalidraw 10001

sudo docker run -dit --restart always --name excalidraw -p 10001:80 welywely/excalidraw:latest

Speed Test 10002

sudo docker run -dit --restart always --name speedtest -p 10002:80 linuxserver/librespeed:latest

Draw.io 10003

sudo docker run -dit --restart always --name drawio -p 10003:8080 jgraph/drawio:latest

Flare 5005

sudo docker run -dit --restart always --name flare -p 5005:5005 -v /home/ubuntu/docker-v/flare/app:/app soulteary/flare

Calibre-Web 8083

首先，在 GitHub 页面下载数据库文件。

sudo docker run -d \
  --name=calibre-web \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8083:8083 \
  -v /home/ubuntu/docker-v/calibre-web/data:/config \
  -v /home/ubuntu/docker-v/calibre-web/calibre/library:/books \
  --restart always \
  lscr.io/linuxserver/calibre-web:latest

默认用户名为 admin。默认密码为 admin123。

IT-Tools 9600

sudo docker run -d --name it-tools --restart always -p 9600:80 corentinth/it-tools:latest

Stirling-PDF 9700

sudo docker run -d \
  -p 9700:8080 \
  -v /home/ubuntu/docker-v/s-pdf/trainingData:/usr/share/tessdata \
  -v /home/ubuntu/docker-v/s-pdf/extraConfigs:/configs \
  -v /home/ubuntu/docker-v/s-pdf/logs:/logs \
  -e DOCKER_ENABLE_SECURITY=false \
  -e INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false \
  -e LANGS=zh_CN \
  --name stirling-pdf \
  --restart always \
  frooodle/s-pdf:latest

EmulatorJS 9800 3000

sudo docker run -d \
  --name=emulatorjs \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e SUBFOLDER=/ `#optional` \
  -p 3000:3000 \
  -p 9800:80 \
  -p 4001:4001 `#optional` \
  -v /home/ubuntu/docker-v/emulatorjs/config:/config \
  -v /home/ubuntu/docker-v/emulatorjs/data:/data \
  --restart always \
  lscr.io/linuxserver/emulatorjs:latest

Minecraft Bedrock Server

创建 Docker Compose 文件。

mkdir /home/ubuntu/docker-v/mc-bedrock
cd /home/ubuntu/docker-v/mc-bedrock
vi docker-compose.yml

填写以下内容。

services:
  mc:
    image: itzg/minecraft-bedrock-server
    restart: always
    environment:
      TZ: "Asia/Shanghai"
      EULA: "TRUE"
      SERVER_NAME: "Wely"
      LEVEL_NAME: "World"
    ports:
      - "19132:19132/udp"
    volumes:
      - /home/ubuntu/docker-v/mc-bedrock/data:/data
    stdin_open: true
    tty: true

然后建立容器。

sudo docker compose up -d

Minecraft Server on Docker (Java Edition)

创建 Docker Compose 文件。

mkdir /home/ubuntu/docker-v/mc-java
cd /home/ubuntu/docker-v/mc-java
vi docker-compose.yml

填写以下内容。

services:
  mc:
    image: itzg/minecraft-server
    restart: always
    environment:
      TZ: "Asia/Shanghai"
      SNOOPER_ENABLED: "false"
      SERVER_NAME: "Wely"
      MAX_PLAYERS: "10"
      LEVEL: "World"
      MODE: "survival"
      DIFFICULTY: "normal"
      EXEC_DIRECTLY: "true"
      GUI: "false"
      INIT_MEMORY: "1G"
      MAX_MEMORY: "4G"
      ENABLE_ROLLING_LOGS: "true"
      EULA: "true"
    ports:
      - "25565:25565"
    volumes:
      - /home/ubuntu/docker-v/mc-java/data:/data
    stdin_open: true
    tty: true

或者使用 fabric 服务端.

services:
  mc:
    image: itzg/minecraft-server
    restart: always
    environment:
      TYPE: "FABRIC"
      FABRIC_LAUNCHER: "fabric-server-mc.1.21-loader.0.15.11-launcher.1.0.1.jar"
      TZ: "Asia/Shanghai"
      SNOOPER_ENABLED: "false"
      SERVER_NAME: "Wely"
      MAX_PLAYERS: "10"
      LEVEL: "fabric-world"
      MODE: "survival"
      DIFFICULTY: "normal"
      EXEC_DIRECTLY: "true"
      GUI: "false"
      INIT_MEMORY: "1G"
      MAX_MEMORY: "4G"
      ENABLE_ROLLING_LOGS: "true"
      EULA: "true"
    ports:
      - "25565:25565"
    volumes:
      - /home/ubuntu/docker-v/mc-java/data:/data
    stdin_open: true
    tty: true

然后建立容器。

sudo docker compose up -d

对于 Docker 无法访问的解决方案

在另一台可以访问的机器上拉取镜像，再传输到需要使用镜像的机器上。

首先拉取对应平台的镜像。

docker pull --platform linux/arm64 image

导出镜像。

docker save -o image.tar image

将 image.tar 文件传输至需要使用镜像的机器，再导入本地镜像。

docker load -i image.tar

此时，导入的镜像包含所有的元数据。

查看路由器校园网 IP

路由器脚本。

#! /bin/ash
echo "==========Start=========="
echo `date '+%Y-%m-%d %H:%M:%S'`
#get current wan_ip
current_wan_ip=`ifconfig -a | grep inet | grep -v inet6 | grep -v 127.0.0.1 | grep -v 192.168.8.1 | awk '{print $2}' | tr -d "addr:"`
echo "IP: $current_wan_ip"
#if ip.html
if [ ! -f "ip.html" ]; then
	echo ${current_wan_ip} > ip.html
	echo "craete ip.html"
else
	last_ip=`cat ip.html`
	if [ "${current_wan_ip}" != "${last_ip}" ]; then
		#renew ip.html
		echo ${current_wan_ip} > ip.html
		echo "renew ip.html"
	else
		echo "no difference"
	fi
fi
echo `date '+%Y-%m-%d %H:%M:%S'`
echo -e "==========End==========\n"

树莓派脚本。

sudo sshpass -p password scp -O -o StrictHostKeyChecking=no -o HostKeyAlgorithms=+ssh-rsa -o PubkeyAcceptedKeyTypes=+ssh-rsa root@192.168.8.1:/root/ip.html /home/ubuntu/server-ip/ip.html

使用 nginx。

sudo docker run -dit --restart always -p 23333:80 --name nginx -v /home/ubuntu/server-ip:/usr/share/nginx/html nginx

Docker 备份脚本

#! /bin/sh
cd /home/ubuntu
sudo tar -czvf docker-v.tar.gz docker-v
sudo mv docker-v.tar.gz /mnt/sda1/docker-backup/docker-v-$(date +%Y%m%d%H%M%S).tar.gz
find /mnt/sda1/docker-backup/ -mtime +7 -name "*.tar.gz" -exec rm -rf {} \;

树莓派 5 风扇

随着树莓派温度的升高，风扇会做出以下反应：

低于 50°C，风扇不旋转（ 0% 速度）
50°C 时，风扇以低速运转（ 30% 速度）
60°C 时，风扇速度增加至中速（ 50% 速度）
67.5°C 时，风扇转速增至高速（ 70% 转速）
75°C 时，风扇升至全速（ 100% 速度）

温度降低时风扇速度也与温度范围有相同的匹配关系，具有 5°C 的滞后；当温度降至低于上述每个阈值 5°C 时，风扇速度会降低。

USB 端口和风扇插口均采用相同的 1.6 A 电流限制。

所有型号的 Raspberry Pi 都进行了一定程度的热管理，以避免在大负荷下过热。SoC 有一个内部温度传感器，GPU 上的软件会对其进行轮询，以确保温度不超过我们为所有型号设定的 85°C 上限。可以将其设置为更低的值，但不能设置为更高的值。当设备接近极限值时，芯片上使用的各种频率和电压会降低。这样可以减少产生的热量，从而控制温度。

当核心温度在 80°C 到 85°C 之间时，ARM 核心将逐渐降低温度。如果温度达到 85°C ，ARM 内核和 GPU 都会受到限制。

Docker build drawio with arm v7

Mon, 27 May 2024 00:00:00 GMT

Draw.io is a Security-first diagramming for teams. And we can run our own draw.io server with Docker.

But unfortunately, there is no arm/v7 version. There is an similar question on the GitHub. So I try to build it and answer that question.

I have solved this question and built an arm/v7 version, which run on my arm/v7 platform successfully.

I pushed it at Docker Hub.

Anyone can use the arm/v7 version with docker pull welywely/drawio

How can I build the arm/v7 version

First, git clone https://github.com/jgraph/docker-drawio.git

The Dockerfile is at docker-drawio-dev/main/Dockerfile

Then docker build --platform linux/arm/v7 -t welyfun/drawio:latest --push .

I tried to change FROM openjdk:11-jdk-slim AS build to FROM adoptopenjdk/openjdk11:armv7l-debianslim-jdk-11.0.23_9-slim AS build in the first line to support arm/v7 and run build.

Then I meet this error.

Buildfile: /tmp/drawio/etc/build/build.xml

merge:
[jscomp] Compiling 1 file(s) with 112 extern(s)
#
# A fatal error has been detected by the Java Runtime Environment:
#
#SIGBUS (0x7) at pc=0x413ee354, pid=28, tid=101
#
# JRE version: OpenJDK Runtime Environment Temurin-11.0.23+9 (11.0.23+9) (build 11.0.23+9)
# Java VM: OpenJDK Server VM Temurin-11.0.23+9 (11.0.23+9, mixed mode, g1 gc, linux-)
# Problematic frame:
#V[libjvm.so+0xa63354]
#
#No core dump will be written. Core dumps have been disabled. To enable core dumping, try "ulimit -c unlimited" before starting Java again
#
# An error report file with more information is saved as:
# /tmp/drawio/etc/build/hs_err_pid28.log
#
# If you would like to submit a bug report, please visit:
#   https://github.com/adoptium/adoptium-support/issues
#
qemu: uncaught target signal 6 (Aborted) - core dumped
Aborted

I tried other similar images, but no one worked.

Solution

Run the following command outside the docker to get the draw.war, which means run in the system directly.

git clone --depth 1 https://github.com/jgraph/drawio.git
cd drawio/etc/build/
ant war

Copy the draw.war at drawio/build/draw.war to docker-drawio-dev/main/, which is the same contents with Dockerfile.

Then change COPY --from=build /tmp/drawio/build/draw.war /tmp to COPY draw.war /tmp in the Dockerfile and delete the command line before FROM tomcat:9-jre11.

Now the Dockerfile only has these commands.

FROM tomcat:9-jre11

LABEL maintainer="JGraph Ltd" \
      org.opencontainers.image.authors="JGraph Ltd" \
      org.opencontainers.image.url="https://www.drawio.com" \
      org.opencontainers.image.source="https://github.com/jgraph/docker-drawio"

ENV RUN_USER            tomcat
ENV RUN_GROUP           tomcat

RUN apt-get update -y && \
    apt-get install -y --no-install-recommends \
        certbot \
        curl \
        xmlstarlet \
        unzip && \
    apt-get autoremove -y --purge && \
    apt-get clean && \
    rm -r /var/lib/apt/lists/*

COPY draw.war /tmp

# Extract draw.io war & Update server.xml to set Draw.io webapp to root
RUN mkdir -p $CATALINA_HOME/webapps/draw && \
    unzip /tmp/draw.war -d $CATALINA_HOME/webapps/draw && \
    rm -rf /tmp/draw.war /tmp/drawio && \
    cd $CATALINA_HOME && \
    xmlstarlet ed \
        -P -S -L \
        -i '/Server/Service/Engine/Host/Valve' -t 'elem' -n 'Context' \
        -i '/Server/Service/Engine/Host/Context' -t 'attr' -n 'path' -v '/' \
        -i '/Server/Service/Engine/Host/Context[@path="/"]' -t 'attr' -n 'docBase' -v 'draw' \
        -s '/Server/Service/Engine/Host/Context[@path="/"]' -t 'elem' -n 'WatchedResource' -v 'WEB-INF/web.xml' \
        conf/server.xml

# Copy docker-entrypoint
COPY docker-entrypoint.sh /
RUN chmod 755 /docker-entrypoint.sh
# Add a tomcat user
RUN groupadd -r ${RUN_GROUP} && useradd -g ${RUN_GROUP} -d ${CATALINA_HOME} -s /bin/bash ${RUN_USER} && \
    chown -R ${RUN_USER}:${RUN_GROUP} ${CATALINA_HOME}

USER ${RUN_USER}

WORKDIR $CATALINA_HOME

EXPOSE 8080 8443

ENTRYPOINT ["/docker-entrypoint.sh"]
CMD ["catalina.sh", "run"]

Now you can build the arm/v7 version with docker build --platform linux/arm/v7 -t welywely/drawio:latest --push .

使用 Ruffle 复活 Flash 游戏

Sun, 05 May 2024 00:00:00 GMT

尽管 Flash 已经没落，仍然有许多优秀的 Flash 游戏陪伴我们成长。使用 Ruffle 这一开源 Flash Player 模拟器，可在所有现代操作系统和浏览器上本地运行，无需大惊小怪即可让 Flash 内容栩栩如生。

安装 Ruffle

对于想要在本地运行 Flash 文件的用户，在官网下载安装包即可。如果只想在浏览器中运行 Flash 文件，可以直接安装浏览器扩展。

嵌入 HTML 网页

如果你是网站管理员，并且希望用户不需要安装任何插件即可运行网页上的 Flash 内容，那么只需要几行代码，即可嵌入 Flash 内容。

Ruffle 可以自动替换网站上任何带有 Ruffle 元素的旧式 Flash 嵌入，只需要在网页中包含以下脚本标签：

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>

下面是嵌入到 HTML 文件中的 Flash 的简单示例，其中 movie.swf 即为需要运行的 Flash 文件：

<body>
    <object>
        <embed src="movie.swf" width="550" height="400" />
    </object>

    <script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
</body>

或者使用 JavaScript API 调用 Ruffle，下面是使用 Ruffle JavaScript API 播放位于 Web 服务器根目录中的 SWF 文件的示例，其中 movie.swf 即为需要运行的 Flash 文件：

<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.addEventListener("load", (event) => {
        const ruffle = window.RufflePlayer.newest();
        const player = ruffle.createPlayer();
        const container = document.getElementById("container");
        container.appendChild(player);
        player.load("movie.swf");
    });
</script>
<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>

下面是一个浏览器最大界面运行 Flash 文件的完整网页示例：

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <title>游戏名称</title>
    <style>
        /* 确保html和body元素占满整个屏幕 */
        html, body {
            height: 100%;
            margin: 0;
            overflow: hidden; /* 隐藏滚动条 */
        }
        /* 使容器和Ruffle播放器全屏和自适应 */
        #container {
            width: 100%;
            height: 100%;
            display: flex;
            justify-content: center;
            align-items: center;
        }
        #container ruffle-player {
            flex-shrink: 0; /* 防止播放器被压缩 */
            width: 100%;
            height: 100%;
        }
    </style>
</head>
<body>
    <div id="container"></div>
    <script src="//unpkg.com/@ruffle-rs/ruffle"></script>
    <script>
      window.addEventListener('load', async () => {
          const ruffle = window.RufflePlayer.newest();
          const player = ruffle.createPlayer();
          const container = document.getElementById('container');
          container.appendChild(player);
          player.load('game.swf');
      });
    </script>
</body>
</html>

新建一个文本文档并重命名为 index.html，将以上网页示例代码粘贴到 HTML 文件中，并将 game.swf 指定为你需要运行的 Flash 游戏。在该 HTML 文件目录下打开终端，使用 python 命令 python -m http.server 快速创建一个本地服务器，然后在浏览器中打开 http://127.0.0.1:8000 即可查看自己的 Flash 游戏网页。

跨域问题

如果运行 Flash 的网页地址为 play.example.com，但运行的 Flash 文件 game.swf 存放在另一个网页 flash.example.com 中，如果没有配置跨域访问，便会在运行网页看到类似错误：

此时按下 F12 打开浏览器控制台即可看到类似跨域错误：

如果你同样使用了 Cloudflare 来托管网站，那么可以采取以下措施。

来到 Flash 文件所在 域名 - 规则 - 转换规则 - 修改相应头 下 创建规则 。

规则名称 随便填。

当传入请求匹配时...

字段	运算符	值
主机名	等于	`flash.example.com`

flash.example.com 即为存放 Flash 文件的地址。

则...

设置静态：Access-Control-Allow-Methods = GET,HEAD,POST,OPTIONS。

设置静态：Access-Control-Allow-Origin = *。

然后 部署 。

然后即可在网页里享受 Flash 游戏。

参考：

博客图床测试

Thu, 02 May 2024 00:00:00 GMT

封面图片来源

这篇博客用于测试基于本博客专用的图床系统，该图床基于 Cloudflare Workers 和 Cloudflare R2 存储桶搭建。

以下查看使用 Markdown 直接插入图片的显示效果。

理论上来说，该图片仅在本博客下可以正常显示，使用新标签页打开此图片的来源地址时会禁止访问。

注意，从本博客点击图片来源地址仍可以访问，例如点击博客开头的封面图片来源或在图片上右击选择新标签页打开，此时仍可以访问图片。如果直接新建空白标签页并粘贴图片地址，访问将被禁止。搭建方法来源于 CloudflareR2快速开始使用(白嫖)指南和 Cloudflare R2对象存储当图床测试。

基于 Cloudflare 的搭建方法

首先创建 R2 存储桶。

然后创建 Cloudflare Workers 项目，代码如下：

addEventListener("fetch", event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const objectName = url.pathname.slice(1) // /path/to/file => path/to/file

  console.log(`${request.method} object ${objectName || '(root)'}: ${request.url}`)

  // 只允许 GET / HEAD
  if (request.method !== 'GET' && request.method !== 'HEAD') {
    return new Response('Method Not Allowed', { status: 405 })
  }

  // 不提供根路径列表，直接返回 404，避免暴露 bucket 结构
  if (!objectName) {
    return new Response('Not Found', { status: 404 })
  }

  // ====== GET：读取对象内容 ======
  if (request.method === 'GET') {
    const object = await R2.get(objectName, {
      // 让 R2 自己解析 Range、条件请求等头
      range: request.headers,
      onlyIf: request.headers,
    })

    if (object === null) {
      return objectNotFound(objectName)
    }

    const headers = new Headers()
    // 将 R2 中保存的 HTTP 元数据写入响应（Content-Type、Cache-Control 等）
    object.writeHttpMetadata(headers)
    headers.set('etag', object.httpEtag)

    // 如果客户端发送了 Range 头，则声明支持分块
    if (request.headers.has('range')) {
      headers.set('accept-ranges', 'bytes')
    }

    // object.body 为空表示满足条件请求（如 If-None-Match），返回 304
    const status = object.body
      ? (request.headers.has('range') ? 206 : 200)
      : 304

    return new Response(object.body, { status, headers })
  }

  // ====== HEAD：只返回元信息，不返回 body ======
  if (request.method === 'HEAD') {
    const object = await R2.head(objectName)

    if (object === null) {
      return objectNotFound(objectName)
    }

    const headers = new Headers()
    object.writeHttpMetadata(headers)
    headers.set('etag', object.httpEtag)

    return new Response(null, { status: 200, headers })
  }
}

// 404 响应
function objectNotFound(objectName) {
  return new Response(
    `<html><body>R2 object "<b>${objectName}</b>" not found</body></html>`,
    {
      status: 404,
      headers: {
        'content-type': 'text/html; charset=UTF-8'
      }
    }
  )
}

回到新建的 Workers 项目首页，来到 设置 - 变量 - R2 存储桶绑定 ，添加绑定 后变量名称填写 R2 ，R2 存储桶选择刚才创建的图床存储桶，然后 部署 。

使用方法

来到 Cloudflare R2 存储桶首页，选择图床所在的存储桶，直接上传图片即可。需要访问图片时，如果你的图床 Workers 项目自定义域为 img.example.com ，图片文件名为 img.png ，那么访问地址为 https://img.example.com/img.png 。

安全性措施

Cloudflare 提供的 R2 存储桶的免费容量为 10 GB 每月，免费的 A 类操作次数为 100 万次每月，免费的 B 类操作次数为 1000 万次每月。正常自己使用是用不完的。~~被刷了那就乖乖掏钱吧~~

配置 Cloudflare 缓存

新方法

推荐使用新方法，新方法不会占用免费的3个页面规则，两种方法选一种配置即可。

来到图床所在 域名 - 缓存 - Cache Rules 下 创建规则 。

规则名称 随便填。

当传入请求匹配时...

字段	运算符	值
主机名	等于	`img.example.com`

img.example.com 即为图床的地址。

则...

缓存资格：符合缓存条件。

添加 边缘 TTL：忽略缓存控制标头，使用此 TTL => 6 个月。

添加 浏览器 TTL：忽略缓存控制标头，使用此 TTL => 1 个月。

然后 部署 。

传统方法

不推荐，此方法会占用免费的3个页面规则。

来到图床所在 域名 - 规则 - 页面规则 下 创建页面规则 。

URL 填 img.example.com/*

img.example.com 即为图床的地址，/* 是指该地址下所有内容。

点击 + 添加设置 。

选取设置	选择
`缓存级别`	`缓存所有内容`
`浏览器缓存 TTL`	`1天` ~~最高都可以到1年~~
`边缘缓存 TTL`	`1个月`

然后 保存和部署页面规则 。

现在访问图片时，访问的都是 Cloudflare CDN 服务器上的内容，不会占用 R2 存储桶的操作次数。

浏览器缓存 TTL 是指浏览器第一次访问这个地址后，就会把地址对应的文件缓存到本地。

接下来在 TTL 时间内，浏览器再次访问这个地址时，都是直接调用本地缓存的文件。

边缘缓存 TTL 是指你第一次访问这个地址后，为你提供这个地址资源的 CDN 节点会缓存这个地址对应的文件。

接下来在 TTL 时间内，你再次通过这个节点访问这个地址时，这个节点会直接调用缓存的文件。

TTL 就是缓存有效期，过期后就要重新缓存。

防盗链

防盗链就是防止别的网站直接抓取我的网站，然后显示在它的网站上，就是防止我的图床承担其他网站的访问流量~~然后免费次数被刷爆了掏钱~~。

来到图床所在 域名 - 安全性 - WAF 下 创建规则 。

规则名称 随便填。

字段	运算符	值
引用方	不包含	`blog.example.com`
And
主机名	等于	`img.example.com`

其中 blog.example.com 即为博客地址，img.example.com 即为图床地址。

然后采取措施：阻止 。

此时只有在博客 blog.example.com 内访问图床 img.example.com 才可以成功。如果不是从博客 blog.example.com 内访问图床 img.example.com ，访问请求将被阻止。

这样对图床地址就有了一个基本的保护。

HTML 常用转义字符对照表

Wed, 01 May 2024 00:00:00 GMT

以下内容来自于 html 常用转义字符对照表。

字符	十进制	转义字符	描述
<code> </code>	` `	` `	空格
`@`	`@`	`&commat;`	at 符号
`©`	`©`	`©`	版权符号
`!`	`!`	`&excl;`	感叹号
`¡`	`¡`	`¡`	倒置感叹号
`:`	`:`	`&colon;`	冒号
`,`	`,`	`,`	逗号
`·`	`·`	`·`	中间点
`‘`	`'`	`'`	撇号
`‘`	`‘`	`‘`	左单引号
`“`	`“`	`“`	左双引号
`(`	`(`	`(`	左括号
`[`	`[`	`[`	左方括号
`{`	`{`	`{`	左花括号
`§`	`§`	`§`	分节符号
`_`	`_`	`&lowbar;`	单下划线
<code>\|</code>	`\|`	`\|`	竖线
`‖`	`‖`	`&Verbar;`	双竖线
`∠`	`∠`	`&ang;`	角
`#`	`#`	`&num;`	数字标志
`$`	`$`	`&dollar;`	美元符号
`%`	`%`	`&percnt;`	百分号
`‰`	`‰`	`&permil;`	千分号
`‱`	`‱`	`pertenk;`	万分号
`*`	`*`	`&ast;`	星号
`/`	`/`	`/`	斜线符号
`+`	`+`	`&add;`	加号
`×`	`×`	`×`	乘号
`=`	`=`	`&equal;`	等于号
`≈`	`≈`	`≈`	约等于
`<`	`<`	`<`	小于号
`≤`	`≤`	`≤`	小于等于
`¹`	`¹`	`¹`	上标 1
`²`	`²`	`²`	上标 2
`³`	`³`	`³`	上标 3
`&`	`&`	`&`	and 符号
`®`	`®`	`®`	注册商标符
`?`	`?`	`&quest;`	问号
`¿`	`¿`	`¿`	倒置问号
`;`	`;`	`&semi;`	分号
`.`	`.`	`&period;`	句号
`•`	`•`	`•`	加重号
`“`	`"`	`"`	引号
`’`	`’`	`’`	右单引号
`”`	`”`	`”`	右双引号
`)`	`)`	`)`	右括号
`]`	`]`	`]`	右方括号
`}`	`}`	`}`	右花括号
`¶`	`¶`	`¶`	段落符号
`__`	`̲`	`&UnderBar;`	双下划线
`¦`	`¦`	`¦`	间断竖线
`…`	`…`	`…`	三点省略号
`^`	`^`	`&Hat;`	hat符号
`π`	`ρ`	`π`	圆周率
`¥`	`¥`	`¥`	元符号
`°`	`°`	`°`	度符号
`√`	`√`	`√`	平方根
`∞`	`∞`	`∞`	正无穷
`±`	`±`	`±`	加减符号
`\`	`\`	`\`	反斜线符号
`–`	`–`	`–`	减号
`÷`	`÷`	`÷`	除号
`≠`	`≠`	`≠`	不等于
`≡`	`≡`	`&equiv;`	相当于
`>`	`>`	`>`	大于号
`≥`	`≥`	`≥`	大于等于
`¼`	`¼`	`¼`	四分之一
`½`	`½`	`½`	二分之一
`¾`	`¾`	`¾`	四分之三

除此之外，还可以使用 \ 来进行转义，例如要转义反引号 ` 可以写为 \` 的形式。

Markdown 语法

Wed, 01 May 2024 00:00:00 GMT

以下内容来自于 Markdown 语法速查表。

总览

Markdown 速查表提供了所有 Markdown 语法元素的基本解释。如果你想了解某些语法元素的更多信息，请参阅更详细的基本语法和扩展语法。

基本语法

这些是 John Gruber 的原始设计文档中列出的元素。所有 Markdown 应用程序都支持这些元素。

元素	Markdown 语法
标题（Heading）	`# H1` <br> `## H2` <br> `### H3`
粗体（Bold）	`bold text`
斜体（Italic）	`italicized text`
引用块（Blockquote）	`> blockquote`
有序列表（Ordered List）	`1. First item` <br> `2. Second item` <br> `3. Third item`
无序列表（Unordered List）	`- First item` <br> `- Second item` <br> `- Third item`
代码（Code）	`code`
分隔线（Horizontal Rule）	`---`
链接（Link）	`[title](https://www.example.com)`
图片（Image）	`![alt text](image.jpg)`

扩展语法

这些元素通过添加额外的功能扩展了基本语法。但是，并非所有 Markdown 应用程序都支持这些元素。

元素	Markdown 语法
表格（Table）	<code> \| Syntax \| Description \| </code> <br> <code> \| ------------ \| ------------- \| </code> <br> <code> \| Header \| Title \| </code> <br> <code> \| Paragraph \| Text \| </code>
代码块（Fenced Code Block）	<code> ``` <br> { <br> "firstName": "John", <br> "lastName": "Smith", <br> "age": 25 <br> } <br> ```</code>
脚注（Footnote）	Here's a sentence with a footnote. `[^1]` <br> `[^1]`: This is the footnote.`
标题编号（Heading ID）	`### My Great Heading {#custom-id}`
定义列表（Definition List）	<code> term <br> : definition </code>
删除线（Strikethrough）	`~~The world is flat.~~`
任务列表（Task List）	`- [x] Write the press release` <br> `- [ ] Update the website` <br> `- [ ] Contact the media`

额外

在表格内换行，可使用 <br> 标签。

在表格内显示字符需要转义，例如插入数线 | 需要写为 | ，插入反引号 ` 需要写为 \` 的形式。

更多转移字符的写法可以查看我的这一篇博客内容。

在网页中嵌入随机名言

Wed, 01 May 2024 00:00:00 GMT

什么是一言？

以下是一言开发者文档中的介绍：

动漫也好、小说也好、网络也好，不论在哪里，我们总会看到有那么一两个句子能穿透你的心。我们把这些句子汇聚起来，形成一言网络，以传递更多的感动。如果可以，我们希望我们没有停止服务的那一天。

简单来说，一言指的就是一句话，可以是动漫中的台词，也可以是网络上的各种小段子。或是感动，或是开心，有或是单纯的回忆。来到这里，留下你所喜欢的那一句句话，与大家分享，这就是一言存在的目的。

打开一言的官网，映入眼帘的便是每次都会刷新的一句话，也可以通过它提供的接口，将这句话嵌入到我们自己的网页中。

接口的调用

官方文档给出了这样的调用方法：

<p id="hitokoto">
  <a href="#" id="hitokoto_text">:D 获取中...</a>
</p>
<script>
  fetch('https://v1.hitokoto.cn')
    .then(response => response.json())
    .then(data => {
      const hitokoto = document.querySelector('#hitokoto_text')
      hitokoto.href = `https://hitokoto.cn/?uuid=${data.uuid}`
      hitokoto.innerText = data.hitokoto
    })
    .catch(console.error)
</script>

这样的调用方式采用了 <a> 标签，链接指向了一言源网页。但这种调用方式会在文字下方生成下划线。下面给出一种采用段落 <p> 标签的示例：

<p id="hitokoto_text">:D 获取中...</p>
<p id="hitokoto_from">from</p>
<script>
    fetch('https://v1.hitokoto.cn')
    .then(response => response.json())
    .then(data => {
        hitokoto_text.innerText = data.hitokoto
        hitokoto_from.innerText = data.from
    })
    .catch(console.error)
</script>

此代码中， .hitokoto 即为获取到的一句话内容， .from 即为来源。对于其中的参数、返回的内容都可以参考官方文档进行设定。请注意，请在合适的地方添加对于一言的引用。

Markdown Extended Features

Wed, 01 May 2024 00:00:00 GMT

GitHub repository cards

You can add dynamic cards that link to GitHub repositories, on page load, the repository information is pulled from the GitHub API.

::github{repo="Fabrizz/MMM-OnSpotify"}

Create a GitHub repository card with the code ::github{repo="<owner>/<repo>"}.

::github{repo="saicaca/fuwari"}

Admonitions

Following types of admonitions are supported: note tip important warning caution

:::note Highlights information that users should take into account, even when skimming. :::

:::tip Optional information to help a user be more successful. :::

:::important Crucial information necessary for users to succeed. :::

:::warning Critical content demanding immediate user attention due to potential risks. :::

:::caution Negative potential consequences of an action. :::

:::note
Highlights information that users should take into account, even when skimming.
:::

:::tip
Optional information to help a user be more successful.
:::

The title of the admonition can be customized.

:::note[MY CUSTOM TITLE] This is a note with a custom title. :::

:::note[MY CUSTOM TITLE]
This is a note with a custom title.
:::

[!TIP] The GitHub syntax is also supported.

> [!NOTE]
> The GitHub syntax is also supported.

> [!TIP]
> The GitHub syntax is also supported.

给 Cloudflare Pages 添加标头文件

Wed, 01 May 2024 00:00:00 GMT

为什么需要 _headers 标头文件

必应、谷歌等搜索引擎会使用爬虫定期抓取互联网上的网站。通常情况下，我们会给部署在 Cloudflare Pages 上的项目配置一个自定义域，例如使用 www.example.com 指向默认的 example.pages.dev 。在搜索引擎的爬虫看来，如果这两个网站下没有配置拒绝索引的 robots.txt 或标头，那么搜索引擎会毫不犹豫的索引这两个相同内容的网站。为了使搜索引擎只收录我们希望的 www.example.com ，排除默认的 example.pages.dev ，我们需要给项目添加 _headers 标头文件。

在 Cloudflare 官方文档中已经对 _headers 文件的使用给出了详细的说明。

如何添加

如果是直接上传文件的项目，通常只需要在根目录下新建一个 _headers 纯文本文档（没有扩展名），并输入以下内容：

https://:project.pages.dev/*
  X-Robots-Tag: noindex

保存，上传，部署，配置网站就像呼吸一样自然。

但是，居然报错了，返回了403错误，大意是服务器拒绝了 API 调用的请求，这就很离谱了。我明明是在官网上部署的服务，为什么还会报错？这么离谱的 bug 早该修修了。

所以，只能通过链接 GitHub 的方式来部署项目，在项目根目录添加 _headers 文件，上传，这才部署成功，并且成功识别到了添加的标头。

Hexo 添加标头文件

在 Hexo 中，直接将 _headers 文件加入 source/ 即可，并且在 _config.yml 中配置跳过渲染 _headers 文件：

skip_render:
  - _headers

Hexo 在构建时默认会忽略以下划线 _ 开头的文件，所以还需要在 _config.yml 中配置包含 _headers 文件：

include:
  - _headers

再次运行构建，即可看到在输出网站根目录下出现了 _headers 文件。

Fuwari 主题博客

对于本博客使用的基于 Astro 构建的 Fuwari 主题，只需要将 _headers 文件加入 public/ 即可，运行构建时会自动将 public 文件夹中的内容原封不动的拷贝到输出网站的根目录中，并且不会忽略以下划线 _ 开头的文件。

Expressive Code Example

Wed, 10 Apr 2024 00:00:00 GMT

Here, we'll explore how code blocks look using Expressive Code. The provided examples are based on the official documentation, which you can refer to for further details.

Expressive Code

Syntax Highlighting

Regular syntax highlighting

console.log('This code is syntax highlighted!')

Rendering ANSI escape sequences

ANSI colors:
- Regular: [31mRed[0m [32mGreen[0m [33mYellow[0m [34mBlue[0m [35mMagenta[0m [36mCyan[0m
- Bold:    [1;31mRed[0m [1;32mGreen[0m [1;33mYellow[0m [1;34mBlue[0m [1;35mMagenta[0m [1;36mCyan[0m
- Dimmed:  [2;31mRed[0m [2;32mGreen[0m [2;33mYellow[0m [2;34mBlue[0m [2;35mMagenta[0m [2;36mCyan[0m

256 colors (showing colors 160-177):
[38;5;160m160 [38;5;161m161 [38;5;162m162 [38;5;163m163 [38;5;164m164 [38;5;165m165[0m
[38;5;166m166 [38;5;167m167 [38;5;168m168 [38;5;169m169 [38;5;170m170 [38;5;171m171[0m
[38;5;172m172 [38;5;173m173 [38;5;174m174 [38;5;175m175 [38;5;176m176 [38;5;177m177[0m

Full RGB colors:
[38;2;34;139;34mForestGreen - RGB(34, 139, 34)[0m

Text formatting: [1mBold[0m [2mDimmed[0m [3mItalic[0m [4mUnderline[0m

Editor & Terminal Frames

Code editor frames

console.log('Title attribute example')

<!-- src/content/index.html -->
<div>File name comment example</div>

Terminal frames

echo "This terminal frame has no title"

Write-Output "This one has a title!"

Overriding frame types

echo "Look ma, no frame!"

# Without overriding, this would be a terminal frame
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
New-Alias tail Watch-Tail

Text & Line Markers

Marking full lines & line ranges

// Line 1 - targeted by line number
// Line 2
// Line 3
// Line 4 - targeted by line number
// Line 5
// Line 6
// Line 7 - targeted by range "7-8"
// Line 8 - targeted by range "7-8"

Selecting line marker types (mark, ins, del)

function demo() {
  console.log('this line is marked as deleted')
  // This line and the next one are marked as inserted
  console.log('this is the second inserted line')

  return 'this line uses the neutral default marker type'
}

Adding labels to line markers

// labeled-line-markers.jsx
<button
  role="button"
  {...props}
  value={value}
  className={buttonClassName}
  disabled={disabled}
  active={active}
>
  {children &&
    !active &&
    (typeof children === 'string' ? <span>{children}</span> : children)}
</button>

Adding long labels on their own lines

// labeled-line-markers.jsx
<button
  role="button"
  {...props}

  value={value}
  className={buttonClassName}

  disabled={disabled}
  active={active}
>

  {children &&
    !active &&
    (typeof children === 'string' ? <span>{children}</span> : children)}
</button>

Using diff-like syntax

+this line will be marked as inserted
-this line will be marked as deleted
this is a regular line

--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
+this is an actual diff file
-all contents will remain unmodified
 no whitespace will be removed either

Combining syntax highlighting with diff-like syntax

  function thisIsJavaScript() {
    // This entire block gets highlighted as JavaScript,
    // and we can still add diff markers to it!
-   console.log('Old code to be removed')
+   console.log('New and shiny code!')
  }

Marking individual text inside lines

function demo() {
  // Mark any given text inside lines
  return 'Multiple matches of the given text are supported';
}

Regular expressions

console.log('The words yes and yep will be marked.')

Escaping forward slashes

echo "Test" > /home/test.txt

Selecting inline marker types (mark, ins, del)

function demo() {
  console.log('These are inserted and deleted marker types');
  // The return statement uses the default marker type
  return true;
}

Word Wrap

Configuring word wrap per block

// Example with wrap
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

// Example with wrap=false
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

Configuring indentation of wrapped lines

// Example with preserveIndent (enabled by default)
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

// Example with preserveIndent=false
function getLongString() {
  return 'This is a very long string that will most probably not fit into the available space unless the container is extremely wide'
}

Collapsible Sections

// All this boilerplate setup code will be collapsed
import { someBoilerplateEngine } from '@example/some-boilerplate'
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'

const engine = someBoilerplateEngine(evenMoreBoilerplate())

// This part of the code will be visible by default
engine.doSomething(1, 2, 3, calcFn)

function calcFn() {
  // You can have multiple collapsed sections
  const a = 1
  const b = 2
  const c = a + b

  // This will remain visible
  console.log(`Calculation result: ${a} + ${b} = ${c}`)
  return c
}

// All this code until the end of the block will be collapsed again
engine.closeConnection()
engine.freeMemory()
engine.shutdown({ reason: 'End of example boilerplate code' })

Line Numbers

Displaying line numbers per block

// This code block will show line numbers
console.log('Greetings from line 2!')
console.log('I am on line 3')

// Line numbers are disabled for this block
console.log('Hello?')
console.log('Sorry, do you know what line I am on?')

Changing the starting line number

console.log('Greetings from line 5!')
console.log('I am on line 6')

Simple Guides for Fuwari

Mon, 01 Apr 2024 00:00:00 GMT

Cover image source: Source

This blog template is built with Astro. For the things that are not mentioned in this guide, you may find the answers in the Astro Docs.

Front-matter of Posts

---
title: My First Blog Post
published: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
---

Attribute	Description
`title`	The title of the post.
`published`	The date the post was published.
`description`	A short description of the post. Displayed on index page.
`image`	The cover image path of the post.<br/>1. Start with `http://` or `https://`: Use web image<br/>2. Start with `/`: For image in `public` dir<br/>3. With none of the prefixes: Relative to the markdown file
`tags`	The tags of the post.
`category`	The category of the post.
`draft`	If this post is still a draft, which won't be displayed.

Where to Place the Post Files

Your post files should be placed in src/content/posts/ directory. You can also create sub-directories to better organize your posts and assets.

src/content/posts/
├── post-1.md
└── post-2/
    ├── cover.png
    └── index.md

Markdown Example

Sun, 01 Oct 2023 00:00:00 GMT

An h1 header

Paragraphs are separated by a blank line.

2nd paragraph. Italic, bold, and monospace. Itemized lists look like:

this one
that one
the other one

Note that --- not considering the asterisk --- the actual text content starts at 4-columns in.

Block quotes are written like so.

They can span multiple paragraphs, if you like.

Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all in chapters 12--14"). Three dots ... will be converted to an ellipsis. Unicode is supported. ☺

An h2 header

Here's a numbered list:

first item
second item
third item

Note again how the actual text starts at 4 columns in (4 characters from the left side). Here's a code sample:

# Let me re-iterate ...
for i in 1 .. 10 { do-something(i) }

As you probably guessed, indented 4 spaces. By the way, instead of indenting the block, you can use delimited blocks, if you like:

define foobar() {
    print "Welcome to flavor country!";
}

(which makes copying & pasting easier). You can optionally mark the delimited block for Pandoc to syntax highlight it:

import time
# Quick, count to ten!
for i in range(10):
    # (but not *too* quick)
    time.sleep(0.5)
    print i

An h3 header

Now a nested list:

First, get these ingredients:
- carrots
- celery
- lentils
Boil some water.

Dump everything in the pot and follow this algorithm:

 find wooden spoon
 uncover pot
 stir
 cover pot
 balance wooden spoon precariously on pot handle
 wait 10 minutes
 goto first step (or shut off burner when done)

Do not bump wooden spoon or it will fall.

Notice again how text always lines up on 4-space indents (including that last line which continues item 3 above).

Here's a link to a website, to a local doc, and to a section heading in the current doc. Here's a footnote [^1].

[^1]: Footnote text goes here.

Tables can look like this:

size material color

9 leather brown 10 hemp canvas natural 11 glass transparent

Table: Shoes, their sizes, and what they're made of

(The above is the caption for the table.) Pandoc also supports multi-line tables:

keyword text

red Sunsets, apples, and other red or reddish things.

green Leaves, grass, frogs and other things it's not easy being.

A horizontal rule follows.

Here's a definition list:

apples : Good for making applesauce. oranges : Citrus! tomatoes : There's no "e" in tomatoe.

Again, text is indented 4 spaces. (Put a blank line between each term/definition pair to spread things out more.)

Here's a "line block":

| Line one | Line too | Line tree

and images can be specified like so:

Inline math equations go in like so: $\omega = d\phi / dt$. Display math should get its own line and be put in in double-dollarsigns:

$$I = \int \rho R^{2} dV$$

And note that you can backslash-escape any punctuation characters which you wish to be displayed literally, ex.: `foo`, *bar*, etc.

Include Video in the Posts

Tue, 01 Aug 2023 00:00:00 GMT

Just copy the embed code from YouTube or other platforms, and paste it in the markdown file.

---
title: Include Video in the Post
published: 2023-10-19
// ...
---

<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

YouTube

Bilibili

字符	十进制	转义字符	描述
<code> </code>	` `	` `	空格
`@`	`@`	`&commat;`	at 符号
`©`	`©`	`©`	版权符号
`!`	`!`	`&excl;`	感叹号
`¡`	`¡`	`¡`	倒置感叹号
`:`	`:`	`&colon;`	冒号
`,`	`,`	`,`	逗号
`·`	`·`	`·`	中间点
`‘`	`'`	`'`	撇号
`‘`	`‘`	`‘`	左单引号
`“`	`“`	`“`	左双引号
`(`	`(`	`(`	左括号
`[`	`[`	`[`	左方括号
`{`	`{`	`{`	左花括号
`§`	`§`	`§`	分节符号
`_`	`_`	`&lowbar;`	单下划线
<code>\|</code>	`\|`	`\|`	竖线
`‖`	`‖`	`&Verbar;`	双竖线
`∠`	`∠`	`&ang;`	角
`#`	`#`	`&num;`	数字标志
`$`	`$`	`&dollar;`	美元符号
`%`	`%`	`&percnt;`	百分号
`‰`	`‰`	`&permil;`	千分号
`‱`	`‱`	`pertenk;`	万分号
`*`	`*`	`&ast;`	星号
`/`	`/`	`/`	斜线符号
`+`	`+`	`&add;`	加号
`×`	`×`	`×`	乘号
`=`	`=`	`&equal;`	等于号
`≈`	`≈`	`≈`	约等于
`<`	`<`	`<`	小于号
`≤`	`≤`	`≤`	小于等于
`¹`	`¹`	`¹`	上标 1
`²`	`²`	`²`	上标 2
`³`	`³`	`³`	上标 3
`&`	`&`	`&`	and 符号
`®`	`®`	`®`	注册商标符
`?`	`?`	`&quest;`	问号
`¿`	`¿`	`¿`	倒置问号
`;`	`;`	`&semi;`	分号
`.`	`.`	`&period;`	句号
`•`	`•`	`•`	加重号
`“`	`"`	`"`	引号
`’`	`’`	`’`	右单引号
`”`	`”`	`”`	右双引号
`)`	`)`	`)`	右括号
`]`	`]`	`]`	右方括号
`}`	`}`	`}`	右花括号
`¶`	`¶`	`¶`	段落符号
`__`	`̲`	`&UnderBar;`	双下划线
`¦`	`¦`	`¦`	间断竖线
`…`	`…`	`…`	三点省略号
`^`	`^`	`&Hat;`	hat符号
`π`	`ρ`	`π`	圆周率
`¥`	`¥`	`¥`	元符号
`°`	`°`	`°`	度符号
`√`	`√`	`√`	平方根
`∞`	`∞`	`∞`	正无穷
`±`	`±`	`±`	加减符号
`\`	`\`	`\`	反斜线符号
`–`	`–`	`–`	减号
`÷`	`÷`	`÷`	除号
`≠`	`≠`	`≠`	不等于
`≡`	`≡`	`&equiv;`	相当于
`>`	`>`	`>`	大于号
`≥`	`≥`	`≥`	大于等于
`¼`	`¼`	`¼`	四分之一
`½`	`½`	`½`	二分之一
`¾`	`¾`	`¾`	四分之三

字符	十进制	转义字符	描述
<code> </code>	` `	` `	空格
`@`	`@`	`&commat;`	at 符号
`©`	`©`	`©`	版权符号
`!`	`!`	`&excl;`	感叹号
`¡`	`¡`	`¡`	倒置感叹号
`:`	`:`	`&colon;`	冒号
`,`	`,`	`,`	逗号
`·`	`·`	`·`	中间点
`‘`	`'`	`'`	撇号
`‘`	`‘`	`‘`	左单引号
`“`	`“`	`“`	左双引号
`(`	`(`	`(`	左括号
`[`	`[`	`[`	左方括号
`{`	`{`	`{`	左花括号
`§`	`§`	`§`	分节符号
`_`	`_`	`&lowbar;`	单下划线
<code>\|</code>	`\|`	`\|`	竖线
`‖`	`‖`	`&Verbar;`	双竖线
`∠`	`∠`	`&ang;`	角
`#`	`#`	`&num;`	数字标志
`$`	`$`	`&dollar;`	美元符号
`%`	`%`	`&percnt;`	百分号
`‰`	`‰`	`&permil;`	千分号
`‱`	`‱`	`pertenk;`	万分号
`*`	`*`	`&ast;`	星号
`/`	`/`	`/`	斜线符号
`+`	`+`	`&add;`	加号
`×`	`×`	`×`	乘号
`=`	`=`	`&equal;`	等于号
`≈`	`≈`	`≈`	约等于
`<`	`<`	`<`	小于号
`≤`	`≤`	`≤`	小于等于
`¹`	`¹`	`¹`	上标 1
`²`	`²`	`²`	上标 2
`³`	`³`	`³`	上标 3
`&`	`&`	`&`	and 符号
`®`	`®`	`®`	注册商标符
`?`	`?`	`&quest;`	问号
`¿`	`¿`	`¿`	倒置问号
`;`	`;`	`&semi;`	分号
`.`	`.`	`&period;`	句号
`•`	`•`	`•`	加重号
`“`	`"`	`"`	引号
`’`	`’`	`’`	右单引号
`”`	`”`	`”`	右双引号
`)`	`)`	`)`	右括号
`]`	`]`	`]`	右方括号
`}`	`}`	`}`	右花括号
`¶`	`¶`	`¶`	段落符号
`__`	`̲`	`&UnderBar;`	双下划线
`¦`	`¦`	`¦`	间断竖线
`…`	`…`	`…`	三点省略号
`^`	`^`	`&Hat;`	hat符号
`π`	`ρ`	`π`	圆周率
`¥`	`¥`	`¥`	元符号
`°`	`°`	`°`	度符号
`√`	`√`	`√`	平方根
`∞`	`∞`	`∞`	正无穷
`±`	`±`	`±`	加减符号
`\`	`\`	`\`	反斜线符号
`–`	`–`	`–`	减号
`÷`	`÷`	`÷`	除号
`≠`	`≠`	`≠`	不等于
`≡`	`≡`	`&equiv;`	相当于
`>`	`>`	`>`	大于号
`≥`	`≥`	`≥`	大于等于
`¼`	`¼`	`¼`	四分之一
`½`	`½`	`½`	二分之一
`¾`	`¾`	`¾`	四分之三

Wely

sunxi_d1 设备树文件定位报告

sunxi_d1 设备树文件定位报告

结论

确认依据

1. 产品选择了 sunxi 的 D1 设备包

2. D1 设备包构建内核目标

3. D1 内核构建流程选用 kernel-5.4.mk

4. 构建规则明确复制并编译 nezha 的 board.dts

为什么不是其他 board.dts

相关文件

开源鸿蒙系统配置 USB 转网口驱动

修改内核配置

构建系统

解决 WPS 的 libdbus-1 问题

解决方案

原因

解决办法：让 WPS 用系统的 libm，而不是自带那份

开源鸿蒙哪吒开发板使用gdbserver调试程序

编译 gdbserver

使用 gdb 连接 gdbserver 进行调试

在 vscode 中配置可视化调试

进阶：在 vscode 中一键编译、上传与调试

编译 dropbear

配置 dropbear 服务器

配置密钥登录

在 vscode 中配置一键上传与调试

为开源鸿蒙哪吒开发板编写程序

下载编译工具链

编写程序

编译程序

传输程序

运行程序

参考

开源鸿蒙开发板连接集成开发环境

开发板设置

PC 设置

开源鸿蒙系统配置网络

查看网口信息

配置有线网络

配置 IP 地址

配置默认网关

配置 DNS 服务器

开放 ping 权限

测试网络连接

参考

vim 拟人配置

修改配置文件

修改后配置文件

构建适用于哪吒开发板的开源鸿蒙系统

安装 Repo 工具

更换镜像源

创建工作目录

获取 SDK

初始化仓库

拉取 SDK

获取源码

获取编译工具链

构建系统

构建前准备

复制编译工具

解压编译工具链

获取 Docker 编译环境

构建系统

生成镜像文件

生成可写镜像文件

烧写镜像

启动系统

参考

树莓派 Pico 驱动墨水屏显示信息

墨水屏

树莓派 Pico 环境搭建

Raspberry Pi Pico SDK

安装依赖

克隆存储库

添加环境变量

picotool

安装依赖

克隆存储库

编译安装

编译 `gdbserver`

使用 `gdb` 连接 `gdbserver` 进行调试

在 `vscode` 中配置可视化调试

进阶：在 `vscode` 中一键编译、上传与调试

编译 `dropbear`

配置 `dropbear` 服务器

在 `vscode` 中配置一键上传与调试

去除 `sudo` 权限

安装完整版 `Python`

编写 `bash` 脚本

创建 `Swap` 交换空间

开启 `Swap`

关闭 `Swap`

字符	十进制	转义字符	描述
<code> </code>	` `	` `	空格
`@`	`@`	`&commat;`	at 符号
`©`	`©`	`©`	版权符号
`!`	`!`	`&excl;`	感叹号
`¡`	`¡`	`¡`	倒置感叹号
`:`	`:`	`&colon;`	冒号
`,`	`,`	`,`	逗号
`·`	`·`	`·`	中间点
`‘`	`'`	`'`	撇号
`‘`	`‘`	`‘`	左单引号
`“`	`“`	`“`	左双引号
`(`	`(`	`(`	左括号
`[`	`[`	`[`	左方括号
`{`	`{`	`{`	左花括号
`§`	`§`	`§`	分节符号
`_`	`_`	`&lowbar;`	单下划线
<code>\|</code>	`\|`	`\|`	竖线
`‖`	`‖`	`&Verbar;`	双竖线
`∠`	`∠`	`&ang;`	角
`#`	`#`	`&num;`	数字标志
`$`	`$`	`&dollar;`	美元符号
`%`	`%`	`&percnt;`	百分号
`‰`	`‰`	`&permil;`	千分号
`‱`	`‱`	`pertenk;`	万分号
`*`	`*`	`&ast;`	星号
`/`	`/`	`/`	斜线符号
`+`	`+`	`&add;`	加号
`×`	`×`	`×`	乘号
`=`	`=`	`&equal;`	等于号
`≈`	`≈`	`≈`	约等于
`<`	`<`	`<`	小于号
`≤`	`≤`	`≤`	小于等于
`¹`	`¹`	`¹`	上标 1
`²`	`²`	`²`	上标 2
`³`	`³`	`³`	上标 3
`&`	`&`	`&`	and 符号
`®`	`®`	`®`	注册商标符
`?`	`?`	`&quest;`	问号
`¿`	`¿`	`¿`	倒置问号
`;`	`;`	`&semi;`	分号
`.`	`.`	`&period;`	句号
`•`	`•`	`•`	加重号
`“`	`"`	`"`	引号
`’`	`’`	`’`	右单引号
`”`	`”`	`”`	右双引号
`)`	`)`	`)`	右括号
`]`	`]`	`]`	右方括号
`}`	`}`	`}`	右花括号
`¶`	`¶`	`¶`	段落符号
`__`	`̲`	`&UnderBar;`	双下划线
`¦`	`¦`	`¦`	间断竖线
`…`	`…`	`…`	三点省略号
`^`	`^`	`&Hat;`	hat符号
`π`	`ρ`	`π`	圆周率
`¥`	`¥`	`¥`	元符号
`°`	`°`	`°`	度符号
`√`	`√`	`√`	平方根
`∞`	`∞`	`∞`	正无穷
`±`	`±`	`±`	加减符号
`\`	`\`	`\`	反斜线符号
`–`	`–`	`–`	减号
`÷`	`÷`	`÷`	除号
`≠`	`≠`	`≠`	不等于
`≡`	`≡`	`&equiv;`	相当于
`>`	`>`	`>`	大于号
`≥`	`≥`	`≥`	大于等于
`¼`	`¼`	`¼`	四分之一
`½`	`½`	`½`	二分之一
`¾`	`¾`	`¾`	四分之三