Crate furiosa_smi_rs

This is rust bindings for Furiosa System Management Interface Library of FuriosaAI’s NPU devices. For additional information of furiosa-smi, please refer to its Documentation.

To learn more about FuriosaAI’s NPU, please visit https://furiosa.ai.

Requirements

This crate requires FuriosaAI’s NPU device and its kernel driver. You can refer to Driver and Firmware Installation to learn the kernel driver installation.

Also, You should install Furiosa System Management Interface Library. You can refer to Installation using package manager or Installation from Source Code.

Usage

Add this to your ‘Cargo.toml’:

[dependencies]
furiosa-smi-rs = "0.1"

Listing devices from the system

The current implementation mainly offers an API, namely list_devices.

list_devices enumerates all Furiosa NPU devices in the system. One can simply call as below:

let devices = furiosa_smi_rs::list_devices()?;

Struct Device offers methods for further information of each device.

Structs

• Device
  Abstraction for a single Furiosa NPU device.
• DeviceErrorInfo
  A struct for device error information
• DeviceFile
  A struct for device file
• DeviceInfo
  A struct for device information
• DeviceTemperature
  A struct for a temperature information of the device
• DeviceUtilization
  A struct for a utilization information of the device
• MemoryUtilization
  A struct for memory utilization
• PeUtilization
  A struct for PE utilization
• VersionInfo
  A struct for version information

Enums

• Arch
  Represents a architecture type of device
• CoreStatus
  Represents a core status
• LinkType
  Represents a device link type
• SmiError
  Represents a error status

Functions

• list_devices
  List all Furiosa NPU devices in the system.

Type Aliases

• SmiResult
  Represents a result of Furiosa SMI API function