CAN zu USB Interface RKS+CAN, Entwickler Info & Treiber

Die aktuelle CANHack.de CAN Interface Hardware ist das RKS+CAN von Kaufmann Automotive GmbH. Es ist ein CAN zu USB Diagnose Interface mit Donglefunktion.

Dieses Thema ist nur von Belang, wenn man eigene Programme für das RKS+CAN entwickeln will oder es für bereits existierende Programme genutzt werden soll.

Es ist bietet eine ASCII Kompatibilitätsschnittstelle (LAWICEL kompatibel) sowie eine Windows .dll an um es mit bestehender Software anzusprechen (Windows, Linux, Mac).
Als Neuentwicklung unterstützt es WCID (Windows Compatible ID) und ist damit unter aktuellen Betriebssystemen wie Microsoft Windows Vista, 7, 8, 8.1, 10 direkt von entwickelten Applikationen ansprechbar ohne sich um Treiberfragen kümmern zu müssen.

Die verwendete Hardware besitzt eine integrierte Lizenzverwaltung und bietet enorme Reserven für zukünftige Feature-Erweiterungen, die Firmware des CAN-Interface ist upgradefähig.
Für größere Stückzahlen ist ein Branding möglich. Eine drahtlose WIFI-Variante ist in Planung.

Endkunden: Das CAN-Interface kann hier erworben werden, die Vollversionen der Programmes KCANMonitor, KOBD2Check (enthält Firmware und Treiberinstallation) sind dabei, das RKS+CAN ist kompatibel zu vielen weiteren Applikationen.
Hersteller: Anfragen für Branding oder eigene Schnittstellen richten Sie bitte direkt an Kaufmann Automotive GmbH - Embedded Softwareentwicklung.

Softwareumfang nach Wunsch, standardmässig sind folgende Softwaren dabei:
- KCANMonitor CAN Sniffer.
- CAN-API für C++ und weitere Beispiele (VB.NET etc.).
- OBD2-Software KOBD2Check, d.h. man kann das System auch zur OBD2-Fehlerauslese nutzen.
- KDataScope, OBD2-Messwerte graphisch darstellen und untersuchen.

RKS+CAN Feature Requests: https://www.canhack.de/viewtopic.php?t=2059

Hilfreich: OBD2-Breakout Box

CAN-Interface USB Treiber / Treiberinfo für eigene Applikationen.

Das RKS+CAN CAN-Interface stellt 2 Schnittstellen zur Verfügung, VCP (virtueller COM Port für Linux und Macs, Windows XP - 8.1) und WinUSB (Linux, Macs, Windowx XP - 8.1).

Treiberinstallation Windows: Wird vollautomatisch mit dem RKS+CAN Installationspaket erledigt. Ab Windows 8 durch WCID keine manuelle Treiberinstallation notwedig.

Bei Linux folgende Zeile zur Datei /etc/modules hinzufügen:
usbserial vendor=0x16d0 product=0x0870
Das Gerät steht dann als /dev/ttyUSB0 zur Verfügung.

Bei Kubuntu 18.04 musste ich allerdings folgendes machen:
insmod /lib/modules/4.15.0-210-generic/kernel/drivers/usb/serial/usbserial.ko vendor=0x16d0 product=0x0870

Info zum Treiber gibt es mit: modinfo usbserial

Update für fedora 37 und Ubuntu 22.03 LTS:
verwendbar mit Treiber usb-serial-simple.

RKS+CAN Windows Interface DLL zur Nutzung der WinUSB Schnittstelle in eigenen Programmen.

Versionshistorie:
- 11.01.2014: Erstes Release
- 21.01.2014: Bugfixes sichere Initialisierung und Hardware Zeitstempel Modus.
- 23.01.2014: Bugfix, keine CAN Nachrichten mehr nach kurzer Trennung vom Bus.
- 24.01.2014: Feature Ub Spannungsmessung am OBD2 Stecker.
- 01.02.2014: Bugfix, Bitratenselektion < 83.333Bit/s.
- 29.06.2014: Bugfix, senden von Nachrichten.
- 03.07.2014: Bugfix, Behandlung von Ausnahmefehlern.
- 08.07.2014: Update, Dokumentation in RKS-USB.H
- 08.07.2014: Bugfix, beenden Benutzung der DLL.
- 04.12.2014: Feature Hardware CAN Filter konfigurierbar.
- 10.12.2014: Feature RTR Nachrichten.
- 27.04.2018: Asynchrone Verarbeitung von Befehlen, auch bei offenem CAN Bus und eintreffenden Nachrichten. D.h. während man CAN Nachrichten liest, kann z.B. die Spannung am OBD2 Stecker abgefragt werden.

API-Beschreibung:

Code:

