🌐 Carrot Web · 장치 관리의 중심

예전 Fleet을 찾고 있다면 이 페이지부터 보세요. 현재 관리 화면의 주소는 :7000입니다.

Carrot Web은 carrotpilot 장치와 같은 네트워크에 연결된 휴대폰·태블릿·PC에서 주행 상태를 확인하고 설정, 로그, 업데이트와 진단 기능을 사용하는 로컬 웹 화면입니다.

주의 운전 중에는 Carrot Web을 조작하지 마세요. 설정 변경, 로그 선택, 터미널 명령과 도구 실행은 안전한 곳에 정차한 뒤 수행해야 합니다.

접속하기

1. 장치와 브라우저를 실행할 기기를 같은 Wi-Fi 또는 핫스팟에 연결합니다.
2. carrotpilot 장치의 IP 주소를 확인합니다.
3. 브라우저 주소창에 http://장치-IP:7000을 입력합니다.

예: http://192.168.0.25:7000

장치 화면에서 흰색 당근 아이콘을 누르면 현재 주소의 QR 코드가 크게 표시됩니다. C3에서는 왼쪽 아래 버튼, C4에서는 아래쪽 상태 아이콘 줄에서 누릅니다. 같은 네트워크의 휴대폰으로 QR 코드를 스캔하면 바로 접속할 수 있으며, 장치 IP가 바뀌면 열린 QR 코드와 주소도 자동으로 갱신됩니다. 긴 주소는 생략되지 않고 화면 폭에 맞게 글자 크기가 조절됩니다. 주소 아래에는 마지막 QR 갱신 시각이 시:분:초 숫자로 표시되고, 오른쪽에는 30초 자동 닫힘 카운트다운이 표시됩니다. QR 화면은 누르면 닫히고, 조작하지 않아도 카운트다운이 끝나면 자동으로 닫힙니다.

Carrot Web은 로컬 장치 관리 화면입니다. 인터넷에 직접 노출하거나 신뢰하지 않는 사람에게 주소, 원격 지원 링크 또는 터미널 접근 권한을 제공하지 마세요.

화면 한눈에 보기

화면이 넓으면 왼쪽 탐색 막대, 세로형 휴대폰에서는 아래쪽 탐색 막대로 표시될 수 있습니다.

화면	주 용도
주행	실시간 전방 영상, HUD와 주행 정보, 화면녹화 시작·중지, 저장 로그 리플레이
설정	carrotpilot·장치 설정, 검색, 즐겨찾기, 프로필과 변경 이력
도구	차량 선택, 언어, 웹 화면 구성, Git 관리, 백업·복원과 시스템 작업
로그	대시캠 주행 로그, 구간 재생·분석·전송, 화면녹화 재생·다운로드
터미널	장치 터미널과 제한 시간 원격 지원 세션

장치 종류, 주행 상태, 선택한 브랜치와 브라우저 기능에 따라 일부 버튼이나 콘텐츠가 표시되지 않을 수 있습니다.

주행 화면

주행 화면은 실시간 영상과 주행 상태를 보는 곳입니다. 기본 구성은 전방 영상과 보조 정보 영역이며, 도구 > Web Settings에서 화면 분할 방향, 표시 영역과 콘텐츠를 조정할 수 있습니다.

실시간 영상과 HUD

CarrotVisionEnabled를 켜면 외부 HUD를 사용하는 동안에도 웹 카메라뷰를 시작할 수 있습니다. 동시 영상 사용은 기기 부하를 높일 수 있으며, 영상이 끊기면 웹 카메라뷰를 중지해 비교하세요.

• 주행 비전 시작을 누르면 카메라 스트림 연결을 시작합니다.
• 영상 위 HUD에는 차량 속도, 설정 속도, 제한속도, 차간거리, 선행차와 주행 경고가 표시될 수 있습니다.
• AR 표시는 도구 > Web Settings에서 켜거나 끕니다.
• 같은 영상 스트림을 다른 브라우저가 사용 중이면 다른 기기에서 사용 중이 표시될 수 있습니다. 정말 현재 브라우저로 옮길 때만 여기서 사용을 선택하세요.
• 장치가 주차 상태이거나 카메라·주행 데이터가 준비되지 않았으면 대기 안내가 표시됩니다.

