대시보드와 조작 권한

A-Go(LeKiwi) 안에는 로봇을 보고 다루는 웹 화면이 들어 있습니다. 로봇이 켜지면 저절로 뜨므로, 같은 네트워크의 노트북 · 태블릿 · 휴대폰에서 브라우저로 주소만 열면 됩니다. PC 에 따로 설치할 것은 없습니다.

이 페이지는 웹 화면의 뼈대를 다룹니다. 모든 화면 위에 있는 위쪽 막대, 한 번에 한 화면만 로봇을 움직이게 하는 조작 권한, 첫 화면인 대시보드, 그리고 로봇 켜기 · 끄기와 비상 정지입니다. 조작 · 지도 작성 같은 다른 화면도 모두 이 규칙 위에서 움직입니다.

학습 목표

  • 웹 화면 주소를 열고, 위쪽 막대의 표시가 무엇을 뜻하는지 읽을 수 있다.
  • 조작 권한을 받고 놓을 수 있으며, 다른 화면이 권한을 쥐고 있을 때 어떻게 되는지 설명할 수 있다.
  • 대시보드에서 로봇 기능을 켜고 끌 수 있고, 끌 때 팔을 접는 과정과 끄기가 거절되는 경우를 이해한다.
  • 비상 정지가 하는 일과 푸는 방법을 알고, 편 팔이 떨어진다는 점에 대비할 수 있다.
  • Physical Labs 앱과 웹 화면이 서로 막는 경우를 구분할 수 있다.

1. 웹 화면 열기

1.1. [PC] 주소 열기

웹 화면은 로봇 안의 프로그램(게이트웨이)이 8080 포트로 보여 줍니다. 로봇 전원을 넣고 1~2분쯤 기다린 뒤, 노트북이나 휴대폰을 로봇과 같은 네트워크에 붙이고 브라우저로 아래 주소를 엽니다.

연결 방식주소
로봇 AP 에 붙었을 때 (처음 켠 로봇은 와이파이 lekiwi01, 비밀번호 lekiwi01)http://192.168.4.1:8080
로봇과 같은 공유기에 붙었을 때http://lekiwi01.local:8080 또는 http://<로봇 IP>:8080 (예: http://192.168.0.201:8080)
랜선으로 PC 에 바로 꽂았을 때http://<유선 IP>:8080

주소의 lekiwi01 은 예시 로봇의 이름입니다. 로봇 번호를 정했다면 그 이름(lekiwiNN)으로 바꿉니다. AP 와이파이 이름 · 비밀번호는 로봇 번호를 정해도 바뀌지 않습니다. 연결하는 방법은 처음 접속하기, 유선 연결, 네트워크 (AP · 공유기)에서 자세히 다룹니다.

공유기가 붙인 이름으로는 열리지 않습니다

웹 화면은 IP 주소, .local 로 끝나는 이름, 로봇 이름만 받습니다. lekiwi01.lan 처럼 공유기가 붙인 이름으로 열면 이 주소로는 열 수 없습니다. http://lekiwi01.local:8080 또는 IP 주소로 여세요 가 나옵니다. 다른 웹사이트가 로봇을 몰래 조작하지 못하게 일부러 막은 것입니다. 안드로이드 휴대폰은 .local 이름이 안 될 수 있으니 IP 주소로 엽니다.

팁

Physical Labs(Ubuntu 판)를 쓴다면 로봇 설정 의 로봇 (ROS2): 줄에 있는 웹 화면 열기 ▾ 로 대시보드 · 네트워크 · 지도 작성 · 자율 주행 · 로그 화면을 바로 열 수 있습니다. Physical Labs 연결을 참고하세요.

1.2. 화면 구성

화면은 세 부분입니다. 맨 위의 위쪽 막대는 어느 화면에서나 같고, 왼쪽 메뉴로 화면을 고르며, 가운데에 고른 화면이 나옵니다.

메뉴하는 일자세한 문서
대시보드경고 · 기능 켜고 끄기 · 전방 카메라 · 모터 · 시스템 · 노드를 한눈에이 페이지
캘리브레이션로봇 팔(팔로워) · 리더암 보정 확인 · 새로 보정 · 접은 자세 저장캘리브레이션
조작키보드 · 화면 패드로 바퀴 조작, 리더암으로 팔 원격 조작조작 (바퀴 · 팔)
이동 설계직선 왕복 · 원 그리기 (시험 기능)이동 설계
지도 작성로봇을 몰아 지도 만들기 · 저장, 자동 주행 맵 생성지도 작성 · 자율 주행
자율 주행저장한 지도에서 목표까지 스스로 가기지도 작성 · 자율 주행
센서IMU · odom · 모터 9대의 값센서 · 로그
네트워크와이파이 · AP 모드 바꾸기네트워크 (AP · 공유기)
로그웹에서 켠 기능의 출력센서 · 로그

