| name | raspi-can-bootstrap |
| description | 라즈베리파이 4(Raspberry Pi OS Bookworm)에 OBD2/CAN 진단 환경을 한 번에 깔아주는 스킬. Node.js 18 LTS, Claude Code, python-can, socketcan, USB-CAN 어댑터(slcan/canable) udev 규칙, aiohttp 의존성, 스왑 확장(4GB 미만 모델용)까지 부트스트랩 스크립트로 자동화한다. 사용자가 "라즈베리파이에 Claude Code 깔아줘", "Pi에 CAN 환경 세팅", "OBD2 raspi 부트스트랩", "raspi-can-bootstrap" 같은 요청을 할 때 호출한다. |
raspi-can-bootstrap
새 라즈베리파이 4 / 5 / Zero 2W에 차량 진단 PWA를 돌리는 데 필요한 모든 것을 설치한다.
전제
- Raspberry Pi OS (Bookworm 이상, 64-bit 권장)
- 인터넷 연결
- USB-CAN 어댑터(예: CANable, Lawicel, USB2CAN 호환) 또는 MCP2515 SPI 모듈
사용법
사용자에게 다음을 묻는다:
- Pi에 SSH 접속할 수 있는가? → 가능하면 SSH로 직접 실행, 아니면 스크립트만 전달
- CAN 어댑터 종류 —
slcan(serial CAN, USB 시리얼) / socketcan(MCP2515) / auto
- CAN 비트레이트 — 기본
500000 (대부분 승용차)
스크립트를 실행하려면:
bash scripts/bootstrap.sh
bash scripts/bootstrap.sh --bitrate 250000
현재 v0.1은 USB-CAN(slcan) 어댑터만 자동 셋업합니다. MCP2515 SPI 모듈을 쓰는 경우 SPI overlay 활성화와 dtoverlay=mcp2515-can0 설정이 추가로 필요합니다(스크립트가 처리하지 않음).
무엇을 설치하는가
| 영역 | 내용 |
|---|
| 시스템 패키지 | git, build-essential, python3-venv, python3-pip, can-utils, libnss3-tools, mkcert(소스 빌드) |
| Node.js | NodeSource를 통한 LTS 18.x — Claude Code 요구사항 |
| Claude Code | npm i -g @anthropic-ai/claude-code |
| Python | venv + python-can, cantools, aiohttp, numpy, pandas, matplotlib |
| 커널 모듈 | can, can-raw, slcan 자동 로드 (/etc/modules-load.d/can.conf) |
| 시스템 서비스 | slcan-attach.service — 부팅 시 USB-CAN 자동 연결 (can0) |
| udev 규칙 | CANable/Lawicel를 /dev/canable로 안정 매핑 |
| 스왑 | RAM 2GB 미만이면 자동으로 zram 1GB 추가 |
설치 후 검증
스크립트 마지막에 자동으로:
ip -s link show can0
cansend can0 7DF#02010D
candump can0 -n 50
node --version
claude --version
차량 연결 가이드
스크립트는 SW 환경만 만든다. 하드웨어 연결은 사람이:
- OBD2 케이블 (DB9 ↔ OBD2) → USB-CAN 어댑터 → Pi USB 포트
- 차량 시동 ON (엔진 ON 권장 — ACC만으로는 일부 ECU가 잠자고 있음)
cansend/candump로 통신 확인candump -L can0 > drive.log 로 드라이빙 로그 수집 → can-signal-hunter 스킬에 전달
실패할 수 있는 지점과 대응
| 증상 | 원인 | 대응 |
|---|
can0 안 뜸 | 어댑터 미인식 | `dmesg |
| 비트레이트 불일치 | 차량 CAN-C(125kbps)/CAN-FD | --bitrate 변경 후 재실행 |
getUserMedia 실패 | HTTPS 미사용 | car-noise-pwa-builder의 mkcert 가이드 참조 |
| Claude Code 설치 OOM | 1GB 모델 | 스왑 확장 (스크립트가 자동 처리) |
보안/안전 주의
- 차량과 연결된 Pi에 외부 인터넷 노출 금지 (LAN 또는 핫스팟만)
- ECU 쓰기 명령(diagnostic write, UDS write) 금지 — 본 스킬은 읽기 전용 환경만 구성
- Pi에서 차량 전원 직결 시 점화 OFF에서도 배터리 방전 가능 → ACC 라인 또는 별도 스위치 권장
참고 스크립트
scripts/bootstrap.sh — 메인 부트스트랩
