센서 · 로그

웹 화면의 센서 화면은 IMU · odom · 모터 9대의 값을 실시간 숫자로 보여 주고, 로그 화면은 웹에서 켠 기능이 내놓는 글을 그대로 보여 줍니다. 평소에는 대시보드만 봐도 충분합니다. 대시보드에 경고가 뜨거나, 기능이 켜지지 않거나, 값이 이상해 보일 때 이 두 화면을 엽니다.

학습 목표

  • 대시보드 센서 수신 칸의 상태 글을 읽고 고장인지 아닌지 가릴 수 있다.
  • 센서 화면에서 IMU · odom · 모터 표를 읽을 수 있다.
  • 로그 화면에서 기능별 출력을 골라 보고, 오류 줄을 찾을 수 있다.
  • 오류처럼 보여도 정상인 줄을 알아볼 수 있다.

1. 언제 무엇을 보나

궁금한 것볼 곳
센서 값이 들어오는지대시보드 → 센서 수신 (2절)
노드가 떠 있는지대시보드 → 노드 (대시보드와 조작 권한)
로봇이 기울거나 돌았는지센서 → IMU (3.1절)
바퀴로 얼마나 움직였는지센서 → odom (3.2절)
모터 한 대가 끊기거나 뜨거운지센서 → 모터 (3.3절)
라이다 스캔 모양조작 화면의 레이더, 지도 작성 · 자율 주행 화면의 지도 (센서 화면에는 없습니다)
로봇 켜기가 실패했거나 노드가 없음로그 → 로봇 (4절)
지도 저장이 안 된다로그 → 지도 저장
자율 주행이 이상하다로그 → 자율 주행

센서 화면은 필요할 때만 여세요

로봇의 웹 화면 프로그램은 열린 화면에 필요한 값만 받습니다. 센서 화면을 열면 IMU 값을 1초에 100번 받으므로, 대시보드와 함께 라즈베리파이를 가장 많이 쓰는 화면입니다. 자율 주행 중에는 센서 화면을 오래 열어 두지 말고 자율 주행 화면을 봅니다.


2. 먼저 대시보드의 센서 수신

대시보드의 모터 · 전원, 센서 수신, 시스템 칸

로봇 기능이 켜진 정상 상태입니다. 가운데 센서 수신 칸에서 스캔 10 Hz · odom 50 Hz · 모터 상태 30 Hz · 전방 카메라 30 Hz 가 정상 이고, IMU 와 손목 카메라 는 보지 않음 입니다.

센서 수신 칸은 값마다 1초에 몇 번 들어오는지(빈도, Hz)와 상태를 보여 줍니다.

2.1. 상태 글

상태뜻할 일
정상기준 빈도 이상으로 들어옵니다없음
측정 중막 받기 시작해 2초 동안 빈도를 재고 있습니다잠시 기다립니다
늦음들어오지만 기준보다 느립니다시스템 칸에서 CPU 가 바쁜지 봅니다. 계속 늦으면 로그를 봅니다
끊김로봇 기능이 켜져 있는데 1초 넘게 오지 않습니다노드 표와 로그(로봇)를 봅니다
꺼짐로봇 기능을 꺼서 오지 않습니다정상입니다. 쓰려면 로봇 켜기
없음아직 한 번도 받지 못했습니다 (로봇 기능을 켜기 전 등). 카메라는 빈도가 0.0 Hz 일 때로봇 기능이 켜져 있는데도 그렇다면 노드 표와 로그를 봅니다
보지 않음그 값을 보는 화면이 없어 로봇에서 받지 않습니다정상입니다. 고장이 아닙니다

2.2. 기준 빈도

센서무엇정상 예 (위 그림)이보다 낮으면 늦음
스캔라이다 스캔10 Hz5 Hz
odom바퀴로 잰 위치 · 속도50 Hz10 Hz
IMU기울기 · 회전대시보드에서는 보지 않음10 Hz
모터 상태모터 9대의 상태30 Hz5 Hz
전방 카메라전방 카메라 영상30 Hz5 Hz
손목 카메라손목 카메라 영상대시보드에서는 보지 않음5 Hz