2. 위쪽 막대

웹 화면 대시보드 — 로봇 기능이 켜져 있고 이 화면이 조작 권한을 쥔 상태

로봇 기능이 실행 중 이고 이 브라우저가 조작 권한을 쥐고 있습니다. 위쪽 막대 왼쪽부터 로봇 이름 · 연결됨 · 대기 중 · 바퀴 토크 꺼짐 · 내가 조작 중 · 권한 놓기, 오른쪽 끝에 밝기 버튼과 비상 정지가 있습니다.

표시화면 글자뜻
로봇 이름lekiwi01이 웹 화면이 붙은 로봇입니다. 누르면 대시보드로 갑니다
연결연결 중 · 연결됨 · 연결 끊김 · 다시 연결 중브라우저와 로봇 사이의 연결입니다. 3초 동안 아무것도 오지 않으면 끊긴 것으로 보고 스스로 다시 붙습니다
모드대기 중 · 지도 작성 중 · 자율 주행 중 · 자동 주행 중로봇이 지금 하는 일입니다. 자동 주행 중 은 자동 주행 맵 생성 중이라는 뜻입니다. 연결 전에는 모드 —
바퀴 토크바퀴 토크 켜짐 · 바퀴 토크 꺼짐 · 바퀴 토크 —바퀴 모터에 힘이 들어가 있는지입니다. — 는 로봇 기능이 꺼져 있어 알 수 없다는 뜻입니다
조작 권한조작 권한 받기 / 내가 조작 중 + 권한 놓기 / <IP> · <브라우저> 조작 중누가 로봇을 조작하는지입니다 (3절)
밝기반쪽이 칠해진 동그라미 버튼밝은 화면과 어두운 화면을 바꿉니다. 고른 값은 이 브라우저에 기억됩니다
비상 정지빨간 비상 정지바퀴를 세우고 바퀴 · 팔 토크를 끕니다 (5절)

3. 조작 권한

3.1. 한 번에 한 화면만 조작합니다

웹 화면은 여러 브라우저에서 동시에 열 수 있습니다. 하지만 로봇을 움직이고 기능을 켜고 끄는 것은 조작 권한을 가진 화면 하나만 할 수 있습니다. 두 사람이 서로 다른 명령을 보내 로봇이 엉뚱하게 움직이는 일을 막기 위해서입니다. 권한이 없는 화면도 모든 값과 카메라를 볼 수 있고, 비상 정지는 누구나 누를 수 있습니다.

할 일조작 권한
로봇 켜기 · 끄기, 지도 작성 시작 · 끄기, 자율 주행 시작 · 끄기필요
바퀴 조작(조작 켜기), 팔 원격 조작(팔 시작)필요
캘리브레이션 (보정 바꾸기 · 새로 보정 · 접은 자세 저장)필요
네트워크 바꾸기 (공유기 연결 · AP 모드)필요
odom 원점으로 (센서 화면)필요
모든 화면 보기 · 카메라 · 로그필요 없음
비상 정지필요 없음 (누구나)

3.2. [웹 화면] 권한 받기 · 놓기

  1. 위쪽 막대의 조작 권한 받기를 누릅니다. 조작 · 이동 설계 화면 안에 있는 같은 버튼도 됩니다.
  2. 내가 조작 중 으로 바뀌고 알림 조작 권한을 받았습니다 (<IP> · <브라우저>) 가 뜹니다. <IP> · <브라우저> 는 이 화면의 이름표입니다 (예: 192.168.0.10 · Chrome).
  3. 다 쓰면 권한 놓기(조작 화면 안에서는 조작 권한 놓기)를 누릅니다. 로봇이 멈추고, 이 권한으로 켠 바퀴 토크가 꺼집니다. 알림은 조작 권한을 놓았습니다 (…) 입니다.

처음 접속한 대시보드 — 로봇 기능 꺼짐, 조작 권한 없음

권한을 받기 전의 대시보드입니다. 위쪽 막대에 보라색 조작 권한 받기가 있고, 로봇 켜기 · 지도 작성 시작은 흐린 채 아래에 먼저 조작 권한을 받으세요 가 보입니다. 로봇 기능이 꺼져 있어 바퀴 토크 —, 전방 카메라는 신호 없음 입니다.

