LAB 07 · 수직 농장

재배 로봇 파라미터

수분 센서가 배지 수분을 재서 보내고, 재배 로봇은 받은 값을 자기 기준값과 견줘 밸브를 엽니다. 농장 관리자는 작물에 따라 기준값을 실행 중에 바꿉니다. 내 PC에서 재배 로봇 노드를 켜고 로봄 연결기로 잇습니다. 센서는 서버가 맡아 연결기를 거쳐 /farm/moisture를 1초마다 보내고, 내 노드는 기준값을 파라미터 moisture_threshold로 내놓고 받은 수분마다 /farm/water로 밸브를 엽니다.

연결 순서

누가 무엇을 하나 로봄 서버(수분 센서) → 연결기(퍼블리셔) → /farm/moisture → 내 노드(구독자) → 내 노드(퍼블리셔) → /farm/water → 연결기(구독자) → 로봄 서버 · 수분 막대

기준값 「기준값 읽기 · 바꾸기 · 확인 시작」 → 로봄 서버 → 연결기(파라미터 서비스 클라이언트) → /robom_farm/get_parameters · set_parameters → 내 노드(파라미터를 가진 노드, 콜백에서 거절할 수 있음)

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

ros2 param get /robom_farm moisture_threshold
ros2 param set /robom_farm moisture_threshold 60.0
ros2 topic echo /farm/water
  1. ROS 2 환경 확인

    Ubuntu 24.04 + ROS 2 Jazzy가 필요합니다. 윈도우는 WSL의 Ubuntu에서 합니다. 아래를 차례로 쳐서 jazzy와 메시지 형식(float64 data)이 나오면 됩니다. 파라미터 서비스 형식(rcl_interfaces)도 ROS 2에 늘 들어 있습니다. std_msgs는 ROS 2에 늘 들어 있어 따로 깔 것이 없습니다.

    source /opt/ros/jazzy/setup.bash
    printenv ROS_DISTRO
    ros2 interface show std_msgs/msg/Float64
  2. 연결기 · 연습 노드 내려받기

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

    판 4 · SHA-256 5d4b39f350347fdff1770652a149b9f9549ddeae195802dcbe29c7a71a3eaa22

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

    연습 재배 로봇 노드 내려받기 (robom_farm_sim.py)

    판 2 · SHA-256 db34243532d80a77ab03216757852e4073948003c152626996b096416c5e5e1c

    연습 노드는 연결 · 구독 · 발행 뼈대가 되어 있고, 기준값 파라미터와 거절 콜백은 「# 할 일」로 비어 있습니다. 그대로 켜면(python3 robom_farm_sim.py) 기준값이 코드 안의 상수라 세 과제 모두 떨어집니다. 「# 할 일」을 채워 완성하세요. ROS 2 없이 네트워크만 먼저 볼 때는 연결기의 --demo를 씁니다(연습 모드라서 확인받기는 되지 않습니다). 가짜 재배 로봇은 기준값과 상관없이 밸브를 열고 무엇이든 받아들이는 모양만 맞는 답을 냅니다.

  3. 연결 열쇠 받기

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

    로그인하고 열쇠 받기

  4. 파일 둘러보기

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

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

    1 · 한 장 그림

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

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

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

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

      /farm/moisture(보내기) · /farm/water(지켜보기) · /robom_farm(파라미터)이 이 표에 있어야 연결기가 다룹니다.

      # ── 판 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 보낼 토픽 퍼블리셔 686번째 줄부터

      켤 때 /farm/moisture 퍼블리셔를 미리 만듭니다.

      # 보낼 토픽의 퍼블리셔는 켤 때 미리 만든다(처음 보낸 메시지를 구독자가 놓치지 않게)
      self.publishers = {topic: node.create_publisher(self._need(t), self.prefix + topic, 10) for topic, t in PUBLISH_TOPICS.items()}
    5. 5 지켜볼 토픽 구독 690번째 줄부터

      켤 때 /farm/water를 구독해 둡니다.

      for topic, type_name in WATCH_TOPICS.items():
          node.create_subscription(self._need(type_name), self.prefix + topic, self._watcher(topic, type_name), 10)
    6. 6 파라미터 클라이언트 695번째 줄부터

      /robom_farm 노드의 파라미터를 읽고 바꿀 서비스 클라이언트를 미리 만듭니다.

      # 파라미터 클라이언트도 미리 만든다(처음 만든 클라이언트는 ROS 2 발견에 몇 초 걸린다)
      self.param = {name: self._need(t) for name, t in PARAM_TYPES.items()}
      self.param_clients = {}
      for target in PARAM_NODES:
          self.param_clients[(target, "param_get")] = node.create_client(self.param["get"], self.prefix + target + "/get_parameters")
          self.param_clients[(target, "param_set")] = node.create_client(self.param["set"], self.prefix + target + "/set_parameters")
    7. 7 받은 메시지 담기 750번째 줄부터

      받은 Bool을 값으로 바꿔 올릴 묶음에 넣습니다.

      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
    8. 8 토픽 보내기 790번째 줄부터

      여기서 서버가 보낸 수분을 /farm/moisture로 내보냅니다.

      def _publish(self, line: dict) -> None:
          topic = line["topic"]
          value = line["data"]["data"]
          message = self._type(PUBLISH_TOPICS[topic])(data=float(value) if PUBLISH_TOPICS[topic].endswith("Float64") else value)
          self.publishers[topic].publish(message)
          if topic in REPEAT_TOPICS:
              self.repeat[topic] = [message, time.monotonic() + REPEAT_EVERY]
          self.link.report({"id": line["id"], "kind": "topic_published"})
    9. 9 파라미터 부르기 898번째 줄부터

      기준값을 읽거나 바꾸는 요청을 보내고, 받아들였는지 · 거절 이유를 서버로 올립니다.

      def _call_param(self, line: dict, client) -> None:
          rid, name = line["id"], line["name"]
          if line["kind"] == "param_get":
              request = self.param["get"].Request()
              request.names = [name]
      
              def got(future) -> None:
                  values = future.result().values
                  self._answer(rid, {"kind": "param_values", "values": {name: param_python(values[0]) if values else None}})
      
              callback = got
          else:
              request = self.param["set"].Request()
              request.parameters = [self.param["parameter"](name=name, value=param_message(self.param["value"], line["value"]))]
      
              def done(future) -> None:
                  results = future.result().results
                  ok = bool(results and results[0].successful)
                  reason = str(results[0].reason)[:200] if results else "노드가 답을 주지 않았습니다"
                  self._answer(rid, {"kind": "param_set_result", "successful": ok, "reason": reason})
      
              callback = done
          future = client.call_async(request)
          future.add_done_callback(callback)
          self.calling.append((time.monotonic() + PARAM_FIND_SECONDS, rid, future))

    3 · 연습 노드 읽기 robom_farm_sim.py

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

    #!/usr/bin/env python3"""로봄 연습 재배 로봇 노드 — 배지 수분을 받아 기준값과 견주고 밸브를 여는 ROS 2 노드(뼈대).쓰는 법 (Ubuntu 24.04 + ROS 2 Jazzy):    source /opt/ros/jazzy/setup.bash    python3 robom_farm_sim.py    # 다른 터미널에서 연결기를 켠다: python3 robom_link.py --key <연결 열쇠>장면: 수분 센서가 배지 수분을 재서 보낸다(연결기가 사이트에서 받아 1초마다 /farm/moisture로 보낸다). 재배 로봇은 받은 값을자기 기준값과 견줘 밸브를 연다. 농장 관리자는 작물에 따라 기준값을 실행 중에 바꾼다.- 노드 이름은 robom_farm이다.- 구독자: /farm/moisture(std_msgs/msg/Float64, 배지 수분 %)를 받을 때마다 결정한다.- 퍼블리셔: /farm/water(std_msgs/msg/Bool)로 밸브를 연다(수분 < 기준값이면 true).- --ns <이름>: 노드 · 토픽 이름 앞에 이름 공간을 붙인다(/<이름>/robom_farm). 연결기의 --ns와 같은 이름을 쓴다.연결 · 구독 · 발행 뼈대는 다 되어 있습니다. 「# 할 일」 자리를 채워 완성하세요. 이 파일을 고쳐 가며 배우세요.그대로 켜면 기준값이 코드 안의 상수라 사이트에서 읽을 수도 바꿀 수도 없고, 틀린 값을 거절하지도 않아 농장 과제 셋 모두 통과하지 못합니다.파이썬 표준 라이브러리와 ROS 2에 들어 있는 rclpy · std_msgs · rcl_interfaces만 쓴다(따로 설치할 것이 없다)."""import argparseimport reimport sysVERSION = "2"PARAM = "moisture_threshold"  # 기준값 파라미터 이름(사이트가 이 이름으로 읽고 바꾼다)DEFAULT = 40.0  # 기본 기준값(실수)LOW, HIGH = 0.0, 100.0  # 받아들여야 하는 범위

    기준값 상수 내가 채움 과제 1 · 파라미터 선언, 과제 2 · 바꾼 값 따르기

    지금은 코드 안 상수인 기준값을 바깥에서 읽고 바꿀 수 있는 파라미터로 내놓는 자리입니다.

    THRESHOLD = 40.0  # 할 일: 이 상수 대신 PARAM 이름의 실수 파라미터(기본 DEFAULT)를 선언하고, 결정할 때마다 그 값을 읽으세요.과제 1 · 파라미터 선언, 과제 2 · 바꾼 값 따르기
    def say(text: str) -> None:    print(text, flush=True)

    밸브 결정 뼈대

    수분이 기준값보다 낮으면 밸브를 여는, ROS 2와 상관없는 계산입니다.

    def decide(moisture: float, threshold: float) -> bool:    """밸브를 열지 정한다: 배지 수분이 기준값보다 낮으면 연다(ROS 2와 상관없는 계산)."""    return moisture < threshold
    def run(namespace: str) -> None:    # rclpy와 메시지 형식은 여기서만 불러온다.    import rclpy    from rcl_interfaces.msg import SetParametersResult    from rclpy.node import Node    from std_msgs.msg import Bool, Float64

    노드와 퍼블리셔 뼈대

    /robom_farm 노드와 물 결정을 보낼 퍼블리셔를 만듭니다.

        rclpy.init()    node = Node("robom_farm", namespace=f"/{namespace}" if namespace else "")    water_out = node.create_publisher(Bool, "farm/water" if namespace else "/farm/water", 10)

    파라미터 콜백 내가 채움 과제 3 · 틀린 값 거절하기

    누가 값을 바꾸려 할 때 먼저 불려, 범위 밖이면 거절하는 자리입니다.

        def on_set(parameters) -> SetParametersResult:        # 파라미터 콜백: 누가 값을 바꾸려 할 때 먼저 불린다. 실패를 돌려주면 값이 그대로다.        # 할 일: PARAM이 LOW ~ HIGH 밖이면 이유를 담아 거절하세요. 지금은 무엇이든 받아들입니다.과제 3 · 틀린 값 거절하기        return SetParametersResult(successful=True)    node.add_on_set_parameters_callback(on_set)

    수분 받아 결정하기 내가 채움 과제 2 · 바꾼 값 따르기

    구독 콜백으로, 수분이 올 때마다 그때의 기준값으로 정해 바로 보내므로 기준값을 어디서 읽는지가 중요합니다.

        def on_moisture(message) -> None:        # 구독 콜백: 수분이 올 때마다 불린다. 지금의 기준값으로 정해 바로 보낸다.        threshold = THRESHOLD        water = decide(message.data, threshold)        water_out.publish(Bool(data=water))        say(f"수분 {message.data:.1f} · 기준값 {threshold} → 밸브 {'엶' if water else '닫음'}")    node.create_subscription(Float64, "farm/moisture" if namespace else "/farm/moisture", on_moisture, 10)
        say(f"로봄 연습 재배 로봇 노드 판 {VERSION} · 노드 {node.get_fully_qualified_name()}")

    노드 돌리기 뼈대

    노드를 돌려 콜백이 불리게 하고, 끌 때 정리합니다.

        try:        rclpy.spin(node)    except KeyboardInterrupt:        say("연습 재배 로봇 노드를 끕니다")    finally:        node.destroy_node()        if rclpy.ok():            rclpy.shutdown()
    def main(argv=None) -> int:    parser = argparse.ArgumentParser(prog="robom_farm_sim.py", description="로봄 연습 재배 로봇 노드 판 " + VERSION)    parser.add_argument("--ns", default="", help="이름 공간(예: farm1 → /farm1/robom_farm)")    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)를 찾지 못했습니다. source /opt/ros/jazzy/setup.bash 를 먼저 하세요")        return 2    return 0if __name__ == "__main__":    sys.exit(main())

    지도로 가기

  5. 연결기 켜기

    연결기 파일이 있는 폴더에서 실행합니다. 「연결됨」이 뜨면 서버가 보낸 수분이 막대로 그려지고, 기준값을 읽고 바꿀 수 있습니다.

