其实对于LIN的加入事件来说，如果看过前面的等待获取不同类型的LIN帧的获取LIN帧数据和等待不同LIN帧类型的函数对比的话，就非常简单了，主要就是将不同的事件加入到事件集中，然后通过等待函数函数检测LIN总线上出现该事件的情况；如果找个例子来说的话，加入的事件就像一道道闸门，LIN总线的报文就像不同身份的人，只有符合通过闸门条件的情况下，才能够通过，然后等待函数将被触发。这部分主要根据大家实际工作中的需求来将事件加入事件集中，然后获取大家需要的信息。
目录
TestJoinLinETFSingleResponseEvent
TestJoinLinHeaderEvent & TestJoinLinWakeupEvent
TestJoinLinReceiveErrorEvent &TestJoinLinTransmErrorEvent
TestJoinLinCSErrorEvent
功能：将事件添加到已联接的事件集中。
事件：校验和错误、LIN事件触发的帧单响应、同步错误
说明：将校验和错误类型的事件添加到已联接的事件集中。这是一个非阻塞函数。
注意：根据所使用的参数类型，如果相应的数据库对象不明确，则只需在调用函数之前设置多总线环境中的适当总线上下文。
apDBMsg：定义报文类消息
aFrameId：LIN报文ID
返回值：
-3：将指定的事件添加到已联接的事件集时出错
-1：一般错误，例如功能不可用
>0：新加入事件的编号
代码示例
testcase tcTFS_waitForLINResponse(int frameId)
{
long eventIndex;
testJoinMessageEvent(frameId);
testJoinLinReceiveErrorEvent(frameId);
testJoinLinCSErrorEvent(frameId);
testJoinLinTransmErrorEvent(frameId);
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1: // valid frame
testStepPass("Validation", "IUT has responded correctly");
break;
case 2: // receive error
testStepFail("Validation", "IUT has responded with wrong number of data bytes");
break;
case 3: // checksum error
testStepFail("Validation", "IUT has responded with wrong checksum");
break;
case 4: // transmission error
testStepFail("Validation", "IUT has not responded");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for response", eventIndex);
}
}
TestJoinLinETFSingleResponseEvent
功能：将LIN事件触发的帧单一响应类型的事件添加到已加入的事件集。
aETFFrameId：LIN事件触发的待等待帧的帧标识符。
aAssocFrameId：与等待的事件触发帧相关联的LIN无条件帧的帧标识符。
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLinETFSingleResponse(int etfFrameId)
{
long eventIndex;
testJoinLinETFSingleResponseEvent(etfFrameId, linGetProtectedID(0x36));
testJoinLinETFSingleResponseEvent(etfFrameId, linGetProtectedID(0x34));
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1:
testStepPass("Validation", "ETF single frame response occurred. FrameId=0x36");
break;
case 2:
testStepPass("Validation", "ETF single frame response occurred. FrameId=0x34");
break;
default:
testStepFail("Validation", "ETF single frame response not occurred");
}
}
TestJoinLinLongDominantSignal
功能：用传输的事件完成当前一组已加入的事件。
说明：
此函数不等待。
在调用函数之前，请考虑始终在多总线环境中设置适当的总线上下文。
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLINHeader(int frameId)
{
long eventIndex;
testJoinLinHeaderEvent(frameId);
testJoinLinLongDominantSignal();
testJoinLinSyncErrorEvent();
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1:
testStepPass("Validation", "LIN Header for FrameId=0x%X occurred", frameId);
break;
case 2:
testStepFail("Validation", "LIN long dominant signal occurred");
break;
case 3:
testStepFail("Validation", "LIN Sync error occurred");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for any LIN event", eventIndex);
}
}TestJoinLinSpike
功能：用传输的事件完成当前一组已加入的事件。
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLINHeader(int frameId)
{
long eventIndex;
testJoinLinHeaderEvent(frameId);
testJoinLinSpike();
testJoinLinSyncErrorEvent();
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1:
testStepPass("Validation", "LIN Header for FrameId=0x%X occurred", frameId);
break;
case 2:
testStepFail("Validation", "LIN Spike occurred");
break;
case 3:
testStepFail("Validation", "LIN Sync error occurred");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for any LIN event", eventIndex);
}
}
TestJoinLinSyncErrorEvent
功能：将类型为同步错误的事件添加到已联接的事件集中。
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLINHeader(int frameId)
{
long eventIndex;
testJoinLinHeaderEvent(frameId);
testJoinLinWakeupEvent();
testJoinLinSyncErrorEvent();
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1:
testStepPass("Validation", "LIN Header for FrameId=0x%X occurred", frameId);
break;
case 2:
testStepFail("Validation", "LIN Wakeup signal occurred");
break;
case 3:
testStepFail("Validation", "LIN Sync error occurred");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for any LIN event", eventIndex);
}
}
TestJoinLinHeaderEvent & TestJoinLinWakeupEvent
功能：加入待等待帧的帧头Header信息到当前事件中
aFrame：加入待等待帧的帧头
aFrameId：加入待等待帧的ID
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLINHeader(int frameId)
{
long eventIndex;
testJoinLinHeaderEvent(frameId);
testJoinLinWakeupEvent();
testJoinLinSyncErrorEvent();
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1:
testStepPass("Validation", "LIN Header for FrameId=0x%X occurred", frameId);
break;
case 2:
testStepFail("Validation", "LIN Wakeup signal occurred");
break;
case 3:
testStepFail("Validation", "LIN Sync error occurred");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for any LIN event", eventIndex);
}
}
TestJoinLinReceiveErrorEvent &TestJoinLinTransmErrorEvent
功能：加入待等待接收/传输帧的错误事件
aFrameId：待加入待等待接收/传输错误帧的ID
返回值：
-3：加入事件失败
-1：一般错误，例如，功能不可用
>0：已加入事件的编号
代码示例
testcase tcTFS_waitForLINResponse(int frameId)
{
long eventIndex;
testJoinMessageEvent(frameId);
testJoinLinReceiveErrorEvent(frameId);
testJoinLinCSErrorEvent(frameId);
testJoinLinTransmErrorEvent(frameId);
eventIndex = testWaitForAnyJoinedEvent(5000);
switch (eventIndex)
{
case 1: // valid frame
testStepPass("Validation", "IUT has responded correctly");
break;
case 2: // receive error
testStepFail("Validation", "IUT has responded with wrong number of data bytes");
break;
case 3: // checksum error
testStepFail("Validation", "IUT has responded with wrong checksum");
break;
case 4: // transmission error
testStepFail("Validation", "IUT has not responded");
break;
default:
testStepFail("Validation", "Internal error! Unexpected event (return code %d) on waiting for response", eventIndex);
}
}