권한이 필요한 버튼은 누를 수 없을 때 그 이유를 버튼 아래에 적어 줍니다.

이유 글뜻 · 할 일
먼저 조작 권한을 받으세요아직 아무 화면도 권한을 받지 않았습니다. 조작 권한 받기
다른 화면(<IP> · <브라우저>)이 조작 중입니다다른 브라우저가 권한을 쥐고 있습니다 (3.3절)
서버에 연결되지 않았습니다로봇과 연결이 끊겼습니다. 위쪽 막대가 연결됨 이 될 때까지 기다립니다
보기 전용 화면이라 명령을 보낼 수 없습니다보기 전용 화면입니다

조작 권한이 없을 때의 조작 패드

조작 화면도 같습니다. 권한이 없으면 키 패드가 흐리고 먼저 조작 권한을 받으세요 가 보입니다.

3.3. 다른 화면이 쥐고 있을 때 · 끊긴 권한 넘겨받기

다른 화면이 권한을 쥐고 있으면 위쪽 막대에 조작 권한 받기 대신 <IP> · <브라우저> 조작 중 이 보입니다. 그 화면이 살아 있는 동안은 권한을 빼앗을 수 없습니다. 그 화면에서 권한 놓기를 누르거나 탭을 닫으면 넘겨받을 수 있습니다.

권한은 아래 경우에 끝납니다.

권한을 가진 화면에서 생긴 일결과
권한 놓기를 누름바로 끝납니다
탭을 닫거나 새로 고침바로 끝납니다
와이파이가 끊기거나 브라우저가 멈춤, 휴대폰 화면이 꺼짐화면이 0.5초마다 보내는 신호가 2초 끊기면 끝납니다
다른 탭 · 창으로 감누르던 키를 놓아 로봇이 멈춥니다. 권한은 남지만, 몇 분 넘게 뒤에 숨겨 두면 브라우저가 신호를 늦춰 끝날 수 있습니다

조작하는 탭은 늘 앞에 두세요

다른 탭에 가 있으면 로봇이 멈추고, 오래 숨겨 두면 권한까지 끝날 수 있습니다. 휴대폰으로 조작할 때는 화면이 꺼지지 않게 해 둡니다.


4. 대시보드

4.1. 칸 한눈에

대시보드는 웹 화면을 열면 처음 나오는 화면으로, 로봇의 상태를 한 장에 모아 보여 줍니다.

칸보여 주는 것
경고로봇이 알리는 문제. 없으면 경고 없음 (4.2절)
기능로봇 · 지도 작성 · 자율 주행 켜고 끄기 (4.3절)
전방 카메라전방 카메라 영상과 초당 프레임 수(fps). 2초 동안 영상이 없으면 신호 없음
모터 · 전원바퀴 토크 · 모터 전압 · 최고 온도 · 연결된 모터 수 · 모터 이상 (4.6절)
센서 수신스캔 · odom · IMU · 모터 상태 · 카메라가 1초에 몇 번 들어오는지 (4.6절)
시스템라즈베리파이의 CPU · 온도 · 메모리 · 디스크 · 부하 · 전원 상태 (4.6절)
로봇이름 · IP · 가동 시간 · 버전 · ROS 도메인과 노드 수 · 접속 주소 (4.7절)
노드로봇 기능의 주요 노드 9개가 떠 있는지 (4.7절)

4.2. 경고

연결되기 전에는 연결되면 로봇 경고를 보여 줍니다, 문제가 없으면 경고 없음, 있으면 경고 N개 와 목록이 나옵니다.

