PCAN-Basic

Die PCAN-Basic API (Application Programming Interface) ermöglicht die einfache Entwicklung leistungsstarker Software mit CAN-CC-, CAN-FD- und CAN-XL-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. Die API unterstützt zahlreiche Programmiersprachen, wie C++, C#, C++/CLR, Pascal OO, VB.NET, Java und Python 3.x. Seit Version 4 unterstützt PCAN-Basic CAN FD. Im Jahr 2025 wurde mit Version 5 die Unterstützung für CAN XL eingeführt.

CAN XL (Extended Data-Field Length) wurde mit dem Ziel geschaffen, die Zusammenarbeit von CAN- und TCP/IP-Netzwerken zu verbessern und die Übertragung größerer Datenströme für Anwendungsfälle wie Flashen von Steuergeräten und Software-Updates zu ermöglichen. Dazu bietet der neue Standard Bitraten von bis zu 20 Mbit/s und eine Datenübertragung mit bis zu 2048 Byte pro Nachricht.

• API zur Entwicklung von Anwendungen mit CAN-CC-, CAN-FD- und CAN-XL-Anbindungen
• Unterstützt die CAN-Spezifikationen CAN CC (Classic CAN 2.0), CAN FD und CAN XL (ISO 11898-1 2024)
• 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
• Nutzung von bis zu 16 Kanälen pro Hardware-Typ
• Einfaches Umschalten zwischen den Kanälen eines PEAK CAN-Interfaces
• Zugriff auf die CAN-Kanäle eines PCAN-Gateways über den 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 für CAN-CC-Aufzeichnungen
  • Version 2.0 für CAN-FD-Aufzeichnungen
  • Version 3.0 für CAN-XL-Aufzeichnungen
• 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
• Erweitertes System für Debuggingoperationen
• Mehrsprachige Debuggingausgabe
• Ausgabesprache abhängig vom Betriebssystem
• Definition eigener Debugging-Information möglich
• Thread-safe API
   

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.
 

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
• InitializeXL: Initialisierung einer CAN-XL-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
• ReadXL: Lesen einer CAN-XL-Nachricht
• Write: Senden einer CAN-Nachricht (11/29-Bit-ID und RTR möglich)
• WriteFD: Senden einer CAN-FD-Nachricht
• WriteXL: Senden einer CAN-XL-Nachricht
• Reset: Löschen des Sende- und Empfangspuffers oder Ausführen eines Hardwareresets

• 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