USB转TCAN

USB转TCAN接口函数和数据类型定义，适用于泰矽微(Tinychip)芯片UART-CAN协议 更多...

结构体
struct	TCAN_CONFIG
	TCAN初始化结构体定义 更多...
struct	TCAN_MSG
	适用于Tinychip芯片的TCAN帧结构体定义 更多...

函数
int WINAPI	TCAN_Init (int DevHandle, unsigned char TCANIndex, TCAN_CONFIG *pConfig)
	初始化TCAN总线，使用TCAN功能时必须调用 更多...
int WINAPI	TCAN_MasterStartSch (int DevHandle, unsigned char TCANIndex, TCAN_MSG *pTCANMsg, unsigned int MsgLen, unsigned int SendTimes, unsigned char ReadBackFlag)
	执行TCAN帧调度表，可以使用该函数实现发送数据或者读取数据 更多...
int WINAPI	TCAN_MasterStopSch (int DevHandle, unsigned char TCANIndex)
	停止执行调度表 更多...
int WINAPI	TCAN_Stop (int DevHandle, unsigned char TCANIndex)
	停止TCAN总线，调用该函数后盖总线无法继续使用，需要继续使用需要重新调用 TCAN_Init 函数对总线进行初始化 更多...
int WINAPI	TCAN_GetMsg (int DevHandle, unsigned char TCANIndex, TCAN_MSG *pTCANMsg, int BufferSize)
	获取TCAN原始数据 更多...
void WINAPI	TCAN_MsgConvert (TCAN_MSG *pTCANMsg, UCAN_RAW_MSG *pUCANMsg, int MsgNum, uint8_t UCAN2TCAN)
	实现TCAN_MSG和UCAN_RAW_MSG消息互转 更多...
long long WINAPI	TCAN_GetStartTime (int DevHandle, unsigned char TCANIndex)
	获取CAN起始时间戳，该时间戳可以转换成实际的时间 更多...
int WINAPI	TCAN_ResetStartTime (int DevHandle, unsigned char TCANIndex)
	复位时间戳，复位后起始时间戳为当前时间 更多...
int WINAPI	TCAN_SetStartTime (int DevHandle, unsigned char TCANIndex, long long StartTimeMs)
	设置数据起始时间戳，主要用于将数据时间戳转换成实时时间用 更多...

包含应答标志
发送数据对方有正常应答标志
#define	TCAN_FLAG_ACK   0x04
	发送数据有正常应答

数据错误定义
数据包含的错误类型定义
#define	TCAN_EFLAG_DATA_ERR   0x01
	数据内容错误
#define	TCAN_EFLAG_PIDH_CKE   0x02
	PIDH数据校验错误
#define	TCAN_EFLAG_PIDL_CKE   0x04
	PIDL数据校验错误
#define	TCAN_EFLAG_CMD_CKE   0x08
	CMD数据校验错误
#define	TCAN_EFLAG_DATA_CKE   0x10
	数据校验CRC错误

函数返回错误值宏定义
函数调用出错后返回值定义
#define	TCAN_SUCCESS   (0)
	函数执行成功
#define	TCAN_ERR_NOT_SUPPORT   (-1)
	适配器不支持该函数
#define	TCAN_ERR_USB_WRITE_FAIL   (-2)
	USB写数据失败
#define	TCAN_ERR_USB_READ_FAIL   (-3)
	USB读数据失败
#define	TCAN_ERR_CMD_FAIL   (-4)
	命令执行失败
#define	TCAN_ERR_PARAMETER   (-5)
	参数错误

详细描述

USB转TCAN接口函数和数据类型定义，适用于泰矽微(Tinychip)芯片UART-CAN协议

函数说明

TCAN_Init()

int WINAPI TCAN_Init	(	int	DevHandle,
		unsigned char	TCANIndex,
		TCAN_CONFIG *	pConfig
	)

初始化TCAN总线，使用TCAN功能时必须调用

参数

	DevHandle	设备号，通过调用 USB_ScanDevice 获取
	TCANIndex	CAN通道号，0-CAN1，1-CAN2
[in]	pConfig	TCAN初始化相关参数，具体可以参考 TCAN_CONFIG

返回

函数执行状态

返回值

=0	函数执行成功
<0	函数调用失败

TCAN_MasterStartSch()