경고뜻 · 할 일
스캔이 1초 넘게 들어오지 않습니다 (odom · IMU · 모터 상태 도 같은 모양)노드는 떠 있는데 값이 1초 넘게 오지 않습니다. 로그 화면의 로봇 출력을 봅니다
모터 <ID> (<이름>) 이상: <내용>모터가 이상 신호(전압 · 각도 센서 · 과열 · 과전류 · 과부하)를 보냈습니다. 센서 화면의 모터 표에서 그 모터를 봅니다
모터 <ID> (<이름>) 온도가 높습니다: <N> ℃60 ℃ 이상입니다. 조작을 멈추고 식힙니다
같은 기능이 N개 떠 있습니다: … 하나만 남기고 끄세요터미널에서 같은 기능을 한 번 더 켰습니다. 하나를 끕니다
cmd_vel 에 다른 발행자가 있습니다: …웹 말고 다른 프로그램이 바퀴 명령을 보내고 있습니다 (Physical Labs 앱이 조작 중이거나 터미널의 키보드 조작 등, 6절)
베이스 컨트롤러가 둘 이상입니다. 같은 ROS_DOMAIN_ID 에 다른 로봇이 있습니다같은 공유기에 ROS 도메인 번호가 같은 로봇이 또 있습니다. 그동안 바퀴 조작은 거절됩니다. 로봇마다 번호를 다르게 합니다 (저장소와 구조)
자율 주행 감독 도구가 끝나 바퀴 토크를 다시 켤 수 없습니다. 자율 주행을 끄고 다시 켜세요 (로그: navigation)자율 주행 끄기 를 누른 뒤 자율 주행 화면에서 다시 시작합니다
라이다 TF(base_footprint ← 스캔 프레임)가 없어 스캔을 그릴 수 없습니다스캔은 오는데 라이다가 로봇 어디에 달렸는지 몰라 그리지 못합니다. 노드 표의 robot_state_publisher 를 확인하고 로봇을 껐다 켭니다

노드가 아예 죽으면 경고 칸에 나오지 않을 수 있습니다

‘1초 넘게 들어오지 않습니다’ 경고는 노드가 떠 있는데 값이 끊길 때만 나옵니다. 노드가 죽으면 대신 노드 표에 없음 으로 보입니다 (4.7절). 또 IMU 처럼 지금 아무 화면도 보지 않는 값은 경고를 따지지 않습니다. 그래서 경고 칸과 노드 표를 함께 봅니다.

4.3. 기능 — 로봇 · 지도 작성 · 자율 주행

기능설명 글버튼
로봇센서 · 모터 · 카메라 노드를 켭니다 (bringup)로봇 켜기 / 로봇 끄기, 체크 칸 카메라 포함
지도 작성로봇을 천천히 움직여 지도를 만듭니다 (Cartographer)지도 작성 시작 / 지도 작성 끄기, 링크 지도 작성 화면
자율 주행저장한 지도에서 목표까지 스스로 갑니다 (Nav2)링크 지도 고르고 시작 / 자율 주행 끄기

자율 주행은 지도를 골라야 하므로 대시보드에서 바로 켜지 않습니다. 지도 고르고 시작으로 자율 주행 화면에 가서 켭니다 (지도 작성 · 자율 주행).

기능 이름 옆 배지는 지금 상태입니다.

배지뜻
꺼짐꺼져 있습니다
켜는 중켜고 있습니다
실행 중켜져 있습니다
끄는 중끄고 있습니다
외부 실행터미널처럼 웹 밖에서 켰습니다. 그대로 써도 되고, 이 로봇에서 켠 것이면 웹에서 끌 수도 있습니다. 다른 컴퓨터에서 켠 것이면 배지 아래에 다른 컴퓨터에서 실행 중이라 끌 수 없습니다 가 나오고, 켠 곳에서 꺼야 합니다
실패켠 뒤 오류로 꺼졌습니다. 아래 줄의 종료 코드 와 로그를 봅니다

배지 아래 줄에는 PID 5878 같은 프로그램 번호, 종료 코드 1, 카메라 없이 켬, 지도 map.yaml 같은 덧붙임이 나옵니다.

버튼을 누를 수 없을 때는 버튼 아래에 이유가 나옵니다. 권한 관련 이유(3.2절) 말고 자주 보는 것은 다음과 같습니다.

이유 글뜻
로봇 상태를 기다리는 중입니다막 연결돼 아직 로봇 상태를 받지 못했습니다. 잠시 기다립니다
먼저 로봇을 켜세요지도 작성 · 자율 주행은 로봇 기능이 켜져 있어야 합니다
자율 주행을 먼저 끄세요 · 지도 작성을 먼저 끄세요지도 작성과 자율 주행은 함께 켤 수 없습니다
지도 작성 · 자율 주행을 먼저 끄세요로봇을 끄려면 둘 다 먼저 끕니다
지도를 저장하는 중입니다. 저장이 끝난 뒤 끄세요지도 저장이 끝날 때까지 기다립니다
팔을 접은 뒤 로봇을 끕니다 (최대 약 12초) · 끄는 중입니다끄고 있습니다 (4.5절)

4.4. [웹 화면] 로봇 켜기

