콘텐츠로 이동

Led Indicator

Led indicator 위젯은 색이 있는 LED 아이콘으로 HMI 장치의 현재 상태를 보여 줍니다. 속성이나 시계열 데이터를 구독하고, 현재 켜짐/꺼짐 상태에 따라 불이 켜지거나 어두워집니다.

작동 방식

섹션 제목: “작동 방식”

LED indicator는 두 가지 원리로 동작합니다:

  1. 상태 감지 — 대시보드를 불러올 때 위젯이 설정한 소스(속성 구독 또는 시계열 구독)에서 HMI 장치의 현재 상태를 읽어 LED를 맞는 색으로 정합니다.
  2. 실시간 갱신 — HMI 장치 상태가 외부에서 바뀌면 위젯이 갱신을 받아 페이지를 다시 불러오지 않고 LED 색을 바로 바꿉니다.

주요 기능

섹션 제목: “주요 기능”
  • LED 제목과 활성 색상을 따로 설정할 수 있습니다.
  • 상태 소스: 속성 구독 또는 시계열 구독.
  • 사용자 지정 f(data) 변환기가 원시 속성이나 텔레메트리 값을 켜짐/꺼짐 불리언 상태로 바꿉니다.
  • 데이터가 없을 때 쓸 대체 상태를 설정할 수 있습니다.

위젯 추가

섹션 제목: “위젯 추가”
  1. 대시보드를 수정 모드로 엽니다. 위쪽 툴바의 위젯 추가를 클릭하거나, 빈 대시보드 가운데의 위젯 추가 아이콘을 클릭합니다.
  2. 위젯 번들 선택 대화상자에서 Control widgets를 찾아 클릭합니다.
  3. Led indicator 위젯을 선택합니다.
  4. 데이터 소스, 모양, 값 설정을 구성한 다음 추가를 클릭합니다.

구성

섹션 제목: “구성”

이 절의 설정은 모두 기본 모드 기준입니다. 필수 항목만 다루는 빠른 설정입니다. 제목 글꼴, 카드 스타일, 툴팁 같은 세부 설정은 고급 탭으로 바꿉니다.

데이터 소스

섹션 제목: “데이터 소스”

상태 데이터의 소스를 선택합니다:

  • 장치 — 특정 HMI 장치. 위젯이 이 HMI 장치의 상태를 읽습니다.
  • 개체 별명 — 엔티티 별칭에 맞는 엔티티 집합. 실행 중에 대상 HMI 장치를 동적으로 고를 때 씁니다.

모양

섹션 제목: “모양”

LED 라벨, 색상, 대체 메시지를 설정합니다.

설정설명
”표시할 데이터 없음” 대체 메시지엔티티 상태 데이터가 없을 때 표시하는 대체 글.
LED 제목LED 아이콘 위에 표시되는 라벨(예: Ventilation, Power).
LED 색상활성(켜짐) 상태일 때의 LED 색상. 비활성(꺼짐) 상태에서는 LED가 회색입니다.

값 설정

섹션 제목: “값 설정”

위젯이 현재 켜짐/꺼짐 상태를 정하는 방법을 정합니다.

초기값 — 아직 받은 데이터가 없을 때 보여 주는 기본 상태. 체크하면 켜짐, 체크하지 않으면 꺼짐입니다.

LED 상태 값 파싱 함수 f(data) — 원시 속성이나 시계열 값을 불리언으로 바꾸는 JavaScript 함수. 켜짐이면 true, 꺼짐이면 false를 돌려줍니다.

return data ? true : false;

LED 상태 소스 요약:

소스 유형설명예시
속성속성 갱신을 구독합니다.shared.powerState = true
시계열최신 텔레메트리 값을 읽습니다.led_state = 1

카드 모양

섹션 제목: “카드 모양”
설정설명
배경카드의 단색 또는 이미지 배경.
카드 버튼 표시툴바의 전체화면 버튼을 켭니다.
카드 모서리 반경모서리 둥글기(픽셀).
카드 패딩카드 내용과 테두리 사이 간격.

액션

섹션 제목: “액션”

