🧭 설정 지도와 값 읽는 법

기존 당근맨 기본 설명 페이지를 현재 Carrot Web 설정 안내로 교체했습니다.

알아두기 이 문서는 carrot-wip 코드와 함께 관리하는 사용자 설명서 원본입니다. 사용자 동작이 바뀌면 관련 코드·테스트와 같은 변경에서 이 문서도 갱신합니다.

carrotpilot의 세부 설정은 Carrot Web에서 모두 확인하고 변경하는 것을 기준으로 합니다. 장치 자체의 기본 설정 화면은 Wi-Fi, 장치 정보, openpilot 기본 토글과 소프트웨어 업데이트에 사용하고, 아래에서 설명하는 carrot_settings.json의 파라미터는 Carrot Web의 설정 화면에서 관리합니다.

주행 중 가속도센서로 1.5g 이상의 수평 충격이 의심되면 경고와 10초 취소 안내를 표시합니다. 터치가 없으면 OpenpilotEnabledToggle을 꺼짐으로 저장하고 Dashcam 모드로 재부팅하며, 다시 켤 때까지 제어를 사용할 수 없습니다. 감지 조건·취소·복구와 녹화 공백을 확인하세요.

알아두기 현재 지원 상태

• 설정 변경에 사용하는 인터페이스: Carrot Web
• 당근맨(CarrotMan): 현재 사용자용 앱·외부 연동으로 지원하지 않음
• CarrotLink: 현재 지원하지 않음
• 예전 문서의 CarrotMan·CarrotLink 접속·설정 안내는 현재 사용 방법이 아님

코드나 메시지 내부에 carrotMan이라는 이름이 남아 있을 수 있지만, 사용자용 CarrotMan 앱을 지원한다는 뜻은 아닙니다.

Carrot Web 접속

1. comma 장치와 휴대폰 또는 PC를 같은 네트워크에 연결합니다.
2. 브라우저에서 http://장치-IP:7000을 엽니다.
3. 상단 메뉴에서 설정을 선택합니다.

예를 들어 장치 IP가 192.168.0.25라면 다음 주소를 사용합니다.

http://192.168.0.25:7000

접속 문제와 다른 화면의 설명은 Carrot Web을 참고하세요.

웹 화면 구성 기본값

도구 > Web Settings > 화면 구성의 처음 설치 기본값은 가로·세로 모두 영역 1 전체이며, 영역 1은 당근비전, 영역 2는 당근네비입니다. 기본값 버튼은 두 방향을 모두 영역 1 전체 + 영역 1 당근비전 + 영역 2 당근네비로 되돌립니다. 화면별 설명은 Carrot Web 화면 구성을 참고하세요.

설정 화면 사용법

Carrot Web 설정 화면에서는 다음 기능을 사용할 수 있습니다.

• 분류 탐색: 대분류, 중분류, 세부 구역 순서로 설정을 찾습니다.
• 검색: 화면 제목이나 파라미터 이름으로 원하는 항목을 찾습니다.
• 즐겨찾기: 설정 항목을 길게 눌러 추가하거나 제거합니다.
• 프로필: 현재 설정 묶음을 이름을 붙여 저장하고 다시 적용합니다.
• 설정 비교: 프로필이나 백업의 값과 현재 값을 비교한 뒤 적용합니다.
• 초기화: 전체 설정을 카탈로그 기본값으로 되돌립니다.
• 파일·QR 백업: 도구 화면에서 설정을 보관하거나 복원합니다.

전체 초기화나 다른 차량의 백업 적용은 많은 값을 한꺼번에 바꿉니다. 먼저 현재 설정을 별도 프로필과 파일로 보관하세요.

항목별 상세 설명

설정 항목의 값 조절 부분을 제외한 본문을 누르면 해당 항목의 상세 화면으로 이동합니다. 기존 설정 박스 아래의 정보 박스에는 설명, 인기값, 이력 탭이 항상 표시되며 설명이 기본으로 열립니다. 데이터가 없는 탭도 사라지지 않고 빈 상태를 표시합니다.

• 설명은 GitHub에서 검증·게시된 현재 언어의 설정 설명을 우선 표시합니다.
• 게시 인덱스와 설명 페이지의 해시가 모두 맞는 내용만 표시합니다.
• 요청이 실패하거나 내용이 올바르지 않으면 마지막으로 검증된 브라우저 저장본을 사용합니다.
• 검증된 원격 정상본이나 저장본이 없으면 장치 내부 문서로 대체하지 않고 빈 상태를 표시합니다.
• 인기값은 수집된 차량의 값 분포를 참고용으로 표시하며 권장값을 뜻하지 않습니다.
• 이력은 최근 변경 3건을 먼저 표시하고, 기록이 더 있으면 전체 이력을 열 수 있습니다.
• 네트워크나 문서 처리에 문제가 생겨도 설정값 확인·변경 기능은 계속 사용할 수 있습니다.
• Carrot Web이 한국어이면 한국어 원문, 영어이면 영어 원문을 표시합니다.
• 중국어 상세 원문이 아직 없으면 중국어 제목·짧은 설명은 유지하고 상세 설명만 영어로 표시합니다.
• GitHub Wiki의 우측 사용 설명서 > 설정 이해하기 > 전체 설정에서는 Carrot Web과 같은 한국어 메뉴 계층·순서로 개별 설정 페이지를 찾을 수 있습니다. 중앙 전체 설정 문서에서는 한국어·영어·중국어 목록을 함께 제공합니다.