HUD와 웹 영상은 참고 화면입니다. 차량의 실제 경고와 전방 상황을 우선 확인하세요.

주행 경로의 차간거리 바와 25 m 표시는 동적 보정이 반영된 현재 추종 목표거리입니다. 앞차의 실측거리와는 다르며, 유효한 앞차가 없으면 숨깁니다. 자세한 내용은 차간거리 설정을 참고하세요.

AR 표시와 진단

• 도구 > Web Settings의 AR 표시를 켜면 Carrot Vision 영상 위에 당근내비 주행 안내를 표시하고, 켜진 동안에만 카메라 자세·위치 등 추가 실시간 데이터를 요청합니다.
• AR 디버그는 표지·앵커·렌더 수와 현재 차단 사유를 보여 주며, 진단 이력을 복사하거나 파일로 저장할 수 있습니다.
• 리플레이 이벤트 타임라인은 당근내비 연결, 현재·다음 회전 안내, 권장 차선, 도로 안전 안내, 구간단속, 신호와 교차로 안내의 기록된 변화를 구분합니다.

화면 구성

도구 > Web Settings > 화면 구성에서 다음을 정합니다.

• 가로 또는 세로 분할
• 분할 화면, 영역 1 전체, 영역 2 전체
• 각 영역에 표시할 전방 영상 또는 지원되는 보조 콘텐츠
• 두 영역 콘텐츠 맞바꾸기

처음 설치한 기기는 가로·세로 모두 영역 1 전체로 시작합니다. 영역 1은 당근비전, 영역 2는 당근네비라서 주행 화면에는 당근비전이 전체 화면으로 보입니다. 분할로 바꾸면 가로는 영역 1 70%·영역 2 30%, 세로는 50%씩 나뉩니다.

기본값 버튼은 가로·세로 화면 구성을 영역 1 전체 + 영역 1 당근비전 + 영역 2 당근네비로 되돌립니다.

사용할 수 없는 콘텐츠는 대기·복구·지원되지 않음 상태로 표시됩니다. 화면 구성을 바꾸어도 차량 제어 방식 자체는 바뀌지 않습니다.

화면녹화 시작과 중지

주행 화면의 Record 버튼은 장치의 ScreenRecord 상태를 켜고 끕니다.

1. Record를 눌러 녹화를 시작합니다.
2. 주행 탐색 버튼에 REC 표시가 나타나는지 확인합니다.
3. 필요한 장면을 기록한 뒤 Record를 다시 눌러 종료합니다.
4. 로그 > 화면녹화에서 저장된 파일을 재생하거나 다운로드합니다.

화면녹화는 화면에 보인 현상을 설명하는 데 유용하지만, 차량 제어 분석에 필요한 원본 주행 로그를 대신하지는 않습니다. 이상 동작 분석에는 분석용 대시캠 로그 전송을 사용하세요.

저장된 주행 리플레이

로그 > 대시캠에서 구간 메뉴의 리플레이를 선택하면 저장된 전방 영상과 당시 주행 데이터를 주행 화면에서 함께 볼 수 있습니다. 이전·다음 구간 이동, 재생 속도, HUD, 이벤트·그래프·센서·원본 로그 분석 기능은 기록에 포함된 데이터와 브라우저 지원 여부에 따라 달라집니다.

실제 주행이 시작되면 안전을 위해 저장 로그 리플레이가 종료될 수 있습니다.

설정 화면

설정 화면은 디바이스와 당근파일럿 탭으로 나뉩니다.

