HMI 장치

장치는 MX On Cloud의 핵심 HMI 엔티티입니다. 텔레메트리를 보내고 속성을 보고하는 물리적 또는 가상의 사물로, 센서·컨트롤러·에뮬레이터 등이 있습니다.

HMI 장치가 동작하려면 라이선스가 필요합니다. 라이선스는 HMI 장치를 만들 때 등록하거나, 나중에 HMI 장치 상세 패널에서 등록할 수 있습니다.

1. 개체 → 장치로 이동합니다.
2. + 버튼을 클릭하고 장치 추가를 선택합니다.
3. 이름을 입력합니다(테넌트 안에서 고유해야 함).
4. 액세스 토큰을 입력하고 검증을 클릭합니다.
5. 라이선스 코드를 입력하고 검증을 클릭합니다. 액세스 토큰이 무료 체험 대상이면 이 필드는 비워 둬도 됩니다.
6. 추가를 클릭합니다.

1. 목록에서 HMI 장치를 클릭해 상세 패널을 엽니다.
2. 수정(연필) 버튼을 클릭합니다.
3. 이름, 프로필, 설명을 수정합니다.
4. 변경사항 적용을 클릭합니다.

장치를 열면 다음 탭이 있는 상세 패널이 나타납니다.

탭	내용
속성	클라이언트·서버·공유 키-값 쌍(일련번호, 펌웨어 버전, 임계값)
최근 데이터	실시간 센서 측정값. 직접 입력과 시간 범위별 삭제 지원
알람	이 HMI 장치의 활성 알람과 지난 알람
관계	다른 엔티티와의 방향 있는 연결
감사 로그	테넌트 관리자에게 보임. 생성·수정·삭제 같은 사용자 작업 이력
라이선스	라이선스 상세(HMI 장치에 현재 적용된 라이선스)와 라이선스 히스토리

라이선스 필드는 HMI 장치에 현재 적용된 라이선스를 보여 줍니다. HMI 장치가 무료 체험을 쓰는 동안, 그리고 라이선스 만료가 다가오거나 만료되면 패널 위쪽에 배너가 나타납니다. 여기서 라이선스를 등록하거나 교체하는 방법은 HMI 장치에 라이선스 등록을 참고하세요.

1. 장치 상세 페이지를 엽니다.
2. 커스터머에게 할당을 클릭합니다.
3. 고객을 선택하고 할당을 클릭합니다.

그 고객에 속한 사용자만 HMI 장치와 데이터에 접근할 수 있습니다.

HMI 장치 목록의 행 동작 장치를 공개로 전환으로 HMI 장치 데이터를 공개합니다. 공개를 취소하려면 행 동작이나 HMI 장치 상세 페이지에서 장치를 비공개로 전환을 사용합니다.

증상	원인	해결
HMI 장치가 계속 비활성	HMI 장치를 만들 때 입력한 액세스 토큰이 HMI 패널에 설정된 토큰과 다르거나, 라이선스가 더 이상 유효하지 않음	HMI 장치 상세 정보를 열어 액세스 토큰을 패널 설정과 비교하고 라이선스 상태를 확인
토큰이 맞는데도 HMI 장치가 계속 비활성	패널의 전송 방식이 HMI 장치의 프로필과 다름	HMI 장치의 장치 프로필이 패널과 같은 전송 방식을 쓰는지 확인
HMI 장치가 MX On Cloud에 연결되지 않음	호스트·포트가 틀렸거나 포트가 막힘	패널에 설정한 호스트가 사용 중인 MX On Cloud 인스턴스와 같은지, 방화벽이나 프록시가 그 포트의 외부 트래픽을 막지 않는지 확인
HMI 장치는 활성인데 텔레메트리가 나타나지 않음	페이로드가 올바른 JSON이 아니거나 예상하지 않은 키를 씀	패널의 데이터 설정을 확인하고 키 이름을 최근 데이터에 보이는 이름과 비교

HMI 장치를 만들고 데이터가 들어오기 시작하면, 다음으로 대시보드에서 시각화하거나, 텔레메트리가 임계값을 넘을 때 알림을 받도록 알람 규칙을 설정해 보세요.

• 대시보드 — 위젯으로 텔레메트리, 속성, 알람을 시각화
• 관계 — 계층 구조 모델링
• REST API — 장치를 프로그램으로 조회, 생성, 관리