mbltml C API

mbltml C API#

mbltml: mbltml C API

mbltml v1.4

mbltml — EN

C API provides Mobilint NPU monitoring and telemetry. More...

Classes
struct	mbltmlCoreId_t
	Composite identifier of an NPU core (cluster + core). More...
struct	mbltmlCoreInfo_t
	Per-core usage record returned by mbltmlGetCoreInfos(). More...
struct	mbltmlProcessInfo_t
	Per-process usage record returned by mbltmlGetProcessInfos(). More...

Macros
#define	MBLTML_DRIVER_VERSION_BUFFER_SIZE 80
#define	MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE 80
#define	MBLTML_FIRMWARE_VERSION_BUFFER_SIZE 80
#define	MBLTML_NODE_NAME_BUFFER_SIZE 80

Typedefs
typedef struct mbltmlCoreId_t	mbltmlCoreId_t
	Composite identifier of an NPU core (cluster + core).
typedef struct mbltmlProcessInfo_t	mbltmlProcessInfo_t
	Per-process usage record returned by mbltmlGetProcessInfos().

Enumerations
enum	mbltmlDriverType_t { MBLTML_DRIVER_ERROR = 0x0 , MBLTML_DRIVER_ARIES = 0x1 , MBLTML_DRIVER_REGULUS = 0x2 , MBLTML_DRIVER_REGULUS_USB = 0x4 }
	Identifier of a Mobilint NPU driver. More...
enum	mbltmlTargetDeviceType_t { MBLTML_TARGET_DEVICE_ARIES_RA = 0x00000001 , MBLTML_TARGET_DEVICE_REGULUS_RA = 0x00000002 , MBLTML_TARGET_DEVICE_ARIES_RB = 0x00000003 , MBLTML_TARGET_DEVICE_REGULUS_RB = 0x00000004 , MBLTML_TARGET_DEVICE_REGULUS_RA_USB = 0x00000005 , MBLTML_TARGET_DEVICE_REGULUS_RB_USB = 0x00000006 , MBLTML_TARGET_DEVICE_ERROR = 0x7FFFFFFF }
	Specific target device type of a Mobilint NPU. More...
enum	mbltmlStatusCode_t { MBLTML_SUCCESS = 0 , MBLTML_UNINITIALIZED = 1 , MBLTML_DRIVER_NOT_FOUND = 2 , MBLTML_INVALID_ARGUMENT = 3 , MBLTML_NOT_SUPPORTED = 4 , MBLTML_INSUFFICIENT_LENGTH = 5 , MBLTML_DEVICE_NOT_FOUND = 6 }
	Status code returned by mbltml APIs. More...
enum	mbltmlExtraPmicId_t { MBLTML_EXTRA_PMIC_ID_NPU = 0 , MBLTML_EXTRA_PMIC_ID_DDR = 1 , MBLTML_EXTRA_PMIC_ID_PMIC = 2 , MBLTML_EXTRA_PMIC_ID_GOLDFINGER = 3 }
	Identifier of an extra PMIC rail. More...
enum	mbltmlCluster_t { MBLTML_CLUSTER_0 = 1 << 16 , MBLTML_CLUSTER_1 = 2 << 16 , MBLTML_CLUSTER_ERROR = 0x7FFF0000 }
	NPU cluster identifier within a device. More...
enum	mbltmlCore_t { MBLTML_CORE_0 = 1 , MBLTML_CORE_1 = 2 , MBLTML_CORE_2 = 3 , MBLTML_CORE_3 = 4 , MBLTML_CORE_GLOBAL = 0x0000FFFE , MBLTML_CORE_ERROR = 0x0000FFFF }
	NPU core identifier within a cluster. More...

