RP2040 (Raspberry Pi Pico) 拥有双核 Cortex-M0+ 架构和独特的 PIO 状态机。在进行 Rust 嵌入式开发时，我们需要一套稳定可靠的烧录与调试方案。

虽然官方提供了基于 USB 存储模拟的 UF2 拖拽烧录方式，但在实际开发中，我们需要断点调试、RTT 日志输出以及一键自动烧录。本文整合了从最基础的软件工具到进阶的硬件调试方案。

第一部分：软件烧录工具 (文件传输) ​

这部分介绍运行在电脑端的纯软件工具，它们主要用于将编译好的固件（UF2/ELF）传输给 RP2040，通常利用 BootROM 或 USB 协议，不涉及硬件调试器。

cargo install elf2uf2-rs

# .cargo/config.toml
[target.thumbv6m-none-eabi]
runner = "elf2uf2-rs --deploy --serial --verbose"

第二部分：调试运行器 (Debug Runners) ​

这部分软件运行在电脑端，充当桥梁角色。它们连接 USB 硬件调试器（如 Picoprobe, DAPLink），并向上层提供调试服务（GDB, RTT）。

cargo install probe-rs-tools

# 自动寻找连接的调试器，烧录并运行，同时输出 RTT 日志
probe-rs run --chip RP2040 <BIN FILE>

[target.thumbv6m-none-eabi]
runner = "probe-rs run --chip RP2040"

openocd -f interface/cmsis-dap.cfg -f target/rp2040.cfg

第三部分：硬件调试方案 ​

这部分解决 “用什么硬件连接 RP2040 SWD 接口” 的问题。RP2040 使用 Multi-drop SWD 协议，部分老旧调试器可能不兼容。

# 警告：请确保你了解硬件连接，错误操作可能导致设备变砖 (需要飞线连接内部 SWD 接口)
probe-rs download --chip stm32f103c8 --protocol swd --binary-format bin --base-address 0x08000000 .\DAP103-dapboot-combined-stlink.bin

补充阅读：其他调试方案 ​

1. Black Magic Probe (GDB Server) ​

如果不想用 OpenOCD，可以将 ST-Link 刷成 Black Magic Probe (BMP) 固件。它内置了 GDB Server，可以直接用 GDB 连接，无需中间件。

2. J-Link 调试 ​

J-Link 配合 OpenOCD 调试 RP2040 需要进行驱动替换（Zadig -> WinUSB）等繁琐配置。除非手头只有 J-Link，否则不建议作为首选方案。

维护 HP 服务器时一不小心把 iLO (Integrated Lights-Out) 重置了导致高级功能授权丢失 (License), 这里记录了通过 HPE 网站提交 Case 找回 iLO License 的详细流程。

准备工作 ​

在开始之前，请准备好以下信息：

1. 服务器序列号 (Serial Number, SN)：通常在服务器机箱上的标签，或者可以在 iLO 概览页面看到。
2. 产品 ID (Product ID)：通常在服务器机箱上的标签，或者可以在 iLO 概览页面看到。
3. 产品型号 (Product Number/Model)：例如 HPE DL360 Gen9。
4. 联系方式：有效的电子邮箱地址，用于接收官方回复。
5. HP 门户账号：用于后续根据授权订单编号 (EON) 获取授权

找回流程 ​

1. 访问 HPE Licensing Support ​

首先访问 HPE 许可支持页面（HPE Licensing Support）。

2. 填写申请单 ​

在打开的页面中，需要填写详细的请求信息。该页面支持中文输入。

必填信息包括：

• Serial Number (序列号)：准确填写服务器的 SN 码。
• Contact Information (联系信息)：姓名、邮箱等。
• Description (描述)：简要说明诉求，例如：“iLO License 丢失，申请查询找回”。

确认信息无误后，点击 SUBMIT 提交。

3. 获取案例编号 (Case Number) ​

提交成功后，网页会显示本次服务的案例编号（Case Number）。

此时你可以点击 “ATTACH FILE” 上传购买凭证（如果有），或者直接点击 “CONTINUE” 完成提交。接下来只需要耐心等待邮件。

4. 等待官方回复 ​

HPE 的响应时间通常在 24 小时之内。你会收到来自 Software Services Support 的邮件。

邮件确认： 官方可能会先发一封邮件确认收到请求，并告知 Case ID。

5. 查看查询结果 ​

客服在后台查询后，会根据结果发送邮件：

如果根据 SN 码查到了绑定的 iLO License，客服会在邮件中直接提供 License Key。

最新的邮件采用了授权订单编号 (EON) 的形式获取需要多一个步骤

6. 根据 EON 获取 License Key ​

访问 HP 仪表页

7. 结束服务 ​

对查询结果没有异议后，HPE 会发送邮件告知 Case 即将关闭。

如果后续有其他问题，需要提交新的 Case 并引用旧的 Case ID。

常见问题 ​

• Gen8 之前的机器能找回吗？ 太老的机器可能数据不再维护，具体以官方回复为准。
• iLO Advanced 有什么用？ 解锁远程控制台（Remote Console）的全部功能（如解除 .NET/Java 远程桌面的连接时长限制、虚拟介质挂载等）。

在使用惠普（HPE）服务器运行 Proxmox VE 时，硬件阵列卡（Smart Array Controller）通常会屏蔽底层的物理磁盘信息。 为了监控磁盘健康状态和配置阵列，我们需要安装 HPE 官方的 ssacli (Smart Storage Admin CLI) 工具。

此外，在不安装官方工具的情况下，我们也可以通过特定参数让 smartctl 穿透阵列卡直接读取物理硬盘的 SMART 信息。

smartctl -a -d cciss,<N> /dev/sg<M>

方法一：Smartctl 穿透读取 SMART 信息 ​

如果你只想查看硬盘的健康状况（如温度、通电时间、错误计数），而不需要配置阵列，通过 smartctl 穿透查询是最简单的方法，无需安装任何额外的驱动或工具。

命令格式 ​

smartctl -a -d cciss,<N> /dev/sg<M>
# 或者直接对逻辑卷对应的设备节点（视驱动模式而定）
smartctl -a -d cciss,<N> /dev/sda

