Compass

Compass 위젯은 숫자 텔레메트리 값을 원형 문자판 위의 나침반 방위로 시각화합니다. HMI 장치의 방향 데이터(기상 관측소의 풍향, 차량이나 드론의 진행 방향, 추적 시스템의 안테나 방향, 센서 배열의 흐름 방향)를 표시할 때 씁니다.
위젯 추가
섹션 제목: “위젯 추가”- 대시보드를 수정 모드로 엽니다. 위쪽 툴바의 위젯 추가를 클릭하거나, 빈 대시보드 가운데의 위젯 추가 아이콘을 클릭합니다.
- 위젯 번들 선택 대화상자에서 Analogue gauges를 찾아 클릭합니다.
- Compass 위젯을 선택합니다.
- 데이터 소스와 모양을 설정한 다음 추가를 클릭합니다.
이 절의 설정은 모두 기본 모드 기준입니다. 필수 항목만 다루는 빠른 설정입니다. 제목 글꼴, 카드 스타일, 툴팁 같은 세부 설정은 고급 탭으로 바꿉니다.
데이터 소스
섹션 제목: “데이터 소스”표시할 값의 소스를 선택합니다:
- 장치 — 특정 HMI 장치. 나침반이 이 HMI 장치의 최신 텔레메트리 값을 표시합니다.
- 개체 별명 — 엔티티 별칭에 맞는 엔티티 집합. 실행 중에 대상 HMI 장치를 동적으로 고를 때 씁니다.
데이터 키를 정확히 하나 추가합니다. 나침반이 표시할 값의 텔레메트리 키입니다. 값은 0~360도 범위여야 합니다.
위젯 카드에 겹쳐 표시하는 선택 요소를 설정합니다.
| 설정 | 설명 |
|---|---|
| 제목 | 위젯의 글 라벨을 표시하거나 숨깁니다. 기본 글은 Compass입니다. 색상과 글꼴을 정합니다. |
| 아이콘 | 위젯의 아이콘을 표시하거나 숨깁니다. 색상과 글꼴을 정합니다. |
나침반 모양
섹션 제목: “나침반 모양”나침반 문자판의 시각 요소를 설정합니다.
| 설정 | 설명 |
|---|---|
| 라벨 | 나침반 문자판 둘레에 놓이는 방향 라벨. 기본 라벨: N, NE, E, SE, S, SW, W, NW. 라벨마다 바꾸거나 지울 수 있습니다. |
| 라벨 스타일 | 방향 라벨의 글꼴 설정(크기, 글꼴 종류, 굵기, 스타일). |
| 주 눈금 색상 | 기본 방위와 중간 방위 위치의 주 눈금 색상. |
| 보조 눈금 색상 | 주 눈금 사이의 보조 눈금 색상. |
| 바늘 색상 | 나침반 바늘의 색상. 기본값은 빨강입니다. |
| 플레이트 색상 | 나침반 문자판의 배경 채우기 색상. 기본값은 검정입니다. |
카드 모양
섹션 제목: “카드 모양”| 설정 | 설명 |
|---|---|
| 배경 색 | 위젯 카드의 단색 배경. |
| 카드 버튼 표시 | 위젯 헤더의 전체화면 버튼을 켜거나 끕니다. |
| 카드 모서리 반경 | 모서리 둥글기(픽셀). |
Compass는 위젯 헤더 버튼 동작을 지원합니다. 위젯 헤더에 놓는 버튼으로, 클릭하면 설정한 동작을 실행합니다.
문제 해결
섹션 제목: “문제 해결”나침반에 데이터가 표시되지 않음
| 원인 | 해결 방법 |
|---|---|
| 데이터 키 이름이 틀림 | 키 이름이 HMI 장치가 보내는 텔레메트리 키와 같은지 확인합니다. 키 이름은 대소문자를 구분합니다. |
| HMI 장치가 데이터를 보내지 않음 | 장치 → 최근 데이터를 열고 최근 값이 있는지 확인합니다. 비어 있으면 HMI 장치의 전송 설정과 액세스 토큰을 확인합니다. |
| 엔티티 별칭이 어떤 엔티티로도 결정되지 않음 | 대시보드에서 개체 별명을 열고 별칭이 결과를 돌려주는지 확인합니다. |
바늘이 움직이지 않거나 잘못된 방향을 가리킴
| 원인 | 해결 방법 |
|---|---|
| 값이 0–360 범위를 벗어남 | HMI 장치가 보내는 텔레메트리 값이 0~360도 범위인지 확인합니다. |
| 텔레메트리 키를 잘못 선택함 | 데이터 키가 HMI 장치가 실제로 보내는 키와 같은지 확인합니다. |
값이 N/A로 표시되거나 갱신이 멈춤
| 원인 | 해결 방법 |
|---|---|
| HMI 장치가 텔레메트리 전송을 멈춤 | 장치 → 최근 데이터에서 HMI 장치 연결과 마지막 활동 시각을 확인합니다. |
| 데이터 소스 엔티티를 잘못 선택함 | 데이터 소스 구성에서 올바른 HMI 장치나 별칭을 선택했는지 확인합니다. |