函数：get_recent_err_msg
函数：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不生效。 |
父主题： 系统配置
函数：get_device_sat_mode
| C函数原型 | aclError aclrtGetDeviceSatMode(aclrtFloatOverflowMode *mode) |
|---|---|
| Python函数 | mode, ret = acl.rt.get_device_sat_mode**(****)** |
| 函数功能 | 查询当前Context对应的Device的浮点计算结果输出模式，同步接口。 Atlas 200/500 A2推理产品，当前版本不支持该接口。 |
| 输入说明 | 无 |
| 返回值说明 | mode：int，获取浮点计算结果输出模式。 ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 系统配置
函数：float16_to_float
| C函数原型 | float aclFloat16ToFloat(aclFloat16 value) |
|---|---|
| Python函数 | output = acl.float16_to_float(value) |
| 函数功能 | 将aclFloat16类型的数据转换为float（指float32）类型的数据。 |
| 输入说明 | value：int，待转化的数据，aclFloat16类型的数据。 |
| 返回值说明 | output：float，浮点数类型。 |
| 约束说明 | 无 |
父主题： 公共接口
在线提单