• -d cciss,<N>: 关键参数。告诉 smartctl 设备是 CCISS 类型（惠普阵列卡旧称），<N> 代表物理磁盘的索引号，从 0 开始。
• /dev/sda: 你的阵列卡逻辑卷设备路径。

实际操作示例 ​

假设系统识别到的阵列盘是 /dev/sda，你想查看第 5 块物理硬盘的信息：

smartctl -a -d cciss,4 /dev/sda

方法二：安装 HPE ssacli 管理工具 ​

ssacli 是惠普官方提供的命令行配置工具，功能非常强大，支持查看详细的阵列卡状态、电池状态、配置 RAID、扩容等操作。

1. 添加 HPE 软件源 ​

导入其 GPG 公钥并创建源文件 /etc/apt/sources.list.d/hp-mcp.list。

curl -fsSL https://downloads.linux.hpe.com/SDR/hpePublicKey2048_key1.pub | gpg --dearmor > /etc/apt/keyrings/hpePublicKey2048_key1.gpg
chmod 0644 /etc/apt/keyrings/hpePublicKey2048_key1.gpg

echo "deb [signed-by=/etc/apt/keyrings/hpePublicKey2048_key1.gpg] https://downloads.linux.hpe.com/SDR/repo/mcp $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release)/current non-free" > /etc/apt/sources.list.d/hp-mcp.list

2. 更新并安装 ​

apt update && apt install -y ssacli

ssacli 常用命令指南 ​

安装完成后，可以直接在终端输入 ssacli 进入交互模式，或者直接在命令行执行。

1. 查看整体状态 ​

这是最常用的命令，用于列出所有控制器、阵列和逻辑卷的概览。

ssacli ctrl all show config

2. 查看详细信息 ​

• 列出所有控制器：

  bash

  ssacli ctrl all show

  1
  

• 查看特定插槽（Slot）控制器的详细配置（假设控制器在 Slot 0）：

  bash

  ssacli ctrl slot=0 show config detail

  1
  

• 查看所有物理硬盘状态：

  bash

  ssacli ctrl slot=0 physicaldrive all show

  1
  

  输出示例：

  text

  physicaldrive 1I:1:1 (port 1I:box 1:bay 1, SATA HDD, 10 TB, OK)
  physicaldrive 1I:1:2 (port 1I:box 1:bay 2, SATA HDD, 10 TB, OK)

  1
  2
  

• 查看逻辑卷（RAID）状态：

  bash

  ssacli ctrl slot=0 logicaldrive all show

  1
  

3. 阵列卡缓存与电池状态 ​

检查缓存模块是否有电，以及电池（超级电容）是否健康。

ssacli ctrl slot=0 show status

4. 常用简写语法 ​

ssacli 的命令结构通常为：<目标> <命令> [参数]。

• 目标 (Target)：

  • ctrl all / ctrl slot=0 (控制器)
  • physicaldrive all / pd 1I:1:1 (物理盘)
  • logicaldrive all / ld 1 (逻辑盘)

• 命令 (Command)：

  • show: 显示信息
  • modify: 修改配置（如开启 / 关闭缓存）
  • rescan: 重新扫描设备

5. 高级操作示例 ​

• 开启 SSD 智能路径 (SSD Smart Path)（适用于 SSD 阵列）：

  bash

  ssacli ctrl slot=0 array A modify ssdsmartpath=enable

  1
  

• 点亮硬盘指示灯（定位物理硬盘时非常有用）：

  bash

  ssacli ctrl slot=0 pd 1I:1:1 modify led=on
  # 关闭
  ssacli ctrl slot=0 pd 1I:1:1 modify led=off

  1
  2
  3
  

参考资料 ​

• Install HP Smart Storage Admin CLI (ssacli) on your PVE node

在进行嵌入式 GUI 开发（如使用 Rust 和 Slint）时，通常会面临以下技术挑战：

• 资源限制：嵌入式设备性能有限，编译速度慢且存储空间不足，不适合直接作为开发环境。
• 环境隔离：为了保持本地开发环境的整洁，通常使用 PVE/WSL/Docker 等虚拟化平台部署独立的 Linux 容器进行开发。

VSCode Remote - SSH 提供了便捷的远程开发体验，实现了 “本地编码，云端编译”。然而，Slint 的 “实时预览” (Live Preview) 功能依赖于图形界面显示。虽然配合 SSH X11 转发 可以将远程窗口投射至本地，但 VSCode 的插件机制存在一定的环境隔离，Slint 插件启动的预览进程往往无法正确获取 DISPLAY 环境变量，导致预览窗口无法显示。

本文介绍一种通过 LSP (Language Server Protocol) 代理脚本注入环境变量的方法，以解决该问题。

准备工作 ​

安装 slint-lsp ​

VSCode 的 Slint 插件默认不包含语言服务器二进制文件，且不会自动安装。我们需要在远程环境中手动安装它。请确保已安装 Rust 工具链：

cargo install slint-lsp

安装完成后，slint-lsp 通常位于 ~/.cargo/bin/ 目录下。

问题分析 ​

在 SSH 终端中手动运行 cargo run 时，Shell 会自动继承 SSH 会话中的 DISPLAY 环境变量（例如 localhost:10.0），因此常规 GUI 程序可以正常通过 X11 转发显示。

然而，VSCode 的 Slint 插件是在后台启动 slint-lsp（语言服务器）进程的。该过程并不总是能继承 SSH Shell 会话中的完整环境变量。这导致当用户点击 "Show Preview" 时，LSP 进程因无法定位显示设备而启动失败。

解决方案：LSP 代理脚本 ​

Slint 插件允许用户自定义 LSP 可执行文件的路径。利用这一特性，我们可以编写一个中间脚本（Wrapper Script）作为代理。在该脚本中手动注入必要的环境变量，然后再调用实际的 LSP 二进制文件。

1. 创建代理脚本 ​

在远程服务器的项目目录或用户目录下创建一个脚本文件，例如 /root/slint_test/.vscode/slint-lsp-proxy.sh：

#!/bin/bash