로봇은 센서 · 모터 · 카메라를 다루는 로봇 기능 전체입니다. 웹 화면은 로봇이 켜질 때 저절로 뜨지만, 로봇 기능은 직접 켜야 합니다.

  1. 위쪽 막대에서 조작 권한 받기를 누릅니다.
  2. 기능 → 로봇 의 카메라 포함 이 체크돼 있는지 봅니다 (처음부터 체크돼 있습니다). 카메라가 필요 없을 때만 끕니다.
  3. 로봇 켜기를 누릅니다. 배지가 켜는 중 이 되고, 주요 노드(베이스 컨트롤러 · 모터 드라이버 · 라이다)가 보이면 실행 중 이 됩니다. 알림은 로봇: 시작했습니다 입니다.
  4. 센서 수신 이 정상 인지(보지 않음 은 정상입니다), 노드 표가 모두 있음 인지 봅니다 (4.6 · 4.7절).

4.5. [웹 화면] 로봇 끄기 — 팔을 먼저 접습니다

  1. 지도 작성 · 자율 주행이 켜져 있으면 먼저 끕니다.
  2. 로봇 끄기를 누릅니다.
  3. 확인 창 로봇을 끌까요? (센서 · 모터 · 카메라 노드가 모두 꺼집니다. 다시 쓰려면 ‘로봇 켜기’를 누르세요.) 에서 로봇 끄기를 누릅니다.
  4. 팔에 힘이 들어가 있을 수 있으면 로봇이 먼저 팔을 접은 자세로 접고 팔 토크를 끕니다. 팔이 스스로 움직이므로 팔 둘레를 비워 둡니다. 알림이 로봇을 끄기 전에 팔을 접습니다 → 팔을 접고 팔 토크를 껐습니다 로 이어지고, 최대 약 12초 걸립니다.
  5. 배지가 끄는 중 → 꺼짐 이 되고 알림 로봇: 꺼졌습니다 가 뜹니다.

팔 토크가 꺼져 있으면 접지 않고 바로 끕니다. 팔이 접은 자세에 다 오지 못해도 접은 것으로 보고 끄며, 알림 팔 접기: 접은 자세에 다 오지 못했습니다: <관절> 이 남습니다.

팔을 접지 못하면 로봇을 끄지 않습니다. 편 팔이 갑자기 떨어지지 않게 하기 위해서입니다. 이때 알림 로봇을 끄지 않았습니다: <이유>. 팔을 손으로 받치고 ‘그래도 끄기’로 팔 힘을 뺀 뒤 끌 수 있습니다 와 함께 확인 창 팔을 접지 못했습니다. 그래도 끌까요? 가 뜹니다.

이유 (알림 속 글)뜻
팔로워가 팔 접기를 거절했습니다: 접은 자세가 설정되지 않았습니다 (rest_pose_ticks)접은 자세가 저장돼 있지 않습니다. 콜론 뒤가 다른 글이면 그것이 팔로워가 거절한 이유입니다
팔이 6초 안에 접히지 않았습니다 (…)팔이 무언가에 걸렸거나 모터가 따라오지 못했습니다
팔 노드가 없어 팔을 접을 수 없습니다로봇 팔 노드가 떠 있지 않습니다

그래도 끄려면 다음과 같이 합니다.

  1. [로봇] 팔 아래를 비우고 팔을 손으로 받칩니다.
  2. [웹 화면] 확인 창에서 그래도 끄기를 누릅니다. 알림 팔을 접지 않고 팔 힘을 뺀 뒤 로봇을 끕니다 (편 팔은 떨어집니다) 가 뜨고, 팔 토크가 꺼진 뒤 로봇 기능이 꺼집니다.

모터 드라이버 노드가 없을 때는 팔을 접을 수도 끌 수도 없어, 알림 모터 드라이버가 없어 팔을 접거나 팔 토크를 끄지 못한 채 로봇을 끕니다. 팔이 굳어 있으면 주 전원을 끄세요 를 남기고 그냥 끕니다.

접은 자세를 꼭 저장해 두세요

접은 자세가 없으면 팔에 힘이 들어간 채로는 로봇 끄기가 늘 거절되고, 그래도 끄기로 팔을 떨어뜨리는 수밖에 없습니다. 팔로워(로봇 팔)를 새로 보정하면 접은 자세가 지워지므로 보정 뒤에 다시 저장합니다. 방법은 캘리브레이션에 있습니다.

로봇 끄기는 라즈베리파이를 끄지 않습니다