• 그룹을 선택한 뒤 항목을 눌러 값을 바꿉니다.
• 설정 이름이나 설명을 검색할 수 있습니다.
• 설정 항목을 길게 눌러 즐겨찾기에 추가하거나 제거할 수 있습니다.
• 프로필은 여러 설정값을 묶어 저장하고 선택적으로 다시 적용합니다.
• 항목 상세 화면에서 인기값, 최근 변경 이력과 검증된 Wiki 상세 설명을 확인할 수 있습니다.
• 일부 위험 설정은 경고가 표시되며 재부팅 뒤 적용될 수 있습니다.
• 메뉴의 설정 초기화는 여러 값을 기본값으로 되돌리므로 현재 설정을 먼저 백업하세요.

각 항목의 범위, 단위와 튜닝 순서는 설정 이해하기를 참고하세요.

도구 화면

도구 화면은 실행 즉시 장치 상태나 저장소를 바꿀 수 있는 관리 기능을 모아 둔 곳입니다. ONNX 차선·BSD 인식은 도구 바로가기가 아니라 설정 → 주행 제어 → 차량 조향 → ONNX 차선·BSD에서 관리합니다.

Jetson 연결·IP·온도 확인

Jetson 통합 이후 carrot-wip에서는 도구 → eGPU 상태 카드에 연결된 Jetson의 IP, 온도와 현재 연결/오류 상태도 표시합니다. eGPU를 사용한 적이 없어도 Jetson 상태를 볼 수 있습니다. Carrot Web 접속 주소는 콤마 IP이며, 카드 안의 Jetson IP는 Jetson 관리 접속 주소입니다. 오래된 온도나 주소는 현재 값처럼 표시하지 않으므로 값이 없으면 최신 정보를 기다리는 상태인지 확인합니다.

정상적으로 Jetson 없이 내부 모델을 사용하는 대기 상태와, 활성 추론 중 연결이 끊기거나 실제 오류·고온이 발생한 경우를 구분합니다. 표시를 없애려고 실제 오류를 무시하거나 설정을 바꾸지 마세요. Jetson만 연결된 경우 eGPU 모델 컴파일 버튼은 사용하지 않습니다.

처음 설치한다면 한글 설치 안내를 따라 설치 ZIP을 풀고 01·02 배치 파일을 실행합니다. 이미지 준비와 USB-C 수정은 자동입니다. Wi-Fi는 연결된 콤마에서 전달받으며 SSID·비밀번호 변경 때문에 SD카드를 꺼낼 필요는 없습니다. P단에서 지도 대신 주행 요약을 보여 주는 현재 동작은 유지됩니다. 설치 경로별 실물 검증 범위는 안내의 시험판 표시를 확인하세요.

빠른 작업

• Car Select: 차량 제조사와 모델을 선택합니다.
• 2026 스타리아 전기차는 Hyundai Staria EV 2026을 선택합니다. 기존 Hyundai Staria 2023과 가속페달·기어 해석이 다르며 자동으로 선택이 바뀌지 않습니다. 선택 후 재부팅하고 정차 상태에서 기어·페달 표시와 CAN 오류를 확인합니다.
• Language: Carrot Web 언어를 변경합니다.
• Web Settings: 주행 화면 구성, 영상·HUD·AR와 웹 전용 표시 옵션을 변경합니다.
• Info: 장치 종류, 브랜치, 커밋, 식별 정보와 네트워크 정보를 확인·복사합니다.

Git Commands

• git pull: 현재 브랜치의 새 커밋을 가져옵니다.
• git sync: 원격 브랜치와 동기화합니다. 로컬 변경이 정리될 수 있습니다.
• git reset: 선택한 기준으로 코드 변경을 되돌립니다.
• git log: 커밋 기록을 보고 특정 커밋·브랜치로 전환하는 데 사용합니다.
• change branch: 로컬 또는 원격 브랜치를 선택합니다.
• reset repo: 저장소 연결과 브랜치를 강제로 초기화합니다.

주의 git sync, git reset, reset repo는 로컬 코드 변경을 잃게 할 수 있습니다. 의미를 모르면 실행하지 말고, 지원 요청 시 현재 브랜치와 커밋만 Info에서 확인하세요.

User / System