# 1. 配置区域设置 (Locale)
# Slint 依赖 UTF-8 环境，强制指定以避免编码错误
# 需确保系统已生成对应 locale (Debian/Ubuntu: sudo dpkg-reconfigure locales)
export LANG=zh_CN.UTF-8
# 或者使用通用的 C.UTF-8
# export LANG=C.UTF-8

# 2. 注入 X11 显示变量
# 此处需填入 SSH X11 转发的 DISPLAY 地址
# SSH 自动转发通常为 localhost:10.0，具体值可通过在终端执行 echo $DISPLAY 获取
export DISPLAY=localhost:10.0

# 3. 图形后端配置 (可选)
# 强制 winit 使用 X11 后端，避免因尝试连接 Wayland 而失败
export WINIT_UNIX_BACKEND=x11

# 4. 启动实际的 LSP
# 需替换为服务器上 cargo 安装的 slint-lsp 实际路径
exec /root/.cargo/bin/slint-lsp "$@"

注意：DISPLAY 的值可能会随会话变化。在固定 IP 的开发环境中，将其硬编码在脚本中较为稳定。

2. 赋予执行权限 ​

需给予脚本执行权限，否则 VSCode 无法调用：

chmod +x /root/slint_test/.vscode/slint-lsp-proxy.sh

3. 配置 VSCode ​

编辑项目的 .vscode/settings.json（或全局 User Settings），将 Slint 插件的 LSP 路径指向上述脚本：

{
  "slint.lspBinaryPath": "/root/slint_test/.vscode/slint-lsp-proxy.sh"
}

验证结果 ​

1. 确保本地电脑的 X Server（如 VcXsrv）已启动。
2. Reload VSCode 窗口以重启 LSP 服务。
3. 打开任意 .slint 文件。
4. 点击编辑器右上角的 Show Preview 按钮。
5. Slint 的预览窗口应能通过 SSH 隧道正常显示在本地桌面上。

值得留意的是官方视乎准备实现真正的远程预览

• Remote controlled slint-viewer - GitHub Issue #9880

总结 ​

通过 Shell 脚本封装 LSP 启动命令，可以有效绕过 VSCode 插件的环境隔离限制。该方法具有一定的通用性，对于其他依赖特定环境变量（如 LD_LIBRARY_PATH 或特定 SDK 路径）的 LSP 服务应该也同样适用。

在管理 Linux 服务器时，通常使用 SSH 命令行进行操作。但有时需运行一些必须使用图形界面（GUI）的软件（如 Oracle 安装程序、IDE、虚拟化管理器 virt-manager 等），以及 Windows 配合 Docker 容器进行 GUI 开发时，而服务器本身可能没有安装桌面环境，或者为了安全和性能不希望安装完整的 VNC/RDP 服务。

X11 转发 (X11 Forwarding) 是一项非常实用的技术，它允许通过 SSH 通道将 Linux 服务器上的图形界面 “转发” 到本地电脑上显示。简而言之，即程序在服务器上运行，但窗口绘制在本地屏幕上。

工作原理 ​

X11 协议采用 C/S（客户端 / 服务端）架构，但其定义与直觉稍有不同：

• X Server（服务端）：运行在本地电脑（拥有显示终端的一端）。负责 “绘图”，管理显示器、键盘和鼠标。
• X Client（客户端）：运行在远程服务器。即实际的应用程序（如 Firefox, xclock），负责请求 X Server 绘制窗口。

SSH X11 转发的作用即在这两者之间建立一条加密隧道。

服务端配置 (远程 Linux 主机) ​

首先需确保远程 Linux 服务器允许 X11 转发，并安装了必要的认证工具。

1. 安装 xauth xauth 用于生成和管理 X 权限文件，是 X11 转发必须的组件。

   Debian/Ubuntu

   bash

   sudo apt update
   sudo apt install xauth

   1
   2
   

   CentOS/RHEL

   bash

   sudo yum install xorg-x11-xauth

   1
   

2. 配置 SSH 服务 编辑 /etc/ssh/sshd_config 文件，确保以下配置项处于启用状态：

   bash

   X11Forwarding yes
   X11DisplayOffset 10
   X11UseLocalhost yes

   1
   2
   3
   

   通常 X11Forwarding 默认为 no，必须修改为 yes。

3. 重启 SSH 服务

   bash

   sudo systemctl restart sshd

   1
   

客户端配置 (本地电脑) ​

根据本地电脑的操作系统，配置方式有所不同。

# 需先设置 DISPLAY 环境变量指向本地 X Server
$env:DISPLAY='localhost:0.0'
ssh -Y user@remote_host

# 推荐使用 -Y，兼容性更好，虽然理论安全性略低
ssh -Y user@remote_host

连接与测试 ​

建立 SSH 连接后，可通过运行简单的 GUI 程序来测试转发是否成功。

1. 验证环境变量 在 SSH 连入的终端中输入：

   bash

   echo $DISPLAY

   1
   

   若输出类似 localhost:10.0 或 :10.0，说明 SSH 已经成功为当前会话分配了显示通道。若为空，请检查 SSH 服务端配置。

2. 运行测试程序 若没有测试程序，可先安装一个简单的时钟：

   Debian/Ubuntu

   bash

   sudo apt install x11-apps

   1
   

   CentOS/RHEL

   bash

   sudo yum install xorg-x11-apps

   1
   

   然后运行：

   bash

   xclock

   1
   

   若本地电脑上弹出了一个时钟小窗口，则表明 X11 转发配置成功。

常见问题排查 ​

Error: Can't open display: ​

• 原因 1：本地 X Server 未启动（Windows 用户常见）。请确保 VcXsrv 或 Xming 已在托盘区运行。
• 原因 2：未启用 SSH 转发参数。请检查是否加了 -Y 参数或 PuTTY 中是否勾选了选项。
• 原因 3：xauth 未安装。服务端必须有 xauth 命令。

X11 connection rejected because of wrong authentication ​

• 通常是因为 xauth 文件权限问题或文件损坏。尝试在服务端删除 .Xauthority 文件后重新连接：
  bash

  rm ~/.Xauthority
  exit
  # 重新 SSH 登录

  1
  2
  3
  

画面响应慢 ​

X11 协议本身网络开销较大，且没有压缩。

