USBCAN.DLL. Manual. Microcomputersysteme. Version 1.2

Transkript

1 USBCAN.DLL Microcomputersysteme Manual Version 1.2 August 2004

2 Die in diesem Manual verwendeten Beschreibungen für Erzeugnisse, die ein eingetragenes Warenzeichen darstellen können, wurden nicht separat bezeichnet. Es wird ausdrücklich darauf verwiesen, daß die Firma Microcomputersysteme weder eine Garantie noch irgendeine juristische Verantwortung oder Haftung für Folgeschäden übernimmt, die auf den Gebrauch oder den Inhalt dieses Handbuches zurückzuführen sind. Die in diesem Handbuch enthaltenen Angaben können ohne vorherige Ankündigung geändert werden. Die Firma Microcomputersysteme geht damit keinerlei Verpflichtungen ein. Die Firma Microcomputersysteme übernimmt weder eine Garantie noch die juristische Verantwortung oder irgendeine Haftung für Folgeschäden, die auf Gebrauch der Software zurückzuführen sind. Die Firma Microcomputersysteme kann ohne vorherige Ankündigung die Software ändern und geht damit keinerlei Verpflichtungen ein. Kein Teil dieses Buches darf in irgendeiner Form ohne schriftliche Genehmigung der Firma Microcomputersysteme unter Einsatz entsprechender Systeme reproduziert, verarbeitet, vervielfältigt oder verbreitet werden. Copyright 2004 Microcomputersysteme - Alle Rechte vorbehalten. Microcomputersysteme Frölichwiese Sosa Tel / Fax / info@mc-sys.de

