Physical Labs 에 A-Go(LeKiwi) 연결하기

Physical Labs 로 A-Go(LeKiwi)를 쓰려면 먼저 앱에 로봇을 하나 만들고, 앱이 찾아갈 로봇 주소를 알려 줍니다. 이 페이지에서는 로봇 설정 탭에서 리더암 포트와 로봇 주소를 정하고, 연결 확인 으로 새 A-Go 를 알아보게 한 뒤, 앱에서 로봇 기능을 켜고 카메라를 확인하는 데까지 다룹니다. 앱에서 로봇을 공유기 · AP 모드로 바꾸는 방법과, 다른 탭 위에 늘 보이는 로봇 상태 띠 · 비상 정지도 함께 설명합니다.

학습 목표

  • Physical Labs 에 Lekiwi 로봇을 만들고 리더암 포트와 로봇 주소를 저장할 수 있다.
  • 연결 확인 결과를 읽고, 앱에서 로봇 기능을 켜고 끌 수 있다.
  • 랜선 · 공유기 · 로봇 AP 가운데 지금 쓰는 길에 맞게 연결 방식을 고르고, 앱에서 공유기 · AP 모드를 바꿀 수 있다.
  • 앱에서 전방 · 손목 카메라를 미리 보고 서로 바뀌지 않았는지 확인할 수 있다.
  • 다른 탭 위의 로봇 상태 띠와 ⛔ 비상 정지 가 무엇을 하는지 설명할 수 있다.

1. 시작하기 전에

1.1. 준비물

준비물설명
Ubuntu 노트북 + Physical LabsUbuntu 24.04 에 Physical Labs 0.2.0 (physical-labs_0.6.0-0.2.0_amd64.deb) 를 설치합니다 (설치와 첫 실행). 새 A-Go 는 Ubuntu 판 0.1.8 부터 연결됩니다
A-Go(LeKiwi)lekiwi1027 이미지를 구운 카드로 켠 로봇 (SD 카드 굽기)
SO-101 리더암USB 케이블과 전원. 노트북에 꽂아 둡니다 — 로봇을 저장할 때 꽂혀 있어야 합니다
네트워크노트북과 로봇이 랜선 · 같은 공유기 · 로봇 AP 가운데 하나로 이어져 있어야 합니다 (1.4절)
인터넷앱을 켤 때와 기능 패키지를 설치할 때 필요합니다 (1.3절)

Windows 판 Physical Labs(최신 0.1.7)는 새 A-Go 를 지원하지 않습니다

Windows 노트북에서는 브라우저로 로봇의 웹 화면을 씁니다 (대시보드와 조작 권한). 앱으로 텔레오퍼레이션 · 데이터 수집 · 추론을 하려면 Ubuntu 노트북이 필요합니다.

1.2. 앱은 로봇과 이렇게 주고받습니다

PC 에는 ROS 2 를 설치하지 않습니다. 앱은 네트워크로 로봇 안의 프로그램들과 주고받습니다.

통로로봇 쪽포트앱에서 쓰는 곳
게이트웨이웹 화면과 같은 프로그램. 로봇이 켜질 때 저절로 뜹니다8080연결 확인, 로봇 켜기 · 끄기, 팔 보정, 카메라 미리보기, 비상 정지, AP 모드
데이터 노드로봇 기능을 켜면 함께 켜집니다5555 · 5556텔레오퍼레이션 · 데이터 수집 · 추론의 관절 · 카메라 · 명령
SSH늘 켜져 있습니다22연결 확인(응답만 봅니다), 📶 와이파이 설정…, 로봇 다시 시작, 로봇 종료

앱이 웹 화면과 같은 게이트웨이를 쓰기 때문에, 로봇을 움직이는 쪽은 앱과 웹 화면 가운데 한 번에 하나입니다 (대시보드와 조작 권한 6절).

1.3. 앱을 켤 때 인터넷이 필요합니다

앱은 켤 때마다 구글 로그인을 인터넷으로 확인합니다. 인터넷 없이 켜면 로그인 화면에서 더 나아가지 못하고, 로그인 기한이 지난 때라면 저장된 로그인이 지워져 다시 로그인해야 합니다. 앱을 다시 설치하거나 업데이트한 뒤에도 처음 켤 때 한 번 더 로그인합니다.

노트북을 로봇 AP 에 붙이기 전에 앱을 켜 두세요

로봇 AP 에는 인터넷이 없습니다. 이 순서로 합니다.

  1. 인터넷이 되는 와이파이에서 Physical Labs 를 켜고 홈 화면까지 들어갑니다.
  2. 쓸 탭(칼리브레이션 · 텔레오퍼레이션 · 데이터 · 훈련 · 추론)을 한 번씩 열어, 설치 카드가 뜨면 설치를 끝내 둡니다 (기능 패키지 설치).
  3. 그다음 노트북 와이파이를 로봇 AP 로 바꿉니다. 켜 둔 앱은 그대로 쓸 수 있습니다.

1.4. 어느 길로 붙을까요?

길앱의 연결 방식로봇 주소이런 때
랜선 (처음 세팅에 권장)이더넷 직결노트북이 랜선으로 나눠 준 주소 (예: 10.42.0.170). 🔍 찾기 로 찾습니다노트북은 와이파이 인터넷을 그대로 쓰고, 로봇 와이파이를 바꾸는 동안에도 랜선은 끊기지 않습니다
공유기와이파이 (고정 IP)192.168.0.(200 + 킷 번호) (예: 192.168.0.201)로봇과 노트북을 같은 192.168.0.x 공유기에 붙였을 때
다른 대역 공유기 · 휴대폰 핫스팟핫스팟 (자동 IP)공유기가 준 주소. 🔍 찾기 로 찾습니다공유기 주소가 192.168.0.x 가 아닐 때
로봇 APAP 모드 (로봇 와이파이)192.168.4.1공유기가 없는 곳. 노트북은 인터넷이 끊깁니다

