软件安装指南

本指南介绍 aBMC 软件包的下载方式、版本目录结构、包关系，以及 BMC 端与子板端的安装与升级步骤。

下载地址

资料包下载地址（提取码：jctu）

目录结构

aBMC 目录按版本划分为多个子目录，版本号由大到小排列，最靠前的为最新版本。

aBMC
├── v3.2.3
├── v3.2.0
├── v3.1.3
└── v2.9.4

以 v3.2.3 为例，版本目录中包含以下文件：

软件包关系

BMC 端的三个包需要全部安装；子板端需要安装 client 包，或者补装 client 包声明的系统依赖和 udev 规则。

各包功能说明

firefly-abmc（BMC 端）

• 安装时自动带上 firefly-abmc-server 和 firefly-abmc-tools。
• 提供 BMC 板级维护服务：
  • ADB 服务：启动 ADB，供子板连接。
  • 服务保活：监控并拉起 Prometheus 等核心服务。
  • 子板控制：子板复位、进入 loader。
  • 按键处理：GPIO 按键事件。
  • 烧录工具：网络 / USB 烧录（flash-fw-net、flash-fw-usb、rkdeveloptool）。
  • 子板映射：/etc/fbmc/*_adb_alias 记录子板 USB 位置与名称。

firefly-abmc-server（BMC 端）

• aBMC 主程序：
  • Web 管理后端：aBMC.service、ffbackend_core。
  • 节点服务：nodeService（aarch64 / android / riscv64）。
  • 升级与恢复：flashserver、upgrade_tool、unpack_fw。
  • Web 与监控：Caddy、Prometheus、Alertmanager、TSDB。
  • 数据目录：/var/firefly-aBMC（数据库、Web 资源、业务文件）。
• 依赖的系统包由 apt 自动安装（ADB、SQLite、nftables、DHCP、chrony、NFS/Samba、Redis、VNC、netplan 等）。

firefly-abmc-tools（BMC 端）

• 提供板级 MCU 固件：
  • 风扇 PWM、风扇检测、SATA 等功能的 hex 固件。
  • 文件名对应不同机型（B1 / B2 / C2 / CS-B2 / CS-D2）。
• 提供网络恢复资源：
  • netrecovery-slave：网络恢复 / 烧录脚本。
  • RK3399、RK3588S 的 recovery 镜像，用于子板网络恢复 / 烧录。
• 无额外依赖。

firefly-abmc-client（子板端）

• 提供子板与 aBMC 通信所需的运行环境，推荐安装。
• 包内文件说明：
  • etc/runtime-monitor.ini：运行监控配置（可选）。
  • etc/udev/rules.d/99-rockchip-permissions.rules：RK 平台设备权限规则。
  • lib/systemd/system/runtime-monitor.service：运行监控服务（可选）。
  • usr/local/bin/runtime-monitor-arm64 / riscv64：运行监控程序（可选小工具）。
• 不安装 client deb 时：需要安装 12 个系统依赖并补 udev 规则；非 RK 平台子板可跳过 udev 规则。
• 运行监控可有可无，不影响 aBMC 基本运行。

安装与升级

安装或升级 aBMC 时，BMC 与子板均需联网（可访问软件源），以便 apt 解析和安装依赖包。

sudo apt install -y ./firefly-abmc-server*.deb ./firefly-abmc-tool*.deb ./firefly-abmc_*all.deb

sudo apt install -y ./firefly-abmc-client*.deb

firefly-abmc-client/
├── etc/
│   ├── runtime-monitor.ini
│   └── udev/rules.d/99-rockchip-permissions.rules
├── lib/systemd/system/runtime-monitor.service
└── usr/local/bin/
    ├── runtime-monitor-arm64
    └── runtime-monitor-riscv64

sudo apt install -y nftables chrony nfs-kernel-server nfs-common samba \
  cifs-utils sshfs logrotate i2c-tools ethtool netplan.io lsof

sudo tee /etc/udev/rules.d/99-rockchip-permissions.rules >/dev/null <<'EOF'
ACTION=="remove", GOTO="permissions_end"

# VPU devices
KERNEL=="avsd", MODE="0660", GROUP="video"
KERNEL=="vepu", MODE="0660", GROUP="video"
KERNEL=="h265e", MODE="0660", GROUP="video"
KERNEL=="rkvdec", MODE="0660", GROUP="video"
KERNEL=="rkvenc", MODE="0660", GROUP="video"
KERNEL=="mpp_service", MODE="0660", GROUP="video"
KERNEL=="vpu[_-]service", MODE="0660", GROUP="video"
KERNEL=="hevc[_-]service", MODE="0660", GROUP="video"

# RGA device
KERNEL=="rga", MODE="0660", GROUP="video"

# MALI devices
KERNEL=="mali*", MODE="0660", GROUP="video"

SUBSYSTEM=="mmc_rpmb" KERNEL=="mmcblk*[0-9]rpmb", MODE="0666"

# DMA heap devices
KERNEL=="cma", MODE="0660", GROUP="video"
KERNEL=="cma-uncached", MODE="0660", GROUP="video"
KERNEL=="system", MODE="0660", GROUP="video"
KERNEL=="system-dma32", MODE="0660", GROUP="video"
KERNEL=="system-uncached", MODE="0660", GROUP="video"
KERNEL=="system-uncached-dma32", MODE="0660", GROUP="video"

LABEL="permissions_end"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger

systemctl status aBMC