Functions
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlInit ()
	Initialize the mbltml library.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlShutdown ()
	Release all resources held by the mbltml library.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetDeviceCount (unsigned int *counts)
	Get the total number of devices detected by the library.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTargetDeviceCount (mbltmlTargetDeviceType_t tdt, unsigned int *counts)
	Get the number of detected devices of a specific target device type.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetDriverVersion (mbltmlDriverType_t dt, char *version, unsigned int length)
	Get the driver version string for a specific driver.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetDriverRevision (mbltmlDriverType_t dt, uint32_t *revision)
	Get the driver revision number for a specific driver.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetNodeName (mbltmlTargetDeviceType_t tdt, int dev_no, char *name, unsigned int length)
	Get the node name of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetDriverType (mbltmlTargetDeviceType_t tdt, int dev_no, mbltmlDriverType_t *driver_type)
	Get the driver type of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetOnDeviceDriverVersion (mbltmlTargetDeviceType_t tdt, int dev_no, char *version, unsigned int length)
	Get the on-device driver version string of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetOnDeviceDriverRevision (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *revision)
	Get the on-device driver revision number of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetFirmwareVersion (mbltmlTargetDeviceType_t tdt, int dev_no, char *version, unsigned int length)
	Get the firmware version string of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetFirmwareRevision (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *revision)
	Get the firmware revision number of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetFirmwareCRC (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *crc)
	Get the CRC of the currently-loaded firmware image.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTemperature (mbltmlTargetDeviceType_t tdt, int dev_no, int *temperature)
	Get the current die temperature of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetSignalType (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *signal_type)
	Get the current signal-type indicator reported by the device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetNPUClock (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *clock)
	Get the current NPU clock frequency of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetBusClock (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *clock)
	Get the current bus clock frequency of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetFanDuty (mbltmlTargetDeviceType_t tdt, int dev_no, int *fan_duty)
	Get the current cooling-fan duty cycle of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetVendorId (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *vendor_id)
	Get the PCIe vendor ID of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetDeviceId (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *device_id)
	Get the PCIe device ID of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetSubVendorId (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *sub_vendor_id)
	Get the PCIe subsystem vendor ID of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetSubDeviceId (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *sub_device_id)
	Get the PCIe subsystem device ID of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetPcieGen (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *pcie_gen)
	Get the negotiated PCIe link generation of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetPcieLanes (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *pcie_lanes)
	Get the negotiated PCIe link width (in lanes) of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetPcieRev (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *pcie_rev)
	Get the PCIe configuration-space revision ID of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetPcieClassCode (mbltmlTargetDeviceType_t tdt, int dev_no, uint32_t *pcie_class_code)
	Get the PCIe configuration-space class code of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTotalPower (mbltmlTargetDeviceType_t tdt, int dev_no, double *power)
	Get the total instantaneous power consumption of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTotalCurrent (mbltmlTargetDeviceType_t tdt, int dev_no, double *current)
	Get the total instantaneous current draw of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTotalVoltage (mbltmlTargetDeviceType_t tdt, int dev_no, double *voltage)
	Get the total instantaneous supply voltage of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetExtraPmicPower (mbltmlTargetDeviceType_t tdt, int dev_no, double *power)
	Get the power consumption of the extra PMIC rail currently selected for the device (W).
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetExtraPmicCurrent (mbltmlTargetDeviceType_t tdt, int dev_no, double *current)
	Get the current of the extra PMIC rail currently selected for the device (A).
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetExtraPmicVoltage (mbltmlTargetDeviceType_t tdt, int dev_no, double *voltage)
	Get the voltage of the extra PMIC rail currently selected for the device (V).
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetExtraPmicId (mbltmlTargetDeviceType_t tdt, int dev_no, mbltmlExtraPmicId_t *pmic_id)
	Get the extra PMIC rail currently selected for the device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetTotalUtilization (mbltmlTargetDeviceType_t tdt, int dev_no, double *utilization)
	Get the overall NPU utilization of a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetMemoryUsage (mbltmlTargetDeviceType_t tdt, int dev_no, int64_t *memory_usage)
	Get the amount of device memory currently in use.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetMemoryTotal (mbltmlTargetDeviceType_t tdt, int dev_no, int64_t *memory_total)
	Get the total amount of device memory available.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetProcessInfos (mbltmlTargetDeviceType_t tdt, int dev_no, mbltmlProcessInfo_t infos, unsigned int info_count)
	Get per-process usage information for a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlGetCoreInfos (mbltmlTargetDeviceType_t tdt, int dev_no, mbltmlCoreInfo_t infos, unsigned int info_count)
	Get per-core usage information for a device.
