函数：get_device_sat_mode
函数：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，浮点数类型。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：float_to_float16
| C函数原型 | aclFloat16 aclFloatToFloat16(float value) |
|---|---|
| Python函数 | output = acl.float_to_float16(value) |
| 函数功能 | 将float（指float32）类型的数据转换为aclFloat16类型的数据。 |
| 输入说明 | value：float，待转化的数据。 |
| 返回值说明 | output：int，aclFloat16类型的数据。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：create_data_buffer
| C函数原型 | aclDataBuffer *aclCreateDataBuffer(void *data, size_t size) |
|---|---|
| Python函数 | output = acl.create_data_buffer(data, size) |
| 函数功能 | 创建aclDataBuffer类型的数据，该数据类型用于描述内存地址、大小等内存信息。同步接口。 如需销毁aclDataBuffer类型的数据，请参见函数：destroy_data_buffer。 |
| 输入说明 | data：int，表述存储aclDataBuffer数据的指针地址。“data”参数支持传入0，表示创建一个空的数据类型，此时“size”参数值无效。该地址对象对应的数据内存需由用户自行管理，调用acl.rt.malloc接口申请内存，调用acl.rt.free接口释放内存。 size：int，内存大小。如果用户需要使用空Tensor，则在申请内存时，内存大小最小为1Byte，以保障后续业务正常运行。 |
| 返回值说明 | output：int， 输出aclDataBuffer的指针地址。 |
| 约束说明 | 无 |
父主题： 公共接口
在线提单