예제 (파이썬)

파이썬만 있으면 돕니다. 따로 설치할 것이 없습니다. 다른 언어로 짤 때도 순서는 같습니다. 붙습니다 → 한 줄 보냅니다 → 한 줄 읽습니다 → ok 를 봅니다.

코드

import json, socket

HOST, PORT = "127.0.0.1", 18091
TIMEOUT_S = 10  # 측정 한 번은 보통 1~3초다. 넉넉히 잡는다


def request(sock, reader, message):
    """한 줄 보내고 한 줄 받는다. 답이 없으면 예외가 난다. 그때는 접속을 닫고 새로 붙는다."""
    sock.sendall((json.dumps(message, separators=(",", ":")) + "\n").encode("utf-8"))
    line = reader.readline()
    if not line:
        raise ConnectionError("서버가 접속을 끊었다")
    return json.loads(line)


def main():
    with socket.create_connection((HOST, PORT), timeout=TIMEOUT_S) as sock:
        reader = sock.makefile("r", encoding="utf-8", newline="\n")

        recipes = request(sock, reader, {"cmd": "recipes"})
        print("레시피:", [(r["id"], r["name"]) for r in recipes["recipes"]])

        result = request(sock, reader, {"cmd": "measure", "recipeId": 1})
        if result["ok"]:
            o = result["offset"]
            print("옵셋 mm:", o["x"], o["y"], o["z"], "도:", o["rx"], o["ry"], o["rz"])
        else:
            print("실패:", result["errorCode"])  # 옵셋은 없다. 로봇을 보정하지 않는다


if __name__ == "__main__":
    main()

코드가 하는 일

  • request 는 주문서 하나를 JSON 한 줄로 바꿔 줄 바꿈을 붙여 보내고, readline 으로 답 한 줄을 끝까지 읽습니다(보내고 받는 규칙의 “모아서 읽기”).

  • main 은 레시피 목록을 먼저 묻고, 1번 레시피로 측정을 시킵니다. 답의 ok 를 보고 옵셋을 찍거나 오류 코드를 찍습니다.

  • 10초 안에 답이 없으면 request 에서 예외가 납니다. with 가 접속을 닫아 주므로 시간과 순서의 “접속을 닫고 다시 붙기” 규칙이 그대로 지켜집니다.

  • 서버가 꺼져 있으면 create_connection 에서 ConnectionRefusedError 가 납니다(오류가 났을 때 돌아오는 값의 “답이 오지 않는 오류”).

경고

다시 시도하려면 main 을 처음부터 다시 부르세요. 제한 시간을 넘긴 sock 을 이어 쓰지 마세요.

돌리면 보이는 것

센서 없이 시험용 서버에 붙였을 때의 결과입니다.

레시피: [(1, 'test'), (2, 'test2'), (5, 'demo')]
실패: LOW_QUALITY

1번 레시피는 실제 센서로 등록한 것이라 시험용 무늬와 모양이 다릅니다. 그래서 LOW_QUALITY 가 왔습니다. 시험용 서버에서 성공 응답을 보는 방법은 시험하고 확인하는 법에 있습니다.