배경
2026-01-12 LH가 가전제어 체험 피드백을 바탕으로 요청한 개발 건임. 가전제어는 LG ThinQ 연동이며 체험단이 있는 2개 단지에서만 제공됨. 2026-09 기준 기존 2개 단지에는 아래 기능을 넣고, 나머지 단지로 확대하는 작업이 진행 중임.
현재 상태 (2026-09-16)
기능은 모두 구현 완료됨. 단, 아래 두 가지는 제공하지 않음.
- 세탁기·건조기 제어는 안전상 이유로 취소됨. 기능은 구현돼 있지만 열지 않음. 세탁기·건조기는 조회와 push 알림만 됨.
- 로봇청소기 예약은 되지 않음.
| 기기 | 조회 | 제어 | push |
|---|---|---|---|
| 세탁기 | 상태, 남은 시간 | 없음 (안전상 취소) | 세탁 완료 |
| 건조기 | 상태, 남은 시간 | 없음 (안전상 취소) | 건조 완료 |
| 로봇청소기 | 상태, 배터리 | 시작·일시정지·재개·충전대 복귀. 예약 없음 | 없음 |
| 에어컨 | 전원, 온도, 모드, 바람세기 | 전원, 희망온도, 운전모드, 바람세기, 꺼짐·켜짐 예약 (기기가 지원하는 기능만) | 없음 |
등록은 LG ThinQ에 기기를 등록한 뒤 홈즈 앱에서 다시 등록하는 두 단계임. 제어 내역은 제어 내역 화면에 기록됨. 설정의 푸시 알림 항목에 세탁기·건조기가 보이고, 끄면 완료해도 알림이 오지 않으며, 기기를 삭제하면 항목도 사라짐.
알아둘 동작:
- 제어용 LG API 토큰은 서버(SCW 스케줄러)가 주기적으로 갱신함. 단지별 API 키를 쓰므로 특정 단지만 제어가 안 되는 경우가 생길 수 있음. 공개노트/기능/우리집제어 “LG ThinQ 토큰 갱신”, 공개노트/개발/모듈/SCW 스케줄러 서버
- 기기 상세의 조회값은 우리집제어 탭까지 나가서 새로고침한 뒤 다시 들어가야 갱신됨.
- 한 기기에 계정을 2개 이상 연결하면 기기제어 이력에 같은 행이 중복되던 문제는 2026-09-16 기준 수정 완료.
서버 쪽 제약 (2026-09-18 코드 확인)
- 지원 기기 타입은 에어컨·세탁기·건조기·로봇청소기 4종뿐임. 그 밖의 타입은 목록에서 제외되고 로그에
Unknown LG device type:으로 원인 타입 문자열이 찍힘 - LG 값과 우리 값을 바꿔 주는 변환표에 없는 값이 오면 상태가
UNKNOWN으로 내려감. 가전사가 새 상태를 추가하면 서버 변환표를 고쳐야 함 - 푸시 구독·해제는 세탁기·건조기에만 호출함. 다른 기기는 아예 부르지 않음. “완료 알림이 안 온다” 점검은 기기 종류 확인부터 시작함
- 로봇청소기 배터리 값이 없으면
80을 하드코딩해 내려 줌. 배터리가 항상 80%로 보이는 원인임 - 제휴사 로고 URL이 코드 상수로 하드코딩되어 있음(DB 컬럼 아님). 로고가 깨져 보이는 원인임
- 제어 내역에 저장되는 “응답값”은 실제 기기 상태가 아니라 요청값 복사본임. 에어컨은 현재 온도만 비움. 제어 뒤 실제 상태는 상세 조회를 따로 해야 알 수 있음
- 에어컨 예약은 절대시간만 씀. 상대시간 처리 코드는 주석 상태임 → 공개노트/개발/에어컨 꺼짐 예약
- 개발 프로필은 LG 시뮬레이터(목업) 모드라 연동 상태가 항상 “연동됨”으로 보이고 실제 가전이 움직이지 않음. 운영은 꺼져 있음
- 호출 실패 시 재시도는 401 한 번뿐임. 타임아웃(3초)·5xx에는 재시도가 없음. 추적은 MAW traceId가 아니라 LG 규격의 메시지 ID로 함 → 공개노트/개발/모듈/MAW 앱 API 서버
실기기 테스트
사무실에 에어컨이 있어 에어컨은 사무실에서 테스트함. 로봇청소기·세탁기·건조기는 실기기가 없어 2026-09-17 LG 방문 테스트로 진행함. 이날 확인할 항목:
- 등록: ThinQ 등록 → 홈즈 앱 등록
- 세탁기: 상태·남은 시간 조회, 세탁 완료까지 돌려 “세탁 완료” 알림 수신, 알림 센터에 기록
- 건조기: 상태·남은 시간 조회, “건조 완료” 알림 수신, 알림 센터에 기록
- 로봇청소기: 상태·배터리 조회, 시작·일시정지·재개·충전대 복귀, 제어 내역 확인
- 에어컨: 전원·온도·모드·바람세기 조회, 전원·희망온도·운전모드·바람세기·꺼짐 예약·켜짐 예약 제어, 제어 내역 화면 기록
- 푸시 설정: 세탁기·건조기 항목 표시, off 시 알림 미수신, 기기 삭제 시 항목 삭제
- 테스트 중 구독 목록(LGE 기준)에 정상 구독되는지
- 테스트 로그가 쌓이는지
결과는 D520-4 통합시험 시나리오(우리집제어) 가전 제어 행에 기록함.
같은 시기 LH 요청 중 가전 외 건 (2026-09-17 기준)
| 건 | 내용 | 상태 |
|---|---|---|
| 가전 상태표시 가독성 개선 | ”행정 중” → “세탁 중”처럼 한글화, 온라인/꺼짐 아이콘 | 2월 배포 대상 |
| 우리집제어 배치 편집 | 기기·항목 위치를 사용자가 직접 배치 | 완료 |
| 즐겨찾기에 가전제어 추가 | 완료 | |
| HOMEZ 제어 기록 조회 | 언제 어떤 기기를 제어했는지 이력 | 개발 중 → 제어 내역 화면으로 구현됨 |
| 원패스 관리 화면 개선 (매입임대) | 지역본부 앞 표시, 원패스 ID를 LH 부여 체계로, 설치 위치, 정상/고장의심, On/Off 표시 개선 | 완료 |
| 26년 고도화 용역 | 방문주차(연동규격 V1.3.3), WISE 임대료 연동(VPN 협의). 2026-01-09 대가표 제출, 01-27 LH 화상회의 | 진행 중(방문주차, WISE 임대료 연계). 방문주차는 공개노트/개발/인터페이스 정의 참고 |
관련
공개노트/기능/우리집제어 공개노트/개발/모듈/MAW 앱 API 서버 공개노트/개발/에어컨 꺼짐 예약 공개노트/개발/push 알림 공개노트/개발/인터페이스 정의 공개노트/개발/모듈/SCW 스케줄러 서버 기본매뉴얼/입주민/에어컨 등 가전 제어가 안 돼요