• Reset Calib: 카메라 보정값을 초기화하고 다시 보정하게 합니다.
• capture tmux: 현재 tmux 로그를 파일로 캡처해 브라우저로 다운로드합니다.
• send tmux: 서버 로그 전송을 요청합니다.

차량 CAN 통신 오류는 현재 온로드에서 새로 수신 중인 carState 또는 radarState가 실제 오류를 보고할 때만 tmux 진단 로그를 자동 전송합니다. 이전 주행 종료 때 남은 timeout은 사용하지 않으며, 오류 확인 후 5초를 기다려 후속 로그까지 캡처합니다. 자동 전송 로그의 CarrotException can_error queued는 오류 원인이 아니라 진단 로그 전송이 예약되었다는 표시이며, 바로 앞의 current onroad CAN error detected from ...에서 판정 소스를 확인할 수 있습니다.

• install required: Carrot Web 부가기능에 필요한 패키지를 확인·설치합니다.
• delete all videos: 화면녹화 파일을 삭제합니다.
• delete all logs: 저장된 주행 로그를 삭제합니다.
• Rebuild All: 전체 빌드와 재시작을 수행합니다.
• reboot: 장치를 재부팅합니다.

로그나 영상을 삭제하면 Carrot Web에서 재생하거나 분석용으로 전송할 수 없습니다. 분석 요청이 예정되어 있으면 전송 완료를 먼저 확인하세요.

Settings 백업과 복원

• 파일 백업·복원
• QR 백업·복원
• 설정값 복사와 전체 값 보기

복원하기 전에 현재 값과 백업 값을 비교하세요. 다른 차량이나 오래된 브랜치의 백업은 설정 이름이 같아도 권장 범위나 의미가 다를 수 있습니다.

시스템 명령 입력

도구 아래쪽 명령 입력창은 서버가 허용한 git 조회·관리 명령과 df, free, uptime 같은 진단 명령만 실행합니다. 결과는 아래 출력 패널에서 확인합니다. 일반적인 장치 작업은 명령 입력보다 준비된 버튼을 우선 사용하세요.

로그 화면

로그 화면에는 대시캠과 화면녹화 탭이 있습니다.

대시캠

• 주행별 카드와 시간 범위를 확인합니다.
• 카드를 펼치면 약 1분 단위 세그먼트를 볼 수 있습니다.
• 세그먼트를 눌러 전방 영상을 재생합니다.
• 세그먼트 메뉴에서 주행 리플레이, 로그 전송, qcamera·rlog·qlog 다운로드를 선택할 수 있습니다.
• 주행 리포트는 자동·수동 주행 시간, 거리, 속도, 급가감속과 개입·경고 통계를 요약합니다.
• 체크박스와 선택 전송, 전체 선택 또는 범위 선택으로 여러 구간을 전송합니다.
• 오른쪽 위 로그 메뉴에서 정렬과 최근 2·5·10개 로그 빠른 전송을 선택합니다.

문제 분석을 위한 선택과 전송 절차는 분석용 대시캠 로그 전송에 자세히 설명합니다.

화면녹화

최근 파일부터 이름, 저장 시각과 용량이 표시됩니다. 항목을 누르면 재생하고 오른쪽 다운로드 버튼으로 원본 파일을 저장합니다. 이 탭은 기존 녹화물을 보여주는 곳이며 녹화 시작·중지는 주행 화면의 Record 버튼에서 합니다.

터미널 화면

터미널은 장치의 carrot-terminal tmux 세션에 연결됩니다. 재연결, 화면 지우기, Ctrl+C, 방향키, Tab 등 모바일용 보조 키를 제공합니다.

터미널 명령은 장치에서 즉시 실행되며 준비된 도구 버튼보다 훨씬 넓은 영향을 줄 수 있습니다. 명령의 의미를 모르면 입력하지 마세요. 연결이 끊어졌다면 Reconnect를 먼저 사용하고, 화면의 Clear는 표시만 지우며 장치 파일을 삭제하지 않습니다.

원격 지원

