빠른 시작

이 장만 읽어도 첫 측정을 시킬 수 있습니다.

전체 그림

식당에 빗대면 이렇습니다. 상위 프로그램은 손님이고 서버는 주방입니다. 손님이 주문서 한 장을 내면(“5번 레시피로 측정”), 주방이 요리해서 접시 하나를 내줍니다(“옵셋은 이만큼”). 주방이 먼저 손님을 부르는 일은 없습니다.

측정 한 번은 다섯 걸음입니다.

  1. 서버에 붙습니다 (주소 127.0.0.1, 포트 18091).

  2. 주문서 한 줄을 보냅니다: {"cmd":"measure","recipeId":5}

  3. 답 한 줄을 받습니다. 보통 1~3초 걸립니다.

  4. 답의 ok 를 봅니다.

  5. ok 가 true 면 offset 을 씁니다. false 면 errorCode 를 보고 대응합니다(오류가 났을 때 돌아오는 값).

경고

ok 가 false 면 로봇을 보정하지 마세요. 오류 응답에는 옵셋이 없습니다. 앞 측정의 옵셋을 다시 쓰지도 마세요.

실제로 주고받은 줄은 이렇습니다.

보냄  {"cmd":"measure","recipeId":5}
받음  {"at":"2026-11-22T03:38:42","source":"upper","recipeId":5,"ok":true,"offset":{"x":-0.0033,"y":-0.0007,"z":0.0000,"rx":-0.0000,"ry":0.0000,"rz":-0.0000},"inlierShare":1.000,"fitness":1.000,"inlierRmseMm":0.0097,"usedFallback":false,"elapsedMs":354}

한눈에 보는 규격

항목

값

통로

TCP, 글자는 UTF-8

주소

127.0.0.1 (같은 PC 에서만 붙을 수 있습니다)

포트

18091 (임시 값)

보내는 것

JSON 한 줄. 줄 끝에 줄 바꿈(\n)

받는 것

JSON 한 줄. 줄 끝에 줄 바꿈(\n)

명령

measure (측정), recipes (레시피 목록) 둘뿐입니다

서버에 붙기

  • 상위 프로그램은 서버와 같은 PC 에서 돌립니다. 서버는 “이 PC 자신”에서 오는 접속만 받습니다. 다른 PC 에서 붙으면 거부됩니다.

  • 포트는 18091 입니다. 서버를 띄우면 명령 창에 아래 줄이 찍힙니다. 여기 적힌 번호가 실제 포트입니다.

    [op] 화면 http://127.0.0.1:18090 , 상위 프로그램 TCP 127.0.0.1:18091
    

    번호를 바꾸려면 설정 화면의 “시스템 설정” 창 “통신” 탭에서 고치고 프로그램을 다시 켜거나(data/config.json 의 upperPort 에 적힙니다), 서버를 --upper-port 번호 로 띄웁니다.

  • 로그인이 없습니다. 붙자마자 주문서를 보내면 됩니다.

  • 한 번 붙어서 계속 써도 됩니다. 서버는 가만히 있는 접속을 끊지 않습니다. 측정할 때마다 새로 붙어도 됩니다.

팁

붙어 있는 동안 운용 화면 위쪽의 상위 칸이 연결됨으로 바뀝니다. 붙었는지 눈으로 확인할 수 있습니다.

다음에 읽을 곳