Qt를 이용한 CAN 버스 개발: SocketCAN에서 PeakCAN까지의 설정 가이드

자동차 전자, 산업 제어 및 임베디드 시스템 개발 분야에서 CAN 버스는 중요한 통신 수단입니다. 그러나 개발자가 Qt 애플리케이션에 CAN 통신을 통합하려고 할 때, 다양한 운영 체제와 하드웨어 인터페이스 사이에서 일관성 있고 유지보수가 쉬운 코드를 작성하는 방법을 찾는 데 어려움을 겪습니다. Linux의 SocketCAN과 Windows의 PeakCAN 중 어떤 것을 선택해야 할까요? 이는 단순히 API 호출의 차이뿐만 아니라 개발 환경 구성, 플러그인 설정, 크로스 플랫폼 컴파일 및 실제 배포 과정에서의 여러 문제를 포함합니다.

본 문서는 실제 프로젝트에서 Qt CAN 기능을 구현해야 하는 엔지니어를 위한 것입니다. 기본적인 API 목록을 나열하지 않고, 실제로 필요한 모든 과정을 단계별로 설명합니다. 라즈베리 파이의 가상 CAN부터 산업용 컴퓨터의 PCIe CAN 카드까지, 이 문서는 명확한 경로와 재사용 가능한 솔루션을 제공합니다.

1. 개발 환경 설정 및 크로스 플랫폼 전략

첫 번째 CAN 통신 코드를 작성하기 전에 안정적이고 이식 가능한 개발 환경을 설정하는 것이 중요합니다.

1.1 Qt와 SerialBus 모듈의 버전 선택

먼저 Qt SerialBus 모듈이 포함된 Qt 버전을 사용해야 합니다. 이 모듈은 Qt 5.8 버전부터 도입되었으며, 이후 계속 개선되었습니다. 새로운 프로젝트에서는 Qt 5.15 LTS 또는 Qt 6.2 이상 버전을 권장합니다. 이들 버전은 CAN 버스 지원이 더 성숙하며, 초기 버전의 호환성 문제를 해결했습니다.

Qt 설치 시 유지 관리 도구(Maintenance Tool)를 통해 Qt SerialBus 컴포넌트를 선택하세요. 일반적인 실수 중 하나는 기본 모듈만 설치하여 컴파일 시 QCanBus 헤더 파일을 찾지 못하는 것입니다. 다음 명령어로 모듈의 존재 여부를 확인할 수 있습니다:

# Qt 설치 디렉토리에서 SerialBus 관련 라이브러리 검색
find /path/to/Qt -name "*serialbus*"

크로스 플랫폼 프로젝트의 경우, Linux(Ubuntu)와 Windows에 동일한 주 버전의 Qt를 설치하는 것이 좋습니다. 이를 통해 컴파일러나 라이브러리 버전 차이로 인한 문제를 최소화할 수 있습니다.

1.2 플랫폼 별 CAN 지원 계층 준비

CAN 통신의 핵심 차이는 하위 드라이버와 운영 체제 인터페이스에 있습니다. Qt는 이러한 차이를 플러그인 메커니즘으로 추상화하지만, 기본 시스템이 적절한 지원을 제공해야 합니다.

Linux (SocketCAN) 환경: SocketCAN은 Linux 커널이 제공하는 CAN 서브시스템으로, CAN 장치를 네트워크 인터페이스로 추상화합니다. 먼저 내장된 관련 모듈이 로드되어 있는지 확인하세요.

# CAN 관련 커널 모듈 확인
lsmod | grep can
# 일반적으로 can, can_raw, can_bcm, vcan 등의 모듈을 로드해야 합니다.
sudo modprobe can
sudo modprobe can_raw
sudo modprobe vcan

# 테스트용 가상 CAN 인터페이스 생성 (실제 하드웨어 필요 없음)
sudo ip link add dev vcan0 type vcan
sudo ip link set up vcan0
# 캐널 감시 도구(candump) 사용 (can-utils 설치 필요)
sudo apt-get install can-utils
candump vcan0

Windows (PeakCAN) 환경: Windows에는 통일된 CAN 인터페이스 표준이 없으므로, 일반적으로 하드웨어 공급업체가 제공하는 API에 의존합니다. 예를 들어 Peak System 하드웨어의 경우, 공식 웹사이트에서 PCAN-Basic API 드라이버와 개발 라이브러리를 다운로드하고 설치해야 합니다. 설치 후 pcanbasic.dll과 헤더 파일은 시스템 디렉토리에 위치하게 됩니다. Qt 프로젝트에서는 .pro 파일에서 해당 라이브러리를 올바르게 링크해야 합니다.

다음은 .pro 파일의 전형적인 설정 부분입니다:

# Windows에서 PeakCAN을 위한 설정
win32 {
    # PCAN-Basic 설치 기본 경로 가정
    INCLUDEPATH += "C:\Program Files\PEAK-System\Drivers\PCAN-Basic API\Include"
    LIBS += -L"C:\Program Files\PEAK-System\Drivers\PCAN-Basic API\Lib" -lPCANBasic
}

주의: 애플리케이션 배포 시 대상 머신에도 동일 버전의 PCAN-Basic 드라이버가 설치되어 있어야 합니다. 그렇지 않으면 플러그인이 로드되지 않습니다.

1.3 빌드 시스템의 통합 관리

크로스 플랫폼 차이를 효과적으로 처리하기 위해 Qt 프로젝트 파일(.pro)에서 **범위(scopes)**를 사용하여 조건부 설정을 추천합니다. 이렇게 하면 플랫폼 관련 설정을 집중 관리할 수 있으며, 코드를 명확하게 유지할 수 있습니다.

# 프로젝트 기본 설정
QT += core serialbus
CONFIG += c++17

# 플랫폼 특정 설정
linux {
    # Linux에서는 SocketCAN 사용, 추가 시스템 라이브러리 링크 불필요
    DEFINES += USE_SOCKETCAN
    # 여기에 Linux 특화 컴파일 옵션 추가 가능
}

win32 {
    # Windows에서는 PeakCAN 사용
    DEFINES += USE_PEAKCAN
    INCLUDEPATH += $$(PCAN_INCLUDE_PATH)
    LIBS += -L$$(PCAN_LIB_PATH) -lPCANBasic
    # 환경 변수 미설정 시 경고 메시지 출력
    !exists($$(PCAN_INCLUDE_PATH)/pcan.h) {
        message("경고: PCAN-Basic 개발 라이브러리가 없습니다. PCAN_INCLUDE_PATH와 PCAN_LIB_PATH 환경 변수를 설정하세요.")
    }
}

USE_SOCKETCAN 또는 USE_PEAKCAN 매크로를 정의하면 C++ 코드에서 #ifdef를 사용하여 Qt 플러그인으로 완전히 추상화할 수 없는 미세한 차이를 처리할 수 있습니다.

2. Qt CAN 플러그인 메커니즘 및 장치 생성

Qt SerialBus 모듈의 강력함은 그 플러그인 메커니즘에 있습니다.

태그: Qt CAN SocketCAN PeakCAN cross-platform

5월 30일 07:45에 게시됨

괴물 클럽

Qt를 이용한 CAN 버스 개발: SocketCAN에서 PeakCAN까지의 설정 가이드