새로 구운 카드의 로봇은 AP 모드로 켜집니다 (처음 접속하기). 두 모드의 차이는 네트워크 (AP · 공유기), 랜선 준비는 유선 연결에 있습니다.


2. [앱] Lekiwi 로봇 만들기

2.1. 새 로봇 생성

  1. [PC] 리더암 USB 케이블을 노트북에 꽂고 리더암 전원도 연결합니다.
  2. [앱] 사이드바 로봇 창고 → 오른쪽 위 + 로봇 추가 를 누릅니다.
  3. 창 새 로봇 생성 에서 Lekiwi (모바일 베이스 + 로봇 팔) 카드를 누릅니다.
  4. 빈 로봇 설정 탭이 열립니다. 로봇 저장 을 누르기 전까지는 로봇 창고에 카드가 생기지 않습니다.

새 로봇 생성 창 — SO-101 · SO-102 · Lekiwi 카드를 고를 수 있고, 나머지 세 카드는 준비 중으로 흐리다

A-Go(LeKiwi)는 앱에서 Lekiwi 로 보입니다.

2.2. 로봇 설정 탭 한눈에

Lekiwi 로봇 설정 탭 맨 위 — 로봇 다시 시작 · 로봇 저장 · 로봇 종료 · 로봇 삭제 버튼, 이름 칸(robot id · teleop id), 1. Leader Arm (USB-PC 직결) 칸

lekiwi01 로봇의 로봇 설정 탭 맨 위입니다. 그림의 리더암 포트 이름은 촬영용 값입니다.

칸하는 일
맨 위 버튼로봇 저장 · 로봇 삭제, 그리고 LeKiwi 에만 있는 로봇 다시 시작 · 로봇 종료 (8절). 로봇 삭제 는 앱의 설정과 노트북의 리더 보정만 지우고, 로봇 안의 보정은 남깁니다
이름robot id · teleop id (2.3절)
포트 › 1. Leader Arm (USB-PC 직결)노트북에 꽂은 리더암 포트 (2.4절)
포트 › 2. Lekiwi (원격)로봇 주소 · 연결 확인 · 로봇 켜기 · 와이파이 · AP 모드 (3 · 4 · 6 · 7절)
포트 › 3. Lekiwi (카메라)로봇의 전방 · 손목 카메라 미리보기 (5절)
모터안내 카드만 있습니다 (10절)

2.3. 이름 — robot id · teleop id

칸예쓰임
robot idlekiwi01앱 안에서 이 로봇을 부르는 이름이고, 로봇 창고 카드의 제목이 됩니다. 영문 · 숫자 · _ · - · . 만 씁니다
teleop idleader리더암 보정 이름입니다. 노트북에 저장되는 리더 보정 파일 이름이 됩니다

robot id 는 로봇 이름(호스트 이름)과 같게 두면 알아보기 쉽습니다. 팔로워 팔의 보정 이름은 이 칸과 상관없이 로봇이 정하며, 로봇 이름(예: lekiwi01)을 씁니다 (캘리브레이션).

2.4. 리더암 포트 — Leader Arm (USB-PC 직결)

  1. 🔄 새로고침 을 누르고 leader arm 목록에서 리더암 포트(예: ttyACM0)를 고릅니다.
  2. 오른쪽 이름 칸은 비워 두면 teleop id 를 씁니다. 저장하면 이 이름(예: /dev/leader)으로 포트가 고정됩니다.

팔로워 팔은 로봇 안에 있으므로 follower arm 줄이 없습니다. 리더암 포트 고르기와 포트 고정 · 🔓 포트 편집 은 팔 로봇과 똑같고, 자세한 것은 로봇 설정에 있습니다. 포트가 목록에 없거나 권한 오류가 나면 문제 해결을 봅니다.


3. [앱] 로봇에 연결하기 — Lekiwi (원격) 칸

2. Lekiwi (원격) 칸 — 킷 번호, 연결 방식 네 가지, 로봇 IP 와 연결 확인, 로봇 와이파이, 로봇 (ROS2) 줄과 상태 줄, SSH 사용자, 팔로워 포트

공유기에 고정 IP(192.168.0.201)로 붙은 lekiwi01 입니다. 로봇 기능이 켜져 있고, 연결 확인 을 누르기 전이라 램프가 회색입니다. 상태 줄의 빠진 노드: IMU 와 팔로워: … 는 촬영할 때 그 로봇의 상태입니다.

3.1. 칸 한눈에

칸하는 일
킷 번호로봇 번호. 오른쪽에 → 호스트명 lekiwi01 · 고정 IP 192.168.0.201 처럼 그 번호의 이름과 고정 IP 가 보입니다 (3.2절)
연결 방식노트북이 로봇에 붙는 길 — 이더넷 직결 · 와이파이 (고정 IP) · 핫스팟 (자동 IP) · AP 모드 (로봇 와이파이) (3.3절)
로봇 IP로봇 주소. 옆에 램프 ● 와 연결 확인 이 있고, 이더넷 직결 · 핫스팟 (자동 IP) 에서는 🔍 찾기 도 보입니다
로봇 와이파이📶 와이파이 설정… — 로봇을 공유기에 붙입니다 (6절)
AP 모드AP 모드 (로봇 와이파이) 를 골랐을 때만 펼쳐집니다 (7절)
로봇 (ROS2)▶ 로봇 켜기 / ■ 로봇 끄기 · 웹 화면 열기 ▾ · 상태 줄. 연결 확인으로 새 A-Go 를 알아본 뒤에 생깁니다 (4절)
SSH 사용자roboseasy 그대로 둡니다
팔로워 포트 · 고급 설정 (ZMQ 포트)바꾸지 않습니다 (10절)

