Shipyard Dashboard — 시작하기

EN KO

이 페이지는 처음 받은 PC 에서 shipyard 대시보드 를 띄우는 순서를 단계별로 안내합니다. 화면 사용법은 Shipyard Dashboard — 화면 가이드 를 참고하세요.

준비물

항목

비고

Windows PC

Windows 10 / 11. 권장 메모리 8GB 이상.

Python 3.10 이상

설치 안 되어 있으면 python.org 또는 사내 배포본에서 받기.

Git

저장소 받기 및 동료와 설정 공유용.

로봇과 같은 사내망

자기 PC 에서 ping <로봇 IP> 가 통해야 합니다.

저장소 받기

GitHub 저장소를 git clone 합니다.

git clone https://github.com/shh444/ur-rtde.git
cd ur-rtde

저장소 안에 미리 만들어둔 설정 3개가 같이 따라옵니다. 이 셋이 동료와 동일한 화면으로 시작하게 해주는 핵심 입니다.

파일

역할

gp_mapping.json

로봇이 보내주는 신호 번호를 “용접 전류”, “X 오프셋” 같은 친숙한 이름으로 바꿔 보여줍니다.

modbus_registers.json

펜던트·용접기 통신 레지스터의 의미·단위·디코딩 규칙.

analysis_templates.json

분석 워크스페이스에서 다른 사람이 만들어둔 차트 프리셋.

가상환경과 패키지 설치

PowerShell 을 열고 프로젝트 폴더 안에서:

py -3 -m venv .venv
./.venv/Scripts/Activate.ps1
python -m pip install --upgrade pip
pip install -r ./backend/requirements.txt

PowerShell 창의 프롬프트 맨 앞에 (.venv) 가 붙으면 가상환경이 활성화된 것입니다. 다음 번에 PowerShell 을 새로 열 때마다 ./.venv/Scripts/Activate.ps1 한 번씩 다시 실행하면 됩니다.

로봇 IP 확인 — 한 곳만 보면 됩니다

대시보드 전체에 단 하나의 설정 파일 app_config.py 가 있습니다. 처음엔 다음 한 줄만 본인 환경에 맞게 바꾸면 됩니다.

ROBOT_HOST = "192.168.1.7"   # ← 본인 로봇 IP

다른 항목들 (주파수, 모델, 포트 등) 은 기본값 그대로 두어도 조선소 셋업에서는 정상 동작합니다.

Tip

여기서 정한 IP 는 기본값일 뿐이고, 나중에 화면 ① 실시간 모니터링 의 상단 ConnectionBar 에서 언제든 즉시 변경할 수 있습니다. 다른 로봇으로 옮길 때 코드 수정 없이 화면에서만 바꾸면 됩니다.

대시보드 실행

PowerShell 에서:

python ./run_shipyard.py

이런 줄이 차례로 보이면 정상 기동입니다.

RTDE host       : 192.168.1.7
Modbus host     : 192.168.1.7
Shipyard URL    : http://127.0.0.1:8010/
INFO:     Uvicorn running on http://127.0.0.1:8010

브라우저(Chrome 권장)에서 다음 주소를 엽니다:

http://127.0.0.1:8010

대시보드 종료는 PowerShell 창에서 Ctrl + C 입니다.

처음 들어가서 확인할 5가지

브라우저에서 처음 화면(◉ 실시간 모니터링)이 뜨면 아래 순서로 점검합니다.

  1. 상단 인디케이터가 녹색 LIVE 인지 — 로봇과 통신이 살아있다는 뜻. 빨간색 DOWN 이면 IP 가 틀렸거나 로봇/네트워크 문제.

  2. 왼쪽 사이드바의 ◈ RTDE 실시간 으로 이동 — 용접 전류·전압·아크율 같은 친숙한 이름이 보이면 OK. 만약 output_double_register_3 같은 raw 이름만 보인다면 gp_mapping.json 이 누락된 것이니 git pull 다시 받기.

  3. ▭ 레코딩 으로 이동 — 이전에 동료가 남긴 레코딩 목록이 보입니다. 처음엔 비어 있을 수 있습니다.

  4. ⟁ 분석 워크스페이스 으로 이동 — 좌측에 “X 아크센싱” 같은 분석 템플릿이 미리 들어와 있어야 동료와 같은 환경입니다.

  5. ⌥ GP 매핑 으로 이동 → Modbus 레지스터 탭 → 한 번 저장 버튼 클릭. 첫 PC 에서 modbus_registers.json 이 없으면 이 단계에서 생성됩니다.

동료 PC 에 똑같이 깔기

동료가 자기 PC 에서:

  1. 위와 같이 git clone → venv → pip install

  2. app_config.py 의 ROBOT_HOST 만 본인 로봇 IP 로

  3. python run_shipyard.py

이렇게만 하면 GP 매핑·Modbus 레지스터 정의·분석 템플릿 모두 동일하게 시작합니다. 누군가 새 분석 템플릿을 만들거나 매핑을 바꾸면, git pull 받는 동료에게도 바로 반영됩니다.

문제가 생기면

자주 만나는 5가지 증상 중심으로 정리합니다.

기동 직후 콘솔에 빨간 글씨로 ``Connection refused`` (RTDE)

로봇 IP 가 app_config.py 와 다르거나 로봇 컨트롤러가 꺼져 있습니다. 먼저 ping <로봇 IP> 가 통하는지 확인하세요. 통한다면 로봇 컨트롤러에서 RTDE 가 켜져 있는지 점검.

브라우저에서 화면 변경이 안 보임

대시보드 화면이 캐시된 경우입니다. Ctrl + Shift + R 로 강제 새로고침. 그래도 안 되면 F12 → Network → “Disable cache” 체크 후 다시 시도.

대시보드 실행 후 화면이 안 떠 / “이미 사용 중인 포트” 오류

이미 다른 PowerShell 창에서 shipyard 가 떠 있을 수 있습니다. 작업표시줄을 확인하거나, PowerShell 에서 netstat -ano | findstr :8010 로 점유 중인 프로세스 PID 를 확인 후 종료.

GP 채널이 ``output_double_register_*`` 같은 이름으로만 보임

gp_mapping.json 이 누락됐거나 깨져 있습니다. git pull 로 다시 받거나 동료에게 파일을 요청하세요.

Modbus LIVE 가 안 떠 / “DOWN”

로봇과 같은 네트워크가 아닐 가능성이 큽니다. PC 의 IP 와 로봇 IP 가 같은 대역(예: 192.168.1.x) 인지, 사내 방화벽이 502 포트를 차단하지 않는지 확인.

다음 단계