函数：get_soc_name
函数：finalize
| C函数原型 | aclError aclFinalize() |
|---|---|
| Python函数 | ret = acl.finalize() |
| 函数功能 | pyACL去初始化函数，用于释放进程内的pyACL相关资源，同步接口。 |
| 输入说明 | 无 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 应用的进程退出前，应显式调用该接口实现pyACL去初始化，否则可能会导致异常，例如应用进程退出时有异常报错。 不建议在析构函数中调用acl.finalize接口，否则在进程退出时可能由于单例析构顺序未知而导致进程异常退出的问题。 |
| 参考资源 | 接口调用示例，参见pyACL初始化与去初始化。 |
父主题： 系统配置
函数：get_version
| C函数原型 | aclErroraclrtGetVersion(int32_t *majorVersion, int32_t *minorVersion, int32_t *patchVersion) |
|---|---|
| Python函数 | major_version, minor_version, patch_version, ret = acl.get_version() |
| 函数功能 | 查询接口版本号，pyACL接口版本号命名可以采用：A.B.C模式，其中C表示bug修复，B表示新增接口，A表示有不兼容修改。同步接口。 |
| 输入说明 | 无。 |
| 返回值说明 | major_version：int，从1开始，如果出现接口的不兼容变更时，加1。 minor_version：int，从0开始，按照迭代周期，有新增接口时加1。 patch_version：int，从0开始，表示本版本仅仅解决了问题，在“majorVersion”、“minorVersion”不变的情况下加1。但“majorVersion”、“minorVersion”增加的时候，“patchVersion”一般为“0”。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 系统配置
函数：get_soc_name
| C函数原型 | const char *aclrtGetSocName() |
|---|---|
| Python函数 | name = acl.get_soc_name() |
| 函数功能 | 查询当前运行环境的芯片版本，同步接口。 |
| 输入说明 | 无 |
| 返回值说明 | name：str，返回芯片版本字符串。如果通过该接口获取芯片版本失败，则返回None。 |
| 约束说明 | 无 |
父主题： 系统配置
函数：get_recent_err_msg
| C函数原型 | const char *aclGetRecentErrMsg() |
|---|---|
| Python函数 | msg = acl.get_recent_err_msg() |
| 函数功能 | 获取并清空与本接口在同一个线程中的其它pyACL接口调用失败时的错误描述信息。同步接口。 |
| 输入说明 | 无 |
| 返回值说明 | msg：str，返回错误描述字符串。 如果通过本接口获取到多条错误描述信息，最上面的错误描述信息为最新的。 获取错误描述信息失败时，返回None。 |
| 约束说明 | - 建议在每次调用pyACL接口失败时都调用acl.get_recent_err_msg接口，以便获取调用pyACL接口异常时的错误描述信息，用于定位问题。 - 同一个线程中多次调用acl.get_recent_err_msg接口后，只有最后一次调用acl.get_recent_err_msg接口返回的错误描述字符串有效，之前acl.get_recent_err_msg接口返回的错误描述字符串不能使用，否则可能导致内存非法访问。 - 如果未在每次调用pyACL接口失败时调用acl.get_recent_err_msg接口，则可能导致错误信息堆积、丢失。 |
父主题： 系统配置
函数：set_device_sat_mode
| C函数原型 | aclError aclrtSetDeviceSatMode(aclrtFloatOverflowMode mode) |
|---|---|
| Python函数 | ret = acl.rt.set_device_sat_mode**(**mode) |
| 函数功能 | 设置当前Context对应的Device的浮点计算结果输出模式，同步接口。 Atlas 200/500 A2推理产品，当前版本不支持该接口。 |
| 输入说明 | mode：int，设置浮点计算结果输出模式。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 调用该接口成功后，后续在该Device上新创建的Stream按设置的模式生效，对之前已创建的Stream不生效。 |
父主题： 系统配置
在线提单