3.2. 킷 번호

킷 번호 에는 로봇 번호를 넣습니다. 호스트 이름 lekiwiNN 의 NN 이고, 새로 구운 카드는 1 입니다. 번호를 넣으면 앱이 그 로봇의 이름과 공유기 고정 IP 192.168.0.(200 + 번호) 를 계산해 보여 주고, 와이파이 (고정 IP) 일 때 로봇 IP 를 채웁니다.

이 칸은 로봇의 이름이나 번호를 바꾸지 않습니다. 로봇 번호는 로봇에서 정합니다 (처음 접속하기 6절). 📶 와이파이 설정… 을 하면 로봇은 자기 번호로 고정 IP 를 거는데, 이 칸이 로봇 번호와 다르면 앱이 다른 주소에서 로봇을 기다립니다. 꼭 같은 번호를 넣으세요.

같은 공유기에 로봇을 여러 대 붙인다면

로봇 번호 · AP 이름 · ROS_DOMAIN_ID 를 로봇마다 다르게 해 둡니다. 번호와 AP 이름은 처음 접속하기 6절, ROS_DOMAIN_ID 는 저장소와 구조에서 다룹니다.

3.3. 연결 방식별로 주소 넣기

랜선 — 이더넷 직결

  1. [PC] 랜선으로 노트북과 로봇을 잇고, 노트북 유선 설정의 IPv4 방식을 다른 컴퓨터에 공유 로 둡니다 (유선 연결 2.1절).
  2. [앱] 이더넷 직결 을 고르고 🔍 찾기 를 누릅니다. 로봇을 찾으면 로봇 IP 가 채워지고 찾음: 10.42.0.170 … 처럼 보입니다. 두 대 이상 찾으면 창 로봇 선택 에서 고릅니다.
  3. 이 주소는 랜선을 다시 꽂을 때마다 바뀔 수 있습니다. 다음에도 🔍 찾기 로 찾습니다.

로봇 AP — AP 모드 (로봇 와이파이)

  1. [PC] 인터넷이 될 때 앱을 켜 둔 뒤(1.3절), 노트북 와이파이를 로봇 AP 에 붙입니다. 새로 구운 카드는 이름 lekiwi01, 비밀번호 lekiwi01 입니다.
  2. [앱] AP 모드 (로봇 와이파이) 를 고르면 아래에 AP 모드 칸이 펼쳐집니다.
  3. ↪ AP 주소 사용 (192.168.4.1) 을 누릅니다. 로봇 IP 가 192.168.4.1 로 바뀌고 연결 확인까지 이어집니다.

Ubuntu 노트북이면 노트북 와이파이를 바꾸는 일까지 앱에 맡길 수도 있습니다 (7.3절).

공유기 — 와이파이 (고정 IP) · 핫스팟 (자동 IP)

  1. [PC] 노트북을 로봇과 같은 공유기에 붙입니다. 로봇을 공유기에 붙이는 방법은 6절에 있습니다.
  2. [앱] 192.168.0.x 공유기면 와이파이 (고정 IP) 를 고릅니다. 킷 번호 를 넣어 두었으면 로봇 IP 가 192.168.0.(200 + 번호) 로 채워집니다.
  3. 다른 대역의 공유기나 휴대폰 핫스팟이면 핫스팟 (자동 IP) 를 고르고 🔍 찾기 를 누릅니다. 로봇 주소를 알면 직접 넣어도 됩니다 (네트워크 (AP · 공유기) 5절).

3.4. [앱] 연결 확인

연결 확인 을 누르면 앱이 로봇을 세 가지로 살펴보고, 줄마다 ✔ · ✖ 로 결과를 보여 줍니다.

결과 줄정상이면✖ 이면
네트워크 · SSH (22)로봇의 SSH 응답<주소> 에 연결하지 못했습니다. — 주소 · 네트워크 · 로봇 전원을 봅니다
로봇 게이트웨이 (8080)로봇 상태 한 줄 (4.2절의 상태 줄과 같은 글)게이트웨이 오류 글
로봇 데이터 노드 (5556)열려 있음열려 있지 않습니다 — 로봇 기능이 꺼져 있으면 정상입니다 (4.1절)
램프뜻
초록로봇에 닿고 데이터 노드도 열려 있습니다 (로봇 기능 켜짐)
노랑로봇에 닿지만 데이터 노드가 닫혀 있습니다 (대개 로봇 기능 꺼짐)
빨강로봇에 닿지 않습니다

게이트웨이가 답하면 앱은 이 로봇을 새 A-Go(ROS 2 로봇)로 기억합니다. 그때부터 화면이 바뀌어 Lekiwi 호스트 줄이 사라지고 로봇 (ROS2) 줄이 생깁니다. 램프에 마우스를 올리면 연결됨 (ROS2 LeKiwi · 로봇 꺼짐) 처럼 결과 요약이 보이고, 다음에 이 화면을 열면 마지막 확인: … 으로 지난 결과를 보여 줍니다. 지금 상태는 연결 확인 을 다시 눌러 봅니다.

