| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 1 个月前 | ||
| 1 个月前 |
Interface List
- 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_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_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
interface_description
- This document describes the DCMIs (DaVinci Card Management Interfaces). You can use these APIs to perform operations such as device management, configuration management, and chip reset.
- DCMI is an NPU device management API. Once the driver is installed, it enables you to query NPU information and usage for status monitoring, and to perform operations including firmware upgrade, device information clearance, parameter configuration, and resource reset. You can call DCMI for secondary integration with third-party systems, based on business requirements.
- This document applies to the Atlas 900 A3 SuperPoD, Atlas 9000 A3 SuperPoD Cluster Computing System, Atlas 800I A3 SuperPoD, Atlas 800T A3 SuperPoD, and A200T A3 Box8 SuperPoD server.
- The Atlas 800I A3 SuperPoD and Atlas 800I A3 Standard Server use the same Ascend HDK. Therefore, this document uses the Atlas 800I A3 SuperPoD as an example.
API Deployment Scenario Description
- If a specific deployment scenario is not mentioned in the command or API description within this document, it indicates that the product does not support that scenario, and no such support is currently planned.
- In the Support in different deployment scenarios tables in this document, Y means "supported", N means "not supported", and NA means "not applicable", indicating that the scenario is not planned.
Table 1 Deployment Scenario Definitions and Descriptions
- DCMIs cannot be concurrently used by multiple threads.
- You are advised to compile DCMI-related executable files in a matching execution environment. Otherwise, glibc versions may be incompatible.
- DSMIs have been deprecated since version 1.0.10 and was no longer be provided since 2023. Use corresponding DCMIs instead.
- Unless otherwise specified, containers in this document refer to unprivileged containers.
- In-band reset: Resets Ascend AI Processors through the standard PCIe hot reset process. The involved API is dcmi_set_device_reset (channel_type is set to 1).
- Before calling the chip reset API, stop NPU-related services on the chip. NPU-related services can be queried using fuser. For details, see Querying NPU Service Processes.
- Wait for 3 seconds after calling dcmi_set_device_reset, and then call dcmi_set_device_rescan.