* Copyright (c) 2026 Huawei Technologies Co., Ltd.
* openUBMC is licensed under Mulan PSL v2.
* You can use this software according to the terms and conditions of the Mulan PSL v2.
* You may obtain a copy of Mulan PSL v2 at:
* http://license.coscl.org.cn/MulanPSL2
* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
* EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
* MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
* See the Mulan PSL v2 for more details.
*/
#ifndef MC_MANAGER_H
#define MC_MANAGER_H
#include <functional>
#include <map>
#include <mc/engine.h>
#include <mc/exception.h>
#include <mc/log.h>
#include <memory>
#include <mutex>
#include <optional>
#include <string>
#include <variant>
#include "internal/bus/bus_base/bus.h"
#ifndef __ZEPHYR__
#include "internal/bus/bus_hisport/hisport.h"
#endif
#include "internal/bus/bus_can/can.h"
#include "internal/bus/bus_i2c/i2c.h"
#include "internal/bus/bus_i2c_mux/i2c_mux.h"
#include "internal/bus/bus_uart/uart.h"
#ifndef __ZEPHYR__
#include "internal/chip/chip_ads78/ads78.h"
#endif
#include "internal/chip/chip_base/chip.h"
#include "internal/chip/chip_cpld/cpld.h"
#include "internal/chip/chip_cpld_chip/cpld_chip.h"
#include "internal/chip/chip_eeprom/eeprom.h"
#include "internal/chip/chip_ina/ina.h"
#include "internal/chip/chip_lm75/lm75.h"
#include "internal/chip/chip_pca9544/pca9544.h"
#include "internal/chip/chip_pca9545/pca9545.h"
#include "internal/chip/chip_pca9555/pca9555.h"
#ifndef __ZEPHYR__
#include "internal/chip/chip_smc/smc.h"
#endif
#ifndef __ZEPHYR__
#include "internal/bus/bus_adc/adc.h"
#include "internal/bus/bus_jtag/jtag.h"
#include "internal/bus/bus_jtag_base/jtag_base.h"
#include "internal/bus/bus_jtag_over_localbus/jtag_over_localbus.h"
#include "internal/bus/bus_localbus/localbus.h"
#include "internal/chip/chip_cpld_register/cpld_register.h"
#endif
#if COMPONENT_DRIVERS_ENABLE_CHIPV2
#include "internal/bus/bus_hisport2/hisport2.h"
#include "internal/bus/bus_i2c_over_hisport/i2c_over_hisport.h"
#include "internal/bus/bus_i2c_over_localbus/i2c_over_localbus.h"
#include "internal/bus/bus_i3c_over_localbus/i3c_over_localbus.h"
#include "internal/bus/bus_spi_over_hisport/spi_over_hisport.h"
#endif
#if COMPONENT_DRIVERS_ENABLE_UNIDEV
#include "internal/bus/bus_gpio/gpio.h"
#include "internal/bus/bus_innerbus/innerbus.h"
#include "internal/bus/bus_jtag_mux/jtag_mux.h"
#include "internal/bus/bus_jtag_over_gpio/jtag_over_gpio.h"
#if COMPONENT_DRIVERS_ENABLE_CHIPV2
#include "internal/bus/bus_jtag_over_hisport/jtag_over_hisport.h"
#endif
#include "internal/chip/chip_canbus_chip/canbus_chip.h"
#include "internal/chip/chip_jtag_switch/jtag_switch.h"
#include "internal/chip/chip_mcu_switch/mcu_switch.h"
#include "internal/chip/chip_rtc/rtc.h"
#include "internal/chip/chip_spi_flash/spi_flash.h"
#include "internal/chip/chip_vrd/vrd.h"
#endif
namespace dev {
* @brief 对象类型枚举
*/
enum class object_type {
chip,
bus
};
* @brief 设备管理器类(单例模式)
*
* 用于管理chip和bus对象的生命周期,提供创建、查询和删除功能
* 全局只有一个实例,确保所有组件访问的是同一个管理器
*/
class MC_API device_manager {
public:
* @brief 获取单例实例
* @return device_manager的单例实例引用
*/
static MC_API device_manager& get_instance();
* @brief 析构函数
*/
MC_API ~device_manager() = default;
device_manager(const device_manager&) = delete;
device_manager& operator=(const device_manager&) = delete;
device_manager(device_manager&&) = delete;
device_manager& operator=(device_manager&&) = delete;
* @brief 创建chip对象
* @param object_name 对象名称
* @param class_name 类名(如Pca9545、Chip等)
* @param csr_data 配置数据
* @return 创建的chip对象shared_ptr,失败返回nullptr
*/
MC_API std::shared_ptr<chip_base> create_chip(const std::string& object_name, const std::string& class_name,
mc::mutable_dict& csr_data);
* @brief 创建bus对象
* @param object_name 对象名称
* @param class_name 类名(如I2c、Hisport等)
* @param csr_data 配置数据
* @return 创建的bus对象shared_ptr,失败返回nullptr
*/
MC_API std::shared_ptr<bus_base> create_bus(const std::string& object_name, const std::string& class_name,
mc::mutable_dict& csr_data);
* @brief 根据名称和类型查询对象
* @param name 对象名称
* @param type 对象类型
* @return 找到的对象shared_ptr,没找到返回nullptr
*/
MC_API std::variant<std::shared_ptr<chip_base>, std::shared_ptr<bus_base>> find_object(const std::string& name,
object_type type);
* @brief 根据名称删除对象
* @param name 对象名称
* @param type 对象类型
* @return 删除成功返回true,失败返回false
*/
MC_API bool remove_object(const std::string& name, object_type type);
* @brief 获取chip对象表
* @return chip对象表的引用
*/
MC_API const std::map<std::string, std::shared_ptr<chip_base>>& get_chip_table() const
{
std::lock_guard<std::mutex> lock(m_mutex);
return m_chip_table;
}
* @brief 获取bus对象表
* @return bus对象表的引用
*/
MC_API const std::map<std::string, std::shared_ptr<bus_base>>& get_bus_table() const
{
std::lock_guard<std::mutex> lock(m_mutex);
return m_bus_table;
}
* @brief 按 class_name 查询对象类型(总线/器件)
* @param class_name 类名(即 device_type,对象名首个 "_" 之前的子串)
* @return 命中 bus 工厂返回 object_type::bus,命中 chip 工厂返回 object_type::chip,否则 nullopt
* @note 供 device_topo 按 device_type 分发子节点建类型使用
*/
MC_API std::optional<object_type> get_object_type(const std::string& class_name) const;
* @brief 清空所有对象表
*/
MC_API void clear_all();
private:
device_manager();
using chip_factory_func = std::function<std::shared_ptr<chip_base>(mc::mutable_dict&)>;
using bus_factory_func = std::function<std::shared_ptr<bus_base>(mc::mutable_dict&)>;
void init_factory_maps();
std::map<std::string, std::shared_ptr<chip_base>> m_chip_table;
std::map<std::string, std::shared_ptr<bus_base>> m_bus_table;
std::map<std::string, chip_factory_func> m_chip_factories;
std::map<std::string, bus_factory_func> m_bus_factories;
mutable std::mutex m_mutex;
};
}
#endif