• 优化：可使用 ssh -Y -C user@host 开启 gzip 压缩，对低带宽环境有一定帮助。
• 替代方案：若需流畅操作复杂桌面，建议改用 VNC 或 NoMachine。

ESP8266-01

ESP8266-12E

ESP8266-12E-NodeMCU-Kit

ESP8266-WeMos-D1-Mini

除 GPIO4/5 以外，其他引在启动时都会产生电平变化

ESP8266 参考 ​

esp8266-pinout-reference-gpios

esp8266-gpio

ESP32 ​

ESP-WROOM-32

ESP32-NodeMCU-32S

ESP32-S3-DevKitC-1

STM32 ​

ESP32 参考 ​

esp32-pinout-reference-gpios

1. OpenWRT 的启动脚本放在 /etc/init.d 目录下，并且须要 chmod +x 赋予执行权。
2. OpenWRT 开机时会自动运行 /etc/rc.d 目录下的脚本。由 /etc/init.d 链接生成。

chmod +x /etc/init.d/{name}

service {name} {action}
# 或
/etc/init.d/{name} {action}

编写 ​

/etc/rc.common 中已经定义了所有默认的函数，只需要重写几个函数就可以实现启动脚本

基础脚本^[1] ​

#!/bin/sh /etc/rc.common

# 启动的顺序，越大越靠后
START=20
# 停止的顺序, 越小越靠前
STOP=15

start(){
    echo "script is start"
}
stop(){
    echo "script is stop"
}
reload() {
    echo "script is reload"
}
restart(){
    echo "script is restart"
}

# 系统启动时执行
# boot(){}

# 系统关机时执行
# shutdown(){}

# 增加自定义命令方法
EXTRA_COMMANDS="custom1 custom2 custom3"
EXTRA_HELP=<<EOF
    custom1 Help for the custom1 command
    custom2 Help for the custom2 command
    custom3 Help for the custom3 command
EOF

custom1 () {
    echo "script is custom1"
}
custom2 () {
    echo "script is custom2"
}
custom3 () {
    echo "script is custom3"
}

可覆盖方法以及说明 ​

默认导出的命令说明 ​

procd 脚本^[2] ​

继承基础脚本信息

由 /etc/rc.common 中导入的 /lib/functions/procd.sh 实现 procd 方法

覆盖方法说明 ​

导出命令 ​

procd 基础方法 ​

procd 触发器注册方法 ​

procd type 列表 ​

详细见 ^[3]

相关工具 ​

#!/bin/sh /etc/rc.common

SERVICE_DAEMONIZE=1
SERVICE_WRITE_PID=1

START=20
STOP=15

start(){
    service_start {path/to/name}
}
stop(){
    service_stop {path/to/name}
}

参考 ​

错误特征 ​

Access to XMLHttpRequest at 'file:///<name>.json' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: http, data, isolated-app, chrome-extension, chrome-untrusted, https, edge.

产生原因 ​

使用 file:// 直接访问本地文件，存在安全隐患，在最新版浏览器中默认被限制

• CVE-2019-11730
• CVE-2015-7186

解决方案 ​

1. 配置调试文件 ​

// .vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "msedge",
      "request": "launch",
      "name": "启动 Edge",
      "file": "${workspaceFolder}",
      "runtimeArgs": ["--allow-file-access-from-files"] 
    }
  ]
}

2. 使用 Live Server 插件 ​

安装后选择要打开的文件，鼠标右击后点击 Open With Live Server

pve kernel: e1000e 0000:00:1f.6 eno1: Detected Hardware Unit Hang

完整错误信息 ​

pve kernel: e1000e 0000:00:1f.6 eno1: Detected Hardware Unit Hang:
  TDH                  <43>
  TDT                  <89>
  next_to_use          <89>
  next_to_clean        <42>
buffer_info[next_to_clean]:
  time_stamp           <100898259>
  next_to_watch        <43>
  jiffies              <1008987c1>
  next_to_watch.status <0>
MAC Status             <40080083>
PHY Status             <796d>
PHY 1000BASE-T Status  <3c00>
PHY Extended Status    <3000>
PCI Status             <10>

解决方法 ​

修改 /etc/network/interfacesn 文件，并在对应网卡下追加以下配置

apt install -y ifupdown2 ethtool

# /etc/network/interfacesn
iface eno1 inet manual
    post-up ethtool -K $IFACE tso off gso off
    # post-up ethtool -K $IFACE gso off gro off tso off tx off rx off rxvlan off txvlan off sg off

参考链接 ​

• e1000e-eno1-detected-hardware-unit-hang.59928

• e1000-driver-hang.58284

NVIDIA vGPU 是一种允许多个虚拟机使用受支持的单个物理 GPU 的技术。

NVIDIA 不允许在消费级 GPU 上使用 vGPU 功能，但是实际上硬件是完全支持的。

这里使用开源软件  vgpu_unlock  通过修补 NVIDIA 驱动的方式解锁了消费级 NVIDIA vGPU 功能。

当然这仅能使消费级 GPU 能够支持 vGPU 技术，而不是破解了授权。（所以还是需要去 NVIDIA 购买！）

基本要求 ​

• 一张 vgpu_unlock 支持的显卡（可以通过这个网站查询 DeivceID 与下面数据进行对比）, 如果不使用 vgpu_unlock 仅需要满足支持 vGPU 即可
• 开启 IOMMU
• 开启 SR-IOV (部分显卡可能需要)

补充数据 ​

安装驱动 ​

环境准备 ​

apt install -y curl unzip git patch dkms mdevctl
apt install -y build-essential pve-headers-`uname -r`

驱动文件准备 ​

下载名为 NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run 驱动文件

安装 ​

chmod +x NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run
./NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run -x --target vgpu-kvm

cd vgpu-kvm

# 补丁1：
curl -sSf https://raw.githubusercontent.com/rupansh/vgpu_unlock_5.12/master/twelve.patch | patch -p0
# 或者
# 补丁2：
curl -sSf https://gitlab.com/polloloco/vgpu-proxmox/-/raw/450-driver/450_5.15.patch | patch -p0

