🔬 Cabana · CAN 메시지 분석

Cabana는 원시 CAN 메시지를 살펴보고 DBC 신호를 해석하는 개발 도구입니다. 일반 설정 화면과 구분해서 사용합니다.

시작할 때 필요한 것

• 문제 시간대의 원본 로그
• 차종·연식·버스·하네스 정보
• 현재 브랜치와 커밋
• 해당 구성과 맞는 DBC

메시지가 존재한다는 사실만으로 신호 의미·차량 지원·배선 적합성이 확인되는 것은 아닙니다.

현재 코드의 사용 예

준비된 개발 환경에서 빌드된 cabana 실행 파일을 사용합니다. 소스는 저장소의 openpilot/tools/cabana입니다.

cabana --demo

cabana "<route-name>"

로컬 자료는 현재 도움말의 --data_dir, DBC 지정은 --dbc를 확인합니다. 로그 공개 보기 페이지가 제공하는 실행 명령도 사용할 수 있습니다.

같은 네트워크에서 CAN 보기

장치 셸:

cd /data/openpilot

./openpilot/cereal/messaging/bridge

PC의 Cabana:

cabana --zmq 장치-IP

현재 도움말에는 msgq·panda·socketcan·zmq 경로가 있습니다. 옛 문서의 --stream을 현재 모든 버전의 필수 인자로 사용하지 않습니다. 실행 파일의 --help와 현재 README가 우선입니다.

확인 순서

버스 → 메시지 주소 → 주기·카운터·체크섬 → DBC 해석 → 차량 상태와 시간 대조 순으로 봅니다. 이 문서의 예제는 읽기·분석이며 CAN 송신이나 ECU 쓰기를 수행하는 절차가 아닙니다.

수치 그래프는 PlotJuggler · 지원용 로그 준비.

---

문서 기준

2026-10-30 확인 · carrot-wip · 10bf0a56.

openpilot/tools/cabana/README.md · docs/user/ko/dashcam-log-sharing.md

개발 브랜치는 계속 변경됩니다. 내 장치의 브랜치·커밋·현재 설정을 함께 확인하세요.