目录

CanTpCopyDataReceived

CAPL 调用返回的错误代码及其含义

CanTpGetReceiverAddress

CanTpGetRecentAddressExtension

CanTpGetSenderAddress

代码示例

CanTpProvideTxData

代码示例

CanTpSetRxBufferSize

代码示例

---

CanTpCopyDataReceived

功能：通过回调函数，接收者可以使用该函数访问已经接收到的数据。 在某些应用中，需要访问已接收的数据，即接收方不必等待发送方发送完整的数据块。 通过回调函数，接收者可以使用此函数访问此数据，但仅限于发出回调指示的连接上的接收。

posFirstByte：应检索的已接收数据的第一个字节的索引，其中 0 表示数据的开始。

dataOut：目标缓冲区，即数据复制到的位置。

nrOfBytesToCopy：应复制到目标缓冲区的最大字节数。

返回值：

        >= 0：复制到目标缓冲区的字节数，受 nrOfBytesToCopy 和已接收的字节数限制。        

        -1：连接没有数据或接收到的字节数少于 posFirstByte。

CAPL 调用返回的错误代码及其含义

Code	Short Description
-19	没有这样的连接，即连接创建失败或给定的句柄未知。
-18	连接已知，但同时已关闭。
-17	该功能尚未实现。
-16	CAPL 函数接收到错误的参数。
-15	CAPL 函数只能从适当的回调函数中调用。
-14	无法为其所应用的寻址模式调用函数。
-13	这在回调函数中是不可能的。
-12	故障注入未激活。
0	好的，没有错误

CanTpGetReceiverAddress

功能：当接收到数据时，该函数返回实际使用的目标地址。

CanTpGetRecentAddressExtension

功能：当接收到数据时，该函数返回传输的地址扩展字节。

CanTpGetSenderAddress

功能：当接收到数据时，该函数返回实际使用的源地址。

功能：当接收到数据时，这些函数返回所使用的实际源地址和目标地址，或者传输的地址扩展字节。 如果接收节点可以与多个对等方通信、是网关或某些地址具有特殊含义（例如在功能诊断中），这尤其有用。

说明：

        a、连接的句柄不必指定，因为它是通过回调上下文隐式给出的。
        b、这些地址不适用于正常和混合（11 位）寻址模式连接。
        c、地址扩展仅适用于混合寻址模式连接。

代码示例

        如果收到的数据针对功能地址，则不响应。 否则在物理连接上发送诊断失败原语。

CanTp_ReceptionInd( long handle, byte data[])
{
  if(CanTpGetReceiverAddress() >= 0xF0)
    return; // 不回复功能请求
  SendNegativeResponse(CanTpGetSenderAddress(), data[0]);
}
void SendNegativeResponse( long target, dword serviceId)
{
  byte negativeResponse[3] = { 0x7F, 0, 0x12 };
  negativeResponse[1] = serviceId;
  CanTpSetTargetAddress( gPhysicalConn, target);
  CanTpSendData( gPhysicalConn, negativeResponse, 3);
}

CanTpProvideTxData

形式 1：在使用不完整的数据开始传输后，一旦该数据可用，就必须提供该数据。 在正在进行的传输的回调指示的上下文中，不必给出连接句柄。

形式 2：一旦必须填写相应的连续帧，就会发送通过此功能提供的数据。 DLL 当前可能正在等待连接发送数据； 在这种情况下，会立即发送连续帧。

connHandle：数据的目的连接句柄；从 CanTpSmallBufferSend 开始。

data：保存数据的缓冲区。

offsetInData：添加到发送数据的第一个字节不必位于缓冲区的开头；该参数指示第一个字节的位置。

lengthThisSendData：从数据缓冲区复制到发送缓冲区（从偏移量开始）的字节数。

代码示例

每次创建诊断故障代码 (DTC) 时，都会将其添加到发送缓冲区并转发到当前正在传输的连接。

void ProvideNextDTC( WORD DTC, BYTE status)
{
  BYTE sListOfDTC[1000]; // static list of DTC
  WORD sNextDTC = 0; // static start position
  sListOfDTC[sNextDTC ] = (BYTE) (DTC >> 8);
  sListOfDTC[sNextDTC + 1] = (BYTE) DTC;
  sListOfDTC[sNextDTC + 2] = status;
  CanTpProvideTxData(gResponseHandle, sListOfDTC, sNextDTC, 3);
  sNextDTC += 3;
}

CanTpSetRxBufferSize

形式1：在接收数据的回调指示期间，可以限制接收缓冲区的大小以引起、停止或修改对回调 CanTp_RxBufferFullInd 的调用。

形式2：该函数将连接的接收缓冲区限制为给定的字节数。 每次缓冲区满时，都会调用回调函数CanTp_RxBufferFullInd。

代码示例

在第一帧的指示回调中，根据第一个数据字节限制接收器缓冲区。

void CanTp_FirstFrameInd( long connHandle, dword length)
{
  BYTE data[1];
  CanTpCopyDataReceived( 0, data, 1);
  if( data[0] == 0x77)
    CanTpSetRxBufferSize( 10);  // buffer full callback
                                // every 10 byte
}


//将接收缓冲区限制为 20 字节
CanTpSetRxBufferSize( connHandle, 20);