Interfaccia CAN-USB RKS+CAN, informazioni per sviluppatori e driver

L'attuale hardware CAN Interface di CANHack.de è l'RKS+CAN di Kaufmann Automotive GmbH. È un interfaccia di diagnostica CAN-USB con funzione di dongle.

Questo argomento è rilevante solo se si desidera sviluppare programmi propri per il RKS+CAN o se si intende utilizzarlo per programmi già esistenti.

Offre un'interfaccia di compatibilità ASCII (compatibile con LAWICEL) e una libreria .dll per Windows, per poterlo integrare con software esistente (Windows, Linux, Mac).
Come nuova funzionalità, supporta WCID (Windows Compatible ID) ed è quindi direttamente accessibile da applicazioni sviluppate sui sistemi operativi attuali come Microsoft Windows Vista, 7, 8, 8.1, 10, 11, senza la necessità di preoccuparsi di problemi relativi ai driver.

L'hardware utilizzata possiede una gestione delle licenze integrata e offre enormi margini di miglioramento per future estensioni delle funzionalità; il firmware dell'interfaccia CAN è aggiornabile.
Per quantità maggiori, è possibile un branding. Una versione wireless WIFI è in fase di progettazione.

Clienti finali: L'interfaccia CAN può essere acquistata qui, le versioni complete dei programmi KCANMonitor, KOBD2Check (include firmware e installazione dei driver) sono incluse, e il RKS+CAN è compatibile con molte altre applicazioni.
Produttore: Per richieste relative al branding o a interfacce personalizzate, vi preghiamo di contattare direttamente Kaufmann Automotive GmbH - Sviluppo di software embedded.

Software inclusa a seconda delle esigenze; di seguito sono elencati i software inclusi di serie:
- KCANMonitor, un analizzatore di bus CAN.
- API CAN per C++ e altri esempi (VB.NET, ecc.).
- Software OBD2, come KOBD2Check, che consente di utilizzare il sistema anche per la lettura dei codici di errore OBD2.
- KDataScope: visualizzazione e analisi grafica dei dati diagnostici OBD2.

RKS+CAN: Richieste di funzionalità: https://www.canhack.de/it/viewtopic.php?t=2059

Interfaccia CAN USB / Informazioni sul driver per applicazioni proprie di .

L'interfaccia CAN RKS+CAN offre 2 interfacce: VCP (porta COM virtuale per Linux e Mac, Windows XP - 8.1) e WinUSB (Linux, Mac, Windows XP - 8.1).

Installazione dei driver Windows: viene eseguita automaticamente tramite il pacchetto di installazione RKS+CAN. A partire da Windows 8, grazie al WCID, non è necessaria l'installazione manuale dei driver.

In Linux, aggiungere la seguente riga al file /etc/modules:
usbserial vendor=0x16d0 product=0x0870
Il dispositivo sarà quindi disponibile come /dev/ttyUSB0.

Con Kubuntu 18.04, ho dovuto fare quanto segue:
`insmod /lib/modules/4.15.0-210-generic/kernel/drivers/usb/serial/usbserial.ko vendor=0x16d0 product=0x0870`

Informazioni sul driver sono disponibili tramite il comando: `modinfo usbserial`.

Aggiornamento per Fedora 37 e Ubuntu 22.04 LTS:
Compatibile con il driver USB seriale "simple".

DLL di interfaccia RKS+CAN per Windows, utilizzabile per sfruttare l'interfaccia WinUSB nei propri programmi.