수직 농장 · 배지 수분과 밸브

연결 안 됨

수분 막대 · 서버가 보낸 최근 수분과 기준값

막대 하나가 서버가 보낸 수분 하나입니다(0 ~ 100%). 가로선이 지금 기준값이고, 밸브를 연 막대는 진하게, 닫은 막대는 옅게, 결정을 아직 받지 못한 막대는 테두리만 그립니다.

    지금 수분
    -
    기준값
    -
    밸브
    -

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

    확인 한 번에 약 25초 걸립니다(망이 느리면 더 걸립니다). 수분 4개를 두 번씩, 한 번은 기준값 60일 때 한 번은 서버가 20 ~ 34.5 사이에서 고른 값일 때 섞은 차례로 보냅니다. 수분마다 바로 앞에 기준값을 바꾸고(다음 수분은 앞 수분이 닿고 2초 뒤), 끝나면 원래 기준값으로 되돌립니다. 값마다 1.5초 안의 마지막 결정을 보고, 확인이 3번 이어서 맞아야 과제 2를 통과합니다.

    「기준값 바꾸기」를 누르면 서버가 연결기에 부탁해 내 노드 /robom_farm의 moisture_threshold를 읽고, 바꾸고, 다시 읽습니다. 0~100 밖의 값(예: 150)도 넣을 수 있습니다. 노드가 거절하는지 보는 과제 3 때문입니다.

    과제 칸

    통과 0/3

    세 과제는 적는 답이 없습니다. 서버가 내 연결 열쇠로 보낸 읽기 · 바꾸기 요청과 받은 답 · 메시지만 보고 판정합니다. 줄마다 지금 무엇이 모자란지 보이고, 조건이 맞으면 「확인받기」로 확인 번호를 받습니다.

    과제 1 · 파라미터 선언

    재배 로봇은 배지 수분이 기준값보다 낮으면 밸브를 엽니다. 농장 관리자가 작물에 따라 기준값을 바꿀 수 있게 하려면 노드가 기준값을 파라미터로 내놓아야 합니다.

    내 PC의 /robom_farm 노드에서 파라미터 moisture_threshold를 실수(기본 40.0)로 선언하세요. 「기준값 읽기」를 눌러 연결기가 읽은 값이 실수이면 「확인받기」로 통과합니다.

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

    힌트 보기
    • 연습 재배 로봇 노드(robom_farm_sim.py)를 먼저 켜고, 다른 터미널에서 연결기를 켭니다. 두 터미널 모두 source /opt/ros/jazzy/setup.bash를 먼저 합니다.
    • 연습 노드는 기준값을 코드 안 상수로 들고 있습니다. 노드가 이름과 기본값을 가진 파라미터를 내놓게 하세요. 기본값을 40이라고 쓰면 정수가 되니 40.0으로 씁니다.
    • 다른 터미널에서 ros2 param get /robom_farm moisture_threshold 를 치면 내 PC에서 값을 볼 수 있습니다.

    과제 2 · 바꾼 값 따르기

    농장 관리자가 기준값을 60으로 올렸습니다. 재배 로봇이 예전 기준 그대로 밸브를 열면 작물이 마릅니다.

    내 노드가 /farm/moisture(std_msgs/msg/Float64, 배지 수분 %)를 받을 때마다 그때의 기준값과 견줘 /farm/water(std_msgs/msg/Bool, 수분 < 기준값이면 true)를 보내게 하세요. 「확인 시작」을 누르면 서버가 수분 넷을 두 번씩, 한 번은 기준값 60일 때 한 번은 서버가 20 ~ 34.5 사이에서 고른 값일 때 섞은 차례로 보냅니다. 수분마다 바로 앞에 기준값을 바꾸고, 끝나면 원래 기준값으로 되돌립니다. 값마다 1.5초 안의 마지막 결정이 맞고, 확인이 3번 이어서 맞으면 「확인받기」로 통과합니다.

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

    힌트 보기
    • 기준값을 노드를 켤 때 한 번만 읽어 변수에 넣어 두면, 서버가 바꿔도 결정이 바뀌지 않습니다. 결정할 때마다 지금 기준값이 무엇인지 노드에 물어보세요.
    • 같은 수분이 기준값 60일 때와 다른 값일 때 한 번씩 오므로, 60을 코드에 적어 두거나 켤 때 한 번만 읽으면 떨어집니다. 기준값은 늘 파라미터에서 읽습니다.
    • 다른 터미널에서 ros2 topic echo /farm/water 로 내 노드가 보내는 결정을, ros2 param get /robom_farm moisture_threshold 로 지금 기준값을 볼 수 있습니다.

    과제 3 · 틀린 값 거절하기

    배지 수분은 0~100 사이입니다. 누가 기준값을 150으로 잘못 넣으면 재배 로봇이 쉬지 않고 밸브를 엽니다.

    값이 바뀌기 전에 불리는 파라미터 콜백에서 0~100 밖의 값을 거절하세요. 화면에서 0~100 밖의 값(예: 150)으로 바꿨을 때 노드가 거절하고, 이어서 읽은 값이 그대로이면 「확인받기」로 통과합니다.

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

    힌트 보기
    • 파라미터 콜백은 값이 바뀌기 전에 불립니다. 새 값을 보고 범위 밖이면 「실패」와 이유를 담은 결과를 돌려주면 값이 그대로 남습니다.
    • 다른 터미널에서 ros2 param set /robom_farm moisture_threshold 150.0 을 쳐 보면 거절하는지 바로 볼 수 있습니다.