# mbltml.mbltml

## Attributes

| Name | Description |
| --- | --- |
| [`MBLTML_DRIVER_VERSION_BUFFER_SIZE`](<#mbltml-driver-version-buffer-size>) | Buffer size (bytes) guaranteed sufficient for [mbltmlGetDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdriverversion>). |
| [`MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE`](<#mbltml-on-device-driver-version-buffer-size>) | Buffer size (bytes) guaranteed sufficient for [mbltmlGetOnDeviceDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetondevicedriverversion>). |
| [`MBLTML_FIRMWARE_VERSION_BUFFER_SIZE`](<#mbltml-firmware-version-buffer-size>) | Buffer size (bytes) guaranteed sufficient for [mbltmlGetFirmwareVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetfirmwareversion>). |
| [`MBLTML_NODE_NAME_BUFFER_SIZE`](<#mbltml-node-name-buffer-size>) | Buffer size (bytes) guaranteed sufficient for [mbltmlGetNodeName()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetnodename>). |
| [`MBLTML_PCIE_SLOT_BUFFER_SIZE`](<#mbltml-pcie-slot-buffer-size>) | Buffer size (bytes) guaranteed sufficient for [mbltmlGetPcieSlot()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetpcieslot>). |
| [`mbltmlDriverType_t`](<#mbltmldrivertype-t>) | Identifier of a Mobilint NPU driver. Used to select a driver when calling family-scoped APIs such as [mbltmlGetDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdriverversion>), and to describe the family of an individual device returned by [mbltmlGetDriverType()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdrivertype>). |
| [`MBLTML_DRIVER_ERROR`](<#mbltml-driver-error>) | Invalid or uninitialized value. |
| [`MBLTML_DRIVER_ARIES`](<#mbltml-driver-aries>) | ARIES Driver. |
| [`MBLTML_DRIVER_REGULUS`](<#mbltml-driver-regulus>) | REGULUS (SoC) Driver. |
| [`MBLTML_DRIVER_REGULUS_USB`](<#mbltml-driver-regulus-usb>) | REGULUS (USB) Driver. |
| [`mbltmlTargetDeviceType_t`](<#mbltmltargetdevicetype-t>) | Specific target device type of a Mobilint NPU. |
| [`MBLTML_TARGET_DEVICE_ARIES_RA`](<#mbltml-target-device-aries-ra>) | aries-ra. |
| [`MBLTML_TARGET_DEVICE_REGULUS_RA`](<#mbltml-target-device-regulus-ra>) | regulus-ra. |
| [`MBLTML_TARGET_DEVICE_ARIES_RB`](<#mbltml-target-device-aries-rb>) | aries-rb. |
| [`MBLTML_TARGET_DEVICE_REGULUS_RB`](<#mbltml-target-device-regulus-rb>) | regulus-rb. |
| [`MBLTML_TARGET_DEVICE_REGULUS_RA_USB`](<#mbltml-target-device-regulus-ra-usb>) | regulus-ra-usb. |
| [`MBLTML_TARGET_DEVICE_REGULUS_RB_USB`](<#mbltml-target-device-regulus-rb-usb>) | regulus-rb-usb. |
| [`MBLTML_TARGET_DEVICE_ERROR`](<#mbltml-target-device-error>) | Invalid or uninitialized. |
| [`mbltmlStatusCode_t`](<#mbltmlstatuscode-t>) | Status code returned by mbltml C APIs. In this Python binding, non-success codes are translated into [MBLTMLError](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) subclasses raised by the wrapper functions. |
| [`MBLTML_SUCCESS`](<#mbltml-success>) | Operation completed successfully. |
| [`MBLTML_DRIVER_NOT_FOUND`](<#mbltml-driver-not-found>) | Required driver could not be located. |
| [`MBLTML_INVALID_ARGUMENT`](<#mbltml-invalid-argument>) | Invalid argument (NULL or out-of-range index). |
| [`MBLTML_UNINITIALIZED`](<#mbltml-uninitialized>) | API used before initialization. |
| [`MBLTML_NOT_SUPPORTED`](<#mbltml-not-supported>) | Feature not supported on the target device. |
| [`MBLTML_INSUFFICIENT_LENGTH`](<#mbltml-insufficient-length>) | Output buffer is too small. |
| [`MBLTML_DEVICE_NOT_FOUND`](<#mbltml-device-not-found>) | Requested device could not be located. |
| [`mbltmlExtraPmicId_t`](<#mbltmlextrapmicid-t>) | Identifier of an extra PMIC rail. Selects which auxiliary PMIC rail is reported by mbltmlGetExtraPmic\*(). The active selection is changed with [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>) and can be queried via [mbltmlGetExtraPmicId()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmicid>). |
| [`MBLTML_EXTRA_PMIC_ID_NPU`](<#mbltml-extra-pmic-id-npu>) | NPU rail. |
| [`MBLTML_EXTRA_PMIC_ID_DDR`](<#mbltml-extra-pmic-id-ddr>) | DDR rail. |
| [`MBLTML_EXTRA_PMIC_ID_PMIC`](<#mbltml-extra-pmic-id-pmic>) | PMIC rail. |
| [`MBLTML_EXTRA_PMIC_ID_GOLDFINGER`](<#mbltml-extra-pmic-id-goldfinger>) | Goldfinger rail. |
| [`mbltmlCluster_t`](<#mbltmlcluster-t>) | NPU cluster identifier within a device. |
| [`MBLTML_CLUSTER_0`](<#mbltml-cluster-0>) | Cluster 0. |
| [`MBLTML_CLUSTER_1`](<#mbltml-cluster-1>) | Cluster 1. |
| [`MBLTML_CLUSTER_ERROR`](<#mbltml-cluster-error>) | Represents an invalid or uninitialized state. |
| [`mbltmlCore_t`](<#mbltmlcore-t>) | NPU core identifier within a cluster. |
| [`MBLTML_CORE_0`](<#mbltml-core-0>) | Local core 0. |
| [`MBLTML_CORE_1`](<#mbltml-core-1>) | Local core 1. |
| [`MBLTML_CORE_2`](<#mbltml-core-2>) | Local core 2. |
| [`MBLTML_CORE_3`](<#mbltml-core-3>) | Local core 3. |
| [`MBLTML_CORE_GLOBAL`](<#mbltml-core-global>) | Global (all cores aggregated). |
| [`MBLTML_CORE_ERROR`](<#mbltml-core-error>) | Represents an invalid or uninitialized state. |

### MBLTML\_DRIVER\_VERSION\_BUFFER\_SIZE

```python
MBLTML_DRIVER_VERSION_BUFFER_SIZE = 80
```

Buffer size (bytes) guaranteed sufficient for [mbltmlGetDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdriverversion>).

### MBLTML\_ON\_DEVICE\_DRIVER\_VERSION\_BUFFER\_SIZE

```python
MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE = 80
```

Buffer size (bytes) guaranteed sufficient for [mbltmlGetOnDeviceDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetondevicedriverversion>).

### MBLTML\_FIRMWARE\_VERSION\_BUFFER\_SIZE

```python
MBLTML_FIRMWARE_VERSION_BUFFER_SIZE = 80
```

Buffer size (bytes) guaranteed sufficient for [mbltmlGetFirmwareVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetfirmwareversion>).

### MBLTML\_NODE\_NAME\_BUFFER\_SIZE

```python
MBLTML_NODE_NAME_BUFFER_SIZE = 80
```

Buffer size (bytes) guaranteed sufficient for [mbltmlGetNodeName()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetnodename>).

### MBLTML\_PCIE\_SLOT\_BUFFER\_SIZE

```python
MBLTML_PCIE_SLOT_BUFFER_SIZE = 80
```

Buffer size (bytes) guaranteed sufficient for [mbltmlGetPcieSlot()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetpcieslot>).

### mbltmlDriverType\_t

```python
mbltmlDriverType_t = c_uint
```

Identifier of a Mobilint NPU driver. Used to select a driver when calling family-scoped APIs such as [mbltmlGetDriverVersion()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdriverversion>), and to describe the family of an individual device returned by [mbltmlGetDriverType()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetdrivertype>).

### MBLTML\_DRIVER\_ERROR

```python
MBLTML_DRIVER_ERROR = 0x0
```

Invalid or uninitialized value.

### MBLTML\_DRIVER\_ARIES

```python
MBLTML_DRIVER_ARIES = 0x1
```

ARIES Driver.

### MBLTML\_DRIVER\_REGULUS

```python
MBLTML_DRIVER_REGULUS = 0x2
```

REGULUS (SoC) Driver.

### MBLTML\_DRIVER\_REGULUS\_USB

```python
MBLTML_DRIVER_REGULUS_USB = 0x4
```

REGULUS (USB) Driver.

### mbltmlTargetDeviceType\_t

```python
mbltmlTargetDeviceType_t = c_uint
```

Specific target device type of a Mobilint NPU.

### MBLTML\_TARGET\_DEVICE\_ARIES\_RA

```python
MBLTML_TARGET_DEVICE_ARIES_RA = 0x00000001
```

aries-ra.

### MBLTML\_TARGET\_DEVICE\_REGULUS\_RA

```python
MBLTML_TARGET_DEVICE_REGULUS_RA = 0x00000002
```

regulus-ra.

### MBLTML\_TARGET\_DEVICE\_ARIES\_RB

```python
MBLTML_TARGET_DEVICE_ARIES_RB = 0x00000003
```

aries-rb.

### MBLTML\_TARGET\_DEVICE\_REGULUS\_RB

```python
MBLTML_TARGET_DEVICE_REGULUS_RB = 0x00000004
```

regulus-rb.

### MBLTML\_TARGET\_DEVICE\_REGULUS\_RA\_USB

```python
MBLTML_TARGET_DEVICE_REGULUS_RA_USB = 0x00000005
```

regulus-ra-usb.

### MBLTML\_TARGET\_DEVICE\_REGULUS\_RB\_USB

```python
MBLTML_TARGET_DEVICE_REGULUS_RB_USB = 0x00000006
```

regulus-rb-usb.

### MBLTML\_TARGET\_DEVICE\_ERROR

```python
MBLTML_TARGET_DEVICE_ERROR = 0x7FFFFFFF
```

Invalid or uninitialized.

### mbltmlStatusCode\_t

```python
mbltmlStatusCode_t = c_uint
```

Status code returned by mbltml C APIs. In this Python binding, non-success codes are translated into [MBLTMLError](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) subclasses raised by the wrapper functions.

### MBLTML\_SUCCESS

```python
MBLTML_SUCCESS = 0
```

Operation completed successfully.

### MBLTML\_DRIVER\_NOT\_FOUND

```python
MBLTML_DRIVER_NOT_FOUND = 2
```

Required driver could not be located.

### MBLTML\_INVALID\_ARGUMENT

```python
MBLTML_INVALID_ARGUMENT = 3
```

Invalid argument (NULL or out-of-range index).

### MBLTML\_UNINITIALIZED

```python
MBLTML_UNINITIALIZED = 1
```

API used before initialization.

### MBLTML\_NOT\_SUPPORTED

```python
MBLTML_NOT_SUPPORTED = 4
```

Feature not supported on the target device.

### MBLTML\_INSUFFICIENT\_LENGTH

```python
MBLTML_INSUFFICIENT_LENGTH = 5
```

Output buffer is too small.

### MBLTML\_DEVICE\_NOT\_FOUND

```python
MBLTML_DEVICE_NOT_FOUND = 6
```

Requested device could not be located.

### mbltmlExtraPmicId\_t

```python
mbltmlExtraPmicId_t = c_uint
```

Identifier of an extra PMIC rail. Selects which auxiliary PMIC rail is reported by mbltmlGetExtraPmic\*(). The active selection is changed with [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>) and can be queried via [mbltmlGetExtraPmicId()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmicid>).

### MBLTML\_EXTRA\_PMIC\_ID\_NPU

```python
MBLTML_EXTRA_PMIC_ID_NPU = 0
```

NPU rail.

### MBLTML\_EXTRA\_PMIC\_ID\_DDR

```python
MBLTML_EXTRA_PMIC_ID_DDR = 1
```

DDR rail.

### MBLTML\_EXTRA\_PMIC\_ID\_PMIC

```python
MBLTML_EXTRA_PMIC_ID_PMIC = 2
```

PMIC rail.

### MBLTML\_EXTRA\_PMIC\_ID\_GOLDFINGER

```python
MBLTML_EXTRA_PMIC_ID_GOLDFINGER = 3
```

Goldfinger rail.

### mbltmlCluster\_t

```python
mbltmlCluster_t = c_uint
```

NPU cluster identifier within a device.

### MBLTML\_CLUSTER\_0

```python
MBLTML_CLUSTER_0 = 0x00010000
```

Cluster 0.

### MBLTML\_CLUSTER\_1

```python
MBLTML_CLUSTER_1 = 0x00020000
```

Cluster 1.

### MBLTML\_CLUSTER\_ERROR

```python
MBLTML_CLUSTER_ERROR = 0x7FFF0000
```

Represents an invalid or uninitialized state.

### mbltmlCore\_t

```python
mbltmlCore_t = c_uint
```

NPU core identifier within a cluster.

### MBLTML\_CORE\_0

```python
MBLTML_CORE_0 = 1
```

Local core 0.

### MBLTML\_CORE\_1

```python
MBLTML_CORE_1 = 2
```

Local core 1.

### MBLTML\_CORE\_2

```python
MBLTML_CORE_2 = 3
```

Local core 2.

### MBLTML\_CORE\_3

```python
MBLTML_CORE_3 = 4
```

Local core 3.

### MBLTML\_CORE\_GLOBAL

```python
MBLTML_CORE_GLOBAL = 0x0000FFFE
```

Global (all cores aggregated).

### MBLTML\_CORE\_ERROR

```python
MBLTML_CORE_ERROR = 0x0000FFFF
```

Represents an invalid or uninitialized state.

## mbltmlCoreId\_t

```python
class mbltmlCoreId_t(Structure)
```

Composite identifier of an NPU core (cluster + core).

**Parameters**

- `cluster` — Cluster to which the core belongs (mbltmlCluster\_t).
- `core` — Core within the cluster (mbltmlCore\_t).

### Attributes

| Name | Description |
| --- | --- |
| [`cluster`](<#mbltmlcoreid-t-cluster>) |  |
| [`core`](<#mbltmlcoreid-t-core>) |  |

#### cluster

```python
cluster: mbltmlCluster_t
```

#### core

```python
core: mbltmlCore_t
```

### Methods

| Name | Description |
| --- | --- |
| [`__repr__`](<#mbltmlcoreid-t-repr>) |  |

#### \_\_repr\_\_

```python
def __repr__(self)
```

## mbltmlCoreInfo\_t

```python
class mbltmlCoreInfo_t(Structure)
```

Per-core usage record returned by [mbltmlGetCoreInfos()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetcoreinfos>).

Utilization for the core can be computed as `npu_time` / `interval` when `interval` is non-zero.

**Parameters**

- `core_id` — Identifier of the core ([mbltmlCoreId\_t](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlcoreid-t>)).
- `npu_time` — Accumulated NPU active time on the core, in microseconds.
- `interval` — Sampling interval covered by `npu_time`, in microseconds.

### Attributes

| Name | Description |
| --- | --- |
| [`core_id`](<#mbltmlcoreinfo-t-core-id>) |  |
| [`npu_time`](<#mbltmlcoreinfo-t-npu-time>) |  |
| [`interval`](<#mbltmlcoreinfo-t-interval>) |  |

#### core\_id

```python
core_id: mbltmlCoreId_t
```

#### npu\_time

```python
npu_time: c_int64
```

#### interval

```python
interval: c_int64
```

### Methods

| Name | Description |
| --- | --- |
| [`__repr__`](<#mbltmlcoreinfo-t-repr>) |  |

#### \_\_repr\_\_

```python
def __repr__(self)
```

## mbltmlProcessInfo\_t

```python
class mbltmlProcessInfo_t(Structure)
```

Per-process usage record returned by [mbltmlGetProcessInfos()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetprocessinfos>).

Utilization for the process can be computed as `total_npu_time_us` / `total_interval_us` when `total_interval_us` is non-zero.

**Parameters**

- `pid` — Process ID.
- `counts` — Number of NPU samples attributed to the process.
- `npu_memory_usage` — Device memory currently used by the process, in bytes.
- `total_interval_us` — Total sampling interval, in microseconds.
- `total_npu_time_us` — Total NPU active time used by the process, in microseconds.

### Attributes

| Name | Description |
| --- | --- |
| [`pid`](<#mbltmlprocessinfo-t-pid>) |  |
| [`counts`](<#mbltmlprocessinfo-t-counts>) |  |
| [`npu_memory_usage`](<#mbltmlprocessinfo-t-npu-memory-usage>) |  |
| [`total_interval_us`](<#mbltmlprocessinfo-t-total-interval-us>) |  |
| [`total_npu_time_us`](<#mbltmlprocessinfo-t-total-npu-time-us>) |  |

#### pid

```python
pid: c_int
```

#### counts

```python
counts: c_int
```

#### npu\_memory\_usage

```python
npu_memory_usage: c_int64
```

#### total\_interval\_us

```python
total_interval_us: c_int64
```

#### total\_npu\_time\_us

```python
total_npu_time_us: c_int64
```

### Methods

| Name | Description |
| --- | --- |
| [`__repr__`](<#mbltmlprocessinfo-t-repr>) |  |

#### \_\_repr\_\_

```python
def __repr__(self)
```

## MBLTMLError

```python
class MBLTMLError(Exception)
```

Base exception raised by the mbltml Python binding.

Wraps a non-success mbltmlStatusCode\_t returned by the underlying C library. Instantiating [MBLTMLError](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) with a known status code yields the matching subclass (e.g., [MBLTMLInvalidArgumentError](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>)).

**Parameters**

- `code` — The mbltmlStatusCode\_t value associated with this exception.

### Methods

| Name | Description |
| --- | --- |
| [`__new__`](<#mbltmlerror-new>) |  |
| [`__str__`](<#mbltmlerror-str>) |  |
| [`__eq__`](<#mbltmlerror-eq>) |  |

#### \_\_new\_\_

```python
def __new__(cls, code: mbltmlStatusCode_t)
```

#### \_\_str\_\_

```python
def __str__(self)
```

#### \_\_eq\_\_

```python
def __eq__(self, other)
```

## MBLTMLDriverNotFoundError

```python
class MBLTMLDriverNotFoundError(MBLTMLError)
```

Raised when the required driver cannot be located.

Wraps MBLTML\_DRIVER\_NOT\_FOUND.

## MBLTMLInvalidArgumentError

```python
class MBLTMLInvalidArgumentError(MBLTMLError)
```

Raised when one or more arguments are invalid.

Wraps MBLTML\_INVALID\_ARGUMENT. Typical causes include a NULL pointer or a `dev_no` that is out of range of the target device type's device count.

## MBLTMLUninitializedError

```python
class MBLTMLUninitializedError(MBLTMLError)
```

Raised when an API is called before initialization.

Wraps MBLTML\_UNINITIALIZED. Call [mbltmlInit()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinit>) first.

## MBLTMLNotSupportedError

```python
class MBLTMLNotSupportedError(MBLTMLError)
```

Raised when the feature is not supported on the target device.

Wraps MBLTML\_NOT\_SUPPORTED.

## MBLTMLInsufficientLengthError

```python
class MBLTMLInsufficientLengthError(MBLTMLError)
```

Raised when the output buffer is too small to hold the result.

Wraps MBLTML\_INSUFFICIENT\_LENGTH.

## MBLTMLDeviceNotFoundError

```python
class MBLTMLDeviceNotFoundError(MBLTMLError)
```

Raised when the requested device cannot be located.

Wraps MBLTML\_DEVICE\_NOT\_FOUND.

## Functions

| Name | Description |
| --- | --- |
| [`mbltmlInit`](<#mbltmlinit>) | Initialize the mbltml library. |
| [`mbltmlShutdown`](<#mbltmlshutdown>) | Release all resources held by the mbltml library. |
| [`mbltmlGetDeviceCount`](<#mbltmlgetdevicecount>) | Get the total number of devices detected by the library. |
| [`mbltmlGetTargetDeviceCount`](<#mbltmlgettargetdevicecount>) | Get the number of detected devices of a specific target device type. |
| [`mbltmlGetDriverVersion`](<#mbltmlgetdriverversion>) | Get the driver version string for a specific driver. |
| [`mbltmlGetDriverRevision`](<#mbltmlgetdriverrevision>) | Get the driver revision number for a specific driver. |
| [`mbltmlGetNodeName`](<#mbltmlgetnodename>) | Get the node name of a device. |
| [`mbltmlGetDriverType`](<#mbltmlgetdrivertype>) | Get the driver type of a device. |
| [`mbltmlGetOnDeviceDriverVersion`](<#mbltmlgetondevicedriverversion>) | Get the on-device driver version string of a device. |
| [`mbltmlGetOnDeviceDriverRevision`](<#mbltmlgetondevicedriverrevision>) | Get the on-device driver revision number of a device. |
| [`mbltmlGetFirmwareVersion`](<#mbltmlgetfirmwareversion>) | Get the firmware version string of a device. |
| [`mbltmlGetFirmwareRevision`](<#mbltmlgetfirmwarerevision>) | Get the firmware revision number of a device. |
| [`mbltmlGetFirmwareCRC`](<#mbltmlgetfirmwarecrc>) | Get the CRC of the currently-loaded firmware image. |
| [`mbltmlGetTemperature`](<#mbltmlgettemperature>) | Get the current die temperature of a device. |
| [`mbltmlGetPcieSwitchTemperature`](<#mbltmlgetpcieswitchtemperature>) | Get the current temperature of the PCIe switch of a device. |
| [`mbltmlGetChipId`](<#mbltmlgetchipid>) | Get the chip ID of a device. |
| [`mbltmlGetSignalType`](<#mbltmlgetsignaltype>) | Get the current signal-type indicator reported by the device. |
| [`mbltmlGetNPUClock`](<#mbltmlgetnpuclock>) | Get the current NPU clock frequency of a device. |
| [`mbltmlGetBusClock`](<#mbltmlgetbusclock>) | Get the current bus clock frequency of a device. |
| [`mbltmlGetFanDuty`](<#mbltmlgetfanduty>) | Get the current cooling-fan duty cycle of a device. |
| [`mbltmlGetVendorId`](<#mbltmlgetvendorid>) | Get the PCIe vendor ID of a device. |
| [`mbltmlGetDeviceId`](<#mbltmlgetdeviceid>) | Get the PCIe device ID of a device. |
| [`mbltmlGetSubVendorId`](<#mbltmlgetsubvendorid>) | Get the PCIe subsystem vendor ID of a device. |
| [`mbltmlGetSubDeviceId`](<#mbltmlgetsubdeviceid>) | Get the PCIe subsystem device ID of a device. |
| [`mbltmlGetPcieGen`](<#mbltmlgetpciegen>) | Get the negotiated PCIe link generation of a device. |
| [`mbltmlGetPcieLanes`](<#mbltmlgetpcielanes>) | Get the negotiated PCIe link width (in lanes) of a device. |
| [`mbltmlGetPcieRev`](<#mbltmlgetpcierev>) | Get the PCIe configuration-space revision ID of a device. |
| [`mbltmlGetPcieClassCode`](<#mbltmlgetpcieclasscode>) | Get the PCIe configuration-space class code of a device. |
| [`mbltmlGetPcieSlot`](<#mbltmlgetpcieslot>) | Get the PCIe slot location of a device. |
| [`mbltmlGetTotalPower`](<#mbltmlgettotalpower>) | Get the total instantaneous power consumption of a device (W). |
| [`mbltmlGetTotalCurrent`](<#mbltmlgettotalcurrent>) | Get the total instantaneous current draw of a device (A). |
| [`mbltmlGetTotalVoltage`](<#mbltmlgettotalvoltage>) | Get the total instantaneous supply voltage of a device (V). |
| [`mbltmlGetExtraPmicPower`](<#mbltmlgetextrapmicpower>) | Get the power consumption of the extra PMIC rail currently selected for the device (W). |
| [`mbltmlGetExtraPmicCurrent`](<#mbltmlgetextrapmiccurrent>) | Get the current of the extra PMIC rail currently selected for the device (A). |
| [`mbltmlGetExtraPmicVoltage`](<#mbltmlgetextrapmicvoltage>) | Get the voltage of the extra PMIC rail currently selected for the device (V). |
| [`mbltmlGetExtraPmicId`](<#mbltmlgetextrapmicid>) | Get the extra PMIC rail currently selected for the device. |
| [`mbltmlGetTotalUtilization`](<#mbltmlgettotalutilization>) | Get the overall NPU utilization of a device. |
| [`mbltmlGetMemoryUsage`](<#mbltmlgetmemoryusage>) | Get the amount of device memory currently in use. |
| [`mbltmlGetMemoryTotal`](<#mbltmlgetmemorytotal>) | Get the total amount of device memory available. |
| [`mbltmlGetProcessInfos`](<#mbltmlgetprocessinfos>) | Get per-process usage information for a device. |
| [`mbltmlGetCoreInfos`](<#mbltmlgetcoreinfos>) | Get per-core usage information for a device. |
| [`mbltmlSetExtraPmicID`](<#mbltmlsetextrapmicid>) | Select which extra PMIC rail subsequent mbltmlGetExtraPmic\*() queries refer to. |

### mbltmlInit

```python
def mbltmlInit() -> None
```

Initialize the mbltml library.

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlShutdown

```python
def mbltmlShutdown() -> None
```

Release all resources held by the mbltml library.

After this call, any further API usage requires re-initialization via [mbltmlInit()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinit>).

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlGetDeviceCount

```python
def mbltmlGetDeviceCount() -> int
```

Get the total number of devices detected by the library.

> [!NOTE]
>
> Supported on all driver types.

This returns the number of all detected devices regardless of their target device type, including devices whose target device type could not be identified.

> [!CAUTION]
>
> **Attention**
>
> Do not confuse this with [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>). Since unidentified devices are not addressable by any (target\_device\_type, dev\_no) pair, this count may exceed the sum over every mbltmlTargetDeviceType\_t.

**Returns**

The number of devices detected.

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlGetTargetDeviceCount

```python
def mbltmlGetTargetDeviceCount(target_device_type: mbltmlTargetDeviceType_t) -> int
```

Get the number of detected devices of a specific target device type.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type whose device count is queried.

**Returns**

The number of devices of `target_device_type` detected, or 0 if none is detected.

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlGetDriverVersion

```python
def mbltmlGetDriverVersion(driver_type: mbltmlDriverType_t) -> str
```

Get the driver version string for a specific driver.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `driver_type` — Driver type whose driver version is queried.

**Returns**

The driver version string.

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlGetDriverRevision

```python
def mbltmlGetDriverRevision(driver_type: mbltmlDriverType_t) -> int
```

Get the driver revision number for a specific driver.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `driver_type` — Driver type whose driver revision is queried.

**Returns**

The driver revision number.

**Throws**

- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on failure.

### mbltmlGetNodeName

```python
def mbltmlGetNodeName(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> str
```

Get the node name of a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The node name string.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetDriverType

```python
def mbltmlGetDriverType(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> mbltmlDriverType_t
```

Get the driver type of a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The mbltmlDriverType\_t of the device.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetOnDeviceDriverVersion

```python
def mbltmlGetOnDeviceDriverVersion(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> str
```

Get the on-device driver version string of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_REGULUS\_USB only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The on-device driver version string.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetOnDeviceDriverRevision

```python
def mbltmlGetOnDeviceDriverRevision(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the on-device driver revision number of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_REGULUS\_USB only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The on-device driver revision.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetFirmwareVersion

```python
def mbltmlGetFirmwareVersion(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> str
```

Get the firmware version string of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The firmware version string.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetFirmwareRevision

```python
def mbltmlGetFirmwareRevision(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the firmware revision number of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The firmware revision.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetFirmwareCRC

```python
def mbltmlGetFirmwareCRC(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the CRC of the currently-loaded firmware image.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The firmware CRC.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetTemperature

```python
def mbltmlGetTemperature(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the current die temperature of a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The temperature reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieSwitchTemperature

```python
def mbltmlGetPcieSwitchTemperature(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the current temperature of the PCIe switch of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

> [!NOTE]
>
> A valid reading is available only on the first aries-rb node of an MLA400 board. Any other ARIES device reports 0.

> [!NOTE]
>
> Requires ARIES firmware v1.2.5 or later. Earlier firmware reports 0.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The temperature reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetChipId

```python
def mbltmlGetChipId(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the chip ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

> [!NOTE]
>
> Requires ARIES firmware v1.2.5 or later. Earlier firmware reports 0.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The chip ID.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetSignalType

```python
def mbltmlGetSignalType(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the current signal-type indicator reported by the device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The signal-type value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetNPUClock

```python
def mbltmlGetNPUClock(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the current NPU clock frequency of a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The NPU clock value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetBusClock

```python
def mbltmlGetBusClock(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the current bus clock frequency of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The bus clock value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetFanDuty

```python
def mbltmlGetFanDuty(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the current cooling-fan duty cycle of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The fan duty value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetVendorId

```python
def mbltmlGetVendorId(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the PCIe vendor ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The vendor ID.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetDeviceId

```python
def mbltmlGetDeviceId(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the PCIe device ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The device ID.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetSubVendorId

```python
def mbltmlGetSubVendorId(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the PCIe subsystem vendor ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The subsystem vendor ID.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetSubDeviceId

```python
def mbltmlGetSubDeviceId(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the PCIe subsystem device ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The subsystem device ID.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieGen

```python
def mbltmlGetPcieGen(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the negotiated PCIe link generation of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The PCIe generation.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieLanes

```python
def mbltmlGetPcieLanes(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the negotiated PCIe link width (in lanes) of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The lane count.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieRev

```python
def mbltmlGetPcieRev(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> int
```

Get the PCIe configuration-space revision ID of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The revision value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieClassCode

```python
def mbltmlGetPcieClassCode(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the PCIe configuration-space class code of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The class code.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetPcieSlot

```python
def mbltmlGetPcieSlot(target_device_type: mbltmlTargetDeviceType_t, dev_no: int) -> str
```

Get the PCIe slot location of a device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The slot location string, formatted either as an ACPI path (e.g. "0-1-2") or as a BDF address (e.g. "0000:01:00.0").

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetTotalPower

```python
def mbltmlGetTotalPower(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the total instantaneous power consumption of a device (W).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The power reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetTotalCurrent

```python
def mbltmlGetTotalCurrent(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the total instantaneous current draw of a device (A).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The current reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetTotalVoltage

```python
def mbltmlGetTotalVoltage(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the total instantaneous supply voltage of a device (V).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The voltage reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetExtraPmicPower

```python
def mbltmlGetExtraPmicPower(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the power consumption of the extra PMIC rail currently selected for the device (W).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

The selected rail is controlled by [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>) and can be queried via [mbltmlGetExtraPmicId()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmicid>).

The firmware refreshes this reading once per second. After changing the selected rail with [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>), allow up to 1 second for the new rail's value to be reported.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The power reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetExtraPmicCurrent

```python
def mbltmlGetExtraPmicCurrent(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the current of the extra PMIC rail currently selected for the device (A).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

The firmware refreshes this reading once per second. After changing the selected rail with [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>), allow up to 1 second for the new rail's value to be reported.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The current reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetExtraPmicVoltage

```python
def mbltmlGetExtraPmicVoltage(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the voltage of the extra PMIC rail currently selected for the device (V).

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

The firmware refreshes this reading once per second. After changing the selected rail with [mbltmlSetExtraPmicID()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlsetextrapmicid>), allow up to 1 second for the new rail's value to be reported.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The voltage reading.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetExtraPmicId

```python
def mbltmlGetExtraPmicId(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> mbltmlExtraPmicId_t
```

Get the extra PMIC rail currently selected for the device.

> [!NOTE]
>
> Supported on MBLTML\_DRIVER\_ARIES only.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The selected mbltmlExtraPmicId\_t value.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetTotalUtilization

```python
def mbltmlGetTotalUtilization(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> float
```

Get the overall NPU utilization of a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The utilization value (typically a ratio in \[0.0, 1.0\] or a percentage).

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetMemoryUsage

```python
def mbltmlGetMemoryUsage(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the amount of device memory currently in use.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The in-use memory in bytes.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetMemoryTotal

```python
def mbltmlGetMemoryTotal(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> int
```

Get the total amount of device memory available.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

The total memory in bytes.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetProcessInfos

```python
def mbltmlGetProcessInfos(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> List[mbltmlProcessInfo_t]
```

Get per-process usage information for a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

List of [mbltmlProcessInfo\_t](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlprocessinfo-t>) records; empty if no process is running.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlGetCoreInfos

```python
def mbltmlGetCoreInfos(
    target_device_type: mbltmlTargetDeviceType_t, dev_no: int
) -> List[mbltmlCoreInfo_t]
```

Get per-core usage information for a device.

> [!NOTE]
>
> Supported on all driver types.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).

**Returns**

List of [mbltmlCoreInfo\_t](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlcoreinfo-t>) records.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.

### mbltmlSetExtraPmicID

```python
def mbltmlSetExtraPmicID(
    target_device_type: mbltmlTargetDeviceType_t,
    dev_no: int,
    pmic_id: mbltmlExtraPmicId_t,
) -> None
```

Select which extra PMIC rail subsequent mbltmlGetExtraPmic\*() queries refer to.

> [!NOTE]
>
> Supported on aries-rb device (MBLTML\_TARGET\_DEVICE\_ARIES\_RB) only.

The underlying readings are refreshed by firmware once per second; allow up to 1 second after this call before [mbltmlGetExtraPmicPower()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmicpower>), [mbltmlGetExtraPmicCurrent()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmiccurrent>) and [mbltmlGetExtraPmicVoltage()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgetextrapmicvoltage>) reflect the newly selected rail.

**Parameters**

- `target_device_type` — Target device type of the device.
- `dev_no` — Device index within `target_device_type`. Device count is obtained via [mbltmlGetTargetDeviceCount()](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlgettargetdevicecount>).
- `pmic_id` — Identifier of the extra PMIC rail to select.

**Throws**

- [`MBLTMLInvalidArgumentError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlinvalidargumenterror>) — if `dev_no` is out of range of the `target_device_type` device count.
- [`MBLTMLDeviceNotFoundError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmldevicenotfounderror>) — if no device of `target_device_type` is detected.
- [`MBLTMLError`](<https://docs.mobilint.com/runtime/en/v1.5/api/mbltml/python/mbltml.mbltml/#mbltmlerror>) — on other failures.
