硬件 on T.本秋的自留地

UPS 折腾记

Wed, 22 Apr 2026 23:00:09 +0800

前言
#

最近我突然有了两台 ups 的管理权，一台工作室的 APC Smart-UPS SPRM1K，另一台家里的 APC BACK-UPS BK650。由于手边只有前者，先更新前者的研究成果，后者择日更新。

管理带通信的 UPS 的配套软件其实就两种，这里主要讲解 NUT，而 apcupsd 配置很简单，而且也可以作为 NUT 的驱动，这里不再详述。

NUT 的配置
#

要理解 NUT，首先要明白几个概念：driver、monitor(client)、server（可选），三个服务都要单独启用。

驱动层
#

driver 其实就是对接各种奇奇怪怪 ups 的，这里我这两台一个用的是串口（apcsmart）,另一个是 usbhid-ups，这里主要是以前者讲解的。

配置 ups 驱动：

## /etc/nut/ups.conf 
## 根据需要填写,可用nut-scanner -U获取驱动
[ups] 
    driver = apcsmart 
    port = /dev/ups 
    cable = 940-0024 
    ignorelb # 手动指定阈值
    override.battery.charge.low = 70 
    override.battery.runtime.low = 20

启动服务：upsdrvctl start。

这里有个小插曲，串口可能提示权限不够：

root@pve:/etc/nut# upsdrvctl start
Network UPS Tools - UPS driver controller 2.8.1
Network UPS Tools - Generic HID driver 0.52 (2.8.1)
USB communication driver (libusb 1.0) 0.46
libusb1: Could not open any HID devices: insufficient permissions on everything
No matching HID UPS found
upsnotify: notify about state 4 with libsystemd: was requested, but not running as a service unit now, will not spam more about it
upsnotify: failed to notify about state 4: no notification tech defined, will not spam more about it
Driver failed to start (exit status=1)

用 udev 规则，给 nut 权限：

cat << 'EOF' > /etc/udev/rules.d/99-nut-ups.rules
SUBSYSTEM=="usb", ATTR{idVendor}=="051d", ATTR{idProduct}=="0002", MODE="0660", GROUP="nut"
EOF
udevadm control --reload-rules
udevadm trigger

再次启动：upsdrvctl start

服务层
#

nut 其实 c/s 架构很分明，如果只有一台机子，也得启动一个服务器。但是这也为拓展型带来了便利。

如果你只有一台机子，用 standalone 即可，作为“吹哨人”，用 netserver，接收命令关闭自己的机器，用 netclient。

我这里改成服务器：

## /etc/nut/nut.conf
# 服务器模式
MODE=netserver

## /etc/nut/upsd.conf
# 加上这一行，给局域网里面的设备提供服务
# 如果你是pve而且路由器不接ups，建议自己建一个
# 自定义交换机
LISTEN 0.0.0.0 3493

配置用户，monuser 最好有，因为群晖用这个而且不能更改。

## /etc/nut/upsd.users
[monuser] 
    password = secret 
    upsmon slave 
[admin] 
    password = <your_password>
    upsmon master 
    actions = SET
    instcmds = ALL

启动服务：systemctl enable --now nut-server

客户端/监视层
#

配置 nut-monitor 以便自动关机：

MONITOR ups@localhost 1 monuser secret master # slave也可以，后文（关机过程）讲

你可以看到，最下面有个shutdown命令，这个只要 monitor 服务启动了，在遇到低电量阈值的时候，就一定会执行的。

启动服务：systemctl enable --now nut-monitor

关机过程
#

断开电源，nut 检测到电池供电，其他客户端收到信号。

对于群晖这种设置了 upssched 的机子，他可以在检测到断电之后的一定时间开启安全模式（umount 所有分区，只保留必须的 nut 监听服务和关机逻辑），如果在此期间市电恢复，重新检测到后会进行自动重启。

电池到达所给定的阈值（电量/剩余事件/电池供电时间），发出警告信号。

这时候服务器自己会开始关机（执行 shutdown），其他客户端会收到信号，开始进行关机。

在关机最后一刻，有一个有意思的脚本想和大家分享。

这个脚本是 systemd 在关机的最后时刻执行的，位于/usr/lib/systemd/system-shutdown/nutshutdown。我们来看看他的结构：

#!/bin/sh

# This script requires both nut-server (drivers)
# and nut-client (upsmon) to be present locally
# and on mounted filesystems
[ -x "/sbin/upsmon" ] && [ -x "/sbin/upsdrvctl" ] || exit