로봇 기능(노드)만 꺼지고 라즈베리파이와 웹 화면은 켜진 채 남습니다. 다시 쓰려면 로봇 켜기를 누릅니다. 터미널에서 켠 로봇 기능을 Ctrl+C 로 끄면 팔을 접지 않으니, 끌 때는 웹 화면이나 Physical Labs 에서 끕니다.

4.6. 모터 · 전원 · 센서 수신 · 시스템

대시보드 가운데 줄 — 모터 · 전원, 센서 수신, 시스템

로봇 기능이 켜진 정상 상태입니다. 모터 9대가 모두 연결돼 있고, IMU 와 손목 카메라 는 이 화면이 받지 않는 값이라 보지 않음 입니다 (고장이 아닙니다).

모터 · 전원 칸입니다.

칸뜻
바퀴 토크켜짐 · 꺼짐. 웹 화면의 조작 켜기로 켰으면 켜짐 · 웹에서 켬
전압 (최저 – 최고)모터들이 재는 전원 전압 가운데 가장 낮은 값과 높은 값 (V)
최고 온도연결된 모터 가운데 가장 뜨거운 모터의 온도 (℃)
연결된 모터연결된 모터 수 / 전체 모터 수. 팔 6대와 바퀴 3대라 정상이면 9 / 9
아래 목록이상이 있으면 <ID> <이름>: 연결 끊김 이나 이상 내용, 없으면 모터 상태 비트 이상 없음

센서 수신 은 라이다 스캔 · odom · IMU · 모터 상태 · 전방 · 손목 카메라가 1초에 몇 번(Hz) 들어오는지와 상태(정상 · 늦음 · 끊김 · 보지 않음 …)를 보여 줍니다. 웹 화면은 지금 열린 화면에 필요한 값만 로봇에서 받으므로 보지 않음 은 고장이 아닙니다. 상태 글의 뜻은 센서 · 로그에 정리했습니다.

시스템 은 라즈베리파이 자체의 상태입니다.

칸뜻
CPU · CPU 온도라즈베리파이 CPU 사용률(%)과 온도(℃)
메모리 · 디스크사용률(%)
부하 (1 · 5 · 15분)최근 1분 · 5분 · 15분 동안의 평균 부하
전원 줄전원 정상 · 지금 전원 전압이 낮습니다. 배터리 · 어댑터를 확인하세요 · CPU 속도가 제한되고 있습니다 · 부팅 뒤 전원 부족이 있었습니다

전원 전압이 낮다고 나오면 배터리를 확인하세요

라즈베리파이 전원이 모자라면 CPU 가 느려지고 동작이 불안정해질 수 있습니다. 부팅 뒤 전원 부족이 있었습니다 는 지금은 괜찮지만, 켜진 뒤 한 번 이상 전압이 떨어졌다는 뜻입니다.

4.7. 로봇 · 노드

대시보드 아래 줄 — 로봇 정보와 노드 표

이 그림의 로봇은 IMU 칩이 응답하지 않아 lekiwi_imu_node 가 없음 입니다. 정상인 로봇은 9개 모두 있음 입니다. 원인을 찾는 방법은 센서 · 로그의 로그 예시를 보세요.

로봇 칸에는 이름 · 호스트 · IP(유선 · 와이파이 주소가 모두 나옵니다) · 가동 시간(라즈베리파이를 켠 뒤 지난 시간) · 버전(웹 화면 프로그램의 버전) · ROS(도메인 <번호> · 노드 <N>개)가 나옵니다. 그 아래에는 이 로봇을 열 수 있는 주소가 모두 링크로 나옵니다.

ROS 줄의 도메인 번호(ROS_DOMAIN_ID)는 같은 공유기에 로봇이 여러 대일 때 중요합니다. SD 카드 이미지로 구운 로봇은 모두 같은 번호로 시작하므로, 여러 대를 함께 쓰면 로봇마다 번호를 다르게 바꿔야 서로의 신호가 섞이지 않습니다. 바꾸는 방법은 저장소와 구조에 있습니다.

노드 표의 노드는 로봇 안에서 한 가지 일을 맡은 프로그램입니다.

노드맡은 일
robot_state_publisher로봇 모델 (부품들의 위치 관계, TF)
joint_state_publisher관절 상태
lekiwi_imu_nodeIMU (기울기 · 회전)
lekiwi_lidar_node라이다
lekiwi_scan_filter_node라이다 스캔 다듬기
lekiwi_motor_driver_node모터 드라이버 (모터 9대와 통신)
lekiwi_base_controller_node베이스 컨트롤러 (바퀴 속도 · odom)
front_camera_node전방 카메라
wrist_camera_node손목 카메라

