이 페이지에서

PeakCAN 플러그인 사용법

PeakCAN 플러그인은 PEAK-System CAN 어댑터와 연동하기 위한 저수준 API를 캡슐화합니다.

이 플러그인을 사용하려면 Windows에서는 PCAN 장치 드라이버와 PCAN-Basic 라이브러리 버전 4.4.0 이상(pcanbasic.dll), Linux에서는 버전 4.0.0(libpcanbasic.so)이 필요합니다. macOS에서는 UV Software의 PCBUSB 라이브러리(버전 0.9 이상)가 필요합니다.

참고: Qt버전 5.14~6.4는 PCBUSB 라이브러리 버전 0.8.1과만 호환되지만, Qt 버전 6.5 이상은 PCBUSB 버전 0.9 이상이 필요합니다.

참고: QCanBusDeviceInfo::alias() 기능은 Windows 환경에서만 지원되며, PCAN-Basic 4.4.0 이상 버전에서만 사용할 수 있습니다.

CAN 버스 장치 생성

먼저 QCanBus 에서 원하는 플러그인이 제공되는지 확인해야 합니다:

if (QCanBus::instance()->plugins().contains(QStringLiteral("peakcan"))) {
    // plugin available
}

여기서 peakcan은 플러그인 이름입니다.

다음으로, 특정 인터페이스에 대한 연결을 설정할 수 있습니다:

QString errorString;
QCanBusDevice*device = QCanBus::instance()->createDevice(
    QStringLiteral("peakcan"), QStringLiteral("usb0"), &errorString);
if (!device) {
    // 오류 처리 코드는 여기에 작성
    qDebug << errorString;
} else {
    device->connectDevice();
}

여기서 usb0은 활성 CAN 인터페이스 이름입니다. PeakCAN 플러그인은 usb0부터 usb15까지 16개의 USB 인터페이스와 pci0부터 pci15까지 16개의 PCI 인터페이스를 지원합니다. availableDevices() 메서드는 현재 사용 가능한 장치 목록을 반환합니다.

참고: 현재 이 플러그인은 USB 및 PCI어댑터만 지원합니다.

참고: macOS에서는 현재 이 플러그인이 USB 어댑터만 지원합니다.

이제 해당 장치가 CAN 프레임의 읽기 및 쓰기 작업을 수행할 수 있게 되었습니다:

QCanBusFrame frame;
frame.setFrameId(8);
QByteArray payload("A36E");
frame.setPayload(payload);
device->writeFrame(frame);

readFrame() 메서드를 사용하여 읽기 작업을 수행할 수 있습니다. 읽을 수 있는 새로운 프레임이 하나 이상 있을 때 framesReceived() 신호가 발생합니다:

QCanBusFrame frame = device->readFrame();

PeakCAN은 setConfigurationParameter()을 통해 제어할 수 있는 다음과 같은 구성들을 지원합니다:

구성 매개변수 키설명
QCanBusDevice::CanFdKey이 구성 옵션은 CAN FD 프레임을 송신하거나 수신할 수 있는지 여부를 결정합니다. 기본적으로 이 옵션은 비활성화되어 있습니다. 이 옵션을 활성화하려면 CAN FD 호환 하드웨어가 필요합니다.
QCanBusDevice::BitRateKeyCAN 버스 연결의 비트 전송률을 결정합니다. 다음의 비트 레이트가 지원됩니다: 5000, 10000, 20000, 33000, 47000, 50000, 83000, 95000, 100000, 125000, 250000, 500000, 800000, 1000000. ‘ QCanBusDevice::CanFdKey ’ 옵션이 활성화된 경우, 비트 전송률은 125000, 250000, 500000 또는 1000000으로 제한됩니다. 이 구성 매개변수는 ‘ QCanBusDevice ’가 연결되어 있지 않은 상태에서만 조정할 수 있습니다.
QCanBusDevice::DataBitRateKeyCAN FD 버스 연결의 데이터 비트 전송률을 결정합니다. 이 옵션을 설정하려면 ‘ QCanBusDevice::CanFdKey ’ 옵션이 활성화되어 있어야 합니다. 가능한 데이터 비트 전송률은 2000000, 4000000, 8000000 또는 10000000입니다. 이 구성 매개변수는 ‘ QCanBusDevice ’가 연결되어 있지 않은 상태에서만 조정할 수 있습니다.

PeakCAN은 다음과 같은 추가 기능을 지원합니다:

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.