Led indicator는 위젯 헤더 버튼 동작을 지원합니다. 위젯 헤더에 놓는 버튼으로, 클릭하면 설정한 동작을 실행합니다.

예시

섹션 제목: “예시”

환기 릴레이 LED 표시기

섹션 제목: “환기 릴레이 LED 표시기”

시나리오: Ventilation Relay라는 HMI 장치에 공유 속성 powerState(Boolean)가 있습니다. powerState = true이면 릴레이가 켜져 있고, powerState = false이면 꺼져 있습니다.

목표: powerState를 읽어 릴레이가 켜져 있으면 초록 LED, 꺼져 있으면 회색 LED를 보여 주는 Led indicator 위젯을 추가합니다.

사전 준비: Ventilation Relay라는 HMI 장치를 만들고(라이선스 등록은 HMI 장치 연결 가이드 참고) 공유 속성을 추가합니다:

  • 키 이름: powerState
  • 데이터 유형: Boolean
  • 값: true

1단계. 위젯 추가. 대시보드를 수정 모드로 열고 위젯 추가를 클릭하고 Control widgets를 선택한 다음 Led indicator를 고릅니다.

2단계. 데이터 소스 설정. 데이터소스 유형을 장치로 정하고 Ventilation Relay를 선택합니다.

3단계. 모양 설정. 모양 탭에서 다음과 같이 설정합니다:

  • “표시할 데이터 없음” 대체 메시지: No telemetry available
  • LED 제목: Ventilation LED
  • LED 색상: #4CAF50

4단계. 값 설정 구성. 값 설정 영역에서 다음과 같이 설정합니다:

  • 초기값: 체크 안 함(꺼짐)
  • LED 상태 값 조회 방식: 속성 구독
  • LED 상태 값이 포함된 장치 속성: powerState
  • LED 상태 값 파싱 함수: return data ? true : false;

5단계. 저장. 추가를 클릭하고 필요하면 크기와 위치를 조정한 다음 대시보드 툴바의 저장을 클릭합니다.

결과: 위젯이 Ventilation Relay HMI 장치의 powerState를 읽습니다. powerState = true이면 LED가 초록으로 빛나 릴레이가 켜져 있음을 나타냅니다. powerState = false이면 LED가 회색이 되어 릴레이가 꺼져 있음을 나타냅니다.

연동: 같은 대시보드에 Single switch 위젯을 추가하면 powerState 속성을 직접 제어할 수 있습니다. 스위치를 켜면 powerState = true가 되어 LED가 초록으로 바뀌고, 끄면 powerState = false가 되어 LED가 회색으로 바뀝니다.

문제 해결

섹션 제목: “문제 해결”

LED에 올바른 상태가 반영되지 않음

원인해결 방법
속성 키나 구독 유형이 틀림값 설정의 키 이름을 확인합니다. 속성을 쓰면 속성 구독을, 텔레메트리를 쓰면 시계열 구독을 선택합니다. 이름은 대소문자를 구분합니다.
파싱 함수가 잘못된 값을 돌려줌f(data) 함수가 예상 데이터 값에 맞게 true나 false를 올바르게 돌려주는지 확인합니다.
HMI 장치에 속성이 설정되지 않음장치 → 속성을 열고 속성이 있고 값이 들어 있는지 확인합니다.

HMI 장치가 켜져 있어도 LED가 회색으로 남음

원인해결 방법
아직 받은 데이터가 없음HMI 장치가 연결되어 데이터를 보내는지 확인합니다. 속성이나 시계열 키 이름이 HMI 장치가 보내는 것과 같은지 확인합니다.
초기값이 체크되지 않았고 데이터를 아직 불러오지 않음HMI 장치의 첫 데이터 갱신을 기다리거나, 임시로 초기값을 체크합니다.

HMI 장치 상태가 바뀌어도 LED가 갱신되지 않음

원인해결 방법
구독 유형이 틀림공유 속성이나 클라이언트 속성에는 속성 구독을, 텔레메트리 키에는 시계열 구독을 씁니다.
© 2026 The MX On Cloud Authors