int WINAPI TCAN_MasterStartSch	(	int	DevHandle,
		unsigned char	TCANIndex,
		TCAN_MSG *	pTCANMsg,
		unsigned int	MsgLen,
		unsigned int	SendTimes,
		unsigned char	ReadBackFlag
	)

执行TCAN帧调度表，可以使用该函数实现发送数据或者读取数据

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
Index	TCAN通道号，0-CAN1，1-CAN2
pMsg	待发送的调度表帧数组
MsgLen	待发送的调度表帧数
SendTimes	调度表里面的帧数据循环发送次数，若设置为0xFFFFFFFF则会循环执行，直到调用 TCAN_MasterStopSch 函数为止
ReadBackFlag	回读调度表执行帧标志，0-不回读，1-底层会存储调度表发送的帧到数据缓冲区，通过调用 TCAN_GetMsg 函数可以获取到调度表发送的帧数据

返回

函数执行状态

返回值

0	函数调用成功
<0	函数调用失败

TCAN_MasterStopSch()

int WINAPI TCAN_MasterStopSch	(	int	DevHandle,
		unsigned char	TCANIndex
	)

停止执行调度表

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
Index	TCAN通道号，0-CAN1，1-CAN2

返回

函数执行状态

返回值

0	函数调用成功
<0	函数调用失败

TCAN_Stop()

int WINAPI TCAN_Stop	(	int	DevHandle,
		unsigned char	TCANIndex
	)

停止TCAN总线，调用该函数后盖总线无法继续使用，需要继续使用需要重新调用 TCAN_Init 函数对总线进行初始化

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
Index	TCAN通道号，0-CAN1，1-CAN2

返回

函数执行状态

返回值

0	函数调用成功
<0	函数调用失败

TCAN_GetMsg()

int WINAPI TCAN_GetMsg	(	int	DevHandle,
		unsigned char	TCANIndex,
		TCAN_MSG *	pTCANMsg,
		int	BufferSize
	)

获取TCAN原始数据

参数

	DevHandle	设备号，通过调用 USB_ScanDevice 获取
	TCANIndex	CAN通道号，0-CAN1，1-CAN2
[out]	pTCANRawMsg	存储TCAN消息数据缓冲区指针，若想单次获取较多的数据，可以把缓冲区设置大点
	BufferSize	TCAN消息缓冲区大小

返回

函数执行状态

返回值

=0	函数执行成功
<0	函数调用失败

TCAN_MsgConvert()

void WINAPI TCAN_MsgConvert	(	TCAN_MSG *	pTCANMsg,
		UCAN_RAW_MSG *	pUCANMsg,
		int	MsgNum,
		uint8_t	UCAN2TCAN
	)

实现TCAN_MSG和UCAN_RAW_MSG消息互转

参数

pTCANMsg	TCAN_MSG消息指针
pUCANMsg	UCAN_RAW_MSG消息指针
MsgNum	需要转换的消息数
UCAN2TCAN	转换类型，0-TCAN_MSG转UCAN_RAW_MSG，1-UCAN_RAW_MSG转TCAN_MSG

返回

无

TCAN_GetStartTime()

long long WINAPI TCAN_GetStartTime	(	int	DevHandle,
		unsigned char	TCANIndex
	)

获取CAN起始时间戳，该时间戳可以转换成实际的时间

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
TCANIndex	CAN通道号，0-CAN1，1-CAN2

返回

CAN起始时间戳

返回值

<0

函数调用失败

TCAN_ResetStartTime()

int WINAPI TCAN_ResetStartTime	(	int	DevHandle,
		unsigned char	TCANIndex
	)

复位时间戳，复位后起始时间戳为当前时间

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
TCANIndex	CAN通道号，0-CAN1，1-CAN2

返回

函数执行状态

返回值

<0

函数调用失败

TCAN_SetStartTime()

int WINAPI TCAN_SetStartTime	(	int	DevHandle,
		unsigned char	TCANIndex,
		long long	StartTimeMs
	)

设置数据起始时间戳，主要用于将数据时间戳转换成实时时间用

参数

DevHandle	设备号，通过调用 USB_ScanDevice 获取
TCANIndex	CAN通道号，0-CAN1，1-CAN2
StartTimeMs	开始记录数据的起始时间戳，该时间戳为实时时间戳

返回

函数执行状态

返回值

<0

函数调用失败