測(cè)試軟件與接口函數(shù)使用手冊(cè)

測(cè)試軟件與接口函數(shù)使用 使用手 使用手CANTest通用測(cè)試軟件、CAN接口函數(shù)摘CAN總線測(cè)試的必備軟件。CAN接口函數(shù)修訂歷增加CANWIFICANtest新功增加新PCIe目測(cè)試軟件使用說 啟動(dòng) DBC與按ID分類顯 幀ID顯示方 幀ID顯示格 滾 接口函數(shù)庫(kù)說明及其使 接口庫(kù)函數(shù)使用方 VC調(diào)用動(dòng)態(tài)庫(kù)的方 VB調(diào)用動(dòng)態(tài)庫(kù)的方 USBCAN-I/II/I+/II+驅(qū)動(dòng)的安 PCI-9820驅(qū)動(dòng)的安 參考資 免責(zé).................................................................................................................CAN-bus通用測(cè)試軟件是一個(gè)專門用來對(duì)所有的ZLGCAN系列板卡進(jìn)試的軟件設(shè)備類型選在這個(gè)框中您可以選擇您要打開的設(shè)備索引號(hào)和CAN通道，以及設(shè)置CAN的初按鈕打開設(shè)備操作窗口并自動(dòng)打開設(shè)備和啟動(dòng)CAN通道。濾波設(shè)：在其中先選擇濾波模式，然后通過設(shè)定濾波器來設(shè)置需要過濾的CAN幀獲取設(shè)備信發(fā)送數(shù)送”按鈕就可以發(fā)送數(shù)據(jù)了（CAN：不同的CAN幀（最多可設(shè)置100幀，和每幀之間間隔、每批之間間隔：接收時(shí)間標(biāo)有智能CAN卡才有時(shí)間標(biāo)識(shí)；sDBC與按ID分類顯用戶點(diǎn)擊后，打開DBC界面，用戶可以導(dǎo)入需要的DBC文件進(jìn)行幀（的顯示，即“ID固定，數(shù)據(jù)變化”。有變化的數(shù)據(jù)段會(huì)標(biāo)紅。實(shí)時(shí)保存與停止保啟動(dòng)之前使能此功能，注意保存位置不能指C盤，可能無法保存。點(diǎn)擊停止保存時(shí)，總線利用錯(cuò)誤信息顯ID顯示方ID顯示格滾顯示幀接口卡設(shè)的函數(shù)庫(kù)說明，如果需要查看已經(jīng)停產(chǎn)型號(hào)函數(shù)說明，請(qǐng)參見V2.92版本。2.1PCI-5121（已經(jīng)停產(chǎn)1PCI-2USBCAN-3USBCAN-4PCI-5CAN232（已經(jīng)停產(chǎn)6PCI-5110（已經(jīng)停產(chǎn)7CANmini（已經(jīng)停產(chǎn)8ISA-9620（已經(jīng)停產(chǎn)9ISA-5420（已經(jīng)停產(chǎn)PC104-CAN（已經(jīng)停產(chǎn)PC104-CANET-100T/200T、CANET-UDPDN-PCI9810（已經(jīng)停產(chǎn)PCI-PC104-PC104-PCI-CANET-100T/200T的TCP工作PEC-9920（已經(jīng)停產(chǎn)PEC-PCIe-9220（已經(jīng)停產(chǎn)PCIE-PCI-5010-PCI-5010-USBCAN-E-USBCAN-E-USBCAN-2E-USBCAN-2E-PCI-5020-PCI-5020-EG20T-CAN（已經(jīng)停產(chǎn)PCIe-PCIE-CANWiFi-200TUDP工作方PCIe-PCIe-PCIe-PCIe-PCIe-PCIe-接口庫(kù)函CANCANCAN狀態(tài)結(jié)表格式幀過濾結(jié)構(gòu)CAN發(fā)送CAN復(fù)位讀某一路CAN初始化某一路CANET通訊結(jié)構(gòu)避免無數(shù)據(jù)時(shí)線程死等。避免客戶來操作中斷，導(dǎo)致CAN卡丟幀、PC死機(jī)或者藍(lán)屏。PC資源。發(fā)送返回實(shí)際成功的幀數(shù)。并且可以設(shè)置發(fā)送重試阻塞超時(shí)。默認(rèn)是1.5秒-4秒?？ê虲AN總線的狀態(tài)。分析后，制定正確的通訊策靈活的接口移植性。所有的致遠(yuǎn)電子CAN接口卡均使用同一套動(dòng)態(tài)庫(kù)，客戶可錯(cuò)誤碼定2.2值CAN錯(cuò)誤CAN控制器內(nèi)部CAN控制器CAN控制器消極錯(cuò)CAN控制器仲裁丟CAN控制器總線錯(cuò)CAN控制器總線關(guān)WCANET錯(cuò)誤 GetReferencesocket的連接時(shí)失敗,只發(fā)送了部分的幀數(shù)據(jù)發(fā)得太快，描VCI_BOARD_INFO結(jié)構(gòu)體包含ZLGCAN系列接口卡的設(shè)備信息。結(jié)構(gòu)體將在typedefstructtypedefstruct{USHORThw_Version;USHORTfw_Version;USHORTdr_Version;USHORTin_Version;USHORTirq_Num; }VCI_BOARD_INFO,成V1.00（描typedefstruct{UINT typedefstruct{UINT }VCI_CAN_OBJ,成設(shè)備接收到某一幀的時(shí)間標(biāo)識(shí)。只有智能卡才有時(shí)間標(biāo)示，如USBCAN系列與ID，=1受DataLen約束。如DataLen定義為3，即Data[0]、Data[1]、Data[2]是有效的。描typedefstruct{UCHARErrInterrupt; typedefstruct{UCHARErrInterrupt; }VCI_CAN_STATUS,成描VCI_ERR_INFO結(jié)構(gòu)體用于裝載VCI庫(kù)運(yùn)行時(shí)產(chǎn)生的錯(cuò)誤信息。結(jié)構(gòu)體將在typedefstructtypedefstruct{UINTBYTEArLost_ErrData;}VCI_ERR_INFO,成描typedefstruct{DWORDAccCode;DWORDAccMask; typedefstruct{DWORDAccCode;DWORDAccMask; }VCI_INIT_CONFIG,成碼。SJA1000的幀過濾碼。對(duì)接收的CAN幀ID進(jìn)行過濾，對(duì)應(yīng)位為0的是0（BTR01（BTR1，=1備CAN波特注意：當(dāng)設(shè)備類型為PCI-5010-U、PCI-5020-U、USBCAN-E-U、USBCAN-2E-U特率和幀過濾不在這里設(shè)置，具體操作見VCI_SetReference說明描typedefstruct{charszpwd[10];charszdesip[20];intdesport;BYTEblisten;}typedefstruct{charszpwd[10];charszdesip[20];intdesport;BYTEblisten;}成 12.18.0描當(dāng)設(shè)備類型為PCI-5010-U、PCI-5020-U、USBCAN-E-U、USBCAN-2E-U時(shí)，定義typedef_VCI_FILTER_RECORD{DWORDtypedef_VCI_FILTER_RECORD{DWORDStart;DWORDEnd;成接口庫(kù)函數(shù)說描 stdcallVCI_OpenDevice(DWORDDevType,DWORDDevIndex,參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。示#include#includeintnDeviceType= /*PCIe-9221intnDeviceInd=0; /*索引號(hào)0*/intn =0;DWORDdwRel=VCI_OpenDevice(nDeviceType,nDeviceInd,if(dwRel!={return}描DWORDDWORDstdcallVCI_CloseDevice(DWORDDevType,DWORD參#includeintnDeviceType=24; #includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0BOOLbRel;bRel=VCI_CloseDevice(nDeviceType,描此函數(shù)用以初始化指定的CANCAN通道時(shí)，需要多次調(diào)用（當(dāng)設(shè)備類DWORDstdcallVCI_InitCAN(DWORDDWORDstdcallVCI_InitCAN(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_INIT_CONFIGpInitConfig);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類初始化參數(shù)結(jié)構(gòu)，為一個(gè)VCI_INIT_CONFIG結(jié)構(gòu)體變量。（PCI-5010-U、PCI-5020-U、USBCAN-E-U、USBCAN-2E-U時(shí)，對(duì)濾波和波特率的2.3ACR0ACR1ACR2，對(duì)應(yīng)SJA1000中的四個(gè)寄存器AMR0AMR1AMR2AMR3，d0，詳見1，詳見AccCode與AccMask配置值請(qǐng)使用測(cè)試軟件CANtest中“濾波設(shè)置”來計(jì)算驗(yàn)收碼0x 即為AccCode值，碼0x 即為AccMask值。VCI_InitCAN的返回#includeintnDeviceType=24; #includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0;VCI_INIT_CONFIGDWORDdwRel=VCI_InitCAN(nDeviceType,nDeviceInd,nCANInd,&vic);if(dwRel==STATUS_ERR){VCI_CloseDevice(nDeviceType,returnFALSE;}描DWORDDWORDstdcallVCI_ReadBoardInfo(DWORDDevType,DWORDDevIndex,PVCI_BOARD_INFO參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。示#include#includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道VCI_BOARD_INFOvbi;DWORDdwRel=VCI_ReadBoardInfo(nDeviceType,nDeviceInd,nCANInd,描DWORDstdcallDWORDstdcallVCI_ReadErrInfo(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_ERR_INFOpErrInfo);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。VCI_OpenDevice，VCI_CloseDeviceVCI_ReadBoardInfo這些與特定的第幾路錯(cuò)誤碼的多種組合之一：(CANET相關(guān)錯(cuò)誤代碼，見2.3錯(cuò)誤碼定義)無無無無無無無無無無無無無無表示為執(zhí)行命令失敗錯(cuò)誤無無無CAN控制器內(nèi)部FIFO出無無CAN控制器無CAN控制器消極錯(cuò)無CAN控制器仲裁丟無無CAN控制器總線錯(cuò)備當(dāng)(PErrInfo->ErrCode&0x0004)==0x0004時(shí)，存在CAN控制器消極錯(cuò)位位00011011bit5=0bitbitbitbit0001100010ID.28-00110ID.20-0010000101IDE00111ID.17-01111ID.12-01110ID.4-011000110101001010110101001000CRC1100011001110111101010010100011011010011差1011111100]]當(dāng)(PErrInfo->ErrCode&0x0008)==0x0008時(shí)，存在CAN控制器仲裁丟失——————位43210000000000011000102000113001004001015001106001117010008010019仲裁丟失在識(shí)別碼的01010仲裁丟失在識(shí)別碼的010110110001101仲裁丟失在識(shí)別碼的01110仲裁丟失在識(shí)別碼的01111仲裁丟失在識(shí)別碼的10000仲裁丟失在識(shí)別碼的10001仲裁丟失在識(shí)別碼的10010仲裁丟失在識(shí)別碼的10011仲裁丟失在識(shí)別碼的10100仲裁丟失在識(shí)別碼的10101仲裁丟失在識(shí)別碼的10110仲裁丟失在識(shí)別碼的10111仲裁丟失在識(shí)別碼的11000仲裁丟失在識(shí)別碼的11001仲裁丟失在識(shí)別碼的11010仲裁丟失在識(shí)別碼的11011仲裁丟失在識(shí)別碼的11100仲裁丟失在識(shí)別碼的11101仲裁丟失在識(shí)別碼的11110仲裁丟失在識(shí)別碼的11111示#include#includeintnDeviceType=24; intnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道VCI_ERR_INFOvei;DWORDdwRel=VCI_ReadErrInfo(nDeviceType,nDeviceInd,nCANInd,描DWORDstdcallDWORDstdcallVCI_ReadCANStatus(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_CAN_STATUSpCANStatus);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類用來CAN狀態(tài)的VCI_CAN_STATUS結(jié)構(gòu)體指針。取錯(cuò)誤碼ERR_CMDFAILED）示#include#includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道VCI_INIT_CONFIGvic;VCI_CAN_STATUSDWORDdwRel=VCI_ReadCANStatus(nDeviceType,nDeviceInd,nCANInd,描DWORDstdcallVCI_GetReference(DWORDDevType,DWORDstdcallVCI_GetReference(DWORDDevType,DWORDDevIndex,DWORDCANIndex,DWORDRefType,PVOIDpData);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類備當(dāng)設(shè)備類型為CANET-UDP時(shí)0字符串首指針，用來存儲(chǔ)所讀取出來的CANET-UDP的IP地址CANET-UDPIP地址。例charszip[20];如果此函數(shù)調(diào)用成功,則在szip中返回CANET-UDP的地址1CANET-UDP的工作端口。例如：CANET-UDP的工作端DWORDport;如果此函數(shù)調(diào)用成功,則在port中返回CANET-UDP的工作端口當(dāng)設(shè)備類型為CANET-TCP時(shí)們的CANtestCANtest0所出來的CANET-TCPIP地（CANET工作在服務(wù)器模式時(shí)使用已經(jīng)連接上的CANET-TCPIP地址。例如：charszip[20];如果此函數(shù)調(diào)用成功,szip1儲(chǔ)讀取出來的工作在服務(wù)器模式CANET-TCP的工作端口。例如DWORDport;如果此函數(shù)調(diào)用成功,portCANET-2儲(chǔ)本機(jī)上的TCP工作端口（CANET在服務(wù)器和客戶端模DWORDport;如果此函數(shù)調(diào)用成功,則在port中返回本機(jī)上的工作4TCP工作戶端方式，1為服務(wù)器方式。例如：DWORDiType;54個(gè)字節(jié)，存儲(chǔ)連接到本機(jī)服務(wù)（當(dāng)CANET工作連接到本機(jī)上客戶端CANET-TCP數(shù)量。DWORDVCI_GetReference(6結(jié)構(gòu)，獲取接工作在客戶端模式cli.iIndex typedeftypedefstruct{intiIndex;HANDLEHANDLE; 示#include#includeintnDeviceType=12; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道charszip[20];DWORDdwRel=VCI_GetReference(nDeviceType,nDeviceInd,描此函數(shù)用以設(shè)置CANET與PCI-5010-U/PCI-5020-U/USBCAN-E-U/USBCAN-2E-U等DWORDDWORDstdcallVCI_SetReference(DWORDDevType,DWORDDevIndex,DWORDCANIndex,DWORDRefType,PVOIDpData);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類備 這個(gè)函數(shù)是用來針對(duì)各個(gè)不同設(shè)備的一些特定操作的。函數(shù)中PVOID型參數(shù)pData隨不同設(shè)備的不同操作而具有不同的當(dāng)設(shè)備類型為PCI-5010-U、PCI-5020-U、USBCAN-E-U、USBCAN-2E-U時(shí)0指向DWORDDWORD變量的值為寫入波特率寄存器BTR的值。戶應(yīng)咨詢致遠(yuǎn)電子CAN-bus技術(shù)支持工程 或者發(fā)送郵件到：，計(jì)算出合適的波值（注意：CAN網(wǎng)絡(luò)最大通訊波特率不應(yīng)該必須在調(diào)用VCI_InitCAN之前調(diào)用本函數(shù) ： ： ： ： ： ： ： ： ： ：1VCIFILTERRECORD填充CAN濾波器的濾波表格（每添加一條的幀接收過濾。應(yīng)該在調(diào)VCI_InitCAN置詳操作見光盤2NULL,可忽3NULL,可忽4指向DWORD類型的指針，該DWORD變量的值為發(fā)送的超時(shí)時(shí)間，單位為ms應(yīng)小于1500ms當(dāng)設(shè)備類型為CANET-UDP時(shí)0儲(chǔ)所指定操作的CANETE-UDPIPcharszip[20];1長(zhǎng)度為4所指定操作的CANET-UDP的工作端設(shè)置所要操作的CANET-UDP的工作端口DWORDport=5000;當(dāng)設(shè)備類型為CANET-TCP時(shí)0字符串首指0字符串首指針，用來設(shè)置所要操作的CANET-TCP的IP地址。例如所指定操作CANET-TCPIP（當(dāng)CANET工作在服務(wù)charszip[20];1DWORD工作在服務(wù)器模式時(shí)使2機(jī)上的TCP設(shè)置本機(jī)TCPDWORDport;4機(jī)的TCP工作模式。服務(wù)器模式則本機(jī)工作在客戶端模式，如果CANET-TCP工作在客戶端模式則本機(jī)工作在服務(wù)器模式。0為客戶端方式，1為服務(wù)器方式。DWORDiType=0;7結(jié)構(gòu)，刪除接（當(dāng)CANET工作在客戶端模cli.iIndex typedeftypedefstruct{intiIndex;HANDLE charszip[32];IP 示#include#includeintnDeviceType=12; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDport=4001; DWORDdwRel;dwRel=VCI_SetReference(nDeviceType,nDeviceInd,描DWORDstdcallVCI_StartCAN(DWORDDevType,DWORDDWORDstdcallVCI_StartCAN(DWORDDevType,DWORDDevIndex,DWORD參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN00，CAN11，以此類推。#includeintnDeviceType=#includeintnDeviceType= //PCIe-intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDdwRel;VCI_INIT_CONFIGdwRel=VCI_OpenDevice(nDeviceType,nDeviceInd,nif(dwRel!=STATUS_OK){return}dwRel=VCI_InitCAN(nDeviceType,nDeviceInd,nCANInd,&vic);if(dwRel==STATUS_ERR){VCI_CloseDevice(nDeviceType,returnFALSE;}dwRel=VCI_StartCAN(nDeviceType,nDeviceInd,nCANInd);if(dwRel==STATUS_ERR){VCI_CloseDevice(nDeviceType,returnFALSE;}描DWORDstdcallVCI_ResetCAN(DWORDDWORDstdcallVCI_ResetCAN(DWORDDevType,DWORDDevIndex,DWORD參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN00，CAN11，以此類推。新VCI_StartCAN才能使用）示#include#includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDdwRel;dwRel=VCI_ResetCAN(nDeviceType,nDeviceInd,描此函數(shù)用以獲取指定CAN通道的接收緩沖區(qū)中，接收到但尚未被的幀數(shù)量。主ULONGstdcallVCI_GetReceiveNum(DWORDDevType,ULONGstdcallVCI_GetReceiveNum(DWORDDevType,DWORDDevIndex,DWORD參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN00，CAN11，以此類推。#includeintnDeviceType=24; #includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDdwRel;dwRel=VCI_GetReceiveNum(nDeviceType,nDeviceInd,描DWORDstdcallDWORDstdcallVCI_ClearBuffer(DWORDDevType,DWORDDevIndex,DWORD參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN00，CAN11，以此類推。#includeintnDeviceType=24; #includeintnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDdwRel;dwRel=VCI_ClearBuffer(nDeviceType,nDeviceInd,描ULONGULONGstdcallVCI_Transmit(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_CAN_OBJpSend,ULONGLen);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類要發(fā)送的幀結(jié)構(gòu)體VCI_CAN_OBJ數(shù)組的首指針#include#include#include#includeintnDeviceType=intnDeviceInd=0;intnCANInd=0;DWORDdwRel;//PCIe-CAN0vco[0].ID= vco[0].SendType=vco[0].RemoteFlag=vco[0].ExternFlag=vco[0].DataLen=1;vco[0].Data[0]=0x66;vco[1].ID= vco[1].SendType=vco[1].RemoteFlag=vco[1].ExternFlag=vco[1].DataLen=1;vco[1].Data[0]=0x55;0為0為dwRelVCI_Transmit(nDeviceType,nDeviceIndnCANInd,vco,2);描ULONGstdcallVCI_Receive(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_CAN_OBJpReceive,ULONGLen,INTWaitTime=－1);ULONGstdcallVCI_Receive(DWORDDevType,DWORDDevIndex,DWORDCANIndex,PVCI_CAN_OBJpReceive,ULONGLen,INTWaitTime=－1);參那么后面插入的這個(gè)設(shè)備索引號(hào)就是1，以此類推。第幾路CAN。即對(duì)應(yīng)卡的CAN通道號(hào)，CAN0為0，CAN1為1，以此類生，請(qǐng)調(diào)用VCI_ReadErrInfo函數(shù)來獲取錯(cuò)誤碼。示#include<string.h>intnDeviceType=24; intnDeviceInd=0; //索引號(hào)0intnCANInd=0; //CAN0通道DWORDdwRel;VCI_CAN_OBJdwRel=VCI_Receive(nDeviceType,nDeviceInd,nCANInd,vco,100, 下。庫(kù)函數(shù)文件總共有三個(gè)文件：ControlCAN.hVC調(diào)用動(dòng)態(tài)庫(kù)的方在擴(kuò)展名為.CPP的文件中包含ControlCAN.h頭文件。如：#include“ControlCAN.h”在工程的連接器設(shè)置中連接到ControlCAN.lib添加ControlCAN.libVB調(diào)用動(dòng)態(tài)庫(kù)的方[Public|Private]D