MBLTML_EXPORT mbltmlStatusCode_t	mbltmlSetExtraPmicID (mbltmlTargetDeviceType_t tdt, int dev_no, mbltmlExtraPmicId_t pmic_id)
	Select which extra PMIC rail subsequent mbltmlGetExtraPmic*() queries refer to.

Detailed Description

C API provides Mobilint NPU monitoring and telemetry.

This header is plain C (C99) so that mbltml/capi.h can be included from C translation units. Keep it free of C++-only constructs such as digit separators and default member initializers; test/test_capi.c guards this.

The structs below therefore carry no default member initializers. Every field is filled in by the API that returns them; a caller that declares one itself is responsible for initializing it (e.g. = {0}).

Macro Definition Documentation

◆ MBLTML_DRIVER_VERSION_BUFFER_SIZE

#define MBLTML_DRIVER_VERSION_BUFFER_SIZE 80

Buffer size (bytes) guaranteed sufficient for mbltmlGetDriverVersion().

Definition at line 18 of file capi.h.

◆ MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE

#define MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE 80

Buffer size (bytes) guaranteed sufficient for mbltmlGetOnDeviceDriverVersion().

Definition at line 20 of file capi.h.

◆ MBLTML_FIRMWARE_VERSION_BUFFER_SIZE

#define MBLTML_FIRMWARE_VERSION_BUFFER_SIZE 80

Buffer size (bytes) guaranteed sufficient for mbltmlGetFirmwareVersion().

Definition at line 22 of file capi.h.

◆ MBLTML_NODE_NAME_BUFFER_SIZE

#define MBLTML_NODE_NAME_BUFFER_SIZE 80

Buffer size (bytes) guaranteed sufficient for mbltmlGetNodeName().

Definition at line 24 of file capi.h.

Typedef Documentation

◆ mbltmlProcessInfo_t

typedef struct mbltmlProcessInfo_t mbltmlProcessInfo_t

Per-process usage record returned by mbltmlGetProcessInfos().

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

Enumeration Type Documentation

◆ mbltmlDriverType_t

enum mbltmlDriverType_t

Identifier of a Mobilint NPU driver.

Used to select a driver when calling family-scoped APIs such as mbltmlGetDriverVersion(), and to describe the family of an individual device returned by mbltmlGetDriverType().

Enumerator
MBLTML_DRIVER_ERROR	0x0	Invalid or uninitialized value.
MBLTML_DRIVER_ARIES	0x1	ARIES (PCIe) Driver.
MBLTML_DRIVER_REGULUS	0x2	REGULUS (SoC) Driver.
MBLTML_DRIVER_REGULUS_USB	0x4	REGULUS (USB) Driver.

Definition at line 33 of file type.h.

◆ mbltmlTargetDeviceType_t

enum mbltmlTargetDeviceType_t

Specific target device type of a Mobilint NPU.

Enumerator
MBLTML_TARGET_DEVICE_ARIES_RA	0x00000001	aries-ra.
MBLTML_TARGET_DEVICE_REGULUS_RA	0x00000002	regulus-ra.
MBLTML_TARGET_DEVICE_ARIES_RB	0x00000003	aries-rb.
MBLTML_TARGET_DEVICE_REGULUS_RB	0x00000004	regulus-rb.
MBLTML_TARGET_DEVICE_REGULUS_RA_USB	0x00000005	regulus-ra-usb.
MBLTML_TARGET_DEVICE_REGULUS_RB_USB	0x00000006	regulus-rb-usb.
MBLTML_TARGET_DEVICE_ERROR	0x7FFFFFFF	Invalid or uninitialized.

Definition at line 43 of file type.h.

◆ mbltmlStatusCode_t

