v0.3 기준 업데이트

업데이트 기준: 2026-06-30

설계 방향의 최신 기준은 노드 책임 분리다. v0.2가 MKBD와 HU32의 직접 상태 동기화에 초점을 뒀다면, v0.3은 Gateway를 추가해 입력 노드, 중계 노드, 표시 노드의 책임을 분리한다.

설계 축 v0.3 기준
MKBD 상태의 입력 원천, 로컬 표시/출력, CAN Broadcast
Gateway Payload 보존, Bus 간 중계, RX/TX 로그
Head Unit 수신 상태 캐시, FreeRTOS/LVGL HMI 반영
검증 MKBD 조작 -> Gateway 로그 -> Head Unit 화면 반영

버전 관리

버전 설계 방향 현재 상태
v0.1 기본 CAN 제어 재현 초기 단계
v0.2 MKBD-HU32 상태 동기화 중간 단계
v0.3 Gateway 포함 3노드 책임 분리 최신 기준

1. 입력 경로 통합

MKBD는 로컬 입력과 CAN 입력을 별도 상태로 관리하지 않는다. 두 입력은 모두 같은 SystemState를 변경한다.

MKBD 물리 입력
  -> SystemState

CAN Request
  -> SystemState

이 구조 덕분에 로컬 조작과 Head Unit 조작이 같은 상태 구조를 공유한다.

2. 모드별 입력 의미 분리

v0.2에서는 같은 물리 입력이라도 현재 화면 모드에 따라 다른 역할을 수행한다.

입력 DATC 모드 INFO 모드
Driver Encoder Driver 온도 조절 Volume 조절
Driver Encoder SW 예비/이벤트 입력 Mute
Passenger Encoder Passenger 온도 조절 HU 포커스 이동
Passenger Encoder SW 예비/이벤트 입력 HU 선택
기능 버튼 Fan / Wind / 화면 전환 Home / Map / Media 진입

3. 계층 분리

CAN 통신은 하드웨어 계층과 Payload 처리 계층을 분리했다.

계층 역할
CanDriver MCP2515 또는 TWAI 송수신
CanProtocol 8바이트 Payload 생성/해석, Checksum 처리
CanHandler Payload 검증, SystemState 반영, Response 생성
CanMonitor Serial 로그 출력

Payload 처리 로직은 CAN 하드웨어에 직접 의존하지 않으므로 단위 테스트 대상으로 분리할 수 있다.

4. 변경 Signal Broadcast

상태가 바뀔 때 전체 상태를 매번 보내지 않는다. 변경 전후 값을 비교해 실제로 바뀐 Signal만 송신한다.