Vector 드라이버 트러블슈팅 — 버전 미스매치와 Network 모드 불가

# Vector 드라이버 트러블슈팅 — 버전 미스매치와 Network 모드 불가

## 가장 흔한 두 가지 문제

Vector 장비를 처음 쓰거나 오래 방치했다 다시 꺼내면 비슷한 문제를 겪는 경우가 많다. 원인은 보통 두 가지다.

1. **드라이버 버전 ≠ 펌웨어 버전** (버전 미스매치)
2. **구형 장비에서 Network-based 모드 미지원**

## 버전 미스매치란

Vector 장비는 두 가지 버전을 동기화해야 한다.

| 구분 | 위치 | 설명 |
|------|------|------|
| **드라이버 버전** | PC | 설치된 XL-Driver 버전 |
| **펌웨어 버전** | 장비 내부 | 장비 자체에 내장된 소프트웨어 |

드라이버를 업데이트했는데 장비 펌웨어가 구버전이면, 또는 반대로 장비가 최신인데 PC 드라이버가 오래됐으면 통신이 정상적으로 안 되거나 기능이 비활성화된다.

**증상**:
- CANoe/CANape에서 채널이 잡히지 않음
- 장비를 연결해도 인식이 안 됨
- 특정 기능(FD, Ethernet 등)만 작동 안 함

**확인 방법**: Vector Hardware Config 툴을 열면 드라이버 버전과 연결된 장비 펌웨어 버전을 모두 확인할 수 있다. 둘이 맞지 않으면 경고 메시지가 뜬다.

## Network-based 모드 미지원 장비

이전에 구매한 구형 Vector 장비 중 일부는 하드웨어 자체가 Network-based 이더넷 모드를 지원하지 않는다. 소프트웨어로 해결되는 문제가 아니라 하드웨어 제한이다.

**증상**:
- Network-based 모드 선택 시 채널이 활성화되지 않음
- API 호출이 실패하거나 에러 반환

## 해결 방법

두 문제 모두 **Vector 공식 서포트 KB**에 해결 가이드가 있다.

> Vector Support KB: [KB0012585](https://support.vector.com/kb?id=kb_article_view&sysparm_article=KB0012585)

이 KB에서 확인할 수 있는 것:
- 드라이버-펌웨어 버전 매칭 표
- 펌웨어 업데이트 절차
- Network-based 모드 지원 장비 목록
- 구형 장비 업그레이드 가능 여부

## 버전 미스매치 예방 수칙

```
1. XL-Driver 버전 업그레이드 시 장비 펌웨어도 함께 업그레이드
2. 여러 PC에서 같은 장비를 쓴다면 드라이버 버전을 통일
3. 새 프로젝트 시작 전 Hardware Config에서 버전 상태 확인
4. 업그레이드 전 현재 버전 메모 → 문제 발생 시 롤백 가능하도록
```

## 추가 트러블슈팅 케이스

현장에서 Vector 장비 관련해 자주 겪는 케이스를 더 정리한다.

### Bus Off 상태에서 복구 안 됨

MCU가 Bus Off 상태가 됐는데 코드를 바꾼 것도 없는데 계속 Bus Off로 뜨는 경우가 있다.

**원인**: Bus Off에 빠진 MCU가 복구 절차를 자동으로 수행하지 않도록 설정됐거나, 복구 후 다시 Bus Off로 빠지고 있는 것이다.

**확인 방법**: CANoe Error Frames 로그를 켜고 버스를 모니터링한다. 어떤 노드가 에러 프레임을 반복 발생시키는지 ID로 식별한다.

**해결**: `CAN_MCR` 레지스터의 `ABOM` 비트를 켜거나(STM32 기준), 소프트웨어에서 명시적으로 `HAL_CAN_ResetError()` + `HAL_CAN_Start()`를 호출해 복구한다.

### 채널이 열리지 않음 — XL_ERR_NO_ACCESS

XL-Driver 코드에서 `xlOpenPort` 호출 시 `XL_ERR_NO_ACCESS`가 반환되는 경우.

**원인**: Vector Hardware Config에서 애플리케이션 채널 매핑이 없거나, 동일한 채널을 다른 프로세스(CANoe 등)가 이미 점유 중인 것이다.

**해결**: Hardware Config에서 매핑을 확인하고, CANoe/CANape 등 다른 Vector 툴을 먼저 종료한다.

### CAN FD 메시지가 깨짐

CAN FD로 전환했는데 데이터가 깨지거나 BRS(Bit Rate Switch) 에러가 발생하는 경우.

**원인**: Data Phase의 Bit Timing이 잘못 설정됐거나, 버스에 CAN FD를 지원하지 않는 구형 노드가 혼재하는 것이다.

**확인**: CAN FD를 지원하는 노드만 버스에 남기고 테스트한다. 구형 노드가 반드시 필요하다면 FD 전용 버스를 분리하거나 Gateway를 두는 구조를 고려한다.

### TX 큐가 가득 참 — XL_ERR_QUEUE_IS_FULL

빠른 속도로 `xlCanTransmit`을 반복 호출하면 TX 큐가 가득 차 이 에러가 발생한다.

**해결**:
- `xlOpenPort` 호출 시 TX 큐 크기(`txQueueSize` 파라미터)를 키운다
- 전송 전에 `xlGetEventQueueSize()`로 큐 여유 공간을 확인하는 로직을 추가한다
- 전송 속도를 조절하거나 ACK를 받은 뒤 다음 패킷을 보내는 흐름 제어를 구현한다

## 마무리 — CAN 개발 전체 그림

이 시리즈를 통해 다음 순서로 CAN 개발을 연결할 수 있게 됐다.

```
CAN 프레임 (개요)
  → Bit Timing 설정 (타이밍)
    → 트랜시버 회로 (하드웨어)
      → Vector 드라이버 선택 (PC 인터페이스)
        → XL-Driver 설정 (API 연동)
          → 트러블슈팅 (현장 대응)
```

CAN은 30년 넘은 기술이지만 개발 환경은 계속 발전하고 있다. CAN FD가 기본이 되는 프로젝트도 늘고, Automotive Ethernet과 혼재하는 아키텍처도 많아졌다. 기초를 제대로 쌓으면 새로운 레이어가 추가될 때도 빠르게 흡수할 수 있다.

Vector 드라이버 트러블슈팅 — 버전 미스매치와 Network 모드 불가

// COMMENTS

ON THIS PAGE