if /sbin/upsmon -K >/dev/null 2>&1; then
  # The argument may be anything compatible with sleep
  # (not necessarily a non-negative integer)
  wait_delay="`/bin/sed -ne 's#^ *POWEROFF_WAIT= *\(.*\)$#\1#p' /etc/nut/nut.conf`" || wait_delay=""

  /sbin/upsdrvctl shutdown

  if [ -n "$wait_delay" ] ; then
    /bin/sleep $wait_delay
    # We need to pass --force twice here to bypass systemd and execute the
    # reboot directly ourself.
    /bin/systemctl reboot --force --force
  fi
fi

exit 0

可以注意到经过一系列的判断，如果是真的断电（发出警告后）upsmon -K会返回 1，那么就会使用upsdrvctl shutdown来命令 ups 在一定时间后断电。

但是这时候，系统已经解除了所有的磁盘 rw 的挂载，执行完脚本的下一步其实就是给 acpi 电源发送 S5 信号并断电，速度很快，其实断不断电也无所谓了。

一般的断电延时 20s 绰绰有余。至于断电时间的设置，高级的 ups 可以设置（见后文upsrw），普通的不可以。

所以如果这是最后一个“吹哨人”执行的 killpower（让 ups 等会断电），最好关闭的时候要尽量比 slave 关得晚，否则就得尽量延长 ups 的延迟时间。

常用命令
#

upscmd：执行一些驱动预设的指令
#

root@SAST-Docker:~# upscmd -l ups
Instant commands supported on UPS [ups]:

bypass.start - Put the UPS in bypass mode
bypass.stop - Take the UPS out of bypass mode
load.off - Turn off the load immediately
load.on - Turn on the load immediately
shutdown.return - Turn off the load and return when power is back
shutdown.stayoff - Turn off the load and remain off
test.battery.start - Start a battery test
test.battery.stop - Stop the battery test
test.failure.start - Start a simulated power failure
test.panel.start - Start testing the UPS pane

upsrw：用于读写 eeprom 的
#

使用：

upsrw -l <upsname>

控制响声、复电延迟启动、复电要求电池水平、关电延迟停止 ups。

比如我们工作室的 SPRM1K 可以设置的东西就很多，还贴心的用了 enum 告诉你：

root@SAST-Docker:/etc/nut# upsrw -l ups
[battery.alarm.threshold]
Battery alarm threshold
Type: ENUM NUMBER
Option: "0" SELECTED
Option: "T"
Option: "L"
Option: "N"

[battery.charge.restart]
Minimum battery level for restart after power off (percent)
Type: ENUM NUMBER
Option: "00"
Option: "15"
Option: "50" SELECTED
Option: "90"

[battery.date]
Battery change date
Type: STRING
Maximum length: 8
Value: 12/30/25

[input.transfer.high]
High voltage transfer point (V)
Type: ENUM NUMBER
Option: "231"
Option: "242"
Option: "253"
Option: "264" SELECTED

[input.transfer.low]
Low voltage transfer point (V)
Type: ENUM NUMBER
Option: "187"
Option: "176" SELECTED
Option: "165"
Option: "154"

[output.voltage.nominal]
Nominal output voltage (V)
Type: ENUM NUMBER
Option: "220" SELECTED
Option: "230"
Option: "240"

[ups.delay.shutdown]
Interval to wait after shutdown with delay command (seconds)
Type: ENUM NUMBER
Option: "020"
Option: "180"
Option: "300" SELECTED
Option: "600"

[ups.delay.start]
Interval to wait before (re)starting the load (seconds)
Type: ENUM NUMBER
Option: "000"
Option: "060" SELECTED
Option: "180"
Option: "300"

[ups.id]
UPS system identifier
Type: STRING
Maximum length: 8
Value: UPS_IDEN

[ups.test.interval]
Interval between self tests (seconds)
Type: ENUM NUMBER
Option: "1209600" SELECTED
Option: "604800"
Option: "0"

我在这里改了ups.delay.shutdown，原因很尴尬，esxi 只支持客户端模式的 nut，服务端只能用一台虚拟机来实现。那么希望在服务端发出 killpower 后，还能等待 esxi 关闭，这个时间就不可避免的延长。

我还改了ups.delay.start，这个参数很有意思，他没有注释，根据字面意思理解，应该是断电之后延迟启动吧？

但是不是这个意思。他指的是如果你发出了 killpower 的命令后中途来电，他断电后，应该在多少秒后开机？

我觉得这句话得细品。

对于我这台 SPRM1K 来说，发送 killpower 指令后，首先是等待ups.delay.shutdown的时间，然后切断输出，然后过了硬编码的 1 分钟，关闭 ups 自己。

那么就有几种情况：

