> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/embed-the-device-hmi.md).

# Device HMI 임베드

실시간 동영상과 최근 감지 결과를 보여 주는 Roboflow Device HMI를 Ignition Perspective 또는 Vision 화면에 표시합니다.

Deployment Manager에서 관리하는 모든 엣지 디바이스는 Device HMI를 실행합니다. Device HMI는 실시간 카메라 피드, 합격률, 최근 감지 결과를 보여 주는 작업자용 화면입니다. Ignition에 이를 삽입하면 작업자 화면에서 Roboflow를 가장 빠르게 사용할 수 있습니다. 스크립트 없이 컴포넌트 하나면 됩니다.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-52102ca0b3bc7f010f5f77ca8c62f0e14b161241%2Fignition-device-hmi-embed.png?alt=media" alt="An Ignition Perspective view named Bottle Line 1 with the Roboflow Device HMI embedded in an Inline Frame, showing a live annotated feed, a 78.7 percent pass rate, and recent pass and fail detections"><figcaption><p>Perspective Inline Frame에 표시된 Device HMI입니다.</p></figcaption></figure>

HMI는 Ignition 뷰 안에 표시되는 Roboflow 화면입니다. Ignition은 여기서 값을 읽거나 태그 값을 전송할 수 없습니다. Roboflow 결과를 Ignition 자체의 태그, 알람, 화면에서 사용하려면 다음을 참고하세요. [실시간 데이터](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/live-data.md), [실시간 비디오](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/live-video.md)및 [기록 데이터](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/historical-data.md).

{% hint style="info" %}
이 절차와 스크린샷은 Ignition 8.1(Designer 8.1.55)을 기준으로 합니다. 8.3을 포함한 다른 버전에서는 메뉴 이름, 대화상자, 속성 이름이 다를 수 있습니다.
{% endhint %}

## 필수 조건

* 최소 하나의 스트림을 실행 중인 [Deployment Manager](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager)에서 관리하는 엣지 디바이스입니다.
* 뷰를 표시하는 모든 컴퓨터에서 포트 `3000`를 통해 디바이스에 연결할 수 있어야 합니다. HMI는 Ignition 게이트웨이가 아니라 작업자의 브라우저에서 로드됩니다. HMI가 디바이스의 다른 서비스를 통해 비디오와 이벤트를 직접 읽으므로 클라이언트에는 다른 포트가 필요하지 않습니다.

## HMI 주소 찾기

HMI는 다음 주소에서 실행됩니다. `http://<device-ip>:3000`. Deployment Manager의 디바이스 카드에서 해당 주소로 연결할 수 있습니다. 삽입할 항목을 선택하세요.

<table data-search="false"><thead><tr><th>주소</th><th>표시 내용</th></tr></thead><tbody><tr><td><code>http://&#x3C;device-ip>:3000/</code></td><td>전체 HMI: 실시간 피드, 합격률, 최근 감지 결과</td></tr><tr><td><code>http://&#x3C;device-ip>:3000/stream/&#x3C;stream></code></td><td>스트림 하나의 비디오를 주변 요소 없이 전체 화면으로 표시</td></tr></tbody></table>

`<stream>` 은 스트림 이름입니다. HMI에서 스트림 탭의 새 탭에서 열기 아이콘을 누르면 해당 주소가 열립니다.

Ignition에 추가하기 전에 작업자 컴퓨터의 브라우저에서 주소를 열어 보세요. Ignition에 주소가 저장되므로 디바이스에 고정 IP 주소나 DNS 이름을 지정하세요.

## Perspective

1. Designer에서 Perspective 뷰를 열고 "Inline Frame" 컴포넌트를 해당 뷰로 끌어다 놓습니다.
2. 다음을 설정합니다. `props.src` 를 HMI 주소로 설정합니다.
3. 컴포넌트 크기를 조정합니다. 스트림 하나를 표시할 때는 카메라 화면 비율(예: 16:9)에 가깝게 설정하세요.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-45436383c06d632d963e3e0074804b6d195682d3%2Fignition-designer-hmi-inline-frame.png?alt=media" alt="Ignition Designer with a Perspective view showing the Roboflow Device HMI in an Inline Frame, and the Property Editor with src set to http://192.168.10.57:3000/"><figcaption><p>Inline Frame에 표시된 Device HMI입니다. Designer에서도 로드됩니다.</p></figcaption></figure>

