From cd29bb84b9fc56236a78c4e400ac35d0d93280e2 Mon Sep 17 00:00:00 2001 From: Frank Voorburg Date: Wed, 23 Aug 2017 14:01:48 +0000 Subject: [PATCH] Refs #316. Added Kvaser Leaf Light v2 CAN interface support to LibOpenBLT. git-svn-id: https://svn.code.sf.net/p/openblt/code/trunk@352 5dc33758-31d5-4daf-9ae8-b24bf3d40d73 --- Host/BootCommander.exe | Bin 123392 -> 152064 bytes .../port/windows/canif/kvaser/canevt.h | 249 + .../port/windows/canif/kvaser/canlib.h | 5488 +++++++++++++++++ .../port/windows/canif/kvaser/canstat.h | 497 ++ .../port/windows/canif/kvaser/leaflight.c | 995 ++- .../port/windows/canif/kvaser/obsolete.h | 304 + .../port/windows/canif/kvaser/predef.h | 103 + .../port/windows/canif/peak/pcanusb.c | 34 +- Host/libopenblt.dll | Bin 114688 -> 130048 bytes 9 files changed, 7647 insertions(+), 23 deletions(-) create mode 100644 Host/Source/LibOpenBLT/port/windows/canif/kvaser/canevt.h create mode 100644 Host/Source/LibOpenBLT/port/windows/canif/kvaser/canlib.h create mode 100644 Host/Source/LibOpenBLT/port/windows/canif/kvaser/canstat.h create mode 100644 Host/Source/LibOpenBLT/port/windows/canif/kvaser/obsolete.h create mode 100644 Host/Source/LibOpenBLT/port/windows/canif/kvaser/predef.h diff --git a/Host/BootCommander.exe b/Host/BootCommander.exe index 7fed9a2ea5bec191a5dcff4f52cecc5044fa510a..a4ba9e0d166e96df3bb7cf4f7e2640cfa30c4ce1 100644 GIT binary patch literal 152064 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%0DA;Gew@4{0xS+E4J3Vob^K4btEp+-WL?fAAQ5 z)i+JQz*}o(ZVjo8Fe}VDcngVW?*s#JfS?L?5k3!A|c}s zsOGEQfutXRly_G5P)DGjF$S&gRp+Z8Qa`0$u6_}1{{j5u@6~6}@?o0x8V-J&R%6se zYNEjhaq!_XHEzvh%?!=`u<}db&8^pL*6h&i(;U)#uQ{)|N~_f-X-8?tLEAP0Z)hRo z3v|z;?Z4BtLI1+2Pp7?$d(g`B_0Q{H(r<*l-;P%PMt=hOR%U2x7-UE^j4>1#78>3) zG&A-<593+mYWR5Dje8)yCym`E>+sOLxHj&oJL_o@ZVJ-MiBKx_P5{3%sa( z<}c0PLe9@Y(wkUXS~^)+OLt3Oiw-@QSW7&5G2<-)Glq*^*Z-6f7rPRS^AFF&wxmdYO`GWFI<@?Hy zm3v`Pe^Rzo#i)|eH%)_nxKmY(p44NiMXDE7zo;6io2gr?Zv@9E)H?NGbs~CIuc$Yv zw}D%}fS&kS{j0i}=4x06zh;_dCV1m1=!%y$uW7c?o@qEd7M<3j9R|M0(Au^6+9K@( z+E1WCj%t6?Ce#2{qjp%iL z2#x=l;Y)bOCm{VzjIE6Aj5izm8l%xWOEHcyTG20Xz@knz-etVoxCZ@$9mb~c4Wmu* zrWDf{)7_@~O^=wKFg=H!(t6WI(+>EC$4oz)enX%2dh}XvG4p1v*Lx`` z^q9@yi(3^5iWJz5bXW~1wHYOf`HF*z?#kXulk!33K5#&os=cZ!bVamk2x1gd5S=Jh z%|V3XX&RmQO!bqBRgY5(>H_t1>J91;jY5;F`52O~*WL#o|B$u=wEtAJ)?2!hx?A*0 zy$A7w!}_*{n+#@y%|Lq7(+s7CIfj*nwT8`xXtY(TaRMR;xsY(;zjraIO|#7po1XyA z8zF_e5j8kxZUVhK!Q!_(46poISl!p)ZEk_qJpga>tc3&*x&e35-|WQ2B5pL6%Y)bX zAon74Z5eRhkC@RJPR2LkJ&>wWei2aJz;A^Y)>3}8Tq`%j^4jEf>a$OmKQ3Q_n9xV^ zJ@NzcU*yCmwJD}5_Q9t9tdJ>NBHp7wyk{hOMfWP-RvuEup`T|%G-rxxhH9>AfocUb zY;*XaQ`NtyTLYoHH1}y9hOT^C^PJ|aW}|kic93qEu0S_kcc1P--J`lEb&FvoSHVuM z2Xb3=@9TEy_UTAGg7gy4>i(dSnKt?k)L!<~M*vy9K2jg6k3)ZHlztqIS-ADN`YGr= z&Ct(+$MiTX=u)a(*TRZ2kut^z_oNZuM%hl)Q9a&lgZ6Wn-SBGi%u~z-=4sG^_nBv# z=OR|~1bBV1`C0Sx=2d3glptfG@wJv)4=gvKhrFHJ39EIMJI^tEBR-68fk@3Jpt+sj z30<{^-_I}BJga$Lvr4mCV?)0cH;)%@E&d2Y^?)6qz`svinc&IO*=!oTE7;tfIa$ChzGPoJV0werUf#l U1-^W+0r-+W5&{weS0Doa2j1xr8UO$Q delta 31154 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 diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canevt.h b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canevt.h new file mode 100644 index 00000000..cd151915 --- /dev/null +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canevt.h @@ -0,0 +1,249 @@ +/* +** Copyright 1999 by KVASER AB +** P.O Box 4076 SE-51104 KINNAHULT, SWEDEN +** E-mail: staff@kvaser.se WWW: http://www.kvaser.se +** +** This software is furnished under a license and may be used and copied +** only in accordance with the terms of such license. +** +** +** Description: +** +** +** +** +** +** +** +** DO NOT USE THIS FILE. THE DATA STRUCTURES AND CONSTANTS HERE ARE +** NOT YET IMPLEMENTED AND WILL CHANGE IN A FUTURE RELEASE. +** +** +** +** +** +** +** +** +** +** +*/ +#ifndef _CANEVT_H_ +#define _CANEVT_H_ + +#include + +#define CANEVT_NO_COMMAND 0 + + // Events +#define CANEVT_RECEIVE_MSG 1 +#define CANEVT_STATISTIC_STD 2 +#define CANEVT_STATISTIC_EXT 3 +#define CANEVT_CHIP_STATE 4 +#define CANEVT_CLOCK_OVERFLOW 5 +#define CANEVT_TRIGGER 6 +#define CANEVT_ERROR 7 +#define CANEVT_TIMER 8 +#define CANEVT_TRANSCEIVER 9 + + // Commands +#define CANEVT_TRANSMIT_MSG 10 +#define CANEVT_SET_TIMER 11 +#define CANEVT_RESET_CLOCK 12 +#define CANEVT_INIT_CHIP 13 +#define CANEVT_START_CHIP 14 +#define CANEVT_STOP_CHIP 15 +#define CANEVT_RESET_CHIP 16 +#define CANEVT_SET_ACCEPTANCE 17 +//#define CANEVT_SET_DRIVERMODE 18 +#define CANEVT_GET_STATISTIC 19 +#define CANEVT_GET_CHIP_STATE 20 +#define CANEVT_SET_OUTPUT_MODE 21 +#define CANEVT_FUNCTION 22 +#define CANEVT_GET_TRANSCEIVER 23 +#define CANEVT_GET_TRANSCEIVER_RESP 24 +#define CANEVT_SET_TRANSCEIVER 25 +// 26, 27, 28 reserved +#define CANEVT_INIT_HARDWARE 29 +#define CANEVT_EXIT_HARDWARE 30 +#define CANEVT_READ_CLOCK 31 + + +#define MAX_MSG_LEN 8 +#define EXT_MSG 0x80000000 // signs an extended identifier + +#define MSGFLAG_ERROR_FRAME 0x01 // Msg is a bus error +#define MSGFLAG_OVERRUN 0x02 // Msgs following this has been lost +#define MSGFLAG_NERR 0x04 // NERR active during this msg +#define MSGFLAG_WAKEUP 0x08 // Msg rcv'd in wakeup mode +#define MSGFLAG_REMOTE_FRAME 0x10 // Msg is a remote frame +#define MSGFLAG_RESERVED_1 0x20 // Reserved for future usage +#define MSGFLAG_TX 0x40 // TX acknowledge +#define MSGFLAG_TXRQ 0x80 // TX request + +typedef struct { + unsigned long id; + unsigned char flags; + unsigned char dlc; + unsigned char data[MAX_MSG_LEN]; +} CanEventMessage; + + +#define CHIPSTAT_BUSOFF 0x01 +#define CHIPSTAT_ERROR_PASSIVE 0x02 +#define CHIPSTAT_ERROR_WARNING 0x04 +#define CHIPSTAT_ERROR_ACTIVE 0x08 + +typedef struct { + unsigned char busStatus; + unsigned char txErrorCounter; + unsigned char rxErrorCounter; +} CanEventChipState; + +typedef struct { + unsigned long stdData; + unsigned long stdRemote; + unsigned long errFrame; + unsigned short busLoad; // 0.00-100.00% +} CanEventStatisticsStd; + +typedef struct { + unsigned long extData; + unsigned long extRemote; + unsigned long ovrFrame; +} CanEventStatisticsExt; + +typedef struct { + unsigned char code; // qqq +} CanEventErrorCode; + +//------------------------------------------------------------------------------ +// commands +//------------------------------------------------------------------------------ + +typedef struct { + unsigned long code; + unsigned long mask; +} CanEventAcceptanceFilter; + +typedef struct { + unsigned char mode; +} CanEventDriverMode; + +typedef struct { + unsigned long rate; +} CanEventSetTimer; + +typedef struct { + unsigned char level; +} CanEventSetDebugLevel; + +#define OUTPUT_MODE_SILENT 0 +#define OUTPUT_MODE_NORMAL 1 + +typedef struct { + unsigned char mode; +} CanEventSetOutputMode; + +typedef struct { + unsigned char code; +} CanEventFunction; + +// The following definitions are copied from lapcmds.h !! +#if 0 +#define TRANSCEIVER_EVENT_ERROR 1 +#define TRANSCEIVER_EVENT_CHANGED 2 + +// event +#define TRANSCEIVER_EVENT_NONE 0 +#define TRANSCEIVER_EVENT_NERR 1 +#define TRANSCEIVER_EVENT_REMOVED 2 +#define TRANSCEIVER_EVENT_DETECTED 3 + +// type +#define TRANSCEIVER_TYPE_NONE 0 +#define TRANSCEIVER_TYPE_251 1 +#define TRANSCEIVER_TYPE_252 2 +#define TRANSCEIVER_TYPE_DNOPTO 3 +#define TRANSCEIVER_TYPE_W210 4 +#define TRANSCEIVER_TYPE_SWC_PROTO 5 // Prototype. Driver may latch-up. +#define TRANSCEIVER_TYPE_SWC 6 + + +// lineMode +#define TRANSCEIVER_LINEMODE_NA 0 +#define TRANSCEIVER_LINEMODE_TWO_LINE 1 +#define TRANSCEIVER_LINEMODE_CAN_H 2 +#define TRANSCEIVER_LINEMODE_CAN_L 3 +#define TRANSCEIVER_LINEMODE_SWC_SLEEP 4 // SWC Sleep Mode. +#define TRANSCEIVER_LINEMODE_SWC_NORMAL 5 // SWC Normal Mode. +#define TRANSCEIVER_LINEMODE_SWC_FAST 6 // SWC High-Speed Mode. +#define TRANSCEIVER_LINEMODE_SWC_WAKEUP 7 // SWC Wakeup Mode. +#define TRANSCEIVER_LINEMODE_SLEEP 8 +#define TRANSCEIVER_LINEMODE_NORMAL 9 +#define TRANSCEIVER_LINEMODE_STDBY 10 // Standby for those who support it +#define TRANSCEIVER_LINEMODE_TT_CAN_H 11 // Truck & Trailer: operating mode single wire using CAN high +#define TRANSCEIVER_LINEMODE_TT_CAN_L 12 // Truck & Trailer: operating mode single wire using CAN low +#define TRANSCEIVER_LINEMODE_OEM1 13 // Reserved for OEM apps +#define TRANSCEIVER_LINEMODE_OEM2 14 // Reserved for OEM apps +#define TRANSCEIVER_LINEMODE_OEM3 15 // Reserved for OEM apps +#define TRANSCEIVER_LINEMODE_OEM4 16 // Reserved for OEM apps + + +// resNet +#define TRANSCEIVER_RESNET_NA 0 +#define TRANSCEIVER_RESNET_MASTER 1 +#define TRANSCEIVER_RESNET_MASTER_STBY 2 +#define TRANSCEIVER_RESNET_SLAVE 3 + +#endif + +typedef struct { + unsigned char event; // TRANSCEIVER_EVENT_xxx +} CanEventTransceiver; + +typedef struct { + unsigned char type; // TRANSCEIVER_TYPE_xxx + unsigned char lineMode; // TRANSCEIVER_LINEMODE_xxx + unsigned char resNet; // TRANSCEIVER_RESNET_xxx +} CanEventGetTransceiverResponse; + +typedef struct { + unsigned char type; // TRANSCEIVER_TYPE_xxx + unsigned char lineMode; // TRANSCEIVER_LINEMODE_xxx + unsigned char resNet; // TRANSCEIVER_RESNET_xxx +} CanEventSetTransceiver; + + +typedef union { + CanEventMessage canEventMessage; + CanEventChipState canEventChipState; + CanEventStatisticsStd canEventStatisticsStd; + CanEventStatisticsExt canEventStatisticsExt; + CanEventErrorCode canEventErrorCode; + CanEventAcceptanceFilter canEventAcceptanceFilter; + CanEventDriverMode canEventDriverMode; + CanEventSetTimer canEventSetTimer; + CanEventSetDebugLevel canEventSetDebugLevel; + CanEventSetOutputMode canEventSetOutputMode; + CanEventFunction canEventFunction; + CanEventTransceiver canEventTransceiver; + CanEventGetTransceiverResponse canEventGetTransceiverResponse; + CanEventSetTransceiver canEventSetTransceiver; +} CanEventUnion; + + +typedef struct { + unsigned char tag; + unsigned char chanIndex; + unsigned char _internal1; + unsigned char _internal2; + unsigned long timeStamp; + CanEventUnion x; +} CanEvent, *PCanEvent; + + +#include + +#endif + diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canlib.h b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canlib.h new file mode 100644 index 00000000..329b8dcc --- /dev/null +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canlib.h @@ -0,0 +1,5488 @@ +/** + * \section LICENSE + * Copyright 1994-2015 by KVASER AB, SWEDEN + * + * WWW: http://www.kvaser.com + * + * This software is furnished under a license and may be used and copied + * only in accordance with the terms of such license. + * + * \section DESCRIPTION + * + * Definitions for the CANLIB API. + * + * \file canlib.h + * \author Kvaser AB + * + * \note MATLAB users on Windows: if you define WIN32_LEAN_AND_MEAN before + * including this file, you will see a lot less warnings. + * + * \defgroup General General + * \defgroup CAN CAN + * \defgroup ObjectBuffers Object buffers + * \win_start + * \defgroup TimeDomainHandling Time Domain Handling + * \defgroup NamedParameterSettings Named Parameter Settings + * \defgroup tScript t-script + * \win_end + */ + +#ifndef _CANLIB_H_ +#define _CANLIB_H_ + +#include +# include +# include "predef.h" +# include "canevt.h" +# define CANLIB_DECLARE_ALL +#include "canstat.h" + +/** Handle to an opened circuit. */ +typedef int canHandle; + +# define canINVALID_HANDLE (-1) + +/** Handle to an opened circuit, created with \ref canOpenChannel(). */ +# define CanHandle int +/** Denotes an invalid circuit handle. */ + +/** Notify message sent to the application window */ +# define WM__CANLIB (WM_USER+16354) + +/** + * \name canOPEN_xxx + * \anchor canOPEN_xxx + * + * These defines are used in \ref canOpenChannel(). + * + * @{ + */ + + +/** + * Don't allow sharing of this circuit between applications. + * + * This define is used in \ref canOpenChannel() + */ +#define canOPEN_EXCLUSIVE 0x0008 + +/** + * This flag causes two things to happen: + * + * \li The call will fail if the specified circuit doesn't allow extended CAN + * (CAN 2.0B). + * + * \li If no frame-type flag is specified in a call to \ref canWrite, it is assumed + * that extended CAN should be used. + * + * This define is used in \ref canOpenChannel(). + */ +#define canOPEN_REQUIRE_EXTENDED 0x0010 + +/** + * Allow opening of virtual channels as well as physical channels. + * + * This define is used in \ref canOpenChannel(). + * + * \sa \ref page_user_guide_virtual_info + */ +# define canOPEN_ACCEPT_VIRTUAL 0x0020 + +/** + * Open the channel even if it is opened for exclusive + * access already. + * + * \warning Use this flag with caution. + * + * This define is used in \ref canOpenChannel(). + */ +# define canOPEN_OVERRIDE_EXCLUSIVE 0x0040 + +/** + * Fail the call if the channel cannot be opened with init access. + * + * Init access means that the thread that owns the handle can set bit rate and + * CAN driver mode. Init access is the default. At most one thread can have + * init access to any given channel. If you try to set the bit rate or CAN + * driver mode for a handle to which you don't have init access, the call will + * silently fail (i.e. \ref canOK is returned although the call had no effect), + * unless you enable "access error reporting" by calling \ref canIoCtl(). Access + * error reporting is by default off. + * + * This define is used in \ref canOpenChannel(). + * + * \sa \ref canOPEN_NO_INIT_ACCESS + */ +# define canOPEN_REQUIRE_INIT_ACCESS 0x0080 + +/** + * Don't open the handle with init access. + * + * This define is used in \ref canOpenChannel(). + * + * \sa \ref canOPEN_REQUIRE_INIT_ACCESS + */ +# define canOPEN_NO_INIT_ACCESS 0x0100 + +/** + * The channel will accept messages with DLC (Data Length Code) greater than + * 8. If this flag is not used, a message with DLC > 8 will always be + * reported or transmitted as a message with DLC = 8. If the + * \ref canOPEN_ACCEPT_LARGE_DLC flag is used, the message will be sent and/or + * received with the true DLC, which can be at most 15. + * + * \note The length of the message is always at most 8. + * + * This define is used in \ref canOpenChannel(). + */ +# define canOPEN_ACCEPT_LARGE_DLC 0x0200 // DLC can be greater than 8 + +/** + * The channel will use the CAN FD protocol, ISO compliant. This also means that messages with + * \ref canFDMSG_xxx flags can now be used. + * + * This define is used in \ref canOpenChannel(). + */ +# define canOPEN_CAN_FD 0x0400 + +/** + * The channel will use the CAN FD NON-ISO protocol. + * Use this if you want to configure the can controller to be able to communicate with + * a can controller designed prior to the release of the CAN FD ISO specification. + * + * Non ISO mode implies: + * \li The stuff bit counter will not be included in the frame format. + * \li Initial value for CRC17 and CRC21 will be zero. + * + * This also means that messages with \ref canFDMSG_xxx flags can now be used. + * + * This define is used in \ref canOpenChannel(). + */ +# define canOPEN_CAN_FD_NONISO 0x0800 +/** @} */ + +/** + * \ingroup CAN + * \name canFILTER_xxx + * \anchor canFILTER_xxx + * + * Flags for \ref canAccept(). + * + * @{ + */ +#define canFILTER_ACCEPT 1 +#define canFILTER_REJECT 2 +/** Sets the code for standard (11-bit) identifiers. */ +#define canFILTER_SET_CODE_STD 3 +/** Sets the mask for standard (11-bit) identifiers. */ +#define canFILTER_SET_MASK_STD 4 +/** Sets the code for extended (29-bit) identifiers. */ +#define canFILTER_SET_CODE_EXT 5 +/** Sets the mask for extended (29-bit) identifiers. */ +#define canFILTER_SET_MASK_EXT 6 + +#define canFILTER_NULL_MASK 0L +/** @} */ + + +/** + * \ingroup CAN + * \name canDRIVER_xxx + * \anchor canDRIVER_xxx + * + * CAN driver types - not all are supported on all cards. + * + * @{ + */ + +/** + * The "normal" driver type (push-pull). This is the default. + */ +#define canDRIVER_NORMAL 4 + +/** + * Sets the CAN controller in Silent Mode; that is, it doesn't send anything, + * not even ACK bits, on the bus. Reception works as usual. + * + * \note The values 2,3,5,6,7 are reserved values for compatibility reasons. + */ +#define canDRIVER_SILENT 1 + +/** + * Self-reception. Not implemented. + */ +#define canDRIVER_SELFRECEPTION 8 + +/** + * The driver is turned off. Not implemented in all types of hardware. + */ +#define canDRIVER_OFF 0 + +/** @} */ + + +/** + * \ingroup CAN + * \anchor BAUD_xxx + * \anchor canBITRATE_xxx + * \anchor canFD_BITRATE_xxx + * \name canBITRATE_xxx + * + * Common bus speeds. Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). + * The values are translated in canlib, \ref canTranslateBaud(). + * + * \note The \ref BAUD_xxx names are only retained for compability. + * + * \sa \ref page_user_guide_misc_bitrate + * + * @{ + */ + + +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 1 Mbit/s. */ +#define canBITRATE_1M (-1) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 500 kbit/s. */ +#define canBITRATE_500K (-2) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 250 kbit/s. */ +#define canBITRATE_250K (-3) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 125 kbit/s. */ +#define canBITRATE_125K (-4) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 100 kbit/s. */ +#define canBITRATE_100K (-5) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 62 kbit/s. */ +#define canBITRATE_62K (-6) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 50 kbit/s. */ +#define canBITRATE_50K (-7) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 83 kbit/s. */ +#define canBITRATE_83K (-8) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsC200(). Indicate a bitrate of 10 kbit/s. */ +#define canBITRATE_10K (-9) + +// CAN FD Bit Rates +/** Used in \ref canSetBusParams() and \ref canSetBusParamsFd() when using the + CAN FD protocol. Indicates a bitrate of 0.5 Mbit/s and sampling point at + 80%. */ +#define canFD_BITRATE_500K_80P (-1000) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsFd() when using the + CAN FD protocol. Indicates a bitrate of 1.0 Mbit/s and sampling point at + 80%. */ +#define canFD_BITRATE_1M_80P (-1001) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsFd() when using the + CAN FD protocol. Indicates a bitrate of 2.0 Mbit/s and sampling point at + 80%. */ +#define canFD_BITRATE_2M_80P (-1002) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsFd() when using the + CAN FD protocol. Indicates a bitrate of 4.0 Mbit/s and sampling point at + 80%. */ +#define canFD_BITRATE_4M_80P (-1003) +/** Used in \ref canSetBusParams() and \ref canSetBusParamsFd() when using the + CAN FD protocol. Indicates a bitrate of 8.0 Mbit/s and sampling point at + 60%. */ +#define canFD_BITRATE_8M_60P (-1004) + +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_1M instead. */ +#define BAUD_1M (-1) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_500K instead. */ +#define BAUD_500K (-2) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_250K instead. */ +#define BAUD_250K (-3) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_125K instead. */ +#define BAUD_125K (-4) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_100K instead. */ +#define BAUD_100K (-5) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_62K instead. */ +#define BAUD_62K (-6) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_50K instead. */ +#define BAUD_50K (-7) +/** The \ref BAUD_xxx names are deprecated, use \ref canBITRATE_83K instead. */ +#define BAUD_83K (-8) +/** @} */ + + +// +// Define CANLIBAPI unless it's done already. +// (canlib.c provides its own definitions of CANLIBAPI, DLLIMPORT +// and DLLEXPORT before including this file.) +// +#ifndef CANLIBAPI +# define CANLIBAPI __stdcall +# define DLLIMPORT __declspec(dllimport) +# define DLLEXPORT __declspec(dllexport) +#endif + + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \ingroup General + * + * \source_cs static void canInitializeLibrary(void); + * + * \source_delphi procedure canInitializeLibrary; + * \source_end + * This function must be called before any other functions is used. It will + * initialize the driver. + * + * You may call \ref canInitializeLibrary() more than once. The actual + * initialization will take place only once. + * + * Any errors encountered during library initialization will be "silent" and an + * appropriate \ref canERR_xxx error code will be returned later on when + * \ref canOpenChannel() (or any other API call that requires initialization) is + * called. + * + * \sa \ref page_code_snippets_examples + * + */ +void CANLIBAPI canInitializeLibrary (void); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canClose(int handle); + * + * \source_delphi function canClose(handle: canHandle): canStatus; + * \source_end + * + * Closes the channel associated with the handle. If no other threads + * are using the CAN circuit, it is taken off bus. The handle can not be + * used for further references to the channel, so any variable containing + * it should be zeroed. + * + * \ref canClose() will almost always return \ref canOK; the specified handle is closed + * on an best-effort basis. + * + * \param[in] hnd An open handle to a CAN channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref canOpenChannel(), \ref canBusOn(), \ref canBusOff() + */ +canStatus CANLIBAPI canClose (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canBusOn(int handle); + * + * \source_delphi function canBusOn(handle: canHandle): canStatus; + * \source_end + * + * Takes the specified channel on-bus. + * + * If you are using multiple handles to the same physical channel, for example + * if you are writing a threaded application, you must call \ref canBusOn() once for + * each handle. The same applies to \ref canBusOff() - the physical channel will not + * go off bus until the last handle to the channel goes off bus. + * + * \param[in] hnd An open handle to a CAN channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref canBusOff(), \ref canResetBus() + * + */ +canStatus CANLIBAPI canBusOn (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canBusOff(int handle); + * + * \source_delphi function canBusOff(handle: canHandle): canStatus; + * \source_end + * + * Takes the specified channel off-bus. + * + * \param[in] hnd An open handle to a CAN channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref canBusOn(), \ref canResetBus() + * + */ +canStatus CANLIBAPI canBusOff (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetBusParams(int handle, int freq, int tseg1, int tseg2, int sjw, int noSamp, int syncmode); + * + * \source_delphi function canSetBusParams(handle: canHandle; freq: Longint; tseg1, tseg2, sjw, noSamp, syncmode: Cardinal): canStatus; + * \source_end + * + * This function sets the nominal bus timing parameters for the specified CAN + * controller. + * + * The library provides default values for \a tseg1, \a tseg2, \a sjw and \a + * noSamp when \a freq is specified to one of the pre-defined constants, + * \ref canBITRATE_xxx for classic CAN and \ref canFD_BITRATE_xxx for CAN FD. + * + * If \a freq is any other value, no default values are supplied by the + * library. + * + * If you are using multiple handles to the same physical channel, for example + * if you are writing a threaded application, you must call \ref canBusOff() once + * for each handle. The same applies to \ref canBusOn() - the physical channel will + * not go off bus until the last handle to the channel goes off bus. + * + * \note Use \ref canSetBusParamsC200() to set the bus timing parameters in the + * ubiquitous 82c200 bit-timing register format. + * + * \param[in] hnd An open handle to a CAN controller. + * \param[in] freq Bit rate (measured in bits per second); or one of the + * predefined constants (\ref canBITRATE_xxx for classic + * CAN and \ref canFD_BITRATE_xxx for CAN FD). + * \param[in] tseg1 Time segment 1, that is, the number of quanta from (but not + * including) the Sync Segment to the sampling point. + * \param[in] tseg2 Time segment 2, that is, the number of quanta from the sampling + * point to the end of the bit. + * \param[in] sjw The Synchronization Jump Width. + * \param[in] noSamp The number of sampling points; can be 1 or 3. + * \param[in] syncmode Unsupported and ignored. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_bit_rate, \ref page_user_guide_misc_bitrate, + * \ref page_user_guide_init_bit_rate, \ref page_code_snippets_examples + * \sa \ref canSetBusParamsC200(), \ref canGetBusParams() + * + */ +canStatus CANLIBAPI canSetBusParams (const CanHandle hnd, + long freq, + unsigned int tseg1, + unsigned int tseg2, + unsigned int sjw, + unsigned int noSamp, + unsigned int syncmode); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetBusParamsFd(int hnd, int freq_brs, int tseg1_brs, int tseg2_brs, int sjw_brs); + * + * \source_delphi function canSetBusParamsFd(hnd: canHandle; freq_brs: Longint; tseg1_brs, tseg2_brs, sjw_brs): canStatus; + * \source_end + * + * This function sets the data phase bus timing parameters for the specified + * CAN controller. + * + * The library provides default values for \a tseg1_brs, \a tseg2_brs and + * \a sjw_brs when \a freq_brs is specified to one of the pre-defined + * constants, \ref canFD_BITRATE_xxx. + * + * If \a freq_brs is any other value, no default values are supplied + * by the library. + * + * \param[in] hnd An open handle to a CAN controller. + * \param[in] freq_brs CAN FD data bit rate (measured in bits per second); or + * one of the predefined constants \ref + * canFD_BITRATE_xxx. + * \param[in] tseg1_brs Time segment 1, that is, the number of quanta from (but not + * including) the Sync Segment to the sampling point. + * \param[in] tseg2_brs Time segment 2, that is, the number of quanta from the sampling + * point to the end of the bit. + * \param[in] sjw_brs The Synchronization Jump Width. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +canStatus CANLIBAPI canSetBusParamsFd(const CanHandle hnd, + long freq_brs, + unsigned int tseg1_brs, + unsigned int tseg2_brs, + unsigned int sjw_brs); + + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetBusParams(int handle, out long freq, out int tseg1, out int tseg2, out int sjw, out int noSamp, out int syncmode); + * + * \source_delphi function canGetBusParams(handle: canHandle; var freq: Longint; var tseg1, tseg2, sjw, noSamp, syncmode: Cardinal): canStatus; + * \source_end + * + * This function retrieves the current nominal bus parameters for the specified + * channel. + * + * The anatomy of a CAN bit is discussed in detail at Kvaser's + * web site at www.kvaser.com. + * + * \param[in] hnd An open handle to a CAN controller. + * \param[out] freq Bit rate (bits per second). + * \param[out] tseg1 Time segment 1, that is, the number of quanta from (but not + * including) the Sync Segment to the sampling point. + * \param[out] tseg2 Time segment 2, that is, the number of quanta from the sampling + * point to the end of the bit. + * \param[out] sjw The Synchronization Jump Width. + * \param[out] noSamp The number of sampling points; can be 1 or 3. + * \param[out] syncmode Unsupported, always read as one. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_bit_rate, \ref page_user_guide_init_bit_rate + * \sa \ref canSetBusParams(), \ref canSetBusParamsC200() + * + */ +canStatus CANLIBAPI canGetBusParams (const CanHandle hnd, + long *freq, + unsigned int *tseg1, + unsigned int *tseg2, + unsigned int *sjw, + unsigned int *noSamp, + unsigned int *syncmode); + + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetBusParamsFd(int hnd, out long freq_brs, out int tseg1_brs, out int tseg2_brs, out int sjw_brs); + * + * \source_delphi function canGetBusParamsFd(hnd: canHandle; var freq_brs: Longint; var tseg1_brs, tseg2_brs, sjw_brs): canStatus; + * \source_end + * + * This function retrieves the current data bus parameters for the specified + * CAN FD channel. + * + * \param[in] hnd An open handle to a CAN FD controller. + * \param[out] freq_brs Bit rate (bits per second). + * \param[out] tseg1_brs Time segment 1, that is, the number of quanta from (but not + * including) the Sync Segment to the sampling point. + * \param[out] tseg2_brs Time segment 2, that is, the number of quanta from the sampling + * point to the end of the bit. + * \param[out] sjw_brs The Synchronization Jump Width. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +canStatus CANLIBAPI canGetBusParamsFd(const CanHandle hnd, + long *freq_brs, + unsigned int *tseg1_brs, + unsigned int *tseg2_brs, + unsigned int *sjw_brs); +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetBusOutputControl(int handle, int drivertype); + * + * \source_delphi function canSetBusOutputControl(handle: canHandle; drivertype: Cardinal): canStatus; + * \source_end + * + * This function sets the driver type for a CAN controller. This corresponds + * loosely to the bus output control register in the CAN controller, hence the + * name of this function. CANLIB does not allow for direct manipulation of the + * bus output control register; instead, symbolic constants are used to select + * the desired driver type. + * + * \note Not all CAN driver types are supported on all cards. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] drivertype Can driver type, \ref canDRIVER_xxx) + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canGetBusOutputControl() + */ +canStatus CANLIBAPI canSetBusOutputControl (const CanHandle hnd, + const unsigned int drivertype); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetBusOutputControl(int handle, out int drivertype); + * + * \source_delphi function canGetBusOutputControl(handle: canHandle; var drivertype: Cardinal): canStatus; + * \source_end + * + * This function retrieves the current CAN controller driver type. + * This corresponds loosely to the bus output control register in the + * CAN controller, hence the name of this function. CANLIB does not + * allow for direct manipulation of the bus output control register; + * instead, symbolic constants are used to select the desired driver + * type. + * + * \note Don't confuse the CAN controller driver type with the bus driver + * type. The CAN controller is not connected directly to the CAN bus; + * instead, it is connected to a bus transceiver circuit which interfaces + * directly to the bus. The "CAN controller driver type" we are talking + * about here refers to the mode which the CAN controller uses to drive + * the bus transceiver circuit. + * + * \note Silent Mode is not supported by all CAN controllers. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[out] drivertype A pointer to an unsigned int which receives the + * current driver type. The driver type can be either + * \ref canDRIVER_NORMAL or \ref canDRIVER_SILENT. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canSetBusOutputControl() + */ +canStatus CANLIBAPI canGetBusOutputControl (const CanHandle hnd, + unsigned int *drivertype); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canAccept(int handle, int envelope, int flag); + * + * \source_delphi function canAccept(handle: canHandle; envelope: Longint; flag: Cardinal): canStatus; + * \source_end + * + * This routine sets the message acceptance filters on a CAN channel. + * + * On some boards the acceptance filtering is done by the CAN hardware; on + * other boards (typically those with an embedded CPU,) the acceptance + * filtering is done by software. \ref canAccept() behaves in the same way for all + * boards, however. + * + * \win_start \ref canSetAcceptanceFilter() and \win_end \ref canAccept() both serve the same purpose but the + * former can set the code and mask in just one call. + * + * If you want to remove a filter, call \ref canAccept() with the mask set to 0. + * + * \note You can set the extended code and mask only on CAN boards that support + * extended identifiers. + * + * \note Not all CAN boards support different masks for standard and extended + * CAN identifiers. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] envelope The mask or code to set. + * \param[in] flag Any of \ref canFILTER_SET_CODE_STD, + * \ref canFILTER_SET_MASK_STD, + * \ref canFILTER_SET_CODE_EXT or + * \ref canFILTER_SET_MASK_EXT + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_filters, +\win_start + * \ref page_user_guide_misc_code_and_mask, +\win_end + * \ref page_code_snippets_examples + */ +canStatus CANLIBAPI canAccept (const CanHandle hnd, + const long envelope, + const unsigned int flag); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadStatus(int handle, out long flags); + * + * \source_delphi function canReadStatus(handle: canHandle; var flags: Longint): canStatus; + * \source_end + * + * Returns the status for the specified circuit. flags points to a longword + * which receives a combination of the \ref canSTAT_xxx flags. + * + * \note \ref canReadStatus() returns the latest known status of the specified + * circuit. If a status change happens precisely when \ref canReadStatus() is + * called, it may not be reflected in the returned result. + * + * \param[in] hnd A handle to an open circuit. + * \param[out] flags Pointer to a \c DWORD which receives the status flags; + * this is a combination of any of the \ref canSTAT_xxx. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI canReadStatus (const CanHandle hnd, + unsigned long *const flags); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadErrorCounters(int handle, out int txErr, out int rxErr, out int ovErr); + * + * \source_delphi function canReadErrorCounters(handle: canHandle; var txErr, rxErr, ovErr: Cardinal): canStatus; + * \source_end + * + * Reads the error counters of the CAN controller. + * + * \ref canReadErrorCounters() returns the latest known values of the error counters + * in the specified circuit. If the error counters change values precisely when + * \ref canReadErrorCounters() is called, it may not be reflected in the returned + * result. + * + * It is allowed to pass \c NULL as the value of the \a txErr, \a rxErr, and \a + * ovErr parameters. + * + * Use \ref canIoCtl() to clear the counters. + * + * \note Not all CAN controllers provide access to the error counters; + * in this case, an educated guess is returned. + * + * \param[in] hnd A handle to an open circuit. + * \param[out] txErr A pointer to a \c DWORD which receives the transmit error + * counter. + * \param[out] rxErr A pointer to a \c DWORD which receives the receive error + * counter. + * \param[out] ovErr A pointer to a \c DWORD which receives the number of + * overrun errors. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canIoCtl() + */ +canStatus CANLIBAPI canReadErrorCounters (const CanHandle hnd, + unsigned int *txErr, + unsigned int *rxErr, + unsigned int *ovErr); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canWrite(int handle, int id, byte[] msg, int dlc, int flag); + * + * \source_delphi function canWrite(handle: canHandle; id: Longint; msg: Pointer; dlc: Cardinal; flag: Cardinal): canStatus; + * \source_end + * + * This function sends a CAN message. The call returns immediately after queuing + * the message to the driver. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * \note The message has been queued for transmission when this calls return. + * It has not necessarily been sent. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] id The identifier of the CAN message to send. + * \param[in] msg A pointer to the message data, or \c NULL. + * \param[in] dlc The length of the message in bytes.
+ For Classic CAN dlc can be at most 8, unless \ref canOPEN_ACCEPT_LARGE_DLC is used.
+ For CAN FD dlc can be one of the following 0-8, 12, 16, 20, 24, 32, 48, 64. + * \param[in] flag A combination of message flags, \ref canMSG_xxx + * (including \ref canFDMSG_xxx if the CAN FD protocol is + * enabled). + * Use this parameter to send extended (29-bit) frames + * and/or remote frames. Use \ref canMSG_EXT and/or + * \ref canMSG_RTR for this purpose. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_sending, \ref page_code_snippets_examples + * \sa \ref canWriteSync(), \ref canWriteWait() + * + */ +canStatus CANLIBAPI canWrite (const CanHandle hnd, + long id, + void *msg, + unsigned int dlc, + unsigned int flag); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canWriteSync(int handle, long timeout); + * + * \source_delphi function canWriteSync(handle: canHandle; timeout: Longint): canStatus; + * \source_end + * + * Waits until all CAN messages for the specified handle are sent, or the + * timeout period expires. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] timeout The timeout in milliseconds. 0xFFFFFFFF gives an + * infinite timeout. + * + * \return \ref canOK (zero) if the queue emptied before the timeout period came to + * its end. + * \return \ref canERR_TIMEOUT (negative) not all messages were transmitted when + * the timeout occurred. + * \return \ref canERR_PARAM (negative) This could be caused by an erroneous + * parameter, or if you have turned TXACKs off (by using \ref canIoCtl()) + * because if you do you can't use this call. The driver simply doesn't + * know when all the messages are sent! + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canWrite(), \ref canWriteWait() + */ +canStatus CANLIBAPI canWriteSync (const CanHandle hnd, unsigned long timeout); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canRead(int handle, out int id, byte[] msg, out int dlc, out int flag, out long time); + * + * \source_delphi function canRead(handle: canHandle; var id: Longint; msg: Pointer; var dlc: Cardinal; var flag: Cardinal; var time: Longint): canStatus; + * \source_end + * + * Reads a message from the receive buffer. If no message is available, the + * function returns immediately with return code \ref canERR_NOMSG. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * It is allowed to pass \c NULL as the value of \a id, \a msg, \a dlc, \a + * flag, and \a time. + * + * \param[in] hnd A handle to an open circuit. + * \param[out] id Pointer to a buffer which receives the CAN identifier. + * This buffer will only get the identifier. To determine + * whether this identifier was standard (11-bit) or extended + * (29-bit), and/or whether it was remote or not, or if it + * was an error frame, examine the contents of the flag + * argument. + * \param[out] msg Pointer to the buffer which receives the message data. + * This buffer must be large enough (i.e. 8 bytes.) Only the + * message data is copied; the rest of the buffer is left + * as-is. + * \param[out] dlc Pointer to a buffer which receives the message length. + * \param[out] flag Pointer to a buffer which receives the message flags, + * which is a combination of the \ref canMSG_xxx and + * \ref canMSGERR_xxx values. + * \param[out] time Pointer to a buffer which receives the message time stamp. + * + * \return \ref canOK (zero) if a message was read. + * \return \ref canERR_NOMSG (negative) if there was no message available. + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_reading, +\win_start + * \ref page_user_guide_send_recv_mailboxes, +\win_end + * \ref page_code_snippets_examples, + * \ref page_user_guide_time_accuracy_and_resolution + * \sa \ref canReadSpecific(), \ref canReadSpecificSkip(), \ref canReadSync(), + * \ref canReadSyncSpecific(), \ref canReadWait() + * + */ +canStatus CANLIBAPI canRead (const CanHandle hnd, + long *id, + void *msg, + unsigned int *dlc, + unsigned int *flag, + unsigned long *time); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadWait(int handle, out int id, byte[] msg, out int dlc, out int flag, out long time, long timeout); + * + * \source_delphi function canReadWait(handle: canHandle; var id: Longint; msg: Pointer; var dlc: Cardinal; var flag: Cardinal; var time: Longint; timeout: Longint): canStatus; + * \source_end + * + * Reads a message from the receive buffer. If no message is available, the + * function waits until a message arrives or a timeout occurs. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * It is allowed to pass \c NULL as the value of \a id, \a msg, \a dlc, \a + * flag, and \a time. + * + * \param[in] hnd A handle to an open circuit. + * \param[out] id Pointer to a buffer which receives the CAN identifier. + * This buffer will only get the identifier. To determine + * whether this identifier was standard (11-bit) or extended + * (29-bit), and/or whether it was remote or not, or if it + * was an error frame, examine the contents of the flag + * argument. + * \param[out] msg Pointer to the buffer which receives the message data. + * This buffer must be large enough (i.e. 8 bytes.). + * \param[out] dlc Pointer to a buffer which receives the message length. + * \param[out] flag Pointer to a buffer which receives the message flags, + * which is a combination of the \ref canMSG_xxx and + * \ref canMSGERR_xxx values. + * \param[out] time Pointer to a buffer which receives the message time stamp. + * \param[in] timeout If no message is immediately available, this parameter + * gives the number of milliseconds to wait for a message + * before returning. 0xFFFFFFFF gives an infinite timeout. + * + * \return \ref canOK (zero) if a message was read. + * \return \ref canERR_NOMSG (negative) if there was no message available. + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canRead(), \ref canReadSpecific(), \ref canReadSpecificSkip(), + * \ref canReadSyncSpecific(), \ref canReadSync() + * + * \sa \ref page_user_guide_time_accuracy_and_resolution + */ +canStatus CANLIBAPI canReadWait (const CanHandle hnd, + long *id, + void *msg, + unsigned int *dlc, + unsigned int *flag, + unsigned long *time, + unsigned long timeout); + +#if defined(CANLIB_DECLARE_ALL) +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadSpecific(int handle, int id, byte[] msg, out int dlc, out int flag, out long time); + * + * \source_delphi function canReadSpecific(handle: canHandle; id: Longint; msg: Pointer; var dlc: Cardinal; var flag: Cardinal; var time: Longint): canStatus; + * \source_end + * + * Reads a message with a specified identifier from the receive buffer. Any + * preceding message not matching the specified identifier will be kept + * in the receive buffer. If no message with the specified identifier is + * available, the function returns immediately with an error code. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * It is allowed to pass \c NULL as the value of \a msg, \a dlc, \a + * flag, and \a time. + * + * \note Use \ref canReadSpecific only if you for some reason must keep the unread + * messages in the queue. If this is not the case, consider using + * \ref canReadSpecificSkip() or \ref canRead() for better performance. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] id The desired CAN identifier. + * \param[out] msg Pointer to the buffer which receives the message data. + * This buffer must be large enough (i.e. 8 bytes.). + * \param[out] dlc Pointer to a buffer which receives the message length. + * \param[out] flag Pointer to a buffer which receives the message flags, + * which is a combination of the \ref canMSG_xxx and + * \ref canMSGERR_xxx values. + * \param[out] time Pointer to a buffer which receives the message time stamp. + * + * \return \ref canOK (zero) if a message was read. + * \return \ref canERR_NOMSG (negative) if a matching message was not found. + * There might be other messages in the queue, though. + * \return \ref canERR_xxx (negative) if failure + * +\win_start * \sa \ref page_user_guide_send_recv_mailboxes \ref \win_end + * page_user_guide_send_recv_reading \ref + * page_user_guide_time_accuracy_and_resolution + * \sa \ref canRead(), \ref canReadSpecificSkip(), \ref canReadSync(), \ref canReadSyncSpecific(), + * \ref canReadWait() + * + */ +canStatus CANLIBAPI canReadSpecific (const CanHandle hnd, long id, void * msg, + unsigned int * dlc, unsigned int * flag, + unsigned long * time); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadSync(int handle, long timeout); + * + * \source_delphi function canReadSync(handle: canHandle; timeout: Longint): canStatus; + * \source_end + * + * Waits until the receive buffer contains at least one message or a timeout + * occurs. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] timeout The timeout in milliseconds. 0xFFFFFFFF gives an + * infinite timeout. + * + * \return \ref canOK (zero) if the queue contains the desired message. + * \return \ref canERR_TIMEOUT (negative) if a timeout occurs before a message + * arrived. + * \return \ref canERR_xxx (negative) if the call fails. + * + * \sa \ref canRead(), \ref canReadSpecific(), \ref canReadSpecificSkip(), + * \ref canReadSyncSpecific(), \ref canReadWait() + */ +canStatus CANLIBAPI canReadSync (const CanHandle hnd, unsigned long timeout); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadSyncSpecific(int handle, int id, long timeout); + * + * \source_delphi function canReadSyncSpecific(handle: canHandle; id, timeout: Longint): canStatus; + * \source_end + * + * Waits until the receive queue contains a message with the specified id, or a + * timeout occurs.. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] id The desired message identifier. + * \param[in] timeout The timeout in milliseconds. 0xFFFFFFFF gives an + * infinite timeout. + * + * \return \ref canOK (zero) if the queue contains the desired message. + * \return \ref canERR_TIMEOUT (negative) if a timeout occurs before the specified + * message arrived. + * \return \ref canERR_xxx (negative) if the call fails. + * + * \sa \ref canRead(), \ref canReadSpecific(), \ref canReadSpecificSkip(), + * \ref canReadSync(), \ref canReadWait() + */ +canStatus CANLIBAPI canReadSyncSpecific (const CanHandle hnd, + long id, + unsigned long timeout); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canReadSpecificSkip(int hnd, int id, byte[] msg, out int dlc, out int flag, out long time); + * + * \source_delphi function canReadSpecificSkip(handle: canHandle; id: Longint; msg: Pointer; var dlc: Cardinal; var flag: Cardinal; var time: Longint): canStatus; + * \source_end + * + * Reads a message with a specified identifier from the receive buffer. Any + * preceding message not matching the specified identifier will be removed + * in the receive buffer. If no message with the specified identifier is + * available, the function returns immediately with an error code. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * It is allowed to pass \c NULL as the value of \a msg, \a dlc, \a + * flag, and \a time. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] id The desired CAN identifier. + * \param[out] msg Pointer to the buffer which receives the message data. + * This buffer must be large enough (i.e. 8 bytes.). + * \param[out] dlc Pointer to a buffer which receives the message length. + * \param[out] flag Pointer to a buffer which receives the message flags, + * which is a combination of the \ref canMSG_xxx and + * \ref canMSGERR_xxx values. + * \param[out] time Pointer to a buffer which receives the message time stamp. + * + * \return \ref canOK (zero) if a matching message was found. + * \return \ref canERR_NOMSG if there was no matching message available. All other + messages (if any!) were discarded. + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_reading, \ref + * page_user_guide_time_accuracy_and_resolution + * \sa \ref canRead(), \ref canReadSpecific(), \ref canReadSync(), + * \ref canReadSyncSpecific(), \ref canReadWait() + */ +canStatus CANLIBAPI canReadSpecificSkip (const CanHandle hnd, + long id, + void * msg, + unsigned int * dlc, + unsigned int * flag, + unsigned long * time); +#endif + + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetNotify(int handle, IntPtr win_handle, int aNotifyFlags); + * + * \source_delphi function canSetNotify(handle: canHandle; aHWnd: HWND; aNotifyFlags: Cardinal): canStatus; + * \source_end + * + * This function associates a window handle with the CAN circuit. A + * \c WM__CANLIB message is sent to that window when certain events + * (specified by the \ref canNOTIFY_xxx flags) occur. + * + * When an event take place, a \c WM__CANLIB message will be sent to the window + * whose handle is aHWnd. This \c WM__CANLIB message will have: + * + * \li \c WPARAM handle to the circuit where the event occurred + * \li \c HIWORD(LPARAM) 0 + * \li \c LOWORD(LPARAM) \ref canEVENT_xxx + * + * In the routine that handles \c WM__CANLIB, you can call the CANLIB API + * functions (for example, \ref canRead()) using the handle found in \c wParam. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] aHWnd Handle of the window which will receive the + * notification messages. + * \param[in] aNotifyFlags The events specified with \ref canNOTIFY_xxx, for + * which callback should be called. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \n In the routine that handles \c WM__CANLIB, you must call \ref canRead() repeatedly + * until it returns \ref canERR_NOMSG, regardless of the \c LPARAM value. This will + * flush the driver's internal event queues. If you fail to do this, no more + * events will be reported. + * + * \sa \ref page_code_snippets_examples + */ +canStatus CANLIBAPI canSetNotify (const CanHandle hnd, + HWND aHWnd, + unsigned int aNotifyFlags); + + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canTranslateBaud(ref int freq, out int tseg1, out int tseg2, out int sjw, out int nosamp, out int syncMode); + * + * \source_delphi function canTranslateBaud(var freq: longint; var tseg1, tseg2, sjw, noSamp, syncMode: Cardinal): canStatus; + * \source_end + * + * This function translates the \ref canBITRATE_xxx constants to their corresponding + * bus parameter values. At return, this \a freq contains the actual bit rate + * (in bits per second). \a TSeg1 is the number of quanta (less one) in a bit + * before the sampling point. \a TSeg2 is the number of quanta after the + * sampling point. + * + * \param[in,out] freq A pointer to a \c DWORD which contains the \ref canBITRATE_xxx + * constant to translate. The bitrate constant value is + * overwritten with the frequency value. + * \param[out] tseg1 A pointer to a buffer which receives the Time segment 1, + * that is, the number of quanta from (but not including) + * the Sync Segment to the sampling point. + * \param[out] tseg2 A pointer to a buffer which receives the Time segment 2, + * that is, the number of quanta from the sampling point to + * the end of the bit. + * \param[out] sjw A pointer to a buffer which receives the Synchronization + * Jump Width. + * \param[out] nosamp A pointer to a buffer which receives the number of + * sampling points. + * \param[out] syncMode Unsupported, always read as zero. May be set to NULL. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canSetBusParams() + */ +canStatus CANLIBAPI canTranslateBaud (long *const freq, + unsigned int *const tseg1, + unsigned int *const tseg2, + unsigned int *const sjw, + unsigned int *const nosamp, + unsigned int *const syncMode); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus canGetErrorText(Canlib.canStatus err, out string buf_str); + * + * \source_delphi function canGetErrorText(err: canStatus; buf: PChar; bufsiz: Cardinal): canStatus; + * \source_end + * + * This function translates an error code (\ref canERR_xxx) + * to a human-readable, English text. + * + * \param[in] err The error code. + * \param[out] buf The buffer which is to receive the text, which is a + * zero-terminated string (provided the buffer is large enough.) + * \param[in] bufsiz The length of the input buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * + */ +canStatus CANLIBAPI canGetErrorText (canStatus err, char *buf, unsigned int bufsiz); + +/** + * \ingroup General + * + * \source_cs static short canGetVersion(); + * + * \source_delphi function canGetVersion: Word; + * \source_end + * + * \win_start + * This API call returns the version of the CANLIB API DLL (canlib32.dll). The + * most significant byte is the major version number and the least significant + * byte is the minor version number. + * + * The actual version of the different driver files can be obtained by studying + * the version resources in each of the files. + * + * \note The version number of the canlib32.dll file is not related to the + * product version of CANLIB you are using. CANLIB consists of several + * driver and DLL files. To obtain the product version, use + * \ref canGetVersionEx(). + * + * \return version number of canlib32.dll + * + * \sa \ref page_user_guide_build_driver_version + * \sa \ref canGetVersionEx(), \ref canProbeVersion() + * + * \win_end + * + * \linux_start + * This API call returns the version of the CANLIB API library (libcanlib.so.x.y). The + * most significant byte is the major version number and the least significant + * byte is the minor version number. + * + * \return version number of libcanlib.so.x.y + * + * \linux_end + * + * + */ +unsigned short CANLIBAPI canGetVersion (void); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus canIoCtl(int handle, int func, int val);
+ static Canlib.canStatus canIoCtl(int handle, int func, out int val);
+ static Canlib.canStatus canIoCtl(int handle, int func, out string str_buf);
+ static Canlib.canStatus canIoCtl(int handle, int func, ref object obj_buf); + * + * \source_delphi function canIoCtl(handle: canHandle; func: Cardinal; buf: Pointer; buflen: Cardinal): canStatus; + * \source_end + * + * This API call performs several different functions; these are described + * below. The functions are handle-specific unless otherwise noted; this means + * that they affect only the handle you pass to \ref canIoCtl(), whereas other open + * handles will remain unaffected. The contents of \a buf after the call is + * dependent on the function code you specified. + * + * \param[in] hnd A handle to an open circuit. + * \param[in] func A \ref canIOCTL_xxx function code + * \param[in,out] buf Pointer to a buffer containing function-dependent data; + or a \c NULL pointer for certain function codes. The + buffer can be used for both input and output + depending on the function code. See \ref canIOCTL_xxx. + * \param[in] buflen The length of the buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI canIoCtl (const CanHandle hnd, + unsigned int func, + void *buf, + unsigned int buflen); + +/* Note the difference from the windows version */ + +/** + * \ingroup CAN + * + * \source_cs static long canReadTimer(int hnd); + * + * \source_delphi function canReadTimer(handle: canHandle): longint; + * \source_end + * + * Reads the current time from the clock used to timestamp the + * messages for the indicated circuit. + * + * This API may return \ref canERR_INVHANDLE and/or \ref canERR_NOTINITIALIZED! + * This happens if \a hnd is invalid, or if the library was not initialized. + * + * \note \ref kvReadTimer() should be used instead since it separates the returned + * time from the error code. + * + * \note The clock used to timestamp the messages may not be available for + * direct reading on all platforms. In such cases, the PC's clock is used + * to return an approximation of the current time. Note that clock drift might + * occur in this case. + * + * \param[in] hnd A handle to an open circuit. + * + * \return The current time, with the prevailing time resolution (milliseconds + * by default). + * + * \sa \ref page_user_guide_time_accuracy_and_resolution + * \win_start + * \sa \ref kvReadTimer() + * \win_end + */ +unsigned long CANLIBAPI canReadTimer (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static int canOpenChannel(int channel, int flags); + * + * \source_delphi function canOpenChannel(channel: Integer; flags: Integer): canHandle; + * \source_end + * + * Opens a CAN channel (circuit) and returns a handle which is used + * in subsequent calls to CANLIB. + * + * + * Channel numbering is dependent on the installed hardware. The first channel + * always has number 0. + * + * For example, + * + * \li If you have a single LAPcan, the channels are numbered 0 and 1. + * + * \li If you have a USBcan Professional, the channels are numbered 0-1 + * according to the labels on the cables. + * + * \li The virtual channels come after all physical channels. + * + * If you are using multiple threads, note that the returned handle is usable + * only in the context of the thread that created it. That is, you must call + * \ref canOpenChannel() in each of the threads in your application that uses the + * CAN bus. You can open the same channel from multiple threads, but you must + * call \ref canOpenChannel() once per thread. + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * \note The handle returned may be zero which is perfectly valid. + * + * \param[in] channel The number of the channel. Channel numbering is hardware + * dependent. + * \param[in] flags A combination of \ref canOPEN_xxx flags + * + * \return Returns a handle to the opened circuit, or \ref canERR_xxx + * (negative) if the call failed. + * + * \sa \ref page_code_snippets_examples, \ref page_user_guide_virtual_info + * \sa \ref canGetNumberOfChannels(), \ref canGetChannelData(), \ref canIoCtl() + * + */ +CanHandle CANLIBAPI canOpenChannel (int channel, int flags); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus canGetNumberOfChannels(out int channelCount); + * + * \source_delphi function canGetNumberOfChannels(var channelCount: Integer): canStatus; + * \source_end + * + * This function returns the number of available CAN channels in the + * computer. The virtual channels are included in this number. + * + * \param[out] channelCount A pointer to a \c DWORD which will receive the current + * number of channels. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples, \ref page_user_guide_virtual_info + * \sa \ref canGetChannelData() + */ +canStatus CANLIBAPI canGetNumberOfChannels (int *channelCount); + + +/** + * \name kvREMOTE_TYPExxx + * \anchor kvREMOTE_TYPExxx + * + * Remote type, returned when using \ref canCHANNELDATA_REMOTE_TYPE + * @{ + */ +#define kvREMOTE_TYPE_NOT_REMOTE 0 ///< +#define kvREMOTE_TYPE_WLAN 1 ///< +#define kvREMOTE_TYPE_LAN 2 ///< +/** @} */ + +/** + * \name kvLOGGER_TYPE_xxx + * \anchor kvLOGGER_TYPE_xxx + * + * Logger type, returned when using \ref canCHANNELDATA_LOGGER_TYPE + * @{ + */ +#define kvLOGGER_TYPE_NOT_A_LOGGER 0 ///< +#define kvLOGGER_TYPE_V1 1 ///< +#define kvLOGGER_TYPE_V2 2 ///< +/** @} */ + + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus canGetChannelData(int channel, int item, out object buffer); + * + * \source_delphi function canGetChannelData(channel, item: Integer; var buffer; bufsize: Cardinal): canStatus; + * \source_end + * + * This function can be used to retrieve certain pieces of information about a channel. + * + * \note You must pass a channel number and not a channel handle. + * + * \param[in] channel The number of the channel you are interested in. Channel + * numbers are integers in the interval beginning at 0 + * (zero) and ending at the value returned by + * \ref canGetNumberOfChannels() minus 1. + * \param[in] item This parameter specifies what data to obtain for the + * specified channel. The value is one of the constants + * \ref canCHANNELDATA_xxx. + * \param[out] buffer The address of a buffer which is to receive the data. + * \param[in] bufsize The size of the buffer to which the buffer parameter + * points. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref canGetNumberOfChannels() + */ +canStatus CANLIBAPI canGetChannelData (int channel, + int item, + void *buffer, + size_t bufsize); + +/** + * \ingroup General + * \anchor canCHANNELDATA_xxx + * \name canCHANNELDATA_xxx + * + * These defines are used in \ref canGetChannelData(). + * + * @{ + */ + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the + * capabilities of the CAN controller; this is a combination of the \ref + * canCHANNEL_CAP_xxx flags. + */ +#define canCHANNELDATA_CHANNEL_CAP 1 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the + * capabilities of the CAN transceiver; this is a combination of the + * \ref canDRIVER_CAP_xxx flags. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +#define canCHANNELDATA_TRANS_CAP 2 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \note Currently not implemented + */ +#define canCHANNELDATA_CHANNEL_FLAGS 3 // available, etc + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the hardware + * type of the card. This value is any one of the \ref canHWTYPE_xxx + * constants. + */ +#define canCHANNELDATA_CARD_TYPE 4 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the card's + * number in the computer. Each card type is numbered separately. For + * example, the first LAPcan card in a machine will have number 0, the second + * LAPcan number 1, etc. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +#define canCHANNELDATA_CARD_NUMBER 5 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives the channel + * number on the card. + */ +#define canCHANNELDATA_CHAN_NO_ON_CARD 6 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 64-bit (8 bytes) area which receives the serial + * number of the card. If the card doesn't have a serial number, 0 is + * returned. The serial number is an 8-byte unsigned integer. Currently, no + * products are using all 8 bytes; at most 4 bytes are used. + */ +#define canCHANNELDATA_CARD_SERIAL_NO 7 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 64-bit (8 bytes) area which receives the serial + * number of the transceiver. The serial number is an 8-byte unsigned + * integer. If the transceiver doesn't have a serial number, 0 is returned. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +#define canCHANNELDATA_TRANS_SERIAL_NO 8 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 64-bit (8 bytes) area which receives the firmware + * revision number on the card. This number consists of four 16-bit words: + * the major revision, the minor revision, the release number and the build + * number, listed in order from the most significant to the least + * significant. + */ +#define canCHANNELDATA_CARD_FIRMWARE_REV 9 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 64-bit (8 bytes) area which receives the hardware + * revision number on the card. This number consists of four 16-bit words; + * the two most significant are always 0, and the two least significant are + * the major revision and the minor revision, listed in order from the most + * significant to the least significant. + */ +#define canCHANNELDATA_CARD_HARDWARE_REV 10 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 8-byte area which receives the UPC (EAN) number for + * the card. If there is no UPC number, the buffer is filled with zeros. The + * UPC (EAN) number is coded as a BCD string with the LSB first, so + * e.g. 733-0130-00122-0 is coded as 0x30001220 0x00073301. + */ +#define canCHANNELDATA_CARD_UPC_NO 11 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 8-byte area which receives the UPC (EAN) number for + * the transceiver. If there is no UPC number, the buffer is filled with + * zeros. The UPC (EAN) number is coded as a BCD string with the LSB first, + * so e.g. 733-0130-00122-0 is coded as 0x30001220 0x00073301. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +#define canCHANNELDATA_TRANS_UPC_NO 12 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to an area which receives a zero-terminated string with a + * clear-text name of the channel. + * + * \note Use of this item code is no longer recommended. The returned + * channel name doesn't contain the exact hardware type (it just contains + * the device family) and uses zero-based channel numbering, which is not + * user friendly. Instead, use e.g. \ref canCHANNELDATA_DEVDESCR_ASCII and + * \ref canCHANNELDATA_CHAN_NO_ON_CARD to build your own channel name. + * + *\win_start + * \sa \ref canCHANNELDATA_DEVNAME_ASCII + *\win_end + */ +#define canCHANNELDATA_CHANNEL_NAME 13 +#if defined(CANLIB_DECLARE_ALL) + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to an array of 4 16-bit unsigned integers which receives + * the file version number of the second-level DLL driver file, i.e. the DLL + * that interfaces between CANLIB32.DLL and the driver proper. + * + * Contents depening on index: + * + * \li 0: 0 + * \li 1: The build number + * \li 2: The minor revision number + * \li 3: The major revision number + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DLL_FILE_VERSION 14 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to an array of 4 16-bit unsigned integers which receives + * the product version number of the second-level DLL driver file, i.e. the + * DLL that interfaces between CANLIB32.DLL and the driver proper. + * + * Contents depening on index: + * + * \li 0: 0 + * \li 1: 1 + * \li 2: The minor revision number + * \li 3: The major revision number + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DLL_PRODUCT_VERSION 15 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives a number that + * identifies the second-level DLL driver file, i.e. the DLL that interfaces + * between CANLIB32.DLL and the driver proper. + * + * Values: + * + * \li 1: kvalapw.dll - used with CANLIB up to 2.29. + * + * \li 2: kvalapw2.dll - used with CANLIB from 3.0 and on. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DLL_FILETYPE 16 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives the CAN + * transceiver type of the specified channel. This value is one of the + * \ref canTRANSCEIVER_TYPE_xxx + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_TRANS_TYPE 17 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives an address + * indicating where the device is located on its underlying bus. The + * interpretation of this number is bus-specific. If the address is unknown + * or the bus driver does not support an address, the bus driver leaves this + * member at its default value of 0xFFFFFFFF. + * + * The following list describes the information certain bus drivers store in + * the Address field for their child devices: + * + * \li ISA: Does not supply an address. Defaults to 0xFFFFFFFF. + * + * \li PC Card (PCMCIA): The socket number (typically 0x00 or 0x40) + * + * \li PCI: The device number in the high word and the function number in the + * low word. + * + * \li USB: The port number. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DEVICE_PHYSICAL_POSITION 18 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives a number + * associated with the device that can be displayed in the user + * interface. This number is typically a user-perceived slot number, such as + * a number printed next to the slot on the board, or some other number that + * makes locating the physical device easier for the user. For buses with no + * such convention, or when the UI number is unknown, 0xFFFFFFFF is returned. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_UI_NUMBER 19 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which is set to 0, if the + * legacy time synchronization is not currently enabled for the specified + * channel, and 1, if the legacy time synchronization is currently enabled + * for the specified channel. + * + * Legacy time synchronization is a mechanism that will keep the PC and CAN + * channel clocks in sync. The synchronization is done in the driver, which + * periodically calculates the difference between the PC clock and the CAN + * device clock and compensates for the clock drift by recalculating the CAN + * message time stamps. You need to enable clock synchronization in the + * Control Panel using the Kvaser Hardware applet. + * + * \note Legacy time synchronization is implemented only on LAPcan and LAPcan + * II. It is not related to Kvaser MagiSync&tm; which is implemented in the + * high-end members of the Kvaser Leaf family. Kvaser MagiSync&tm; is always + * enabled and allows for much more accurate time synchronization. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + * + */ +# define canCHANNELDATA_TIMESYNC_ENABLED 20 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to an array of four 16-bit unsigned integers which + * receives the file version number of the kernel-mode driver. + * + * Contents depening on index: + * + * \li 0: The build number + * \li 1: 0 + * \li 2: The minor revision number + * \li 3: The major revision number + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DRIVER_FILE_VERSION 21 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to an array of four 16-bit unsigned integers which + * receives the product version number of the kernel-mode driver. + * + * Contents depening on index: + * + * \li 0: 0 + * \li 1: 0 + * \li 2: The minor revision number + * \li 3: The major revision number + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DRIVER_PRODUCT_VERSION 22 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the device manufacturer's name + * as a zero-terminated Unicode string. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_MFGNAME_UNICODE 23 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the device manufacturer's name + * as a zero-terminated ASCII string. + */ +# define canCHANNELDATA_MFGNAME_ASCII 24 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the product name of the device + * as a zero-terminated Unicode string. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DEVDESCR_UNICODE 25 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the product name of the device + * as a zero-terminated ASCII string. + */ +# define canCHANNELDATA_DEVDESCR_ASCII 26 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the name of the device + * driver (e.g. "kcans") as a zero-terminated ASCII string. + * + * \note The device driver names have no special meanings and may change + * from a release to another. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DRIVER_NAME 27 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the quality of + * the channel, where the quality is measured in percent of optimal quality. + * + * For WLAN, -90 dBm and -35 dBm are considered 0% and 100%, respectively. + * + * The quality is 100% for any directly connected channel (USB, PCI etc.). + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_CHANNEL_QUALITY 28 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer point to a 32-bit unsigned integer that receives the roundtrip + * time which is measured in milliseconds. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_ROUNDTRIP_TIME 29 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the + * \ref kvBUSTYPE_GROUP_xxx bus type. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_BUS_TYPE 30 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a CHAR array of at least 32 characters which receives + * the current device name as a \c NULL terminated ASCII string. + * + * If device name is not set or the device does not support this + * functionality, an error will be returned. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_DEVNAME_ASCII 31 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that contains the time in + * milliseconds since the last communication occured. + * + * For WLAN devices, this is the time since the last keep-alive message. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_TIME_SINCE_LAST_SEEN 32 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the + * current WLAN operational mode of the remote capable device; + * \ref canCHANNEL_OPMODE_xxx. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_REMOTE_OPERATIONAL_MODE 33 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the remote profile name + * of the device as a zero-terminated ASCII string. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_REMOTE_PROFILE_NAME 34 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the remote host name + * of the device as a zero-terminated ASCII string. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_REMOTE_HOST_NAME 35 + + /** + * \win_start + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a buffer which receives the mac address + * of the device as a zero-terminated ASCII string. + * \win_end + * \linux_start + * Not implemented. + * \linux_end + */ +# define canCHANNELDATA_REMOTE_MAC 36 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer which receives + * maximum bitrate of the device. Zero value means no limit on + * bitrate. + */ +# define canCHANNELDATA_MAX_BITRATE 37 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that receives the + * capabilities mask of the CAN channel. This mask specifies + * which capabilities corresponding device is guaranteed + * to support/not support at the moment, see \ref canCHANNEL_CAP_xxx + * for info about flags. + */ +# define canCHANNELDATA_CHANNEL_CAP_MASK 38 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that is 1 if + * the channel(device) is currently connected as a remote device. 0 if it is not + * currenty a remote device. */ +# define canCHANNELDATA_IS_REMOTE 40 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that returns the type of remote connection. + * in mHz. See \ref kvREMOTE_TYPExxx for returned values. + */ +# define canCHANNELDATA_REMOTE_TYPE 41 + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer points to a 32-bit unsigned integer that returns the logger type of the device. + * See \ref kvLOGGER_TYPE_xxx for returned values. + */ +# define canCHANNELDATA_LOGGER_TYPE 42 + + + + +#endif + + /** + * This define is used in \ref canGetChannelData(), \a buffer + * mentioned below refers to this functions argument. + * + * \a buffer is a user supplied byte array of length 'bufsize' (at + * least one byte long) to which the null terminated UTF-8 coded + * channel name will be placed. + */ +#define canCHANNELDATA_CUST_CHANNEL_NAME 39 + + /** @} */ + + +/** + * \name canCHANNEL_IS_xxx + * \anchor canCHANNEL_IS_xxx + * + * These channelFlags are used in \ref canGetChannelData() and in conjunction with \ref + * canCHANNELDATA_CHANNEL_FLAGS. + * @{ + */ +/** Used with \ref canCHANNELDATA_CHANNEL_FLAGS, indicates that the channel is + opened exclusively. */ +#define canCHANNEL_IS_EXCLUSIVE 0x0001 +/** Used with \ref canCHANNELDATA_CHANNEL_FLAGS, indicates that the channel is + opened. */ +#define canCHANNEL_IS_OPEN 0x0002 + +/** Used with \ref canCHANNELDATA_CHANNEL_FLAGS, indicates that the channel is + * opened as CAN FD. */ + +#define canCHANNEL_IS_CANFD 0x0004 + +//#define canCHANNEL_IS_CANFD_NON_ISO 0x0008 Reserved for when needed + + /** @} */ + + +/** + * \name canHWTYPE_xxx + * \anchor canHWTYPE_xxx + * + * The following constants can be returned from \ref canGetChannelData(), using the + * \ref canCHANNELDATA_CARD_TYPE item code. They identify the hardware type for + * the channel specified in the call to \ref canGetChannelData(). + * + * \note They indicate a hardware type, but not necessarily a specific + * product. For example, \ref canHWTYPE_LAPCAN is returned both for LAPcan and + * LAPcan II. (You can use \ref canGetChannelData() to obtain the UPC/EAN code for + * the device. This number uniquely identifies the product.) + * + * @{ + */ +#define canHWTYPE_NONE 0 ///< Unknown or undefined +#define canHWTYPE_VIRTUAL 1 ///< The virtual CAN bus +#define canHWTYPE_LAPCAN 2 ///< LAPcan Family +#define canHWTYPE_CANPARI 3 ///< CANpari (obsolete). +#define canHWTYPE_PCCAN 8 ///< PCcan Family +#define canHWTYPE_PCICAN 9 ///< PCIcan Family +#define canHWTYPE_USBCAN 11 ///< USBcan (obsolete). +#define canHWTYPE_PCICAN_II 40 ///< PCIcan II family +#define canHWTYPE_USBCAN_II 42 ///< USBcan II, USBcan Rugged, Kvaser Memorator +#define canHWTYPE_SIMULATED 44 ///< Simulated CAN bus for Kvaser Creator (obsolete). +#define canHWTYPE_ACQUISITOR 46 ///< Kvaser Acquisitor (obsolete). +#define canHWTYPE_LEAF 48 ///< Kvaser Leaf Family +#define canHWTYPE_PC104_PLUS 50 ///< Kvaser PC104+ +#define canHWTYPE_PCICANX_II 52 ///< Kvaser PCIcanx II +#define canHWTYPE_MEMORATOR_II 54 ///< Kvaser Memorator Professional family +#define canHWTYPE_MEMORATOR_PRO 54 ///< Kvaser Memorator Professional family +#define canHWTYPE_USBCAN_PRO 56 ///< Kvaser USBcan Professional +#define canHWTYPE_IRIS 58 ///< Obsolete name, use canHWTYPE_BLACKBIRD instead +#define canHWTYPE_BLACKBIRD 58 ///< Kvaser BlackBird +#define canHWTYPE_MEMORATOR_LIGHT 60 ///< Kvaser Memorator Light +#define canHWTYPE_MINIHYDRA 62 ///< Obsolete name, use canHWTYPE_EAGLE instead +#define canHWTYPE_EAGLE 62 ///< Kvaser Eagle family +#define canHWTYPE_BAGEL 64 ///< Obsolete name, use canHWTYPE_BLACKBIRD_V2 instead +#define canHWTYPE_BLACKBIRD_V2 64 ///< Kvaser BlackBird v2 +#define canHWTYPE_MINIPCIE 66 ///< Kvaser Mini PCI Express +#define canHWTYPE_USBCAN_KLINE 68 ///< USBcan Pro HS/K-Line +#define canHWTYPE_ETHERCAN 70 ///< Kvaser Ethercan +#define canHWTYPE_USBCAN_LIGHT 72 ///< Kvaser USBcan Light +#define canHWTYPE_USBCAN_PRO2 74 ///< Kvaser USBcan Pro 5xHS and variants +#define canHWTYPE_PCIE_V2 76 ///< Kvaser PCIEcan 4xHS and variants +#define canHWTYPE_MEMORATOR_PRO2 78 ///< Kvaser Memorator Pro 5xHS and variants +#define canHWTYPE_LEAF2 80 ///< Kvaser Leaf Pro HS v2 and variants +#define canHWTYPE_MEMORATOR_V2 82 ///< Kvaser Memorator (2nd generation) + + +/** @} */ + +/** + * \name canCHANNEL_CAP_xxx + * \anchor canCHANNEL_CAP_xxx + * + * Channel capabilities. + */ +#define canCHANNEL_CAP_EXTENDED_CAN 0x00000001L ///< Can use extended identifiers +#define canCHANNEL_CAP_BUS_STATISTICS 0x00000002L ///< Can report busload etc +#define canCHANNEL_CAP_ERROR_COUNTERS 0x00000004L ///< Can return error counters +#define canCHANNEL_CAP_CAN_DIAGNOSTICS 0x00000008L ///< Can report CAN diagnostics +#define canCHANNEL_CAP_GENERATE_ERROR 0x00000010L ///< Can send error frames +#define canCHANNEL_CAP_GENERATE_OVERLOAD 0x00000020L ///< Can send CAN overload frame +#define canCHANNEL_CAP_TXREQUEST 0x00000040L ///< Can report when a CAN messsage transmission is initiated +#define canCHANNEL_CAP_TXACKNOWLEDGE 0x00000080L ///< Can report when a CAN messages has been transmitted +#define canCHANNEL_CAP_VIRTUAL 0x00010000L ///< Virtual CAN channel +#define canCHANNEL_CAP_SIMULATED 0x00020000L ///< Simulated CAN channel +#define canCHANNEL_CAP_RESERVED_1 0x00040000L ///< Obsolete, use canCHANNEL_CAP_REMOTE_ACCESS or \ref canGetChannelData() instead. +#define canCHANNEL_CAP_CAN_FD 0x00080000L ///< CAN-FD ISO compliant channel +#define canCHANNEL_CAP_CAN_FD_NONISO 0x00100000L ///< CAN-FD NON-ISO compliant channel +#define canCHANNEL_CAP_SILENT_MODE 0x00200000L ///< Channel supports Silent mode +#define canCHANNEL_CAP_SINGLE_SHOT 0x00400000L ///< Channel supports Single Shot messages +#define canCHANNEL_CAP_LOGGER 0x00800000L ///< Channel has logger capabilities. +#define canCHANNEL_CAP_REMOTE_ACCESS 0x01000000L ///< Channel has remote capabilities +#define canCHANNEL_CAP_SCRIPT 0x02000000L ///< Channel has script capabilities. + +/** + * \name canCHANNEL_OPMODE_xxx + * \anchor canCHANNEL_OPMODE_xxx + * + * Current WLAN operational mode. + * + * @{ + */ +#define canCHANNEL_OPMODE_NONE 1 ///< Not applicable, or unknown +#define canCHANNEL_OPMODE_INFRASTRUCTURE 2 ///< Infrastructure mode +#define canCHANNEL_OPMODE_RESERVED 3 ///< Reserved value, do not use +#define canCHANNEL_OPMODE_ADHOC 4 ///< Adhoc mode +/** @} */ + +/** + * \name canDRIVER_CAP_xxx + * \anchor canDRIVER_CAP_xxx + * + * Driver (transceiver) capabilities. + * @{ + */ +/** Used with \ref canCHANNELDATA_TRANS_CAP */ +#define canDRIVER_CAP_HIGHSPEED 0x00000001L +/** @} */ + +/** + * \ingroup General + * \name canIOCTL_xxx + * \anchor canIOCTL_xxx + * + * These defines are used in \ref canIoCtl(). + * + * @{ + */ + + + /** + * This define is used in \ref canIoCtl(), \a buf and \a buflen refers to this + * functions arguments. + * + * Tells CANLIB to "prefer" extended identifiers; that is, if you send a + * message with \ref canWrite() and don't specify \ref canMSG_EXT nor \ref canMSG_STD, + * \ref canMSG_EXT will be assumed. The contents of \a buf and \a buflen are + * ignored. \ref canRead() et al will set \ref canMSG_EXT and/or \ref canMSG_STD as usual + * and are not affected by this call. + */ +#define canIOCTL_PREFER_EXT 1 + + /** + * This define is used in \ref canIoCtl(), \a buf and \a buflen refers to this + * functions arguments. + * + * Tells CANLIB to "prefer" standard identifiers; that is, if you send a + * message with \ref canWrite() and don't specify \ref canMSG_EXT nor \ref canMSG_STD, + * \ref canMSG_STD will be assumed. The contents of \a buf and \a buflen are + * ignored. \ref canRead() et al will set \ref canMSG_EXT and/or \ref canMSG_STD as usual + * and are not affected by this call. + */ +#define canIOCTL_PREFER_STD 2 +// 3,4 reserved. + + /** + * The following canIOCTL code is deprecated. + * It is recommended to use \ref canIOCTL_RESET_OVERRUN_COUNT to reset overrun status + * (Note that CAN error counters are never updated on device and will be briefly + * changed back to their original values after this call) + * + * This define is used in \ref canIoCtl(), \a buf and \a buflen refers to this + * functions arguments. + * + * Tells CANLIB to clear the CAN error counters. The contents of \a buf and \a + * buflen are ignored. CAN error counters on device side are NOT updated. + * + */ +#define canIOCTL_CLEAR_ERROR_COUNTERS 5 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a DWORD which contains the desired time-stamp clock + * resolution in microseconds. The default value is 1000 microseconds, i.e. + * one millisecond. + * + * \note The accuracy of the clock isn't affected. + */ +#define canIOCTL_SET_TIMER_SCALE 6 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a DWORD which contains + * + * \li 0: to turn Transmit Acknowledges off. + * \li 1: to turn Transmit Acknowledges on. + * \li 2: to turn Transmit Acknowledges off, even for the driver's internal + * usage. This might enhance performance but will cause some other APIs to + * stop working (for example, the current size of the transmit queue can not + * be read when this mode is active.) + * + * The default value is 0, Transmit Acknowledge is off. + */ +#define canIOCTL_SET_TXACK 7 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points at a \c DWORD which receives the current RX queue level. The + * returned value is approximative (this is because not all hardware supports + * retrieving the queue levels. In that case a best-effort guess is + * returned. Also note that a device with embedded CPU will report its queue + * levels to the host computer after a short delay that depends on the bus + * traffic intensity, and consequently the value returned by the call to + * \ref canIoCtl() might be a few milliseconds old.) + */ +#define canIOCTL_GET_RX_BUFFER_LEVEL 8 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points at a \c DWORD which receives the current TX queue level. The + * returned value is approximative (this is because not all hardware supports + * retrieving the queue levels. In that case a best-effort guess is + * returned. Also note that a device with embedded CPU will report its queue + * levels to the host computer after a short delay that depends on the bus + * traffic intensity, and consequently the value returned by the call to + * \ref canIoCtl() might be a few milliseconds old.) + */ +#define canIOCTL_GET_TX_BUFFER_LEVEL 9 + + /** + * This define is used in \ref canIoCtl(), \a buf and \a buflen refers to this + * functions arguments. + * + * Discard the current contents of the RX queue. The values of \a buf and \a + * buflen are ignored. + * + * \note This is the same thing as calling \ref canFlushReceiveQueue() + */ +#define canIOCTL_FLUSH_RX_BUFFER 10 + + /** + * This define is used in \ref canIoCtl(), \a buf and \a buflen refers to this + * functions arguments. + * + * Discard the current contents of the TX queue. The values of \a buf and \a + * buflen are ignored. + * + * \note This is the same thing as calling \ref canFlushTransmitQueue(). + */ +#define canIOCTL_FLUSH_TX_BUFFER 11 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD which contains the desired time-stamp clock + * resolution in microseconds. Note that the accuracy of the clock isn't + * affected. The default value is 1000 microseconds, i.e. one millisecond. + */ +#define canIOCTL_GET_TIMER_SCALE 12 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD which contains + * + * \li \c 0 to turn Transmit Requests off. + * \li \c 1 to turn Transmit Requests on. + * + * Default value is \c 0, Transmit Requests off. + */ +#define canIOCTL_SET_TXRQ 13 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points at a \c DWORD which receives a Windows Event handle which can + * be passed to the Win32 API \c WaitForSingleObject. The event is signaled + * when "something" (typically that a CAN message has been received or + * transmitted) happens in the driver. + * + * \note There is no more information available as to what happened when this + * call returns. The call may return on an "internal" event in CANLIB and your + * application must be prepared to handle this (i.e. go to sleep again.) + * + * \win_start + * \note If \ref canWaitForEvent() returns with success status (\ref canOK), you must call + * \ref canRead() repeatedly until it returns \ref canERR_NOMSG, before calling + * \ref canWaitForEvent() again. This will flush the driver's internal event queues. + * Failure to call \ref canRead() can cause \ref canWaitForEvent() to get stuck in a state + * where it always sleeps for the specified timeout and then returns with + * \ref canERR_TIMEOUT. + * + * \sa \ref canWaitForEvent() + * \win_end + * + * \note You must not set, reset, nor close this handle. Waiting on it is + * the only supported operation. + */ +#define canIOCTL_GET_EVENTHANDLE 14 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \note Not yet implemented. + */ +#define canIOCTL_SET_BYPASS_MODE 15 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +#define canIOCTL_SET_WAKEUP 16 + +#if defined(CANLIB_DECLARE_ALL) + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a HANDLE which receives the Windows handle related to the + * CANLIB handle. + */ +# define canIOCTL_GET_DRIVERHANDLE 17 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +# define canIOCTL_MAP_RXQUEUE 18 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +# define canIOCTL_GET_WAKEUP 19 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a unsigned char which contains + * + * \li \c 0 to turn access error reporting off, and + * \li \c 1 to turn access error reporting on. + * + * Default value is \c 0, access error reporting off. + */ +# define canIOCTL_SET_REPORT_ACCESS_ERRORS 20 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a unsigned char which receives the current setting of the access + * error reporting (0 or 1.) + */ +# define canIOCTL_GET_REPORT_ACCESS_ERRORS 21 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Connects the handle to the virtual bus number (0..31) which the \a buf + * points to. + */ +# define canIOCTL_CONNECT_TO_VIRTUAL_BUS 22 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Disonnects the handle from the virtual bus number (0..31) which the \a buf + * points to. + */ +# define canIOCTL_DISCONNECT_FROM_VIRTUAL_BUS 23 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \ref canUserIoPortData struct that contains a port number + * and a port value to set. This is used by special hardware only. + */ +# define canIOCTL_SET_USER_IOPORT 24 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \ref canUserIoPortData struct that contains a port + * number. After the call, the struct will contain the current value of the + * I/O port. This is used by special hardware only. + */ +# define canIOCTL_GET_USER_IOPORT 25 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +# define canIOCTL_SET_BUFFER_WRAPAROUND_MODE 26 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Use this function code to set the size of the receive buffer for a + * specific handle. \a buf points to an unsigned integer which contains the + * new size (number of messages) of the receive buffer. + * + * \note The receive buffer consumes system nonpaged pool memory, which is a + * limited resource. Do not increase the receive buffer size unless you + * have good reasons to do so. + * + * \note You can't use this function code when the channel is on bus. + */ +# define canIOCTL_SET_RX_QUEUE_SIZE 27 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +# define canIOCTL_SET_USB_THROTTLE 28 + + /** + * This define is used in \ref canIoCtl(). + * + * This is only intended for internal use. + */ +# define canIOCTL_GET_USB_THROTTLE 29 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a DWORD. If the value is zero, the CAN clock will not be + * reset at buson for the handle. Otherwise, the CAN clock will be reset at + * buson. + * + * Default value is \c 1, the CAN clock will be reset at buson. + */ +# define canIOCTL_SET_BUSON_TIME_AUTO_RESET 30 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Returns the state of the Transmit Acknowledge as a DWORD in \a buf: + * + * \li 0: Transmit Acknowledges is turned off. + * \li 1: Transmit Acknowledges is turned on. + * \li 2: Transmit Acknowledges is turned off, even for the driver's internal + * usage. + */ +# define canIOCTL_GET_TXACK 31 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to an unsigned byte. If the value is zero, the local transmit + * echo is turned off for the handle. Otherwise, local transmit echo is turned + * on. + * + * Local transmit echo is turned on by default on all handles. This means + * that if two handles are open on the same channel, and a message is + * transmitted on the first handle, it will be received as a normal message + * on the second handle. Use the \ref canIOCTL_SET_LOCAL_TXECHO function code to + * turn this function off, if it is not desired on a certain handle. + */ +# define canIOCTL_SET_LOCAL_TXECHO 32 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to an unsigned byte. If the value is zero, the reporting of + * error frames is turned off for the handle. Otherwise, error frame reporting + * is turned on. + * + * Default value is \c 1, error frame reporting is turned on. + */ +# define canIOCTL_SET_ERROR_FRAMES_REPORTING 33 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a 32-bit unsigned integer that receives the quality of + * the channel, where the quality is measured in percent of optimal quality. + * + * For a WLAN, -90 dBm and -35 dBm are considered 0% and 100%, respectively. + * + * The quality is 100% for any directly connected channel (USB, PCI etc.). + */ +# define canIOCTL_GET_CHANNEL_QUALITY 34 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD that contains the roundtrip time measured in + * milliseconds. + */ +# define canIOCTL_GET_ROUNDTRIP_TIME 35 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD that contains the \ref kvBUSTYPE_GROUP_xxx bus type. + */ +# define canIOCTL_GET_BUS_TYPE 36 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a CHAR array of at least 32 characters which receives the + * current device name as a \c NULL terminated ASCII string. + * + * If device name is not set or the device does not support this + * functionality, an error will be returned. + */ +# define canIOCTL_GET_DEVNAME_ASCII 37 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD that contains the time in milliseconds since the last + * communication occured. + * + * For WLAN devices, this is the time since the last keep-alive message. + */ +# define canIOCTL_GET_TIME_SINCE_LAST_SEEN 38 + + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Obtain the time reference list for MagiSync devices. + * + * \a buf points to an array of pairs of 64-bit ints, one of which + * will contain the reference number and the other one the timestamp + * in nanoseconds. + * + * \note This function is subject to change in future releases and is + * not supported by Kvaser. + */ +# define canIOCTL_GET_TREF_LIST 39 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * \a buf points to a \c DWORD that contains the number of microseconds + * the minimum CAN message transmit interval should be set to, or 0xffffffff + * to fetch the current setting. + * The minimum interval can not be set to more than one second. + * + * When a CAN channel goes bus on, the minimum interval is set to zero. + * I.e. CAN transmissions happen at the maximum speed the device is capable of. + * + * If the device does not support this functionality, or if an invalid + * minimum interval is requested, an error will be returned. + * + * \note The minimum CAN messages transmit interval applies to the physical CAN + * channel. It will thus affect all messages transmitted, even those sent + * using other CANlib handles to the same physical channel. The interval + * is defined as the time from the successful completion of one transmit + * to the beginning of the next one. + */ +# define canIOCTL_TX_INTERVAL 40 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * Some hardware have bitrate limits, which must be met when using any of \a canSetBusParams(), + * \a canSetBusParamsC200(), \a canGetBusParams() functions + * which can be overriden with this IOCTL. + * \a buf points to a \c long value that contains a user defined bitrate. + * A value of 0 means that the device should use its own default bitrate limit. + */ +# define canIOCTL_SET_BRLIMIT 43 + + /** + * Obsolete, use \ref canIOCTL_SET_THROTTLE_SCALED instead + */ +# define canIOCTL_SET_USB_THROTTLE_SCALED 41 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * This ioctl can be used to set the responsitivity of some devices. + * \a buf points to a \c DWORD that should contain a value between 0 and 100. + * A value of 0 means that the device should be very responsive and a value + * of 100 means that the device generates less cpu load or requires more bandwidth. + * Note that not all + * devices support this. Some hardware will accept this command but neglect it. + * This can be found out by reading the scaled throttle. + */ +# define canIOCTL_SET_THROTTLE_SCALED 41 + + /** + * Obsolete, use \ref canIOCTL_GET_THROTTLE_SCALED instead + */ +# define canIOCTL_GET_USB_THROTTLE_SCALED 42 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * This ioctl can be used to set the responsitivity of some devices. + * \a buf points to a \c DWORD that should contain a value between 0 and 100. + * A value of 0 means that the device should be very responsive and a value + * of 100 means that the device generates less cpu load or requires more bandwidth. + * Note that not all + * devices support this. Some hardware will accept this command but neglect it. + * This can be found out by reading the scaled throttle. + */ +# define canIOCTL_GET_THROTTLE_SCALED 42 + + /** + * This define is used in \ref canIoCtl(), \a buf mentioned below refers to this + * functions argument. + * + * This ioctl resets overrun count and flags, \sa \ref canReadStatus \sa \ref canGetBusStatistics + */ +# define canIOCTL_RESET_OVERRUN_COUNT 44 +#endif + /** @} */ + +#if defined(CANLIB_DECLARE_ALL) +/** Used in \ref canIOCTL_SET_USER_IOPORT and \ref canIOCTL_GET_USER_IOPORT. */ +typedef struct { + unsigned int portNo; ///< Port number used in e.g. \ref canIOCTL_SET_USER_IOPORT + unsigned int portValue; ///< Port value used in e.g. \ref canIOCTL_SET_USER_IOPORT +} canUserIoPortData; + +#endif + +#if defined(CANLIB_DECLARE_ALL) +/** + * \ingroup Notification and Waiting + * + * \source_cs static Canlib.canStatus canWaitForEvent(int hnd, ulong timeout); + * + * \source_delphi function canWaitForEvent(hnd: canHandle; timeout: Cardinal): canStatus; + * \source_end + * + * Waits for an event (of any kind) to happen at the specified CAN circuit, or + * a timeout to occur. An event in this context means for example the arrival + * of a CAN message or a CAN bus status change, but it can also be an event + * internal to the driver. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] timeout The number of milliseconds to wait before the call + * returns, if no event occurs. 0xFFFFFFFF gives an + * infinite timeout. + * + * \return \ref canOK (zero) if an event happened during the specified time + * period. + * \return \ref canERR_TIMEOUT (negative) if nothing happened during the specified + * time period. + * \return \ref canERR_xxx (negative) if failure. + * + * \sa \ref page_code_snippets_examples, + * \ref page_user_guide_send_recv_asynch_not + * \sa \ref canRead() + */ +canStatus CANLIBAPI canWaitForEvent (const CanHandle hnd, DWORD timeout); +#endif + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetBusParamsC200(int hnd, byte btr0, byte btr1); + * + * \source_delphi function canSetBusParamsC200(hnd: canHandle; btr0, btr1: byte): canStatus; + * \source_end + * + * This function sets the bus timing parameters using the same + * convention as the 82c200 CAN controller (which is the same as many + * other CAN controllers, for example, the 82527.) + * + * To calculate the bit timing parameters, you can use the bit timing + * calculator that is included with CANLIB SDK. Look in the BIN directory. + * + * 82c200 Bit Timing + * + * \li \a btr0 [b7..b6]: SJW - 1 + * \li \a btr0 [b5..b0]: Prescaler -1 + * \li \a btr1 [b7]: \c 1: 3 samples, \c 0: 1 samples + * \li \a btr1 [b6..b4]: tseg2 - 1 + * \li \a btr1 [b3..b0]: tseg1 - 2 + * + * \note CANLIB will always behave as if the clock frequency is 16 MHz. It does + * not matter if the device has a different physical clock, since this will be + * compensated for by the driver. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] btr0 The desired bit timing, formatted as the contents of the + * BTR0 register in the 82c200. + * \param[in] btr1 The desired bit timing, formatted as the contents of the + * BTR1 register in the 82c200. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * + * \sa \ref page_code_snippets_bit_rate, \ref page_user_guide_misc_bitrate + * \sa \ref canSetBusParams() + */ +canStatus CANLIBAPI canSetBusParamsC200 (const CanHandle hnd, unsigned char btr0, unsigned char btr1); + +#if defined(CANLIB_DECLARE_ALL) + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetDriverMode(int hnd, int lineMode, int resNet); + * + * \source_delphi function canSetDriverMode(hnd: canHandle; lineMode, resNet: Integer): canStatus; + * \source_end + * + * This function sets the current CAN bus driver mode. This is + * typically a mode like sleep, wakeup, standby, fast mode, etc. The + * different modes are almost always hardware dependent and requires + * special DRVcan cables. As an example, the DRVcan S implements J2411 + * compliant single-wire CAN and supports four line modes, namely + * Normal, Sleep, Fast and Wakeup. + * + * Standard ISO 11898 CAN do not support any of these bus driver modes. + * + * \note The bus driver mode is typically used to control things like one- or + * two-wire mode, sleep mode, and so on. It requires special support in the CAN + * driver circuit. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] lineMode An int which defines the line mode, + * \ref canTRANSCEIVER_LINEMODE_xxx. + * \param[in] resNet An int which defines the resnet mode. Set this parameter to + * \ref canTRANSCEIVER_RESNET_NA unless you have good reasons to set it + * to something else. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \win_start + * \sa \ref canGetDriverMode() + * \win_end + * + * \linux_start + * Not implemented. + * \linux_end + */ +canStatus CANLIBAPI canSetDriverMode (const CanHandle hnd, int lineMode, int resNet); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetDriverMode(int hnd, out int lineMode, out int resNet); + * + * \source_delphi function canGetDriverMode(hnd: canHandle; var lineMode: Integer; var resNet: Integer): canStatus; + * \source_end + * + * This function retrieves the current CAN bus driver mode. This is typically a + * mode like sleep, wakeup, standby, fast mode, etc. The different modes are + * almost always hardware dependent and requires special DRVcan cables. As an + * example, the DRVcan S implements J2411 compliant single-wire CAN and + * supports four line modes, namely Normal, Sleep, Fast and Wakeup. + * + * Standard ISO 11898 CAN do not support any of these bus driver modes. + * + * \note The bus driver mode is typically used to control things like one- or + * two-wire mode, sleep mode, and so on. It requires special support in the CAN + * driver circuit. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[out] lineMode A pointer to an int which receives the current line + * mode (\ref canTRANSCEIVER_LINEMODE_xxx). + * \param[out] resNet A pointer to an int which receives the current resnet + * mode. This value is usually + * \ref canTRANSCEIVER_RESNET_NA except for special DRVcan + * cables. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \win_start + * \sa \ref canSetDriverMode() + * \win_end + * + * \linux_start + * Not implemented. + * \linux_end + * + */ +canStatus CANLIBAPI canGetDriverMode (const CanHandle hnd, int *lineMode, int *resNet); +#endif + +/** + * \name canVERSION_CANLIB32_xxx + * \anchor canVERSION_CANLIB32_xxx + * @{ + * Item codes for canGetVersionEx(). + */ + + /** + * This define is used in \ref canGetVersionEx() and controls which version number + * that returned. + * + * Version number of the canlib32.dll file coded as an unsigned 16-bit word + * with the major version number in the upper byte and the minor version + * number in the lower byte. This version number is not related to the + * product version number of the whole CANLIB. For example, canlib32.dll + * belonging to CANLIB 2.27 would return 0x305. + */ +#define canVERSION_CANLIB32_VERSION 0 + + /** + * This define is used in \ref canGetVersionEx() and controls what type of version + * number that is returned. + * + * Product version number of canlib32.dll coded as an unsigned 16-bit word + * with the major version number in the upper byte and the minor version + * number in the lower byte. The product version number corresponds to the + * version number of the whole CANLIB. For example, canlib32.dll belonging to + * CANLIB 2.27 would return 0x21B. + */ +#define canVERSION_CANLIB32_PRODVER 1 + + /** + * This define is used in \ref canGetVersionEx() and controls what type of version + * number that is returned. + * + * Product version number of canlib32.dll coded as an unsigned 32-bit word + * where the bytes contain (in order from the most significant to the least + * significant byte) 0, major version number, minor version number, and the + * minor version letter. (The minor version letter is the ASCII code for the + * letter, or 0 (zero) if no letter). For example, CANLIB 3.8 would return + * 0x00030800 and CANLIB 3.8a would return 0x00030861. + */ +#define canVERSION_CANLIB32_PRODVER32 2 + + /** + * This define is used in \ref canGetVersionEx() and controls what type of version + * number that is returned. + * + * Returns 1 if the present version is a beta (preview) release, or 0 if it + * is an official release. + */ +#define canVERSION_CANLIB32_BETA 3 +/** @} */ + +#if defined(CANLIB_DECLARE_ALL) + +/** + * \ingroup Information Services + * + * \source_cs static int canGetVersionEx(int itemCode); + * + * \source_delphi function canGetVersionEx(itemCode: Cardinal): Cardinal; + * \source_end + * + * This function returns various version numbers from the driver routines. + * + * \param[in] itemCode Specifies which version number to retrieve. See + * \ref canVERSION_CANLIB32_xxx + * + * \return The return value is desired version number. + * + * \sa \ref page_user_guide_build_driver_version + */ +unsigned int CANLIBAPI canGetVersionEx (unsigned int itemCode); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamGetCount(); + * + * \source_delphi function canParamGetCount(): canStatus; + * \source_end + * + * This function returns the number of entries in the table of named + * channels. + * + * \return The number of channels (zero or positive) + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * + */ +canStatus CANLIBAPI canParamGetCount (void); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamCommitChanges(); + * + * \source_delphi function canParamCommitChanges(): canStatus; + * \source_end + * + * This function writes the current set of named parameters to the + * Registry. Previous entries are erased. + * + * The named parameters are stored in the + * \c HKEY_LOCAL_MACHINE\\SOFTWARE\\KVASER \c AB\\CANLIB32\\PredefinedBitrates + * key in the Registry. + * + * \note You must have Administrator's rights to write to the Registry. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * + */ +canStatus CANLIBAPI canParamCommitChanges (void); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamDeleteEntry(int index); + * + * \source_delphi function canParamDeleteEntry(index: Integer): canStatus; + * \source_end + * + * This function deletes the entry in the table of named parameter settings + * with the given index. The entries below (i.e. with higher indices) the + * deleted entry are moved up one step in the table. + * + * The named parameters are stored in the + * \c HKEY_LOCAL_MACHINE\\SOFTWARE\\KVASER \c AB\\CANLIB32\\PredefinedBitrates + * key in the Registry. + * + * \param[in] index The index of the entry to delete. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCreateNewEntry(), \ref canParamCommitChanges() + */ +canStatus CANLIBAPI canParamDeleteEntry (int index); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static int canParamCreateNewEntry(); + * + * \source_delphi function canParamCreateNewEntry(): canStatus; + * \source_end + * + * This function creates a new entry in the table of named parameter + * settings. + * + * The named parameters are stored in the + * \c HKEY_LOCAL_MACHINE\\SOFTWARE\\KVASER \c AB\\CANLIB32\\PredefinedBitrates + * key in the Registry. + * + * \return The index of the created entry (zero or positive) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamDeleteEntry() + * + */ +canStatus CANLIBAPI canParamCreateNewEntry (void); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamSwapEntries(int index1, int index2); + * + * \source_delphi function canParamSwapEntries(index1, index2: Integer): canStatus; + * \source_end + * + * This function swaps two entries in the list of named + * parameters. + * + * The named parameters are stored in the + * \c HKEY_LOCAL_MACHINE\\SOFTWARE\\KVASER \c AB\\CANLIB32\\PredefinedBitrates + * key in the Registry. + * + * \param[in] index1 The first of the two entries that are to be swapped in the + * named parameters list. + * \param[in] index2 The second of the two entries that are to be swapped in the + * named parameters list. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges() + * + */ +canStatus CANLIBAPI canParamSwapEntries (int index1, int index2); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamGetName(int index, ref string str_buf); + * + * \source_delphi function canParamGetName(index: Integer; buffer: PChar; maxlen: Integer): canStatus; + * \source_end + * + * This function returns the name of a given entry in the list of + * named parameters. + * + * The named parameters are stored in the + * \c HKEY_LOCAL_MACHINE\\SOFTWARE\\KVASER \c AB\\CANLIB32\\PredefinedBitrates + * key in the Registry. + * + * \param[in] index The index of the entry in the named parameters list, whose + * name is to be returned. + * \param[out] buffer A pointer to a buffer that is to receive a + * \c NULL terminated string which contains the name. The + * buffer is allocated and deallocated by the user. + * \param[in] maxlen The length of the buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamSetName(), \ref canParamCommitChanges() + */ +canStatus CANLIBAPI canParamGetName (int index, char *buffer, int maxlen); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static int canParamGetChannelNumber(int index); + * + * \source_delphi function canParamGetChannelNumber(index: Integer): canStatus; + * \source_end + * + * This function returns the channel number of the entry with the + * given index in the table of named parameter settings. + * + * \param[in] index The index of the entry in the table of named parameter + * settings. + * + * \return The channel number of the entry in question (zero or positive) + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamGetChannelNumber() + */ +canStatus CANLIBAPI canParamGetChannelNumber (int index); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamGetBusParams(int index, out int bitrate, out int tseg1, out int tseg2, out int sjw, out int noSamp); + * + * \source_delphi function canParamGetBusParams(index: Integer; var bitrate: LongInt; var tseg1: Cardinal; var tseg2: Cardinal; var sjw: Cardinal; var nosamp: Cardinal): canStatus; + * \source_end + * + * This function retrieves the bus parameters associated with the + * entry with the given index in the table of named parameter + * settings. + * + * \param[in] index The index of the entry in the table of named parameter + * settings. + * \param[out] bitrate Bit rate (bits per second). + * \param[out] tseg1 Time segment 1, that is, the number of quanta from (but + * not including) the Sync Segment to the sampling point. + * \param[out] tseg2 Time segment 2, that is, the number of quanta from the + * sampling point to the end of the bit. + * \param[out] sjw The Synchronization Jump Width. + * \param[out] noSamp The number of sampling points; can be 1 or 3. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamSetBusParams() + */ +canStatus CANLIBAPI canParamGetBusParams (int index, + long* bitrate, + unsigned int *tseg1, + unsigned int *tseg2, + unsigned int *sjw, + unsigned int *noSamp); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamSetName(int index, string str_buf); + * + * \source_delphi function canParamSetName(index: Integer; buffer: PChar): canStatus; + * \source_end + * + * This function sets or changes the name of a named parameter. + * + * \param[in] index The index of the named parameter whose name is to be + * changed or set. + * \param[out] buffer A pointer to a \c NULL terminated string that contains the + * new name. If the string is longer than the maximum + * allowed name length, it is truncated. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamGetName() + */ +canStatus CANLIBAPI canParamSetName (int index, const char *buffer); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamSetChannelNumber(int index, int channel); + * + * \source_delphi function canParamSetChannelNumber(index, channel: Integer): canStatus; + * \source_end + * + * This function sets the channel number for a specified entry in the list of + * named parameters. Channels are numbered from 0 and up. + * + * \param[in] index The index of the entry in the named parameter list whose + * channel number is to be set. + * \param[in] channel The channel number. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamGetChannelNumber() + */ +canStatus CANLIBAPI canParamSetChannelNumber (int index, int channel); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamSetBusParams(int index, int bitrate, int tseg1, int tseg2, int sjw, int noSamp); + * + * \source_delphi function canParamSetBusParams(index: Integer; bitrate: longint; tseq1, tseq2, sjw, noSamp: Cardinal): canStatus; + * \source_end + * + * This function sets or changes the bus parameters for a given entry in the + * list of named parameters. + * + * \note The bus parameters are not checked for validity. + * + * \param[in] index The index of the entry in the named parameter list whose + * parameters are to be set or changed. + * \param[in] bitrate Bit rate (measured in bits per second); or one of the + * predefined constants \ref canBITRATE_xxx. + + * \param[in] tseg1 Time segment 1, that is, the number of quanta from (but not + * including) the Sync Segment to the sampling point. + * \param[in] tseg2 Time segment 2, that is, the number of quanta from the + * sampling point to the end of the bit. + + * \param[in] sjw The Synchronization Jump Width. + * \param[in] noSamp The number of sampling points; can be 1 or 3. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges(), \ref canParamGetBusParams() + */ +canStatus CANLIBAPI canParamSetBusParams (int index, + long bitrate, + unsigned int tseg1, + unsigned int tseg2, + unsigned int sjw, + unsigned int noSamp); + +/** + * \ingroup NamedParameterSettings + * + * \source_cs static Canlib.canStatus canParamFindByName(string str_name); + * + * \source_delphi function canParamFindByName(const Name: PChar):canStatus; + * \source_end + * + * This function returns the index of the parameter setting with the + * given name. + * + * \param[in] name A pointer to a string containing the name of the setting. + * + * \return The index of the setting (zero or positive) if success. + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_misc_named_parameters + * \sa \ref canParamCommitChanges() + */ +canStatus CANLIBAPI canParamFindByName (const char *name); +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufFreeAll(int handle); + * + * \source_delphi function canObjBufFreeAll(handle: canHandle): canStatus; + * \source_end + * + * Deallocates all object buffers on the specified handle. The + * buffers cannot be referenced after this operation. + * + * \param[in] hnd An open handle to a CAN circuit. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + * \sa \ref canObjBufFree(), \ref canObjBufAllocate() + */ +canStatus CANLIBAPI canObjBufFreeAll (const CanHandle hnd); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufAllocate(int handle, int type); + * + * \source_delphi function canObjBufAllocate(handle: canHandle; tp: Integer): canStatus; + * \source_end + * + * Allocates an object buffer associated with a handle to a CAN + * circuit. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] type The type of the buffer. Must be one of \ref canOBJBUF_TYPE_xxx + * + * \return A buffer index (zero or positive) if success. + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + * \sa \ref canObjBufFree(), \ref canObjBufFreeAll() + */ +canStatus CANLIBAPI canObjBufAllocate (const CanHandle hnd, int type); + + /** + * \name canOBJBUF_TYPE_xxx + * \anchor canOBJBUF_TYPE_xxx + * + * Used in \ref canObjBufAllocate(). + * + * @{ + */ +#define canOBJBUF_TYPE_AUTO_RESPONSE 0x01 ///< The buffer is an auto-response buffer. +#define canOBJBUF_TYPE_PERIODIC_TX 0x02 ///< The buffer is an auto-transmit buffer. + /** @} */ + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufFree(int handle, int idx); + * + * \source_delphi function canObjBufFree(handle: canHandle; idx: Integer): canStatus; + * \source_end + * + * Deallocates the object buffer with the specified index. The buffer + * can not be referenced after this operation. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The object buffer to deallocate. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + * \sa \ref canObjBufFreeAll(), \ref canObjBufAllocate(), + */ +canStatus CANLIBAPI canObjBufFree (const CanHandle hnd, int idx); + +// Writes CAN data to the object buffer with the specified index. + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufWrite(int handle, int idx, int id, byte[] msg, int dlc, int flags); + * + * \source_delphi function canObjBufWrite(handle: canHandle; idx, id: Integer; var msg; dlc, flags: cardinal): canStatus; + * \source_end + * + * Defines the contents of a specific object buffer. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The index of the object buffer whose contents is to be + * defined. + * \param[in] id The CAN identifier of the message. + * \param[in] msg Points to the contents of the message. + * \param[in] dlc The length of the message in bytes.
+ For Classic CAN dlc can be at most 8, unless \ref canOPEN_ACCEPT_LARGE_DLC is used.
+ For CAN FD dlc can be one of the following 0-8, 12, 16, 20, 24, 32, 48, 64. + * \param[in] flags Message flags; a combination of the \ref canMSG_xxx flags. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufWrite (const CanHandle hnd, + int idx, + int id, + void* msg, + unsigned int dlc, + unsigned int flags); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufSetFilter(int handle, int idx, int code, int mask); + * + * \source_delphi function canObjBufSetFilter(handle: canHandle; idx: Integer; code, mask: Cardinal): canStatus; + * \source_end + * + * Defines a message reception filter on the specified object buffer. + * Messages not matching the filter are discarded. + * + * \note For an auto response buffer, set the code and mask that together define + * the identifier(s) that trigger(s) the automatic response. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The index of the object buffer on which the filter is to be + * set. + * \param[in] code The acceptance code in the filter. + * \param[in] mask The acceptance mask in the filter. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \win_start \ref page_user_guide_misc_code_and_mask, \win_end + * \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufSetFilter (const CanHandle hnd, + int idx, + unsigned int code, + unsigned int mask); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufSetFlags(int handle, int idx, int flags); + * + * \source_delphi function canObjBufSetFlags(handle: canHandle; idx: Integer; flags: Cardinal): canStatus; + * \source_end + * + * Sets object buffer flags on a specified object buffer. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The buffer on which the flags are to be set. + * \param[in] flags Specifies a combination of zero or more of the + * \ref canOBJBUF_AUTO_RESPONSE_xxx flag values + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufSetFlags (const CanHandle hnd, + int idx, + unsigned int flags); + +/** + * \name canOBJBUF_AUTO_RESPONSE_xxx + * \anchor canOBJBUF_AUTO_RESPONSE_xxx + * + * These defines are used in \ref canObjBufSetFlags(). + * + * @{ + */ + /** + * This define is used in \ref canObjBufSetFlags(). + * + * For auto-response buffers only. When this flag is in effect, the buffer + * will auto-respond to remote requests only. If this flag is not in effect, + * the buffer will auto-respond to both remote requests and ordinary data + * frames. + * + */ +# define canOBJBUF_AUTO_RESPONSE_RTR_ONLY 0x01 + /** @} */ + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufSetPeriod(int hnd, int idx, int period); + * + * \source_delphi function canObjBufSetPeriod(handle: canHandle; idx: Integer; period: Cardinal): canStatus; + * \source_end + * + * The \ref canObjBufSetPeriod function sets the transmission period for an auto + * transmission object buffer. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] idx The index of a CAN object buffer. + * \param[in] period The transmission interval, in microseconds. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufSetPeriod (const CanHandle hnd, + int idx, + unsigned int period); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufSetMsgCount(int hnd, int idx, int count); + * + * \source_delphi function canObjBufSetMsgCount(handle: canHandle; idx: Integer; count: Cardinal): canStatus; + * \source_end + * + * The \ref canObjBufSetMsgCount function sets the message count for an auto + * transmit object buffer. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] idx The index of a CAN object buffer. + * \param[in] count The message count. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufSetMsgCount (const CanHandle hnd, + int idx, + unsigned int count); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufEnable(int handle, int idx); + * + * \source_delphi function canObjBufEnable(handle: canHandle; idx: Integer): canStatus; + * \source_end + * + * Enables the object buffer with the specified index. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The index of the object buffer to enable. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + * \sa \ref canObjBufDisable() + */ +canStatus CANLIBAPI canObjBufEnable (const CanHandle hnd, int idx); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufDisable(int handle, int idx); + * + * \source_delphi function canObjBufDisable(handle: canHandle; idx: Integer): canStatus; + * \source_end + * + * Disables the object buffer with the specified index. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] idx The index of the buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + * \sa \ref canObjBufEnable() + */ +canStatus CANLIBAPI canObjBufDisable (const CanHandle hnd, int idx); + +/** + * \ingroup ObjectBuffers + * + * \source_cs static Canlib.canStatus canObjBufSendBurst(int hnd, int idx, int burstlen); + * + * \source_delphi function canObjBufSendBurst(handle: canHandle; idx: Integer; burstLen: Cardinal): canStatus; + * \source_end + * + * The canObjBufSendBurst function sends a burst of CAN messages. You have to + * set up an object buffer first with the message to send. The messages will be + * sent as fast as possible from the hardware. + * + * This function is inteneded for certain diagnostic applications. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] idx The index of a CAN object buffer. + * \param[in] burstlen The number of messages to send. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_user_guide_send_recv_obj_buf + */ +canStatus CANLIBAPI canObjBufSendBurst (const CanHandle hnd, + int idx, + unsigned int burstlen); + +/** + * \name canVERSION_xxx + * \anchor canVERSION_xxx + * + * These defines are used in \ref canProbeVersion(). + * + * @{ + */ + /** + * This define is used in \ref canProbeVersion(), \a major and \a minor refer to + * this functions arguments. + * + * Require that exactly the version specified by \a major and \a minor be + * present. Earlier and later versions are not accepted. This flag does not + * affect the acceptance of beta versions. + */ +#define canVERSION_DONT_ACCEPT_LATER 0x01 + /** + * This define is used in \ref canProbeVersion(), \a major and \a minor refer to + * this functions arguments. + * + * Return FALSE if a beta version (preview version) of CANLIB is installed, + * regardless of its version number. + */ +#define canVERSION_DONT_ACCEPT_BETAS 0x02 + /** @} */ + +/** + * \ingroup General + * + * \source_cs static bool canProbeVersion(int hnd, int major, int minor, int oem_id, int flags); + * + * \source_delphi function canProbeVersion(handle: canHandle; major, minor, oem_id: Integer; flags: Cardinal): Boolean; + * \source_end + * + * This function checks whether a specific version of CANLIB is installed on + * the system. + * + * The default behaviour of \ref canProbeVersion is to accept + * + * \li the version specified by \a major and \a minor, and + * \li any later version, and + * \li all beta versions. + * + * You get the default behaviour by setting \a flags to 0. Use any + * combination of the \ref canVERSION_xxx flags to modify the behaviour. + * + * \note Different handles might have different driver versions installed. This + * should not normally be the case but it might happen anyway. You should check + * the version for each handle you open, e.g. directly after calling + * \ref canOpenChannel(). + * + * \param[in] hnd A handle to an open circuit. + * \param[in] major The major version number of the version to test for. + * \param[in] minor The minor version number of the version to test for. + * \param[in] oem_id Reserved, must be zero. + * \param[in] flags Any combination of the \ref canVERSION_xxx flags, or 0. + * + * \return TRUE if the specified version of CANLIB is installed on the system. + * + * \sa \ref page_user_guide_build_driver_version + * \sa \ref page_code_snippets_examples + * \sa \ref canGetVersion(), \ref canGetVersionEx(), \ref canGetChannelData() + */ +BOOL CANLIBAPI canProbeVersion (const CanHandle hnd, + int major, + int minor, + int oem_id, + unsigned int flags); +#endif + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canResetBus(int handle); + * + * \source_delphi function canResetBus(handle: canHandle): canStatus; + * \source_end + * + * This function tries to reset a CAN bus controller by taking the channel off + * bus and then on bus again (if it was on bus before the call to \ref canResetBus().) + * + * This function will affect the hardware (and cause a real reset of the CAN + * chip) only if \a hnd is the only handle open on the channel. If there + * are other open handles, this operation will not affect the hardware. + * + * \param[in] hnd A handle to an open circuit. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canBusOn(), \ref canBusOff() + */ +canStatus CANLIBAPI canResetBus (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canWriteWait(int handle, int id, byte[] msg, int dlc, int flag, long timeout); + * + * \source_delphi function canWriteWait(handle: canHandle; id: longint; var msg; dlc, flag, timeout : Cardinal): canStatus; + * \source_end + * + * This function sends a CAN message. It returns when the message is sent, or + * the timeout expires. + * + * This is a convenience function that combines \ref canWrite() and \ref canWriteSync(). + * + * If you are using the same channel via multiple handles, note that the + * default behaviour is that the different handles will "hear" each other just as + * if each handle referred to a channel of its own. If you open, say, channel 0 + * from thread A and thread B and then send a message from thread A, it will be + * "received" by thread B. + * This behaviour can be changed using \ref canIOCTL_SET_LOCAL_TXECHO. + * + * \param[in] hnd A handle to an open CAN circuit. + * \param[in] id The identifier of the CAN message to send. + * \param[in] msg A pointer to the message data, or \c NULL. + * \param[in] dlc The length of the message in bytes.
+ For Classic CAN dlc can be at most 8, unless \ref canOPEN_ACCEPT_LARGE_DLC is used.
+ For CAN FD dlc can be one of the following 0-8, 12, 16, 20, 24, 32, 48, 64. + * \param[in] flag A combination of message flags, \ref canMSG_xxx. + * Use this parameter to send extended (29-bit) frames + * and/or remote frames. Use \ref canMSG_EXT and/or + * \ref canMSG_RTR for this purpose. + * \param[in] timeout The timeout, in milliseconds. 0xFFFFFFFF gives an + * infinite timeout. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +canStatus CANLIBAPI canWriteWait (const CanHandle hnd, + long id, + void *msg, + unsigned int dlc, + unsigned int flag, + unsigned long timeout); + + +#if defined(CANLIB_DECLARE_ALL) + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus canUnloadLibrary(); + * + * \source_delphi function canUnloadLibrary: Integer; + * \source_end + * + * \win_start + * Use this function if you are loading CANLIB32.DLL dynamically (that is, + * using the Win32 API \c LoadLibrary) and need to unload it using the Win32 + * API \c FreeLibrary. \ref canUnloadLibrary() will free allocated memory, unload + * the DLLs canlib32.dll has loaded and de-initialize data structures. You must + * call \ref canInitializeLibrary() again to use the API functions in canlib32.dll. + * \win_end + * \linux_start + * \ref canUnloadLibrary() will close all open handles and free allocated memory. + * \linux_end + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canInitializeLibrary() + */ +canStatus CANLIBAPI canUnloadLibrary (void); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetAcceptanceFilter(int hnd, int code, int mask, int is_extended); + * + * \source_delphi function canSetAcceptanceFilter(handle: canHandle; code, mask: Cardinal; is_extended: Integer): canStatus; + * \source_end + * + * This routine sets the message acceptance filters on a CAN channel. + * + * Format of \a code and \a mask: + * + * \li A binary 1 in a mask means "the corresponding bit in the code is + * relevant" + * \li A binary 0 in a mask means "the corresponding bit in the code is not + * relevant" + * \li A relevant binary 1 in a code means "the corresponding bit in the + * identifier must be 1" + * \li A relevant binary 1 in a code means "the corresponding bit in the + * identifier must be 1" + * + * In other words, the message is accepted if ((code XOR id) AND mask) == 0. + * + * \a extended should be set to: + * + * \li \c 0 (FALSE): if the code and mask shall apply to 11-bit CAN identifiers. + * \li \c 1 (TRUE): if the code and mask shall apply to 29-bit CAN identifiers. + * + * If you want to remove a filter, call \ref canSetAcceptanceFilter() with the mask + * set to \c 0. + * + * On some boards the acceptance filtering is done by the CAN hardware; on + * other boards (typically those with an embedded CPU,) the acceptance + * filtering is done by software. \ref canSetAcceptanceFilter() behaves in the same + * way for all boards, however. + * + * \ref canSetAcceptanceFilter() and \ref canAccept() both serve the same purpose but the + * former can set the code and mask in just one call. + * + * \note You can set the extended code and mask only on CAN boards that support + * extended identifiers. + * + * \note Not all CAN boards support different masks for standard and + * extended CAN identifiers. + * + * \param[in] hnd An open handle to a CAN circuit. + * \param[in] code The acceptance code to set. + * \param[in] mask The acceptance mask to set. + * \param[in] is_extended Select 29-bit CAN identifiers. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples, + * \ref page_user_guide_misc_code_and_mask + * \sa \ref canAccept() + */ +canStatus CANLIBAPI canSetAcceptanceFilter (const CanHandle hnd, + unsigned int code, + unsigned int mask, + int is_extended); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canFlushReceiveQueue(int hnd); + * + * \source_delphi function canFlushReceiveQueue(handle: canHandle): canStatus; + * \source_end + * + * This function removes all received messages from the handle's receive queue. + * Other handles open to the same channel are not affcted by this + * operation. That is, only the messages belonging to the handle you are + * passing to \ref canFlushReceiveQueue are discarded. + * + * \note This call has the same effect as calling \ref canIoCtl() with a function + * code of \ref canIOCTL_FLUSH_RX_BUFFER. + * + * \param[in] hnd A handle to an open circuit. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canFlushTransmitQueue() + */ +canStatus CANLIBAPI canFlushReceiveQueue (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canFlushTransmitQueue(int hnd); + * + * \source_delphi function canFlushTransmitQueue(handle: canHandle): canStatus; + * \source_end + * + * This function removes all messages pending transmission from the + * transmit queue of the circuit. + * + * \note If there are other handles open to the same circuit, they are also + * flushed. + * + * \note This call has the same effect as calling \ref canIoCtl() with a function + * code of \ref canIOCTL_FLUSH_TX_BUFFER. + * + * \param[in] hnd A handle to an open circuit. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canFlushReceiveQueue() + */ +canStatus CANLIBAPI canFlushTransmitQueue (const CanHandle hnd); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvGetApplicationMapping(int busType, string appName, int appChannel, out int resultingChannel); + * + * \source_delphi function kvGetApplicationMapping(busType: Integer; appName: PChar; appChannel: Integer; var resultingChannel: Integer): canStatus; + * \source_end + * + * \note The \ref kvGetApplicationMapping function is presently not implemented. + * + * \param busType + * \param appName + * \param appChannel + * \param resultingChannel + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI kvGetApplicationMapping (int busType, + char *appName, + int appChannel, + int *resultingChannel); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvBeep(int hnd, int freq, int duration); + * + * \source_delphi function kvBeep(handle: canHandle; freq: Integer; duration: Cardinal): canStatus; + * \source_end + * + * The \ref kvBeep function emits a sound of a specific frequency and duration from + * the loudspeaker on the device. + * + * \note This function requires that a loudspeaker be present on the hardware. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] freq The frequency (in Hertz) of the sound. + * \param[in] duration The duration of the sound, in milliseconds. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI kvBeep (const CanHandle hnd, + int freq, + unsigned int duration); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvSelfTest(int hnd, out int presults); + * + * \source_delphi function kvSelfTest(handle: canHandle; var presults: Cardinal): canStatus; + * \source_end + * + * The \ref kvSelfTest function runs a built-in self test in the device. Note that + * not all devices supports built-in self tests. + * + * \param[in] hnd An open hnd to a CAN channel. + * \param[out] presults A pointer to a 32-bit unsigned integer where the + * resuls of the self test will be placed. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI kvSelfTest (const CanHandle hnd, unsigned long *presults); + + /** + * \anchor kvLED_ACTION_xxx + * \name kvLED_ACTION_xxx + * + * The following constants can be used together with the \ref kvFlashLeds() function. + * + * @{ + */ +#define kvLED_ACTION_ALL_LEDS_ON 0 ///< Turn all LEDs on. +#define kvLED_ACTION_ALL_LEDS_OFF 1 ///< Turn all LEDs off. +#define kvLED_ACTION_LED_0_ON 2 ///< Turn LED 0 on. +#define kvLED_ACTION_LED_0_OFF 3 ///< Turn LED 0 off. +#define kvLED_ACTION_LED_1_ON 4 ///< Turn LED 1 on. +#define kvLED_ACTION_LED_1_OFF 5 ///< Turn LED 1 off. +#define kvLED_ACTION_LED_2_ON 6 ///< Turn LED 2 on. +#define kvLED_ACTION_LED_2_OFF 7 ///< Turn LED 2 off. +#define kvLED_ACTION_LED_3_ON 8 ///< Turn LED 3 on. +#define kvLED_ACTION_LED_3_OFF 9 ///< Turn LED 3 off. +#define kvLED_ACTION_LED_4_ON 10 ///< Turn LED 4 on. +#define kvLED_ACTION_LED_4_OFF 11 ///< Turn LED 4 off. +#define kvLED_ACTION_LED_5_ON 12 ///< Turn LED 5 on. +#define kvLED_ACTION_LED_5_OFF 13 ///< Turn LED 5 off. +#define kvLED_ACTION_LED_6_ON 14 ///< Turn LED 6 on. +#define kvLED_ACTION_LED_6_OFF 15 ///< Turn LED 6 off. +#define kvLED_ACTION_LED_7_ON 16 ///< Turn LED 7 on. +#define kvLED_ACTION_LED_7_OFF 17 ///< Turn LED 7 off. +#define kvLED_ACTION_LED_8_ON 18 ///< Turn LED 8 on. +#define kvLED_ACTION_LED_8_OFF 19 ///< Turn LED 8 off. +#define kvLED_ACTION_LED_9_ON 20 ///< Turn LED 9 on. +#define kvLED_ACTION_LED_9_OFF 21 ///< Turn LED 9 off. +#define kvLED_ACTION_LED_10_ON 22 ///< Turn LED 10 on. +#define kvLED_ACTION_LED_10_OFF 23 ///< Turn LED 10 off. +#define kvLED_ACTION_LED_11_ON 24 ///< Turn LED 11 on. +#define kvLED_ACTION_LED_11_OFF 25 ///< Turn LED 11 off. + + /** @} */ + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvFlashLeds(int hnd, int action, int timeout); + * + * \source_delphi function kvFlashLeds(handle: canHandle; action: Integer; timeout: Integer): canStatus; + * \source_end + * + * The \ref kvFlashLeds function will turn the LEDs on the device on or off. + * + * \param[in] hnd + * \param[in] action One of the \ref kvLED_ACTION_xxx constants, defining + * which LED to turn on or off. + * \param[in] timeout Specifies the time, in milliseconds, during which the + * action is to be carried out. When the timeout expires, + * the LED(s) will return to its ordinary function. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +canStatus CANLIBAPI kvFlashLeds (const CanHandle hnd, int action, int timeout); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canRequestChipStatus(int hnd); + * + * \source_delphi function canRequestChipStatus(handle: canHandle): canStatus; + * \source_end + * + * \win_start + * The canRequestChipStatus function requests that the hardware report the chip + * status (bus on/error passive status etc.) to the driver. The chip status can + * later be retrieved using the \ref canReadStatus() function. + * + * \note The \ref canRequestChipStatus() function is asynchronous, that is, it + * completes before the answer is returned from the hardware. The time between + * a call to \ref canRequestChipStatus() and the point in time where the chip status + * is actually available via a call to \ref canReadStatus() is not + * defined. \ref canReadStatus() always returns the latest data reported by the + * hardware. + * \win_end + * \linux_start + * This function is a dummy implementation for code portability. The Linux + * implementation of \ref canReadStatus() will return the latest status without + * need of an additional call to canRequestChipStatus(), unlike the Windows + * counterpart. + * \linux_end + * + * \param[in] hnd An open handle to a CAN channel. + * + * \win_start + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * \win_end + * \linux_start + * \return \ref canOK (zero) + * \linux_end + * + * \sa \ref canReadStatus() + */ +canStatus CANLIBAPI canRequestChipStatus (const CanHandle hnd); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canRequestBusStatistics(int hnd); + * + * \source_delphi function canRequestBusStatistics(handle: canHandle): canStatus; + * \source_end + * + * The \ref canRequestBusStatistics function requests bus statistics from the + * hardware. The bus statistics figures can be retrieved later by a call to the + * \ref canGetBusStatistics function. + * + * \note The time between a call to \ref canRequestBusStatistics() and the point in + * time where the bus statistics is actually available via a call to + * \ref canGetBusStatistics() is not defined. Typically, you would call + * \ref canRequestBusStatistics() from your application periodically (for example, + * once per second) to request the data from the driver and then call + * \ref canGetBusStatistics() with the same rate to obtain the latest reported data. + * + * \param[in] hnd An open handle to a CAN channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canGetBusStatistics() + */ +canStatus CANLIBAPI canRequestBusStatistics (const CanHandle hnd); + + /** + * \ingroup CAN + * This struct is returned by \ref canGetBusStatistics() + * + * The values are cleared when the corresponding channel goes on bus. + */ +typedef struct canBusStatistics_s { + unsigned long stdData; ///< Number of received standard (11-bit identifiers) data frames. + unsigned long stdRemote; ///< Number of received standard (11-bit identifiers) remote frames. + unsigned long extData; ///< Number of received extended (29-bit identifiers) data frames. + unsigned long extRemote; ///< Number of received extended (29-bit identifiers) remote frames. + unsigned long errFrame; ///< Number of error frames + + /** + * The bus load, expressed as an integer in the interval 0 - 10000 + * representing 0.00% - 100.00% bus load. + */ + unsigned long busLoad; + unsigned long overruns; ///< The number of overruns detected by the hardware, firmware or driver. +} canBusStatistics; + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetBusStatistics(int hnd, out Canlib.canBusStatistics stat); + * + * \source_delphi function canGetBusStatistics(handle: canHandle; var stat: canBusStatistics; bufsiz: Cardinal): canStatus; + * \source_end + * + * The \ref canGetBusStatistics() function retrieves the latest bus statistics + * figures reported by the driver. You request the bus statistics from the + * driver by calling the \ref canRequestBusStatistics() function. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] stat A pointer to a \ref canBusStatistics struct that will receive + * the bus statistics figures. + * \param[in] bufsiz The size, in bytes, of the stat buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canRequestBusStatistics() + */ +canStatus CANLIBAPI canGetBusStatistics (const CanHandle hnd, + canBusStatistics *stat, + size_t bufsiz); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canSetBitrate(int hnd, int bitrate); + * + * \source_delphi function canSetBitrate(handle: canHandle; bitrate: Integer): canStatus; + * \source_end + * + * The \ref canSetBitrate() function sets the nominal bit rate of the specified + * CAN channel. The sampling point is recalculated and kept as close as + * possible to the value before the call. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] bitrate The new bit rate, in bits/second. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canSetBusParamsC200(), \ref canSetBusParams(), \ref canGetBusParams() + */ +canStatus CANLIBAPI canSetBitrate (const CanHandle hnd, int bitrate); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvAnnounceIdentity(int hnd, object buffer); + * + * \source_delphi function kvAnnounceIdentity(handle: canHandle; var buf; bufsiz: Cardinal): canStatus; + * \source_end + * + * The \ref kvAnnounceIdentity function is used by certain OEM applications. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] buf A pointer to the data to be sent to the driver. + * \param[in] bufsiz The size, in bytes, of the buffer that buf points to. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +canStatus CANLIBAPI kvAnnounceIdentity (const CanHandle hnd, + void *buf, + size_t bufsiz); +/** + * \ingroup General + * + * The \ref kvAnnounceIdentityEx function is used by certain OEM applications. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] type Type of announcement. + * \param[out] buf A pointer to the data to be sent to the driver. + * \param[in] bufsiz The size, in bytes, of the buffer that buf points to. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +canStatus CANLIBAPI kvAnnounceIdentityEx (const CanHandle hnd, + int type, + void *buf, + size_t bufsiz); + +/** + * \ingroup CAN + * + * \source_cs static Canlib.canStatus canGetHandleData(int hnd, int item, out object buffer); + * + * \source_delphi function canGetHandleData(handle: canHandle; item: Integer; var Buffer; bufsize: Cardinal): canStatus; + * \source_end + * + * \note This function can be used to retrieve certain pieces of information about an open handle to a CANlib channel. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] item This parameter specifies what data to obtain for the specified handle. The value is one of the constants \ref canCHANNELDATA_xxx + * \param[out] buffer The address of a buffer which is to receive the data. + * \param[in] bufsize The size of the buffer to which the buffer parameter points. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canGetChannelData() + */ +canStatus CANLIBAPI canGetHandleData (const CanHandle hnd, + int item, + void *buffer, + size_t bufsize); + +/** Used for time domain handling. */ +typedef void *kvTimeDomain; + +/** Contains status codes according to \ref canSTAT_xxx. */ +typedef canStatus kvStatus; + +/** + * \ingroup TimeDomainHandling + * + * Used for time domain handling. + */ +typedef struct kvTimeDomainData_s { + int nMagiSyncGroups; ///< number of MagiSync&tm; groups + int nMagiSyncedMembers; ///< number of MagiSync&tm; members + int nNonMagiSyncCards; ///< number of non MagiSync&tm; interfaces + int nNonMagiSyncedMembers; ///< number of non MagiSync&tm; members +} kvTimeDomainData; + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainCreate(out object domain); + * + * \source_delphi function kvTimeDomainCreate(var domain: kvTimeDomain): kvStatus; + * \source_end + * + * This routine creates an empty time domain. + * + * The variable is set by this function and then used in later calls to + * other functions using a \ref kvTimeDomain. + * + * Time domains created by \ref kvTimeDomainCreate() can be destroyed with a + * call to \ref kvTimeDomainDelete(). + * + * \note A time domain is a set of channels with a common time base. + * + * \param[out] domain A pointer to a caller allocated, opaque variable of type + * \ref kvTimeDomain that holds data to identify a particlar + * time domain. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvTimeDomainDelete() + */ +kvStatus CANLIBAPI kvTimeDomainCreate (kvTimeDomain *domain); + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainDelete(object domain); + * + * \source_delphi function kvTimeDomainDelete(domain: kvTimeDomain): kvStatus; + * \source_end + * + * This is a cleanup routine that deletes all members of a domain and then + * deletes the domain itself. + * + * \note A time domain is a set of channels with a common time base. + * + * \param[in] domain An opaque variable set by \ref kvTimeDomainCreate() that + * identifies the domain to be deleted. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvTimeDomainCreate() + */ +kvStatus CANLIBAPI kvTimeDomainDelete (kvTimeDomain domain); + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainResetTime(object domain); + * + * \source_delphi function kvTimeDomainResetTime(domain: kvTimeDomain): kvStatus; + * \source_end + * + * This routine resets the time on all members of a time domain. + * + * After a call to this routine timestamps from all channels with MagiSync&tm; + * running have no offset at all any longer. The same applies for channels that + * reside on the same physical interface. + * + * \note A time domain is a set of channels with a common time base. + * + * \param[in] domain An opaque variable set by \ref kvTimeDomainCreate() that + * identifies the domain to reset the time on. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvTimeDomainCreate() + */ +kvStatus CANLIBAPI kvTimeDomainResetTime (kvTimeDomain domain); + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainGetData(object domain, Canlib.kvTimeDomainData data); + * + * \source_delphi function kvTimeDomainGetData(domain: kvTimeDomain; var data: kvTimeDomainData; bufsiz: Cardinal): kvStatus; + * \source_end + * + * This routine collects some data on a time domain. + * + * \note A time domain is a set of channels with a common time base. + * + * \param[in] domain An opaque variable set by \ref kvTimeDomainCreate() that + * identifies the domain to add a handle to. + * \param[out] data A pointer to a \ref kvTimeDomainData that is to be filled by + * the function. + * \param[in] bufsiz The size in bytes of the \ref kvTimeDomainData struct. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvTimeDomainCreate() + */ +kvStatus CANLIBAPI kvTimeDomainGetData (kvTimeDomain domain, + kvTimeDomainData *data, + size_t bufsiz); + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainAddHandle(object domain, int handle); + * + * \source_delphi function kvTimeDomainAddHandle(domain: kvTimeDomain; handle: canHandle): kvStatus; + * \source_end + * + * This routine adds an open channel handle to a domain. + * + * \note A time domain is a set of channels with a common time base. + * + * \param[in] domain An opaque variable set by \ref kvTimeDomainCreate() + * that identifies the domain to add a handle to. + * \param[in] hnd A handle to an open channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvTimeDomainCreate(), \ref kvTimeDomainRemoveHandle() + */ +kvStatus CANLIBAPI kvTimeDomainAddHandle(kvTimeDomain domain, + const CanHandle hnd); + +/** + * \ingroup TimeDomainHandling + * + * \source_cs static Canlib.canStatus kvTimeDomainRemoveHandle(object domain, int handle); + * + * \source_delphi function kvTimeDomainRemoveHandle(domain: kvTimeDomain; handle: canHandle): kvStatus; + * \source_end + * + * This routine removes an open channel handle from a domain. + * + * \note A time domain is a set of channels with a common time base. + * + * \param[in] domain An opaque variable set by \ref kvTimeDomainCreate() + * that identifies the domain to remove a handle from. + * \param[in] hnd A handle to an open channel. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvTimeDomainCreate(), \ref kvTimeDomainAddHandle() + */ +kvStatus CANLIBAPI kvTimeDomainRemoveHandle (kvTimeDomain domain, + const CanHandle hnd); + +/** + * \name kvCallback_t + * \anchor kvCallback_t + * \ref kvCallback_t is used by the function \ref kvSetNotifyCallback() + * + * The callback function is called with the following arguments: + * \li hnd - the handle of the CAN channel where the event happened. + * \li context - the context pointer you passed to \ref kvSetNotifyCallback(). + * \li notifyEvent - one of the \ref canNOTIFY_xxx notification codes. + * + * \note It is really the \ref canNOTIFY_xxx codes, and not the + * \ref canEVENT_xxx codes that the \ref canSetNotify() API is using. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] context Arbitrary user-defined context data which + * is passed to the callback function. + * \param[in] notifyEvent One or more of the \ref canEVENT_xxx flags. + * + */ +typedef void (CANLIBAPI *kvCallback_t) (CanHandle hnd, void* context, unsigned int notifyEvent); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvSetNotifyCallback(int hnd, Canlib.kvCallbackDelegate callback, IntPtr context, uint notifyFlags); + * + * \source_delphi function kvSetNotifyCallback(handle: canHandle; callback: kvCallback_t; context: Pointer; notifyFlags: Cardinal): canStatus; + * \source_end + * + * The \ref kvSetNotifyCallback() function registers a callback function which is + * called when certain events occur. + * + * You can register at most one callback function per handle at any time. + * + * To remove the callback, call \ref kvSetNotifyCallback() with a \c NULL pointer in + * the callback argument. + * + * \note The callback function is called in the context of a high-priority + * thread created by CANLIB. You should take precaution not to do any time + * consuming tasks in the callback. You must also arrange the synchronization + * between the callback and your other threads yourself. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] callback A pointer to a callback function of type + * \ref kvCallback_t + * \param[in] context A pointer to arbitrary user-defined context data which + * is passed to the callback function. + * \param[in] notifyFlags One or more of the \ref canNOTIFY_xxx flags. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canSetNotify() + */ +kvStatus CANLIBAPI kvSetNotifyCallback (const CanHandle hnd, + kvCallback_t callback, + void* context, + unsigned int notifyFlags); + +/** + * \name kvBUSTYPE_xxx + * \anchor kvBUSTYPE_xxx + * + * Bus types, returned by \ref kvGetSupportedInterfaceInfo(). + * @{ + */ +#define kvBUSTYPE_NONE 0 ///< Unkown bus type. +#define kvBUSTYPE_PCI 1 ///< Bus of type PCI. +#define kvBUSTYPE_PCMCIA 2 ///< Bus of type PCMCIA +#define kvBUSTYPE_USB 3 ///< Bus of type USB +#define kvBUSTYPE_WLAN 4 ///< Bus of type WLAN +#define kvBUSTYPE_PCI_EXPRESS 5 ///< Bus of type PCI Express +#define kvBUSTYPE_ISA 6 ///< Bus of type ISA +#define kvBUSTYPE_VIRTUAL 7 ///< Bus of type virtual +#define kvBUSTYPE_PC104_PLUS 8 ///< Bus of type PC104+ +#define kvBUSTYPE_LAN 9 ///< Bus of type LAN +/** @} */ + +/** + * \name kvBUSTYPE_GROUP_xxx + * \anchor kvBUSTYPE_GROUP_xxx + * + * Bus type group, returned when using \ref canCHANNELDATA_BUS_TYPE + * This is a grouping of the individual \ref kvBUSTYPE_xxx. + * @{ + */ +#define kvBUSTYPE_GROUP_VIRTUAL 1 ///< \ref kvBUSTYPE_VIRTUAL +#define kvBUSTYPE_GROUP_LOCAL 2 ///< \ref kvBUSTYPE_USB +#define kvBUSTYPE_GROUP_REMOTE 3 ///< \ref kvBUSTYPE_WLAN, \ref kvBUSTYPE_LAN +#define kvBUSTYPE_GROUP_INTERNAL 4 ///< \ref kvBUSTYPE_PCI, \ref kvBUSTYPE_PCMCIA, ... +/** @} */ + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvGetSupportedInterfaceInfo(int index, out string hwName, out int hwType, out int hwBusType); + * + * \source_delphi function kvGetSupportedInterfaceInfo(index: Integer; hwName: PChar; nameLen: Cardinal; var hwType: Integer; var hwBusType: Integer): kvStatus; + * \source_end + * + * The \ref kvGetSupportedInterfaceInfo function returns information about the + * different supported hardware types in the installed version of CANLIB. + * + * This function is used to enumerate all the supported hardware types in the + * installed version of CANLIB. It does not return a complete list of all + * supported devices, nor does it return a list of the presently installed + * hardware. The returned data indicates which device families are supported. + * + * For example, a returned set of data might be: + * \li \a hwType = \ref canHWTYPE_MEMORATOR_PRO + * \li \a hwBusType = \ref kvBUSTYPE_USB + * \li \a hwName = \c "Kvaser Memorator Professional" + * + * This means that + * \li the presently installed version of CANLIB supports members in the Kvaser + * Memorator Pro family (e.g. the HS/HS and the HS/LS), + * \li the members of the Kvaser Memorator Pro family are USB devices, + * \li the members of the Kvaser Memorator Pro family use the + * \ref canHWTYPE_MEMORATOR_PRO hardware type. + * + * The \ref kvGetSupportedInterfaceInfo() function is intended to help + * application designers build a bus-oriented display of the different + * installed and/or supported Kvaser devices in the computer. + * + * \param[in] index Use this parameter to enumerate the different supported + * hardware types. Start with index = 0, and then call + * \ref kvGetSupportedInterfaceInfo again() with index = + * 1,2,3,... until the function returns an error code. + * \param[out] hwName A pointer to a buffer that will receive the name of the + * hardware family, as a zero-terminated ASCII string. + * \param[in] nameLen The length of the hwName buffer. + * \param[out] hwType Pointer to a 32-bit integer that will receive the + * hardware type (one of the \ref canHWTYPE_xxx + * constants.) + * \param[out] hwBusType Pointer to a 32-bit integer that will receive the bus + * type (one of the \ref kvBUSTYPE_xxx constants.) + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canBusOn(), \ref canResetBus() + */ +kvStatus CANLIBAPI kvGetSupportedInterfaceInfo (int index, + char *hwName, + size_t nameLen, + int *hwType, + int *hwBusType); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvReadDeviceCustomerData(int hnd, int userNumber, int itemNumber, byte[] data, int bufsize); + * + * \source_delphi function kvReadDeviceCustomerData(hnd: canHandle;userNumber, itemNumber: Integer; var data; bufsize: Cardinal): kvStatus; + * \source_end + * + * Reading customer data works with Kvaser Leaf (of all + * types), Kvaser USBcan Professional, Kvaser Memorator Professional, Kvaser Eagle and + * Kvaser Memorator Light. To write customer data use external tools. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] userNumber Assigned by Kvaser. + * \param[in] itemNumber Must be zero (reserved) + * \param[out] data A pointer to a buffer of up to 8 bytes where + * the result will be placed. + * \param[in] bufsiz The size of the buffer that data points at. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +kvStatus CANLIBAPI kvReadDeviceCustomerData (const CanHandle hnd, + int userNumber, + int itemNumber, + void *data, + size_t bufsiz); + +// +// +// APIs for t-script +// + +/** + * \ingroup tScript + * \name kvENVVAR_TYPE_xxx + * \anchor kvENVVAR_TYPE_xxx + * + * These defines are used in \ref kvScriptEnvvarOpen(). + * @{ + */ + /** + * This define is used in \ref kvScriptEnvvarOpen(). + * + * It defines the type of the envvar as \c int. + */ +#define kvENVVAR_TYPE_INT 1 + + /** + * This define is used in \ref kvScriptEnvvarOpen(). + * + * It defines the type of the envvar as \c float. + */ +#define kvENVVAR_TYPE_FLOAT 2 + + /** + * This define is used in \ref kvScriptEnvvarOpen(). + * + * It defines the type of the envvar as \c string. + */ +#define kvENVVAR_TYPE_STRING 3 + /** @} */ +/** + * \ingroup tScript + * \name kvEVENT_xxx + * \anchor kvEVENT_xxx + * + * These defines are used in \ref kvScriptSendEvent(). + * @{ + */ + + /** + * This define is used in \ref kvScriptSendEvent(). + * + * It defines an event of type "key pressed". + */ +#define kvEVENT_TYPE_KEY 1 + /** @} */ + /** + * \ingroup tScript + * + * A handle to a t-script envvar. + * Returned by the function \ref kvScriptEnvvarOpen(). + */ +typedef __int64 kvEnvHandle; + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptStart(int hnd, int slotNo); + * + * \source_delphi function kvScriptStart(const hnd: canHandle; slotNo: integer): kvStatus; + * \source_end + * + * The \ref kvScriptStart() function starts a loaded script. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot with the loaded script we want to start. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptLoadFile(), \ref kvScriptStop() + */ +kvStatus CANLIBAPI kvScriptStart (const CanHandle hnd, int slotNo); + +/** + * Script stop modes. Used by \ref kvScriptStop(). + * \anchor kvSCRIPT_STOP_xxx + * \name kvSCRIPT_STOP_xxx + * @{ + */ +#define kvSCRIPT_STOP_NORMAL 0 /**< Stop a running script */ +#define kvSCRIPT_STOP_FORCED -9 /**< Request termination of a hanged script */ +/** @} */ + + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptStop(int hnd, int slotNo, int mode); + * + * \source_delphi function kvScriptStop(const hnd: canHandle; slotNo: integer; mode: integer): kvStatus; + * \source_end + * + * The \ref kvScriptStop() function stops a started script. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot with the loaded and running script we want to stop. + * \param[in] mode Stop mode of type \ref kvSCRIPT_STOP_xxx + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptLoadFile(), \ref kvScriptStart() + */ +kvStatus CANLIBAPI kvScriptStop (const CanHandle hnd, int slotNo, int mode); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptUnload(int hnd, int slotNo); + * + * \source_delphi function kvScriptUnload(const hnd: canHandle; slotNo: integer): kvStatus; + * \source_end + * + * The \ref kvScriptUnload() function unloads a stopped script. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot with the loaded and stopped script we want to unload. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptLoadFile(), \ref kvScriptStop() + */ +kvStatus CANLIBAPI kvScriptUnload (const CanHandle hnd, int slotNo); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptSendEvent(int hnd, int slotNo, int eventType, int eventNo, uint data); + * + * \source_delphi function kvScriptSendEvent(const hnd: canHandle; slotNo: integer; eventType: integer; eventNo: integer; data: Cardinal): kvStatus; + * \source_end + * + * The \ref kvScriptSendEvent() function sends an event of a type, and an event + * number and associated data to a script running in a specific slot. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot where the script was loaded and is running. + * \param[in] eventType The event to send, of type \ref kvEVENT_xxx + * \param[in] eventNo The event's number. + * \param[in] data The event's data. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + */ +kvStatus CANLIBAPI kvScriptSendEvent (const CanHandle hnd, + int slotNo, + int eventType, + int eventNo, + unsigned int data); + +/** + * \ingroup tScript + * + * \source_cs static long kvScriptEnvvarOpen(int hnd, string envvarName, out int envvarType, out int envvarSize); + * + * \source_delphi function kvScriptEnvvarOpen(const hnd: canHandle; envvarName: PChar; var envvarType: Integer; var envvarSize: Integer): \ref kvEnvHandle; + * \source_end + * + * The \ref kvScriptEnvvarOpen() opens an existing envvar and returns a handle to it. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] envvarName The envvar's name; a pointer to a \c NULL terminated + * array of chars. + * \param[out] envvarType A pointer to a 32-bit integer that will receive the + * \ref kvENVVAR_TYPE_xxx type. + * \param[out] envvarSize A pointer to a 32-bit integer that will receive the + * size of the envvar in bytes. + * + * \return A \ref kvEnvHandle handle (positive) to an envvar if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarClose() + */ +kvEnvHandle CANLIBAPI kvScriptEnvvarOpen (const CanHandle hnd, + char* envvarName, + int *envvarType, + int *envvarSize); // returns scriptHandle + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarClose(long eHnd); + * + * \source_delphi function kvScriptEnvvarClose(const eHnd: kvEnvHandle): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarClose() function closes an open envvar. + * + * \param[in] eHnd An open handle to an envvar. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvScriptEnvvarOpen() + */ +kvStatus CANLIBAPI kvScriptEnvvarClose (kvEnvHandle eHnd); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarSetInt(long eHnd, int val); + * + * \source_delphi function kvScriptEnvvarSetInt(const eHnd: kvEnvHandle; val: Integer): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarSetInt() sets the value of an \c int envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[in] val The new value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarGetInt(), \ref kvScriptEnvvarSetFloat(), + * \ref kvScriptEnvvarSetData() + */ +kvStatus CANLIBAPI kvScriptEnvvarSetInt (kvEnvHandle eHnd, int val); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarGetInt(long eHnd, out int val); + * + * \source_delphi function kvScriptEnvvarGetInt(const eHnd: kvEnvHandle; var val: Integer): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarGetInt() function retrieves the value of an \c int envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[out] val The current value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarSetInt(), \ref kvScriptEnvvarGetFloat(), + * \ref kvScriptEnvvarGetData() + * + */ +kvStatus CANLIBAPI kvScriptEnvvarGetInt (kvEnvHandle eHnd, int *val); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarSetFloat(long eHnd, float val); + * + * \source_delphi function kvScriptEnvvarSetFloat(const eHnd: kvEnvHandle; val: Single): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarSetFloat() sets the value of a \c float envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[in] val The new value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarGetFloat(), \ref kvScriptEnvvarSetInt(), + * \ref kvScriptEnvvarSetData() + */ +kvStatus CANLIBAPI kvScriptEnvvarSetFloat (kvEnvHandle eHnd, float val); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarGetFloat(long eHnd, out float val); + * + * \source_delphi function kvScriptEnvvarGetFloat(const eHnd: kvEnvHandle; var val: Single): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarGetFloat() function retrieves the value of a \c float envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[out] val A pointer to a \c float where the retrieved result should be + * stored. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarSetFloat(), \ref kvScriptEnvvarGetInt(), + * \ref kvScriptEnvvarGetData() + */ +kvStatus CANLIBAPI kvScriptEnvvarGetFloat (kvEnvHandle eHnd, float *val); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarSetData(long eHnd, byte[] buf, int start_index, int data_len); + * + * \source_delphi function kvScriptEnvvarSetData(const eHnd: kvEnvHandle; var buf; start_index: Integer; data_len: Integer): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarSetData() function sets a range of data bytes in an envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[in] buf A pointer to a data area with the new values. + * \param[in] start_index The start index of the envvar's data range that we + * want to update. + * \param[in] data_len The length in bytes of the envvar's data range that + * we want to update. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarGetData(), \ref kvScriptEnvvarSetInt(), + * \ref kvScriptEnvvarSetFloat() + */ +kvStatus CANLIBAPI kvScriptEnvvarSetData (kvEnvHandle eHnd, + void *buf, + int start_index, + int data_len); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptEnvvarGetData(long eHnd, out byte[] buf, int start_index, int data_len); + * + * \source_delphi function kvScriptEnvvarGetData(const eHnd: kvEnvHandle; var buf; start_index: Integer; data_len: Integer): kvStatus; + * \source_end + * + * The \ref kvScriptEnvvarGetData() function retrieves a range of data bytes from an envvar. + * + * \param[in] eHnd An open handle to an envvar. + * \param[out] buf A pointer to a data area where the retrieved data + * range should be stored. + * \param[in] start_index The start index of the data range. + * \param[in] data_len The length in bytes of the data range. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptEnvvarOpen(), \ref kvScriptEnvvarSetData(), \ref kvScriptEnvvarGetInt(), + * \ref kvScriptEnvvarGetFloat() + */ +kvStatus CANLIBAPI kvScriptEnvvarGetData (kvEnvHandle eHnd, + void *buf, + int start_index, + int data_len); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptLoadFileOnDevice(int hnd, int slotNo, ref string localFile); + * + * \source_delphi function kvScriptLoadFileOnDevice(hnd: canHandle; slotNo: Integer; localFile: PChar): kvStatus; + * \source_end + * + * The \ref kvScriptLoadFileOnDevice() function loads a compiled script file (.txe) + * stored on the device (SD card) into a script slot on the device. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot where to load the script. + * \param[in] localFile The script file name; a pointer to a \c NULL terminated + * array of chars. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptLoadFile(), \ref kvFileCopyToDevice(), \ref kvScriptStart(), + * \ref kvScriptStop() + */ +kvStatus CANLIBAPI kvScriptLoadFileOnDevice (const CanHandle hnd, + int slotNo, + char *localFile); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptLoadFile(int hnd, int slotNo, ref string filePathOnPC); + * + * \source_delphi function kvScriptLoadFile(hnd: canHandle; slotNo: Integer; filePathOnPC: PChar): kvStatus; + * \source_end + * + * The \ref kvScriptLoadFile() function loads a compiled script file (.txe) stored + * on the host (PC) into a script slot on the device. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slotNo The slot where to load the script. + * \param[in] filePathOnPC The script file name; a pointer to a \c NULL + * terminated array of chars. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref page_code_snippets_examples + * \sa \ref kvScriptLoadFileOnDevice(), \ref kvFileCopyToDevice(), \ref kvScriptStart(), + * \ref kvScriptStop() + */ +kvStatus CANLIBAPI kvScriptLoadFile (const CanHandle hnd, + int slotNo, + char *filePathOnPC); + + + + +/** + * \ingroup General + * \name kvSCRIPT_REQUEST_TEXT_xxx + * \anchor kvSCRIPT_REQUEST_TEXT_xxx + * + * These defines are used in \ref kvScriptRequestText() for printf message subscribe/unsubscribe. + * + * @{ + */ + +/** + * Cancel subscription of printf messages from script slots. + */ +#define kvSCRIPT_REQUEST_TEXT_UNSUBSCRIBE 1 + +/** + * Subscribe to printf messages from script slots. + */ +#define kvSCRIPT_REQUEST_TEXT_SUBSCRIBE 2 + +/** + * Select all script slots. + */ +#define kvSCRIPT_REQUEST_TEXT_ALL_SLOTS 255 + +/** @} */ + + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptRequestText(int hnd, int slot, int request); + * + * \source_delphi function kvScriptRequestText(hnd: canHandle; slotNo: cardinal; request: cardinal): kvStatus; + * \source_end + * + * The \ref kvScriptRequestText() Sets up a printf subscription to a + * selected script slot. + * Read the printf messages with \ref kvScriptGetText(). + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slot The slot to subscribe to. + * \param[in] request Subscription request i.e. \ref kvSCRIPT_REQUEST_TEXT_xxx. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +kvStatus CANLIBAPI kvScriptRequestText(const CanHandle hnd, + unsigned int slot, + unsigned int request); + + + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptGetText(int hnd, out int slot, out ulong time, out int flags, out string buf); + * + * \source_delphi function kvScriptGetText(hnd: canHandle; var slot: integer; var time: Cardinal; var flags: Cardinal; buf: PChar; bufsize: Cardinal): kvStatus; + * \source_end + * + * The \ref kvScriptGetText() Reads a printf from a subscribed script slot. + * Set up a subscription with \ref kvScriptRequestText(). + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] slot The slot where the printf originated. + * \param[out] time The printf timestamp. + * \param[out] flags Printf flags. A combination of \ref canSTAT_xxx flags. + * \param[out] buf Buffer to hold the printf string. + * \param[in] bufsize Size of the buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +kvStatus CANLIBAPI kvScriptGetText(const CanHandle hnd, + int *slot, + unsigned long *time, + unsigned int *flags, + char *buf, + size_t bufsize + ); + + + +/** + * Script status flag bits. Used by \ref kvScriptStatus(). + * \anchor kvSCRIPT_STATUS_xxx + * \name kvSCRIPT_STATUS_xxx + * @{ + */ +#define kvSCRIPT_STATUS_LOADED 1 /**< The slot is loaded with a script */ +#define kvSCRIPT_STATUS_RUNNING 2 /**< The slot is running a script. */ +/** @} */ + + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvScriptStatus(int hnd, int slot, out unsigned int status); + * \source_delphi function kvScriptStatus(hnd: canHandle; var slot: integer; var time: integer): kvStatus; + * \source_end + * + * The \ref kvScriptStatus() function reads the current status of a script slot. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] slot The slot which status we want. + * \param[out] status The script status, as \ref kvSCRIPT_STATUS_xxx flag bits + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +kvStatus CANLIBAPI kvScriptStatus(const CanHandle hnd, + int slot, + unsigned int *status); + + + + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileCopyToDevice(int hnd, string hostFileName, string deviceFileName); + * + * \source_delphi function kvFileCopyToDevice(hnd: canHandle; hostFileName: PChar; deviceFileName: PChar): kvStatus; + * \source_end + * + * The \ref kvFileCopyToDevice() function copies an arbitrary file from the host to + * the device. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] hostFileName The host file name; a pointer to a \c NULL terminated + * array of chars. + * \param[in] deviceFileName The target device file name; a pointer to a \c NULL + * terminated array of chars. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvFileCopyFromDevice(), \ref kvFileDelete() + */ +kvStatus CANLIBAPI kvFileCopyToDevice (const CanHandle hnd, + char *hostFileName, + char *deviceFileName); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileCopyFromDevice(int hnd, string deviceFileName, string hostFileName); + * + * \source_delphi function kvFileCopyFromDevice(hnd: canHandle; deviceFileName: PChar; hostFileName: PChar): kvStatus; + * \source_end + * + * The \ref kvFileCopyFromDevice() function copies an arbitrary file from the device + * to the host. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] deviceFileName The device file name; a pointer to a \c NULL + * terminated array of chars. + * \param[in] hostFileName The target host file name; a pointer to a \c NULL terminated + * array of chars. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvFileCopyToDevice() + */ +kvStatus CANLIBAPI kvFileCopyFromDevice (const CanHandle hnd, + char *deviceFileName, + char *hostFileName); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileDelete(int hnd, string deviceFileName); + * + * \source_delphi function kvFileDelete(hnd: canHandle; deviceFileName: PChar): kvStatus; + * \source_end + * + * The \ref kvFileDelete() function deletes a file on the device. + * + * \note Deleting system files is not recommended. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] deviceFileName The file on the device to delete; a pointer + * to a \c NULL terminated array of chars. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvFileCopyToDevice() + */ +kvStatus CANLIBAPI kvFileDelete (const CanHandle hnd, char *deviceFileName); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileGetName(int hnd, int fileNo, out string name); + * + * \source_delphi function kvFileGetName(hnd: canHandle; fileNo: Integer; name: PChar; namelen: Integer): kvStatus; + * \source_end + * + * The \ref kvFileGetName() function returns the name of the file with + * number \a fileNo. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] fileNo The number of the file. + * \param[out] name A buffer that will contain the name of the + * file. The name is a zero-terminated ASCII string. + * \param[in] namelen The length, in bytes, of the \a name buffer. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvFileGetCount(), \ref kvFileGetSystemData() + */ +kvStatus CANLIBAPI kvFileGetName (const CanHandle hnd, + int fileNo, + char *name, + int namelen); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileGetCount(int hnd, out int count); + * + * \source_delphi function kvFileGetCount(hnd: canHandle; var count: Integer): kvStatus; + * \source_end + * + * The \ref kvFileGetCount() function returns the number of files. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] count A pointer to a 32-bit integer that will receive + * the file count. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvFileGetName(), \ref kvFileGetSystemData() + */ +kvStatus CANLIBAPI kvFileGetCount (const CanHandle hnd, int *count); + +/** + * \ingroup tScript + * + * \source_cs static Canlib.canStatus kvFileGetSystemData(int hnd, int itemCode, out int result); + * + * \source_delphi function kvFileGetSystemData(hnd: canHandle; itemCode: Integer; var result: Integer): kvStatus; + * \source_end + * + * The \ref kvFileGetSystemData() function is used for reading disk parameters, + * e.g. size, max number of (user) files, etc. + * + * \note Not yet implemented + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] itemCode The item we want information on. + * \param[out] result A pointer to a 32-bit integer that will + * receive the result. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + */ +kvStatus CANLIBAPI kvFileGetSystemData (const CanHandle hnd, + int itemCode, + int *result); + +/** + * \ingroup General + * \anchor kvDEVICE_MODE_xxx + * \name kvDEVICE_MODE_xxx + * + * These defines are used in \ref kvDeviceSetMode() and \ref kvDeviceGetMode(). + * + * \note The mode is device specific, which means that not all modes are + * implemented in all products. + * + * @{ + */ + /** + * This define is used in \ref kvDeviceSetMode() and \ref kvDeviceGetMode(). + * + * Device is running or should be running in interface mode. + */ +#define kvDEVICE_MODE_INTERFACE 0x00 + /** + * This define is used in \ref kvDeviceSetMode() and \ref kvDeviceGetMode(). + * + * Device is running or should be running in logger mode. + */ +#define kvDEVICE_MODE_LOGGER 0x01 + /** @} */ + + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvDeviceSetMode(int hnd, int mode); + * + * \source_delphi function kvDeviceSetMode(hnd: canHandle; mode: Integer): kvStatus; + * \source_end + * + * The \ref kvDeviceSetMode() sets the mode. + * + * \note The mode is device specific, which means that not all modes are + * implemented in all products. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[in] mode One of the \ref kvDEVICE_MODE_xxx constants, + * defining which mode to use. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvDeviceGetMode() + */ +kvStatus CANLIBAPI kvDeviceSetMode (const CanHandle hnd, int mode); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvDeviceGetMode(int hnd, out int result); + * + * \source_delphi function kvDeviceGetMode(hnd: canHandle; var mode: Integer): kvStatus; + * \source_end + * + * The \ref kvDeviceGetMode() reads the current device's specific mode. + * + * \note The mode is device specific, which means that not all modes are + * implemented in all products. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] result A pointer to a 32-bit integer that will receive the + * \ref kvDEVICE_MODE_xxx value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvDeviceSetMode() + */ +kvStatus CANLIBAPI kvDeviceGetMode (const CanHandle hnd, int *result); + + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvPingRequest(int hnd, out uint requestTime); + * + * \source_delphi function kvPingRequest(hnd: canHandle; var requestTime: Cardinal): kvStatus; + * \source_end + * + * This function sends an active ping to a device. The ping time can later be + * retrieved using \ref kvPingGetLatest(). + * + * \param[in] hnd A handle to an open circuit. + * \param[out] requestTime Time of request in microseconds. Used for matching answer to request. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ +kvStatus CANLIBAPI kvPingRequest (const CanHandle hnd, + unsigned int *requestTime); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvPingGetLatest(int hnd, out uint requestTime, out uint pingTime); + * + * \source_delphi function kvPingGetLatest(hnd: canHandle; var requestTime: Cardinal; var pingTime: Cardinal): kvStatus; + * \source_end + * + * This retrieves the latest ping time issued by an earlier call to \ref kvPingRequest() + * + * \param[in] hnd A handle to an open circuit. + * \param[out] requestTime Time of request in microseconds. Used for matching answer to request. + * \param[out] pingTime Latest value of ping time in milliseconds. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + */ + kvStatus CANLIBAPI kvPingGetLatest (const CanHandle hnd, + unsigned int *requestTime, + unsigned int *pingTime); + + +/** + * \ingroup Internal + * \anchor Internal + * \name Unimplemented internal + * + * The following are not yet implemented. Do not use it. + * + * @{ + */ +// +// +// +#if defined(_CANEVT_H_) +canStatus CANLIBAPI canReadEvent (const CanHandle hnd, CanEvent *event); +#endif + +/** This function is not implemented, do not use it. */ +void CANLIBAPI canSetDebug(int d); +/** This function is not implemented, do not use it. */ +canStatus CANLIBAPI canSetNotifyEx (const CanHandle hnd, + HANDLE event, + unsigned int flags); +/** This function is not implemented, do not use it. */ +canStatus CANLIBAPI canSetTimer (const CanHandle hnd, + DWORD interval, + DWORD flags); +/** This is reserved for \ref canSetTimer() but not implemented, do not use it. */ +#define canTIMER_CYCLIC 0x01 +/** This is reserved for \ref canSetTimer() but not implemented, do not use it. */ +#define canTIMER_EXPENSIVE 0x02 +/** This function is not implemented, do not use it. */ +int CANLIBAPI canSplitHandle (CanHandle hnd, int channel); +/** This function is not implemented, do not use it. */ +int CANLIBAPI canOpenMultiple (DWORD bitmask, int flags); +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvReadTimer(int hnd, out int time); + * + * \source_delphi function kvReadTimer(handle: canHandle; var time: Cardinal): kvStatus; + * \source_end + * + * The \ref kvReadTimer reads the hardware clock on the specified device and returns + * the value. + * + * When the call to \ref kvReadTimer() returns, the time value is already + * obsolete. The time required for the device firmware, any intermediary buses + * (like USB,) and the operating system to return the time value is not + * defined. + * + * This call should be used instead of \ref canReadTimer() because it can return an + * error code if it fails. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] time A pointer to a 32-bit unsigned integer that will receive + * the time value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref canReadTimer(), \ref kvReadTimer64() + */ +kvStatus CANLIBAPI kvReadTimer (const CanHandle hnd, unsigned int *time); + +/** + * \ingroup General + * + * \source_cs static Canlib.canStatus kvReadTimer64(int hnd, out long time); + * + * \source_delphi function kvReadTimer64(handle: canHandle; var time: Int64): kvStatus; + * \source_end + * + * The \ref kvReadTimer64 reads the hardware clock on the specified device and + * returns the value. + * + * When the call to \ref kvReadTimer64() returns, the time value is already + * obsolete. The time required for the device firmware, any intermediary buses + * (like USB,) and the operating system to return the time value is not + * defined. + * + * This call should be used instead of \ref canReadTimer() because it can return an + * error code if it fails. + * + * \param[in] hnd An open handle to a CAN channel. + * \param[out] time A pointer to a 64-bit signed integer that will receive the + * time value. + * + * \return \ref canOK (zero) if success + * \return \ref canERR_xxx (negative) if failure + * + * \sa \ref kvReadTimer(), \ref canReadTimer() + */ +kvStatus CANLIBAPI kvReadTimer64 (const CanHandle hnd, KVINT64 *time); +/** @} */ +#endif + +#ifdef __cplusplus +} +#endif + +# include "obsolete.h" + +#ifdef KVASER_EYES_ONLY +canStatus CANLIBAPI lowLevelAccess (const CanHandle hnd, void * data, int size); +#endif + +#endif diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canstat.h b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canstat.h new file mode 100644 index 00000000..6d8e05ef --- /dev/null +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/canstat.h @@ -0,0 +1,497 @@ +/** + * \section LICENSE + * Copyright 1994-2013 by KVASER AB, SWEDEN + * + * WWW: http://www.kvaser.com + * + * This software is furnished under a license and may be used and copied + * only in accordance with the terms of such license. + * + * \section DESCRIPTION + * + * Definitions for the CANLIB API. + * + * \file canlib.h + * \author Kvaser AB + * + * \note MATLAB users on Windows: if you define WIN32_LEAN_AND_MEAN before + * including this file, you will see a lot less warnings. + * + * \defgroup General General + * \defgroup CAN CAN + * \defgroup ObjectBuffers Object buffers + * \win_start + * \defgroup TimeDomainHandling Time Domain Handling + * \defgroup NamedParameterSettings Named Parameter Settings + * \defgroup tScript t-script + * \win_end + */ +#ifndef _CANSTAT_H_ +#define _CANSTAT_H_ + +// +// Don't forget to update canGetErrorText in canlib.c if this is changed! +// + +/** + * \name canERR_xxx + * \anchor canERR_xxx + * + * Generally, a return code greater than or equal to zero means success. A + * value less than zero means failure. + * + * You should avoid testing for a specific error code unless it is explicitly + * stated in the documentation for the API in question that this specific error + * code is returned. Instead, check if the error code is less than zero. Use + * \ref canGetErrorText() to obtain an error message suitable for a message to the + * user, or for a line in an error log file. + */ +typedef enum { + /** + * Normal successful completion; The driver is just fine, and really + * believes it carried out your command to everyone's satisfaction. + */ + canOK = 0, + /** + * Error in one or more parameters; a parameter \ref canERR_xxx + * specified in the call was invalid, out of range, or so. This status code + * will also be returned when the call is not implemented. + */ + canERR_PARAM = -1, + /** + * There were no messages to read; A function tried to read a message, + * but there was no message to read. + */ + canERR_NOMSG = -2, + /** + * Specified device or channel not found. There is no hardware + * available that matches the given search criteria. For example, you may + * have specified \ref canOPEN_REQUIRE_EXTENDED but there's no controller + * capable of extended CAN. You may have specified a channel number that is + * out of the range for the hardware in question. You may have requested + * exclusive access to a channel, but the channel is already occupied. + */ + canERR_NOTFOUND = -3, + /** + * Out of memory; A memory allocation failed. + */ + canERR_NOMEM = -4, + /** + * No channels available; There is indeed hardware matching the + * criteria you specified, but there are no channels available, or the + * channel you specified is already occupied. + */ + canERR_NOCHANNELS = -5, + + canERR_INTERRUPTED = -6, ///< Interrupted by signals + /** + * Timeout occurred; A function waited for something to happen (for + * example, the arrival of a message), but that something didn't happen. + */ + canERR_TIMEOUT = -7, + /** + * The library is not initialized; The driver is not + * initialized. \ref canInitializeLibrary() was probably not called? + */ + canERR_NOTINITIALIZED = -8, + /** + * Out of handles; No handles are available inside canlib32. The + * application has too many handles open (i.e. has called \ref canOpenChannel() too + * many times, or there's a memory leak somewhere.) + * + * \note We are not talking about Windows handles here, it's CANLIB's own + * internal handles. + */ + canERR_NOHANDLES = -9, + /** + * Handle is invalid; The CANLIB handle you specified (if the API call + * includes a handle) is not valid. Ensure you are passing the handle and + * not, for example, a channel number. + */ + canERR_INVHANDLE = -10, + canERR_INIFILE = -11, ///< Error in the ini-file (16-bit only) + /** + * Driver type not supported; CAN driver mode is not supported by the + * present hardware. + */ + canERR_DRIVER = -12, + /** + * Transmit buffer overflow; The transmit queue was full, so the + * message was dropped. + */ + canERR_TXBUFOFL = -13, + canERR_RESERVED_1 = -14, ///< Reserved + /** + * A hardware error has occurred; Something probably related to the + * hardware happened. This could mean that the device does not respond (IRQ + * or address conflict?), or that the response was invalid or unexpected + * (faulty card?). + */ + canERR_HARDWARE = -15, + /** + * A driver DLL can't be found or loaded; (One of) the DLL(s) + * specified in the registry failed to load. This could be a driver + * installation problem. + */ + canERR_DYNALOAD = -16, + /** + * A DLL seems to have wrong version; DLL version mismatch. (One of) + * the DLL(s) specified in the registry is - probably - too old, or - less + * likely - too new. + */ + canERR_DYNALIB = -17, + /** + * Error when initializing a DLL; Something failed when a device + * driver was being initialized. In other words, we can open the driver but + * it makes a lot of fuss about something we don't understand. + */ + canERR_DYNAINIT = -18, + canERR_NOT_SUPPORTED = -19, ///< Operation not supported by hardware or firmware + canERR_RESERVED_5 = -20, ///< Reserved + canERR_RESERVED_6 = -21, ///< Reserved + canERR_RESERVED_2 = -22, ///< Reserved + /** + * Can't find or load kernel driver; A device driver (kernel mode + * driver for NT, VxD for W95/98) failed to load; or the DLL could not open + * the device. Privileges? Driver file missing? + */ + canERR_DRIVERLOAD = -23, + /** + * DeviceIOControl failed; Use Win32 GetLastError() to learn what + * really happened. + */ + canERR_DRIVERFAILED = -24, + canERR_NOCONFIGMGR = -25, ///< Can't find req'd config s/w (e.g. CS/SS) + canERR_NOCARD = -26, ///< The card was removed or not inserted + canERR_RESERVED_7 = -27, ///< Reserved + /** + * Error (missing data) in the Registry; A registry key is missing, + * invalid, malformed, has gone for lunch or what not. can_verify.exe might + * provide some insight. + */ + canERR_REGISTRY = -28, + canERR_LICENSE = -29, ///< The license is not valid. + /** + * Internal error in the driver; Indicates an error condition in the + * driver or DLL, which couldn't be properly handled. Please contact the + * friendly support at support@kvaser.com. + */ + canERR_INTERNAL = -30, + /** + * Access denied; This means that you tried to set the bit rate on a + * handle to which you haven't got init access or you tried to open a channel + * that already is open with init access. See \ref canOpenChannel() for more + * information about init access. + */ + canERR_NO_ACCESS = -31, + /** + * Not implemented; The requested feature or function is not + * implemented in the device you are trying to use it on. + */ + canERR_NOT_IMPLEMENTED = -32, + /** + * Device File error; An error has occured when trying to access a + * file on the device. + */ + canERR_DEVICE_FILE = -33, + /** + * Host File error; An error has occured when trying to access a file on the host. + * + */ + canERR_HOST_FILE = -34, + /** + * Disk error; A disk error has occurred. Verify that the disk is + * initialized. + */ + canERR_DISK = -35, + /** + * CRC error; The CRC calculation did not match the expected result. + */ + canERR_CRC = -36, + /** + * Configuration Error; The configuration is corrupt. + */ + canERR_CONFIG = -37, + /** + * Memo Error; Other configuration error. + */ + canERR_MEMO_FAIL = -38, + /** + * Script Fail; A script has failed. + * + * \note This code represents several different failures, for example: + * - Trying to load a corrupt file or not a .txe file + * - Trying to start a t script that has not been loaded + * - Trying to load a t script compiled with the wrong version of the t compiler + * - Trying to unload a t script that has not been stopped + * - Trying to use an envvar that does not exist + */ + canERR_SCRIPT_FAIL = -39, + + /** + * The t script version dosen't match the version(s) that the device firmware supports.; + */ + canERR_SCRIPT_WRONG_VERSION = -40, + + + // The last entry - a dummy so we know where NOT to place a comma. + canERR__RESERVED = -41 ///< Reserved +} canStatus; + + +/** + * \name Convenience + * @{ + */ +#define CANSTATUS_SUCCESS(X) ((X) == canOK) +#define CANSTATUS_FAILURE(X) ((X) != canOK) +/** @} */ + +/** + * \name canEVENT_xxx WM__CANLIB notification codes + * \anchor canEVENT_xxx + * Appears in the notification \c WM__CANLIB message. + * @{ + */ +#define canEVENT_RX 32000 ///< when the queue of received CAN messages goes from empty to non-empty +#define canEVENT_TX 32001 ///< when a CAN message has been transmitted +#define canEVENT_ERROR 32002 ///< when a CAN bus error is reported by the CAN controller +#define canEVENT_STATUS 32003 ///< when the CAN controller changes state +#define canEVENT_ENVVAR 32004 ///< An envvar changed +# define canEVENT_BUSONOFF 32005 ///< Bus on/off status changed +# define canEVENT_REMOVED 32006 ///< Device removed +/** @} */ + +/** + * \name canNOTIFY_xxx + * \anchor canNOTIFY_xxx + * + * These are notification codes used in calls to \ref canSetNotify() and \ref kvSetNotifyCallback(). + * + * This can be \ref canNOTIFY_NONE (zero), meaning that no event notification is to + * occur, or a combination of any of the following constants + * + * @{ + */ +#define canNOTIFY_NONE 0 ///< Turn notifications off. +#define canNOTIFY_RX 0x0001 ///< CAN message reception notification +#define canNOTIFY_TX 0x0002 ///< CAN message transmission notification +#define canNOTIFY_ERROR 0x0004 ///< CAN bus error notification +#define canNOTIFY_STATUS 0x0008 ///< CAN chip status change +#define canNOTIFY_ENVVAR 0x0010 ///< An environment variable was changed by a script +# define canNOTIFY_BUSONOFF 0x0020 ///< Notify on bus on/off status changed +# define canNOTIFY_REMOVED 0x0040 ///< Notify on device removed +/** @} */ + + +/** + * \ingroup InformationServices + * \name canSTAT_xxx + * \anchor canSTAT_xxx + * + * The following circuit status flags are returned by \ref canReadStatus(). Note + * that more than one flag might be set at any one time. + * + * \note Usually both \ref canSTAT_HW_OVERRUN and \ref canSTAT_SW_OVERRUN are set + * when overrun has occurred. This is because the kernel driver can't see the + * difference between a software overrun and a hardware overrun. So the code + * should always test for both types of overrun using the \ref canSTAT_OVERRUN + * "flag". + * + * @{ + */ +#define canSTAT_ERROR_PASSIVE 0x00000001 ///< The circuit is error passive +#define canSTAT_BUS_OFF 0x00000002 ///< The circuit is Off Bus +#define canSTAT_ERROR_WARNING 0x00000004 ///< At least one error counter > 96 +#define canSTAT_ERROR_ACTIVE 0x00000008 ///< The circuit is error active. +#define canSTAT_TX_PENDING 0x00000010 ///< There are messages pending transmission +#define canSTAT_RX_PENDING 0x00000020 ///< There are messages in the receive buffer +#define canSTAT_RESERVED_1 0x00000040 +#define canSTAT_TXERR 0x00000080 ///< There has been at least one TX error +#define canSTAT_RXERR 0x00000100 ///< There has been at least one RX error of some sort +#define canSTAT_HW_OVERRUN 0x00000200 ///< The has been at least one HW buffer overflow +#define canSTAT_SW_OVERRUN 0x00000400 ///< The has been at least one SW buffer overflow +#define canSTAT_OVERRUN (canSTAT_HW_OVERRUN | canSTAT_SW_OVERRUN) ///< For convenience. +/** @} */ + +/** + * \name Message information flags, < 0x100 + * \anchor canMSG_xxx + * + * The following flags can be returned from \ref canRead() et al, or passed to + * \ref canWrite(). + * + * All flags and/or combinations of them are meaningful for received messages. + * + * \ref canMSG_RTR, \ref canMSG_STD, \ref canMSG_EXT, \ref canMSG_WAKEUP and + * \ref canMSG_ERROR_FRAME are meaningful also for transmitted messages. + * \ref canMSG_SINGLE_SHOT is only for transmission. + * + * Note that \ref canMSG_RTR cannot be set for CAN FD messages. + * + * @{ + */ +#define canMSG_MASK 0x00ff ///< Used to mask the non-info bits +#define canMSG_RTR 0x0001 ///< Message is a remote request +#define canMSG_STD 0x0002 ///< Message has a standard ID +#define canMSG_EXT 0x0004 ///< Message has an extended ID +#define canMSG_WAKEUP 0x0008 ///< Message to be sent / was received in wakeup mode + +/** + * NERR was active during the message + * + * The NERR flag is set by the CAN transceiver when certain CAN bus wire faults + * occur, namely: + * \li CANH wire interrupted + * \li CANL wire interrupted + * \li CANH short-circuited to battery + * \li CANH short-circuited to VCC + * \li CANL short-circuited to ground + * \li CANH short-circuited to ground + * \li CANL short-circuited to battery + * \li CANL short-circuited to VCC + * \li CANL and CANH mutually short-circuited + * + * See the TJA1054 data sheet (available from Philips) for more detailed + * information. + */ +#define canMSG_NERR 0x0010 +#define canMSG_ERROR_FRAME 0x0020 ///< Message is an error frame +#define canMSG_TXACK 0x0040 ///< Message is a TX ACK (msg is really sent) +#define canMSG_TXRQ 0x0080 ///< Message is a TX REQUEST (msg is transfered to the chip) +#define canMSG_DELAY_MSG 0x0100 ///< Message is NOT sent on the bus. The transmission of messages are delayed. The dlc specifies the delay in milliseconds (1..1000). + +// single shot flags: +#define canMSG_SINGLE_SHOT 0x1000000 ///< Message is Single Shot, try to send once, no retransmission. This flag can only be used with transmitted messages. +#define canMSG_TXNACK 0x2000000 ///< Message is a failed Single Shot, message was not sent. This flag is only used with received messages. +#define canMSG_ABL 0x4000000 ///< Only together with canMSG_TXNACK, Single shot message was not sent because arbitration was lost. This flag is only used with received messages. + + +/** + * \name canFDMSG_xxx + * \anchor canFDMSG_xxx + * + * Flags used in the CAN FD protocol. Set \ref canOPEN_CAN_FD in \ref + * canOpenChannel() to enable the CAN FD protocol. + * + * @{ + */ +#define canFDMSG_MASK 0xff0000 +#define canFDMSG_EDL 0x010000 ///< Obsolete, use \ref canFDMSG_FDF instead +#define canFDMSG_FDF 0x010000 ///< Message is an FD message (CAN FD) +#define canFDMSG_BRS 0x020000 ///< Message is sent/received with bit rate switch (CAN FD) +#define canFDMSG_ESI 0x040000 ///< Sender of the message is in error passive mode (CAN FD) +/** @} */ + +/** @} */ + +/** + * \name Message error flags + * \anchor canMSGERR_xxx + * + * \note Not all hardware platforms can detect the difference between hardware + * overruns and software overruns, so your application should test for both + * conditions. You can use the symbol \ref canMSGERR_OVERRUN for this purpose. + * + * @{ + */ +#define canMSGERR_MASK 0xff00 ///< Used to mask the non-error bits +// 0x0100 reserved +#define canMSGERR_HW_OVERRUN 0x0200 ///< HW buffer overrun +#define canMSGERR_SW_OVERRUN 0x0400 ///< SW buffer overrun +#define canMSGERR_STUFF 0x0800 ///< Stuff error +#define canMSGERR_FORM 0x1000 ///< Form error +#define canMSGERR_CRC 0x2000 ///< CRC error +#define canMSGERR_BIT0 0x4000 ///< Sent dom, read rec +#define canMSGERR_BIT1 0x8000 ///< Sent rec, read dom + +// Convenience values for the message error flags. +#define canMSGERR_OVERRUN 0x0600 ///< Any overrun condition. +#define canMSGERR_BIT 0xC000 ///< Any bit error. +#define canMSGERR_BUSERR 0xF800 ///< Any RX error + +/** @} */ + +/** + * \name canTRANSCEIVER_LINEMODE_xxx + * \anchor canTRANSCEIVER_LINEMODE_xxx + * + * The following values can be used \win_start with \ref canSetDriverMode() \win_end to set different + * driver (i.e. transceiver) modes. \win_start Use \ref canGetDriverMode() to obtain the + * current driver mode for a particular CAN channel. \win_end + * + * \linux_start + * Not implemented in Linux. + * \linux_end + * @{ + */ +#define canTRANSCEIVER_LINEMODE_NA 0 ///< Not Affected/Not available. +#define canTRANSCEIVER_LINEMODE_SWC_SLEEP 4 ///< SWC Sleep Mode. +#define canTRANSCEIVER_LINEMODE_SWC_NORMAL 5 ///< SWC Normal Mode. +#define canTRANSCEIVER_LINEMODE_SWC_FAST 6 ///< SWC High-Speed Mode. +#define canTRANSCEIVER_LINEMODE_SWC_WAKEUP 7 ///< SWC Wakeup Mode. +#define canTRANSCEIVER_LINEMODE_SLEEP 8 ///< Sleep mode for those supporting it. +#define canTRANSCEIVER_LINEMODE_NORMAL 9 ///< Normal mode (the inverse of sleep mode) for those supporting it. +#define canTRANSCEIVER_LINEMODE_STDBY 10 ///< Standby for those who support it +#define canTRANSCEIVER_LINEMODE_TT_CAN_H 11 ///< Truck & Trailer: operating mode single wire using CAN high +#define canTRANSCEIVER_LINEMODE_TT_CAN_L 12 ///< Truck & Trailer: operating mode single wire using CAN low +#define canTRANSCEIVER_LINEMODE_OEM1 13 ///< Reserved for OEM apps +#define canTRANSCEIVER_LINEMODE_OEM2 14 ///< Reserved for OEM apps +#define canTRANSCEIVER_LINEMODE_OEM3 15 ///< Reserved for OEM apps +#define canTRANSCEIVER_LINEMODE_OEM4 16 ///< Reserved for OEM apps + +/** @} */ + +/** + * \anchor canTRANSCEIVER_RESNET_xxx + * + */ +#define canTRANSCEIVER_RESNET_NA 0 +#define canTRANSCEIVER_RESNET_MASTER 1 +#define canTRANSCEIVER_RESNET_MASTER_STBY 2 +#define canTRANSCEIVER_RESNET_SLAVE 3 + +/** + * \name Transceiver (logical) types + * \anchor canTRANSCEIVER_TYPE_xxx + * + * The following constants can be returned from \ref canGetChannelData(), using the + * \ref canCHANNELDATA_TRANS_TYPE item code. They identify the bus transceiver + * type for the channel specified in the call to \ref canGetChannelData. + * + * \note They indicate a hardware type, but not necessarily a specific circuit + * or product. + * + * @{ + */ +// Also see src\include\hwnames.h and registered document 048. +#define canTRANSCEIVER_TYPE_UNKNOWN 0 ///< Unknown or undefined +#define canTRANSCEIVER_TYPE_251 1 ///< 82c251 +#define canTRANSCEIVER_TYPE_252 2 ///< 82c252, TJA1053, TJA1054 +#define canTRANSCEIVER_TYPE_DNOPTO 3 ///< Optoisolated 82C251 +#define canTRANSCEIVER_TYPE_W210 4 ///< +#define canTRANSCEIVER_TYPE_SWC_PROTO 5 ///< AU5790 prototype +#define canTRANSCEIVER_TYPE_SWC 6 ///< AU5790 +#define canTRANSCEIVER_TYPE_EVA 7 ///< +#define canTRANSCEIVER_TYPE_FIBER 8 ///< 82c251 with fibre extension +#define canTRANSCEIVER_TYPE_K251 9 ///< K-line + 82c251 +#define canTRANSCEIVER_TYPE_K 10 ///< K-line, without CAN +#define canTRANSCEIVER_TYPE_1054_OPTO 11 ///< TJA1054 with optical isolation +#define canTRANSCEIVER_TYPE_SWC_OPTO 12 ///< AU5790 with optical isolation +#define canTRANSCEIVER_TYPE_TT 13 ///< B10011S Truck-And-Trailer +#define canTRANSCEIVER_TYPE_1050 14 ///< TJA1050 +#define canTRANSCEIVER_TYPE_1050_OPTO 15 ///< TJA1050 with optical isolation +#define canTRANSCEIVER_TYPE_1041 16 ///< TJA1041 +#define canTRANSCEIVER_TYPE_1041_OPTO 17 ///< TJA1041 with optical isolation +#define canTRANSCEIVER_TYPE_RS485 18 ///< RS485 (i.e. J1708) +#define canTRANSCEIVER_TYPE_LIN 19 ///< LIN +#define canTRANSCEIVER_TYPE_KONE 20 ///< KONE +#define canTRANSCEIVER_TYPE_CANFD 22 ///< CAN-FD +#define canTRANSCEIVER_TYPE_LINX_LIN 64 +#define canTRANSCEIVER_TYPE_LINX_J1708 66 +#define canTRANSCEIVER_TYPE_LINX_K 68 +#define canTRANSCEIVER_TYPE_LINX_SWC 70 +#define canTRANSCEIVER_TYPE_LINX_LS 72 +/** @} */ + +#endif diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/leaflight.c b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/leaflight.c index 26455d8c..999b4616 100644 --- a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/leaflight.c +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/leaflight.c @@ -38,6 +38,30 @@ #include "candriver.h" /* Generic CAN driver module */ #include "leaflight.h" /* Kvaser Leaf Light v2 interface */ #include /* for Windows API */ +/*lint -efile(537, pshpack1.h, poppack.h) */ +/*lint -efile(451, pshpack1.h, poppack.h) */ +#include "canlib.h" /* for Kvaser CANLIB API */ + + +/*************************************************************************************** +* Type definitions +****************************************************************************************/ +/* Type definitions of the function in the Kvaser CANLIB API that this CAN interface + * uses. + */ +typedef void (__stdcall * tLeafLightLibFuncInitializeLibrary)(void); +typedef canStatus (__stdcall * tLeafLightLibFuncUnloadLibrary)(void); +typedef CanHandle (__stdcall * tLeafLightLibFuncOpenChannel)(int32_t channel, int32_t flags); +typedef canStatus (__stdcall * tLeafLightLibFuncSetBusParams)(const CanHandle hnd, int32_t freq, uint32_t tseg1, uint32_t tseg2, uint32_t sjw, uint32_t noSamp, uint32_t syncmode); +typedef canStatus (__stdcall * tLeafLightLibFuncSetBusOutputControl)(const CanHandle hnd, const uint32_t drivertype); +typedef canStatus (__stdcall * tLeafLightLibFuncSetAcceptanceFilter)(const CanHandle hnd, uint32_t code, uint32_t mask, int32_t is_extended); +typedef canStatus (__stdcall * tLeafLightLibFuncIoCtl)(const CanHandle hnd, uint32_t func, void * buf, uint32_t buflen); +typedef canStatus (__stdcall * tLeafLightLibFuncBusOn)(const CanHandle hnd); +typedef canStatus (__stdcall * tLeafLightLibFuncWrite)(const CanHandle hnd, int32_t id, void * msg, uint32_t dlc, uint32_t flag); +typedef canStatus (__stdcall * tLeafLightLibFuncRead)(const CanHandle hnd, int32_t * id, void * msg, uint32_t * dlc, uint32_t * flag, uint32_t * time); +typedef canStatus (__stdcall * tLeafLightLibFuncReadStatus)(const CanHandle hnd, uint32_t * const flags); +typedef canStatus (__stdcall * tLeafLightLibFuncBusOff)(const CanHandle hnd); +typedef canStatus (__stdcall * tLeafLightLibFuncClose)(const CanHandle hnd); /*************************************************************************************** @@ -51,6 +75,32 @@ static void LeafLightDisconnect(void); static bool LeafLightTransmit(tCanMsg const * msg); static bool LeafLightIsBusError(void); static void LeafLightRegisterEvents(tCanEvents const * events); +/* CAN message reception thread. */ +static DWORD WINAPI LeafLightReceptionThread(LPVOID pv); +/* Kvaser CANLIB library handling. */ +static void LeafLightLibLoadDll(void); +static void LeafLightLibUnloadDll(void); +static void LeafLightLibFuncInitializeLibrary(void); +static canStatus LeafLightLibFuncUnloadLibrary(void); +static CanHandle LeafLightLibFuncOpenChannel(int32_t channel, int32_t flags); +static canStatus LeafLightLibFuncSetBusParams(const CanHandle hnd, int32_t freq, + uint32_t tseg1, uint32_t tseg2, + uint32_t sjw, uint32_t noSamp, + uint32_t syncmode); +static canStatus LeafLightLibFuncSetBusOutputControl(const CanHandle hnd, + const uint32_t drivertype); +static canStatus LeafLightLibFuncSetAcceptanceFilter(const CanHandle hnd, uint32_t code, + uint32_t mask, int32_t is_extended); +static canStatus LeafLightLibFuncIoCtl(const CanHandle hnd, uint32_t func, void * buf, + uint32_t buflen); +static canStatus LeafLightLibFuncBusOn(const CanHandle hnd); +static canStatus LeafLightLibFuncWrite(const CanHandle hnd, int32_t id, void * msg, + uint32_t dlc, uint32_t flag); +static canStatus LeafLightLibFuncRead(const CanHandle hnd, int32_t * id, void * msg, + uint32_t * dlc, uint32_t * flag, uint32_t * time); +static canStatus LeafLightLibFuncReadStatus(const CanHandle hnd, uint32_t * const flags); +static canStatus LeafLightLibFuncBusOff(const CanHandle hnd); +static canStatus LeafLightLibFuncClose(const CanHandle hnd); /**************************************************************************************** @@ -81,6 +131,60 @@ static tCanEvents * leafLightEventsList; /** \brief Total number of event entries into the \ref leafLightEventsList list. */ static uint32_t leafLightEventsEntries; +/** \brief Handle to the Kvaser CANLIB dynamic link library. */ +static HINSTANCE leafLightDllHandle; + +/** \brief Handle to the CAN channel. */ +static CanHandle leafLightCanHandle; + +/** \brief Function pointer to the Kvaser CANLIB canInitializeLibrary function. */ +static tLeafLightLibFuncInitializeLibrary leafLightLibFuncInitializeLibraryPtr; + +/** \brief Function pointer to the Kvaser CANLIB canUnloadLibrary function. */ +static tLeafLightLibFuncUnloadLibrary leafLightLibFuncUnloadLibraryPtr; + +/** \brief Function pointer to the Kvaser CANLIB canOpenChannel function. */ +static tLeafLightLibFuncOpenChannel leafLightLibFuncOpenChannelPtr; + +/** \brief Function pointer to the Kvaser CANLIB canSetBusParams function. */ +static tLeafLightLibFuncSetBusParams leafLightLibFuncSetBusParamsPtr; + +/** \brief Function pointer to the Kvaser CANLIB canSetBusOutputControl function. */ +static tLeafLightLibFuncSetBusOutputControl leafLightLibFuncSetBusOutputControlPtr; + +/** \brief Function pointer to the Kvaser CANLIB canSetAcceptanceFilter function. */ +static tLeafLightLibFuncSetAcceptanceFilter leafLightLibFuncSetAcceptanceFilterPtr; + +/** \brief Function pointer to the Kvaser CANLIB canIoCtl function. */ +static tLeafLightLibFuncIoCtl leafLightLibFuncIoCtlPtr; + +/** \brief Function pointer to the Kvaser CANLIB canBusOn function. */ +static tLeafLightLibFuncBusOn leafLightLibFuncBusOnPtr; + +/** \brief Function pointer to the Kvaser CANLIB canWrite function. */ +static tLeafLightLibFuncWrite leafLightLibFuncWritePtr; + +/** \brief Function pointer to the Kvaser CANLIB canRead function. */ +static tLeafLightLibFuncRead leafLightLibFuncReadPtr; + +/** \brief Function pointer to the Kvaser CANLIB canReadStatus function. */ +static tLeafLightLibFuncReadStatus leafLightLibFuncReadStatusPtr; + +/** \brief Function pointer to the Kvaser CANLIB canBusOff function. */ +static tLeafLightLibFuncBusOff leafLightLibFuncBusOffPtr; + +/** \brief Function pointer to the Kvaser CANLIB canClose function. */ +static tLeafLightLibFuncClose leafLightLibFuncClosePtr; + +/** \brief Handle for the event to terminate the reception thread. */ +static HANDLE leafLightTerminateEvent; + +/** \brief Handle for a CAN related event. */ +static HANDLE leafLightCanEvent; + +/** \brief Handle for the CAN reception thread. */ +static HANDLE leafLightRxThreadHandle; + /***********************************************************************************//** ** \brief Obtains a pointer to the CAN interface structure, so that it can be linked @@ -106,6 +210,25 @@ static void LeafLightInit(tCanSettings const * settings) /* Initialize locals. */ leafLightEventsList = NULL; leafLightEventsEntries = 0; + leafLightTerminateEvent = NULL; + leafLightCanEvent = NULL; + leafLightRxThreadHandle = NULL; + leafLightDllHandle = NULL; + leafLightCanHandle = -1; + /* Reset library function pointers. */ + leafLightLibFuncInitializeLibraryPtr = NULL; + leafLightLibFuncUnloadLibraryPtr = NULL; + leafLightLibFuncOpenChannelPtr = NULL; + leafLightLibFuncSetBusParamsPtr = NULL; + leafLightLibFuncSetBusOutputControlPtr = NULL; + leafLightLibFuncSetAcceptanceFilterPtr = NULL; + leafLightLibFuncIoCtlPtr = NULL; + leafLightLibFuncBusOnPtr = NULL; + leafLightLibFuncWritePtr = NULL; + leafLightLibFuncReadPtr = NULL; + leafLightLibFuncReadStatusPtr = NULL; + leafLightLibFuncBusOffPtr = NULL; + leafLightLibFuncClosePtr = NULL; /* Reset CAN interface settings. */ leafLightSettings.devicename = ""; leafLightSettings.channel = 0; @@ -135,7 +258,9 @@ static void LeafLightInit(tCanSettings const * settings) leafLightSettings.devicename = canDeviceName; } } - /* ##Vg TODO Perform initialization of Kvaser Leaf Light API. */ + /* Perform initialization of Kvaser Leaf Light API. */ + LeafLightLibLoadDll(); + LeafLightLibFuncInitializeLibrary(); } } /*** end of LeafLightInit ***/ @@ -146,7 +271,9 @@ static void LeafLightInit(tCanSettings const * settings) ****************************************************************************************/ static void LeafLightTerminate(void) { - /* ##Vg TODO Perform termination of Kvaser Leaf Light API. */ + /* Perform termination of Kvaser Leaf Light API. */ + (void)LeafLightLibFuncUnloadLibrary(); + LeafLightLibUnloadDll(); /* Release memory that was allocated for storing the device name. */ if (leafLightSettings.devicename != NULL) { @@ -175,9 +302,214 @@ static void LeafLightTerminate(void) static bool LeafLightConnect(void) { bool result = false; + bool baudrateSupported = true; + int32_t frequency = 0; + uint32_t tseg1 = 0; + uint32_t tseg2 = 0; + uint32_t sjw = 0; + uint32_t noSamp = 0; - /* ##Vg TODO Process and verify settings, configure acceptance filter, connect. */ + /* Convert the baudrate to a value supported by the PCAN-Basic API. */ + switch (leafLightSettings.baudrate) + { + case CAN_BR10K: + frequency = canBITRATE_10K; + break; + case CAN_BR20K: + frequency = 20000; + tseg1 = 5; + tseg2 = 2; + sjw = 2; + noSamp = 1; + break; + case CAN_BR50K: + frequency = canBITRATE_50K; + break; + case CAN_BR100K: + frequency = canBITRATE_100K; + break; + case CAN_BR125K: + frequency = canBITRATE_125K; + break; + case CAN_BR250K: + frequency = canBITRATE_250K; + break; + case CAN_BR500K: + frequency = canBITRATE_500K; + break; + case CAN_BR800K: + frequency = 800000; + tseg1 = 6; + tseg2 = 3; + sjw = 2; + noSamp = 1; + break; + case CAN_BR1M: + frequency = canBITRATE_1M; + break; + default: + baudrateSupported = false; + break; + } + /* Note that the device name itself is not needed anymore at this point, it was only + * needed by the CAN driver to link the correct interface (this one). The channel is + * also don't care as the adapter only has one channel. Check settings. + */ + assert(baudrateSupported); + + /* Invalidate handles. */ + leafLightCanHandle = -1; + leafLightTerminateEvent = NULL; + leafLightCanEvent = NULL; + leafLightRxThreadHandle = NULL; + + /* Only continue with valid settings. */ + if (baudrateSupported) + { + /* Init result code to success and only negate it on detection of error. */ + result = true; + /* Open the CAN channel with support for both 11- and 29-bit CAN identifiers, and + * obtain its handle. + */ + leafLightCanHandle = LeafLightLibFuncOpenChannel(0, canOPEN_REQUIRE_INIT_ACCESS | + canOPEN_REQUIRE_EXTENDED); + /* Validate the handle. */ + if (leafLightCanHandle < 0) + { + result = false; + } + /* Configure the baudrate. */ + if (result) + { + if (LeafLightLibFuncSetBusParams(leafLightCanHandle, frequency, tseg1, tseg2, + sjw, noSamp, 0) != canOK) + { + result = false; + } + } + /* Set output control to the default normal mode. */ + if (result) + { + if (LeafLightLibFuncSetBusOutputControl(leafLightCanHandle, + canDRIVER_NORMAL) != canOK) + { + result = false; + } + } + /* Configure reception acceptance filter. */ + if ( (result) && (leafLightSettings.mask != 0x00000000u) ) + { + /* Start out by closing the acceptance filters first. */ + if (LeafLightLibFuncSetAcceptanceFilter(leafLightCanHandle, 0x00000000u, + 0x00000000u, 0) != canOK) + { + result = false; + } + if (result) + { + if (LeafLightLibFuncSetAcceptanceFilter(leafLightCanHandle, 0x00000000u, + 0x00000000u, 1) != canOK) + { + result = false; + } + } + if (result) + { + /* Use bit logic to determine if the filter should accept standard 11-bit and/or + * extended 29-bit identifiers: + * acceptStdId = ((mask & code & CAN_MSG_EXT_ID_MASK) == 0) + * acceptExtId = ((mask & code & CAN_MSG_EXT_ID_MASK) != 0) || + * ((mask & CAN_MSG_EXT_ID_MASK) == 0) + */ + bool acceptStdID = ((leafLightSettings.mask & leafLightSettings.code & CAN_MSG_EXT_ID_MASK) == 0); + bool acceptExtID = ((leafLightSettings.mask & leafLightSettings.code & CAN_MSG_EXT_ID_MASK) != 0) || + ((leafLightSettings.mask & CAN_MSG_EXT_ID_MASK) == 0); + /* Configure acceptance filter for standard 11-bit identifiers. */ + if (acceptStdID) + { + if (LeafLightLibFuncSetAcceptanceFilter(leafLightCanHandle, + leafLightSettings.code & 0x1fffffffu, + leafLightSettings.mask & 0x1fffffffu, + 0) != canOK) + { + result = false; + } + } + /* Configure acceptance filter for extended 29-bit identifiers. */ + if ((acceptExtID) && (result)) + { + if (LeafLightLibFuncSetAcceptanceFilter(leafLightCanHandle, + leafLightSettings.code & 0x1fffffffu, + leafLightSettings.mask & 0x1fffffffu, + 1) != canOK) + { + result = false; + } + } + } + } + /* Go on the bus. */ + if (result) + { + if (LeafLightLibFuncBusOn(leafLightCanHandle) != canOK) + { + result = false; + } + } + /* Obtain the handle for CAN events. */ + if (result) + { + leafLightCanEvent = NULL; + if (LeafLightLibFuncIoCtl(leafLightCanHandle, canIOCTL_GET_EVENTHANDLE, + &leafLightCanEvent, sizeof(leafLightCanEvent)) != canOK) + { + result = false; + } + /* Validate the handle. */ + if (leafLightCanEvent == NULL) + { + result = false; + } + } + /* Create the terminate event handle used in the reception thread. */ + if (result) + { + leafLightTerminateEvent = CreateEvent(NULL, TRUE, FALSE, ""); + if (leafLightTerminateEvent == NULL) + { + result = false; + } + } + /* Start the reception thread as the last step. */ + if (result) + { + leafLightRxThreadHandle = CreateThread(NULL, 0, LeafLightReceptionThread, + NULL, 0, NULL); + if (leafLightRxThreadHandle == NULL) + { + result = false; + } + } + } + + /* Clean-up in case an error occurred. */ + if (!result) + { + if (leafLightCanHandle >= 0) + { + /* Go off the bus and close the channel. */ + (void)LeafLightLibFuncBusOff(leafLightCanHandle); + (void)LeafLightLibFuncClose(leafLightCanHandle); + leafLightCanHandle = -1; + } + if (leafLightTerminateEvent != NULL) + { + /* Close the event handle. */ + (void)CloseHandle(leafLightTerminateEvent); + leafLightTerminateEvent = NULL; + } + } /* Give the result back to the caller. */ return result; } /*** end of LeafLightConnect ***/ @@ -189,7 +521,30 @@ static bool LeafLightConnect(void) ****************************************************************************************/ static void LeafLightDisconnect(void) { - /* ##Vg TODO Disconnect. */ + /* Stop the reception thread. */ + if (leafLightRxThreadHandle != NULL) + { + /* Trigger event to request the reception thread to stop. */ + (void)SetEvent(leafLightTerminateEvent); + /* Wait for the thread to signal termination. */ + (void)WaitForSingleObject(leafLightRxThreadHandle, INFINITE); + /* Close the thread handle. */ + (void)CloseHandle(leafLightRxThreadHandle); + leafLightRxThreadHandle = NULL; + } + /* Close the terminate event handle. */ + if (leafLightTerminateEvent != NULL) + { + (void)CloseHandle(leafLightTerminateEvent); + leafLightTerminateEvent = NULL; + } + /* Go off the bus and close the channel. */ + if (leafLightCanHandle >= 0) + { + (void)LeafLightLibFuncBusOff(leafLightCanHandle); + (void)LeafLightLibFuncClose(leafLightCanHandle); + leafLightCanHandle = -1; + } } /*** end of LeafLightDisconnect ***/ @@ -202,14 +557,52 @@ static void LeafLightDisconnect(void) static bool LeafLightTransmit(tCanMsg const * msg) { bool result = false; + tCanEvents const * pEvents; + int32_t txId; + uint32_t txFlags; + uint8_t txData[CAN_MSG_MAX_LEN]; /* Check parameters. */ assert(msg != NULL); - /* Only continue with valid parameters. */ - if (msg != NULL) /*lint !e774 */ + /* Only continue with valid parameters and handle. */ + if ( (msg != NULL) && (leafLightCanHandle >= 0) ) /*lint !e774 */ { - /* ##Vg TODO Transmit and trigger event(s). */ + /* Prepare message. */ + if ((msg->id & CAN_MSG_EXT_ID_MASK) == 0) + { + txId = msg->id & 0x7ffu; + txFlags = canMSG_STD; + } + else + { + txId = msg->id & 0x1fffffffu; + txFlags = canMSG_EXT; + } + for (uint8_t idx = 0; idx < msg->dlc; idx++) + { + txData[idx] = msg->data[idx]; + } + /* Submit CAN message for transmission. */ + if (LeafLightLibFuncWrite(leafLightCanHandle, txId, txData, msg->dlc, txFlags) == canOK) + { + /* Update result value to success. */ + result = true; + /* Trigger transmit complete event(s). */ + pEvents = leafLightEventsList; + for (uint32_t idx = 0; idx < leafLightEventsEntries; idx++) + { + if (pEvents != NULL) + { + if (pEvents->MsgTxed != NULL) + { + pEvents->MsgTxed(msg); + } + /* Move on to the next entry in the list. */ + pEvents++; + } + } + } } /* Give the result back to the caller. */ return result; @@ -224,9 +617,21 @@ static bool LeafLightTransmit(tCanMsg const * msg) static bool LeafLightIsBusError(void) { bool result = false; + uint32_t statusFlags; - /* ##Vg TODO Check and process status. */ - + /* Only continue with valid handle. */ + if (leafLightCanHandle >= 0) + { + /* Read the status flags. */ + if (LeafLightLibFuncReadStatus(leafLightCanHandle, &statusFlags) == canOK) + { + /* Check for bus off or error passive bits. */ + if ((statusFlags & (canSTAT_BUS_OFF | canSTAT_ERROR_PASSIVE)) != 0) + { + result = true; + } + } + } /* Give the result back to the caller. */ return result; } /*** end of LeafLightIsBusError ***/ @@ -272,5 +677,577 @@ static void LeafLightRegisterEvents(tCanEvents const * events) } /*** end of LeafLightRegisterEvents ***/ +/************************************************************************************//** +** \brief CAN message reception thread. +** \param pv Pointer to thread parameters. +** \return Thread exit code. +** +****************************************************************************************/ +static DWORD WINAPI LeafLightReceptionThread(LPVOID pv) +{ + DWORD waitResult; + HANDLE handles[] = + { + leafLightCanEvent, + leafLightTerminateEvent + }; + bool running = true; + int32_t rxId; + uint32_t rxDlc; + uint32_t rxTime; + uint32_t rxFlags; + tCanMsg rxMsg; + canStatus rxStatus; + tCanEvents const * pEvents; + + /* Parameter not used. */ + (void)pv; + + /* Enter thread's infinite loop. */ + while (running) + { + waitResult = WaitForMultipleObjects(sizeof(handles)/sizeof(handles[0]), handles, + FALSE, INFINITE); + switch (waitResult) + { + /* CAN reception event. */ + case WAIT_OBJECT_0 + 0: /*lint !e835 */ + /* Only read out the events when the handle is valid. */ + if (leafLightCanHandle >= 0) + { + /* Empty out the event queue. */ + do + { + rxStatus = LeafLightLibFuncRead(leafLightCanHandle, &rxId, &rxMsg.data[0], + &rxDlc, &rxFlags, &rxTime); + /* Only process the result if a message was read. */ + if (rxStatus == canOK) + { + /* Only process STD and EXT messages. */ + if ((rxFlags & (canMSG_STD | canMSG_EXT)) != 0) + { + /* Convert the CAN message to the format of the CAN driver module. Note + * that the data was already copied by LeafLightLibFuncRead(). + */ + rxMsg.id = (uint32_t)rxId; + if ((rxFlags & canMSG_EXT) != 0) + { + rxMsg.id |= CAN_MSG_EXT_ID_MASK; + } + rxMsg.dlc = (uint8_t)rxDlc; + + /* Trigger message reception event(s). */ + pEvents = leafLightEventsList; + for (uint32_t idx = 0; idx < leafLightEventsEntries; idx++) + { + if (pEvents != NULL) + { + if (pEvents->MsgRxed != NULL) + { + pEvents->MsgRxed(&rxMsg); + } + /* Move on to the next entry in the list. */ + pEvents++; + } + } + } + } + } + while (rxStatus != canERR_NOMSG); + } + break; + + /* Termination event. */ + default: + case WAIT_OBJECT_0 + 1: /*lint !e835 */ + /* Stop thread. */ + running = false; + break; + } + } + /* Exit thread. */ + return 0; +} /*** end of LeafLightReceptionThread ***/ + + +/************************************************************************************//** +** \brief Loads the Kvaser CANLIB DLL and initializes the API function pointers. +** +****************************************************************************************/ +static void LeafLightLibLoadDll(void) +{ + /* Reset the channel handle. */ + leafLightCanHandle = -1; + /* Start out by resetting the API function pointers. */ + leafLightLibFuncInitializeLibraryPtr = NULL; + leafLightLibFuncUnloadLibraryPtr = NULL; + leafLightLibFuncOpenChannelPtr = NULL; + leafLightLibFuncSetBusParamsPtr = NULL; + leafLightLibFuncSetBusOutputControlPtr = NULL; + leafLightLibFuncSetAcceptanceFilterPtr = NULL; + leafLightLibFuncIoCtlPtr = NULL; + leafLightLibFuncBusOnPtr = NULL; + leafLightLibFuncWritePtr = NULL; + leafLightLibFuncReadPtr = NULL; + leafLightLibFuncReadStatusPtr = NULL; + leafLightLibFuncBusOffPtr = NULL; + leafLightLibFuncClosePtr = NULL; + + /* Attempt to load the library and obtain a handle to it. */ + leafLightDllHandle = LoadLibrary("canlib32"); + + /* Assert libary handle. */ + assert(leafLightDllHandle != NULL); + + /* Only continue if the library was successfully loaded */ + if (leafLightDllHandle != NULL) /*lint !e774 */ + { + /* Set canInitializeLibrary function pointer. */ + leafLightLibFuncInitializeLibraryPtr = (tLeafLightLibFuncInitializeLibrary)GetProcAddress(leafLightDllHandle, "canInitializeLibrary"); + /* Set canUnloadLibrary function pointer. */ + leafLightLibFuncUnloadLibraryPtr = (tLeafLightLibFuncUnloadLibrary)GetProcAddress(leafLightDllHandle, "canUnloadLibrary"); + /* Set canOpenChannel function pointer. */ + leafLightLibFuncOpenChannelPtr = (tLeafLightLibFuncOpenChannel)GetProcAddress(leafLightDllHandle, "canOpenChannel"); + /* Set canSetBusParams function pointer. */ + leafLightLibFuncSetBusParamsPtr = (tLeafLightLibFuncSetBusParams)GetProcAddress(leafLightDllHandle, "canSetBusParams"); + /* Set canSetBusOutputControl function pointer. */ + leafLightLibFuncSetBusOutputControlPtr = (tLeafLightLibFuncSetBusOutputControl)GetProcAddress(leafLightDllHandle, "canSetBusOutputControl"); + /* Set canAccept function pointer. */ + leafLightLibFuncSetAcceptanceFilterPtr = (tLeafLightLibFuncSetAcceptanceFilter)GetProcAddress(leafLightDllHandle, "canSetAcceptanceFilter"); + /* Set canIoCtl function pointer. */ + leafLightLibFuncIoCtlPtr = (tLeafLightLibFuncIoCtl)GetProcAddress(leafLightDllHandle, "canIoCtl"); + /* Set canBusOn function pointer. */ + leafLightLibFuncBusOnPtr = (tLeafLightLibFuncBusOn)GetProcAddress(leafLightDllHandle, "canBusOn"); + /* Set canWrite function pointer. */ + leafLightLibFuncWritePtr = (tLeafLightLibFuncWrite)GetProcAddress(leafLightDllHandle, "canWrite"); + /* Set canRead function pointer. */ + leafLightLibFuncReadPtr = (tLeafLightLibFuncRead)GetProcAddress(leafLightDllHandle, "canRead"); + /* Set canReadStatus function pointer. */ + leafLightLibFuncReadStatusPtr = (tLeafLightLibFuncReadStatus)GetProcAddress(leafLightDllHandle, "canReadStatus"); + /* Set canBusOff function pointer. */ + leafLightLibFuncBusOffPtr = (tLeafLightLibFuncBusOff)GetProcAddress(leafLightDllHandle, "canBusOff"); + /* Set canClose function pointer. */ + leafLightLibFuncClosePtr = (tLeafLightLibFuncClose)GetProcAddress(leafLightDllHandle, "canClose"); + } +} /*** end of LeafLightLibLoadDll ***/ + + +/************************************************************************************//** +** \brief Unloads the Kvaser CANLIB DLL and resets the API function pointers. +** +****************************************************************************************/ +static void LeafLightLibUnloadDll(void) +{ + /* Reset the API function pointers. */ + leafLightLibFuncInitializeLibraryPtr = NULL; + leafLightLibFuncUnloadLibraryPtr = NULL; + leafLightLibFuncOpenChannelPtr = NULL; + leafLightLibFuncSetBusParamsPtr = NULL; + leafLightLibFuncSetBusOutputControlPtr = NULL; + leafLightLibFuncSetAcceptanceFilterPtr = NULL; + leafLightLibFuncIoCtlPtr = NULL; + leafLightLibFuncBusOnPtr = NULL; + leafLightLibFuncWritePtr = NULL; + leafLightLibFuncReadPtr = NULL; + leafLightLibFuncReadStatusPtr = NULL; + leafLightLibFuncBusOffPtr = NULL; + leafLightLibFuncClosePtr = NULL; + /* Reset the channel handle. */ + leafLightCanHandle = -1; + /* Unload the library and invalidate its handle. */ + if (leafLightDllHandle != NULL) + { + (void)FreeLibrary(leafLightDllHandle); + leafLightDllHandle = NULL; + } +} /*** end of LeafLightLibUnloadDll **/ + + +/************************************************************************************//** +** \brief This function must be called before any other functions is used. It will +** initialize the driver. +** +****************************************************************************************/ +static void LeafLightLibFuncInitializeLibrary(void) +{ + /* Check function pointer and library handle. */ + assert(leafLightLibFuncInitializeLibraryPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncInitializeLibraryPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + leafLightLibFuncInitializeLibraryPtr(); + } +} /*** end of LeafLightLibFuncInitializeLibrary ***/ + + +/************************************************************************************//** +** \brief Frees allocated memory, unload the DLLs canlib32.dll has loaded and de- +** initializes data structures. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncUnloadLibrary(void) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncUnloadLibraryPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncUnloadLibraryPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncUnloadLibraryPtr(); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncUnloadLibrary ***/ + + +/************************************************************************************//** +** \brief Opens a CAN channel and returns a handle which is used in subsequent calls. +** \param channel The number of the channel. Channel numbering is hardware dependent. +** \param flags A combination of canOPEN_xxx flags. +** \return Handle (positive) to the channel if successful, canERR_xxx (negative) +** otherwise. +** +****************************************************************************************/ +static CanHandle LeafLightLibFuncOpenChannel(int32_t channel, int32_t flags) +{ + canHandle result = (canHandle)canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncOpenChannelPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncOpenChannelPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncOpenChannelPtr(channel, flags); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncOpenChannel ***/ + + +/************************************************************************************//** +** \brief This function sets the nominal bus timing parameters for the specified CAN +** controller. The library provides default values for tseg1, tseg2, sjw and +** noSamp when freq is specified to one of the pre-defined constants, +** canBITRATE_xxx for classic CAN and canFD_BITRATE_xxx for CAN FD. +** \param hnd An open handle to a CAN controller. +** \param freq Bit rate (measured in bits per second); or one of the predefined +** constants (canBITRATE_xxx for classic CAN and canFD_BITRATE_xxx for +** CAN FD). +** \param tseg1 Time segment 1, that is, the number of quanta from (but not +** including) the Sync Segment to the sampling point. +** \param tseg2 Time segment 2, that is, the number of quanta from the sampling point +** to the end of the bit. +** \param sjw The Synchronization Jump Width. +** \param noSamp The number of sampling points; can be 1 or 3. +** \param syncmode Unsupported and ignored. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncSetBusParams(const CanHandle hnd, int32_t freq, + uint32_t tseg1, uint32_t tseg2, + uint32_t sjw, uint32_t noSamp, + uint32_t syncmode) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncSetBusParamsPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncSetBusParamsPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncSetBusParamsPtr(hnd, freq, tseg1, tseg2, sjw, noSamp, syncmode); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncSetBusParams ***/ + + +/************************************************************************************//** +** \brief This function sets the driver type for a CAN controller. This corresponds +** loosely to the bus output control register in the CAN controller, hence the +** name of this function. CANLIB does not allow for direct manipulation of the +** bus output control register; instead, symbolic constants are used to select +** the desired driver type. +** \param hnd A handle to an open circuit. +** \param drivertype Can driver type (canDRIVER_xxx). +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncSetBusOutputControl(const CanHandle hnd, + const uint32_t drivertype) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncSetBusOutputControlPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncSetBusOutputControlPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncSetBusOutputControlPtr(hnd, drivertype); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncSetBusOutputControl ***/ + + +/************************************************************************************//** +** \brief This routine sets the message acceptance filters on a CAN channel. +** \param hnd A handle to an open circuit. +** \param code The acceptance code to set. +** \param mask The acceptance mask to set +** \param is_extended Select 29-bit CAN identifiers. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncSetAcceptanceFilter(const CanHandle hnd, uint32_t code, + uint32_t mask, int32_t is_extended) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncSetAcceptanceFilterPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncSetAcceptanceFilterPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncSetAcceptanceFilterPtr(hnd, code, mask, is_extended); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncSetAcceptanceFilter ***/ + + +/************************************************************************************//** +** \brief This API call performs several different functions; these are described +** below. The functions are handle-specific unless otherwise noted; this means +** that they affect only the handle you pass to canIoCtl(), whereas other open +** handles will remain unaffected. The contents of buf after the call is +** dependent on the function code you specified. +** \param hnd A handle to an open circuit. +** \param func A canIOCTL_xxx function code. +** \param buf Pointer to a buffer containing function-dependent data; or a NULL +** pointer for certain function codes. The buffer can be used for both input +** and output depending on the function code. See canIOCTL_xxx. +** \param buflen The length of the buffer. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncIoCtl(const CanHandle hnd, uint32_t func, void * buf, + uint32_t buflen) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncIoCtlPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncIoCtlPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncIoCtlPtr(hnd, func, buf, buflen); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncIoCtl ***/ + + +/************************************************************************************//** +** \brief Takes the specified channel on-bus. +** \param hnd An open handle to a CAN channel. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncBusOn(const CanHandle hnd) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncBusOnPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncBusOnPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncBusOnPtr(hnd); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncBusOn ***/ + + +/************************************************************************************//** +** \brief This function sends a CAN message. The call returns immediately after +** queuing the message to the driver. +** \param hnd A handle to an open CAN circuit. +** \param id The identifier of the CAN message to send. +** \param msg A pointer to the message data, or NULL. +** \param dlc The length of the message in bytes. +** \param flag A combination of message flags, canMSG_xxx (including canFDMSG_xxx if +** the CAN FD protocol is enabled). Use this parameter to send extended +** (29-bit) frames and/or remote frames. Use canMSG_EXT and/or canMSG_RTR for +** this purpose. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncWrite(const CanHandle hnd, int32_t id, void * msg, + uint32_t dlc, uint32_t flag) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncWritePtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncWritePtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncWritePtr(hnd, id, msg, dlc, flag); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncWrite ***/ + + +/************************************************************************************//** +** \brief Reads a message from the receive buffer. If no message is available, the +** function returns immediately with return code canERR_NOMSG. +** \param hnd A handle to an open circuit. +** \param id Pointer to a buffer which receives the CAN identifier. This buffer will +** only get the identifier. To determine whether this identifier was standard +** (11-bit) or extended (29-bit), and/or whether it was remote or not, or if +** it was an error frame, examine the contents of the flag argument. +** \param msg Pointer to the buffer which receives the message data. This buffer must +** be large enough (i.e. 8 bytes.) Only the message data is copied; the rest +** of the buffer is left as-is. +** \param dlc Pointer to a buffer which receives the message length. +** \param flag Pointer to a buffer which receives the message flags, which is a +** combination of the canMSG_xxx and canMSGERR_xxx values. +** \param time Pointer to a buffer which receives the message time stamp. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncRead(const CanHandle hnd, int32_t * id, void * msg, + uint32_t * dlc, uint32_t * flag, uint32_t * time) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncReadPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncReadPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncReadPtr(hnd, id, msg, dlc, flag, time); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncRead ***/ + + +/************************************************************************************//** +** \brief Returns the status for the specified circuit. flags points to a longword +** which receives a combination of the canSTAT_xxx flags. +** \param hnd A handle to an open circuit. +** \param flags Pointer to a DWORD which receives the status flags; this is a +** combination of any of the canSTAT_xxx. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncReadStatus(const CanHandle hnd, uint32_t * const flags) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncReadStatusPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncReadStatusPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncReadStatusPtr(hnd, flags); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncReadStatus ***/ + + +/************************************************************************************//** +** \brief Takes the specified channel off-bus. +** \param hnd A handle to an open circuit. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncBusOff(const CanHandle hnd) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncBusOffPtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncBusOffPtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncBusOffPtr(hnd); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncBusOff ***/ + + +/************************************************************************************//** +** \brief Closes the channel associated with the handle. If no other threads are +** using the CAN circuit, it is taken off bus. The handle can not be used for +** further references to the channel, so any variable containing it should be +** zeroed. +** \param hnd A handle to an open circuit. +** \return canOK if successful, canERR_xxx otherwise. +** +****************************************************************************************/ +static canStatus LeafLightLibFuncClose(const CanHandle hnd) +{ + canStatus result = canERR_NOTINITIALIZED; + + /* Check function pointer and library handle. */ + assert(leafLightLibFuncClosePtr != NULL); + assert(leafLightDllHandle != NULL); + + /* Only continue with valid function pointer and library handle. */ + if ((leafLightLibFuncClosePtr != NULL) && (leafLightDllHandle != NULL)) /*lint !e774 */ + { + /* Call library function. */ + result = leafLightLibFuncClosePtr(hnd); + } + /* Give the result back to the caller. */ + return result; +} /*** end of LeafLightLibFuncClose ***/ + + /*********************************** end of leaflight.c ********************************/ diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/obsolete.h b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/obsolete.h new file mode 100644 index 00000000..02924bca --- /dev/null +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/obsolete.h @@ -0,0 +1,304 @@ +/** + * \section LICENSE + * Copyright 1998-2011 by KVASER AB, SWEDEN + * + * WWW: http://www.kvaser.com + * + * This software is furnished under a license and may be used and copied + * only in accordance with the terms of such license. + * + * \section DESCRIPTION + * + * This file contains definitions which are retained for compatibility. + * + * \file obsolete.h + * \author Kvaser AB + */ + +#ifndef _OBSOLETE_H_ +#define _OBSOLETE_H_ + +/** + * \defgroup Obsolete Obsolete API Reference + * @{ + */ + +#define canCIRCUIT_ANY -1 ///< Any circuit will do \warning Obsolete! +#define canCARD_ANY -1 ///< Any card will do \warning Obsolete! +#define canCHANNEL_ANY -1 ///< Any channel will do \warning Obsolete! + +#define CANID_METAMSG (-1L) ///< Like msgs containing bus status changes. \warning Obsolete! +#define CANID_WILDCARD (-2L) ///< We don't care or don't know. \warning Obsolete! + +/** + * Retained for compatibility. + */ + +/** + * \warning Obsolete! + */ +typedef void* (*canMemoryAllocator) (size_t size); + +/** + * \warning Obsolete! + */ +typedef void (*canMemoryDeallocator)(void* p); + +/** + * \warning Obsolete! + */ +typedef struct tagCanHWDescr { + int circuitType; + int cardType; + int channel; +} canHWDescr; + +/** + * \warning Obsolete! + */ +typedef struct tagCanSWDescr { + unsigned int rxBufSize; + unsigned int txBufSize; + canMemoryAllocator alloc; + canMemoryDeallocator deAlloc; +} canSWDescr; + +#ifdef __WIN32__ +/** + * \warning Obsolete! + */ +typedef struct { + unsigned int size; + unsigned int rxBufSize; + unsigned int txBufSize; +} canSWDescriptorEx; +#endif + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canLocateHardware(void); + +/** + * \warning Obsolete! + */ +int CANLIBAPI canOpen(const canHWDescr * const hwdescr, + const canSWDescr * const swdescr, + const unsigned int flags); + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canGetCircuits(int * context, + char * name, + char * vendor, + char * version, + unsigned int * cardtype, + unsigned int * circtype, + unsigned int * channel); + +/** + * \name Some obsolete codes; they are not used nowadays. + * \warning Obsolete! + * @{ + */ +#define canERR_BUFOFL canERR_RESERVED_3 ///< "Buffer overflow" \warning Obsolete! +#define canERR_REINIT canERR_RESERVED_4 ///< "Reinitialization failed" \warning Obsolete! +#define canERR_MSGLOST canERR_RESERVED_5 ///< "Message lost by CAN-chip" \warning Obsolete! +#define canERR_OVERRUN canERR_RESERVED_6 ///< "Receive buffer overrun" \warning Obsolete! +#define canERR_CARDCOMMFAILED canERR_RESERVED_7 ///< "Can't communicate with the card" \warning Obsolete! +/** @} */ + +/** + * \name Circuit status flags, retained for compatibility + * \warning Obsolete! + * @{ + */ +#define canCIRCSTAT_ERROR_PASSIVE 0x0001 ///< Error passive \warning Obsolete! +#define canCIRCSTAT_BUS_OFF 0x0002 ///< Bus off \warning Obsolete! +#define canCIRCSTAT_ERROR_WARNING 0x0004 ///< Error counter > 96 \warning Obsolete! +/** @} */ + + +/** + * \name retained for compatibility + * \warning Obsolete! + * @{ + */ +#define canCHANNEL_CAP_REMOTE canCHANNEL_CAP_RESERVED_1 ///< Obsolete, use \ref canCHANNEL_CAP_REMOTE_ACCESS or \ref canCHANNELDATA_IS_REMOTE + + +/** + * \name Sticky status flags + * \warning Obsolete! + * @{ + */ +#define canSTICKY_ACK_ERROR 0x80000801 ///< \warning Obsolete! +#define canSTICKY_FORM_ERROR 0x80000002 ///< \warning Obsolete! +#define canSTICKY_STUFF_ERROR 0x80000004 ///< \warning Obsolete! +#define canSTICKY_CRC_ERROR 0x80000008 ///< \warning Obsolete! +#define canSTICKY_BIT0_ERROR 0x80000010 ///< \warning Obsolete! +#define canSTICKY_BIT1_ERROR 0x80000020 ///< \warning Obsolete! +#define canSTICKY_HW_OVERRUN 0x80000040 ///< \warning Obsolete! +#define canSTICKY_SW_OVERRUN 0x80000080 ///< \warning Obsolete! +/** @} */ + +#define canSTAT_INACTIVE canSTAT_RESERVED_1 ///< The circuit is not active (removed from the sw bus) \warning Obsolete! + + +/* +#define canCIRCSTAT_TXERR 0x0001 // TX error has occurred +#define canCIRCSTAT_RXERR 0x0002 // Receive error has occurred +#define canCIRCSTAT_OVERRUN 0x0004 // Receiver overrun +#define canCIRCSTAT_WAKEUP 0x0008 // Wakeup has occurred +#define canCIRCSTAT_INT 0x0010 // ?? +#define canCIRCSTAT_ACK 0x0020 // ACK error +#define canCIRCSTAT_BIT 0x0040 // Bit error +*/ +/* +More apocryphs. +#define canCIRCSTAT_OVERRUN 0x0004 // Receiver overrun +#define canCIRCSTAT_WAKEUP 0x0008 // Wakeup has occurred +#define canCIRCSTAT_ACK 0x0010 // ACK error +#define canCIRCSTAT_BIT0 0x0020 // Bit error +#define canCIRCSTAT_BIT1 0x0040 // Bit error +#define canCIRCSTAT_BOFF 0x0080 // Chip went Bus Off +*/ +/* +Even more. +#define canCIRCSTAT_BOFF_HW 0x10000L // Chip is Bus Off +#define canCIRCSTAT_BOFF_SW 0x20000L // We are Bus Off +*/ + + +/** + * \name Flags for canOpen + * \warning Obsolete! Use \ref canOPEN_xxx instead. + * @{ + */ +#define canWANT_ACTIONS 0x01 ///< \warning Obsolete! +#define canWANT_OWN_BUFFERS 0x02 ///< \warning Obsolete! +#define canWANT_ERROR_COUNTERS 0x04 ///< \warning Obsolete! +#define canWANT_EXCLUSIVE 0x08 ///< \warning Obsolete! Use \ref canOPEN_xxx instead. +#define canWANT_EXTENDED 0x10 ///< \warning Obsolete! Use \ref canOPEN_xxx instead. +#if defined(CANLIB_DECLARE_ALL) +# define canWANT_VIRTUAL 0x20 ///< \warning Obsolete! Use \ref canOPEN_xxx instead. +#endif + +/** @} */ + +/** + * \name Circuit types. + * \warning Obsolete! + * @{ + */ +// No circuit 0 +#define PCCAN_PHILIPS 1 ///< 82C200 on PCCAN 1.0 \warning Obsolete! +#define PCCAN_INTEL526 2 ///< Not supported. \warning Obsolete! +#define PCCAN_INTEL527 3 ///< 82527 on PCCAN 1.0 \warning Obsolete! +#define CANCARD_NEC72005 4 ///< NEC72005 on CANCard \warning Obsolete! +#define CIRC_VIRTUAL 5 ///< \warning Obsolete! +#define CIRC_SJA1000 6 ///< \warning Obsolete! +/** @} */ + +/** + * \name Card types. + * \warning Obsolete! + * @{ + */ +#define canCARD_PCCAN 1 ///< PCCAN ver 1.x (KVASER) \warning Obsolete! +#define canCARD_CANCARD 2 ///< CANCard (Softing) \warning Obsolete! +#define canCARD_AC2 3 ///< CAN-AC2 (Softing) \warning Obsolete! +#define canCARD_LAPCAN 4 ///< \warning Obsolete! +#define canCARD_ISACAN 5 ///< \warning Obsolete! +#define canCARD_PCCAN_OEM 6 ///< Special for OEM PCcan cards. \warning Obsolete! +/** @} */ + +/** + * \name The canFlgXXX are left for compatibility. + * \warning Obsolete! + * @{ + */ +#define canFlgACCEPT 1 ///< \warning Obsolete! +#define canFlgREJECT 2 ///< \warning Obsolete! +#define canFlgCODE 3 ///< \warning Obsolete! +#define canFlgMASK 4 ///< \warning Obsolete! +/** @} */ + +/** + * \name Flags for action routines + * \warning Obsolete! + * @{ + */ +#define canDISCARD_MESSAGE 3 ///< \warning Obsolete! +#define canRETAIN_MESSAGE 4 ///< \warning Obsolete! +/** @} */ + +/** + * \name For busParams - sync on rising edge only or both rising and falling edge + * (Not supported) + * \warning Obsolete! + * @{ + */ +#define canSLOW_MODE 0x01 ///< Sync on rising and falling edge \warning Obsolete! +/** @} */ + +/** + * \name CAN driver types; these constants are retained for compatibility. + * (Not supported) + * \warning Obsolete! + * @{ + */ +#define canOFF 0 ///< \warning Obsolete! +#define canTRISTATE 1 ///< \warning Obsolete! +#define canPULLUP 2 ///< \warning Obsolete! +#define canPULLDOWN 3 ///< \warning Obsolete! +#define canPUSHPULL 4 ///< This is the usual setting. \warning Obsolete! +#define canINVPULLUP 5 ///< \warning Obsolete! +#define canINVPULLDOWN 6 ///< \warning Obsolete! +#define canINVPUSHPULL 7 ///< \warning Obsolete! +/** @} */ + +/** + * \name These were never implemented. + * (Not supported) + * \warning Obsolete! + * @{ + */ +#define canIOCTL_LOCAL_ECHO_ON 3 ///< \warning Obsolete! +#define canIOCTL_LOCAL_ECHO_OFF 4 ///< \warning Obsolete! + +#define canMSG_STATUS 0x0008 +/** @} */ + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canInstallAction(int handle, long id, int (*fn)()); + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canUninstallAction(int handle, long id); + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canInstallOwnBuffer(int handle, long id, unsigned int len, + void * buf); + +/** + * \warning Obsolete! + */ +canStatus CANLIBAPI canUninstallOwnBuffer(int handle, long id); +#ifdef __cplusplus +} +#endif + +/** @} */ + +#endif diff --git a/Host/Source/LibOpenBLT/port/windows/canif/kvaser/predef.h b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/predef.h new file mode 100644 index 00000000..dad2755a --- /dev/null +++ b/Host/Source/LibOpenBLT/port/windows/canif/kvaser/predef.h @@ -0,0 +1,103 @@ +/* +** Copyright 2007 by KVASER AB, SWEDEN +** WWW: http://www.kvaser.com +** +** This software is furnished under a license and may be used and copied +** only in accordance with the terms of such license. +** +** Description: +** This file removes the differences between BCC and MSC with regards +** to some predefined macros. The other differences remain. Sigh. +** --------------------------------------------------------------------------- +*/ + +#ifndef _PREDEF_H_ +#define _PREDEF_H_ + +// 1) Win16: Borland defines _Windows +// MSC defines _WINDOWS +// We want _WINDOWS (but also _Windows to be sure) +#if defined(_Windows) && !defined(_WINDOWS) +# define _WINDOWS 1 +#endif + +#if defined(_WINDOWS) && !defined(_Windows) +# define _Windows 1 +#endif + + +// 2) Win32: Borland defines _Windows and __WIN32__ and _WIN32 +// MSC defines _WIN32 +// We want __WIN32__ and _WINDOWS and _Windows and _WIN32 +#if defined(_WIN32) || defined(__WIN32__) +# if !defined(__WIN32__) +# define __WIN32__ 1 +# endif +# if !defined(_WINDOWS) +# define _WINDOWS 1 +# endif +# if !defined(_Windows) +# define _Windows 1 +# endif +#endif + + +// 3) DLL: Borland defines __DLL__ +// MSC defines _DLL +// We want __DLL__ +#if defined (_DLL) && !defined(__DLL__) +# define __DLL__ 1 +#endif + + + + +//=========================================================================== +#ifndef USE_CANLIB39_TYPES + // New typedefs for CANLIB 4.0 and beyond, partly to take care about + // the 64 bit ints, partly to alleviate pre3.9 mixing of ints and + // longs. + #if __STDC_VERSION__ >= 199901L + #include + #define KVINT32 int32_t + #define KVINT64 int64_t + #define KVINT32L int32_t + #define KVUINT32 uint32_t + #define KVUINT64 uint64_t + #define KVUINT32L uint32_t + #elif defined(__GNUC__) + #define KVINT32 int + #define KVINT64 long long + #define KVINT32L int + #define KVUINT32 unsigned int + #define KVUINT64 unsigned long long + #define KVUINT32L unsigned int + #else + #define KVINT32 int + #define KVINT64 __int64 + #define KVINT32L int + #define KVUINT32 unsigned int + #define KVUINT64 unsigned __int64 + #define KVUINT32L unsigned int + #endif +#else + // Old typedefs for compability with CANLIB 3.9 and older. + #ifdef __GNUC__ + #define KVINT32 int + #define KVINT64 long long + #define KVINT32L long + #define KVUINT32 unsigned int + #define KVUINT64 unsigned long long + #define KVUINT32L unsigned long + #else + #define KVINT32 int + #define KVINT64 __int64 + #define KVINT32L long + #define KVUINT32 unsigned int + #define KVUINT64 unsigned __int64 + #define KVUINT32L unsigned long + #endif +#endif + +#endif + diff --git a/Host/Source/LibOpenBLT/port/windows/canif/peak/pcanusb.c b/Host/Source/LibOpenBLT/port/windows/canif/peak/pcanusb.c index 2d0fc303..afb84d28 100644 --- a/Host/Source/LibOpenBLT/port/windows/canif/peak/pcanusb.c +++ b/Host/Source/LibOpenBLT/port/windows/canif/peak/pcanusb.c @@ -46,7 +46,7 @@ ****************************************************************************************/ /* Type definitions of the function in the PCAN-Basic API that this CAN interface uses.*/ typedef TPCANStatus (__stdcall * tPCanUsbLibFuncInitialize)(TPCANHandle, TPCANBaudrate, TPCANType, DWORD, WORD); -typedef TPCANStatus (__stdcall * tPCanUsbLibFuncpUninitialize)(TPCANHandle); +typedef TPCANStatus (__stdcall * tPCanUsbLibFuncUninitialize)(TPCANHandle); typedef TPCANStatus (__stdcall * tPCanUsbLibFuncGetStatus)(TPCANHandle); typedef TPCANStatus (__stdcall * tPCanUsbLibFuncSetValue)(TPCANHandle, TPCANParameter, void*, DWORD); typedef TPCANStatus (__stdcall * tPCanUsbLibFuncRead)(TPCANHandle, TPCANMsg*, TPCANTimestamp*); @@ -73,7 +73,7 @@ static void PCanUsbLibUnloadDll(void); static TPCANStatus PCanUsbLibFuncInitialize(TPCANHandle Channel, TPCANBaudrate Btr0Btr1, TPCANType HwType, DWORD IOPort, WORD Interrupt); -static TPCANStatus PCanUsbLibFuncpUninitialize(TPCANHandle Channel); +static TPCANStatus PCanUsbLibFuncUninitialize(TPCANHandle Channel); static TPCANStatus PCanUsbLibFuncGetStatus(TPCANHandle Channel); static TPCANStatus PCanUsbLibFuncSetValue(TPCANHandle Channel, TPCANParameter Parameter, void * Buffer, DWORD BufferLength); @@ -142,7 +142,7 @@ static HINSTANCE pCanUsbDllHandle; static tPCanUsbLibFuncInitialize pCanUsbLibFuncInitializePtr; /** \brief Function pointer to the PCAN-Basic Uninitialize function. */ -static tPCanUsbLibFuncpUninitialize pCanUsbLibFuncpUninitializePtr; +static tPCanUsbLibFuncUninitialize pCanUsbLibFuncUninitializePtr; /** \brief Function pointer to the PCAN-Basic GetStatus function. */ static tPCanUsbLibFuncGetStatus pCanUsbLibFuncGetStatusPtr; @@ -199,7 +199,7 @@ static void PCanUsbInit(tCanSettings const * settings) pCanUsbDllHandle = NULL; /* Reset library function pointers. */ pCanUsbLibFuncInitializePtr = NULL; - pCanUsbLibFuncpUninitializePtr = NULL; + pCanUsbLibFuncUninitializePtr = NULL; pCanUsbLibFuncGetStatusPtr = NULL; pCanUsbLibFuncSetValuePtr = NULL; pCanUsbLibFuncReadPtr = NULL; @@ -329,6 +329,11 @@ static bool PCanUsbConnect(void) assert(baudrateSupported); assert(channelSupported); + /* Invalidate handles. */ + pCanUsbTerminateEvent = NULL; + pCanUsbCanEvent = NULL; + pCanUsbRxThreadHandle = NULL; + /* Only continue with valid settings. */ if ( (baudrateSupported) && (channelSupported) ) { @@ -451,7 +456,7 @@ static bool PCanUsbConnect(void) if (libInitialized) { /* Uninitialize the library. */ - (void)PCanUsbLibFuncpUninitialize(pCanUsbChannelLookup[pCanUsbSettings.channel]); + (void)PCanUsbLibFuncUninitialize(pCanUsbChannelLookup[pCanUsbSettings.channel]); } if (pCanUsbTerminateEvent != NULL) { @@ -487,6 +492,7 @@ static void PCanUsbDisconnect(void) (void)WaitForSingleObject(pCanUsbRxThreadHandle, INFINITE); /* Close the thread handle. */ (void)CloseHandle(pCanUsbRxThreadHandle); + pCanUsbRxThreadHandle = NULL; } /* Close the terminate event handle. */ @@ -502,7 +508,7 @@ static void PCanUsbDisconnect(void) pCanUsbCanEvent = NULL; } /* Disconnect from the CAN interface. */ - (void)PCanUsbLibFuncpUninitialize(pCanUsbChannelLookup[pCanUsbSettings.channel]); + (void)PCanUsbLibFuncUninitialize(pCanUsbChannelLookup[pCanUsbSettings.channel]); } /*** end of PCanUsbDisconnect ***/ @@ -725,7 +731,7 @@ static void PCanUsbLibLoadDll(void) { /* Start out by resetting the API function pointers. */ pCanUsbLibFuncInitializePtr = NULL; - pCanUsbLibFuncpUninitializePtr = NULL; + pCanUsbLibFuncUninitializePtr = NULL; pCanUsbLibFuncGetStatusPtr = NULL; pCanUsbLibFuncSetValuePtr = NULL; pCanUsbLibFuncReadPtr = NULL; @@ -744,7 +750,7 @@ static void PCanUsbLibLoadDll(void) /* Set CAN_Initialize function pointer. */ pCanUsbLibFuncInitializePtr = (tPCanUsbLibFuncInitialize)GetProcAddress(pCanUsbDllHandle, "CAN_Initialize"); /* Set CAN_Uninitialize function pointer. */ - pCanUsbLibFuncpUninitializePtr = (tPCanUsbLibFuncpUninitialize)GetProcAddress(pCanUsbDllHandle, "CAN_Uninitialize"); + pCanUsbLibFuncUninitializePtr = (tPCanUsbLibFuncUninitialize)GetProcAddress(pCanUsbDllHandle, "CAN_Uninitialize"); /* Set CAN_GetStatus function pointer. */ pCanUsbLibFuncGetStatusPtr = (tPCanUsbLibFuncGetStatus)GetProcAddress(pCanUsbDllHandle, "CAN_GetStatus"); /* Set CAN_SetValue function pointer. */ @@ -767,7 +773,7 @@ static void PCanUsbLibUnloadDll(void) { /* Reset the API function pointers. */ pCanUsbLibFuncInitializePtr = NULL; - pCanUsbLibFuncpUninitializePtr = NULL; + pCanUsbLibFuncUninitializePtr = NULL; pCanUsbLibFuncGetStatusPtr = NULL; pCanUsbLibFuncSetValuePtr = NULL; pCanUsbLibFuncReadPtr = NULL; @@ -825,24 +831,24 @@ static TPCANStatus PCanUsbLibFuncInitialize(TPCANHandle Channel, TPCANBaudrate B ** success. ** ****************************************************************************************/ -static TPCANStatus PCanUsbLibFuncpUninitialize(TPCANHandle Channel) +static TPCANStatus PCanUsbLibFuncUninitialize(TPCANHandle Channel) { /* set result to error. */ TPCANStatus result = PCAN_ERROR_INITIALIZE; /* Check function pointer and library handle. */ - assert(pCanUsbLibFuncpUninitializePtr != NULL); + assert(pCanUsbLibFuncUninitializePtr != NULL); assert(pCanUsbDllHandle != NULL); /* Only continue with valid function pointer and library handle. */ - if ((pCanUsbLibFuncpUninitializePtr != NULL) && (pCanUsbDllHandle != NULL)) /*lint !e774 */ + if ((pCanUsbLibFuncUninitializePtr != NULL) && (pCanUsbDllHandle != NULL)) /*lint !e774 */ { /* Call library function. */ - result = pCanUsbLibFuncpUninitializePtr(Channel); + result = pCanUsbLibFuncUninitializePtr(Channel); } /* Give the result back to the caller. */ return result; -} /*** end of PCanUsbLibFuncpUninitialize ***/ +} /*** end of PCanUsbLibFuncUninitialize ***/ /************************************************************************************//** diff --git a/Host/libopenblt.dll b/Host/libopenblt.dll index 24447d90164a8f9bd49b6021461bb5c47364a060..c93732f569f6482098337310cf41b2a99b8f212f 100644 GIT binary patch delta 33768 zcmeIbdt6l2*FSz{1VsZG6%-W}6%_Atzt4adOidI~6jKYY9f=fmFfw&eP@$0|kBXKh zgcX*RhIuJ9G7~i`G&3tcMP@Yy7JcGlSmgZPYoD26hV1EizQ5n|{p*LXy=R}j*IsMw zwbx#I?aMjlbBJtTc3@q$q@ zFkCO;P6TjVgG9=i2}p+DfT#L)367F-%>a(-D&h1`_3hcUXt0EfCkXGK6t$k}+e4_8 z1l@D{4zdY1ClP*?^y?r4$>DekkO+OG-8)V@h;%&i_TpD5jFt9j&q+Cs_`4!3k@iu5 zEY}uK*F;v4Vt?_dHGKKPjHUBA?wKyg0#{rZew`I3rQ;-at%l=njO>YMs1ebT-iX#4 z5cN8a=&Bykdz9BZ5Ya9zBDD&U>s>_Yvk-0XizxmCA_vvDr9?EB9)k(rLy?I7Jq^*n zh(S2g3h<_F1y04LJZMQx2rS~{4_5KHPPs>d8&fnjw*xPQIq~pL-lqu#teyXB> zdzqwTdr01sH|JepWQVsTU4`ZjlO^3MCf+kPP}L zA&%`r@$4?mh-ZeW5kJY|;oT_R6!wYq;+w*U;kW*#I8v~8qq4i9>`|fVUK(IO`>lj2 z@tMF2l*(Nb#AWq%G^Qu;&|VpzjmQp!J&79pGytHQqf@f;eU#aAPX}$N%nEkqeD89V5i@mt`2_@% z5abA&;(VUyF^~?3*(ycxq#0GG~dvQZo_`m6Txgf9F4%18l5d}XlR2X}vGFL32X-RPJS;JO6VD*#ay z=n?G$pfPv9VCfShN;|8sqmh4#gmIM6%SZd8@9Kj-+WFjfzUYG(`o>o{ENNa94+B8uOB6W1V{IXI^=%K)+-E1Esi4PKw<7vHYI@`~AoOqu;oWe~*3%Krgx2U7 z73``;%T@u-tt!;4hwU8p_!ODli)&cyL*nfxk$`35i^-%T1mi% znb;O)dZ8avf|5%aN8@C!i()@IU-n4DErrjJ;g&)x2IhI%$hx487}yEgyez?=fgQl$ zkw(832D-IKBaBI7No&$`UKU374Nqo0&u9d|M)7)}=MS`^(a(oQPqZvCXo?&Cs0dfJ z*t9$QprR1-t$o7M!e4}G{{Zpu>j8I=}AUpT!5!1522DDm9m!@mD>Kj zI$Wj(+M-I)>UPm%N4{9=av2hWmXji#rG88T1N_-mT-<&U^XB6s=!!+T77@uDM+mSy z8Lb@=F&>qQ5c$eTK&9L@&0LnWPFnY-BcT~h4uV`Ce^K}~ddT!js-vIaU&p}e$T-&L z{~>HnxoglGwMX2}J%TMpEj|5$@N&$UfwfdM^*(zjC>9osuNy^?xC8I-nrI>6|V+H()|H9(efLR>+p_6w z^=xF+bzt^j)8MIny$vcTVa-fw_UoP%CBh$rdrPO5u#qJnVzD<6VLqv)bwv2bJz{q} zN7!QB*^3lk}}^TM$G(#GAws^O90bFM(c znA-Bn49hH%6s5a@-j4l&u`TV-EKiQ zVwm*l-NK>~v!yRTBb**FM6yX}7}2fUS%QyG_HT94GeU29k0A9kAcNUfkVp5@@3`z9 zfigTR>lDdB<5z^FQ(%|XBO7+mC z0wQ1N zIXi?-n)C#2Cd$HE(X81{G{ZPd7YShn2{n$y8u&T|;kD>k2Ofh8LTZq#N@%1X=PsdA z(@%b#3RA8+Mg^2PDVcZ`L!%(Pp3(_d9pi!vLK-|Eva-f+h0a>-%qHXj4b^ozK61GV z5*i8jz|(ZHtnb|eN*AqU0z+Xca)>m@xc2rugfTDkjC>v$`HZgkgT z<0~4>^4SDdkH{DKgMtvM?u!B&S z5d8jDVDV21!!6w+8qTl*y9j!-2!qS5FP)wg=2+C$N~)-y?~ngXp~xu1KacPy0fIl> z3T#iI@Uf*^*Un%V27%Pli+y<^L=h&)tihdM2YInf9Ms2B#ae+T4SKtwOyJ0tR!UKY@X$AKBX5k&{5b65&gv@4 zUz{fiXHE*h8WH(wz|RhbbMI+3M#~%(YD;DC{XXPta=^_F*I><4{Y#I-ssz6o-3rW?a!}Eps z(ftOA@Lj#|zz_JwO|886Z!wi(txz($ZB%Ot!K}ss)F8a&n}jo?V<)DfVf=+wty>Hj zroV7VJcd>zEUpA;-cM*vS-nXxj)}I`62fWe{^Gj5(MQkVTw{g?1b@91*rkoa?lHal z5#x?gSoMk9AZ4iRw^G@jne z?w236Ya2lAw2(A5P!b_bA3NH9Gy}-gkNDF(nMW-o=d1&42>iG-0FVK7g|GJdO1l8$ z_EkdjuF(|e_ULV1M{*@VuzHt}&)k&62awhVK_0H~90n6?n$hS?2GEAe(7Y!Y3Vs1d zxq%jVX$@zzYSyi(Asj2Db%D;FkPDoNGwTQ;+_Uc`vci<>$%P3GNvJL?y*HvW<&lHx#+mdg_dp%#sh>ZTk=<-9!CwYP_Kh5 zi7%aVzVxJLO_1Aw+m1u1@^{=)6q}oAC zQTqZ=_*#(2^+NLanf8bqB6rSZta4E3;pz>SvI1x`CiHLu+F_f)6O8jJbPP5!i9Mxr z>FA3eklnW(WrsogLJudpup<;pO-2cy2dd)QFWapJjn1j-ND0=opce*D=rQv3w`lsS z4b3HP9VxZR&M4%7n6DfRG|io*mTX4k+mahO!iEX6b&Q<>ZClt$aiJyBy2&1f#$xQXXm2ri*}(x7gsD?r!Qs;S|R3p11U zN|&w@TuBLIuM$Xft7djt#X&6-BQ~5{JCK$e%prReA`$hA+q>d)SB-e5QAhJ(GMg?Upa4Y%E;O8KMyR6JGAKQ4SVwYPosU8>Cfn<{IeLg*2%jm|@VIX}j^ z4YSb^7)bq4vt`+~8Rd;I%doH9PU_o**`pq_Eu3mw&K3PShm(aoz;%`le1MaUL`X$g zim*{AoTlhj4z~C_M82}zwNm(Wnj+e(@N+;K)>)j+T;a351!GnUgHv?Udsd3>R#Nv6 zsUV*@$QqOltl5ZsvEEsRR$(H((MP+ zmg0(K%rlbRKiC?9dVGGX%DsGPyiPRA2`pljKaE?NLiYV*!+KzoC9%2goahM?{@t0v zrTaDWVgb+ZY*i^KQ{$71K>-WBpEZANn3PlURCosc>=Dz?ntYAdvSV59|doCxx-mi7Xor z4*09B*ch{vxOLmf&IHy(VEk%-ZhI{i*3F3(9-FP48(dCvOi^#nVQMvbqVUk+0t7jvWfM`=F(IHJB#9EE zg36}h*Y22rU7=LUNtP9a&qgBGLXRSa=ZQipkn`28D9DL|2+2+tLZ~VZR2V9$=RBnY zpsE6?2#DB{qba@R01FG?IXM4oA$OF>$#Ot0ACYhWoI*7Zx&BTy`q3eB?L7i40Yp_G z!{sLRWI8RHl3LJzLg>#D`uKJJ=*PC856#;JFy|peG>}@zh)02u=|b{cQw;Tz1jiMh zg&q#4G(4kjrL65(#)*rp3oj_`c3wStfp`ktc#Tq>#Ok4WpW-R>Fvf~-XTDWBzfQ0&=+T7+3H9Ti${i?FNa&Hk1$DxI7Tz~u zD6o=6p-ngX!^oLVxLKDviJ90z1%mvc;U@n% z!KZomkegIV81?!77{8n^3PRZR(3nn4DaG9YS~cg)7k+x^K{Z(}NnJa)34067aSxwr z^Tg)B`afN+{1CEePlQvPj}DT^(2d|~9Y0)(wjSh%*hwPDBnXQOl~)24J-9-TgizVK z+box+7U%%OwBeHN9wsad#7bIh{ecCld(z3vf~BsR>uaf>LvOA-9f3w-@bsN0ina)k z+~zE@69CWAYHPj@YDZN)%w%GFb0!t%-WkXhcLo0zfK$$d0xUqQI05ZW-3bzx| zMu% z{mzscs!o}>Y2w!2%2jCF^Rs>1wg4LC)q@{UL~V0#wwwjHr*%If?P*=D@amG0f3Lpn z;Q8}csdY)4{abe*@UuP{w6tGL@;|rk&MYBwsbPG;YOwvlEMK;xps`-I%TVOQb}+y_ zY!64;!*=v)q2t571zBeAzbG*_RzgTrxi_SyckQ9f+QT-8VkEWJP@9U-96qSfzfHg1 z&lbHw;-c4WMD+w-4oE)gNq_Lu0MDK6qu(Y1jRzEev=!*nZp?0Oa(|SX&WCQ1z<$7> z5x2~sg>L%Ut?6)!Xb(^*c_>`yy)0t@3HYDv!^xRKPWsq!NoyhDPBVQa{0TJCtMt=R z)M6k~0qqg+Dx^IE&Rh!tV?)Jvap249N|Iz2wYQ1do4LhbG>20m8jpckNnmFI!N(W* zgKYtrFV@ga*S&-O3#0;=hDlbinSA7mSS5)nKk-*bW9X4^lF2_Af=^}$&#XuotIvT< z2F~!6$qgu)S0))KBAH+;bMb)nNMs(;9*LypKq5Vacw6sIeo|p9F10O-A@BJghWO&? zY>4;IiXFRm9auV!%Z{lyG8LCRYoR3GfgqVKvczoDegJ!T`Uq(cPp2!M$~qJ%i4w*> zuCixOG$>fyWK{rHc|L< z?GS0vHDRzl%F6A4u(J{Q3OfX~yl!YD8poFqSVXZu*!TAd`S!tm*XGgb|Je=aLN_P? zOY3PzI4KZ1f(cys#6GEO9iYwx<{_JN{+#P_F<}P?x}4s_R}z9FDY7=Fa3jLWYNYju{Jxd*%3c%~o4;r2ekVeM}x^=^Y znNB4%W5UX*6PB&(6|olR#Wi_8s6tPlm=cgr9KX0u-h()nQD&j`L883uX*4e%k?)|{ zlfZmnTH%p}q{ShBmH^|Q@dsQ9KzBPr^Kt=3%UYZWJ?;o6mI_kp*R84Nz`&!u+zBCe zV{$vRYK zh1|A%p|8wxV>pi_>=CUQRxzl`KC6wDC;~TBx54icTJ^lo~jbmu(g7Z>l<Z5zYat-rMuB!S zlN^b5+={v~nh?_kQn3xrZudZ|mUqNnqi7js5Hn;M#61(|4=8f34?!&pwV7iEf>M44 zqAzMy1yc6E5bi4d!1^SrkH4xwukQLqxeG|%2g%Mh8TY65SuHdPAW*K&0SL)6uJpU3B6hC ziY`ohmcxy{rr)5&H}V*GQxqmFI4^bLOR9zwx z&6F5}1QxWeIujCD(z@!DNN}29LdjGS7X|)`G6X;XcGY1&<_@j;JrFf{KV+Ce+Dd=YrSng4d`-P1v3geBKPG3PlTrxR@3uyjmV zPAE|Q6h}$}&gJMhuL-*g1Zq!qwuOr1o{oek0mi+j_TAG193ccT#rXmQz*{sP074s@ zHy6#ywJ==>&6|b?I@C|+N~uzkGb)s@l1J&r$`1E?rQ?UY zn}K-^wY!NJMO-%2x{U00tlDLXFj(8mp7K3*i+%vhO0dYtufw|!u0D_zjS5s$igOZBB41T1cUDx4(=-vbOCn^O31)X+QrH4N3bL0BRqxhG(s7|euRq%v~%qF zV>`$e#k zSW|a%*u__zQW_oJ9Mr6-|mD zo{-qxo7V-@`<3W;KI3`+-v19sh`qlJm>eM_%EGV@sez8hWF~hE!_Dl<0v)}-5BM_b zja+fE7q=q_eGxG8<}yF@6P-H(H|#}m&q6-+zR zOz)TYdI*z&Mz|OrCVV%mOUrg$DOt3FgnCB^jVUPQnS>v3l$7!V%|}v*iN0n{(G}=4^pCE}*?$)jxrU!j#ic%A-kziPclwXE3E$Kyx-z=OU)gMUIprw>m3x*KFf#gB=OmaWa{$K=-Rn01oNH91SPU{WZ#Pp(egR+{A(V%iB|^lT0=P0- za)ID#Di5b}Ofl|q4VBYE%+YA)ivUnc)Z9P4lbS6$H51d>D09M)93b(tL z#Z|~@Sr)f!A|^D83^EJD7~D-{qxOMpH6mZKxr{86G=qGWLB0&g3y6FnXEI2_spM?^ zJsi?k0^Dyu!|@h5m3ujLGumf_@bR-zZn4qu6}KPWCt5+TfYwn&zO+6W?%#oD803CH z9zx^`xsO3IoHm_@so}&_6c&Y%aK|Dr-Gm`6v*SU0)eNq`$Y};@i!ya{Itv+Yk-Ghl zzlxO^X(p`e#8v~bRr0DoTU}Z;;5$Gj^W19y-H*t(1viFKTN%>75i6BJ0V)CL$L#CF ze8fs-O%$sH-W2a7QafMwCpDjuYUyk#K{f%1-+RCx(!d}YPTLTVSo@J!nJ9fE8DST> z3u?{XZ$rJJgd6u)F_M`T8IC44YQX_tbkLuT3gB>4X9ABQ$g2S2@#d^sigxkFMF9h4 zNdJLjf`K?wQNd4~_x=OJWcNjeEyPA8IN&oYaF*uVn{8TgY$ed66#!ju$iuP7@aIFQ zZ49Zck4MB^NyKzbl=8vkAprR?S%wTB1%;AsT^}gK>q6b5i)J5@$p?vY35fDZZ~9Z7 z$|$#}K^j5s1Q0*wus`G=2FY;RMtFD}Ks-iZM1?^Oa9dCu{=Jf1;RFb#8wa;y`rEg2GX$!#O+xHs@G7~_2uPEZ^sh<4Ch_6 zkn+LNWdIcWL4ldXF8-XkIrPL0+#@T&2@I}PlV`LfXJ|80ir_30z`uy3lIsPV*%PK;brfGz#&Aw1a9{u zv~-;4Jrx)*5H#<0D)3=HPPn$E^SA~=wC#*PqB0=zKM24%K>YwhC7uHi)6PFTc#i;< z_k+TP2}wnP_J@K2W+4D^pp@Bew{ zzP@ThzG0Q{eUUz#q*{S1ZxO`+tekq=Zt2K<65e?c6M zq7%V{Ke2^E=ZF)qw&L>v!w)^{4_FAms=&Y3QK9eFA)(a8p+^Ez_TxH3lJm4MYiplr z_am>>&Zq>q$_Q1ig(39pc(T1%+D)A$)?vG(?%mW6`=HKlR%iE3;iIknS`mvETw5dK zn6ifE^`<3aIO$jaaLQW8Hkk`joTc>iTlGCmzunty*Bv30+dqWADcmpUScU!~0O#J~ z&bTSOD2#Vg3{IftO>s^U?g)ddVv{|2-9t!)e72uilLlf_nOIM6Q|b@?g|Kj2AA8ct zRy)GCd!el*sDOi8#Qrfq%3p!J zxT{PMXdLY-!yKPs`HpbPZE45>Ybd1wcQEz>u);&WrgvWivDXMn7j0gAF=LZoDi z5FccK9?`V!gr~5ti%y_nsRba;<7V%O9CY{HWSJC$EeYd{Z}bc{p>#)STpH-LjG~FG zTj_Ia_p{3`A!HIT&|7wKQ!dkHV9I4j!etZY6JcGkMcQ~=s4R}{*nGU@Hc8M4;Z||~ z4kC6^SfT&U30>wA6S8w);t(QcY=xYi-Rxw8e6}!&DEgpf3-iz#VP`v-l<@9gvIh-oUx?2ZCYscLmnPgR#8MJI+pyeuQ+Q-o zw3L$y!Y;p-RqlFJnt4+&JRK=T?HNx`lGeNmbdHK>r%R0ZaEQ+J7<$Ao}zCx9Fwln14BZ(Mxgc!PUS5dU$0O(H3Q|x zQC>>L=uda`%~VWnL-7SSdfZHC!Jk0@E{~gX)cL{J!Wz zsGMZRwp#Fjtqwuh-DT1L7k%KC9~<=UX1lj}@?jWp+wrCl{Oq6y87Zd4!`N#70{Y_s zB47VQg$lksH=H1w2y*v_{*dh%B*RH-0?^p@Y+vc>o5GQ2t#+nQjMO+nP>s5L_DB8* zR)qPJ8c&dC0mNr~><>AfK{A}SC{JU%(Y05$lA{8c$NqqFujB;Va|%1tWX8jM!dwER z{J3g=%b%B*Tf1O^L<>7g@nWaB}Doyi$!z zu_FBk#f6@rE>+l>#bTIi2y;1*@=2fhV{X%mhkp@d34r)9SN$PBhvm$*Fr0pUfn%kX z4IFo05R|FndTE!ys6$9%q64%1Q6#aV7w7gh_s|vOLpOzPFGa1uEbWCTS6kg!Cbc8hT@W_Z-gHE26T)? z4u2exI2ljcH=&EzvY&!rB?(!skD=>bN5oLF9ga!3y!k13@B^fUZE;irA+ z9=M4j+I%XH?cfTy_F_o{w2laF}q@DVdaXUODL`wnh;$v zc1?KDuH^+gvfE zORkt{Ts!(n<)jt&96TZkuYnY~tUltpkZ!}A39Pv(eD;Q1gEMkh%uW{5Wj9w$5sS(3 zbj9Q&7S{-DmEa2B3+!dh4T8C%hZH}l6=UqRKVd+H)KDCLmEvBPDb`d|Y`K7V(dO_b z_7hUietMl{KY^#&PfR8I8Fm~$ySD^3;Kz}`m0f4Q_$D5H3loCM8tHjM4eqv81d`n{{6pM6fUCsCKcuiAg{C#QQ^&CL#65hGt6JZP9JqhnQI>NSt5$Mz z3#NrMv7C2nahqTp(yZbC+%9M;{os{&N>IU5jW>lwhlkjkkYD!&n8xPM7GPmJ-L4pX=@QCEpG|Vb z&^MS|G4!n(R}6h@$rVE%>~O_ou$X5teLKk&lg48DP6ZU7#nV{a1f3O?*c3vYohAMC zy&KCw?ZO0CObI|d8qRcl3SS2G;ID(FbSa;Mv@1LeK-gsvT`8FP-82fu`~rmxp|~JK z{flt_k=~*4Kf_|i(WHGkfY13^*mOkKnF9c~Hnfy}@t$)T_lr<{L@AB>MF==LAVyB5 zw&3(W&X;MI3-30JhI%8D^p_6{hy4obEKEMyP16ZUP6j!B%kT$@V5G{qYp&w{psMm% z6zXk~|*9+zSWsR%B#c`IJYm=5yPDx=a;ikSRGAwUKY z!UYn-xwp`mthbUQbP!hwx?@2pl_uq$ZkRfK25y-NU%xdVd_S}RpRyzwvrF^gxJ2`d z(Bti>uIP2V8Q^ow0nTcpgrv704r4`NTb4{$QOT=A!N+f_{;p2M@d?uX*MtSf`~QWR z`e-*ZdybEy>07UMX@H6m5s+<_i zfuA@UHr&eU2iFrtxlJ=dH~fs&PM_{m8k$#wEPf}zr;967$60(9?-wEEWNa+q$b!N~ z^V|UR4?h&~bY6{^ABU)LLnSWh@I?cJ7f$vY#vsZm8&`DQMf)k!IRpv{O)AU_BzVXS z=o?QClf(%9-Z4k-L_avfHpu!yA8)&C!;_PyxbOwdBj^|mH|%kRNB0%hzZ2WC6+wn> z1Ko5kEx9JV^UfGaUm>7Uj#yJU3P`gnX9t0Es1NAWR6amXpZVP>B)cu|Y9-OanRojD z`1^Mil-2#zy~vt-suw-voazY#yH5>7eEJk|`0rEt;Fdj*z1IZodlpo-y+`z3cyE+s zfZ%*@(1;)?qxTj63l~a*{h#51g6Z6*fJfUq0yfkS5aLfq+o=xr)eAx>Q58s4&=unK z4OCz_SUHtc1rn5RIqlv59`I-vN5FO_!o=W$V3wNmUhY|PdtEWj=yq2OhtUHkgvCKD z4yL$kjEp^yU4s|GVps>^_UR}8qJyWaMP04f^Zug}I}KLO);`xlLy*hT=2}=zmM6y+ z%^w&D9kIo-P3QzZhZ4BOCI=B*I>RT4vm_VXwQK>Z%DRc^iF^$MN)Jena)qlIAikc< zzM$%BYs1I<(iX-x9LDyUs-b^nwB9qqtGY8jy+-AF?waeatj-W96vNE$2i(YqK+}Vq z1>z>I=fk$3;W242cGsDu@#3j1OsvICI{L;Q4S%v?NzOEeAeepa_d4*ixuFxGp>Mdk zpTTne*|qaYnnCs!I=0lD;o&lVyGwz6IThS;DfGgH=_h$PT5-m5K#7a0VMUI%xW!GkQqKgeyF+=)Z$99o_<%pEV(_t? z_OBHvk5z!H%M=b@niA%o?;@4`BCI?=yq&BDpRmGkedTS z{XS~WnLsL#ID^19?%Ho~g8k|IxIyIomy_5un<0x%AB5A;j{P8xeinZaHE=Khu3(Lo z;x&v}<9Pbt2k_AXSd}E2XJ!NTzz6qhyj)Cm^a3{746lJDGM_k_Hn_5ew%`e!F@w(; zB*a~a8Vq25H-Kiit`uyj!CM#*+ys8VC&ww~==sV)LcxW|2;}pylR2*KZrC0(;B$bB z6Bl%n!NPwoL=pSlK3p^pkOg^(ji_H5E2ilkkJ6!Hx|z~)G0nl;ma4^c0HyU}I*8I{ zF&#|lcrh(QdQs_^LBiJ`vK36gM_Oh)KT7Qhnc=e+kWPC0B&P~n5Lib+grD+b1`Dr$ z^k^hni^q1V%30JiuB=E`R)j07QWWHu#ZW8cKsm8s%8CRJWs zE&hj1XM`fWx|H-B(zsimgInDw#^E9U(kg)TP3#&Vl;CtK^KCG20>3AO zmwzALmR4-?pMK5=f-q@uP$x-5$INd;d1~=H<(uN+og`g@Zz0|O znwVcK?<5IpTaKrj-|8%xKL^PUMhVvkL4%NlkcN5R zOhQ79NJ z4Bh;B9}nI}1BaWx|8|$RLLY+gu@7z z5Pn3E21>ae2(buegmDPd5YiAb5poc=B0P<-92>;*5RwqaAm|Yy5u^z9K~nBYkaQ?_ z9EleZiV)T!EJ2u!FcHCw5QPwokl$V^T$Co-ZEcZ8C`UMna225eLE28r$q;%Y3`Vdb zOh8CQNJB_RSdH)m!cK(e5zZjgBGe-^BcuaQ8p1S$2?+5BT7;np{SYGBg5i!xv_-gs z7B(XMh)|1g1>qxv(+Ecq*0yB~4;(5br$+pH8TlM1<)YiP z#*xSp$*`cnPEu}-1YSfx$&t)`lH&oAqs7BslWeyiv7WGgVZA3#7S}ayXq+Z)Lfmt4 zWpVrB-ibRK_jw#A7yr}FVRDW9Nx2~3C9jYlmp969%U$wGim8g3iY&z{MUJAkvcGbW zaRVMib+Ed#+Ne%aFH)DO%hj)`&#OOHf2#gd9jWQ78K}8elc8B= z*F35@rTI+rwPvJttahSyk#>dlRqdPF_PRd0XLZl(%5|r8=X4+Ie${dM-wmG|hnSK~ zDW+K_o!M+2Wq!?EVLoQ&;_+4(bZoEulKeCIzvRtwiK3liuwsNlqj*JeKyg@cRq?Ij zM@464FEFW5#w)Xxc4e9Jw6a=he@eAOwOb`ow*|Mc>S1b?`k?x-`ndY4`d{jA)pIqA zz~wKRTbgFgTriiRy`ycTYp;vZ4c5tZ6LnK`Gj!kRzSq_3g7hK!F8ZhRJM_EtQHB`9 z5W~HOiH2muyM{A{3kIj*rr}q^LE~ZLapP6vzl`4+mzh?YR-1O(P0yOjOg~#2t-o7C z;=083jT;*`DQ;fe*0`tRuEc#6hh`-qz}f39?=K%DALs6dH|1~1E9F1Rt%}i#@rs3t zbVa7(X+@s$obn^(W#!Mx+sa6lQ5CP6sd_-QK=p*GNcF7hh{~yQsiM?F)q3?V^>gaI z>I-W76}3zguIZ_HSd*z)srgdl(u8QcYUNsuHctDTwoJQE+etS}r_`Bs1-c!&1G+bL z@96sJ2kM9E$LlBQr|C2GS^CHI#c1{O`oX3VCXH#XX|w5lQ?xnOJk%^VtIc|JRlIqO zd7OE<`BC#4v(56D#cnCHlv`f2{A{;0S~^-|t)r|nt(n$M)>o}>SdUt7T7R=Hh+7g@ z8}}ngAWf9OP`Osl%k$;iIvfOgQa?WzeGQg^_8m;lxBC zQEWr+pHy5>1YjU;RTe9sRUTD7i9X-2I*5L+QiZ73s5h#2tDna}d|myuI#|<16QzmO z*iD+Tnpv8Bh^<8PmF6b&T%v8K?WTP~yGMIV8x1Wt>(=VFVko|(dlf_RBi&`)bqvQQ z-5p&Q{Sf^^{VIJ=!#Kk|^!>fkl(D*9DX9ky{i*dQ}G2hY5upl$sA(oW070l zvV07|O|zz1Gpw&!Pg*ZpuUKoWP1ZlHZQ{b>M#L?R+ZFdh+*@&64#$;4Rb+BA#>q5{ zlxO8KMYQ5^MY-aTqEcbg?bB80PUxz17j<8{n_%yykI@g;YxQyZd-b#QY5GO_t@?xd z!}{a;AM`i%|Iy#k-@wT2X&h#p2yJ-WxWTyDxZC)m@qqCywCf{ds%e$UZrWffHN9xs zZ~6_|F~hvqe9-JPcd`tzOtYj}wp;dC&RQ;8+FCnWugBdXg)ZW_Y;dlI zYcFfR(mJ*O);4R~>g*kKGF=Z{v~IX=jBdPcvTliPrOvL~q$|?xg}7dapnli6bb)#~ zWRtF6reCMupm*rE>-XsQ=_??mD*Z?LukG?X!;N2)X_Z5JkbtuJz&lE^lh$&p8j~6y_Y%faO&nLkaYNyVgvfiyUY#1s4uBMQ-7uYQT>bhH}xHL2TdnUH%)KN zV2whf)mSv+HA$N3nmL-q%xtgG6ljVx+cmp2<(k)F{f=wSYQEPrXnxlOXgg{nwEeV0 zwOVbwc7k@A_5m%gU9MfN&D9n`AMEc#A*!{t+Ml(J+TXPubX|14bt$?9Fp^852T$q* z-7e_C8yGhK(FN$+>qGT@FkV!81MGh?M*j=?L;7R-ck~}a3%=Fg(BIZe4TB5|4K~AL z2D@PkY(kk~pW&F{l;KlDxG~x|$T-3nXPji5YMg0YY+P6-UN(Mi{Mz`l@s6>L zslBPYsh`PW$};7d3ScJom|ingn2wpwnJ$^WF~wj)F_`1blc6>9&5O;Cnb(_3&EJ_D z&9|X3p_bm3{+2-&gJqOuq2&e3AjQIQjT;>|K5ix^;bk;d4{%%t#_BZH5>>WpJ%-p0Rf+0l)gjeM z)mhagRgLO9hUS>&oTj6;FUIOc?GV(6)P=(j8l<~lH&2(Z+omhg zy{J2`I|~#118?qZ-LQnG6z8P3d?%SCQBiP=3&fv7cl32 zWBDF~v)K{|``6Rj*Q&tKT#nhV#Cpd1k==T4+`_mwG1Jw@HIcY0aaaj)2f!-I+%!w_vGj0SK#e^3oq!F{7<=5(Vkh%eu_cx`^<__ z@QYFu_#XolyuyY#V4Wf#v*cmS1LqZ&6<@)U{#((ku(wr)D0?Uql+%!qrsk=ZtKP)OKBxLv^|k6J)vv1Cs`l`5`>7YI zZR*D`khj3GDpT)MA5)*gG#jpo)(p~&(8OsbX{KssVz@5XJfV4Cb6N8_T;88GckG%r z+V!%rWMB%~Q-X%@3M4xo64)=C{r7 zntyO>zRc3o(icGJh(td7gi$}h{?DrAaom_U~)Rw`C2b}F7#lqo(|T!9sg zP(~}4DOW02D|f=xC{uo{yrTRazJD}q;Z9h<64hQ+xoVu|5vcdm@GM@`?1zdU)tuCv z)|}T=Yp!T&G}kmv%};hsBdiowoZ4V*XIQFBy6<#d^^y91`dFA5wLSsby-2?wdVN%X zQh!>1UVl-4RsXgAdrZ!a`akq-4EGqi82T7u4Z{p7X#Ks0nTCfAYYZC==MB|{D~1|q zz0>fs;g;b~LjW|tv$4CeFN~1FXf}>C-fOf^G0rk(8ncWqV@48R9py*soHeKRAahka+-cJHJW}maptz@uzqGE zI!yEpd2_ybJI2QqxHX+EM$2SNs%4HP%d*OnZ`ozHlv?&#-nV>cxnlX+5^B|1CtIh( zK4n@@S--K?TW?#rxb|3_CCANyL3$`IBW`(IE>;F##@(dRQY-p})PdvSL7c~U=%g5+ zSgzQict-K6qCufmnv{u9<{z;lh)~6-R8Zt;s#&V}Fl5E>5A9{>rwY{-*s(g5R4rF8 zQD>=()NiRjRCm^l)@;;#tNBqg0S@$K%nt)FClu;l)?LD4%%~ruUk?x9mcFk+VVDGa zzs8Vj*k*VZ_Wq>dtXK3u!Q}jI;EZjJJB-g5Up1aF4ls|vnqZ`Pym^v&h8-Hc#Jn0J z+G&24c>q^1|KBtRSwb!S;69JDBw1!)-Y28-6z2S{Fd)ONT5AFv=tb6**7Md+t#$AP zJHvPniyH;QJqL6BlDNFMLvhFAzKHvd9Igg&5!+cFA@7Za>`M7gtRPOvdq7fl73TLu z#S+B|#Rf$&+{E*WHqhoujXS5eEXs^P-x~~0E+W-%`Su52A={oAd;AKVW2Iz)jEv464;cZRO tCF!R3)Xj!%=izqY+7CMn2v*6|7xdM7E~^68ccR%`w7bnT4ayqBl{O2P_{xgj#$`oKe8X7#k+&i*L8OklbBfg7Mi)6 zxCU7^p?T7V?2r`MaRT|Agy=>MPj^FBMfe91M|Tb&E26B4@V6ncpGZSCg!FNeZXY0# z+V?>A3x@P=EwanvuVi%Bjgp;ho{rl63df~CI6J#SZmIKp^GeD7HjhZ!cR56rV%@`s zO8T~yOWObPa&ukEL19?CGD&Npsog|Lo09SOjSQFmT2!)2epe!m+9$X=8qikS(TcpG zqXv0mC(37bYC=9ET8sQimJjVh<;Lg_r0?t%-dFte7tOJPs|&UL8Om-Yx~@fGE_sQB ztck7J4Kdl65+@3 z`v^Wp6$(Ec@a|+;wvmg7 z(*T*h1f%yR3bW2(eAC=@(}HoY<73poU5G4L2f0DG`+9nSDX(8qh8|2i1GjG?dH$#Hqf-fhX=7irLN zg&l^0%6n*Vf6Zhea}Ab?*3Z}FM_wWdB z6(m~#dl|MxN0KLyY2$K+hj-L8D_3jqZ>vMK;NYet3+xN)+uo zOd_P_JGctv$>l;}cxT~gpEj}>DEUHoY>9BDkD^oOFTLIi;Zy~IIDmijl( z_3b&U5Hxt1F_chSKOwcB&;TEy^pm?MnxXqqg^Zs=!`3Z z)Q0$x!*14iy{2T@qhv}KX(WwcfIr%Ti>^TEIV^&%UX*PUk<4;O0?XU+`ujN(I;}$% z?BFE@q@yM-Q+iK&?@f1d6AViRz5cC0=$kNT+Cl0QXAbQ%gY}VfY}Efn{3rpzA8Y}p zW?&KA8guqWNTcy<>6HSGRu>53?XNz#9-`Fmxz{6i`f$S-_aDV@7X*;)Yyno;JOe;}2 zAi$A&zwY0sOQIFM_8|*a%)V_x&%_?qYcv~B2wk@go(7X?oa|NX3e?U+EmPkXGEvbg zeHt9KO<0>a*j`1*N83V?hp}!x4bobPPX`2F)dK9ZeBq149x#EJEbXqn9QBll>HbcLc;es;VT3xUgl`V z*Ow+ki`XH1J=|%NIFj;IU~o^8P4*nk7xoS4(~Bt}Ga48#45!5(X2Ygps=RkUGr}(h zsHKPU1jWF?+9crTPX-Yo8jJFXX&IQljm|y;j>@@4n8=7T2O61Y+-t|;LFvFLy#oRr z+RDUCYYG`2VXH7`P*3UVt<1AB2H9NIL^w66Svn%z4xPzH*OC&JU|Gel0tD}A0ru4v zKYwqKRiZ=G7FyBlI#177pNMmz_7l#ax zHoB!X&TWJ`YTy0(oF#_Qpohh%$(BI*{;H zEinDESvaqZmwvFhB<_iFNl9wguO&jEHd@+{EF91dUa1_3KIO=Q-SESWqNbhk(6_`% z%e8g9Y!o1~kOe~?W{|L++)ZqBBE-eoCO&C2ppPR9hTgbQ7^YjA?4h=%+koJ;xuX1@;_77$stKYw$@!;`TydZVv!zy-)mcTp$GbIYA=uuK6ExhKW8I?txZg(O3C+j>yN-Q358SqAOEj4@En4P?P;>kI}c zFt6$9PKlUAOB7H4_l18LdPr*@6FxEYw|l79{uYCH;4!fm^RIX?%V&%wHw4Ev-D$gv}O%G;FOv)Ex=w_BlNO%mlj+UVjVptYuGrhvi2S*n*`tu$bx0;%y5R7>01{_ z@rv3^QG=wt))(0bUdt4|wQB5zgeYusD59+ZCwpg>JDO&OI6&~bT7YF_3bSopV&X0^ zhg}4_Sp?_u*^4SuD6nbm2dQK1lu-P4oI&{K5q={e_#-XA&Nv0HtxMAoz+F zU{_ZQ-`fXC-#E|wDSI^=hg3&zdksNPO$$Y;4@UYnA>|Qk`CBalZj^}hMg>E9?$Hu9 zKNN;1NQ9c@B=;?@FC0iRx6oKsvc+^ z*OEd6>ru5r#Cvgt@Y4f{3Y zi-genV5qvf`VcZhehHHC>44xbw*dRE<-+9=J^K*j?%~+@i69-;&_6!ZN+V^C*CF%cF9zjwe#%L5fdhKnnu2CNNsJHgCK|I95yVg?lUz z4XcUD%>;`fcvB)TNUNP(kX)aN?!pVBVmeZt8+GpF`c_!9d$`lWrBQLI0ruWq%5gXa z5f=q@Q?MvVM-4lki-)lu#tqF71!Fi6;i5C5Z}&*}Inr{m1k*wgo-5xy%0d-oI1tdg^@~S#ZF&E)kv>GsBf}QXFzm5$i0A zI#HE-Ju{5XW1>zZLk{P3o?twU%OGS$SSq_)$}PoMoIrK&HdGxAuZlX6;>Dp*B1EPZ ze%Txv7TWx+^I1WIXEjeou(27v@Zi{P!#*#g`L8A_o49qS)lBxJq6Wl*^o39O+7n1O*si`aG%SkgRz-5{coK_|5GMJ2C|e?TgIZ@%#31Vfi{ z0@~F=pBv{3!zT8=FW^6u<_pUw#x>vfn=kB{I7Hg;kZ@t*WM%QZfcrfA5GQ{T=`hl9 zr0Sq_8s$o)tHPMn0bP>jgYL{0GU(!a%f;EDRQz4O znJ2WL+S9e*Pr7XQi!RT@gfJq37(Er^<@tV=FGk0}k%psZ^S*5++8Yp}5nr({!q_fc zH+;Qw;S}eiT;aJ{ocyy{Tu1rOD0G<3$rF(rNYjMVQ&n9G!4|&^S+FkOnk9s%sp10$ zzY(M{<%!doS1~ituwa((V46WXXqLF#O6?jc6*6WFu-7jJ)(k!rYtI>w%D)hPidfA8 z1Yh3*?B{gh!i@1TGKpOC4lRT4mHQULbfzezvz1ZOg9Gi{5_DdLESPg!dJv7*iAEuT zaZ5wNI;RT<9~>Fo4yPFKl0?bN!YeaXb0-`KmPGe5n>|A$iC+py22Kr@q>hY-N%AP_n?!qGY5E_uiUoN1Ne2g|T9s|-IRUS1I|hv}jzUsQYq1zH=i;d_p(Xx|D*6SFc@ znq!kmXj+QmU=eEonOj=C3tin~!}25dP+_>NcrUIl_gI_@?W3B>@_fa96tZn}D^hro zC?o+nf3gLIRH7h4vgZqt)D;g^7%Hj%naV&wT?nTpAYyx&7}Nwkv6_WvfX(Di61heq zw`x_WKwnO3CfC=a#W1=>t^pAoZ<43dTkQzno^t5e?aJu0yCfZNGSS6&FG_Y zo&}iaI5P62W-{XAKzg_0M0Uu73BINUCy%B!3u?pDu!Cj7%z3?fg`(B~$Y&|EKa5Wmo|_jxJ?>H9 z+k-4Pq}`nuz{hOHNR$r}WZddd$TI|qn6qYre_WH9aDrm~Sm~^Z!rb{bR|fj<)h#-< z^>t)By9La{2yB%z6#thKLOEGPkXZoY8(To0BuF~k&Z)yF5KmECzNAtI(N>~zKEz$r z3HXXIbb(!ZxJ+2Fpj#($5-i;FlK;S(21$YXzb#lUJ)R=8Tc~vzGePPovS9TrNf8M! z-j5MSRRlJAO(@uK0t+(K5`s(z5MR{-GKL`}-pPVQ-d_pf{qF(ZuPoH}W)6K<5_JO8 zNQCD4&p+g)f%UXMU{H}!rQt`)goH)o#*QB^MihFsOFtYQO(WcFNIk@id@Y#CLl!KZ z0^Jx3Ike%1H61Dw$`}k)qVpP{q8o2iX(Y96{)N@j%mR@Zrrhh!`1~`VBi&-<&fw z6Op=Uba1488)LM&A_hXjd4`PAw$9Q1b z4CsolZlSQlpiGt{bY1#LKMKK<3Z5pUlM8Z*4qlXCTAU=OHzi1m?MDkomyR4&zXoj2 z9Tm)WUyNpe?E`2M=NRI<5zv0NyRB_zTQ1lh9_9)eXKX_we44bpvw@yBJx$EVtOxUj z$b#)B97F=M%`*gclE9RYg@WB4Daz=dHTDo>DuDQl1gQ+#FdYXd%o`lQv?X#&RaC)` z;9s1p?ox?#HDsBQ=?Y3BU8NQjkZ}IlWw_jbETkDJxR(`~YAHg)CS}_eS`*{&;!6gl8ZW*d?SG zXreP&oEDnh;KT!6w-SD_zf4HZRw5sR788MDlB3Z=0E494i zielj&!9i3bnYE5&S_g6X`W7;E0&z?cGI87Mi=svXFWd-l*``nx)DD9RW(I{v3xOsA zir?1)v<#qx*~d-xH&V;HQBO$_KoHT0TNcrxwtnxkba)J%0t!`&6~cr^mh~eA|EB

LsF)I}8b%2G+UrX|{_30-lg)swDt!6X%BdZhDq^Z1=AKeX6 zr3zBXe~JS?+J*O4Cy$h6K_{c^!8&RCK#)$hqlt6^SLWn^^=m|pvR@;KS$xIyS+zgg(S%X=69ySv2gWfigB^H`C0NBsd^CL&RgSv8*7PqF>3Y5NRL+iwg1n2oR54#xu zSZxIY{$e)9Dk&#)td8sbBSUK}9CWxl4Src94zSp} z()%Pc7}}=^ZBj1Ko^SoynJi4A{IuF4(jng7 zaYvpi+qvvnx3v^)ad3y`n6!Igmf%81H zmEDM&+?Z_`@_||!a_qtBNPHu1$nFXe2e>#i`=62zMtT0+6;l>Eol90MUd;*orpP6K zC(JfB%+45hLlKprjpkQ=`T^aAa0UQ;|EqSeCfDnwO+$@FxV@>5L@!8OT@?E@B8T)) z(hmA)-=PtPxCTk9j|mUD;_M#Mb;g!ZT@OL8z$!Er!tr^4;JK}#V68R6N!P&MujSC= z|BJboqH4hFl*;-+7R?nda2tjF@ywzE} z65-i{J4^Dd)yq9s8DiE4BQ_pStF|d_lnEtSI@gE5lNTYsSLNB3?e*U4;K{~isl@X= zF0izF`JQ>Kvw{eU2lc;kp4n&(Ou%sk7|y|}U=RL|Y^)*?N^+u}MwSLP5rDO@5Asee z${1K-@#dis%%+l?FkM|N6N)zXhd>S&~e#5l!lKE30_4% z<}PsZd<9`DCM2lxzj6F1zY4v1kE;caF~H&T;$@=4dDf^&JAdNEJpk+TV)i!i8a_22 zI4>d#@!%oER!a|NNM-K1O2+I>(_r#8-X><=(#X7bq*JEEMPJU5qFTP=}yVzLCUR zwJlVpx%<)uzK)P33k8XRGI2Y5(earP`tfCY#P2)0-tYeg*RnA z{}i6c8!!ECKuJ|z+JEB-)>D2@ND7n^QHn>p5I#6ir$h-;C2T<(s5AOX0pH2wvkD;p z;3q@n@0REyJ(2Ug3lz-s@qQM1(>zHu*fdEbXqqGf?lE$_fklNhS+-exH_XMS0x{pz z0{iLy3?;oKyplzVRL?gwF2P=n{q@dT`apWDuz1SWMPQihNOChgs2iH|nlDrT~ zI)yA)NdrJeJU*w;(j9j}XbH!Epow!C-|=h%(WoXGIXgmWoOdC%h}N@EQo$z zMmG(Ui%1*L_4aEt#&qKUG~kP=HrvLu$6^efOYjGQnxDEe6#pVZFGAuKLIq*ZJ}b#* z1$e1jHqf0KRz%fq9pTF#U)h*HwX%ucYYkR;FW~XL3V*+l`f|(D>Y&+Y0kD913>hCN zZ4Z=QQ`lUHL~;U^d4W3(gij6BrK8lEu{ASL zm*Fb~#;FCm8 zC!h{5Vc?w+uOgxf=TZ$GZ!fqUnQ*p^8M6N+4tfm&PSwCq6#H;Necq!!g{)8EDdE=P zJ}rpZg~%hZ4rYK+IX%IsTR}F{S3y;q@nwm(SALqOi0*!_x-XpC5?Ez&tvixx`$o<@ zCGbZKtV3TB0LGP-*@fDL<44B$C`Kfcc#}L6g@{)Nj1oom*L8^`Bca`m@5K=&Qvao4 zJh8sCRZ%E-HB3kZ7hW&y+%xGVj#LFj$wfu|+yg@ILeFg5u2aI%SG&7HHQb>s^~WBc zsnHon;hu`H2~NcD0x(<%XUz~M+eU2Q;}ZZXsEB8uKEO2$kTnA^@PK=C5tit`#)?by z>D30wmvT zD4w`OK;rBH?8=B+xJ;NR!EF%7LL1+v0m4P1$;5_A*5Fo9$7VT>qSmjEUd_mSQtm|S zpQ|I1L~qvH5(em3hg;#(dmo=^|E&#EJo#4=AcH4EVcF}k147R?{Iga&oR08&;5xi@ zkI#REW3LxEe8_#c$Fo7DuL&Py8@WjGa`^6rS$v7y5i=YQe&~u`dHs~B6hM+L33*AuY5;RW|Q4B)! zJo#Z)*do*KTiEzUytGOp6u%K7S=AeBr3+38V@hJB=)JgPg7oqMp|oT`zZ(Z| z*aJtW`M=G}oV*HUn(6*P{YhWB@qp0!c${k$sE~#)ggXPJKc6i9a5(|EJYNaHtC49U zPBhX!U7)pPXw0@zE}q| z16(mNjP`nJS5Q0Lz}J45+DQzwhy6_=FQR6Qr>}WCHIr;;jz%+~#|oes|1tvDAOge_ zKnwiisXa?N!H{DZB*W>9^9$RB zPITGJEYtwj`vMAk7kYz6$SGC1m?bkFW)Wr&VJ>_j6!W=Gp*+kc$Z7!b8}@}lKFc5( z&OhUU8o2ylo>aNWphOqgK$wpLDW6^xin&t@9ySu>J^=9}UJQl2+mX0sIGscM zdWgr=mKKe7!sMyg)JIJ6DTSacLM?b8qZN7h8)04tqfo~@PJBrv1`nLk(rLits8YNx=v7c7=+6Np#zPoUrgE`}#dx?$ znCl7io&%wnTeaZfBZBk*h~NHlDCEb8oY^*pGh{4q93u_}z3A>63xcwgG?aA;Pdtbs zCOR<7A3@Qph!-7o<9+Nc3{*)dLaY#0mdA7#ft}s)dIlP>DDd@BVmg>to?!DKqhqmp@{?h37{M@VYZPfFThWD$4r?V_3}>qB9@&YA6QbFE9)ShWK|L>2R5( zzz^|^4t(F3DI9pmNGH8D@7N+29K|&Dv=hzy_@lzWv;EqyLJc2w%tu3*eRgaoQ32m! zzA7eU*|y84gnyik>q|F?@1w=`60}2c_$H!=8Zg9I;Rt`6UFwG$FT(ZvQ#kiId%Uk( zst9);3mV{~zZi(57I7sce0#39%Lh0@1kCzVKr*gHXc1o=Nc#=zcug~FMzL%1Uv?ej z>l!#2-dl=g=bPAGraveYRP^n)ANTn9nSK9OgEHPD_hQ|}RiRA!OhWl$sc^GG8At4T zor-4azNOzLV7m|wW%fHiuKhs_D{p0&Tp!3AC&5CeU2yO`wHdrBS7V7v)?SWc%?-URxF*_%LXPH#dU@}M1pSFs=1 ziyO`e<1crU;=*4Z;i^6jhl;#GxuS~l9+xTCU8LMrfqc<+MLoMj*0M{Fa&`$n#V!da z*=5LaT=qT{?!m>K%oX2a*RbLmTnmzA#dUO_d#j25o*)rr366(~&^Sw8TnphYgjXYP z8^)Di2)~6A?Tc^-?kl}TcJlBw?!pswsKLsQJIQJ;VuwmA-2ADLjjZOK8k|<$qMGsH zjeNCS$a{bI|62)bAtA}tEY{HfEEg8@`AjrodF>U=|67)8{*C2!%`6L=tIAF^4grm) z$?|v9of6hu9ptJ<{k>1XG>&qf0v2`@=}pLC#z$WRc@yZR6)9cqTe3nmTc_VCAG-6964R)sV$8&cd0kz9xy$SmO;_`(nFvOvoV~G{%WSJDe=7$4wn}jB%#ilxlgfp|*Sf{h z?NW(X5zC|qb4M~(-jU>^AbfFcDDl$adOs_Xl{%xq%d43A!OLAM9pNw$F%|8B(19}=R5xXRdljK`lB;EsW+{v zh%^YDis-SuB%~s^(CLFDHDg-l?^R5#MU*l9i%NhFpoGh$giB=*CijEMG5w*gLJY@( zB5F;|uBe|fZF&*b0N;PmPtkA;0VBDIbj+RwDY9))#lRbJo#iwf3U>-#_4WOCiC0l0 z7cy=<9L<`*wtVtZdL#&z(eU{V&0qCN{BW$a;h5n3uvMm~?1Q%q(3IUc zJt~*p$(c4Ss5L6*7OMC?0G}pqO5GRpBb&|$3qMLsBpjJA*m$1njPc_wh^_IEVRwPTj||Y0)?SlS!nz7e3KTqJ^8E^aAitpQxy6z^9{7^~k3^ z=%(<~?m%$l)BebBd`cWjZy6(+k3Z^;2_tXW&^hN8(R=gOa7kyO@z#L*IT)k=p%NlV zQCR3bR-j-yyD@BSTX$G)U1uTnvv?Qv!MS*TBo!`%Qx^<{c!Y%x3$D+K#zfZ$lGu$H$*2tw2m z4%ZC+cSh^{9$wRx@fipzwb>hMy_p@MP#A`l;Sal;2Zb(`dGf{6TSNm=up2b|Aq~N< zmPMKXo|=M`no0D+hUoqj#Zo;P3_%3@7mHfpXLCabLPMV>`tHHTfx9u+n>n}{Pt^43d{$Rs;@5El0nG0O z&~)$3{M=i3R~CvJ%OCOAc*GhbU*1)C_UqUf)bogwS>C68u-&F(%>gdn|JoqwCWPOK zBli2>Su_uj`8g>K=wFm5mK&)&SS&YDSt*t|gxeymSPrAIQ7p@-Y!%B9R8A7ha+DVp zjp!bu@PeVE|$~GiH#7;^H`q4a(Ef)$@j1>ty0m2JQWL5mV--_!5#7iEYDy$ z%nCIyPHY(Sx|B9bC4F0k#lh-}uSq3g@((z9siYNFVCrqZh<`*%YrABmx*ig)t_?XT zo(cKduvp}9w#aGmluauuoz_mWMjD2$n96t&jr(!kzx$PF$T61g_Iw4Xw9A-n@-lvt$ENEt}myOjRXO>(7GTk_D1UN9cgT$fgg z$x}v5xqafv!Dq%kGx6Z{PD76wChc!kD(NGcBas%~B%sz(Yx&!d;(s#{is)9>dUXHa zO$>!}w``CkrhUdmQJMX49d>c|&_R;U5qD7j#aF*uIY<)Sde0?%BYkQ2(m|4Lt<$b^ z@(tH_ZyO}(8MfyJCoj1sO_cQUTZLx;?TT?C;!BN*5-uHeCkO2QX|QDeEEL-flyJR} zbV#X48A$7po0k`ZYF(gGwG(sM|!B2^-NGN|;#5Q+M} z6DG-x8KwILNtL8jo-7HI?9RF(*|2+isl>QD=@ChEDXcuFZJSkG8n=R5vitqFC4)+z zJS%x#Qo7)*WN#;-Mtaf}dqctvMA9RTN1BPW4CyhX?MMfZP9R-J`UXjg|KjO}l!#WgLD(= z3Q`5qNu*6T8N>YtUl+p(Iq55?=c+KmA2ioJ2V9L+_&%As)%ouC4Y0`z!WO?KSp0_9lC{qnl%eW3^+w<0;1;$05h> z4ve4@|3`*PxN^2~zH*5&Te)3Xp}eHLs_d!is~Vt6R*hAqs=ibGsQN|KNj+BWQGcuc zQT?)}MDvm6mgY-MJ8hg+uU)NOr`@D|PWyuPCGGp#I_(eIpS4|dR+ny=Zj^4P?q%KU zx(@oz`dGbQ|A2m@K3D&-{(Jp$!=r|EhFykd4KEnZ8LABLnhu$NGsjsHEQ2gia^f7kw*{VV$q_Rfx; z4z**RW2xhS<2A>3jvpPrIJi`fqfJDNZy0iw+mwaMGG%*JCskLKPGwdlsg|mys-IOq zuimddqrRlBQ@7K|H3Kw5HCoMsnhecy%~s7x%~egkrb#2yF43;gI<>C7+5_4e?bq6S zT8l18H&S<4cUAY9?v9SrhwG#CEA*@N>-Asgf7eS55r!FtMTRUxuHh-ee;Ix@{BG!K z>}iZQCK;2B-Iw zV{8*`t8MFSn_RXtwhG&ATcfR`eSkg5KHa|2{)9cxe%gM)u65WQM;&F3CNjbdeCL7y z(pqU$rYjdHoyv8}4azKKjxrDC__p#K3^H8RQ#C_3Tem=$rOVa1bzkbtdWSw)KUcp< zzf6Bx-v%OdGz>Lp3?{=YL%yNW(8=hEfedD&12VjCY&3?M5={@7Mw=#>mYP1{h=QZyjt^L$Va>R4Z@YVtv~BoOPe| zsP%2@b*t3Y!PeOpYa47EZY!`oYkSf5lP%od&Mvpd*$3Lk+2^?IPud0hv-U&wlaTqG z{bP*3=zvcfH_&1Q`JZp~+!6zw$aGVP;qMVIzxFajfy4F~$^c zQkqtnHk!7>;&+=~HeEG+Wg2cCW1enaXx?SsXFg*7&iuPM!qUOg#nRt0&N9bx$YrUv z)LQB-L!rP_>jLW%>q@I&-D7>;`kM8$^{n-x^)u`DR?fD~_5xHFZ&%u__D#@Pk^O-E zi2b7deftOYTD#Zoa4d0TI<`4#$X2pA?g%as${1xlyk)tvM%kbor&_1VQ5C927}guI z4F!hXh9bjZgG-d+Tf@H$e;8UDql{gQgN#a}-Z;;=*|^2H-B@ZoZ9H$hVtfm}dk^*y zYfdzeGpCtnnwOc^n6u2=AldWgM9WyqL`$0G5z89O2FnFlNPnx-y4iZt`i1p3YrIWq zTWDKp+hf~ry9r}I?zrNpcHDE+JAQIGxI#oNjA@LrhjOS=qckZODmN>)z^Y4?pDMpr z)+w8mtyRNRDXJN&g{ntXhg2t3r&Z@vU#RY=>Qqgt4(i9$Kd66FH>qPZJv4naGd0g> z4r>~8?e#JGKKg$8!3bGN`my?1`gwX@zg7Q~evf{i{*b;*e@1^^@A^S6Hz*9<4I|;( zt1!M>4Q|5@!`}=q8D2NMWjJei-*CfFYnWi1Vw_=ogK6U<;~nF-#wMfG)WOsl@olh4 zXR@2dnI@U$niiNhne)s$&3nxU%ty^-<_hx_bG7+PbDjAoGiM32w6jE8dRh`KcFO~n zF$jFCT$c5g&6aJJ=PkvSLzWK_G=8yoEd#9&Sr=NDSvOd-;82BdsQs{qQrN>K>&Mof zHkIvp+ZVPwwmMrodz4*aA8(&(f6TtczSF+P{+hkaUTMERy{zi zQCrmO)Pi~sLh^9USj}9GOY^qIqiN7|)%J!PuGMaIX?G(4zp6c@J*&N@y$PSJ)Ba2Q z2VAm)t~XqAp6+2?q3(q4ZJj}%rhiFarN5>3z$H5y;tT@~T7%s%+AtZ>Y`$ToA=8k9 zsP+`*%2y2~hB8AX2JZvICx$zQZxOJ6F@zf4wnq*8jE-*f9 ze8jlUm}5L(JZda6R>0n?jb9q;j6WHFH@3t0jxdceO*GAccds_BH|3jln%*@1%M@mA zYmPGaG7mLt%qIBxWb-`pOXlO|x6EhESIxK0UzzWke=$of9pM=ZEK4jaEiTKG7Qyl? zhWZW5RZF-v+GXu(?Pa~+YPUXM9b=tgoo9W_`lhu4<9yZnx%E5ikJewTZEYQG{op`O z+j^VJ_7ujx*mlVFmhG(Va~pRQpM+r?e^yI1GL1rG&6n+-EpqIBBRb{AA#aZH&=IalX$p78nKN8DpjK8>7q= z4PRJfT4u^K6_^Cm8B?X{8`W~)_Utt)+S6PGTT}EhxXQv2uDXp3|0v74xPj7nC95)c+qhX z>xAQ&E8lTkbX;}ZbbRKhMS%Iy@tcDy=eP~fP%C8=;$aVEU*!;`K{-bG5aQw*rK?O? zuB^mz>AJF-+5EQ%mA@&asT-3Z`m*}Ex>|i(U90{^U5|hz z)pXPhbYa9sX~t_NYtl9AG`Vn(O3f9GR69`X(2mxoXcuaiVz$cH?$AD~eN%f{TdBRO z^=kX;99XK%&}Hb}z*KchcUM=h`vpsu;rbN)Wc_sgOvJj?n7ZE6f5wK-gz2jc-XJk{ zMquA!bQ}L}tTFa84KlfGu;ouocQHB&b6?o;2t@ZO<_+ep<^r>TQ7Sf9nlGC_HUAfu zowF?qEm@XVET=6}tH!#<`hoQmtJ$_43z%A4XZsv1U7oX_Mc^6e&^jJ<6g%!vpsC`x z5m0{zWpAY&3zy}})rd3&N@_?RcB2vO`=An zF=_13&_vB_EK%2K@-zh+LGvuM^d9E(MvYg~QLEA#wMp7h+Lv;lU#%e2pQ1Z&y~Qwq7+SSR9rE zme(z(uui&S`M~mtCDHnWwb8l`j(gO0!gdNyd(n2qcEk3Gt%d@)$@X7Z`~6`HV~e8B z_E>u#d!l`)U28XEH8>KHeX>2>J{w;iW2*~oMrh>P%f>1rC*N&vlq{CSl^$r6JlG2R H`dj}4Op+I2