enum mbltmlStatusCode_t

Status code returned by mbltml APIs.

Enumerator
MBLTML_SUCCESS	0	Operation completed successfully.
MBLTML_UNINITIALIZED	1	API used before initialization.
MBLTML_DRIVER_NOT_FOUND	2	Required driver could not be located.
MBLTML_INVALID_ARGUMENT	3	Invalid argument (NULL or out-of-range).
MBLTML_NOT_SUPPORTED	4	Feature not supported on target device.
MBLTML_INSUFFICIENT_LENGTH	5	Output buffer is too small.
MBLTML_DEVICE_NOT_FOUND	6	Requested target device could not be located.

Definition at line 56 of file type.h.

◆ mbltmlExtraPmicId_t

enum mbltmlExtraPmicId_t

Identifier of an extra PMIC rail.

Selects which auxiliary PMIC rail is reported by the mbltmlGetExtraPmic*() APIs. The active selection is changed with mbltmlSetExtraPmicID() and can be queried via mbltmlGetExtraPmicId().

Enumerator
MBLTML_EXTRA_PMIC_ID_NPU	0	NPU rail.
MBLTML_EXTRA_PMIC_ID_DDR	1	DDR rail.
MBLTML_EXTRA_PMIC_ID_PMIC	2	PMIC rail.
MBLTML_EXTRA_PMIC_ID_GOLDFINGER	3	Goldfinger rail.

Definition at line 73 of file type.h.

◆ mbltmlCluster_t

enum mbltmlCluster_t

NPU cluster identifier within a device.

Enumerator
MBLTML_CLUSTER_0	1 << 16	Cluster 0.
MBLTML_CLUSTER_1	2 << 16	Cluster 1.
MBLTML_CLUSTER_ERROR	0x7FFF0000	Invalid or uninitialized state.

Definition at line 83 of file type.h.

◆ mbltmlCore_t

enum mbltmlCore_t

NPU core identifier within a cluster.

Enumerator
MBLTML_CORE_0	1	Local core 0.
MBLTML_CORE_1	2	Local core 1.
MBLTML_CORE_2	3	Local core 2.
MBLTML_CORE_3	4	Local core 3.
MBLTML_CORE_GLOBAL	0x0000FFFE	Global (all cores aggregated).
MBLTML_CORE_ERROR	0x0000FFFF	Invalid or uninitialized state.

Definition at line 92 of file type.h.

Function Documentation

◆ mbltmlInit()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlInit ( )

Initialize the mbltml library.

Returns: MBLTML_SUCCESS on success, otherwise an appropriate mbltmlStatusCode_t error code.

◆ mbltmlShutdown()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlShutdown ( )

Release all resources held by the mbltml library.

After this call, any further API usage requires re-initialization via mbltmlInit().

Returns: MBLTML_SUCCESS on success, otherwise an appropriate mbltmlStatusCode_t error code.

◆ mbltmlGetDeviceCount()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetDeviceCount ( unsigned int * counts )

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.

Attention: Do not confuse this with mbltmlGetTargetDeviceCount(). Since unidentified devices are not addressable by any (tdt, dev_no) pair, this count may exceed the sum over every mbltmlTargetDeviceType_t.

Parameters

[out] counts Pointer that receives the device count.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if counts is NULL, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTargetDeviceCount()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTargetDeviceCount	(	mbltmlTargetDeviceType_t	tdt,
		unsigned int *	counts )

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

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type whose device count is queried.
[out]	counts	Pointer that receives the device count. Set to 0 if no device of `tdt` is detected.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if counts is NULL, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetDriverVersion()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetDriverVersion	(	mbltmlDriverType_t	dt,
		char *	version,
		unsigned int	length )

Get the driver version string for a specific driver.

Note: Supported on all driver types.

A buffer of MBLTML_DRIVER_VERSION_BUFFER_SIZE bytes guarantees success. The resulting string is NUL-terminated. On failure, the contents of version are left unmodified.

Parameters

