Ubuntu-Rockchip项目中的pd-mapper服务问题分析与解决方案

在基于Rockchip处理器的单板计算机上运行Ubuntu系统时，用户可能会遇到pd-mapper服务启动失败的问题。这个问题主要出现在使用Ubuntu 24.04 LTS系统的Orange Pi 5 Plus等Rockchip平台设备上。

问题现象

系统启动过程中，pd-mapper服务会报错并无法正常启动。查看服务状态会显示如下错误信息：

× pd-mapper.service - Qualcomm PD mapper service
     Loaded: loaded (/usr/lib/systemd/system/pd-mapper.service; enabled; preset: enabled)
     Active: failed (Result: exit-code)

问题根源分析

pd-mapper服务是专为Qualcomm处理器设计的电源管理服务，主要用于处理电源域映射。然而在Rockchip平台的设备上，这个服务并不适用，因此会导致启动失败。虽然服务失败不会直接影响系统的基本功能，但会带来以下问题：

1. 延长系统启动时间
2. 产生不必要的错误日志
3. 占用系统资源尝试重启服务

解决方案

临时解决方案

对于已经安装好的系统，可以通过以下命令禁用该服务：

sudo systemctl disable pd-mapper.service

长期解决方案

从系统镜像构建层面解决这个问题更为合理，有两种实现方式：

1. 通过ubuntu-rockchip-settings包
   可以修改该软件包的配置，使其在安装时根据处理器类型决定是否启用pd-mapper服务。

2. 在创建rootfs时处理
   在livecd-rootfs构建过程中，可以添加逻辑判断，对于Rockchip平台的设备自动禁用该服务。

技术实现建议

对于Rockchip平台的设备，建议在系统镜像构建阶段就禁用pd-mapper服务。这可以通过在构建脚本中添加如下逻辑实现：

# 检查处理器架构
if [ "$(uname -m)" = "aarch64" ]; then
    # 进一步检查是否为Rockchip平台
    if grep -q "rockchip" /proc/device-tree/compatible; then
        chroot "${rootfs}" systemctl disable pd-mapper.service
    fi
fi

这种实现方式具有以下优点：

• 自动适配所有Rockchip平台设备
• 在系统安装前就解决问题
• 不影响Qualcomm平台设备的正常功能

总结

对于基于Rockchip处理器的单板计算机用户，pd-mapper服务的问题虽然不影响基本使用，但最佳实践还是在系统构建阶段就将其禁用。这不仅可以提升系统启动效率，还能保持系统日志的整洁。项目维护者可以考虑在未来的版本中默认对Rockchip平台禁用此服务。