carrotpilot 사용 설명서

carrotpilot을 처음 접하는 사용자부터 설정과 주행감을 조정하려는 사용자까지 함께 볼 수 있는 한국어 설명서입니다.

이 Wiki는 ajouatom/openpilot의 carrot-wip 브랜치를 기준으로 작성합니다. 기존 문서의 내용을 그대로 복사하지 않고, 현재 코드와 화면에서 확인되는 기능을 우선 설명합니다.

[!CAUTION] carrotpilot은 운전자를 대신하지 않는 연구·실험용 운전자 보조 소프트웨어입니다. 항상 전방과 주변 상황을 직접 확인하고 즉시 제어할 준비를 해야 합니다. 차량 장착이나 사용 전에는 거주 지역의 법규와 보험 조건을 직접 확인하세요. 하네스 또는 차량 배선 작업은 잘못하면 차량 안전 기능에 영향을 줄 수 있습니다.

어디서 시작할까요?

상황	먼저 읽을 문서
새 장치에 처음 설치한다	처음 설치
내 차의 하네스 위치와 장착 방식을 확인하고 싶다	차량별 장착과 하네스
설치는 끝났지만 무엇을 확인할지 모르겠다	최초 설정과 점검
설정 항목이 너무 많다	설정 이해하기
차로 변경이 언제 시작되고 무엇을 조절할 수 있는지 알고 싶다	차로 변경 이해하기
휴대폰이나 PC에서 장치를 관리하고 싶다	Carrot Web
이상 동작 로그를 보내고 싶다	대시캠 분석 로그 전송
조향·가감속 느낌을 조절하고 싶다	튜닝 입문
문제가 생겼다	자주 묻는 질문

carrotpilot이란?

carrotpilot은 openpilot을 기반으로 하며 다음과 같은 사용자 기능을 확장한 프로젝트입니다.

• 현대·기아 차량을 포함한 여러 차량의 운전자 보조 제어
• 주행 모드, 조향, 차간거리, 감속과 화면 표시를 조절하는 세부 설정
• 같은 네트워크의 브라우저에서 설정, 상태, 로그와 도구를 사용하는 Carrot Web

현재 사용자 설정은 Carrot Web을 기준으로 하며, 당근맨(CarrotMan)과 CarrotLink는 지원하지 않습니다.

지원 범위와 동작 방식은 차량, 하네스, 순정 ACC 사용 여부, 브랜치에 따라 달라집니다. 다른 사용자의 값을 그대로 적용하기보다 현재 차량 구성을 먼저 확인해야 합니다.

이 문서가 따르는 원칙

• 기능 설명의 기준은 carrot-wip의 현재 코드입니다.
• 설치와 튜닝은 초보자가 되돌릴 수 있는 순서로 설명합니다.
• 차량별로 검증되지 않은 값을 보편적인 권장값처럼 제시하지 않습니다.
• 화면 이름과 파라미터 이름을 함께 적어 검색과 문제 보고가 가능하게 합니다.
• 코드가 바뀌면 관련 문서와 검증 기준도 함께 갱신합니다.

설정과 코드 동작 설명서는 carrot-wip 코드 안에서 한국어와 English를 같은 주제의 문서 쌍으로 관리합니다. Wiki는 설치 사례와 문서 탐색을 맡고, 코드 동작의 상세 설명은 이 원본으로 연결합니다.

이 Wiki는 아직 첫 번째 골격입니다. 우선 설치, 기본 설정, 안전한 튜닝 절차와 FAQ를 제공하며 차량별 상세 안내와 전체 설정 사전은 차례로 추가할 예정입니다.