업데이트 기준: 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노드 책임 분리 | 최신 기준 |
MKBD는 로컬 입력과 CAN 입력을 별도 상태로 관리하지 않는다. 두 입력은 모두 같은 SystemState를 변경한다.
MKBD 물리 입력
-> SystemState
CAN Request
-> SystemState
이 구조 덕분에 로컬 조작과 Head Unit 조작이 같은 상태 구조를 공유한다.
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 진입 |
CAN 통신은 하드웨어 계층과 Payload 처리 계층을 분리했다.
| 계층 | 역할 |
|---|---|
| CanDriver | MCP2515 또는 TWAI 송수신 |
| CanProtocol | 8바이트 Payload 생성/해석, Checksum 처리 |
| CanHandler | Payload 검증, SystemState 반영, Response 생성 |
| CanMonitor | Serial 로그 출력 |
Payload 처리 로직은 CAN 하드웨어에 직접 의존하지 않으므로 단위 테스트 대상으로 분리할 수 있다.
상태가 바뀔 때 전체 상태를 매번 보내지 않는다. 변경 전후 값을 비교해 실제로 바뀐 Signal만 송신한다.