在等待ups.delay.shutdown时，市电恢复。
在等待硬编码的 1 分钟的时候，市电恢复。
ups 关机之后，市电恢复。

这三种情况中前两者会等待ups.delay.start的时间，最后一种不会等待，初始化之后直接开机。

我想应该是这篇文章里面提到的问题，作者说如果断电的时间太短，那么 After AC Loss 就算设置为 Power On，也不一定能自动开机。所以才有这么一个选项。

btw: 我并不太赞同链接里面的方案，复杂度太高了很难维护，其实里面很多东西厂家已经做好了。（排除 UPS 不够高端的问题，这个等我回去测试一下我的 BK650 再下定论）

奇怪的 bug
#

根据 man 8 usbhid-ups 中的说明，可以直接在 ups.conf 里面配置 allow_killpower 来在启动的时候生效，但是这个 issue 说 allow_killpower 在 2.8.3 之后才修复启动的时候硬编码的 0 会覆盖回去的问题，然而 trixie 是 2.8.1，就很难受。

能用点 hack 的办法，启动的时候修改。

systemctl edit nut-driver@ups.service
# 写入
[Service]
# 延迟几秒确保驱动已经完全初始化
ExecStartPost=/bin/sh -c "sleep 5 && /usr/bin/upsrw -s driver.flag.allow_killpower=1 -u admin -p <你的密码> ups"

但是这台设备不再身边，所以我还是选择了保守的 apcupsd 方案关机+nut 桥接给群晖，这篇文章之后还会更新的。

给老机 x200 刷开源 BIOS--Coreboot！

Sat, 30 Aug 2025 12:33:31 +0800

这篇文本来是想写一下升级过程的，因为我在家里面翻出了这台 x200，也算是我早期用得比较久的本子了（B 站就是在这上面注册的）。

出于情怀，给它换了无线网卡，换了风扇，内存 4G->8G，换了原来坏了的键盘，总共没超过 200 元。

不过暂时没带来学校，所以图片的话，以后再补充吧。

刷入 Coreboot 注意事项
#

这里记载了折腾过程中遇到的坑。

请不要购买 CH341A！
#

为什么我会在这里得出跟 libreboot 一样的结论呢？

CH341A 无法设置 spispeed，而是默认 2M，这就造成一个问题，如果你的连接质量不好的话，这已经是一个相当高的速率了。可能会使得你根本没法看到你的芯片读取到。这里还是推荐买正版的 pico 吧，这玩意用的 buck-boost 电路，相比国产的 pico 来说，发热肯定会小不少，这可能对稳定刷写有一定的帮助。

刷写
#

在libreboot 的教程中，告诉你1, 9脚分别是 WP/HOLD，据说主板自带上拉电阻，所以不用连接。

经过测试，发现夹子连接正确的话，这两个脚会有 3.1v 左右的电压，稍微低了一点但是不影响。

如果原始的固件你可能根本刷不进去，写入没一会就提示擦除失败，我试了连接这两个脚是无关事项，所以后来者可以不用连接。

请看过程：

❯ flashprog -p serprog:dev=/dev/ttyACM0,spispeed=16M -c "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" -w x200_bios.rom

Using clock_gettime for delay loops (clk_id: 1, resolution: 1ns).
serprog: Programmer name is "pico-serprog"
Found Macronix flash chip "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" (8192 kB, SPI) on serprog.
Reading old flash chip contents... done.
Erasing and writing flash chip... FAILED at 0x00130000! Expected=0xff, Found=0x2f, failed byte count from 0x00130000-0x00137fff: 0x44aa
ERASE FAILED!
FAILED!
Uh oh. Erase/write failed. Checking if anything has changed.
Reading current flash chip contents... done.
Apparently at least some data has changed.
Your flash chip is in an unknown state.

那这个问题如何解决呢？答案是先擦除，再写入。

像这样：

❯ flashprog -p serprog:dev=/dev/ttyACM0,spispeed=16M -c "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" -E

...
Using clock_gettime for delay loops (clk_id: 1, resolution: 1ns).
serprog: Programmer name is "pico-serprog"
Found Macronix flash chip "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" (8192 kB, SPI) on serprog.
Erasing flash chip... Erase done.

然后就可以完美写入了：

❯ flashprog -p serprog:dev=/dev/ttyACM0,spispeed=16M -c "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" -w x200_bios.rom

...
Using clock_gettime for delay loops (clk_id: 1, resolution: 1ns).
serprog: Programmer name is "pico-serprog"
Found Macronix flash chip "MX25L6436E/MX25L6445E/MX25L6465E/MX25L6473E/MX25L6473F" (8192 kB, SPI) on serprog.
Reading old flash chip contents... done.
Erasing and writing flash chip... Erase/write done.
Verifying flash... VERIFIED.