[in]	dt	Driver type whose driver version is queried.
[out]	version	Output buffer that receives the version string.
[in]	length	Size, in bytes, of `version`.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if version is NULL, MBLTML_INSUFFICIENT_LENGTH if length is too small, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetDriverRevision()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetDriverRevision	(	mbltmlDriverType_t	dt,
		uint32_t *	revision )

Get the driver revision number for a specific driver.

Note: Supported on all driver types.

Parameters

[in]	dt	Driver type whose driver revision is queried.
[out]	revision	Pointer that receives the revision number.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if revision is NULL, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetNodeName()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetNodeName	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		char *	name,
		unsigned int	length )

Get the node name of a device.

Note: Supported on all driver types.

A buffer of MBLTML_NODE_NAME_BUFFER_SIZE bytes guarantees success. The resulting string is NUL-terminated. On failure, the contents of name are left unmodified.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	name	Output buffer that receives the node name.
[in]	length	Size, in bytes, of `name`.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if name is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, MBLTML_INSUFFICIENT_LENGTH if length is too small, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetDriverType()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetDriverType	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		mbltmlDriverType_t *	driver_type )

Get the driver type of a device.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	driver_type	Pointer that receives the mbltmlDriverType_t value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if driver_type is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetOnDeviceDriverVersion()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetOnDeviceDriverVersion	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		char *	version,
		unsigned int	length )

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

Note: Supported on MBLTML_DRIVER_REGULUS_USB only.

A buffer of MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE bytes guarantees success. The resulting string is NUL-terminated. On failure, the contents of version are left unmodified.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	version	Output buffer that receives the version string.
[in]	length	Size, in bytes, of `version`.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if version is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, MBLTML_INSUFFICIENT_LENGTH if length is too small, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetOnDeviceDriverRevision()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetOnDeviceDriverRevision	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	revision )

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

Note: Supported on MBLTML_DRIVER_REGULUS_USB only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	revision	Pointer that receives the on-device driver revision.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if revision is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetFirmwareVersion()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetFirmwareVersion	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		char *	version,
		unsigned int	length )

Get the firmware version string of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

A buffer of MBLTML_FIRMWARE_VERSION_BUFFER_SIZE bytes guarantees success. The resulting string is NUL-terminated. On failure, the contents of version are left unmodified.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	version	Output buffer that receives the version string.
[in]	length	Size, in bytes, of `version`.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if version is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, MBLTML_INSUFFICIENT_LENGTH if length is too small, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetFirmwareRevision()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetFirmwareRevision	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	revision )

Get the firmware revision number of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	revision	Pointer that receives the firmware revision.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if revision is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetFirmwareCRC()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetFirmwareCRC	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	crc )

Get the CRC of the currently-loaded firmware image.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	crc	Pointer that receives the firmware CRC.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if crc is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTemperature()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTemperature	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		int *	temperature )

Get the current die temperature of a device.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	temperature	Pointer that receives the temperature reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if temperature is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetSignalType()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetSignalType	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	signal_type )

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

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	signal_type	Pointer that receives the signal-type value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if signal_type is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetNPUClock()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetNPUClock	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	clock )

Get the current NPU clock frequency of a device.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	clock	Pointer that receives the NPU clock value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if clock is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetBusClock()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetBusClock	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	clock )

Get the current bus clock frequency of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	clock	Pointer that receives the bus clock value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if clock is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetFanDuty()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetFanDuty	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		int *	fan_duty )

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

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	fan_duty	Pointer that receives the fan duty value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if fan_duty is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetVendorId()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetVendorId	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	vendor_id )

Get the PCIe vendor ID of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	vendor_id	Pointer that receives the vendor ID.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if vendor_id is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetDeviceId()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetDeviceId	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	device_id )

Get the PCIe device ID of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	device_id	Pointer that receives the device ID.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if device_id is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetSubVendorId()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetSubVendorId	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	sub_vendor_id )

Get the PCIe subsystem vendor ID of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	sub_vendor_id	Pointer that receives the subsystem vendor ID.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if sub_vendor_id is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetSubDeviceId()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetSubDeviceId	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	sub_device_id )

