🥕 CarrotPilot 시작 가이드

차량 연결부터 설정, 로그 분석까지. 이유를 이해하며 사용하는 carrot-wip 설명서.

2026.10 에디션 · 원본 설명서 전체를 복제한 뒤 현재 코드와 사용자 문서를 기준으로 개편했습니다. 원본 CarrotPilot 사이트는 그대로 유지합니다.

처음이라면 이 순서로

순서	할 일	바로 가기
01	내 차량·하네스·제어 방식 확인	차량 구성과 롱컨 이해하기
02	현재 설치 주소와 첫 실행 확인	설치와 첫 실행
03	휴대폰·PC에서 장치 열기	Carrot Web 사용법
04	설정을 저장하고 하나씩 이해하기	설정 지도 · 백업과 복원
05	이상 동작을 기록하고 분석하기	로그 전송 · 문제 해결

이번 설명서에서 달라진 것

• 설치 주소: 옛 tr16-e 예제 대신 현재 README의 i.carrotpilot.app/carrot-wip을 안내합니다.
• 설정 화면: CarrotMan·CarrotLink 대신 Carrot Web을 사용합니다. 접속은 http://장치-IP:7000입니다.
• 실제 동작 중심: 크루즈 버튼, 차간거리, 감속 소스와 레이더 모드를 구분합니다.
• 설정값의 의미: 기본값과 현재 값, 배율과 적용 조건을 나눠 설명합니다.
• 진단까지 연결: 화면녹화와 주행 로그의 차이, 업데이트·백업·지원 요청을 정리했습니다.

CarrotPilot은 무엇인가요?

openpilot 기반의 독립적인 운전자 보조 소프트웨어입니다. 현대·기아·제네시스(HKG)를 중심으로 개발되며, comma.ai가 공식 검토·승인·지원하는 배포판은 아닙니다. 지원 장치는 C3, C3X, C4이며 차종·연식·ECU·하네스에 따라 가능한 기능이 달라집니다.

carrot-wip은 rolling 개발 브랜치입니다. 업데이트마다 동작이 달라질 수 있으므로 장기간 고정된 안정판처럼 취급하지 않습니다. 지원 여부는 같은 차명보다 정확한 하드웨어 구성이 중요합니다.

자주 찾는 기능

궁금한 점	안내
버튼을 누르면 속도가 이상하게 바뀌어요	버튼·프리셋과 순정 SCC
앞차와 거리·출발감을 조절하고 싶어요	크루즈·차간거리
커브·카메라에서 왜 감속하나요?	속도·감속
차선변경 지연·조향감을 이해하고 싶어요	조향과 차로 변경
레이더에 점은 보이는데 앞차가 아니에요	레이더트랙·코너레이더
eGPU·Jetson 모델을 바꾸고 싶어요	Carrot Web의 모델 선택
DM 경고나 카메라 문제가 있어요	운전자 감시

읽기 전에 기억할 세 가지

1. 운전자가 계속 감독합니다. 전방·주변 상황을 직접 확인하고 언제든 제어할 준비를 합니다. 웹 설정과 로그 조작은 정차 후에 합니다.
2. 내 장치의 현재 값부터 저장합니다. 다른 차량의 튜닝이나 오래된 핀 배치를 그대로 적용하지 않습니다.
3. 확인된 것과 시험 중인 것을 구분합니다. 코드에 기능이 있다는 사실만으로 모든 차량에서 검증됐다는 뜻은 아닙니다.

문서 찾는 법

기존 설명서의 페이지 주소와 배선 자료를 유지해 예전 링크로도 찾아올 수 있습니다. 배선 페이지에는 과거 자료 표시와 현재 확인 절차를 추가했습니다. 각 페이지 아래의 고정 커밋 링크에서 이 설명서가 확인한 원문을 볼 수 있습니다.

---

문서 기준

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

README.md · docs/user/README.md · docs/user/ko/settings.md

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