提醒一句，尽量不要接在 hub 或者台式机的前面板，很可能会供电不足导致写入之后验证失败。

如果杜邦线的长度太长（最好 10cm），夹子的质量不好，可能会导致你根本无法用 16M 的 spispeed 写入，甚至根本没法读取到芯片，经过我测试，现在我手上的这套设备已经不太行了，只能在 64K 的速度稳定写入，这消耗了大概 50 分钟进行一轮读取 - 擦除/写入 - 读取，所以当你成功刷入 coreboot 后，最好保守一点，直接在目标机子上面刷吧。

中国移动 RAX3000Me USB3.0 版折腾小记

Sat, 12 Jul 2025 13:47:15 +0800

前言
#

这几天在闲鱼蹲路由器，终于让我蹲到了一台 65 的 RAX3000Me，遂开始折腾。

买之前看了下恩山发现可以免拆，无非就是导出导入配置文件破解 ssh 呗，但是到手之后，发现我大意了。

这台没法按照标准流程¹破解密码，通过爬帖得知，无法导出配置的自己的加密都存在问题，没办法免拆。

那？！CH340，启动！

刷写教程
#

教程大部分都是参考这篇文章，在此感谢。

CMCC RAX3000Me 可通过 mtk_uartboot 启动刷机，拆机刷 OpenWRT/ImmortalWRT 无障碍！

拆机
#

先把贴纸撕下来，拧下两颗螺丝。

左手握着长边，右手握着短边，像这样：

用力往下掰，会出现一条缝，用薄点的拆机片或者卡片撬开，小心别把卡扣弄断了。

拧下 5 颗螺丝，卸下散热片，上面涂有硅脂，要稍微移动一下散热片才好下来，装回去的时候得重新涂一下。

（其实不卸下也行，但是我探针就太难插了）

推一下下面和右边的卡扣，把主板撬出来，小心不要弄断天线连接处了。

你会看到这样：

电源线左边，分别是GND TX 3.3v RX。

文件准备
#

准备好这些东西：

❯ ls -lah
总计 2.3M
drwxr-xr-x 1 texsd texsd  148  7月19日 14:11 .
drwx------ 1 texsd texsd 1.3K  7月18日 21:58 ..
-rw-r--r-- 1 texsd texsd 248K  7月14日 18:10 mt7981-cmcc_rax3000me-nand-ddr3-fip-fit.bin
-rwxrwxr-x 1 texsd texsd 206K 2024年 2月 2日 mt7981-ddr3-bl2.bin
-rwxr-xr-x 1 texsd texsd 1.9M 2024年 3月 2日 mtk_uartboot

天灵的 U-Boot

bl2 （预构建，也可自行编译）²

mtk_uartboot

打开你的shell，cd到此文件夹，连接你的 CH340，你应该能在设备管理器看到对应的串口。我是/dev/ttyUSB0，如果你使用 Windows，一般是COMX，请自行替换。

./mtk_uartboot -s /dev/ttyUSB0 -p ./mt7981-ddr3-bl2.bin -f mt7981-cmcc_rax3000me-nand-ddr3-fip-fit.bin --brom-load-baudrate 115200 --bl2-load-baudrate 115200 -a

这里要记得加-a，否则可能识别成 aarch32 导致超时。

这时候应该会提示：

mtk_uartboot - 0.1.1
Using serial port: /dev/ttyUSB0
Handshake...

准备完成！

刷入 UBOOT
#

把你的 CH340 插上线，用杜邦线什么的都行，但是最好有带弹簧的测试探针，这是我的工具：

找出 CH340 的GND RX TX，从左往右依次按上主板的触点（不用接 3.3v），这时候右手还可以操作电脑。

如果你不确定是否插好，可以退出 mtk_uartboot，打开任意串口工具并连接，直接插电启动，应该能看到调试信息。

确认插好了，就直接上电，大概 30 秒左右，mtk_uartboot 输出以下内容并交还 shell：

mtk_uartboot - 0.1.1
Using serial port: /dev/ttyUSB0
Handshake...
hw code: 0x7981
hw sub code: 0x8a00
hw ver: 0xca00
sw ver: 0x1
Baud rate set to 115200
sending payload to 0x201000...
Checksum: 0x55cf
Setting baudrate back to 115200
Jumping to 0x201000 in aarch64...
Waiting for BL2. Message below:
==================================
NOTICE:  BL2: v2.10.0   (release):v2.4-rc0-5845-gbacca82a8-dirty
NOTICE:  BL2: Built : 20:18:08, Feb  2 2024
NOTICE:  WDT: Cold boot
NOTICE:  WDT: disabled
NOTICE:  EMI: Using DDR3 settings
NOTICE:  EMI: Detected DRAM size: 512MB
NOTICE:  EMI: complex R/W mem test passed
NOTICE:  CPU: MT7981 (1300MHz)
NOTICE:  Starting UART download handshake ...
==================================
BL2 UART DL version: 0x10
Baudrate set to: 115200
FIP sent.
==================================
NOTICE:  Received FIP 0x3df58 @ 0x40400000 ...
==================================