지원은 제한 시간 동안 외부 지원자가 터미널을 볼 수 있는 지원 세션을 만듭니다.

1. 증상을 간단히 입력합니다.
2. 공유 시간을 15분·30분·1시간 중 필요한 만큼만 선택합니다.
3. 명령 권한은 가능하면 항상 확인을 사용합니다.
4. 지원 링크와 PIN은 지정된 지원자에게만 전달합니다.
5. 화면에 표시되는 명령을 읽고 필요한 명령만 실행으로 승인합니다.
6. 지원이 끝나면 즉시 중지합니다.

전체 허용과 무제한은 사용자가 모든 위험을 이해하고 실시간으로 세션을 지켜볼 때만 사용하세요. 링크와 PIN을 공개 채널에 올리지 마세요.

접속·표시 문제 해결

1. 브라우저와 장치가 같은 네트워크인지 확인합니다.
2. 장치 IP가 바뀌지 않았는지 확인합니다.
3. 주소가 http://장치-IP:7000 형식인지 확인합니다.
4. 공용 Wi-Fi의 기기 간 통신 차단 기능이 켜져 있지 않은지 확인합니다.
5. 페이지를 새로 고친 뒤에도 안 되면 장치를 재부팅하고 서비스가 시작될 때까지 기다립니다.
6. 지원 요청에는 장치 종류, 차량, 브랜치, 커밋, 발생 시각, 오류 문구를 함께 적습니다.

영상만 보이지 않을 때는 다른 브라우저가 스트림을 사용 중인지, 장치가 주행·카메라 준비 상태인지, 현재 브라우저가 영상 코덱과 WebRTC를 지원하는지 확인하세요.

관련 문서

• 분석용 대시캠 로그 전송
• 설정 이해하기
• 버튼·프리셋
• 속도·감속
• 크루즈·차간거리
• 레이더트랙·코너레이더

외부 주행 모델 선택 (carrot-wip)

도구의 외부 주행 모델 콤보에서 N16 Nav, Flip Flop 또는 Light speed를 선택하면 자동으로 저장됩니다. eGPU와 Jetson에 같은 선택이 적용되며 내부 모델은 CD210으로 고정됩니다. 저장만으로 실행 중인 모델은 바뀌지 않습니다. 시동을 끈 상태에서 인터넷을 유지하고 콤마와 Jetson을 모두 재부팅하면 다운로드·검증 후 적용합니다. 처음 사용하는 Jetson 모델은 엔진 준비 시간이 추가로 필요합니다. 연결된 eGPU에는 공식 사전 컴파일 PKL을 다운로드하며, 모델 자체를 다시 컴파일하지 않습니다.

NOO 지원은 경로 영상과 내비게이션 입력을 받는 모델이라는 표시입니다. 현재 N16이 지원하며 Flip Flop과 Light speed는 지원하지 않습니다. 이 표시는 경로 입력의 현재 유효성이나 주행 성능을 보장하지 않습니다. MD v3는 목록에서 제외했습니다. Flip Flop은 2026-10-24에 교체된 공식 ONNX를 사용합니다. 과거 MD v3 ONNX와는 파일 해시가 다릅니다.

모델 목록은 개발자가 관리하며 사용자 숨기기·삭제 메뉴는 없습니다. 새 모델과 퇴역 모델은 Git Pull로 갱신됩니다. 퇴역 모델은 목록에서 제외되고, 사용하지 않는 파일은 오프로드에서 자동으로 정리됩니다. 실행 중인 모델은 다음 재부팅에서 기본 모델로 전환한 뒤 정리합니다. 설치된 활성 모델과 다음 부팅용 모델은 보호하며, Jetson 정리는 오프로드 연결 시 처리합니다. 다른 사용 중 모델이 공유하는 ONNX는 유지합니다. GPU 메모리에는 선택한 모델만 올립니다.

---

문서 기준

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

docs/user/ko/carrot-web.md · openpilot/selfdrive/carrot/README.md · openpilot/selfdrive/carrot/carrot_server.py

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