Releases: wshan1977/locationx_position_setting_tool
Releases · wshan1977/locationx_position_setting_tool
Release list
v1.10.0
변경 사항
외부망 [위치 확인]에 로케이터 표시 (서버 v2.3.0+ 필요)
- 서버 카드 cloud-agent(v1.2.0)가 적용본 positioning_config의 로케이터 배치(좌표·자세)를
placements토픽(retained)으로 중계합니다. - 내부망에 한 번도 접속한 적 없는 PC에서도 외부 브로커+siteId만으로 위치 확인 뷰에 로케이터 보드·커버리지가 그려집니다.
- 외부망 장치 목록에 로케이터 좌표
(x, y, z) m·자세(x°, y°, z°)표시.
카드 [소프트웨어 업데이트] 버튼
- 장치 설정 탭·외부망 장치 목록에서 배포 저장소 최신 태그와 카드 버전을 비교해, 다르면 provision.sh 재배포로 업데이트합니다 (카드 IP로 SSH 접속이 가능한 네트워크에서만 동작).
프로젝트 이름 교정
locationx_positon_seting_tool→locationx_position_setting_tool오타 수정.- 실행 파일 이름이
locationx_position_setting_tool.exe로 바뀌었습니다 — 기존 바로가기는 새로 만들어 주세요.
호환 카드 버전
- 서버: v2.3.0 이상 (외부망 로케이터 표시·status 좌표 기능. 구버전 서버에서도 도구는 동작하지만 외부망 위치 확인에 로케이터가 안 보입니다)
- 로케이터: v1.0.26
v1.9.1
주요 변경 (v1.9.0 이후)
실물 이미지 개선
- 2D 사진 180° 회전 보정: 실물 설치와 대조해 커넥터 방향 정합 확정 —
외부망 테스트·MQTT 뷰어의 위치 확인 2D, 위치 설정 Top 뷰 공통 적용 - 위치 설정(서버) 탭에 "실물 이미지" ON/OFF 토글 (캔버스 우상단):
- Top 뷰: 배치된 로케이터 자리에 실물 사진 (월드 스케일 0.5m · 설치 회전 반영 ·
천장 설치 = 뒷면 · 바닥 설치 = 앞면) — 드래그 배치·선택 동작은 그대로 - 3D 뷰: 실물 케이스 형상 표시가 같은 토글을 따름
- Top 뷰: 배치된 로케이터 자리에 실물 사진 (월드 스케일 0.5m · 설치 회전 반영 ·
- 3D 케이스 해상도 5만 삼각형 · 표시 크기 1.5배 (v1.9.0 릴리즈 후 반영분 포함)
호환 카드 버전
v1.8.0과 동일 (외부망 기능: 서버 카드 v2.2.1+ · 가동시간: 서버 v2.2.3 / 로케이터 v1.0.24+)
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.9.0
주요 변경 (v1.8.0 이후)
로케이터 실물 표현 — 3D 케이스 · 2D 사진
- 3D 뷰 실물 케이스: 기구 CAD(LocatorXCase.step)에서 추출한 5만 삼각형 메시를
위치 설정 3D · 위치 확인 3D 뷰의 로케이터 자리에 렌더링 (뒷면 컬링 + 깊이 정렬 + 플랫 셰이딩)- 좌표 정합: 안테나면 → 바라보는 방향(+z) · 케이블 커넥터 → 방위 0°(빨간 노치) — 실물 대조 확정
- 표시 크기 1.5배 (실측 18cm는 룸 스케일에서 시인성 부족) · 위치 확인 뷰는 "실물 케이스" 토글
- 기존 노치·방향 화살표·라벨 유지 (설치 회전 확인 기준)
- 2D 뷰 실물 사진: 천장 설치(아래를 봄) = 뒷면 사진 · 바닥 설치(위를 봄) = 앞면 사진,
커넥터 방향으로 회전 · 수신 상태는 테두리 색으로 유지 - 장치 목록 사진 아바타: 장치 설정 목록·상세 헤더 · 위치 설정 장치 패널(배치됨 = 흐리게) ·
외부망 장치 카드(오프라인 = 흐리게)
기타
- 2D/3D 캔버스 배경을 테마 그룹 배경색(#F2F2F7)으로 통일
호환 카드 버전
v1.8.0과 동일 (외부망 기능: 서버 카드 v2.2.1+ · 가동시간: 서버 v2.2.3 / 로케이터 v1.0.24+)
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.8.0
주요 변경 (v1.7.0 이후)
아이폰(iOS) 스타일 테마
- iOS 시스템 블루(#007AFF) 액센트 · 연회색 그룹 배경 위 흰 카드
- 큰 라운드 코너(카드/버튼/입력/다이얼로그) · 플랫 디자인(무그림자)
- iOS 스크롤 물리 적용
외부망 장치 카드에 가동시간 표시
- "가동시간 1일 14시간 (부팅 07-08 21:46)" 형태 — 카드가 얼마나 켜져 있었는지 외부망에서 확인
- 상태 수신 후 경과분을 더해 보정하므로 실시간에 가깝게 표시
호환 카드 버전
- 가동시간 표시: 서버 카드 v2.2.3 · 로케이터 카드 v1.0.24 이상
- 외부망 기능 전반: 서버 카드 v2.2.1 이상
- 참고: 로케이터 카드 v1.0.25는 상태 페이지(:8080)에 AoA 각도 24시간 그래프 추가 (도구와는 독립)
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.7.0
주요 변경 (v1.6.1 이후)
⑤ 외부망 테스트 탭 신설
서버 카드의 외부망 중계(cloud-agent)가 공개 브로커(broker.hivemq.com 등)로 내보낸 데이터를 인터넷 어디서나 확인·제어합니다. 브로커 주소 + siteId로 연결.
- 장치 목록: 전 장치 상태(CPU 온도 · 서비스 상태 · 온라인/오프라인) + 리부트 · 서비스 재시작 · LED 식별 원격 명령
- 토픽 뷰어: 중계 토픽 탐색기 (내부망 뷰어와 동일 화면)
- 위치 확인: 계산된 태그 위치 2D/3D 라이브 뷰 (position만 중계 — angle 점선은 외부망 미지원)
장치 설정 탭 — 서버 카드 외부망 중계 관리
- 외부망 MQTT 브로커 설정 섹션: 중계 활성화 · 외부 브로커 주소 · 전송속도(Hz, 1~100) · 적용된 siteId 확인
- 제어 버튼: 내부망 MQTT 브로커 재시작(mosquitto, 명칭 변경) · 외부망 MQTT 브로커 재시작(cloud-agent, 신규)
작업자 UX 개선
- 탭에 작업 순서 번호: ① 장치 설정 → ② 위치 설정 → ③ 데이터 수신 → ④ MQTT 뷰어(내부망) → ⑤ 외부망 테스트
- 모든 탭 상단에 한 줄 작업 안내 배너 · 장치 상세 패널 섹션 카드화
- 토픽 뷰어에 토픽 복사 아이콘 — 외부망에서는 실제 브로커 토픽(locationx//... 포함)으로 복사되어 다른 MQTT 툴에서 바로 사용 가능
버그 수정
- 외부망 연결 해제가 UI에 반영되지 않던 문제
- 세션에 외부망 연결 정보(브로커·siteId) 저장 (재실행 시 프리필)
호환 카드 버전
- 외부망 기능: 서버 카드 v2.2.1 이상 필요 (v2.2.2 권장 — 상태 웹에 중계 카드 표시)
- 내부망 기능: 기존과 동일 (서버 카드 v2.1.1+ 권장)
- 로케이터 카드: 제한 없음
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.6.1
주요 변경 (v1.3.0 이후 누적)
장치 설정 탭 — 서버 카드 관리 강화
- 서버 카드 MQTT 브로커 설정 (v1.4.0): positioning 서비스가 접속할 브로커를 도구에서 직접 변경 (config 서버
/api/mqtt· 서버 카드 v2.0.0+ 필요) - 서버 카드 제어 3종 (v1.6.0): positioning 재시작 · MQTT 브로커(mosquitto) 재시작 · 재부팅 — 서버 카드 v2.1.1 이상 필요
- 서버/로케이터 패널 순서 통일 (v1.6.1): 두 카드 모두 "MQTT 브로커 설정 → 장치 제어(상태 페이지 → 재시작 → 재부팅)" 순서로 정렬
기타
- 로케이터 상태 페이지 버튼 (v1.5.0): 장치 탭에서 카드의 상태 확인 웹(:8080) 바로 열기 + 앱 버전 표시
- 공개 브로커 호환 (v1.4.x): MQTT 기본 구독 필터를
#→silabs/#로 변경 (루트 와일드카드를 거부하는 브로커 대응 · 기존 세션 자동 이관)
호환 카드 버전
- 서버 카드: v2.1.1 이상 권장 (제어 기능 전부 사용 가능 · v2.0.x는 브로커 설정까지만)
- 로케이터 카드: 제한 없음 (UDP 프로토콜 동일)
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.3.0
주요 변경
- 태그 수명 관리: 수신이 끊겨도 태그가 마지막 위치에 유지, 10초 후 슬립(회색) 표시, 경과 시간 초/분/시간 표기
- [태그 갱신]: 슬립 태그를 화면에서 제거 (새 신호가 와야 다시 표시, 결과 메시지 안내)
- [서버에서 읽기]: 서버 카드의 현재 positioning 설정을 캔버스/전역 설정에 반영 (Ctrl+Z 복귀 가능)
- 2D 위치 확인 그리드: 미터 그리드 + 원점 축으로 거리 확인 가능
- 전면 툴팁: 모든 버튼/설정에 1초 호버 설명 추가
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)
v1.2.0
v1.1.0
주요 변경
- 세션 자동 저장/복원: 재시작 시 도면·배치·서버 IP·MQTT 설정 자동 복원, 서버 주소가 같으면 MQTT 자동 재연결
- 장치 검색 동기화: 배치된 로케이터의 IP/이름 자동 갱신, 검색 안 되는 로케이터 경고 표시
- 실행 취소: 위치 설정에서 Ctrl+Z / Ctrl+Y (배치·이동·삭제·원점·보정·도면 편집)
- 도면 편집: 도면 삭제, 도면 이동/크기 조정 모드 (배치는 고정)
- 설정 툴팁: AoA 상세 설정·전역 Positioning 설정 각 항목 1초 호버 설명
- 설정 변경 비밀번호 확인 (경각심 용도)
- 3D 위치 확인: angle 점선·도면 표시 ON/OFF 토글
설치
zip 압축 해제 후 locationx_positon_seting_tool.exe 실행 (Flutter 설치 불필요)