# 修改许可, 将 NVIDIA、Dual MIT/GPL、MIT 改为 GPL
# sed -i 's/^c("\(NVIDIA\|Dual MIT\/GPL\|MIT\)")/MODULE_LICENSE("GPL")/' ./kernel/nvidia/nv-frontend.c ./kernel/nvidia-vgpu-vfio/nvidia-vgpu-vfio.c

cd ..

./vgpu-kvm/nvidia-installer --dkms

显卡本身就支持 vGPU 可以不打解锁补丁直接安装

./NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run --dkms

应用解锁补丁 (可选) ​

chmod +x NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run
./NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run --apply-patch ./<version>.patch

./NVIDIA-Linux-x86_64-<version>-vgpu-kvm-custom.run --dkms

chmod +x NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run
./NVIDIA-Linux-x86_64-<version>-vgpu-kvm.run -x --target vgpu-kvm

git clone 'https://github.com/DualCoder/vgpu_unlock.git' vgpu_unlock

cp -l vgpu_unlock/kern.ld vgpu-kvm/kernel/nvidia/kern.ld
cp -l vgpu_unlock/vgpu_unlock_hooks.c vgpu-kvm/kernel/common/inc/vgpu_unlock_hooks.c

# 在文件 vgpu-kvm/kernel/nvidia/nvidia.Kbuild 的末尾插入 ldflags-y += -T $(src)/nvidia/kern.ld
sed -i '$ a ldflags-y += -T $(src)/nvidia/kern.ld' vgpu-kvm/kernel/nvidia/nvidia.Kbuild
# 在文件 vgpu-kvm/kernel/nvidia/os-interface.c 的32行后插入 #include "vgpu_unlock_hooks.c"
sed -i '32 a #include "vgpu_unlock_hooks.c"' vgpu-kvm/kernel/nvidia/os-interface.c

echo 'kernel/nvidia/kern.ld 0644 KERNEL_MODULE_SRC INHERIT_PATH_DEPTH:1 MODULE:resman' >> vgpu-kvm/.manifest
echo 'kernel/common/inc/vgpu_unlock_hooks.c 0644 KERNEL_MODULE_SRC INHERIT_PATH_DEPTH:1 MODULE:vgpu' >> vgpu-kvm/.manifest

./vgpu-kvm/nvidia-installer --dkms

安装 vgpu_unlock-rs (可选) ​

安装环境 ​

# 国内请使用镜像安装 见: https://rsproxy.cn/

curl https://sh.rustup.rs -sSf | sh -s -- -y --profile minimal
source $HOME/.cargo/env
# 版本过老
#apt -y install cargo rustc

编译 ​

git clone https://github.com/mbilker/vgpu_unlock-rs vgpu_unlock-rs
cd vgpu_unlock-rs

# 编译过程需要下载文件，可能会失败
cargo build --release

cd ..

安装 ​

cp vgpu_unlock-rs/target/release/libvgpu_unlock_rs.so /lib/nvidia/libvgpu_unlock_rs.so

mkdir /etc/systemd/system/{nvidia-vgpud.service.d,nvidia-vgpu-mgr.service.d}
echo '[Service]
Environment=LD_PRELOAD=/lib/nvidia/libvgpu_unlock_rs.so' | tee /etc/systemd/system/nvidia-{vgpu-mgr,vgpud}.service.d/vgpu_unlock-rs.conf

systemctl daemon-reload
systemctl enable nvidia-{vgpu-mgr,vgpud}.service

配置 ​

创建空的配置文件

mkdir /etc/vgpu_unlock
touch /etc/vgpu_unlock/profile_override.toml

配置文件说明，可能有误具体看源码

unlock = 1 # 启用解锁功能(不需要unlock vGPU可以设置为0)
# unlock_migration = 1 # 解锁 VM 迁移功能

# 这里的nvidia-<n>通过 mdevctl types 命令查询得到
# 工作模式为覆盖，所以nvidia-<n>是必须存在的mdev设备
# 更多设置请查看源码 https://github.com/mbilker/vgpu_unlock-rs/blob/master/src/lib.rs#L235-L264
[profile.nvidia-<n>]
num_displays = 1          # 虚拟显示器的最大数量
display_width = 1920      # 最大显示宽度
display_height = 1080     # 最大显示高度
max_pixels = 2073600      # 最大像素 max_pixels=display_width*display_height
cuda_enabled = 1          # 是否开启CUDA
frl_enabled = 1           # 如果开启会限制帧率为60fps
framebuffer = 0x76000000  # VRAM的大小
                          # 其他选项:
                          # 1GB: 0x3B000000
                          # 2GB: 0x76000000
                          # 3GB: 0xB1000000
                          # 4GB: 0xEC000000
                          # 8GB: 0x1D8000000
                          # 16GB: 0x3B0000000
                          # 这些数据仅供参考，你可以通过此方法计算
                          # VRAM=`framebuffer`+`framebuffer_reservation`
# 修改did和sdis,svid
# 似乎只对Windows有效
# 你可以通过这个网站用Ctrl+F查询相同核心显卡的DeivceID（设备ID）
# https://devicehunt.com/view/type/pci/vendor/10DE/
# pci_device_id = 0x1E30    # 0x<did> 由设备ID组成
# pci_id = 0x1E3012BA       # 0x<sdid><svid> 由子设备ID和子供应商ID组成

# 使用 mdevctl list 查看已经创建的 mdev
[mdev.<00000000-0000-0000-0000-000000000000>]
# 具体配置同上

# 仅pve支持
[vm.<VMID>]
# 具体配置同上

屏蔽 NVIDIA GPU 开源驱动 ​

Proxmox 自带了适用于 NVIDIA GPU 的开源驱动程序，所以我们要屏蔽掉它然后使用 vGPU 驱动。

echo "blacklist nouveau" >> /etc/modprobe.d/blacklist.conf
# 似乎可以不执行
update-initramfs -u -k all

重启主机 ​

reboot

验证安装 ​

检查驱动是否安装成功 ​

nvidia-smi

输出类似如下