연결 확인 결과 — 초록 램프, 로봇 (ROS2) 줄, ✔ 네트워크 · SSH (22) · ✔ 로봇 게이트웨이 (8080) · ✔ 로봇 데이터 노드 (5556) 세 줄

로봇 기능이 켜진 lekiwi01 을 확인한 결과입니다. 세 줄이 모두 ✔ 이고 램프가 초록입니다. 로봇 기능이 꺼져 있으면 셋째 줄이 ✖ … 열려 있지 않습니다 가 되고 램프가 노랑입니다.

▶ 호스트 실행 은 누르지 마세요

새로 만든 Lekiwi 로봇은 연결 확인을 하기 전까지 예전 방식 화면을 보여 줍니다 — Lekiwi 호스트 줄의 ▶ 호스트 실행, 카메라 칸의 🔄 Pi 에서 읽어오기. 새 A-Go 에는 예전 호스트 프로그램이 없어 이 버튼들을 쓸 수 없습니다. 먼저 연결 확인 부터 누릅니다.

3.5. [앱] 로봇 저장

  1. 맨 위 로봇 저장 을 누릅니다. robot id · teleop id · 리더암 포트 · 로봇 IP 가 다 들어가야 켜집니다.
  2. 창 로봇 저장 — 미리보기 에 리더암 USB 포트를 고정하는 규칙이 보입니다. 적용 을 누르고 관리자(시스템) 비밀번호를 넣습니다.
  3. 로봇이 저장되었습니다. 가 뜨면 끝입니다. 처음 저장한 뒤에는 리더암 USB 케이블을 한 번 뺐다 꽂습니다.

주소를 바꾸면 꼭 다시 로봇 저장

칼리브레이션 · 텔레오퍼레이션 · 데이터 · 추론 탭과 그 위의 로봇 상태 띠는 저장된 주소로 로봇에 붙습니다. 연결 방식이나 로봇 IP 를 바꾼 뒤(와이파이 설정 · AP 모드 켜기 · 노트북 AP 연결 뒤도 마찬가지) 로봇 저장 을 하지 않으면 다른 탭은 예전 주소를 씁니다. 저장할 때마다 리더암이 꽂혀 있어야 하고, 관리자 비밀번호를 다시 묻습니다.


4. [앱] 로봇 기능 켜기 · 끄기 — 로봇 (ROS2) 줄

로봇 전원을 켜면 게이트웨이(웹 화면)만 저절로 뜨고, 모터 · 카메라 · 라이다를 다루는 로봇 기능은 꺼진 채입니다. 텔레오퍼레이션 · 데이터 수집 · 추론과 카메라 미리보기는 로봇 기능이 켜져 있어야 합니다. 앱과 웹 화면 어느 쪽에서 켜고 꺼도 같습니다.

4.1. ▶ 로봇 켜기

  1. 로봇 (ROS2) 줄의 ▶ 로봇 켜기 를 누릅니다.
  2. 아래 검은 창에 진행이 한 줄씩 나옵니다. ─── 로봇 켜기 · <주소>:8080 ─── 으로 시작해 ▶ 로봇 기능: 켜는 중 · 실행 중 을 거쳐 ✔ 끝났습니다 (N s) 로 끝납니다. 앱은 최대 90초 기다립니다.
  3. 상태 줄이 로봇 켜짐 · … · 카메라: 전방 ✔ · 손목 ✔ 이 되고, 버튼이 ■ 로봇 끄기 로 바뀌면 됩니다.

앱으로 켜면 카메라도 함께 켜집니다. 켜지 못하면 로봇 기능을 켜지 못했습니다: … — 위 로그를 보세요 나 90 초 안에 로봇 기능이 '실행 중' 이 되지 않았습니다 — 위 로그를 보세요 가 나옵니다. 검은 창의 마지막 줄과 웹 화면의 로그를 봅니다.

4.2. 상태 줄 읽기

상태 줄은 화면이 보이는 동안 1초마다 새로 읽고, 여러 조각을 · 로 이어 보여 줍니다.

조각뜻
로봇 켜짐 · 로봇 꺼짐 · 로봇 켜는 중 · 로봇 끄는 중 · 로봇 켜기 실패로봇 기능의 상태
로봇 켜짐 (바깥에서 실행)앱 · 웹 화면이 아닌 곳(로봇 터미널 등)에서 켰습니다
전압 12.3 V로봇 전원 전압
⛔ 비상 정지 걸림비상 정지가 걸려 있습니다 (9절)
조작: <IP> · <브라우저>웹 화면 같은 다른 화면이 조작 권한을 쥐고 있습니다
PC(ZMQ, <IP>) 조작 중그 PC 의 앱이 텔레오퍼레이션 · 데이터 수집 · 추론으로 로봇을 움직이고 있습니다
ZMQ 시작 대기: <이유> · ZMQ 막힘: <이유> · ZMQ 노드 응답 없음데이터 노드가 앱의 조작을 시작하지 못하는 까닭
빠진 노드: <이름>로봇 기능이 켜졌는데 떠 있지 않은 노드 (모터 드라이버 · 베이스 컨트롤러 · 팔로워 · 라이다 · IMU · 전방 카메라 · 손목 카메라 등)
카메라: 전방 ✔ · 손목 ✔두 카메라 노드가 떠 있는지
팔로워: <이유>팔로워 팔 보정에 대해 로봇이 알리는 것 (아래 정보)

팔로워: 모터 보정 값을 아직 받지 못했습니다 (lekiwi/motor/arm_registers) 가 늘 고장은 아닙니다

