🛠️ FAQ · 증상별 해결 순서

설정을 무작정 바꾸기 전에 증상과 현재 버전을 좁혀 보세요.

접속·설정

질문	먼저 할 일
Fleet이 열리지 않아요	현재 Carrot Web은 http://장치-IP:7000. 같은 네트워크·IP 확인
당근맨 APK는 어디 있나요?	현재 CarrotMan·CarrotLink는 사용자 연동으로 지원하지 않음. Carrot Web 사용
업데이트했는데 설정값이 옛날과 같아요	영구 설정은 유지될 수 있음. 카탈로그 기본값이 현재 값과 같다는 뜻은 아님
다른 사람과 기본값이 달라요	카탈로그 기본값 / Params 최초값 / 기존 저장값 / 차종을 구분
백업을 복원했는데 일부가 빠져요	복원 미리보기의 제외·무효 항목 확인. DM Enabled는 이동 대상이 아님

주행·입력

증상	확인할 항목
속도가 버튼 한 번에 크게 바뀜	CruiseButtonMode, CruiseSpeedUnitBasic, CruiseSpeedUnit
길게 누르는 단위가 내 설정과 다름	현재 가속·감속 길게 누르기는 내부 10km/h 격자
원하는 속도보다 계속 낮게 감속함	앞차·커브·카메라·경로 중 더 낮은 후보가 적용되는지 확인
차간 단계가 같은데 추종감이 다름	TF, 속도별 배율, 드라이브 모드, 추종응답성 확인
차선변경이 너무 빨리 시작함	LaneChangeNeedTorque, LaneChangeDelay와 방향지시등 요청 조건 확인
레이더 점이 보이는데 제동하지 않음	표시용 포인트와 제어용 선행차는 다름
HKG에서 Kp/Ki 조절이 안 보임	현 제어기는 공통 Kp 1.0 / Ki 0 고정, 해당 튜닝 미적용
충격 안내 뒤 제어가 안 켜짐	자동 Dashcam 전환 가능성. 주차 후 openpilot 사용 토글·재시작 확인

CAN·조향·제동 오류나 예상하지 못한 동작은 튜닝으로 가리기보다 해제하고 자료를 남깁니다.

업데이트 뒤 이상해졌을 때

1. 도구 > Info에서 브랜치와 커밋을 기록합니다.
2. 변경한 설정과 업데이트 전 값을 구분해 메모합니다.
3. 차량·하네스와 인식된 차종이 일치하는지 확인합니다.
4. 화면녹화와 문제 전후 로그를 준비합니다.
5. 특정 커밋 전환·reset이 필요하면 현재 코드 변경과 설정 백업을 먼저 확인합니다.

git sync, git reset, reset repo는 단순 새로고침이 아니며 로컬 변경을 잃을 수 있습니다.

지원 요청을 잘 쓰는 법

차량·연식·구성 / 장치 / 브랜치·커밋 / 발생 시각 / 실제 증상 / 운전자 개입 / 최근 바꾼 설정 / 로그 링크

예: “14:32경 80km/h, 우측 합류 차량 접근 때 급감속. 브레이크로 해제. 업데이트 후 처음 발생. 문제 앞뒤 세 구간 전송.”

로그 전송 절차 · 백업과 복원 · 네트워크 문제.

---

문서 기준

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

docs/user/ko/carrot-web.md · docs/user/ko/settings.md · docs/user/ko/buttons-presets.md · docs/user/ko/dashcam-log-sharing.md · openpilot/selfdrive/controls/lib/longcontrol.py

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