Get the PCIe subsystem device ID of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	sub_device_id	Pointer that receives the subsystem device ID.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if sub_device_id is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetPcieGen()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetPcieGen	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	pcie_gen )

Get the negotiated PCIe link generation of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	pcie_gen	Pointer that receives the PCIe generation.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if pcie_gen is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetPcieLanes()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetPcieLanes	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	pcie_lanes )

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

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	pcie_lanes	Pointer that receives the lane count.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if pcie_lanes is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetPcieRev()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetPcieRev	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	pcie_rev )

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

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	pcie_rev	Pointer that receives the revision value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if pcie_rev is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetPcieClassCode()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetPcieClassCode	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		uint32_t *	pcie_class_code )

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

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	pcie_class_code	Pointer that receives the class code.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if pcie_class_code is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTotalPower()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTotalPower	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	power )

Get the total instantaneous power consumption of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	power	Pointer that receives the power reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if power is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTotalCurrent()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTotalCurrent	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	current )

Get the total instantaneous current draw of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	current	Pointer that receives the current reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if current is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTotalVoltage()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTotalVoltage	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	voltage )

Get the total instantaneous supply voltage of a device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	voltage	Pointer that receives the voltage reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if voltage is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetExtraPmicPower()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetExtraPmicPower	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	power )

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() and can be queried via mbltmlGetExtraPmicId().

The firmware refreshes this reading once per second. After changing the selected rail with mbltmlSetExtraPmicID(), allow up to 1 second for the new rail's value to be reported.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	power	Pointer that receives the power reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if power is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetExtraPmicCurrent()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetExtraPmicCurrent	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	current )

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(), allow up to 1 second for the new rail's value to be reported.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	current	Pointer that receives the current reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if current is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetExtraPmicVoltage()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetExtraPmicVoltage	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	voltage )

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(), allow up to 1 second for the new rail's value to be reported.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	voltage	Pointer that receives the voltage reading.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if voltage is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetExtraPmicId()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetExtraPmicId	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		mbltmlExtraPmicId_t *	pmic_id )

Get the extra PMIC rail currently selected for the device.

Note: Supported on MBLTML_DRIVER_ARIES only.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	pmic_id	Pointer that receives the selected mbltmlExtraPmicId_t value.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if pmic_id is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetTotalUtilization()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetTotalUtilization	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		double *	utilization )

Get the overall NPU utilization of a device.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	utilization	Pointer that receives the utilization value (typically a ratio in [0.0, 1.0] or a percentage).

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if utilization is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetMemoryUsage()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetMemoryUsage	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		int64_t *	memory_usage )

Get the amount of device memory currently in use.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	memory_usage	Pointer that receives the in-use memory, in bytes.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if memory_usage is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetMemoryTotal()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetMemoryTotal	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		int64_t *	memory_total )

Get the total amount of device memory available.

Note: Supported on all driver types.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	memory_total	Pointer that receives the total memory, in bytes.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if memory_total is NULL, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetProcessInfos()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetProcessInfos	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		mbltmlProcessInfo_t *	infos,
		unsigned int *	info_count )

Get per-process usage information for a device.

Note: Supported on all driver types.

This call supports the standard two-step query pattern:

Pass *info_count == 0 (with infos either NULL or unused) to learn the required entry count, which is written back to info_count.
Pass a buffer with *info_count set to its capacity to retrieve up to that many entries; the actual entry count is written back to info_count.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	infos	Output array that receives the process records. May be `NULL` when `*info_count` is `0`.
[in,out]	info_count	On input, the capacity of `infos` in entries (or `0` to query the required size). On output, the number of entries written or required.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if info_count is NULL, or if infos is NULL while *info_count is non-zero, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, MBLTML_INSUFFICIENT_LENGTH if infos is too small to hold all entries, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlGetCoreInfos()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlGetCoreInfos	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		mbltmlCoreInfo_t *	infos,
		unsigned int *	info_count )