3 Dieses Handbuch ist nur für Entwickler gedacht, die in Ihrer Applikation die Funktionen der canusb-dll nutzen möchten. Diese Funktionen sind nur mit der originalen Hardware nutzbar, es ist nicht erlaubt, diese DLL weiterzugeben. Die API-Funktionen: int stdcall CAN_Init ( unsigned long hwnummer, //Seriennummer auf Label unsigned short int baudrate, //Baudratenregister BTR0/BTR1 int mode, //0=82C200, 1=SJA1000 unsigned long int acc_code, unsigned long int acc_mask ); Parametrisiert die Hardware. int stdcall CAN_Close ( void ); gibt Hardware frei. int stdcall CAN_Status ( void ); liefert den Inhalt des Statusregister zurück. int stdcall CAN_MsgWr ( struct message *ptransmit ); Schreibt eine Nachricht. mögliche Rückgabe: CAN_TXFULL int stdcall CAN_MsgRd ( struct message *ptransmit ); gibt die nächste Message oder den nächsten Fehler zurück. Message wird nach 'transmitt' geschrieben. mögliche Rückgabe: CAN_OK,CAN_BUSERROR int stdcall CAN_DllInfo ( struct info *pinfo ); gibt einen Textstring mit Version- und Copyrightinfo zurueck (max. 255 Zeichen).

4 Headerfile usbcan_demo.h #ifndef USBCAN_DEMO_H #define USBCAN_DEMO_H /*** Maskenbits fuer Fehlerbedingungen ***/ #define CAN_OK #define CAN_TXFULL #define CAN_RXEMPTY #define CAN_OVERRUN #define CAN_BUSERROR #define CAN_BUSOFF #define CAN_NODRIVER 0x00 0x01 // Sendepuffer im Controller ist voll 0x02 // keine neue Message empfangen 0x04 // CAN-Controller wurde zu spaet gelesen 0x08 // Busfehler: ein Errorcounter erreichte Limit 0x10 // Busfehler: CAN-Controller ging 'Bus-Off' 0x20 // kein ezusb.sys geladen /*** Baudratencodes = Registerwerte BTR0/BTR1 */ #define CAN_BAUD_1M 0x0014 // 1 MBit / s #define CAN_BAUD_500K 0x001C // 500 kbit / s #define CAN_BAUD_250K 0x011C // 250 kbit / s #define CAN_BAUD_125K 0x031C // 125 kbit / s #define CAN_BAUD_100K 0x432F // 100 kbit / s #define CAN_BAUD_50K 0x472F // 50 kbit / s #define CAN_BAUD_20K 0x532F // 20 kbit / s #define CAN_BAUD_10K 0x672F // 10 kbit / s #define CAN_BAUD_5K 0x7F7F // 5 kbit / s struct message unsigned long int ID; // 11 Bit-Kennung unsigned char RTR; // true, wenn remote request unsigned char LEN; // Anzahl der gueltigen Datenbytes (0..8) unsigned char DATA[8]; // Datenbytes 0..7 unsigned char EXTENDED; // true, wenn extended (29 Bit) Frame ; struct message CANMsgRd; struct message CANMsgWr; struct info unsigned char byte[255]; ; struct info dllinfo; #endif

5 Beispielprogramm usbcan_demo.c: #include <windows.h> #include <winbase.h> #include <stdio.h> #include <conio.h> #include <string.h> #include <fcntl.h> #include <sys\stat.h> #include <io.h> #include <time.h> #include "usbcan_demo.h" HINSTANCE hdll; typedef int ( stdcall *pcan_init) ( unsigned long hwnummer, unsigned short int baudrate, int _mode, unsigned long int acc_code, unsigned long int acc_mask ); typedef int ( stdcall *pcan_close) (void); typedef int ( stdcall *pcan_status) (void); typedef int ( stdcall *pcan_msgwr) ( struct message *ptransmit ); typedef int ( stdcall *pcan_msgrd) ( struct message *ptransmit ); typedef int ( stdcall *pcan_dllinfo) (struct info *pdllinfo); pcan_init CAN_Init; pcan_close CAN_Close; pcan_status CAN_Status; pcan_msgwr CAN_MsgWr; pcan_msgrd CAN_MsgRd; pcan_dllinfo CAN_DllInfo; int status; unsigned char i; long sendtime ; /* Zeit in Sekunden */ #define NOW (clock() / CLK_TCK) int main( void ) hdll=loadlibrary("usbcan.dll"); if ( hdll == NULL ) printf("\n Programm benoetigt usbcan.dll!"); printf("\n Weiter mit bel. Taste...\n"); getchar(); return FALSE;

6 // DLL-Adressen ermitteln CAN_Init=(int( stdcall *)( unsigned long hwnummer, unsigned short int baudrate, int _mode, unsigned long int acc_code, unsigned long int acc_mask )) GetProcAddress(hDll,"CAN_Init"); CAN_Close=(int( stdcall *)(void)) GetProcAddress(hDll,"CAN_Close"); CAN_Status=(int( stdcall *)(void)) GetProcAddress(hDll,"CAN_Status"); CAN_MsgWr=(int( stdcall *)(struct message *ptransmit)) GetProcAddress(hDll,"CAN_MsgWr"); CAN_MsgRd=(int( stdcall *)(struct message *ptransmit)) GetProcAddress(hDll,"CAN_MsgRd"); CAN_DllInfo=(int( stdcall *)(struct info *pdllinfo)) GetProcAddress(hDll,"CAN_DllInfo"); if ( CAN_Init( ,CAN_BAUD_100K,1,0xFFFFFFFF,0xFFFFFFFF )!= NULL ) return FALSE; sendtime = NOW ; while (! kbhit() ) /* ---- Lesen ---- */ status = CAN_MsgRd( &CANMsgRd ); if ( status == CAN_ERR_OK ) printf("\ncanmsg-id:%0.8d",canmsgrd.id); printf(" LEN=%d, ",CANMsgRd.LEN) ; if ( CANMsgRd.RTR == 1 ) printf(" RTR=1, "); else printf(" RTR=0, "); for (i=0; i < CANMsgRd.LEN ; i++) printf("%0.2x",canmsgrd.data[i]); /* ---- Senden ---- */ if ( sendtime < NOW ) CANMsgWr.ID=400; CANMsgWr.RTR=0; CANMsgWr.LEN=2; CANMsgWr.DATA[0]=0x11; CANMsgWr.DATA[1]=0x55; CAN_MsgWr(&CANMsgWr); /* jede Sekunde senden */ sendtime = NOW + 1 ; /* while */ CAN_Close(); CAN_DllInfo(&dllinfo);

7 printf("\n\n%s",dllinfo.byte); FreeLibrary( hdll ); printf("\n*** USBCAN-Test beendet ***\n") ; printf("\nbeenden mit Return "); getch(); return 0;