Cronologia delle versioni:
- 11.01.2014: Prima versione.
- 21 gennaio 2014: Correzioni di bug relative all'inizializzazione sicura e alla modalità di timestamp hardware.
- 23.01.2014: Correzione di un bug che causava la perdita dei messaggi CAN dopo una breve interruzione della connessione al bus.
- 24.01.2014: Funzionalità di misurazione della tensione tramite il connettore OBD2.
- 01.02.2014: Correzione di bug, selezione del bitrate inferiore a 83.333 bit/s.
- 29.06.2014: Correzione di un bug relativo all'invio di messaggi.
- 03.07.2014: Correzione di bug, gestione degli errori.
- 08.07.2014: Aggiornamento, documentazione in RKS-USB.H.
- 08.07.2014: Correzione di bug, interruzione dell'utilizzo della libreria DLL.
- 04.12.2014: Funzionalità: filtro hardware CAN configurabile.
- 10.12.2014: Articolo/Servizio speciale sulle notizie di RTR.
- 27.04.2018: Elaborazione asincrona dei comandi, anche in presenza di un bus CAN aperto e di messaggi in arrivo. Ciò significa che, durante la lettura dei messaggi CAN, è possibile, ad esempio, interrogare la tensione presente sulla connessione OBD2.

Descrizione dell'API:

Codice:

// 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);

Progetto C++ per Visual Studio, compatibile con le versioni 2008 e successive, con un esempio di utilizzo della libreria RKS-USB.DLL nei propri programmi.

Programma VB.NET (esempio di codice) per la simulazione della velocità su tachimetri VDO NEC 24c32/64, come ad esempio quelli presenti su modelli Passat 3C, Golf 6, T5.2 e altri.

Citazione:

I take the chance and recommend our CAN-interface RKS+CAN in english. Ha... Vantaggi: - Nessun problema con host USB 2.0 né USB 3.0. - Nessun driver necessario (!!!), una volta collegato al computer, funziona con Windows. installs (if needed) automatically the necessary driver. L'utente o un... Lo sviluppatore software che utilizza il nostro cavo non deve fare assolutamente nulla. (Compatibile con Windows superiori a XP). - Compatibile con Windows XP e Windows 10. - Il firmware (i comandi) può essere adattato alle VOSTRE esigenze come sviluppatore di software. - Currently it is tested out and working perfectly. Se in seguito dovesse essere disponibile un nuovo aggiornamento del firmware... updates may be necessary, this is absolutely NO problem. Il testo crittografato. Il firmware può essere fornito semplicemente insieme al vostro ultimo pacchetto software. Aggiornare il firmware richiede una sola riga di codice. - Gestione sicura delle licenze: un'applicazione può verificare la validità di una licenza. using asymmetric encryption via elliptic curves (curve25519). Anche noi, come... Gli sviluppatori hardware non sanno quale licenza sia memorizzata nel cavo! - È possibile identificare singoli cavi utilizzando il numero di serie del cavo che si trova... Desiderate stampare sui cavi OPPURE utilizzando la memoria interna del microcontrollore. numero di serie. - Microcontrollore ad alta velocità difficile da copiare, clonare o leggere: LPC1756. - Codice di esempio (C++) per la verifica della licenza, l'archiviazione, l'aggiornamento del firmware e la comunicazione CAN. Comunicazione disponibile. - È possibile utilizzare il proprio VID/PID USB oppure uno dei nostri (esclusivamente per...). (Versione per cavo). - Competitive price, WE are the manufacturer. Indicaci semplicemente la tua richiesta. quantità e desideri, cosa modificare per adattarla alle tue esigenze.

Cordiali saluti, Rainer.

Linux:
L'ID del produttore/dispositivo per il driver usb-serial-simple è stata testata con successo.

Codice:

[ 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

e proposta per l'integrazione.

Se qualcuno utilizza ancora una versione di Linux in cui gli ID non sono inclusi, si veda: [segue un riferimento o istruzione].
RKS+CAN con Linux Fedora 37.

Se dovesse accadere che il modulo "usb-serial-simple" non sia elencato con il comando "lsmod" quando l'interfaccia è collegata, provare a caricare prima il modulo "insmod usbserial" e poi "insmod usb-serial-simple".

Verifica del successo con il comando "dmesg".

Cordiali saluti, Rainer.