接口列表
- dcmi_init
- dcmi_get_dcmi_version
- dcmi_get_driver_version
- dcmi_get_version
- dcmi_get_card_list
- dcmi_get_card_num_list
- dcmi_get_device_num_in_card
- dcmi_get_device_id_in_card
- dcmi_get_device_type
- dcmi_get_device_chip_info
- dcmi_get_device_pcie_info
- dcmi_get_device_pcie_info_v2
- dcmi_get_pcie_info
- dcmi_get_device_board_info
- dcmi_get_board_info
- dcmi_get_device_elabel_info
- dcmi_get_device_power_info
- dcmi_get_device_die_v2
- dcmi_get_device_die
- dcmi_get_device_ndie
- dcmi_get_device_health
- dcmi_get_driver_health
- dcmi_get_device_errorcode_v2
- dcmi_get_device_errorcode
- dcmi_get_driver_errorcode
- dcmi_get_device_errorcode_string
- dcmi_get_device_errorinfo
- dcmi_get_device_flash_count
- dcmi_get_device_flash_info_v2
- dcmi_get_device_flash_info
- dcmi_get_device_aicore_info
- dcmi_get_aicore_info
- dcmi_get_device_aicpu_info
- dcmi_get_aicpu_info
- dcmi_get_device_system_time
- dcmi_get_system_time
- dcmi_get_device_temperature
- dcmi_get_device_voltage
- dcmi_get_device_pcie_error_cnt
- dcmi_get_pcie_error_cnt
- dcmi_get_device_ecc_info
- dcmi_get_ecc_info
- dcmi_get_device_frequency
- dcmi_get_device_hbm_info
- dcmi_get_hbm_info
- dcmi_get_device_memory_info_v3
- dcmi_get_device_memory_info_v2
- dcmi_get_memory_info
- dcmi_get_device_utilization_rate
- dcmi_get_device_sensor_info
- dcmi_get_soc_sensor_info
- dcmi_set_container_service_enable
- dcmi_get_device_board_id
- dcmi_get_board_id
- dcmi_get_device_component_count
- dcmi_get_device_component_list
- dcmi_get_device_component_static_version
- dcmi_get_device_cgroup_info
- dcmi_get_device_llc_perf_para
- dcmi_set_device_info
- dcmi_get_device_info
- dcmi_set_device_sec_revocation
- dcmi_get_device_mac_count
- dcmi_get_device_network_health
- dcmi_get_device_logic_id
- dcmi_get_device_fan_count
- dcmi_get_device_fan_speed
- dcmi_get_card_elabel_v2
- dcmi_get_card_elabel
- dcmi_mcu_get_chip_temperature
- dcmi_get_device_ssh_enable
- dcmi_get_card_board_info
- dcmi_get_card_pcie_info
- dcmi_get_card_pcie_slot
- dcmi_get_fault_device_num_in_card
- dcmi_mcu_check_i2c
- dcmi_mcu_collect_log
- dcmi_get_device_chip_slot
- dcmi_get_product_type
- dcmi_get_device_outband_channel_state
- dcmi_mcu_get_board_info
- dcmi_mcu_get_power_info
- dcmi_get_computing_power_info
- dcmi_get_device_aicpu_count_info
- dcmi_get_first_power_on_date
- dcmi_get_fault_event
- dcmi_get_device_resource_info
- dcmi_get_device_dvpp_ratio_info
- dcmi_get_device_phyid_from_logicid
- dcmi_get_device_logicid_from_phyid
- dcmi_get_card_id_device_id_from_phyid
- dcmi_get_card_id_device_id_from_logicid
- dcmi_get_device_boot_status
- dcmi_sm_encrypt
- dcmi_sm_decrypt
- dcmi_set_power_state
- dcmi_get_npu_work_mode
- dcmi_subscribe_fault_event
- dcmi_get_device_compatibility
- dcmi_get_all_device_count
- dcmi_get_multi_ecc_time_info_v2
- dcmi_get_multi_ecc_record_info_v2
- dcmi_get_pcie_link_bandwidth_info
- dcmi_get_topo_info_by_device_id
- dcmi_get_affinity_cpu_info_by_device_id
- dcmi_get_netdev_pkt_stats_info
- dcmi_get_rdma_bandwidth_info
- dcmi_get_device_hbm_product_info
- dcmi_get_serdes_quality_info
- dcmi_get_mainboard_id
- dcmi_prbs_operate
- dcmi_get_ping_info
- dcmi_get_ping_info_v2
- dcmi_set_traceroute
- dcmi_get_pfc_duration_info
- dcmi_clear_pfc_duration
- dcmi_get_netdev_tc_stat_info
- dcmi_set_device_clear_tc_pkt_stats
- dcmi_get_qpn_list
- dcmi_get_qp_info
- dcmi_get_hccs_link_bandwidth_info
- dcmi_get_device_cpu_freq_info
- dcmi_get_device_chip_info_v2
- dcmi_get_extra_statistics_info
- dcmi_start_hccsping_mesh
- dcmi_get_hccsping_mesh_info
- dcmi_get_hccsping_mesh_info_v2
- dcmi_get_hccsping_mesh_state
- dcmi_stop_hccsping_mesh
- dcmi_get_hccs_avail_credit_info
- dcmi_get_device_share_enable
- dcmi_get_device_share_config_recover_mode
- dcmi_get_netdev_brother_device
- dcmi_get_custom_op_status
- dcmi_get_custom_op_config_recover_mode
- dcmi_get_spod_node_status
- dcmi_get_serdes_full_eye
- dcmi_set_device_clear_pcie_error
- dcmi_clear_pcie_error_cnt
- dcmi_get_device_p2p_enable
- dcmi_get_p2p_enable
- dcmi_set_device_clear_ecc_statistics_info
- dcmi_set_device_mac
- dcmi_get_device_mac
- dcmi_get_device_gateway
- dcmi_set_device_gateway
- dcmi_get_device_ip
- dcmi_set_device_ip
- dcmi_set_device_ecc_enable
- dcmi_config_ecc_enable
- dcmi_get_nve_level
- dcmi_set_nve_level
- dcmi_set_device_share_enable
- dcmi_set_device_share_config_recover_mode
- dcmi_set_device_user_config
- dcmi_set_user_config
- dcmi_get_user_config
- dcmi_clear_device_user_config
- dcmi_get_device_cpu_num_config
- dcmi_set_device_cpu_num_config
- dcmi_create_capability_group
- dcmi_delete_capability_group
- dcmi_get_capability_group_info
- dcmi_get_capability_group_aicore_usage
- dcmi_set_custom_op_config_recover_mode
- dcmi_set_spod_node_status
- dcmi_get_mcu_version
- dcmi_mcu_get_version
- dcmi_set_mcu_upgrade_stage
- dcmi_mcu_upgrade_control
- dcmi_set_mcu_upgrade_file
- dcmi_mcu_upgrade_transfile
- dcmi_get_mcu_upgrade_status
- dcmi_mcu_get_upgrade_status
- dcmi_mcu_get_upgrade_statues
- dcmi_set_device_pre_reset
- dcmi_pre_reset_soc
- dcmi_set_device_reset
- dcmi_reset_device
- dcmi_set_device_rescan
- dcmi_rescan_soc
- dcmi_reset_device_inband
- dcmi_set_card_customized_info
- dcmi_set_customized_info_api
- dcmi_mcu_set_license_info
- dcmi_get_card_customized_info
- dcmi_get_customized_info_api
- dcmi_mcu_get_license_info
- return_codes
- faq
接口说明
- 本文档详细的描述了DCMI（DaVinci Card Management Interface）接口，用户可使用这些接口进行设备管理、配置管理、芯片复位启动等操作。
- DCMI（DaVinci Card Management Interface）是NPU的设备管理API接口，在驱动安装完成后，可以使用该接口查询NPU设备的信息和使用情况，便于用户了解当前NPU的状态，并提供接口用于对NPU进行固件升级、清除设备信息、配置参数和资源复位等操作。用户可以根据业务需要，调用DCMI接口完成第三方系统二次集成开发。
- 适用于Atlas 900 A3 SuperPoD 超节点、Atlas 9000 A3 SuperPoD 集群算力系统、Atlas 800I A3 超节点、Atlas 800T A3 超节点、A200T A3 Box8 超节点服务器。
- 由于Atlas 800I A3 超节点与Atlas 800I A3 标准服务器使用的Ascend HDK软件相同，因此本文以Atlas 800I A3 超节点统称，不作区分。
- 如果部分部署场景在本文档的相关命令或接口描述中未提及，则表明该产品不涉及此场景，当前未规划。
- 本文档中“不同部署场景下的支持情况”表中的Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。
表 1 部署场景分类定义及说明
- 不支持多线程并发使用DCMI接口。
- 建议用户在对应的执行环境上编译DCMI相关的可执行文件，否则可能会出现glibc版本前后不兼容的情况。
- DSMI接口从1.0.10版本开始废弃，计划于2023年版本不再提供，请使用对应的DCMI接口进行替代。
- 本文涉及的容器场景除特殊说明外，均指普通容器。
- 带内复位：通过PCIe标准热复位流程复位昇腾AI处理器。使用接口： dcmi_set_device_reset（channel_type设置为1）
- 调用芯片复位接口前，请停掉该芯片的NPU相关业务，NPU相关业务可通过fuser软件查询，具体参考查询NPU业务进程。
- 调用dcmi_set_device_reset接口之后需等待3秒，才可调用dcmi_set_device_rescan接口。