scan-3d 상위 프로그램 작성 안내

이 매뉴얼은 scan-3d 운용 서버(operation-server)에 측정을 시키는 상위 프로그램을 처음 만드는 분을 위한 것입니다. 통신 프로그램을 짜 본 적이 없어도 따라올 수 있게 썼습니다.

상위 프로그램이 할 일은 세 가지입니다. 서버에 붙습니다. 글자 한 줄을 보냅니다. 글자 한 줄을 받습니다.

경고

이 규격은 임시 규격입니다. 포트 번호, 명령 이름, 옵셋의 방향과 부호는 제품 값으로 확정되지 않았습니다. 통신하는 코드를 한 곳에 모아 짜 두면 나중에 고치기 쉽습니다. 바뀔 수 있는 항목은 조심할 것과 바뀔 수 있는 것에 모아 두었습니다.

어디부터 읽을까요

상황

읽을 곳

급합니다. 첫 측정부터 해 보고 싶습니다

빠른 시작, 예제 (파이썬)

오류가 났을 때 무엇이 돌아오는지 알고 싶습니다

오류가 났을 때 돌아오는 값

돌아온 숫자(옵셋)를 어떻게 쓰는지 알고 싶습니다

성공했을 때 돌아오는 값

보냈는데 답이 없습니다

시험하고 확인하는 법

모르는 말이 나옵니다

용어 풀이

팁

현장에 나가기 전에 오류가 났을 때 돌아오는 값와 시간과 순서는 꼭 읽으세요. 오류를 잘못 다루면 엉뚱한 값으로 로봇을 보정하게 됩니다.

기준: Backend/src/main.cpp (2026-11-22). 반환 예는 따로 적지 않은 한 전부 실제로 받은 줄입니다.