3. 센서 화면

센서 화면은 IMU · odom · 모터 세 칸입니다. 로봇 기능이 꺼져 있으면 값이 모두 — 이고, 모터 표에는 모터 상태가 들어오지 않습니다 가 나옵니다.

센서 화면 윗부분 — IMU 와 odom 칸

이 그림의 로봇은 IMU 칩이 응답하지 않아 IMU 값이 모두 — 입니다 (4.3절의 로그 예시). 정상인 로봇은 숫자가 계속 바뀝니다. odom 은 로봇이 멈춰 있어 0 입니다.

3.1. IMU

IMU 는 로봇 몸체의 기울기와 회전을 재는 센서입니다.

칸뜻
roll · pitch · yaw기울기와 방향 (°)
자이로 (rad/s) x · y · z축마다 도는 빠르기
가속도 (m/s²) x · y · z축마다 가속도. 가만히 있어도 중력 때문에 0 이 아닌 값이 보입니다

3.2. odom

odom(오도메트리)은 바퀴가 돈 양으로 어림한 로봇의 위치와 속도입니다.

칸뜻
위치 x · 위치 y (m)원점에서 움직인 거리
방향 yaw (°)원점에서 돌아간 방향
속도 vx · vy (m/s) · wz (rad/s)앞뒤 · 좌우 속도와 회전 속도

3.3. 모터 표

센서 화면의 모터 표 — 모터 9대

모터 9대가 모두 연결 · 정상 입니다. 1~6번은 팔, 7~9번은 바퀴이고, 토크는 모두 꺼짐 입니다.

열뜻
ID · 이름모터 번호와 이름. 1 arm_shoulder_pan · 2 arm_shoulder_lift · 3 arm_elbow_flex · 4 arm_wrist_flex · 5 arm_wrist_roll · 6 arm_gripper · 7 base_left_wheel · 8 base_back_wheel · 9 base_right_wheel
연결연결 / 끊김
모드팔은 위치, 바퀴는 속도
토크모터에 힘이 들어가 있는지 (켜짐 / 꺼짐)
위치 (rad) · 속도 (rad/s)모터 축의 각도와 도는 빠르기
부하 (%) · 전압 (V) · 온도 (℃) · 전류 (A)모터에 걸린 힘 · 전원 전압 · 온도 · 전류
상태정상, 또는 이상 내용 전압 · 각도 센서 · 과열 · 과전류 · 과부하

4. 로그 화면

4.1. 보는 법

로그 화면 — 로봇 기능의 출력

로그 → 로봇 을 고른 모습입니다. 맨 위 [웹 오퍼레이터] 실행: ros2 launch lekiwi_bringup bringup.launch.py use_camera:=true 다음에 노드들이 하나씩 시작한 줄과 라이다 줄이 이어집니다.

  1. [웹 화면] 왼쪽 메뉴에서 로그를 엽니다.
  2. [웹 화면] 위의 버튼에서 볼 기능을 고릅니다. 로봇 · 지도 작성 · 자율 주행 · 지도 저장 가운데 하나입니다. 제목 옆 배지는 고른 기능의 지금 상태(실행 중 · 꺼짐 …)입니다.
  3. [웹 화면] 맨 아래 따라가기가 체크돼 있으면 새 줄이 올 때마다 맨 아래로 내려갑니다. 위로 올려 읽고 싶으면 체크를 끕니다.

웹에서 켠 기능만 보입니다

웹 화면이나 Physical Labs 의 ▶ 로봇 켜기로 켠 기능의 출력만 남습니다. 터미널에서 직접 켠 기능(대시보드 배지 외부 실행)은 여기 보이지 않습니다. 아무것도 켜지 않았으면 아직 로그가 없습니다. 웹에서 켠 기능의 출력만 보입니다. 가 나옵니다.

로봇 기능을 켜기 전의 로그 화면

라즈베리파이를 켠 뒤 로봇 기능을 한 번도 켜지 않았으면 배지가 꺼짐 이고 로그가 비어 있습니다.