// RKS-USB.h : main header file for the RKS-USB DLL // #pragma once #ifndef __AFXWIN_H__    #error "include 'stdafx.h' before including this file for PCH" #endif // CAN frame types #define FRAME_TYPE_NORMAL     0x1 #define FRAME_TYPE_RTR        0x2 #define FRAME_TYPE_NORMAL_EXT 0x3 #define FRAME_TYPE_RTR_EXT    0x4 #define FRAME_TYPE_ERR        0x5 // CAN data structure typedef struct {   DWORD dwID;   BYTE byDLC;   BYTE abyData[8]; // max 8 data bytes } can_data_t; // CAN error information structure typedef struct {   BYTE byError; } can_err_t; // CAN information structure typedef union {   can_data_t sData;   can_err_t sErr; } can_union_t; // The final CAN frame structure used for send/receive typedef struct {   BYTE byType;   DWORD dwTimeStamp;   can_union_t uFrm;  } can_msg_t; // DLL exports // Initialize USB driver, open connection to RKS+CAN hardware. Returns TRUE on success. //  This command must be done once before calling any other RKS... function, except //  RKSDeviceConnected. extern "C" __declspec(dllexport) BOOL RKSInitialize(void); // Free USB driver and RKS+CAN hardware. Should be called to release interface/driver. extern "C" __declspec(dllexport) void RKSFree(void); // Check if the RKS+CAN is connected to the computer. Returns TRUE on success. pcBufIfGUID can be NULL. //  If pcBufIfGUID is not NULL, copy the DeviceInterfaceGUID of the RKS+CAN hardware to it. //  If you check simply if the RKS+CAN is connected, it is recommended to call it with pcBufIfGUID = NULL. extern "C" __declspec(dllexport) BOOL RKSDeviceConnected(LPSTR pcBufIfGUID, DWORD dwBufSize); // Set the timeouts for reading / writing data to the RKS+CAN interface. The software waits at maximum the //  specified values for read/write operations to complete. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSSetTimeouts(DWORD dwMsTimeoutRead, DWORD dwMsTimeoutWrite); // Get the version of the of the RKS+CAN hardware. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSGetVersion(PUCHAR pucBuffer, DWORD dwBufferLength); // Get the serial number of the RKS+CAN hardware (printed on the cable case).  Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSGetSerial(PUCHAR pucBuffer, DWORD dwBufferLength); // Return time since RKS-USB driver initialisation. bReInit can be used to reset the time to zero. //  Can be used to get relatively exact time information, the time is returned in seconds. extern "C" __declspec(dllexport) double RKSGetTimeSinceInit(BOOL bReInit = FALSE); // Get the error status of the RKS+CAN interface in pbyStatus. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANGetLastStatus(BYTE* pbyStatus); // Set RKS+CAN hardware to listen only mode. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANSetListenOnly(BOOL bEnabled); // Set time stamp mode of the RKS+CAN hardware. E.g. 0, 1 or 2. //  For possible values check the ASCII interface description. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANSetTimeStamp(BYTE byMode); // Get time stamp mode. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANGetTimeStamp(BYTE*pbyMode); // Get the supply voltage of the RKS+CAN hardware. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANGetUb(DWORD* pdwVoltage_mV); // Set CAN hardware filtering of the RKS+CAN hardware. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANSetFilter(DWORD dwCode, DWORD dwMask); // Open CAN bus with the desired bitrate. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANOpen(DWORD dwBitrate); // Close CAN bus. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANClose(void); // Get one CAN message from the receive queue, RKSCANOpen(...) must have //  been called before. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANRx(can_msg_t* pMsg); // Add one CAN message to the send queue, RKSCANOpen(...) must have //  been called before. Returns TRUE on success. extern "C" __declspec(dllexport) BOOL RKSCANTx(can_msg_t* pMsg);

C++ Visual Studio Projekt für Visual Studio 2008 und neuer, Beispielnutzung der RKS-USB.DLL in eigenen Programmen.

VB.NET Programm (Beispielcode) zur Drehzahlsimulation an NEC 24c32/64 VDO Tachos, also z.B. Passat 3C, Golf 6, T5.2 Tachos usw.

Zitat:

I take the chance and recommend our CAN-interface RKS+CAN in english. It has the following advantages: - NO problems with USB 2.0 nor USB 3.0 hosts - NO (!!!) driver hassling, once plugged to the computer, Windows installs (if needed) automatically the necessary driver. The user or a software developer using our cable needs to to *nothing*. (Win > XP) - Compatible to Win XP - Win 10 - Firmware (commands) can be adapted to YOUR need as software developer. - Currently it is tested out and working perfectly. If later firmware updates may be necessary, this is absolutely NO problem. The encrypted firmware can be simply delivered with your latest software package. Updating the firmware is one line of code. - Secure license handling, an application can check for valid license using asymmetric encryption via elliptic curves (curve25519). Even we as hardware developer do not know what license is stored in the cable! - You can identify single cables using the cable serial number that you wish to print on your cable OR using the microcontroller's internal serial number. - Fast microcontroller that is not easy to copy/clone/read out: LPC1756. - Demo code (C++) for license check/store/firmware upgrade/CAN communication available. - You can use your own USB VID/PID or use one of ours (exclusively for YOUR cable version). - Competitive price, WE are the manufacturer. Just tell us your quantities and wishes what to change to your needs.

Best, Rainer

Linux:
Vendor/Device-ID für Treiber usb-serial-simple erfolgreich getestet

Code:

[ 8061.025594] usbserial: USB Serial support registered for kaufmann [ 8061.025611] usb_serial_simple 2-1.3:1.0: kaufmann converter detected [ 8061.031722] usb 2-1.3: kaufmann converter now attached to ttyUSB0 [ 8061.031767] usb_serial_simple 2-1.3:1.1: kaufmann converter detected [ 8061.031871] usb 2-1.3: kaufmann converter now attached to ttyUSB1

und zur Integration vorgeschlagen.

Sollte jemand noch ein Linux nutzen, wo die IDs nicht drin sind, siehe:
RKS+CAN mit Linux Fedora 37

Sollte, warum auch immer usb-serial-simple bei angestecktem Interface nicht mit "lsmod" gelistet sein, "insmod usbserial" und dann "insmod usb-serial-simple".

Erfolg testen mit "dmesg".

Viele Grüsse, Rainer