libsoc_adapter ​

版本信息 ​

1. 组件概述 ​

1.1 组件简介 ​

libsoc_adapter 是 openUBMC 的 BMC SOC 芯片适配库，属于用户态驱动层。它将 BMC SOC 各控制器的内核态 ioctl 接口封装为统一的用户态 API，并通过 BCAL（源码头文件注释为 Board Control Abstraction Layer）纯虚接口对上层微组件屏蔽芯片差异。

组件类型为 library（见 mds/service.json），不启动独立服务进程，也不注册 D-Bus / MDB 资源协作接口（required 为空，仓库中没有 model.json 或 ipmi.json）。运行时代码位于调用方进程内。

编译产物主要包括：

• libbcal.so：驱动工厂与 BCAL 公共框架，安装到 /usr/lib64。
• libsoc_adapter.so：Lua 绑定集合（CMake 目标名为 libsoc_adapter 且 PREFIX 为空），安装到 /usr/lib64。
• libsoc_adapter_c.so：部分 C 封装（如 TRNG / MCTP / USB C wrapper），安装到 /usr/lib64。
• lib{driver}.so：各 BCAL 驱动实现，安装到 /opt/bmc/bcal（例如 libi2c.so、libgpio.so、libuart.so）。
• Mock 库：安装到 /usr/lib64/mock，用于无硬件测试。
• 可选内核模块：bmc_hisport_drv.ko；在 chipv2_enable=true 时还会构建 bmc_i2c_over_localbus_drv.ko、bmc_i3c_over_localbus_drv.ko、bmc_uart_over_localbus_drv.ko，安装到 lib/modules/ko。

Lua 业务通过 require 'libsoc_adapter.{driver}' 加载对应绑定，导出符号为 luaopen_libsoc_adapter_{driver}。

1.2 解决什么问题 ​

上层微组件（如 runtime_accessor、hwproxy、bmc_soc）需要访问 I2C、GPIO、UART、eMMC、PECI 等片上控制器，但不同芯片代际的设备节点、ioctl 和能力集合不同。若业务直接调用内核接口，会把芯片差异扩散到各组件。

libsoc_adapter 通过以下方式隔离差异：

• 以 bcal::IDriver / bcal::IDriverFactory 统一驱动生命周期和加载路径。
• 为每种控制器提供 BCAL 纯虚接口，厂商实现（*Extend）负责实际 ioctl。
• 通过 vendor/huawei/v1/ 与 vendor/huawei/v2/ 以及 CMake 选项 chipv2_enable（对应 CONAN_DEFS_CHIPV2_ENABLE）选择芯片实现。
• 为驱动提供 Lua 绑定，供 Lua 微组件在进程内访问硬件。
• 提供 Mock 实现，支持无真实硬件的 UT/IT。

1.3 核心功能 ​

• 驱动工厂：按名称加载 /opt/bmc/bcal/lib{driver_name}.so，按 driver_name + index 管理实例引用计数。
• BCAL 标准控制器接口：I2C、GPIO、UART / UART 互连、ADC、PWM、SPI、JTAG、Localbus、MDIO、MMC、PECI、MCTP、IPMB、BT、KCS、CANBUS、EDMA、EFUSE、SOL、TRNG、USB DRD、USB 复合设备、WDT、MEM。
• Lua 绑定：BCAL 驱动绑定位于 src/luawrapper/；芯片相关 HAL（如 sys_info、hiss、boot_loader、Hisport）绑定位于 vendor/huawei/v1/ 或 vendor/huawei/v2/。
• HAL 能力：hal::SysInfo（核温、复位原因、DDR 自检等）、hal::Hiss（安全模块 / TPCM / 安全启动）、hal::BootLoader（PCIe 控制器与 BAR 相关环境变量）。
• Hisport：仓库自行实现的内核模块与用户态访问路径，提供初始化、读、写。
• Mock：vendor/huawei/mock/ 下为各驱动提供无硬件实现。

1.4 关键术语表 ​

1.5 外部交互边界图 ​

构建依赖见 mds/service.json：huawei_secure_c、skynet、libsomp；测试依赖 test_data。组件自身没有常驻进程、监听端口或资源协作接口。

2. API 使用说明与示例 ​