然后路由器就会亮起蓝灯（正常进官方系统没联网是红灯），网线插 LAN 口连到电脑，输入192.168.1.1/uboot.html，上传之前下载的 uboot。

一些问题
#

mtk_uartboot异常退出，提示 coredump

这大概率是连接不好/接上了 3.3v。建议不要接 3.3v，否则每次连上都会导致 CH340 断开连接。

无论怎么尝试，总是提示Timeout waiting for specified message.

有下面两种情况：

第一种：没有加-d参数。

Jumping to 0x201000 in aarch32...
Waiting for BL2. Message below:
==================================
==================================
Timeout waiting for specified message.

这就是默认使用了aarch32，请严格按照上面的命令执行！

第二种：没识别出内存。

==================================
NOTICE:  BL2: v2.10.0   (release):v2.4-rc0-5845-gbacca82a8-dirty
NOTICE:  BL2: Built : 20:20:25, Feb  2 2024
NOTICE:  WDT: Cold boot
NOTICE:  WDT: disabled
NOTICE:  EMI: Using DDR4 settings
NOTICE:  EMI: Detected DRAM size: 0MB
==================================

你的 bl2 用错了，请确认你的 ddr 类型，或者尝试另外一种 ddr 类型。

第三种：是aarch64，但是没有输出。

Jumping to 0x201000 in aarch64...
Waiting for BL2. Message below:
==================================
==================================
Timeout waiting for specified message.

可能是以下情况：

自己编译的 bl2 没成功。
下载中出现损坏。
使用了 immortalwrt 官方的 preloader，此文件我试了很多次都没成功，原因未知。

刷入固件
#

新版固件
#

新版的immortalwrt（23.05 和我打算用的 24.10）已经在使用一种新的镜像文件*.itb，这个镜像同时包含dtb ramdisk kernel。想要详细了解的可以参考u-boot FIT image 介绍

直接刷入sysupgrade的itb可能会出现不成功的情况，表现为一直闪蓝灯，这里我们需要先刷入initramfs的itb，重启进入系统之后，再刷入对应的sysupgrade镜像。

请注意uboot版本可能与固件版本相关，经过测试天灵 25 年 3 月编译的uboot是可以使用我上面的方法刷入 237 固件。

padavanonly/immortalwrt-mt798x-6.6

旧版固件
#

如果你想使用原汁原味的immortalwrt-mt798x，你可能得使用原版的 hanwckf 的uboot，这个版本没有dhcp需要手动设置静态地址。建议使用 24.11 的版本，因为尝试了 22 年的版本发现不认复旦微的这颗 NAND，导致uboot无法启动，只能使用 CH340 重新刷一遍。

而且，使用最新源码编译出来会导致 wifi 设置中缺少加密方式的问题，此问题亦有在 issues 里面提及，但感觉修复的可能性不大。

硬件 on T.本秋的自留地

UPS 折腾记

前言 #

NUT 的配置 #

驱动层 #

服务层 #

客户端/监视层 #

关机过程 #

常用命令 #

upscmd：执行一些驱动预设的指令 #

upsrw：用于读写 eeprom 的 #

奇怪的 bug #

给老机 x200 刷开源 BIOS--Coreboot！

刷入 Coreboot 注意事项 #

请不要购买 CH341A！ #

刷写 #

中国移动 RAX3000Me USB3.0 版折腾小记

前言 #

刷写教程 #

拆机 #

文件准备 #

刷入 UBOOT #

一些问题 #

刷入固件 #

新版固件 #

旧版固件 #

参考 #

前言
#

NUT 的配置
#

驱动层
#

服务层
#

客户端/监视层
#

关机过程
#

常用命令
#

upscmd：执行一些驱动预设的指令
#

upsrw：用于读写 eeprom 的
#

奇怪的 bug
#

刷入 Coreboot 注意事项
#

请不要购买 CH341A！
#

刷写
#

前言
#

刷写教程
#

拆机
#

文件准备
#

刷入 UBOOT
#

一些问题
#

刷入固件
#

新版固件
#

旧版固件
#

参考
#