4.2. 줄 읽는 법

웹 화면이 직접 넣는 줄은 [웹 오퍼레이터] 로 시작합니다.

줄뜻
[웹 오퍼레이터] 실행: ros2 launch …기능을 켰습니다. 뒤에 켠 명령이 그대로 적힙니다
[웹 오퍼레이터] SIGINT 을 보냅니다끄라는 신호를 보냈습니다. 오래 꺼지지 않으면 SIGTERM · SIGKILL 이 이어집니다
[웹 오퍼레이터] 종료 코드 N기능이 끝났습니다. 끄기를 누르지 않았는데 0 이 아닌 숫자로 끝났다면 실패입니다

나머지는 로봇 프로그램이 내는 줄입니다. 대개 [노드 이름-번호] [수준] …: 내용 모양이고, 글자 색이 없으므로 수준 글자로 무엇이 중요한지 가립니다.

수준뜻
[INFO] · [info]알림입니다. 대부분이 이것입니다
[WARN]주의입니다. 먼저 아래 4.4절의 ‘정상인 줄’인지 봅니다
[ERROR] · [FATAL]오류입니다. 특히 process has died 는 그 노드가 죽었다는 뜻입니다

4.3. 예: 노드가 죽은 경우

로그에서 IMU 노드가 죽은 부분

lekiwi_imu_node 가 [FATAL] … BMI160 not found on /dev/i2c-1 address 0x68 (no response) 를 남기고, [ERROR] [lekiwi_imu_node-3]: process has died […, exit code 1, …] 로 끝났습니다. 나머지 노드는 계속 돌아 로봇 기능은 실행 중 입니다.

이때 다른 화면에는 이렇게 보입니다.

메시지는 IMU 칩(BMI160)이 응답하지 않는다는 뜻이고, 배선 · 전원을 확인하라고 덧붙입니다(Check wiring, power …). 로봇 기능을 껐다 켜 보고, 같은 줄이 또 나오면 문제 해결을 봅니다.

4.4. 정상인데 오류처럼 보이는 줄

줄 (일부)언제뜻
Please set the initial pose · StaticLayer: "map" ... does not exist · Timed out waiting for transform from base_footprint to map자율 주행을 켠 뒤, 초기 위치를 정하기 전로봇이 지도 어디에 있는지 아직 몰라서 되풀이해 나옵니다. 자율 주행 화면에서 초기 위치를 정하면 그칩니다
[웹 오퍼레이터] SIGINT 을 보냅니다 와 뒤따르는 종료 줄기능을 끌 때끄는 과정입니다

5. 문제 해결

증상확인할 것
센서 수신에 보지 않음 이 있다정상입니다. 그 값을 보는 화면이 없을 뿐입니다
스캔 · odom · 모터 상태 · 전방 카메라 가 모두 0.0 Hz 에 없음 또는 꺼짐로봇 기능이 꺼져 있습니다. 대시보드에서 로봇 켜기
센서 하나가 끊김노드 표에서 그 노드가 있음 인지 보고, 로그(로봇)에서 그 노드 이름을 찾습니다
IMU 값이 모두 —노드 표의 lekiwi_imu_node 와 로그를 봅니다 (4.3절)
모터 표에 끊김 이 있다그 모터의 케이블과 전원을 봅니다 (문제 해결)
모터 상태 가 과열 이거나 경고 온도가 높습니다조작을 멈추고 모터를 식힙니다
odom 원점으로가 거절된다지도 작성 · 자율 주행을 끄고, 조작 권한을 받은 뒤 다시 누릅니다
로그가 비어 있다 (아직 로그가 없습니다 …)아직 켜지 않았거나 터미널에서 켰습니다. 웹 화면이나 Physical Labs 로 켠 기능만 보입니다
로그에 같은 줄이 두 번 보인다기능을 고른 순간 생기는 알려진 한계입니다. 무시해도 됩니다
자율 주행 로그에 Please set the initial pose 가 계속 나온다정상입니다. 초기 위치를 정하면 그칩니다

6. 정리