LAB 03 · 셔틀 호출

셔틀 정류장 서비스 만들기

셔틀이 정류장 셋을 잇는 순환 노선을 쉬지 않고 돕니다. 내 PC의 셔틀 노드는 자기 위치를 /shuttle/position 토픽으로 알리고, 정류장에서 「몇 분 뒤 도착?」을 물으면 /shuttle/arrival 서비스로 그 위치에서 계산한 답을 돌려줍니다. 실제 버스 도착 안내도 차량 위치를 아는 쪽이 계산해 줍니다. 토픽이 한 방향으로 흘려보내는 통신이라면, 서비스는 묻고 답을 받는 통신입니다.

연결 순서

누가 무엇을 하나 지도 단추 → 로봄 서버 → 연결기(서비스 클라이언트 · 위치 구독자) → /shuttle/arrival · /shuttle/position → 내 노드(서비스 서버 · 위치 퍼블리셔)

돌아오는 길 내 노드의 답(minutes)과 위치 → 연결기 → 로봄 서버 → 정류장 말풍선 · 노선 위 셔틀

내 PC에서 직접 확인하는 명령(노드와 연결기가 켜진 뒤):

ros2 node info /robom_shuttle_sim
ros2 topic echo /shuttle/position
ros2 service call /shuttle/arrival robom_interfaces/srv/ShuttleEta "{stop: 1}"
  1. ROS 2 환경 확인

    Ubuntu 24.04 + ROS 2 Jazzy가 필요합니다. 윈도우는 WSL의 Ubuntu에서 합니다. 아래를 쳐서 jazzy가 나오면 됩니다.

    source /opt/ros/jazzy/setup.bash
    printenv ROS_DISTRO

    이 실습실의 형식은 로봄 형식 패키지 robom_interfaces에 들어 있습니다. 내려받아 한 번만 빌드합니다.

    형식 패키지 내려받기 (robom_interfaces.tar.gz)

    판 1.0.0 · SHA-256 1630d68bff6b67a55c23226f7944cff52586ac11ebcb2c9bd2009c0ac88b1554

    mkdir -p ~/robom_ws/src && cd ~/robom_ws/src
    tar -xzf ~/Downloads/robom_interfaces.tar.gz
    cd ~/robom_ws && source /opt/ros/jazzy/setup.bash
    colcon build --packages-select robom_interfaces
    source ~/robom_ws/install/setup.bash
    ros2 interface show robom_interfaces/srv/ShuttleEta

    마지막 형식이 보이면 끝입니다. source ~/robom_ws/install/setup.bash는 노드 터미널과 연결기 터미널 모두에서 합니다.

  2. 연결기 · 연습 노드 내려받기

    로봄 연결기 내려받기 (robom_link.py)

    판 4 · SHA-256 5d4b39f350347fdff1770652a149b9f9549ddeae195802dcbe29c7a71a3eaa22

    이 실습실은 연결기 판 4 이상이어야 합니다. 받은 파일이 맞는지는 sha256sum robom_link.py로 견줘 봅니다.

    연습 셔틀 노드 내려받기 (robom_shuttle_sim.py)

    판 2 · SHA-256 7201984f5ce93b610121f4071f0d12a3f7ad7dad29cc71f9f9e8f798a8ea78a6

    연습 셔틀 노드는 뼈대(위치 보내기 · 서비스 열기)는 되어 있고, 서비스 콜백의 「# 할 일」을 채워 완성하는 노드입니다: python3 robom_shuttle_sim.py. 그대로 켜면 과제 1은 되지만 과제 2는 「셔틀 위치로 보면 n분입니다」로 떨어집니다. ROS 2 없이 네트워크만 먼저 볼 때는 연결기의 --demo를 씁니다(연습 모드라서 확인받기는 되지 않습니다). 가짜 셔틀은 위치와 상관없이 늘 같은 분으로 답합니다.

  3. 연결 열쇠 받기

    열쇠는 로그인한 학생만 받습니다.

    로그인하고 열쇠 받기

  4. 파일 둘러보기

    켜기 전에 내려받은 두 파일이 무엇을 하는지 봅니다. 그림의 화살표를 누르면 그 일을 하는 코드가 아래에서 밝아집니다.

    연결기와 연습 노드 둘러보기

    1 · 한 장 그림

    내 PC
    내 노드robom_shuttle_sim.py
    연결기robom_link.py
    로봄 사이트
    로봄 서버열쇠 · 판정
    지도이 화면

    2 · 연결기 둘러보기 robom_link.py

    연결기는 이 실습실에서 아래 8곳을 씁니다. 내 PC의 ROS 2 쪽에서는 퍼블리셔 · 구독자 · 서비스 · 액션 · 파라미터 클라이언트 노릇을, 사이트 쪽에서는 HTTP로 묻고 올리는 노릇을 합니다.

    1. 1 허용 목록 52번째 줄부터

      /shuttle/position(지켜보기)과 /shuttle/arrival(서비스)이 이 표에 있어야 연결기가 다룹니다.

      # ── 판 4 허용 목록 (바로잡기 명세 1-2절) ── 서버(app/link/state.py)의 목록과 같아야 한다. 목록 밖은 연결기가 거절한다.
      INTERFACES = "robom_interfaces"
      SERVICES = {"/shuttle/arrival": "robom_interfaces/srv/ShuttleEta"}  # 셔틀 정류장
      ACTIONS = {"/cafe/brew": "robom_interfaces/action/Brew"}  # 바리스타 로봇
      PUBLISH_TOPICS = {  # 사이트가 보내 달라고 할 수 있는 토픽
          "/crossroad/signal": "std_msgs/msg/String",
          "/farm/moisture": "std_msgs/msg/Float64",
      }
      REPEAT_TOPICS = ("/crossroad/signal",)  # 다음 값이 올 때까지 같은 값을 다시 보낸다(교차로가 신호를 계속 방송하는 장면)
      REPEAT_EVERY = 0.5
      WATCH_TOPICS = {  # 켜질 때 모두 구독해 두고, 받은 것을 1초에 한 번 모아 올린다
          "/shuttle/position": "std_msgs/msg/Float64",
          "/crossroad/cmd_vel": "geometry_msgs/msg/Twist",
          "/energy/robot_status": "std_msgs/msg/Header",
          "/farm/water": "std_msgs/msg/Bool",
      }
      PARAM_NODES = ("/robom_farm",)  # 파라미터를 읽고 바꿀 수 있는 노드
      DRONE_TOPICS = {  # 드론(3차부터 그대로)
          "/drone/pose": "geometry_msgs/msg/PoseStamped",
          "/drone/battery": "sensor_msgs/msg/BatteryState",
          "/drone/command": "std_msgs/msg/String",
      }
    2. 2 명령 받기 273번째 줄부터

      HTTP로 기다렸다가 서버가 보낸 「몇 분?」 요청을 받아 ROS 2 쪽으로 넘깁니다.

      def command_loop(self) -> None:
          tries = 0
          while not self.stop.is_set():
              try:
                  commands = self.server.wait_commands()
                  tries = 0
              except KeyExpired:
                  self._expired()
                  return
              except ServerSaid as error:
                  say(error.args[0])
                  self.stop.wait(1.0)
                  continue
              except (urllib.error.URLError, OSError):
                  tries = self._retry(tries, "받기")
                  continue
              for line in commands:
                  if isinstance(line, str):  # 판 1 모양(서버가 판 머리를 못 본 때)
                      line = {"kind": "drone", "command": line}
                  if not isinstance(line, dict):
                      continue
                  kind = line.get("kind")
                  if kind == "drone" and line.get("command") in ("start", "stop"):
                      say(f"명령 받음: {line['command']}")
                      self.on_command(line["command"])
                  elif kind in REQUEST_KINDS and isinstance(line.get("id"), str):
                      what = line.get("name") or line.get("topic") or ""
                      say(f"요청 받음: {kind} {what}".rstrip())
                      self.on_request(line)
    3. 3 지켜본 메시지 올리기 305번째 줄부터

      구독해서 받은 셔틀 위치를 1초에 한 번 모아 서버로 올립니다.

      def watch_loop(self) -> None:
          """지켜본 메시지를 WATCH_EVERY초에 한 번 모아 올린다(판 3). 받은 것이 없으면 보내지 않는다."""
          tries = 0
          while not self.stop.wait(WATCH_EVERY):
              batch = self._take_watched()
              if not batch:
                  continue
              try:
                  self.server.report({"kind": "topic_watch", "messages": batch})
                  tries = 0
              except KeyExpired:
                  self._expired()
                  return
              except ServerSaid as error:
                  say(error.args[0])
                  if error.status == 429:  # 속도 제한: 묶음을 되돌려 두고 다음 차례에 함께 보낸다(모양 오류는 버린다)
                      self._put_back(batch)
              except (urllib.error.URLError, OSError):
                  tries = self._retry(tries, "지켜본 메시지 올리기")
    4. 4 지켜볼 토픽 구독 690번째 줄부터

      켤 때 /shuttle/position을 구독해 둡니다.

      for topic, type_name in WATCH_TOPICS.items():
          node.create_subscription(self._need(type_name), self.prefix + topic, self._watcher(topic, type_name), 10)
    5. 5 서비스 · 액션 클라이언트 704번째 줄부터

      robom_interfaces가 있으면 /shuttle/arrival 서비스 클라이언트를 미리 만듭니다.

      # 서비스 · 액션 클라이언트: 형식 패키지(robom_interfaces)가 있으면 미리 만든다
      self.clients, self.actions = {}, {}
      for name, type_name in SERVICES.items():
          if self._type(type_name) is not None:
              self.clients[name] = node.create_client(self._type(type_name), self.prefix + name)
      for name, type_name in ACTIONS.items():
          if self._type(type_name) is not None:
              self.actions[name] = action_client(node, self._type(type_name), self.prefix + name)
    6. 6 받은 메시지 담기 750번째 줄부터

      받은 위치 메시지를 칸 이름이 붙은 값으로 바꿔 올릴 묶음에 넣습니다.

      def _watcher(self, topic: str, type_name: str):
          def on_message(message) -> None:
              data = to_plain(type_name, message)
              if data is not None:
                  self.link.watch(topic, data)
      
          return on_message
    7. 7 서비스 · 액션 부르기 857번째 줄부터

      서버가 보낸 정류장 번호로 요청을 채워 내 노드의 서비스를 부릅니다.

      try:
          if kind == "service_call":
              future = self.clients[name].call_async(fill(type_.Request(), line["request"]))
              future.add_done_callback(lambda f: self._replied(rid, f.result()))
          else:
              future = self.actions[name].send_goal_async(
                  fill(type_.Goal(), line["goal"]),
                  feedback_callback=lambda f: self.link.report({"id": rid, "kind": "action_feedback", "feedback": plain(f.feedback)}),
              )
              future.add_done_callback(lambda f: self._accepted(rid, f.result()))
      except (TypeError, ValueError, AssertionError, AttributeError):
          self._fail(rid, "요청 값이 형식에 맞지 않습니다")
    8. 8 서비스 답 올리기 873번째 줄부터

      내 노드가 돌려준 답(minutes)을 서버로 올립니다.

      def _replied(self, rid: str, response) -> None:
          if response is None:
              self._fail(rid, "서비스 서버가 답을 주지 않았습니다. 내 노드의 터미널에 오류가 있는지 보세요")
          else:
              self.link.report({"id": rid, "kind": "service_reply", "response": plain(response)})

    3 · 연습 노드 읽기 robom_shuttle_sim.py

    파일 전체입니다(표지 주석 줄만 뺐습니다). 그대로 두는 뼈대는 어두운 바탕, 내가 채우거나 고칠 줄(「# 할 일」 주석과 그 자리의 코드)은 노란 바탕이고, 「# 할 일」 옆에 그 과제 이름이 있습니다.

    #!/usr/bin/env python3"""로봄 연습 셔틀 노드 — 셔틀 호출 구역의 순환 노선을 도는 셔틀. 뼈대는 되어 있고, 「# 할 일」을 채워 완성하는 노드다.쓰는 법 (Ubuntu 24.04 + ROS 2 Jazzy, 형식 패키지 robom_interfaces를 빌드해 둔 뒤):    source /opt/ros/jazzy/setup.bash    source ~/robom_ws/install/setup.bash    python3 robom_shuttle_sim.py    # 다른 터미널에서도 같은 두 줄을 source하고 연결기를 켠다: python3 robom_link.py --key <연결 열쇠>이 셔틀 노드가 하는 일 (한 노드가 두 역할):- 퍼블리셔: 노선(한 바퀴 12칸, 1초에 1칸) 위의 자기 위치를 /shuttle/position(std_msgs/msg/Float64)으로 1초에 5번 보낸다. (완성됨)- 서비스 서버: /shuttle/arrival(robom_interfaces/srv/ShuttleEta)을 열고, 「n번 정류장까지 몇 분?」(request.stop)에  남은 분(response.minutes)으로 답한다. (서버를 여는 데까지는 완성됨, 계산은 「# 할 일」)- --ns <이름>: 토픽 · 서비스 이름 앞에 이름 공간을 붙인다(/<이름>/shuttle/...). 연결기의 --ns와 같은 이름을 쓴다.정류장 1 · 2 · 3은 노선의 0 · 4 · 8칸째에 있다. 1칸 = 1분으로 본다.그대로 켜면 과제 1(서비스로 답하기)은 통과하지만, 과제 2(셔틀 위치로 답하기)는 「셔틀 위치로 보면 n분입니다」 한 줄로 떨어진다.파이썬 표준 라이브러리와 ROS 2에 들어 있는 rclpy · std_msgs, 그리고 내려받아 빌드한 robom_interfaces만 쓴다.이 파일을 고쳐 가며 배우세요. 「# 할 일」을 채운 뒤 노드를 다시 켜고 같은 정류장을 두 번 물어 보면 답이 바뀌는 것이 보입니다."""import argparseimport reimport sysVERSION = "2"LAP = 12.0  # 노선 한 바퀴 칸 수SPEED = 1.0  # 1초에 가는 칸 수SEND_PER_SECOND = 5  # 위치를 보내는 횟수(1초에)STOPS = {1: 0.0, 2: 4.0, 3: 8.0}  # 정류장 번호 → 노선의 몇 칸째def say(text: str) -> None:    print(text, flush=True)def make_node(namespace: str):    """셔틀 노드를 만든다. rclpy와 메시지 형식은 여기서만 불러온다."""    from rclpy.node import Node    from robom_interfaces.srv import ShuttleEta    from std_msgs.msg import Float64    prefix = f"/{namespace}" if namespace else ""

    셔틀 노드 만들기 뼈대

    위치를 보낼 퍼블리셔, 1초에 5번 부를 타이머, /shuttle/arrival 서비스 서버를 만듭니다.

        class Shuttle(Node):        def __init__(self):            super().__init__("robom_shuttle_sim")            self.position = 0.0  # 지금 노선의 몇 칸째에 있나(0 이상 12 미만)            self.publisher = self.create_publisher(Float64, prefix + "/shuttle/position", 10)            self.create_timer(1.0 / SEND_PER_SECOND, self.drive)            self.create_service(ShuttleEta, prefix + "/shuttle/arrival", self.arrival)

    위치 보내기 뼈대

    타이머마다 셔틀을 조금 움직이고 지금 노선 위치를 보냅니다.

            def drive(self):            # 타이머 콜백: 셔틀을 조금 움직이고 지금 위치를 보낸다. 연결기가 이 토픽을 구독해 지도에 셔틀을 그린다.            self.position = (self.position + SPEED / SEND_PER_SECOND) % LAP            message = Float64()            message.data = self.position            self.publisher.publish(message)

    정류장 답하기 내가 채움 과제 2 · 셔틀 위치로 답하기

    서비스 콜백으로, 요청의 정류장 번호를 읽고 셔틀 위치로 계산한 답을 채워 돌려주는 자리입니다.

            def arrival(self, request, response):            # 서비스 콜백: 요청(request.stop)을 읽고 답(response.minutes)을 채워 돌려준다.            # 연결기는 로봄 서버가 보낸 요청을 이 서비스에 넘기고, 돌려준 답을 서버로 보낸다.            stop = request.stop            # 할 일: 셔틀이 지금 어디 있는지 보지 않습니다. self.position으로 계산하세요과제 2 · 셔틀 위치로 답하기            #        (STOPS[stop]이 정류장 자리, 노선은 한 바퀴 LAP칸, 정류장이 셔틀 뒤에 있으면 한 바퀴를 돌아야 닿습니다)            response.minutes = stop * 2            say(f"요청 받음: 정류장 {stop}번 → {response.minutes}분 뒤 도착 (셔틀은 {self.position:.1f}칸째)")            return response
        return Shuttle()

    노드 돌리기 뼈대

    노드를 돌려 타이머와 서비스 콜백이 불리게 하고, 끌 때 정리합니다.

    def run(namespace: str) -> None:    import rclpy    rclpy.init()    node = make_node(namespace)    say(f"로봄 연습 셔틀 노드 판 {VERSION} · /shuttle/position을 보내고 /shuttle/arrival(robom_interfaces/srv/ShuttleEta)에 답합니다")    try:        rclpy.spin(node)  # 타이머마다 drive(), 요청이 올 때마다 arrival()이 불린다    except KeyboardInterrupt:        say("연습 셔틀 노드를 끕니다")    finally:        node.destroy_node()        if rclpy.ok():            rclpy.shutdown()
    def main(argv=None) -> int:    parser = argparse.ArgumentParser(prog="robom_shuttle_sim.py", description="로봄 연습 셔틀 노드 판 " + VERSION)    parser.add_argument("--ns", default="", help="이름 공간(예: bus1 → /bus1/shuttle/arrival)")    args = parser.parse_args(argv)    if args.ns and not re.fullmatch(r"[A-Za-z][A-Za-z0-9_]{0,31}", args.ns):        say("--ns는 영문자로 시작하는 32자 안의 영문 · 숫자 · _만 됩니다")        return 2    try:        run(args.ns)    except ImportError:        say("ROS 2(rclpy)나 robom_interfaces를 찾지 못했습니다. source /opt/ros/jazzy/setup.bash 와 "            "source ~/robom_ws/install/setup.bash 를 먼저 했는지 보세요")        return 2    return 0if __name__ == "__main__":    sys.exit(main())

    지도로 가기

  5. 연결기 켜기

    연결기 파일이 있는 폴더에서 실행합니다. 「연결됨」이 뜨면 지도의 「몇 분 뒤 도착?」을 누를 수 있습니다.

셔틀 호출 지도 · 순환 노선과 정류장 셋

연결 안 됨
1 물빛광장 2 별빛마을 3 구름나래 창고
↓ 돌봄 · 준비 중

셔틀 위치(/shuttle/position)를 기다리는 중입니다.

연결기가 붙으면 누를 수 있습니다.

노선은 한 바퀴 12칸이고 셔틀은 1초에 1칸 갑니다(1칸 = 1분). 단추를 누르면 서버가 정류장 번호(stop)를 연결기로 보내고, 연결기가 내 PC의 /shuttle/arrival을 부릅니다. 답은 5초 안에 와야 하고, 서버는 답을 받은 순간 직전의 셔틀 위치로 답이 맞는지 셈합니다. 다시 물으면 셔틀이 다가온 만큼 숫자가 줄어듭니다.

과제 칸

통과 0/2

두 과제는 적는 답이 없습니다. 서버가 내 연결 열쇠로 받은 서비스 답과 셔틀 위치만 보고 판정합니다. 줄마다 지금 무엇이 모자란지 보이고, 조건이 맞으면 「확인받기」로 확인 번호를 받습니다.

과제 1 · 서비스로 답하기

셔틀 호출 구역 정류장에 「몇 분 뒤 도착?」 단추가 생겼습니다. 주민이 단추를 누르면 내 셔틀 노드가 답해야 합니다.

내 PC에서 /shuttle/arrival 서비스(robom_interfaces/srv/ShuttleEta)를 여는 셔틀 노드와 연결기를 켜세요. 지도에서 「몇 분 뒤 도착?」을 누른 요청에 5초 안에 형식이 맞는 답(minutes 칸의 정수)이 오면 「확인받기」로 통과합니다.

로그인하고 연결 열쇠로 연결기를 켜면 서버가 받은 답으로 판정합니다

힌트 보기
  • 연습 셔틀 노드(robom_shuttle_sim.py)를 먼저 켜고, 다른 터미널에서 연결기를 켭니다. 두 터미널 모두 ROS 2와 ~/robom_ws/install/setup.bash를 source합니다.
  • ros2 service list 에 /shuttle/arrival이 보이면 서비스 서버가 켜진 것입니다. ros2 service call /shuttle/arrival robom_interfaces/srv/ShuttleEta "{stop: 1}" 로 직접 불러 볼 수 있습니다.

과제 2 · 셔틀 위치로 답하기

셔틀은 노선을 쉬지 않고 돕니다. 같은 정류장이라도 셔틀이 어디 있느냐에 따라 기다릴 시간이 다릅니다. 셔틀 노드는 자기 위치를 아니까, 그 위치로 계산해 답해야 합니다.

노선은 한 바퀴 12칸이고 셔틀은 1초에 1칸 갑니다(1칸 = 1분). 정류장 1 · 2 · 3은 0 · 4 · 8칸째에 있습니다. 요청의 stop을 읽고, 셔틀이 지금 있는 칸에서 그 정류장까지 남은 칸 수를 minutes에 넣으세요. 셔틀이 정류장에 서 있으면 0입니다. 서버는 답을 받은 순간 직전의 /shuttle/position으로 기대값을 셈해 ±1분 안이면 맞음으로 봅니다. 정류장 셋 모두 맞게 답하고, 셔틀이 움직인 뒤 같은 정류장을 다시 물어 답이 바뀌면 「확인받기」로 통과합니다. 셔틀이 이미 지나간 정류장도 한 번은 물어야 합니다(판정 줄이 지금 물을 만한 정류장을 일러 줍니다). 틀린 답이 한 번 나오면 정류장마다 최근 답 셋이 모두 맞아야 다시 통과할 수 있습니다.

로그인하고 연결 열쇠로 연결기를 켜면 서버가 받은 답으로 판정합니다

힌트 보기
  • 노드는 셔틀 위치를 이미 알고 있습니다. 서비스 콜백에서 정류장 번호 대신 그 위치를 읽어 남은 칸 수를 계산하세요.
  • 정류장이 셔틀보다 뒤에 있으면 한 바퀴를 돌아야 닿습니다. 남은 칸 수가 늘 0 이상 12 미만이 되게 하세요.
  • ros2 topic echo /shuttle/position 으로 셔틀 위치를 보며 ros2 service call로 답을 견줘 볼 수 있습니다.