Get per-core usage information for a device.

Note: Supported on all driver types.

The two-step query pattern documented in mbltmlGetProcessInfos() applies.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[out]	infos	Output array that receives the core records. May be `NULL` when `*info_count` is `0`.
[in,out]	info_count	On input, the capacity of `infos` in entries (or `0` to query the required size). On output, the number of entries written or required.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if info_count is NULL, or if infos is NULL while *info_count is non-zero, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, MBLTML_INSUFFICIENT_LENGTH if infos is too small to hold all entries, or another mbltmlStatusCode_t error code on failure.

◆ mbltmlSetExtraPmicID()

MBLTML_EXPORT mbltmlStatusCode_t mbltmlSetExtraPmicID	(	mbltmlTargetDeviceType_t	tdt,
		int	dev_no,
		mbltmlExtraPmicId_t	pmic_id )

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(), mbltmlGetExtraPmicCurrent() and mbltmlGetExtraPmicVoltage() reflect the newly selected rail.

Parameters

[in]	tdt	Target device type of the device.
[in]	dev_no	Device index within `tdt`. See mbltmlGetTargetDeviceCount() for the count.
[in]	pmic_id	Identifier of the extra PMIC rail to select.

Returns: MBLTML_SUCCESS on success, MBLTML_INVALID_ARGUMENT if dev_no is out of range of the tdt device count, MBLTML_DEVICE_NOT_FOUND if no device of tdt is detected, or another mbltmlStatusCode_t error code on failure.

mbltml C API

mbltml C API#

Classes

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ MBLTML_DRIVER_VERSION_BUFFER_SIZE

◆ MBLTML_ON_DEVICE_DRIVER_VERSION_BUFFER_SIZE

◆ MBLTML_FIRMWARE_VERSION_BUFFER_SIZE

◆ MBLTML_NODE_NAME_BUFFER_SIZE

Typedef Documentation

◆ mbltmlProcessInfo_t

Enumeration Type Documentation

◆ mbltmlDriverType_t

◆ mbltmlTargetDeviceType_t

◆ mbltmlStatusCode_t

◆ mbltmlExtraPmicId_t

◆ mbltmlCluster_t

◆ mbltmlCore_t

Function Documentation

◆ mbltmlInit()

◆ mbltmlShutdown()

◆ mbltmlGetDeviceCount()

◆ mbltmlGetTargetDeviceCount()

◆ mbltmlGetDriverVersion()

◆ mbltmlGetDriverRevision()

◆ mbltmlGetNodeName()

◆ mbltmlGetDriverType()

◆ mbltmlGetOnDeviceDriverVersion()

◆ mbltmlGetOnDeviceDriverRevision()

◆ mbltmlGetFirmwareVersion()

◆ mbltmlGetFirmwareRevision()

◆ mbltmlGetFirmwareCRC()

◆ mbltmlGetTemperature()

◆ mbltmlGetSignalType()

◆ mbltmlGetNPUClock()

◆ mbltmlGetBusClock()

◆ mbltmlGetFanDuty()

◆ mbltmlGetVendorId()

◆ mbltmlGetDeviceId()

◆ mbltmlGetSubVendorId()

◆ mbltmlGetSubDeviceId()

◆ mbltmlGetPcieGen()

◆ mbltmlGetPcieLanes()

◆ mbltmlGetPcieRev()

◆ mbltmlGetPcieClassCode()

◆ mbltmlGetTotalPower()

◆ mbltmlGetTotalCurrent()

◆ mbltmlGetTotalVoltage()

◆ mbltmlGetExtraPmicPower()

◆ mbltmlGetExtraPmicCurrent()

◆ mbltmlGetExtraPmicVoltage()

◆ mbltmlGetExtraPmicId()

◆ mbltmlGetTotalUtilization()

◆ mbltmlGetMemoryUsage()

◆ mbltmlGetMemoryTotal()

◆ mbltmlGetProcessInfos()

◆ mbltmlGetCoreInfos()

◆ mbltmlSetExtraPmicID()