+---------------------------------------------------------------------------------------+
| NVIDIA-SMI 535.54.06              Driver Version: 535.54.06    CUDA Version: N/A      |
|-----------------------------------------+----------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |         Memory-Usage | GPU-Util  Compute M. |
|                                         |                      |               MIG M. |
|=========================================+======================+======================|
|   0  Tesla P40                      On  | 00000000:05:00.0 Off |                    0 |
| N/A   38C    P8              19W / 250W |   7668MiB / 23040MiB |      1%      Default |
|                                         |                      |                  N/A |
+-----------------------------------------+----------------------+----------------------+

+---------------------------------------------------------------------------------------+
| Processes:                                                                            |
|  GPU   GI   CI        PID   Type   Process name                            GPU Memory |
|        ID   ID                                                             Usage      |
|=======================================================================================|
|   No running processes found                                                          |
+---------------------------------------------------------------------------------------+

检查 vGPU 是否解锁成功 ​

mdevctl types

输出类似如下，如果没有输出说明解锁失败

0000:05:00.0
  nvidia-156
    Available instances: 0
    Device API: vfio-pci
    Name: GRID P40-2B
    Description: num_heads=4, frl_config=45, framebuffer=2048M, max_resolution=5120x2880, max_instance=12
  nvidia-215
    Available instances: 0
    Device API: vfio-pci
    Name: GRID P40-2B4
    Description: num_heads=4, frl_config=45, framebuffer=2048M, max_resolution=5120x2880, max_instance=12
  nvidia-241
    Available instances: 0
    Device API: vfio-pci
    Name: GRID P40-1B4
    Description: num_heads=4, frl_config=45, framebuffer=1024M, max_resolution=5120x2880, max_instance=24
---SNIP---

检查此卡是否被识别为启用了 vGPU ​

nvidia-smi vgpu

如果输出 No supported devices in vGPU mode ，请检查以上步骤是否出现错误。

如果检查无误，说明此卡不支持 vGPU。

错误排查 ​

你需要有一定的 Linux 知识和看懂报错的能力，这些命令或许对你有帮助

dmesg
journalctl --no-pager -b 0 -u nvidia-vgpud
journalctl --no-pager -b 0 -u nvidia-vgpu-mgr
uname -a
cat /proc/cmdline

在 Proxmox 虚拟机中使用 vGPU ​

apt list nvidia-smi

# /etc/pve/qemu-server/<VMID>.conf
# 在首行追加新的一行，第5段一共12位，不足位前面补0
args: -uuid 00000000-0000-0000-0000-00000000<VMID>

打开 Proxmox Web 界面，转到对应的 VM，添加一个 PCI 直通设备。选择对应 GPU 和对应 MDev Type 并添加。

下载链接 ​

工具 ​

vgpu_unlock

vgpu_unlock-rs

vgpu-proxmox

fastapi-dls

vGPU 驱动 ​

APQA 网盘 – vGPU (有最新版)

适用于 NVIDIA RTX 虚拟工作站的驱动程序 (仅包含 guest 驱动)

NVIDIA-VGPU-Driver-Archive (推荐使用 删库了)

NVIDIA-VGPU-Driver-Archive (archive.org 还有一部分)

之前备份了整个 NVIDIA-VGPU-Driver-Archive, 不过为了方便存储是解包过的，只保留有完整的压缩包结构

NVIDIA-VGPU-Driver-Archive (IPFS 建议用客户端)

相关教程 ​

vGPU 教程 – 国光的 PVE 环境搭建教程

在 Proxmox VE 7.2 中开启 vGPU_unlock，实现显卡虚拟化

vGPU 在 Proxmox VE 下的配置与使用

Proxmox VE Nvidia-vGPU doc

安装 NVIDIA Virtual GPU Manager

补充说明 ​

• nvidia-smi vgpu 查询出的可能不是覆盖后的信息，可以参考这个创建一个启动文件
• 虚拟机中的驱动版本不能高于宿主机
• 文章可能有误，这只是一个笔记。

脚注 ​

IOMMU 的作用 ​

让虚拟机可以直接控制主机的 PCI 设备。

在使用时也会有一定优势，例如更低的延迟、更高的性能或更多功能。

但当设备传递到虚拟机后该设备不再被主机使用。

环境要求 ​

主板 / 硬件需要支持 IOMMU，并在主板设置中开启 IOMMU

开启 IOMMU ^[1] ​

# /etc/default/grub
GRUB_CMDLINE_LINUX_DEFAULT="quiet"
GRUB_CMDLINE_LINUX=""
GRUB_CMDLINE_LINUX="intel_iommu=on iommu=pt pcie_acs_override=downstream,multifunction"

update-grub

# /etc/kernel/cmdline
# 在末尾空格追加
intel_iommu=on iommu=pt pcie_acs_override=downstream,multifunction

proxmox-boot-tool refresh

# /etc/default/grub
GRUB_CMDLINE_LINUX_DEFAULT="quiet"
GRUB_CMDLINE_LINUX="" // [!code --]
GRUB_CMDLINE_LINUX="amd_iommu=on iommu=pt pcie_acs_override=downstream,multifunction"

update-grub

# /etc/kernel/cmdline
# 在末尾空格追加
amd_iommu=on iommu=pt pcie_acs_override=downstream,multifunction

proxmox-boot-tool refresh

重启后验证是否配置成功

cat /proc/cmdline

增加所需模块 ​

编辑 /etc/modules

# /etc/modules
vfio
vfio_iommu_type1
vfio_pci
vfio_virqfd

验证 IOMMU ​

如果输出 DMAR: IOMMU enabled 则说明开启成功

dmesg | grep -e DMAR -e IOMMU -e AMD-Vi

查询 IOMMU 分组情况

#!/bin/bash
shopt -s nullglob
for g in $(find /sys/kernel/iommu_groups/* -maxdepth 0 -type d | sort -V); do
    echo "IOMMU Group ${g##*/}:"
    for d in $g/devices/*; do
        echo -e "\t$(lspci -nns ${d##*/})"
    done;
done;

IOMMU 中断重新映射 ^[2] ​

验证是否支持

dmesg | grep 'remapping'

如果输出类似如下结果说明支持

AMD-Vi: Interrupt remapping enabled
DMAR-IR: Enabled IRQ remapping in x2apic mode

如果您的系统不支持，您可以通过以下方式允许不安全的中断

