HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 HD CAN Module Programmer’s Guide (Windows) Page 1 of 25 Hatteland Display AS, Åmsosen, N-5578 Nedre Vats, Norway Tel: (+47) 4814 2200 - mail@hatteland-display.com - www.hatteland-display.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 INDEX INDEX .......................................................................................................................................... 2 Revision History ............................................................................................................................ 3 Abbreviation..............................................
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 Revision History Created Approved Rev Date By Date By Description 1 2013.08.18 Wei Jing 2013.09.25 Joakim Emanuelsson Preliminary Version HD CAN Library V1.0.216 2 2013.09.25 Wei Jing 2013-09-25 Joakim Emanuelsson HD CAN Library V1.0.224 CAN FW V1.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 1. Introduction Along with the Hatteland Display external CAN module, a library set is provided for customized development under Windows environment. It provides the full control of the target CAN module, such as Device Open/Close, Communication Module Connect/Disconnect, Message Send/Receive and Periodic Message send.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 2. Usage of CAN Library 2.1 Installation In order to install software for USB–CAN Gateway following steps should be performed: Run setup file named Hatteland_CAN_Driver_Setup-1.0.216.exe (common for operating systems listed in Chap 1), Select components to install (CAN Driver and API are obligatory, SWDL is optional), Finish the installation.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 3. Example Application /************************************************************************** **********//** * @file test_demo_CAN.cpp * @brief Demo application for HD CAN Module * @date 2013-09-24 * @copyright Hatteland Display AS *************************************************************************** ************/ #include "hdj2534Handler.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 /** @brief J2534 PassThru function numbers */ enum passThruFuncNum { NO_FUNCTION = 0, PASSTHRU_OPEN, PASSTHRU_CLOSE, PASSTHRU_CONNECT, PASSTHRU_DISCONNECT, PASSTHRU_READ_MSG, PASSTHRU_WRITE_MSG, PASSTHRU_START_PERIODIC_MSG, PASSTHRU_STOP_PERIODIC_MSG, PASSTHRU_START_MSG_FILTER, PASSTHRU_STOP_MSG_FILTER, PASSTHRU_SET_PROGRAMMING_VOLTAGE, PASSTHRU_READ_VE
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 PassThruGetStatus_t PassThruGetStatus; PassThruReset_t PassThruReset; _J2534_ERROR_CODE err; bool freeLib() { if (NULL != dllLib) { if (FreeLibrary(dllLib) == NULL) { return false; } dllLib = NULL; } return true; } bool loadLib() { #ifdef _WIN64 dllLib = LoadLibrary(TEXT("HDJ2534x64.dll")); #else dllLib = LoadLibrary(TEXT("HDJ2534x86.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 PassThruSetProgrammingVoltage = (PassThruSetProgrammingVoltage_t)GetProcAddress(dllLib,"PassThruSetProgramm ingVoltage"); PassThruReadVersion = (PassThruReadVersion_t)GetProcAddress(dllLib,"PassThruReadVersion"); PassThruGetStatus = (PassThruGetStatus_t)GetProcAddress(dllLib,"PassThruGetStatus"); PassThruReset = (PassThruReset_t)GetProcAddress(dllLib,"P
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 *************************************************************************** ************/ static void callPassThruConnect() { int baudSel; int protoSel; int chanSel; int devSel; int flagSel; unsigned long deviceIdToUse; unsigned long baudrate; unsigned long flags; //"Enter protocol (0-J1850VPW, 1-J1850PWM, 2-ISO9141, 3-ISO14230, 4CAN, 5-ISO15765, " // "
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 J2534_ERROR_CODE err; PASSTHRU_MSG *rxPassThruMsgPtr = rxPassThruMsg; J2534_RxStatus rxStatus; err = PassThruReadMsgs(channel_1, rxPassThruMsgPtr, msgNumPtr, timeout); if (err == STATUS_NOERROR) { if (msgNum != 0) { for (unsigned int i = 0; i < msgNum; i++) { id = rxPassThruMsg[i].Data[0] << 24; id |= rxPassThruMsg[i].
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 unsigned long msgNum = 1; unsigned long *msgNumPtr = &msgNum; unsigned int dlc = 1; J2534_ConnectFlags txFlags; unsigned long timeout = 0;; int addrSel; int chanSel; int msgPtrSel; int msgNumPtrSel; int protoSel; PASSTHRU_MSG *txPassThruMsgPtr = txPassThruMsg; //"Enter protocol (0-J1850VPW, 1-J1850PWM, 2-ISO9141, 3-ISO14230, 4CAN, 5-ISO15765, " // "6-SC
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 unsigned int maskId = 0; unsigned int pattId = 0; int msgPtrSel; PASSTHRU_MSG *filterMaskPassThruMsgPtr = &filterMaskPassThruMsg; PASSTHRU_MSG *filterPattPassThruMsgPtr = &filterPattPassThruMsg; J2534_ConnectFlags filterFlags; J2534_FILTER filterType; memset((void *)&filterMaskPassThruMsg, 0, sizeof filterMaskPassThruMsg); memset((void *)&filterPattPass
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 //Set Standard ID(0/Standard;1/Extended) filterFlags.bits.Can29BitId = 0; filterMaskPassThruMsg.TxFlags = filterFlags.value; filterFlags.bits.Can29BitId = 0; filterPattPassThruMsg.TxFlags = filterFlags.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 callPassThruConnect(); //Soft Reset the module callPassThruReset(); //Re-Open Device callPassThruOpen(); //Connect Channel_1 CAN 125000bps callPassThruConnect(); //Write a single message callPassThruWriteMsgs(); //Set Read Message filter 0 callPassThruStartMsgFilter(); //Read one single message callPassThruReadMsgs(); //Delete Read Message Filter 0 call
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 4. Appendix a) J2534_ERROR_CODE J2534::PassThruClose ( unsigned long DeviceID ) This function is used to close the connection to a Pass-Thru Device. All periodic messages will be stopped, filters will be cleared, and all pins will return to their default state (see Section 6.8). This function must be called before an application exits.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 c) J2534_ERROR_CODE J2534::PassThruDisconne ct unsigned ( long ChannelI D ) This function is used to terminate a logical connection with a protocol channel. If the function is successful, a value of STATUS_NOERROR is returned.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 f) J2534_ERROR_CODE J2534::PassThruIoctl ( unsigned long ChannelID, J2534_IOCTL IoctlID, void * pInput, void * pOutput ) This function is used to read and write all the protocol hardware and software configuration parameters. If the function is successful, a value of STATUS_NOERROR is returned.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 h) J2534_ERROR_CODE J2534::PassThruReadMsgs ( unsigned long channelID, PASSTHRU_MSG * pMsg, pNumMsgs unsigned long * , unsigned long timeout ) This function reads messages and indications from the receive buffer. All messages and indications shall be read in the order that they occurred on the bus.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 i) J2534_ERROR_CODE J2534::PassThruReadVersion unsigned ( long DeviceID, char * pFirmwareVer sion, char * pLibVersion, char * pApiVersion ) This function returns the version strings associated with the library. If the function is successful, a value of STATUS_NOERROR is returned.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS k) J2534_ERROR_CODE J2534::PassThruS tartMsgFilter DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 ( unsigned long ChannelI D, J2534_FILTER FilterType , PASSTHRU_MSG * pMaskMsg , PASSTHRU_MSG * pPattern Msg, PASSTHRU_M SG * pFlowControlMsg, unsigned long * pFilterID ) This function starts filtering of incoming messages. If the function is successful, a value of STATUS_NOERROR is returned.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 l) J2534_ERROR_CODE J2534::PassThruStartPer iodicMsg ( unsigned long ChannelID, PASSTHRU_MS G* pMsg, unsigned long * pMsgID, unsigned long TimeInterv al ) This function will immediately queue the specified message for transmission, and repeat at the specified interval.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 n) J2534_ERROR_CODE J2534::PassThruStopPeriodi cMsg unsigned ( long unsigned long ChannelI D, MsgID ) This function stops the specified periodic message. If the function is successful, a value of STATUS_NOERROR is returned. After this call the MsgID will be invalid. Parameters: [in] ChannelID The channel ID assigned by the PassThruConnect function.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 o) J2534_ERROR_CODE J2534::PassThruWriteMsg s ( unsigned long ChannelID, PASSTHRU_MS G* pMsg, unsigned long * pNumMsgs , unsigned long Timeout ) This function is used to send messages. The messages are placed in the buffer and sent in the order they were received.
HD CAN Module Programmer’s Guide (Windows) All intellectual properties belongs to Hatteland Display AS DOC101357-1_ - rev 2 – 2013-09-23 - Created by:6644 p) J2534_ERROR_CODE J2534::PassThruReset( void ) This function resets gateway. Parameters Returns Status, see function return codes in hdj2534.h. Page 25 of 25 Hatteland Display AS, Åmsosen, N-5578 Nedre Vats, Norway Tel: (+47) 4814 2200 - mail@hatteland-display.com - www.hatteland-display.