모든 생산 라인에서 뷰 하나를 사용하려면 `deviceHost` 뷰 매개변수를 추가하고 `props.src` 를 다음 표현식에 바인딩합니다.

```
"http://" + {view.params.deviceHost} + ":3000/"
```

### HTTPS를 통한 Perspective

HMI는 HTTP로 제공됩니다. 브라우저는 `http://` 페이지가 `https://`로 로드된 페이지 안에 표시되는 것을 차단하므로 Perspective 세션에서 HTTPS를 사용하는 경우 프레임은 빈 상태로 남습니다. HMI 앞단에 HTTPS 리버스 프록시를 배치하고 해당 프록시의 `https://` 주소를 사용하거나, 공장 네트워크에서 HTTP로 세션을 여세요.

## Vision

1. Designer에서 Vision 창을 열고 "Web Browser" 컴포넌트를 창으로 끌어다 놓습니다. 이 컴포넌트는 Component Palette의 "Web Browser" 그룹에 있습니다.
2. Vision Property Editor의 "Data"에서 "Mode"를 "URL"로 유지하고 "Starting URL"에 HMI 주소를 설정합니다.
3. 브라우저 주소 표시줄을 숨기려면 "Behavior"에서 "Show Navigation Buttons"를 끕니다.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-13d2380d602dab774927f20a105303210d277156%2Fignition-vision-hmi-web-browser.png?alt=media" alt="Ignition Designer with a Vision window showing the Roboflow Device HMI in a Web Browser component, and the Vision Property Editor with Mode set to URL and Starting URL set to http://192.168.10.57:3000/"><figcaption><p>Vision Web Browser 컴포넌트에 표시된 Device HMI입니다.</p></figcaption></figure>

Ignition 8.1에서는 Web Browser 구성 요소가 Web Browser 모듈에서 제공됩니다. 이 모듈은 별도로 설치하고 라이선스를 취득해야 합니다. 8.3에서는 Vision의 일부입니다. 이 구성 요소는 HMI를 별도의 페이지로 표시하므로 위의 HTTPS 제한은 Vision에 적용되지 않습니다. 자세히 알아보기: [Web Browser 구성 요소](https://docs.inductiveautomation.com/docs/8.3/appendix/components/vision-components/misc/web-browser).

## 문제 해결

<table data-search="false"><thead><tr><th>문제</th><th>해결 방법</th></tr></thead><tbody><tr><td>HTTPS 세션에서 프레임이 비어 있음</td><td>브라우저가 혼합 콘텐츠를 차단합니다. HTTPS를 통한 Perspective를 참조하세요.</td></tr><tr><td>프레임에 "이 사이트에 연결할 수 없습니다"가 표시됨</td><td>같은 컴퓨터의 브라우저에서 HMI 주소를 여세요. 여기서도 연결되지 않으면 컴퓨터가 포트에서 장치에 연결할 수 없는 것입니다. <code>3000</code>.</td></tr><tr><td>HMI는 로드되지만 비디오 영역이 비어 있음</td><td>주소의 스트림 이름이 실행 중인 스트림과 일치하지 않습니다. Deployment Manager에서 스트림을 확인하세요.</td></tr><tr><td>Ignition 내에서 "장치 설정" 잠금을 해제할 수 없음</td><td>장치 설정을 변경하려면 별도의 브라우저 탭에서 HMI 주소를 여세요.</td></tr></tbody></table>

## 보안

HMI의 실시간 보기에는 로그인 기능이 없습니다. 포트에서 장치에 연결할 수 있는 사람은 누구나 `3000` 동영상을 볼 수 있습니다. 장치를 신뢰할 수 있는 네트워크에 연결하고 기본 "장치 설정" 비밀번호를 변경하세요.