echo "options vfio_iommu_type1 allow_unsafe_interrupts=1" > /etc/modprobe.d/iommu_unsafe_interrupts.conf

前阵子手贱在海鲜市场买了个 2.5G 的猫棒，本来到货了很高兴结果插上去没有一点反应，查了半天发现是卡在了速率协商上，必须手动指定 1G 还好不是猫棒有问题要不然 RMB-200......

但这样一来就有些浪费，还好早有国外大神提出了解决方法，似乎不止适用于 BCM57810S。

使用前需要重新编译驱动，不过目前大部分系统已经内置了该驱动补丁，刚好 openwrt、ikuai 也在其中，不用重新编译。

修改方法有两种 DOS (或许可以用 cmd) 和 UEFI，使用 DOS 太麻烦所以这里直接使用 UEFI。

准备 ​

• 一张博通 BCM57810S 网卡
• 一个大于 100MB 的 FAT32 格式的 U 盘
• 支持 UEFI 启动的电脑
• 下载需要的文件B57BCMCD_T7.6.2.3.zip, B57BCMCD_T7.6.4.1.zip, B57BCMCD_T7.12b.4.1.zip(下载任意一个皆可)(mega 下不了的点这里(访问码:fl7d))

开始 ​

UEFI

复制 / UEFI/uefi_ediag/x64 目录下面所有的文件到 U 盘根目录

进入到主板的 UEFI Shell 界面，进入 U 盘（一般情况下 u 盘为 fsX）执行 ediag_x64.efi -b10eng

输入命令进入速率设置模式

device <number> #number 为需要修改的光口编号
nvm cfg
7  # link settings

遇到 more... 'q' to quit 可以按 q 键取消打印更多

按照 <option>=<value> 的格式修改数据，cancel 取消本次配置，save 保存设置

35=70
36=70
56=6
59=6

35=50
36=50
56=7
59=7

遇到的问题 ​

• 两个口不能同时使用 2.5G 速率 经过测试可以同时使用 2.5G 猫棒 + 2.5G 电口
• 耗电比光猫还高，需要给软路由配一个好点的电源，不然间接性罢工

Proxmox VE (PVE) 安装后，默认配置的软件源指向官方服务器。由于国内网络环境的原因，下载速度可能较慢，甚至连接失败。为了获得更好的使用体验，建议替换为国内的镜像源。

PVE 软件源更换 ​

1. 移除企业版订阅源 ​

Proxmox 默认启用了企业版软件源（Enterprise Repository），该源需要付费订阅才能使用。如果你没有订阅，更新时会报错。我们需要将其禁用或移除。

# 或者直接删除该文件（推荐备份）
mv /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/pve-enterprise.list.bak
mv /etc/apt/sources.list.d/ceph.list /etc/apt/sources.list.d/ceph.list.bak

2. 添加非订阅版源 ​

我们可以使用国内镜像提供的非订阅版源（No-Subscription Repository）。

注意：部分精简版系统可能未预装 lsb_release 命令。如果执行报错，请先安装：apt-get install lsb-release，或者手动将 $(lsb_release -sc) 替换为你的系统代号（如 bookworm 或 bullseye）。

echo "deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/pve $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release) pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

echo "deb https://mirrors.ustc.edu.cn/proxmox/debian/pve $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release) pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

echo "deb https://mirrors.nju.edu.cn/proxmox/debian/pve $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release) pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

Debian 基础源更换 ​

PVE 是基于 Debian 构建的，因此还需要替换 Debian 的基础系统源。

sed -i.bak -e 's#http://ftp.debian.org#https://mirrors.tuna.tsinghua.edu.cn#g' \
           -e 's#http://security.debian.org#https://mirrors.tuna.tsinghua.edu.cn/debian-security#g' \
           /etc/apt/sources.list

sed -i.bak -e 's#http://ftp.debian.org#https://mirrors.ustc.edu.cn#g' \
           -e 's#http://security.debian.org#https://mirrors.ustc.edu.cn/debian-security#g' \
           /etc/apt/sources.list

sed -i.bak -e 's#http://ftp.debian.org#https://mirrors.aliyun.com#g' \
           -e 's#http://security.debian.org#https://mirrors.aliyun.com/debian-security#g' \
           /etc/apt/sources.list

sed -i.bak -e 's#http://ftp.debian.org#https://repo.huaweicloud.com#g' \
           -e 's#http://security.debian.org#https://repo.huaweicloud.com/debian-security#g' \
           /etc/apt/sources.list

CEPH 源更换 ​

如果你在 PVE 中使用了 CEPH 存储，建议同步替换 CEPH 的源。通常 CEPH 源位于 /etc/apt/sources.list.d/ceph.list。

注意：PVE 8 (Bookworm) 对应的 CEPH 版本通常为 quincy 或 reef，而 PVE 7 (Bullseye) 对应 pacific 或 quincy。以下命令以 PVE 8 (Bookworm) + CEPH Quincy 为例，请根据实际情况调整。

# 请根据你的 CEPH 版本和系统代号进行调整
echo "deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/ceph-quincy $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release) no-subscription" > /etc/apt/sources.list.d/ceph.list

sed -i.bak "s#http://download.proxmox.com#https://mirrors.tuna.tsinghua.edu.cn/proxmox#g" /usr/share/perl5/PVE/CLI/pveceph.pm

# 替换 ceph.list 中的源地址
# 请根据你的 CEPH 版本（如 ceph-quincy, ceph-reef）进行调整
echo "deb https://mirrors.ustc.edu.cn/proxmox/debian/ceph-quincy $(grep -Po '^VERSION_CODENAME=\K.*' /etc/os-release) no-subscription" > /etc/apt/sources.list.d/ceph.list

# 替换 pveceph 初始化工具中的下载地址（可选，用于 pveceph install 命令）
sed -i.bak "s#http://download.proxmox.com#https://mirrors.ustc.edu.cn/proxmox#g" /usr/share/perl5/PVE/CLI/pveceph.pm

LXC 容器模板源更换 ​

PVE 的 LXC 容器模板下载器（APLInfo）也默认使用官方源。替换后可以加速 CT 模板的下载。