本章 C++ 接口以 include/bcal/*.h 为准。仓库内 docs/v1/*.md、docs/v2/*.md 是各驱动的芯片 ioctl 规格，部分签名仍带 config() / index 参数，与当前 BCAL 头文件不一致时，以头文件为准。

本组件没有资源协作接口，不能通过 busctl 调用。

2.1 驱动工厂 bcal::IDriverFactory ​

功能说明 ​

IDriverFactory 是全局单例，负责在指定目录加载 lib{driver_name}.so，并通过导出符号 create_driver / destroy_driver 创建、销毁驱动实例。同一 driver_name 的多个 index 共享动态库句柄，但各自持有独立实例。

头文件：#include "bcal/driver.h"。

bcal::IDriverFactory& factory = bcal::IDriverFactory::get_instance();
factory.set_driver_path("/opt/bmc/bcal");
bcal::IDriver* driver = factory.get_driver("gpio", 192);

参数说明 ​

driver_load_info 字段：driver_name、success、error_msg。

返回值与异常 ​

工厂实现本身不抛出异常；失败通过空指针和 error_msg 表达。error_msg 典型值：

• Failed to load library: ...（dlopen 失败，后接 dlerror()）
• Failed to find both create_driver and destroy_driver symbol

应用场景 ​

• C++ 组件按名称获取 GPIO / I2C / UART 等驱动实例。
• Lua 绑定内部通过工厂取驱动，再转成具体 BCAL 类型。
• 测试时将路径指到 Mock 库目录，替换真实驱动。

限制条件 ​

• 默认路径为 /opt/bmc/bcal，需在首次 get_driver 前按需调用 set_driver_path。
• get_driver_list 不把 libbcal.so 当作驱动。
• release_driver / destroy_driver 传入非本工厂指针时会被忽略。
• 同一 driver_name 的多个 index 共享 .so 句柄；最后一个引用释放后才会卸载动态库。

调试示例 ​

#include "bcal/driver.h"
#include "bcal/gpio.h"

bcal::IDriverFactory& factory = bcal::IDriverFactory::get_instance();
bcal::IDriver* raw = factory.get_driver("gpio", 0);
if (raw == nullptr) {
    auto infos = factory.get_driver_load_info();
    // 根据 infos[].error_msg 定位 dlopen / 符号问题
    return;
}
auto* gpio = static_cast<BCAL_DRIVER_GPIO::Gpio*>(raw);
factory.release_driver(raw);

2.2 bcal::IDriver 公共接口 ​

功能说明 ​

所有 BCAL 驱动必须实现 IDriver。每个实例对应一个硬件对象，由 index 区分（例如一个 Gpio 实例对应一根 GPIO 引脚）。

参数说明 ​

返回值与异常 ​

init / lock / unlock 无返回值；具体实现可能抛出 std::runtime_error（例如设备节点打开失败）。control 约定 0 / -1。

应用场景 ​

所有 BCAL 读写操作之前需要 init；多线程访问同一实例时应成对调用 lock / unlock。

限制条件 ​

• 当前 IDriver 没有 config() 方法；配置通过 init(args, size) 传入。
• control 的 cmd 与参数结构由各驱动头文件定义，不能跨驱动混用。

调试示例 ​

见 2.5 GPIO：GpioConfig 通过 init 传入方向。

2.3 BCAL 驱动接口概览 ​

以下类均继承 bcal::IDriver。命名空间、头文件和关键方法来自 include/bcal/。

未在上表展开的结构体、枚举和 control 命令字，请直接阅读对应头文件。仓库 docs/bcal_interface_doc.md 有更长的接口说明，但其中部分命名空间仍写作 DRIVER_*，与当前头文件中的 BCAL_DRIVER_* 不一致，以头文件为准。

2.4 Lua 模块加载约定 ​

功能说明 ​

libsoc_adapter.so 将多个 luaopen_libsoc_adapter_* 导出到同一共享库。Lua 使用点分模块名加载：

local i2c = require 'libsoc_adapter.i2c'
local gpio = require 'libsoc_adapter.gpio'
local sys_info = require 'libsoc_adapter.sys_info'

参数说明 ​

BCAL Lua 绑定（src/luawrapper/）导出的模块名与 luaopen 后缀如下。

芯片 HAL Lua 绑定（随 v1/v2 编入同一 libsoc_adapter.so）还包括 sys_info、hiss、boot_loader、scm3、hisport、innerbus、comm 等，以对应 luaopen_libsoc_adapter_* 为准。部分 v1/v2 文件将 Mock 入口命名为 luaopen_libsoc_adapter_*_mock，与正式模块名不同，测试代码需要按实际导出符号加载。

返回值与异常 ​

加载成功返回 Lua userdata（绑定类实例）。工厂取驱动失败时，绑定构造函数抛出 std::runtime_error，在 Lua 侧表现为错误，例如 Failed to get driver 'i2c'。

应用场景 ​

Lua 微组件、runtime_accessor 以及各业务仓中的 require 'libsoc_adapter.xxx'。

限制条件 ​

• 需要 /usr/lib64/libsoc_adapter.so 可被 Lua C 搜索器找到（Lua 会把 libsoc_adapter.i2c 解析为库 libsoc_adapter 中的 luaopen_libsoc_adapter_i2c）。
• 同时需要 /opt/bmc/bcal 下对应 lib{driver}.so，以及内核设备节点。
• require 'libsoc_adapter.uart' 的构造函数会立即加载全部 UART 端口以及 uart_connect；任一失败即抛错。v1 最多 8 路，v2（CONAN_DEFS_CHIPV2_ENABLE）最多 16 路。

调试示例 ​

local gpio = require 'libsoc_adapter.gpio'
gpio:init(192, 1)          -- 引脚 192，方向输出
gpio:write(192, 1)
local level = gpio:read(192, 1)
gpio:close()

2.5 I2C ​

功能说明 ​

C++ 接口 BCAL_DRIVER_I2C::I2c 提供 master/slave 读写、从设备缓存和复位。Lua 类 LI2c 在内部调用工厂 get_driver("i2c", bus_id)，并在每次操作前按总线号切换实例。

参数说明 ​

C++ I2cConfig（init 参数）

C++ 方法

Lua 方法（src/luawrapper/l_i2c.cpp）

Lua 还注册了 I2C_READ_S、I2C_SLAVE_CACHE_RDWR_S、DEV_I2C_DEPLOY、DEV_I2C_MSG。其中 I2C_READ_S 的总线号字段在 Lua 侧注册名为 rv_id（绑定到 C++ 成员 drv_id）。

I2C_MAX_CHANEL 为 16，MAX_BYTE_READ_NUM 为 2048（include/bcal_extend/i2c_extend.h）。

返回值与异常 ​

应用场景 ​

访问板载 EEPROM、温度传感器、CPLD 等 I2C 器件；runtime_accessor 的 I2C 路径。

限制条件 ​

• C++ read/write 不再带 index 参数，总线号由工厂创建实例时的 index 决定。
• Lua I2C_READ_S 请使用字段名 rv_id，不是 drv_id。
• 读长度超过 2048 时，厂商实现会抛出 runtime_error。

调试示例 ​

C++ 调试 ​

#include "bcal/driver.h"
#include "bcal/i2c.h"

using namespace BCAL_DRIVER_I2C;
auto& factory = bcal::IDriverFactory::get_instance();
auto* raw = factory.get_driver("i2c", 0);
auto* i2c = static_cast<I2c*>(raw);
I2cConfig cfg{};
cfg.speed = 100;
cfg.mode = 0;
cfg.addr = 0;
cfg.use_smbus = 0;
i2c->init(&cfg, sizeof(cfg));
int32_t rc = i2c->write(addr_and_payload, 1000, 0);
factory.release_driver(raw);

Lua 调试 ​

local i2c = require 'libsoc_adapter.i2c'
assert(i2c:init(0, 100, 0, 0) == 0)
local req = i2c.I2C_READ_S()
req.rv_id = 0
req.length = 2
req.time_out_cnt = 1000
req.re_read_cnt = 3
local rc, data = i2c:read(req, string.char(0x50))
print(rc, data)
i2c:close()

2.6 GPIO ​

功能说明 ​

每个 Gpio 实例对应一根引脚。Lua 绑定用第一个参数作为 index 切换实例。

参数说明 ​

C++

Lua（LGpio）

返回值与异常 ​

C++ write 失败返回 -1。Lua 在 get_driver 失败或对象已 close 时抛出 runtime_error。

应用场景 ​

面板灯、在位检测、中断引脚、复位脚控制。

限制条件 ​

• 必须先 init 再读写。
• 驱动力等级因管脚而异，头文件要求参见说明文档；源码未在本组件内给出完整管脚等级表。

调试示例 ​

见 2.4 节 Lua 示例。

2.7 UART 与串口互连 ​

功能说明 ​

Uart 对应一个 UART 控制器；UartConnect 管理 UART 与 PORT 的互连。Lua LUart 把二者放在同一个 userdata 中：构造时加载全部 uart 实例和 uart_connect 实例。

参数说明 ​

C++ Uart

C++ UartConnect

control 命令包括 CMD_OPEN_PORT、CMD_UPDATE_BAUD、CMD_UPDATE_BAUD_V2 以及 v2 的 RX/TX 直连命令。参数结构见同一头文件。

Lua 常用方法

open、read、write、select_read、set_baud_rate、set_parity、set_data_bits、set_stop_bits、uart_connect_uart、query_uart_connection 等。v2 额外导出 get_baud_from_reg、uart_rx_from_uart_tx 等。部分方法是别名，例如 get_current_baud 与 get_host_baud_rate 绑定同一函数。

返回值与异常 ​

Lua 构造失败抛出 Failed to get driver 'uart' 或 Failed to get driver 'uart_connect'。open/read 等在 index 越界时抛出 uart id is invalid:%d。

应用场景 ​

SOL、面板串口、HOST 串口互连；bmc_soc 的串口管理会间接依赖本库或 soctrl。

限制条件 ​

• Lua 构造即打开全部端口，缺少任意 libuart.so 实例或 libuart_connect.so 都会失败。
• v1 / v2 的端口数量不同（8 / 16）。
• Lua select_read(index, len) 的超时在绑定层固定为 1000 ms，不能由调用方传入。

调试示例 ​

local uart = require 'libsoc_adapter.uart'
uart:open(0)
uart:set_baud_rate(0, 115200)
uart:write(0, 'AT\r')
local data = uart:select_read(0, 64)  -- 超时在绑定层固定为 1000 ms
uart:close()

open / set_baud_rate / write / select_read 的首参均为 UART index。Lua select_read 只接受 (index, len)，超时写死为 1000 ms，与 C++ Uart::select_read(len, timeout) 不同。

2.8 libsoc_adapter.sys_info ​

功能说明 ​

hal::SysInfo 封装 /dev/sys_info，不属于 BCAL 工厂驱动，而是 HAL 类。Lua 模块 libsoc_adapter.sys_info 导出该类方法。bmc_soc 获取 BMC 核温、复位原因、DDR 自检等数据时会调用本库。

设备节点：/dev/sys_info（SYS_INFO_DEVNAME）。

参数说明 ​

方法签名来自 vendor/huawei/v2/luawrappers/sys_info.h（v1 对应文件同类）。Lua 通过 luaopen_libsoc_adapter_sys_info 导出下列方法。

C++ 另有 get_soc_board_cfg，当前 v2 的 luaopen_libsoc_adapter_sys_info 未导出该方法。

返回值与异常 ​

打开 /dev/sys_info 失败时由 hal::Driver 基类处理（通常抛异常）。ioctl 语义以 sys_info.h 中的 SYS_INFO_* 命令为准。

应用场景 ​

BMC 核温监控、复位原因记录、DDR 自检展示、PCIe / VGA 相关状态。

限制条件 ​

• 依赖内核 sys_info 设备，QEMU 或非配套内核上可能不可用。
• 不同芯片 ioctl 编号可能不同，v1/v2 头文件需分别核对。

调试示例 ​

local sys = require 'libsoc_adapter.sys_info'
local t1, t2, t3 = sys:get_core_temp()
local reset = sys:get_reset_type()
local ddr = sys:get_ddr_self_test_result()
sys:close()

2.9 libsoc_adapter.hiss ​

功能说明 ​

hal::Hiss 封装 /dev/sec_module，提供安全核通信、BIOS 校验、TPCM、DICE 证书、KMC 主密钥编解码等接口。Lua 模块名固定为 libsoc_adapter.hiss（源码注释：避免业务感知 1711/1712 差异）。

参数说明 ​

下列签名来自 include/hiss.h，并已在 luaopen_libsoc_adapter_hiss 中注册。未列入的私有方法 send_recv_msg_with_hiss 不向 Lua 导出。

各命令字枚举见 include/hiss.h 中 SEC_FW_MSG_A55_SUB_CMD_TYPE_E 等。完整参数约束源码未在独立规格中逐项列出的，请对照头文件与安全核协议，不要臆测取值范围。

返回值与异常 ​

打开 /dev/sec_module 失败或 ioctl 失败时由实现抛出异常或返回错误码。具体 errno 映射源码未覆盖为统一错误表。

应用场景 ​

安全启动、BIOS 校验、Efuse 电源控制、TPCM 度量、证书与密钥管理。

限制条件 ​

• 仅在具备安全核 / sec_module 设备的芯片上可用。
• 涉及证书、密钥的接口不得在日志中打印明文。
• Lua 导出名称 export_nonce_chanllenge 等与头文件拼写保持一致（含 chanllenge）。

调试示例 ​

local hiss = require 'libsoc_adapter.hiss'
hiss:boot_ok_notify()
local mode = hiss:get_secure_boot_mode()
hiss:close()

2.10 libsoc_adapter.boot_loader ​

功能说明 ​

hal::BootLoader 访问 U-Boot 环境变量分区（头文件中设备为 /dev/mmcblk0p8），并提供 PCIe 控制器状态与 BAR 相关接口。Lua 导出三个方法。

参数说明 ​

环境变量区偏移、大小见 include/boot_loader.h（ENV_AREA_OFFSET、ENV_AREA_SIZE）。set_uboot_env / get_uboot_env 为私有方法，Lua 未导出。

返回值与异常 ​

设备打开或分区校验失败时由 hal::Driver / 实现抛错。set_pcie_bar_8M 返回 int8_t，取值含义源码未覆盖为公开枚举。

应用场景 ​

BMC 启动后同步 PCIe 控制器使能状态。

限制条件 ​

• 依赖指定 eMMC 分区布局，分区号写死在头文件中。
• 不适用于没有该分区的机型。

调试示例 ​

local bl = require 'libsoc_adapter.boot_loader'
local st = bl:get_pcie_controller_state(0)
bl:close()

3. 组件扩展案例 ​

3.1 扩展能力概述 ​

libsoc_adapter 不提供运行时插件 DSL，也不注册 MDB 接口。扩展方式是代码级二次开发：

• 上层组件增加 Conan 依赖后调用现有 C++ / Lua API。
• 新增 BCAL 驱动：定义接口、Extend 实现、create_driver/destroy_driver、Lua 绑定。
• 通过 Mock 目录为新驱动提供无硬件实现。

构建选项（mds/service.json）包括 chipv2_enable、enable_qemu、enable_luajit、chip、module_symvers。

3.2 扩展点说明 ​

仓库 docs/driver_adapter_guide.md 给出了逐步文件清单。

3.3 二次开发指导 ​

步骤一：定义 BCAL 接口 ​

在 include/bcal/xxx.h 中让 Xxx 继承 bcal::IDriver，并实现业务纯虚方法。配置结构通过 init(void* args, uint32_t size) 传入。

步骤二：实现驱动 .so ​

实现 create_driver(int32_t index) 与 destroy_driver(IDriver*)，CMake 将目标安装到 opt/bmc/bcal，生成 libxxx.so。

步骤三：注册 Lua API ​

LUA_EXPORT int32_t luaopen_libsoc_adapter_xxx(lua_State* L)
{
    luaL_checkversion(L);
    luawrap::lua_class<LXxx>(L)
        .ctor<>()
        .def("init", c_func_wrap(L, LXxx::init))
        .def("close", c_func_wrap(L, LXxx::release));
    return 1;
}

构造函数内应调用 IDriverFactory::get_instance().get_driver("xxx", index)。

示例代码 ​

local xxx = require 'libsoc_adapter.xxx'
xxx:init(...)
xxx:close()

验证方法 ​

1. 交叉编译后确认 /opt/bmc/bcal/libxxx.so 与 /usr/lib64/libsoc_adapter.so 已安装。
2. require 'libsoc_adapter.xxx' 成功。
3. 覆盖成功路径、非法 index、设备节点缺失。
4. 同步更新本文档第 2 章接口表。

注意事项 ​

• v1/v2 若行为不同，需同时维护两套实现，并用 chipv2_enable 切换。
• 每个新驱动应提供 Mock。
• 保持 luaopen 符号与 require 模块名的对应关系。
• control 只用于紧急扩展，正式能力应加到 BCAL 纯虚接口中。

4. 日志说明 ​

4.1 一键日志收集 ​

libsoc_adapter 是动态库，不创建独立日志文件，也没有仓库内声明的 on_dump 或一键日志项。工厂把加载失败写入内存中的 driver_load_info.error_msg；驱动实现普遍通过抛出 std::runtime_error（format(...)）把错误交给调用方。是否出现在系统一键日志中，取决于宿主组件的日志配置。

4.2 关键日志信息 ​

组件没有统一的日志级别宏。下列字符串来自工厂与 Lua 绑定中的异常 / error_msg，会出现在宿主日志或 Lua traceback 中。

驱动 ioctl 失败时，部分实现把 strerror(errno) 拼进 runtime_error，关键字形如 ioctl(...) failed。

5. 问题定界指南 ​

5.1 典型问题定界 ​

5.2 错误码速查表 ​

本组件没有 D-Bus 结构化错误对象。

5.3 调试方法 ​

开启调试日志 ​

没有独立日志开关。在宿主进程打开 DEBUG，并过滤 Failed to get driver、ioctl、libsoc_adapter 等关键字。

复现问题方法 ​

1. 确认 /usr/lib64/libsoc_adapter.so、/usr/lib64/libbcal.so、/opt/bmc/bcal/lib<drv>.so 存在。
2. 确认对应 /dev/* 与内核模块（Hisport 为 bmc_hisport_drv.ko）。
3. 用第 2 章最小 Lua 示例先验证工厂加载，再验证业务参数。
4. C++ 调用方打印 get_driver_list() 与 get_driver_load_info()。

没有 busctl 调试面。

5.4 错误对象解读 ​

Lua API 要么返回整数/tuple，要么抛出异常字符串。C++ BCAL 写接口普遍使用 0/-1，读接口返回数据或 tuple。将 -1、errno 和 Lua 异常视为不同层次，不要混成同一错误码。

6. 常见问题解答 ​

Q1：为什么 require 'libsoc_adapter.gpio' 找不到模块？ ​

• 问题描述：Lua 报告 module not found 或无法加载共享库。
• 一句话答案：检查 libsoc_adapter.so 是否在 Lua C 搜索路径中。
• 根因说明：模块入口是 luaopen_libsoc_adapter_gpio，由无前缀目标 libsoc_adapter 安装为 /usr/lib64/libsoc_adapter.so。
• 解决方案：确认文件存在，将 /usr/lib64/?.so 纳入 package.cpath。
• 规避方案：通过组件包和正式构建流程部署，不要只拷贝单个 .so。
• 适用版本：1.130.70。

Q2：为什么已经能 require，仍提示 Failed to get driver？ ​

• 问题描述：Lua 绑定构造成功前或构造中抛出获取驱动失败。
• 一句话答案：BCAL 工厂还要再加载 /opt/bmc/bcal/lib{name}.so。
• 根因说明：libsoc_adapter.so 只是绑定层；真正 ioctl 实现在 libgpio.so 等驱动库。
• 解决方案：安装对应驱动 .so，确认 create_driver/destroy_driver 已导出。
• 规避方案：测试环境使用 /usr/lib64/mock 中的 Mock 库，并用 set_driver_path 指向该目录（C++）或按产品测试框架替换。
• 适用版本：1.130.70。

Q3：IDriver 里有没有 config()？ ​

• 问题描述：对照仓库 docs/v1 规格调用 config(index, …) 无法编译。
• 一句话答案：当前公共接口只有 init(args, size)，没有 config()。
• 根因说明：BCAL 头文件已将配置并入 init；v1/v2 规格文档部分尚未同步。
• 解决方案：按 include/bcal/*.h 传配置结构体。
• 规避方案：新增代码不要再依赖 docs/v1 中带 index 的旧签名。
• 适用版本：以当前 include/bcal/driver.h 为准。

Q4：为什么 UART Lua 一加载就失败？ ​

• 问题描述：require 'libsoc_adapter.uart' 立即报错。
• 一句话答案：构造函数会加载全部 UART 端口和 uart_connect。
• 根因说明：LUart 在构造时循环 get_driver("uart", i) 并 get_driver("uart_connect", 0)，任一为空即抛异常。
• 解决方案：保证 libuart.so 能为每个 index 创建实例，且存在 libuart_connect.so。
• 规避方案：仅需单路 UART 的 C++ 代码应直接 get_driver("uart", n)，不要走 Lua 全量加载。
• 适用版本：1.130.70。

Q5：本组件能否用 mdbctl / busctl 调试？ ​

• 问题描述：在资源树上找不到 libsoc_adapter 对象。
• 一句话答案：不能。它不是微组件服务，不注册资源协作接口。
• 根因说明：mds/service.json 的 type 为 library，required 为空。
• 解决方案：使用 Lua 示例或 C++ 工厂 API；业务对象在 bmc_soc 等组件上。
• 规避方案：无。
• 适用版本：1.130.70。