업데이트 기준: 2026-06-30
MKBD 트러블슈팅은 v0.3에서도 유지하되, 문제 범위를 MKBD 단독 동작과 Gateway 경유 통신으로 나눠 본다. MKBD 로컬 출력이 정상인데 Head Unit 반영이 안 되면 Gateway RX/TX 로그를 먼저 확인한다.
| 증상 구분 | 확인 순서 |
|---|---|
| OLED/Fan 미반응 | MKBD 입력, SystemState, 출력 모듈 확인 |
| CAN 송신 미확인 | MKBD CAN Driver, Payload, Checksum 확인 |
| Gateway에는 RX, HU에는 미수신 | Gateway TX, Bus B 배선, Head Unit TWAI 확인 |
| HU 수신은 있으나 화면 미반영 | Head Unit SystemState, LVGL dirty flag 확인 |
| 버전 | 트러블슈팅 범위 | 현재 상태 |
|---|---|---|
| v0.1 | MKBD 단독 HW/입력 문제 | 보존 |
| v0.2 | MKBD-HU32 직접 CAN 연동 문제 | 보존 |
| v0.3 | MKBD-Gateway-HU 3노드 분리 진단 | 최신 기준 |
MKBD를 버튼 중심 입력 구조에서 로터리 엔코더 중심 입력 구조로 변경하면서 발생한 문제와 조치 내용을 정리한다. DATC/INFO 모드 전환, Driver/Passenger 엔코더 입력, CAN Broadcast 연동, OLED 표시 갱신 과정에서 확인한 내용을 기준으로 한다.
증상:
EncoderInput.cpp를 추가한 뒤 빌드 중 isFallingEdge() 재정의 오류가 발생했다.
error: redefinition of 'uint8_t isFallingEdge(uint8_t, uint8_t)'
ButtonInput.cpp: previously defined here
EncoderInput.cpp: redefinition here
원인 판단:
MKBD는 Arduino 빌드 특성 때문에 .ino 마지막에서 각 .cpp 파일을 직접 include하는 구조를 사용하고 있었다. ButtonInput.cpp와 EncoderInput.cpp 안에 같은 이름의 static isFallingEdge() 함수가 들어가면서 하나의 번역 단위 안에서 이름이 충돌했다.
조치:
버튼 입력과 엔코더 입력의 내부 helper 함수 이름을 분리했다. 버튼은 버튼 전용 edge 함수, 엔코더는 엔코더 전용 edge 함수로 구분해 같은 파일에 합쳐져도 이름이 겹치지 않게 했다.
결과:
엔코더 입력 모듈 추가 후 빌드가 통과했다.