sed -i.bak 's#http://download.proxmox.com#https://mirrors.tuna.tsinghua.edu.cn/proxmox#g' /usr/share/perl5/PVE/APLInfo.pm

sed -i.bak 's#http://download.proxmox.com#https://mirrors.ustc.edu.cn/proxmox#g' /usr/share/perl5/PVE/APLInfo.pm

sed -i.bak "s#http://download.proxmox.com#https://mirrors.nju.edu.cn/proxmox#g" /usr/share/perl5/PVE/APLInfo.pm

应用更改 ​

完成上述修改后，必须更新缓存并重启 PVE 的后台服务以使更改生效。

# 更新 apt 缓存
apt update

# 重启 pvedaemon 服务 (无需重启系统)
systemctl restart pvedaemon

若 apt update 运行无报错且速度明显提升，则说明换源成功。

由于 windows 太卡，索性把平板换成 manjaro 系统，导致触摸屏无法使用（虽然大概率用不到，但强迫症不舒服）

苦寻许久终于找到解决方案 gsl-firmware

设备信息 ​

• 主板：H8811
• 屏幕：显示分辨率 1280x800，10.1 英寸屏幕
• 内存：DDR3 4GB
• 磁盘：eMMC 64GB
• CPU：Intel Cherry Trail X5-Z8350 1.44GHz

准备驱动 ​

从 github 拉取 gsl-firmware, 并进入工具目录

git clone https://github.com/onitake/gsl-firmware.git
cd gsl-firmware/tools

./fw_extractor gslX680.ko

# 通过GSL_TS_CFG.h获取
./untscfg GSL_TS_CFG.h firmware.fw

# 通过SileadTouch.fw获取
./unscramble SileadTouch.fw firmware.fw

# 通过SileadTouch.sys获取
./scanwindrv SileadTouch.sys

安装驱动 ​

dmesg | grep silead

# Output:
# [    7.238457] silead_ts i2c-MSSL1680:00: supply vddio not found, using dummy regulator
# [    7.238596] silead_ts i2c-MSSL1680:00: supply avdd not found, using dummy regulator
# [    7.239017] silead_ts i2c-MSSL1680:00: Silead chip ID: 0x80360000
# [    7.384785] silead_ts i2c-MSSL1680:00: Direct firmware load for silead/mssl1680.fw failed with error -2
# [    7.384802] silead_ts i2c-MSSL1680:00: Firmware request error -2
# [    7.571823] silead_ts: probe of i2c-MSSL1680:00 failed with error -2

mkdir /lib/firmware/silead
cp firmware.fw /lib/firmware/silead/mssl1680.fw

modprobe -r silead
modprobe silead

git clone https://github.com/onitake/gslx680-acpi.git
cd gslx680-acpi
make && make install
# make uninstall 卸载命令

./fwtool -c firmware.fw -m 1680 -w 1280 -h 800 -t 10 silead_ts.fw
cp silead_ts.fw /lib/firmware

# Usage: fwtool {
#   -i <new_firmware.fw> |
#   -x <new_firmware.fw> <firmware.fw> |
#   (-c [<firmware.fw> -1|<GSL_TS_CFG.h> -2|<SileadTouch.fw> -3] | -s ) [-m <controller_model>] [-w <width>] [-h <height>] [-t <num_touches>] [-f <flags>] <new_firmware.fw>
# }
# -i    打印新型固件的信息
# -c    将旧的固件格式转换为新型固件格式
# -s    设置新型固件参数和标志
# -x    新型固件格式转换回旧的固件格式
#
# -1    Plain firmware, as used with the Android driver (默认)
# -2    Windows GSL_TS_CFG.h firmware
# -3    Scrambled Windows SileadTouch.fw firmware
# -m    设置芯片型号（4字节ASCII字符串，例如：1680）
# -w    设置宽度参数（分辨率）
# -h    设置高度参数（分辨率）
# -t    设置支持的触点数量参数
# -f    设置标志，用逗号分隔（可选，支持的标志： xflip, yflip, swap, track）
#           xflip 开启水平翻转
#           yflip 开启垂直翻转
#           swap xy轴交换
#           track 启用手指跟踪（用于不支持的芯片）
#          (每个标志都可以加上'no'前缀以禁用它(noxflip, noyflip, noswap, notrack))

modprobe -r gslx680_ts_acpi
modprobe gslx680_ts_acpi

遇到的问题 ​

• 不知道什么原因，一旦屏幕旋转校准信息就会丢失
• HOME 键无法使用

markdown-it 测试

# 命令代码预览测试

选项卡测试 ​

modprobe -r silead
modprobe silead

modprobe -r gslx680_ts_acpi
modprobe gslx680_ts_acpi

代码块测试 ​

test

testa

test2 ​

export default {
  data() {
    return {
      msg: "Error", 
      msg: "Warning", 
    };
  },
};

export default {
  data () {
    return {
      msg: 'Removed'
      msg: 'Added'
    }
  }
}

export default {
  data() {
    return {
      msg: "Focused!", 
    };
  },
};

export default {
  data() {
    return {
      msg: "Highlighted!", 
    };
  },
};

// line-numbers is disabled by default
const line2 = "This is line 2";
const line3 = "This is line 3";

// line-numbers is enabled
const line2 = 'This is line 2'
const line3 = 'This is line 3'

// line-numbers is enabled and start from 2
const line3 = 'This is line 3'
const line4 = 'This is line 4'

export default { // Highlighted
  data () {
    return {
      msg: `Highlighted!
      This line isn't highlighted,
      but this and the next 2 are.`,
      motd: 'VitePress is awesome',
      lorem: 'ipsum'
    }
  }
}

提示测试 ​

数学公式 ​

When $a\ne 0$, there are two solutions to $(a{x}^2+bx+c=0)$ and they are

Maxwell's equations:

列表样式 ​

• 1
• 2
• 3

1. 1
2. 2
3. 3

2.9 分割线 ​

可以在一行中用三个以上的减号来建立一个分隔线，同时需要在分隔线的上面空一行。如下：

脚注 1 链接^[1]。

脚注 2 链接[2]。

行内的脚注[3] 定义。

重复的页脚定义[2:1]。