업데이트 기준: 2026-07-01

1. 문서 목적

이 문서는 v0.3 Gateway Unit에서 발생할 수 있는 CAN 중계 문제를 증상별로 분리해 정리한다. 핵심 기준은 MKBD TX, Gateway RX, Gateway TX, Head Unit RX, HMI 반영 중 어느 단계에서 끊기는지 확인하는 것이다.

2. 기본 진단 순서

MKBD 입력 발생
  -> MKBD TX 로그 확인
  -> Gateway RX 로그 확인
  -> Gateway TX 로그 확인
  -> Head Unit RX 로그 확인
  -> Head Unit HMI 반영 확인

3. 증상별 원인과 조치

증상 가능 원인 확인 방법 조치
Gateway RX 로그가 없음 MKBD CAN 송신 실패, Bus A 배선 오류, bitrate 불일치 MKBD TX 로그, CANH/CANL, GND 확인 MKBD CAN Driver, 배선, 500 kbps 설정 확인
Gateway RX는 있으나 TX가 없음 중계 조건 미충족, Checksum/DLC 오류, Driver 송신 실패 Gateway RX/TX 로그 비교 DLC 8 여부, Checksum, TX Driver 상태 확인
Gateway TX OK이나 Head Unit RX 없음 Bus B 배선 오류, TWAI RX Pin 오류, Transceiver 전원 문제 Head Unit Serial Log, SN65HVD230 전원 확인 CANH/CANL, GND, TWAI TX/RX Pin 재확인
Head Unit RX는 있으나 HMI 미반영 Payload Signal 미처리, SystemState 미갱신, LVGL dirty flag 누락 Head Unit RX 로그와 UI 상태 비교 Signal Handler, SystemState, UI 갱신 조건 확인
Payload 값이 다름 Gateway에서 DATA 변경, Buffer 복사 오류 Gateway RX DATA와 TX DATA 비교 중계 로직에서 ID/DATA 보존 여부 확인
간헐적 수신 실패 종단저항, GND 불안정, CAN Bus 노이즈 반복 입력 로그, 물리 연결 확인 120Ω 종단, 공통 GND, 배선 길이/접촉 확인
Checksum 오류 D7 계산 불일치, Counter 포함 계산 범위 오류 D0~D6 XOR 재계산 CAN 명세서의 Checksum 규칙 재확인

4. 단계별 체크리스트

단계 체크 항목
전원 ESP32-S3, MCP2515, SN65HVD230/TJA1050 전원 확인
배선 CANH/CANL 교차 여부, 공통 GND, TX/RX Pin 방향 확인
속도 모든 노드 500 kbps 기준 확인
Frame Standard ID, DLC 8 확인
Payload D0~D7 값과 Checksum 확인
Log RX/TX 방향과 ID/DATA가 연속적으로 보이는지 확인
HMI Head Unit 수신 후 SystemState/LVGL 반영 확인

5. 디버깅

6. 버전 관리

버전 트러블슈팅 기준 관리 상태
v0.1 Gateway 없음, CAN 기본 송수신 중심 해당 없음
v0.2 MKBD-HU32 직접 연결 문제 중심 비교 기준
v0.3 MKBD-Gateway-Head Unit 3노드 분리 진단 현재 기준