업데이트 기준: 2026-07-01

1. 문서 목적

이 문서는 v0.3에서 추가된 Gateway Unit의 기능 요구사항과 검증 기준을 정리한다. Gateway는 MKBD와 Head Unit 사이의 CAN Frame을 중계하며, 최종 포트폴리오에서는 MKBD 입력 -> Gateway RX/TX -> Head Unit HMI 반영 흐름을 증명하는 핵심 노드다.

2. 시스템 내 역할

항목 요구사항
위치 MKBD와 Head Unit 사이의 중계 노드
기본 책임 CAN Frame 수신, 로그 출력, 반대편 Bus 송신
데이터 정책 CAN ID, DLC, DATA[0..7] 의미를 변경하지 않음
검증 책임 RX/TX 로그로 Payload 보존과 전달 여부 확인
확장 책임 필터링, 진단, Wi-Fi/BT/OTA 연동의 기준 노드

3. 기능 요구사항

ID 요구사항 우선순위 검증 방법
GW-FR-01 Gateway는 MKBD 측 CAN Bus에서 Standard Frame을 수신해야 한다. 필수 MKBD 입력 후 Gateway RX 로그 확인
GW-FR-02 Gateway는 Head Unit 측 CAN Bus로 동일 CAN ID와 DATA를 송신해야 한다. 필수 Gateway TX 로그와 Head Unit RX 로그 비교
GW-FR-03 Gateway는 DLC 8 Payload를 기준으로 처리해야 한다. 필수 DLC 로그 및 비정상 DLC 테스트
GW-FR-04 Gateway는 D0~D6 XOR Checksum을 확인할 수 있어야 한다. 필수 정상/오류 Payload 로그 비교
GW-FR-05 Gateway는 RX/TX 방향, CAN ID, DATA, 송신 결과를 로그로 남겨야 한다. 필수 Serial Monitor 로그 확인
GW-FR-06 Gateway는 Payload 의미를 임의 변경하지 않아야 한다. 필수 입력 Payload와 출력 Payload 비교
GW-FR-07 Gateway는 향후 필터링 정책을 추가할 수 있는 구조여야 한다. 권장 중계 로직 분리 여부 확인
GW-FR-08 Gateway는 양방향 중계를 고려한 구조여야 한다. 권장 Bus A->B, Bus B->A 흐름 문서/코드 확인

4. 비기능 요구사항

ID 요구사항 기준
GW-NFR-01 가독성 RX/TX 로그는 사람이 Payload 흐름을 추적할 수 있어야 한다.
GW-NFR-02 유지보수성 Driver, Protocol, Routing, Log 책임을 분리한다.
GW-NFR-03 확장성 필터, 진단, OTA/Wi-Fi/BT 기능을 Gateway 책임으로 확장 가능해야 한다.
GW-NFR-04 안정성 비정상 Payload는 최소한 로그로 식별 가능해야 한다.
GW-NFR-05 포트폴리오 설명성 Gateway 추가 이유가 2노드 구조 대비 명확해야 한다.

5. 인터페이스 요구사항

인터페이스 요구사항
MKBD 측 CAN MCP2515/TJA1050 계열 Bus에서 Frame 수신
Head Unit 측 CAN TWAI/SN65HVD230 계열 Bus로 Frame 송신
Serial Log RX/TX 방향, CAN ID, DATA, Result 출력
Payload CAN 명세서의 8바이트 고정 규격 준수

6. 검증 시나리오

단계 입력/상황 기대 결과
1 MKBD Fan Up 입력 Gateway RX에 0x300 Fan Speed Payload 출력
2 Gateway 중계 Gateway TX OK 로그 출력
3 Head Unit 수신 Head Unit RX 로그의 ID/DATA가 Gateway TX와 일치
4 HMI 반영 Head Unit 하단바 또는 HVAC 화면 Fan 값 갱신
5 오류 Payload Checksum/DLC 오류가 로그로 구분됨

7. 버전 관리

버전 요구사항 기준 관리 상태
v0.1 Gateway 없음 해당 없음
v0.2 MKBD-HU32 직접 연결 비교 기준
v0.3 Gateway 중계 요구사항 신규 정의 현재 기준