PCAN-Basic

Die PCAN-Basic API (Application Programming Interface) ermöglicht die einfache Entwicklung leistungsstarker Software mit CAN- und CAN-FD-Unterstützung. Die API beinhaltet alle Funktionen, die für die Kommunikation der Applikation mit einer PCAN-PC-Hardware benötigt werden. Durch das betriebssystemübergreifende Konzept können Softwareprojekte mit wenig Aufwand zwischen den Plattformen portiert werden.

PCAN-Basic besteht aus dem eigentlichen Gerätetreiber und einer Interface-DLL, welche die API-Funktionen zur Verfügung stellt.

Als Nachfolger von PCAN-Light bietet PCAN-Basic einen vergrößerten Funktionsumfang und eine erweiterte Sprachunterstützung. Sie stellt dem Entwickler unter C++, C#, C++/CLR, Delphi, VB.NET, Java und Python 3.x vielfältige Funktionen zur Verfügung.

CAN FD

PCAN-Basic für Windows unterstützt ab Version 4 den Standard CAN FD (CAN with Flexible Data rate), der sich vor allem durch eine höhere Bandbreite bei der Datenübertragung auszeichnet.

PCAN-Basic für Linux

PEAK-System bietet die PCAN-Basic API zur Entwicklung eigener CAN-Applikationen für Linux an. Der Programmierer kann dafür auf die Sprachen C++, Java und Python 3.x zurückgreifen.

• API zur Entwicklung von Anwendungen mit CAN- und CAN-FD-Anbindungen
• Unterstützt die CAN-Spezifikationen 2.0 A/B und FD
• Entwicklung von Anwendungen für die Plattformen Windows® 11 (x64/ARM64), 10 (x86/x64) und Linux
• Gleichzeitig können eine eigene und mehrere Applikationen von PEAK-System auf einem physikalischem Kanal betrieben werden
• Anwendung einer einzigen DLL für alle unterstützten Hardware-Typen
• Nutzung von bis zu 16 Kanälen pro Hardware-Typ (abhängig von dem verwendeten PEAK-CAN-Interface)
• Einfaches Umschalten zwischen den Kanälen eines PEAK CAN-Interfaces
• Zugriff auf die CAN-Kanäle eines PCAN-Gateways über den neuen Hardware-Typ PCAN-LAN
• Treiberinterne Pufferung von bis zu 32.768 CAN-Nachrichten pro CAN-Kanal
• Genauigkeit der Zeitstempel von empfangenen Nachrichten bis zu 1 µs (abhängig von dem verwendeten PEAK-CAN-Interface)
• Unterstützung der PEAK-System Trace-Formate Version 1.1 und 2.0 (für CAN-FD-Anwendungen)
• Zugriff auf spezielle Hardwareparameter wie beispielsweise Listen-Only-Mode
• Benachrichtigung der Applikation über Windows-Events beim Empfang einer Nachricht
• Unterstützung von CAN-Error-Frames
• Bestätigung des physikalischen Sendens durch CAN-Echo-Frames
• Erweitertes System für Debuggingoperationen
• Mehrsprachige Debuggingausgabe
• Ausgabesprache abhängig vom Betriebssystem
• Definition eigener Debugging-Information möglich
• Thread-safe API

Hinweis: Parallel-Port-CAN-Interfaces werden nur auf x86-Systemen unterstützt.

Systemvoraussetzungen

• Windows® 11 (x64/ARM64), 10 (x64) oder Linux
• Für die CAN-Bus-Anbindung: PC-CAN-Interface von PEAK-System
  
  

Funktionsüberblick

Verbindung:

• Initialize: Initialisierung einer CAN-Hardware, Setzen der Übertragungsrate, Anmelden am Treiber
• InitializeFD: Initialisierung einer CAN-FD-Hardware
• Uninitialize: Abmelden vom Treiber

Konfiguration:

• SetValue: Einrichten der Hardwareparameter wie Debug-Log, Listen-Only und Auto-Reset
• FilterMessages: Registrierung von Nachrichten für den Empfang

Information:

• GetValue: Auslesen der DLL- und API-Informationen
• GetStatus: Auslesen der CAN-Bus-Statusinformationen
• GetErrorText: Liefert eine Beschreibung des Fehlercodes

CAN-Kommunikation:

• Read: Lesen einer CAN-Nachricht bzw. des Status inkl. Timestamp
• ReadFD: Lesen einer CAN-FD-Nachricht
• Write: Senden einer CAN-Nachricht (11/29-Bit-ID und RTR möglich)
• WriteFD: Senden einer CAN-FD-Nachricht
• Reset: Löschen des Sende- und Empfangspuffers
  
  

• PCAN-Basic Interface-DLLs (x86/x64/ARM64)
• PCAN-Basic.NET-Assembly
• Beispiele und Header-Dateien für alle gängigen Programmiersprachen
• Dokumentation im PDF- und HTML-Help-Format

Zusätzliche Informationen

• PCAN-Basic API: Versionshistorie (Englisch)
• PCAN-Basic API (Linux): Versionshistorie (Englisch)
• Ein Vergleich unserer APIs für die Entwicklung von CAN-FD- und CAN-Anwendungen
• APIs für normierte Protokolle aus dem Automotive-Bereich
• Der Standard CAN FD: Unterstützung und kompatible Produkte
• PEAK-System Forum: Abschnitt für die PCAN-Basic API für Fragen und Support (Englisch)
• EULA: Endbenutzer-Software-Lizenzvertrag für unsere kostenfreien Treiber, Software und APIs