PCAN-Basic API

PCAN-Basic provides an API for applications that communicate through an installed PCAN driver. The package normally contains runtime libraries, headers or language bindings, documentation, and sample projects. Use the contents and release notes of the package you install as the source for exact platform and language support.

Package Checklist

Look for these items after installation or extraction:

• runtime libraries for the target architecture;
• headers and import libraries for native development;
• managed or language-specific bindings where supplied;
• sample console and GUI projects;
• the English API help file or online reference.

Recommended Bring-up Sequence

1. Install the PCAN driver and verify the channel in PCAN-View.
2. Run a sample that enumerates or looks up channels.
3. Initialize one channel with the bus mode and bit timing used by the network.
4. Read status before transmitting.
5. Send and receive a controlled test frame.
6. Uninitialize the channel on exit, including error paths.

For CAN FD, use the CAN FD initialization and frame APIs supplied by the installed package. Classic CAN initialization does not automatically enable CAN FD.

Error Handling

• Check every API return value.
• Convert error codes to readable text where the binding provides that function.
• Distinguish driver or channel errors from CAN-bus error states.
• Record the channel identifier, initialization string or bit timing, and software versions in test logs.

Samples

Start with the sample closest to the required operation: channel lookup, parameter access, manual read/write, timer-driven I/O, event-driven receive, or trace-file handling. Build it unchanged first, then introduce project-specific logic one change at a time.

Interoperability remains scoped to the tested hardware, CANmeleon application profile and version when applicable, driver, OS, PCAN-Basic package, tested functions, limitations, and date.