빠른 시작
이 장만 읽어도 첫 측정을 시킬 수 있습니다.
전체 그림
식당에 빗대면 이렇습니다. 상위 프로그램은 손님이고 서버는 주방입니다. 손님이 주문서 한 장을 내면(“5번 레시피로 측정”), 주방이 요리해서 접시 하나를 내줍니다(“옵셋은 이만큼”). 주방이 먼저 손님을 부르는 일은 없습니다.
측정 한 번은 다섯 걸음입니다.
서버에 붙습니다 (주소
127.0.0.1, 포트18091).주문서 한 줄을 보냅니다:
{"cmd":"measure","recipeId":5}답 한 줄을 받습니다. 보통 1~3초 걸립니다.
답의
ok를 봅니다.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 |
주소 |
|
포트 |
|
보내는 것 |
JSON 한 줄. 줄 끝에 줄 바꿈( |
받는 것 |
JSON 한 줄. 줄 끝에 줄 바꿈( |
명령 |
|
서버에 붙기
상위 프로그램은 서버와 같은 PC 에서 돌립니다. 서버는 “이 PC 자신”에서 오는 접속만 받습니다. 다른 PC 에서 붙으면 거부됩니다.
포트는
18091입니다. 서버를 띄우면 명령 창에 아래 줄이 찍힙니다. 여기 적힌 번호가 실제 포트입니다.[op] 화면 http://127.0.0.1:18090 , 상위 프로그램 TCP 127.0.0.1:18091
번호를 바꾸려면 설정 화면의 “시스템 설정” 창 “통신” 탭에서 고치고 프로그램을 다시 켜거나(
data/config.json의upperPort에 적힙니다), 서버를--upper-port 번호로 띄웁니다.로그인이 없습니다. 붙자마자 주문서를 보내면 됩니다.
한 번 붙어서 계속 써도 됩니다. 서버는 가만히 있는 접속을 끊지 않습니다. 측정할 때마다 새로 붙어도 됩니다.
팁
붙어 있는 동안 운용 화면 위쪽의 상위 칸이 연결됨으로 바뀝니다. 붙었는지 눈으로 확인할 수 있습니다.
다음에 읽을 곳
바로 돌려 볼 코드는 예제 (파이썬)에 있습니다.
줄을 보내고 받을 때 지킬 규칙은 보내고 받는 규칙에 있습니다.
처음 붙일 때의 점검 순서는 시험하고 확인하는 법에 있습니다.