가로·세로 화면 모두 기존 설정 박스 다음에 정보 박스가 세로로 이어집니다. 배율과 기본값 버튼의 위치와 동작은 기존 설정 박스 안에서 유지됩니다.

검증된 게시 설명은 현재 설정 코드의 기본값·범위·선택지를 기준으로 작성됩니다. 화면의 짧은 설명과 상세 설명이 다르면 현재 브랜치의 설정 코드와 함께 문제를 확인하세요.

숫자와 기본값 읽는 법

carrot_settings.json의 각 항목에는 다음 정보가 들어 있습니다.

필드	의미
name	코드와 Params에서 사용하는 고유 이름
title	Carrot Web에 표시되는 한국어 제목
descr	값의 방향, 모드 번호와 주의사항
min / max	입력 가능한 범위
unit	+와 - 버튼으로 한 번에 움직이는 단위
default	설정 카탈로그가 사용하는 초기 기준값

현재 값이 가장 우선입니다

2026 스타리아 EV는 차량 선택에서 Hyundai Staria EV 2026을 사용합니다. 기존 스타리아 선택은 자동 변경되지 않으며, HDA2·카메라 SCC 설정은 차량 배선에 맞춰 별도로 확인합니다. 차량 선택 안내를 참고하세요.

업데이트 후에도 장치에 저장된 영구 설정은 유지될 수 있습니다. JSON의 default, 제목 괄호 안 숫자, 다른 사용자의 설정값보다 내 장치의 Carrot Web에 표시된 현재 값을 먼저 기록하세요.

default는 모든 차량에 권장되는 튜닝값이라는 뜻이 아닙니다. 차종 기본 튜닝, 기존 Params와 브랜치에 따라 실제 시작값이 다를 수 있습니다.

배율과 단위를 확인합니다

표시 예	저장값	실제 의미
TFollowGap1 x0.01s	110	1.10초
SteerActuatorDelay	30	0.30초
LateralTorqueAccelFactor x0.001	2500	2.500
StopDistanceCarrot	600	6.00m(600cm) 기준 값
비율 %	105	105%

항목 이름과 설명에 적힌 x0.01, x0.001, cm, km/h, %를 생략하면 값의 크기를 잘못 이해할 수 있습니다.

현재 코드의 설정 지도

이 커밋의 설정 카탈로그에는 204개 파라미터 정의가 있습니다. 메뉴 안에서 중복 참조되거나 검색 전용인 항목이 있어 메뉴 합계와 같지는 않습니다. 원문 문서의 과거 개수 대신 실제 JSON을 기준으로 확인했습니다.

주행 제어

• 시작·오토 — 시작 동작 · 오토크루즈
• 버튼·프리셋 — 버튼 모드 · 속도 단위 · 버튼 테스트 · 속도 프리셋
• 차량 조향 — ONNX 차선·BSD · 중앙 보정 · 조향감 · 차로 변경 (자동 턴) · 레인모드 · 고급 토크
• 속도·감속 — 과속카메라 · 제한속도 · 방지턱 · 커브·턴 · 신호감지
• 크루즈·차간 — 가속 성향 · 정차·재출발 · 가감속 튜닝 · 차간거리 · 당근 크루즈

차량·하드웨어

• 현대·기아
• CANFD·HDA
• 레이더
• 운전자 모니터링
• 차량 보조
• 기기 하드웨어

화면 표시

• 정보 표시
• 경로 표시
• 밝기·주행화면
• 외부 HUD — 기본 · 화면·카메라 · 레이더 표시 · 성능·디버그

시스템

• 녹화·전원 — 녹화·전원
• 카메라
• 네트워크·지도
• 사운드
• 소프트웨어

목적별로 읽기

바꾸고 싶은 것	자세한 안내
버튼과 속도 단계	버튼·프리셋
가속·정차·추종거리	크루즈·차간
카메라·커브·경로 감속	속도·감속
조향·차선변경	조향과 차로 변경
레이더 입력과 실험 모드	레이더
감시 카메라와 경고	운전자 감시

한 항목을 바꾸는 기록법

1. 현재 값·단위·브랜치·커밋을 남깁니다.
2. 바꾸려는 증상을 하나로 정합니다.
3. 적용 차종과 재시작 필요 여부를 확인합니다.
4. 하나만 변경하고 차이를 관찰합니다.
5. 예상과 다르면 원래 값으로 복원하고 문제 시각을 기록합니다.

화면·밝기와 차량 CAN·제어 설정은 영향이 다릅니다. 인기값은 다른 사용자의 분포이며 내 차량 권장값이 아닙니다.

전체 설정 상세 원문 · 현재 설정 카탈로그

---

문서 기준

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

docs/user/ko/settings.md · openpilot/selfdrive/carrot_settings.json · openpilot/common/params_keys.h

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