v0.3 기준 업데이트

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

MKBD 모듈 분리는 v0.3에서도 유지한다. 입력 처리, 상태 관리, 표시/출력, CAN 송신 계층을 분리해야 Gateway 추가 후에도 MKBD 쪽 책임이 명확해진다.

모듈 책임 v0.3 기준
Input 버튼/엔코더 이벤트 생성
App/SystemState 상태 변경과 Signal 판정
Display/Fan OLED와 Fan/PWM 로컬 반영
CAN 8바이트 Payload Broadcast 송신
Test Payload/상태/입력 단위 검증

버전 관리

버전 구조 현재 상태
v0.1 단일 스케치 중심 구현 보존
v0.2 입력/상태/표시/CAN 모듈 분리 보존
v0.3 Gateway 연동을 고려한 MKBD 책임 경계 유지 최신 기준

1. 분리 목적

MKBD는 입력 처리, 상태 변경, OLED 출력, Fan 제어, CAN 송수신을 모두 포함한다. 이를 하나의 .ino 파일에 몰아넣으면 기능 추가와 테스트가 어려워진다.

v0.2에서는 버튼 외에 로터리 엔코더와 HU32 메뉴 제어 Signal이 추가되었으므로, 입력 계층과 상태 처리 계층을 더 명확히 분리했다.

2. 현재 폴더 구조

MKBD/
  MKBD.ino
  GDS.h

  state/
    State.h
    State.cpp

  app/
    AppLogic.h
    AppLogic.cpp

  button/
    ButtonInput.h
    ButtonInput.cpp

  encoder/
    EncoderInput.h
    EncoderInput.cpp

  display/
    Datc.h
    Datc.cpp
    Info.h
    Info.cpp

  can/
    CanDriver.h
    CanDriver.cpp
    CanProtocol.h
    CanProtocol.cpp
    CanHandler.h
    CanHandler.cpp
    CanMonitor.h
    CanMonitor.cpp

3. 모듈별 역할

모듈 역할
MKBD.ino setup/loop, 각 모듈 조립, 하드웨어 초기화
GDS.h 핀, 범위, CAN ID, Signal, 주기 상수 관리
state SystemState 초기화와 문자열 변환
app 입력 이벤트를 상태 변경 로직에 연결
button 버튼 edge/debounce 처리
encoder 로터리 엔코더 방향/SW 입력 처리
display/Datc DATC 화면 출력과 공조 표시
display/Info INFO 화면 출력과 인포 표시
can/CanDriver MCP2515 송수신
can/CanProtocol Payload 생성/해석, Checksum 처리
can/CanHandler Request 검증, 상태 반영, Response 생성
can/CanMonitor CAN RX/TX 로그 출력

4. 데이터 흐름

MKBD 로컬 입력

Button / Encoder 입력
  -> ButtonInput / EncoderInput
  -> AppLogic
  -> SystemState 변경
  -> 변경 Signal Broadcast
  -> OLED / Fan 갱신

CAN 수신

MCP2515
  -> CanDriver
  -> CanProtocol
  -> CanHandler
  -> SystemState 변경
  -> Response / Broadcast 송신

HU32 제어 Signal