v0.3 기준 업데이트

업데이트 기준: 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 표시 갱신 과정에서 확인한 내용을 기준으로 한다.

1. 엔코더 모듈 추가 후 빌드 오류

증상:

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 함수로 구분해 같은 파일에 합쳐져도 이름이 겹치지 않게 했다.

결과:

엔코더 입력 모듈 추가 후 빌드가 통과했다.

2. 엔코더 회전 입력 감도 문제