下载
中文
注册

PostFakeMsg

功能说明

通过AllocMessage接口获取到消息空间地址msg后,AIV发送假消息,刷新消息状态msgState为FAKE。

当多个AIV的消息内容一致时,AIC仅需要读取一次位置靠前的第一个消息,通过消息结构体中自定义的参数skipCnt设置为n,通知AIC后续n条消息无需读取,直接跳过,被跳过的这n个消息队列的AIV需要使用本接口发送假消息,这被称之为消息合并机制或消息合并场景。

如下图所示,假设Queue1、2、3的第0条消息与Queue0的第0条消息相同,在消息合并场景中,从AIC视角来看,Queue 0(0),Queue 4(0)的消息会被处理,并根据用户自定义的消息内容完成相应的AIC上的计算。Queue 1(0), Queue 2(0), Queue 3(0)由于发了假消息,AIC将刷新假消息的状态并跳过这些假消息,但不会读取用户自定义的消息内容也不会进行计算。

图1 PostFakeMessage示意图

函数原型

1
__aicore__ inline uint16_t PostFakeMsg(__gm__ CubeMsgType* msg)

参数说明

表1 接口参数说明

参数

输入/输出

说明

msg

输入

该CubeResGroupHandle中某个任务的消息空间地址。

返回值

当前消息空间与该消息队列队首空间的地址偏移。

支持的型号

Atlas A2训练系列产品/Atlas 800I A2推理产品

约束说明

调用示例

1
2
3
4
5
a.AssignQueue(queIdx);  
auto msgPtr = a.AllocMessage();        // 获取消息空间指针msgPtr
AscendC::CubeGroupMsgHead headA = {CubeMsgState::Fake, 0};
AscendC::CubeMsgBody msgA = {headA, 1, 0, 0, false, false, false, false, 0, 0, 0, 0, 0, 0, 0, 0};
a.SendFakeMsg(msgPtr);           // 在msgPtr指针位置,发送假消息