5. 비상 정지

5.1. 누르면 일어나는 일

위쪽 막대 오른쪽 끝의 빨간 비상 정지는 모든 화면에 있고, 확인 창 안에도 있습니다. 조작 권한이 없는 화면, 연결이 끊겨 다시 붙는 중인 화면에서도 누를 수 있습니다. 손가락을 대는 순간 바로 보냅니다.

누르면 로봇은 다음을 합니다.

  1. 바퀴를 세웁니다 (속도 0).
  2. 자율 주행 목표를 모두 취소합니다.
  3. 바퀴 토크를 끕니다 (누가 켰든).
  4. 팔 토크도 끕니다. 팔 원격 조작도 멈춥니다.
  5. 하던 보정 · 자동 주행 맵 생성도 멈춥니다.

알림은 비상 정지 (<누른 화면>): 멈춤 · 목표 취소 · 바퀴 · 팔 토크 끄는 중 입니다. 조작 권한은 그대로 남습니다.

비상 정지는 팔 토크도 꺼서 편 팔과 잡은 물건이 떨어집니다

팔을 편 채 다룰 때는 팔 아래를 비워 둡니다. 팔을 놓지 않고 멈추려면 비상 정지 대신 조작 화면 텔레오퍼레이션 칸의 멈춤을 누릅니다 (팔은 토크를 켠 채 그 자리에 머뭅니다).

비상 정지는 네트워크로 갑니다

와이파이가 끊기면 로봇에 닿지 않습니다. 그때는 조작 명령이 0.3초 끊기면 바퀴가 서고, 화면 신호가 2초 끊기면 권한이 끝나며 바퀴 토크가 꺼지도록 되어 있습니다. 그래도 로봇 주 전원은 늘 손이 닿는 곳에 둡니다.

알림에 주 전원을 끄세요 가 들어 있으면 바퀴나 팔 토크를 끄지 못한 것입니다 (예: 비상 정지: 팔 토크를 끄지 못했습니다 (모터 드라이버 없음). 팔이 굳어 있으면 주 전원을 끄세요). 팔을 받치고 로봇 주 전원을 끕니다.

5.2. 걸린 채 남습니다 — 푸는 법

비상 정지는 풀 때까지 걸려 있습니다. 걸려 있는 동안 모든 화면 맨 위에 빨간 띠가 뜹니다.

푸는 법은 다음과 같습니다.

  1. [로봇] 주변에 사람 · 케이블이 없는지, 팔 아래가 비었는지 봅니다.
  2. [웹 화면] 조작 권한을 가진 화면에서 조작 화면의 조작 켜기를 누릅니다. 자율 주행이 켜져 있었다면 자율 주행 끄기 뒤 자율 주행 화면에서 자율 주행 시작을 합니다. 성공하면 비상 정지가 풀리고 바퀴 토크가 다시 켜집니다.

6. Physical Labs 앱과 함께 쓸 때

Physical Labs 앱의 텔레오퍼레이션 · 데이터 수집 · 추론은 로봇의 데이터 노드와 ZMQ(포트 5555 · 5556)로 주고받습니다. 로봇 켜기 · 끄기, 보정, 비상 정지, AP 모드는 앱도 웹 화면과 같은 로봇 안 게이트웨이에 부탁합니다. 그래서 로봇을 움직이는 쪽은 한 번에 하나입니다.

상황막히는 것보이는 글할 일
웹 화면이 조작 권한을 쥐고 있음앱의 텔레오퍼레이션 · 데이터 수집 · 추론(앱) 웹 화면이 조작 중입니다웹 화면에서 권한 놓기 (또는 그 탭 닫기)
웹 화면이 조작 권한을 쥐고 있음앱의 로봇 켜기 · 끄기 · 보정 · AP 모드 · 비상 정지 풀기(앱) 다른 화면(<IP> · <브라우저>)이 조작 중입니다위와 같음
앱이 로봇을 조작 중웹의 팔 시작 · 자율 주행 · 자동 주행 맵 생성 · 팔로워 보정 · 네트워크 바꾸기(웹) PC(ZMQ, <IP>)가 조작 중입니다앱에서 조작을 끝냅니다
앱이 로봇을 조작 중웹의 바퀴 조작(웹) 다른 프로그램이 cmd_vel 을 보내고 있습니다: …, 대시보드 경고 cmd_vel 에 다른 발행자가 있습니다: …위와 같음
비상 정지가 걸려 있음앱의 조작 시작(앱) 비상 정지가 걸려 있습니다웹의 조작 켜기나 앱의 비상 정지 풀기로 풉니다

