Function: get_function_addr

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas training product	√
Atlas inference product	√
Atlas 200I/500 A2 inference product	√

Function

Obtains the start address of an operator on a device based on a kernel function handle. For operators that involve matrix and vector compute, an operator has two start addresses, which are executed on the Cube and Vector compute units, respectively. This API can be used to obtain the start addresses of operators on the Cube and Vector compute units. If the value of aivAddr obtained by calling this API is empty, the operator is executed only on the Cube Unit.

Prototype

C Prototype

aclError aclrtGetFunctionAddr(aclrtFuncHandle funcHandle, void **aicAddr, void **aivAddr)

Python Function

aic_addr, aiv_addr, ret = acl.rt.get_function_addr(func_handle)

Parameters

Parameter	Description
func_handle	Int, kernel function handle.

Return Value

Returned Value	Description
aic_addr	Int, start address of an operator on the AI Core or Cube Core. For the following products, the start address of an operator on the AI Core is returned. Atlas training product Atlas inference product For the following products, the start address of an operator on the Cube Core is returned. Atlas 350 Accelerator Card Atlas A3 training product/Atlas A3 inference product Atlas A2 training product/Atlas A2 inference product Atlas 200I/500 A2 inference product
aiv_addr	Int, start address of an operator on the Vector Core. If the value of aivAddr obtained by calling this API is empty, the operator is not executed on the Vector Core.
ret	Int, 0 on success; else, failure.

Returned Value

Description

aic_addr

Int, start address of an operator on the AI Core or Cube Core.

For the following products, the start address of an operator on the AI Core is returned.
Atlas training product

Atlas inference product
For the following products, the start address of an operator on the Cube Core is returned.
Atlas 350 Accelerator Card

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas 200I/500 A2 inference product

aiv_addr

Int, start address of an operator on the Vector Core.

If the value of aivAddr obtained by calling this API is empty, the operator is not executed on the Vector Core.

ret

Int, 0 on success; else, failure.

Parent topic: Kernel Loading and Execution