로봇이 아직 모터의 보정 값을 받지 않았다는 뜻입니다. 로봇 기능이 꺼져 있으면 보이고, 켜져 있어도 모터 값을 보는 화면(웹 화면 캘리브레이션)이 없으면 남을 수 있습니다. 보정이 모터와 맞는지는 웹 화면 캘리브레이션 의 모터와 맞음 으로 확인합니다. 보정 파일이 아예 없으면 보정 파일 <이름>.json 이 없습니다 처럼 다른 글이 나옵니다 (캘리브레이션).

4.3. ■ 로봇 끄기

접은 자세를 저장하는 방법은 캘리브레이션 5절에 있습니다.

4.4. 웹 화면 열기 ▾

웹 화면 열기 ▾ 를 누르면 대시보드 · 네트워크 · 지도 작성 · 자율 주행 · 로그 가운데 하나를 브라우저로 엽니다 (http://<로봇 IP>:8080/#/<화면>). 지도 작성 · 자율 주행은 앱에 없으므로 웹 화면에서 합니다 (지도 작성 · 자율 주행).

웹 화면 열기 메뉴 — 대시보드 · 네트워크 · 지도 작성 · 자율 주행 · 로그

고른 화면이 브라우저에서 http://<로봇 IP>:8080/#/<화면> 으로 열립니다.

웹 화면에서 조작 권한 받기 를 하면 그동안 앱의 텔레오퍼레이션 · 로봇 켜기 · 보정이 막힙니다. 앱으로 돌아올 때는 웹 화면에서 권한 놓기 를 누릅니다.


5. [앱] 카메라 미리보기 — Lekiwi (카메라) 칸

로봇의 전방(front) · 손목(wrist) 카메라를 앱에서 미리 봅니다. 영상은 게이트웨이로 받으므로 팔을 보정하기 전에도 볼 수 있습니다.

3. Lekiwi (카메라) 칸, 미리보기를 켜기 전 — ▶ 모두 보기, front · wrist 줄의 카메라 노드 실행 중, 아래 모터 칸의 안내 카드

미리보기를 켜기 전입니다. 줄마다 그 카메라의 상태가 보입니다. 아래 모터 칸의 안내 카드는 10절을 봅니다.

  1. ▶ 모두 보기 를 누릅니다. 한 대만 보려면 그 줄의 ▶ 를 누릅니다.
  2. 로봇 기능이 꺼져 있으면 창 카메라 확인 이 “지금 켤까요?” 를 묻습니다. Yes 를 누르면 로봇을 켠 뒤 미리보기가 이어집니다 (로봇을 켜는 중입니다… (위 터미널 창) → 영상을 기다리는 중입니다… → 수신 중).
  3. [로봇] 왼쪽 front 에 로봇 앞 바닥이, 오른쪽 wrist 에 그리퍼가 보이는지 확인합니다.
  4. 다 봤으면 ■ 모두 중지 를 누릅니다.

카메라 미리보기 — 왼쪽 front 에 사무실 바닥과 의자, 오른쪽 wrist 에 보라색 그리퍼 끝

줄의 로봇 30.0 fps 는 카메라의 실제 fps, 영상 아래 640x480 · 14.0 fps 는 미리보기의 해상도와 fps 입니다.

카메라 줄에 나오는 글(카메라 노드 실행 중 · 로봇 N fps · ⚠ 카메라 없이 켜졌습니다 — … 등)의 뜻과 할 일은 카메라 연결 4.3절의 표에 있습니다.


6. [앱] 로봇을 공유기에 붙이기 — 📶 와이파이 설정…

📶 와이파이 설정… 은 로봇이 주변 와이파이에 붙게 하고, 192.168.0.x 공유기면 로봇 번호의 고정 IP 192.168.0.(200 + 번호) 까지 맞춥니다. 이 버튼은 SSH 로 동작합니다. 랜선(이더넷 직결)으로 붙은 상태에서 하는 것이 가장 안전합니다 — 로봇 와이파이가 바뀌는 동안에도 랜선은 끊기지 않습니다. 웹 화면 네트워크 로도 공유기에 붙일 수 있습니다 (네트워크 (AP · 공유기)).

6.1. 처음 한 번 — 앱 키 등록

  1. 📶 와이파이 설정… 을 누릅니다.
  2. 이 노트북에서 처음이면 창 로봇 비밀번호 가 뜹니다 — “roboseasy@<주소> 에 앱 공개키를 한 번만 등록합니다. 이후에는 비밀번호 없이 접속합니다.”
  3. 입력 칸에는 이미 스페이스 한 칸이 들어 있습니다. 로봇 비밀번호(스페이스 한 번)를 바꾸지 않았다면 그대로 OK 를 누릅니다.

카드를 새로 구운 로봇이면 다음 창이 뜰 수 있습니다. 카드를 새로 구웠다면 정상입니다 (SD 카드 굽기 7.2절).

6.2. 와이파이 바꾸기

  1. [앱] 창 로봇 와이파이 설정 의 첫 쪽에 로봇 주변의 와이파이 목록이 나옵니다. 공유기를 고르고 다음 → 을 누릅니다. 목록에 없으면 새로고침 하거나 직접 입력… 으로 이름을 넣습니다. 로봇이 AP 모드일 때는 주변을 찾지 못할 수 있으니 직접 입력… 을 씁니다.
  2. 둘째 쪽에서 공유기 비밀번호를 넣고 로봇 IP 방식 을 고릅니다. 192.168.0.x 공유기면 킷 고정 IP 192.168.0.201 유지 — 192.168.0.x 공유기 (1번 로봇의 예), 다른 대역 공유기나 휴대폰 핫스팟이면 자동 IP (DHCP) — 휴대폰 핫스팟 등 192.168.0.x 가 아닌 망 입니다.
  3. 적용 을 누르면 셋째 쪽에서 ① 설정 전송 → ② 네트워크 재시작 → ③ 재접속·로봇 찾기 → ④ 연결 확인 → ⑤ 기록 확인 이 차례로 진행되고, 끝나면 ✅ <공유기> 에 연결됨 · wlan0 … 이 보입니다.
  4. 와이파이로 전환 (자동 IP 면 핫스팟으로 전환) 을 누릅니다. 창이 닫히고 연결 방식 과 로봇 IP 가 새 값으로 바뀝니다.
  5. [PC] 노트북도 같은 공유기에 붙입니다.
  6. [앱] 연결 확인 → 로봇 저장. 확인되면 랜선을 빼도 됩니다.

7. [앱] AP 모드 칸 — 공유기 없이 쓰기

AP 모드는 로봇이 직접 와이파이를 띄우는 모드입니다 (네트워크 (AP · 공유기) 1절). 연결 방식 에서 AP 모드 (로봇 와이파이) 를 고르면 AP 모드 칸이 펼쳐지고, 연결 확인을 마친 새 A-Go 라면 로봇의 무선 상태를 저절로 읽습니다. 새 A-Go 는 이 칸을 게이트웨이로 처리하므로 SSH 키나 비밀번호가 필요 없습니다.

AP 모드 칸 — 상태 글 로봇 무선: 공유기 연결 · AP 이름 lekiwi01, AP 이름 · 새 비밀번호 칸, AP 모드 켜기 · 노트북을 이 AP 에 연결 · 공유기 모드로 돌아가기 · AP 주소 사용 버튼

공유기 주소(192.168.0.201)로 연결 확인을 마친 뒤 AP 모드 (로봇 와이파이) 를 고른 모습입니다. 로봇은 아직 공유기에 붙어 있고, AP 를 켜면 lekiwi01 이라는 이름으로 뜹니다.

7.1. 칸 구성

칸 · 버튼하는 일
상태 글 · 상태 읽기지금 로봇 무선 상태 — 로봇 무선: AP 켜짐 · 이름 lekiwi01 · 192.168.4.1 또는 로봇 무선: 공유기 연결 (<공유기> · <주소>) · AP 이름 lekiwi01
AP 이름 (예: lekiwi01) · 새 비밀번호 (8~63자) · 보기 · AP 이름·비밀번호 저장로봇 AP 의 이름 · 비밀번호를 바꿉니다 (7.5절)
📡 AP 모드 켜기로봇 무선을 AP 로 바꿉니다. 재부팅해도 AP 로 남습니다 (7.2절)
💻 노트북을 이 AP 에 연결노트북 와이파이를 로봇 AP 로 바꾸고 연결 확인까지 합니다. Ubuntu 에서만 보입니다 (7.3절)
🌐 공유기 모드로 돌아가기저장된 공유기로 돌아갑니다 (7.4절)
↪ AP 주소 사용 (192.168.4.1)로봇 IP 를 192.168.4.1 로 바꾸고 연결 확인을 합니다. 노트북이 이미 로봇 AP 에 붙어 있을 때 씁니다

새로 구운 카드처럼 이미 AP 모드인 로봇에는 3.3절의 ‘로봇 AP’ 순서대로 붙습니다. 연결 확인이 끝나면 상태 글이 로봇 무선: AP 켜짐 · … 으로 바뀝니다.

7.2. 공유기 모드에서 AP 모드로 바꾸기

  1. [앱] 랜선이나 공유기 주소로 연결 확인 이 된 상태에서 AP 모드 (로봇 와이파이) 를 고릅니다.
  2. 📡 AP 모드 켜기 → 확인 창 AP 모드 켜기 → Yes.
  3. 켜지면 로봇 IP 가 192.168.4.1 로 바뀌고 “AP 모드가 켜졌습니다 — … 노트북 와이파이를 lekiwi01 에 연결한 뒤 [연결 확인] 을 누르세요” 가 나옵니다.
  4. [PC] 노트북 와이파이를 로봇 AP 로 바꿉니다 (와이파이 메뉴에서 직접 고르거나 7.3절의 버튼).
  5. [앱] 연결 확인 → 로봇 저장.

공유기 주소로만 붙어 있었다면 AP 로 바뀌는 순간 연결이 끊기고, 상태 글에 명령은 보냈지만 이 주소로는 더 이상 닿지 않습니다 (무선으로 붙어 있었다면 정상). … 가 보입니다. 정상입니다. 랜선으로 붙어 있었다면 연결은 끊기지 않습니다 — 랜선으로 계속 쓰려면 연결 방식 을 이더넷 직결 로 되돌리고 🔍 찾기 를 합니다.

7.3. 💻 노트북을 이 AP 에 연결 (Ubuntu)

  1. 로봇 AP 가 켜져 있거나 로봇 IP 가 192.168.4.1 이고, AP 이름 칸이 채워져 있으면 버튼이 켜집니다.
  2. 확인 창 노트북을 AP 에 연결 → Yes. 새 비밀번호 칸이 비어 있으면 창 로봇 AP 비밀번호 가 AP 비밀번호를 묻습니다 (저장하지 않습니다).
  3. 'lekiwi01' 에 연결하는 중… (최대 40초) 뒤 노트북이 'lekiwi01' 에 연결되었습니다 (192.168.4.x). — 로봇 연결을 확인합니다… 가 나오고, 연결 확인까지 이어집니다.
  4. 로봇 저장.

7.4. 🌐 공유기 모드로 돌아가기

  1. 🌐 공유기 모드로 돌아가기 → 확인 창 공유기 모드로 돌아가기 → Yes. 로봇이 저장된 공유기에 다시 붙고, 붙지 못하면 스스로 AP 로 돌아옵니다.
  2. [PC] 노트북도 그 공유기로 옮깁니다.
  3. [앱] 연결 방식 을 와이파이 (고정 IP) 로 바꾸고 (다른 대역이면 핫스팟 (자동 IP) + 🔍 찾기) 연결 확인 → 로봇 저장.

로봇에 저장된 공유기가 없으면 저장된 공유기가 없어 공유기 모드로 돌아갈 수 없습니다. … 로 거절됩니다. 이때는 6절의 📶 와이파이 설정… 이나 웹 화면 네트워크 로 공유기를 처음 등록합니다.

7.5. AP 이름 · 비밀번호 바꾸기

새로 구운 카드는 모든 로봇의 AP 가 lekiwi01 / lekiwi01 입니다. 교실처럼 로봇이 여러 대면 로봇마다 다른 이름 · 비밀번호로 바꿉니다 (예: 이름 lekiwi02).

  1. 상태를 읽으면 비어 있는 AP 이름 칸에 지금 이름이 채워집니다. 새 이름과 새 비밀번호 (8~63자)를 넣습니다. 둘 다 넣어야 AP 이름·비밀번호 저장 이 켜집니다.
  2. AP 이름·비밀번호 저장 을 누릅니다. AP 가 켜져 있으면 “AP 가 켜져 있어 저장하면 AP 가 다시 시작됩니다. …” 를 묻습니다. Yes 를 누른 뒤 노트북을 새 이름 · 비밀번호로 다시 붙입니다.

비밀번호는 보낸 뒤 칸에서 지우고, 앱 어디에도 저장하지 않습니다. 앱은 AP 이름만 기억합니다.


8. [앱] 로봇 다시 시작 · 로봇 종료

맨 위 로봇 다시 시작 · 로봇 종료 는 SSH 로 라즈베리파이를 다시 시작하거나 끕니다. 연결 확인 으로 로봇에 닿아야 눌립니다.

버튼하는 일그다음
로봇 다시 시작라즈베리파이를 다시 시작합니다. 실행 중인 텔레오퍼레이션 · 수집이 끊깁니다보통 1~2분 뒤 돌아오면 앱이 연결 확인을 다시 합니다. 로봇 기능은 꺼진 채 켜지므로 ▶ 로봇 켜기 를 다시 누릅니다
로봇 종료라즈베리파이를 끕니다로봇이 종료되었습니다. 초록 LED 깜빡임이 멈춘 뒤 전원을 빼세요. 다시 켜려면 로봇 전원을 껐다 켭니다 (앱에서는 켤 수 없습니다)

9. 다른 탭 위의 로봇 상태 띠 — 켜기 · 끄기 · 비상 정지

텔레오퍼레이션 탭, 데이터 › 수집, 추론 실행 화면, 워크스페이스 실행 화면 위에는 보라색 띠가 있습니다. 로봇 설정 탭에 가지 않고도 로봇 상태를 보고 로봇 기능을 켜고 끌 수 있습니다. 로봇 설정 · 칼리브레이션 탭에는 이 띠와 비상 정지 버튼이 없습니다.

데이터 › 수집 화면 위의 로봇 상태 띠 — 초록 점, 로봇 켜짐 상태 글, ■ 로봇 끄기 · ⛔ 비상 정지 버튼

띠의 글은 4.2절의 상태 줄과 같습니다 (그림의 글은 촬영할 때 그 로봇의 상태입니다). 띠는 로봇 저장 으로 저장된 주소를 씁니다.

점 · 글뜻 · 할 일
초록 · 로봇 켜짐 · …쓸 준비가 됐습니다. 다만 조작: <IP> · <브라우저> 가 함께 보이면 웹 화면이 조작 권한을 쥐고 있어, 점이 초록이어도 텔레오퍼레이션 · 수집 · 추론이 시작되지 않습니다 (웹 화면에서 권한 놓기)
빨강 · 로봇 꺼짐 … — [로봇 켜기] 를 누르면 카메라 · 팔 · 바퀴가 켜집니다.▶ 로봇 켜기 를 누릅니다
빨강 · 켜져 있는데 둘째 줄에 까닭지금 조작을 시작할 수 없는 까닭입니다 (데이터 · 학습 · 추론 문제 해결)
빨강 · 로봇 게이트웨이(<주소>:8080)에 연결하지 못했습니다: …네트워크와 저장된 주소를 봅니다 (3.5절)

9.1. ⛔ 비상 정지

⛔ 비상 정지 는 누르는 즉시 로봇에 보내집니다. 웹 화면의 비상 정지와 같은 것입니다.

비상 정지는 팔 토크도 끕니다 — 편 팔이 떨어집니다

로봇은 바퀴를 세우고 바퀴 · 팔 토크를 끕니다. 팔을 편 채 쓸 때는 팔 아래를 비워 둡니다. 키보드 단축키는 없으니 마우스로 누릅니다. 비상 정지를 보내지 못했습니다 — 로봇 게이트웨이에 닿지 않습니다. 로봇의 전원 스위치를 직접 끄세요. 가 뜨면 로봇 전원 스위치를 끕니다.

9.2. 비상 정지 풀기

비상 정지는 풀 때까지 걸려 있고, 상태 줄에 ⛔ 비상 정지 걸림 이 보입니다. 이때 띠에 비상 정지 풀기 가 나타납니다.

  1. [로봇] 주변에 사람 · 케이블이 없는지, 팔 아래가 비었는지 봅니다.
  2. [앱] 비상 정지 풀기 → 확인 창 “비상 정지를 풉니다. … 바퀴 토크를 잠깐 켰다가 끄며, 팔은 그대로입니다.” → Yes.
  3. 창 비상 정지 풀기 에 로봇의 답(예: 바퀴 토크를 켰습니다)이 뜨고, 상태 줄에서 ⛔ 비상 정지 걸림 이 사라지면 풀린 것입니다.

웹 화면에서 건 비상 정지도 앱에서 풀 수 있고, 그 반대도 됩니다 (대시보드와 조작 권한 5절).


10. 신경 쓰지 않아도 되는 칸

칸까닭
배지 네트워크 설정 필요 · 회색 ⚙ Pi 연결 마법사마법사는 아직 동작하지 않습니다. 배지는 연결이 돼도 바뀌지 않으니, 연결 상태는 램프와 연결 확인 결과로 봅니다
팔로워 포트 (자동 — 로봇 호스트 스크립트의 값 (예: /dev/lekiwi)) 와 그 아래 안내 글예전 방식 로봇용입니다. 새 A-Go 는 이 칸을 읽지 않으니 비워 둡니다
고급 설정 (ZMQ 포트)명령 포트 5555 · 영상 포트 5556 그대로 둡니다
모터 칸 안내 카드 (… 모터 ID 설정과 팔로워 보정은 Pi 에서 수행합니다. …)예전 방식 기준의 글입니다. 새 A-Go 의 팔로워 보정은 앱 칼리브레이션 탭이나 웹 화면에서 합니다. 조립된 로봇은 모터 ID 를 다시 정할 일이 없습니다 (모터 셋업)

11. 문제 해결

증상확인할 것
연결 확인 ✖ 네트워크 · SSH (22) — <주소> 에 연결하지 못했습니다.로봇 전원이 켜졌는지 (처음 켤 때는 1~2분), 노트북과 로봇이 같은 네트워크인지 봅니다. 랜선이면 🔍 찾기 로 주소를 다시 찾습니다
🔍 찾기 에서 이더넷 직결 네트워크를 찾지 못했습니다. · 직결된 로봇을 찾지 못했습니다. …랜선과 로봇 전원, 노트북 유선 설정의 IPv4 방식이 다른 컴퓨터에 공유 인지 보고 1~2분 뒤 다시 찾습니다 (유선 연결)
연결 확인 뒤에도 ▶ 호스트 실행 이 보이고 로봇 (ROS2) 줄이 없다게이트웨이(8080)에 닿지 않았습니다. 브라우저로 http://<로봇 IP>:8080 이 열리는지 보고, 열리면 연결 확인 을 다시 누릅니다
로봇 데이터 노드 (5556) — 열려 있지 않습니다로봇 기능이 꺼져 있습니다 → ▶ 로봇 켜기. 켜져 있는데도 닫혀 있으면 예전 이미지일 수 있으니 lekiwi1027 이미지로 굽습니다 (SD 카드 굽기)
leader arm: <포트> 의 시리얼 넘버를 읽지 못했습니다.리더암 USB 가 꽂혀 있어야 저장됩니다
다른 탭의 띠가 로봇 게이트웨이(<주소>:8080)에 연결하지 못했습니다 · 예전 주소를 본다주소를 바꾼 뒤 로봇 저장 을 하지 않았습니다 (3.5절)
다른 화면(<IP> · <브라우저>)이 조작 중입니다 (켜기 · 끄기 · AP · 비상 정지 풀기)웹 화면이 조작 권한을 쥐고 있습니다. 웹 화면에서 권한 놓기 를 누르거나 그 탭을 닫습니다
로봇 상태를 아직 읽지 못했습니다 — … (와이파이 · AP)연결 확인 뒤 몇 초 기다렸다가 다시 합니다
로봇이 움직일 수 있는 동안에는 네트워크를 바꾸지 않습니다. 와 까닭앱의 텔레오퍼레이션 · 수집 · 추론, 웹 화면의 조작 · 자율 주행을 멈추고 2초 뒤 다시 합니다
팔 토크가 켜져 있을 수 있어 네트워크를 바꿀 수 없습니다. …텔레오퍼레이션 뒤 팔에 힘이 남아 있습니다. 칼리브레이션 › 🔓 토크 해제 (직접 교시) 나 ■ 로봇 끄기 를 한 뒤 다시 합니다
저장된 공유기가 없어 공유기 모드로 돌아갈 수 없습니다. …공유기를 아직 등록하지 않았습니다 (6절). 📶 와이파이 설정… 으로 방금 처음 등록했다면 로봇 다시 시작 뒤에 다시 합니다
노트북 주변에서 이 이름의 와이파이를 찾지 못했습니다. … · AP 비밀번호가 맞지 않습니다.로봇 AP 가 켜져 있는지, 노트북이 가까이 있는지, AP 이름 · 비밀번호가 맞는지 봅니다
먼저 랜선으로 연결해 [▶ 호스트 실행] 을 한 번 눌러 SSH 키를 등록해 주세요. (다시 시작 · 종료)📶 와이파이 설정… 으로 키를 등록합니다 (8절)
앱이 로그인 화면에서 넘어가지 않는다노트북이 로봇 AP 에 붙어 인터넷이 없습니다. 인터넷이 되는 와이파이에서 앱을 켠 뒤 로봇 AP 로 바꿉니다 (1.3절)

더 많은 증상은 문제 해결에 있습니다.


12. 정리

다음은 팔을 보정하고, 시범 데이터를 모아 학습시키는 순서입니다.