Physical Labs 로 새 A-Go 를 쓰려면 Ubuntu 판이 필요합니다

Ubuntu 판 0.1.8 이상(최신 0.2.0)이 새 A-Go(ROS 2)를 지원합니다. Windows 판(최신 0.1.7)은 지원하지 않습니다. 웹 화면은 브라우저만 있으면 되므로 Windows 노트북에서도 열 수 있습니다.


7. 하루를 끝낼 때

  1. [웹 화면] 자율 주행 · 지도 작성을 끕니다.
  2. [웹 화면] 조작 화면에서 바퀴는 조작 끄기, 팔은 멈춤으로 끝냅니다 (조작 (바퀴 · 팔)). 팔은 토크를 켠 채 그 자리에 머뭅니다.
  3. [웹 화면] 대시보드에서 로봇 끄기를 누릅니다. 팔이 접은 자세로 접힌 뒤 꺼집니다 (4.5절).
  4. [웹 화면] 권한 놓기를 누릅니다.
  5. [PC] PC 에이전트를 썼다면 터미널에서 Ctrl+C 로 끕니다 (PC 에이전트 (리더암)).
  6. [로봇] 라즈베리파이를 끈 뒤 주 전원을 내립니다.

웹 화면에는 라즈베리파이를 끄는 버튼이 없습니다

Physical Labs 로봇 설정 맨 위의 로봇 종료를 쓰거나, SSH(ssh roboseasy@lekiwi01.local, 비밀번호는 스페이스 한 번)로 접속해 sudo poweroff 를 실행합니다. 라즈베리파이가 꺼질 때까지 잠시 기다린 뒤 주 전원을 내립니다.


8. 문제 해결

증상확인할 것
주소가 열리지 않는다노트북이 로봇과 같은 네트워크인지(AP 모드면 와이파이 lekiwi01), 로봇을 켠 뒤 1~2분이 지났는지, 주소 끝에 :8080 을 넣었는지 봅니다. .local 이 안 되면 IP 로 엽니다
이 주소로는 열 수 없습니다 …공유기가 붙인 이름으로 열었습니다. http://lekiwi01.local:8080 이나 IP 로 엽니다
위쪽 막대가 연결 끊김 · 다시 연결 중, 또는 알림 서버에 연결할 수 없습니다. 로봇 전원과 네트워크를 확인하세요와이파이와 로봇 전원을 확인합니다. 다시 붙으면 조작 권한 받기부터 다시 합니다
다른 화면(…)이 조작 중입니다그 화면에서 권한 놓기를 누르거나 탭을 닫습니다. 그 화면이 꺼졌거나 연결이 끊겼다면 2초 뒤 저절로 풀립니다
권한이 저절로 풀리고 조작 화면 신호가 끊겨 로봇을 멈췄습니다 (…)조작하던 탭을 닫았거나 오래 숨겼거나, 휴대폰 화면이 꺼졌거나, 와이파이가 끊겼습니다. 권한을 다시 받습니다
로봇 켜기 뒤 실패 와 종료 코드로그 화면 로봇 출력의 마지막 줄들을 봅니다
실행 중 인데 노드 표에 없음 이 있다그 노드가 죽었습니다. 로그에서 그 노드 이름을 찾아봅니다. 카메라 노드는 카메라 없이 켬 이거나 카메라가 빠져 있어도 없음 입니다
로봇을 끄지 않았습니다: …팔을 접지 못했습니다. 팔을 받치고 그래도 끄기 → 다음에는 접은 자세를 저장해 둡니다 (4.5절)
외부 실행 에 다른 컴퓨터에서 실행 중이라 끌 수 없습니다다른 컴퓨터에서 켰습니다. 켠 곳에서 끕니다. 방금 강제로 끈 경우라면 10~20초 기다립니다
전방 카메라가 신호 없음로봇 기능이 꺼져 있거나 카메라 없이 켬 입니다. 노드 표의 front_camera_node 를 보고 카메라 연결을 확인합니다
빨간 비상 정지 띠가 사라지지 않는다조작 권한을 가진 화면에서 조작 켜기(자율 주행이 켜져 있으면 자율 주행을 껐다가 다시 시작)가 성공해야 풀립니다. 누른 지 1초가 지난 뒤에 합니다 (5.2절)
앱이 웹 화면이 조작 중입니다 로 시작하지 않는다웹 화면에서 권한 놓기

9. 정리