SmartThings Web 1.8.75

1.8.75

Bridge가 시작될 때마다 몇 시간 동안 CPU를 많이 쓰던 문제를 수정했습니다.

• 원인: 상세 조회(detail discovery)가 15초마다 기기 하나씩 SmartThings 페이지를 여는데, 시도 기록이 Bridge 시작마다 초기화되어 모든 기기를 다시 열었습니다. 기기 239대 기준 약 319회, 약 3시간 동안 Bridge CPU가 30~40%였습니다.
• 상세 컨트롤이 이미 완성된 기기는 다시 조회하지 않습니다(컨트롤은 저장된 인벤토리에서 복원됩니다).
• 2회 조회해도 완성되지 않은 기기는 /data/detail-discovery.json에 기록하고 7일 동안 또는 이름이 바뀔 때까지 다시 조회하지 않습니다. 기기 이름은 해시로만 저장합니다.
• 카메라 이미지 기기는 지금처럼 매번 조회합니다.
• 통합 코드는 바뀌지 않았습니다.

업데이트

1. Bridge 앱을 1.8.75로 업데이트합니다. 업데이트 중 Bridge가 다시 시작됩니다. 이 버전으로 처음 시작할 때는 미완성 기기를 한 번 더 조회하고, 그다음 재시작부터 조회가 줄어듭니다.
2. HACS 통합도 버전 정렬을 위해 1.8.75로 업데이트합니다. 통합 코드 변경은 없으므로 Home Assistant 재시작은 필요 없습니다.

SmartThings Web 1.8.74

1.8.74

Bridge가 30분마다 상태를 다시 맞출 때 일부 컨트롤과 기기 종류가 흔들리던 문제를 수정했습니다.

• 새로고침 버튼: 재조정 스냅샷이 Advanced 새로고침 버튼을 만들고, 곧이어 명령 카탈로그 반영이 이를 지웠습니다. 그래서 새로고침 버튼 엔티티가 재조정마다 사라졌다가 다음 재조정에서야 돌아왔습니다. 이제 카탈로그 반영은 스위치 토글만 교체합니다.
• 기기 종류: Advanced 기기 행의 통신 방식 값(OCF, ZIGBEE 등)이 기기 카드의 종류(세탁기·건조기 등)를 덮어쓸 수 있었습니다. 이제 이 값은 종류가 비어 있을 때만 쓰고, presentation도 기존 값을 유지합니다.
• 통합 코드는 바뀌지 않았습니다(1.8.73의 실행 중 삭제 방지가 그대로 적용됩니다).

업데이트

1. Bridge 앱을 1.8.74로 업데이트합니다. 업데이트 중 Bridge가 다시 시작됩니다.
2. HACS 통합도 버전 정렬을 위해 1.8.74로 업데이트합니다. 통합 코드 변경은 없으므로 Home Assistant 재시작은 필요 없습니다.

SmartThings Web 1.8.73

1.8.73

Home Assistant 실행 중 약 30분마다 버튼·이진 센서·조명 등이 한꺼번에 사라지던 문제를 수정했습니다.

• Bridge는 30분마다 상태를 다시 맞추면서 인벤토리 전체를 다시 적용하고, 명령 카탈로그와 기기 정보는 그 뒤에 비동기로 채웁니다. 그 몇 초 사이 통합의 엔티티 레지스트리 정리가 불완전한 인벤토리를 보고 명령 버튼, 읽기 전용 가전 전원 이진 센서 등을 지웠습니다.
• 플랫폼은 같은 실행 중에 이미 만든 엔티티를 다시 만들지 않기 때문에, 지워진 엔티티는 Home Assistant를 다시 시작할 때까지 돌아오지 않았습니다.
• 이제 삭제는 설정 직후 인벤토리가 준비된 첫 정리에서만 합니다. 실행 중의 정리는 엔티티 ID 이름 정리만 하고, 정말로 사라진 기기·엔티티는 다음 시작 때 정리합니다.
• Bridge 동작은 바뀌지 않았습니다. 버전 정렬 규칙에 따라 Bridge 앱 버전도 1.8.73입니다. 프로토콜 계약은 6을 유지합니다.

업데이트

1. HACS 통합을 1.8.73으로 업데이트하고 Home Assistant를 다시 시작합니다.
2. 재조정 때 지워졌던 엔티티는 재시작하면 같은 고유 ID로 다시 만들어지고, 이후 실행 중에는 지워지지 않습니다.
3. Bridge 앱 1.8.73은 버전 정렬용이며 동작 변경이 없습니다.

SmartThings Web 1.8.72

1.8.72

Home Assistant를 시작할 때마다 일부 센서·이진 센서가 만들어졌다가 곧바로 사라지던 문제를 수정했습니다.

• 펌웨어 묶음이 없는 기기의 state·updateAvailable 센서, 읽기 전용 가전(건조기·세탁기·식기세척기 등)의 전원 binary_sensor, 재실(occupancy) binary_sensor를 엔티티 레지스트리 정리 단계가 오래된 행으로 판단해 지웠습니다. 플랫폼은 이 엔티티들을 만들고 있었으므로 시작할 때마다 생겼다 지워졌습니다.
• 정리 단계가 플랫폼과 같은 규칙으로 판단하도록 맞췄습니다. 펌웨어 묶음의 원시 센서(업데이트 엔티티가 대신함)와 제어 가능한 스위치의 옛 binary_sensor는 지금처럼 정리됩니다.
• Bridge 동작은 바뀌지 않았습니다. 버전 정렬 규칙에 따라 Bridge 앱 버전도 1.8.72입니다. 프로토콜 계약은 6을 유지합니다.

업데이트

1. HACS 통합을 1.8.72로 업데이트하고 Home Assistant를 다시 시작합니다.
2. 해당 엔티티는 다음 시작부터 지워지지 않고 유지됩니다.
3. Bridge 앱 1.8.72는 버전 정렬용이며 동작 변경이 없습니다.

SmartThings Web 1.8.71

1.8.71

Home Assistant를 시작할 때마다 명령 전용 버튼·선택·숫자 엔티티가 사라지던 문제를 수정했습니다.

• 엔티티 레지스트리 정리 단계가 Advanced 카탈로그 명령 엔티티(…_command_button_…, …_command_select_…, …_command_number_…)와 관측된 선택 컨트롤 엔티티(…_select_…)를 현재 인벤토리의 엔티티로 인정하지 않아, 플랫폼이 만든 직후 지웠습니다. 이제 플랫폼이 만드는 것과 같은 규칙으로 고유 ID를 계산해 보존합니다.
• Bridge가 더 이상 내보내지 않는 컨트롤의 엔티티는 지금처럼 정리됩니다.
• Bridge 동작은 바뀌지 않았습니다. 버전 정렬 규칙에 따라 Bridge 앱 버전도 1.8.71입니다. 프로토콜 계약은 6을 유지합니다.

업데이트

1. HACS 통합을 1.8.71로 업데이트하고 Home Assistant를 다시 시작합니다.
2. 지워졌던 명령 전용 엔티티는 같은 고유 ID로 다시 만들어집니다. 엔티티 ID를 직접 바꿨거나 이름을 지정했던 경우 그 설정이 유지되는지는 Home Assistant가 삭제 기록을 보존하고 있는지에 따라 달라집니다.
3. Bridge 앱 1.8.71은 버전 정렬용이며 동작 변경이 없습니다.

SmartThings Web 1.8.70

1.8.70

Bridge 앱의 브라우저 실행 환경을 Playwright 1.65.0으로 올렸습니다. Chromium은 151에서 158로 바뀝니다.

• playwright-core 1.65.0과 Bridge 이미지(v1.65.0-resolute, Chromium revision 1254)를 함께 올렸습니다. 둘 중 하나만 올리면 브라우저 실행 파일을 찾지 못해 Bridge가 시작되지 않습니다.
• setuid 샌드박스 경로와 AppArmor 프로파일을 새 revision에 맞췄습니다. arm64 이미지는 Chromium 경로가 chrome-linux-arm64로 바뀌었습니다.
• 통합 코드는 바뀌지 않았습니다. 버전 정렬 규칙에 따라 통합 버전도 1.8.70입니다. 프로토콜 계약은 6을 유지합니다.

업데이트

1. Bridge 앱을 1.8.70으로 업데이트하고 재시작합니다.
2. HACS 통합을 1.8.70으로 업데이트합니다(동작 변경 없음, 버전 정렬).
3. Bridge 웹 UI에서 로그인 상태와 연결 무결성을 확인합니다. 브라우저가 바뀌므로 다시 로그인해야 할 수 있습니다.

자동 검증은 amd64 이미지를 AppArmor 강제 없이 실행합니다. arm64와 Home Assistant OS가 적용하는 AppArmor에서의 동작은 자동 검증에 포함되지 않습니다.

SmartThings Web 1.8.69

1.8.69

Bridge 하나는 연결된 계정의 모든 위치 이벤트를 하나의 스트림과 하나의 순번으로 보냅니다. 위치마다 설정 항목을 따로 만들면 각 항목이 다른 위치의 상태 이벤트도 받습니다. 지금까지 통합은 이런 이벤트를 "자기 위치에 없는 기기"로 보고, 올 때마다 Bridge 인벤토리 전체를 다시 받아 파싱하고 복사했습니다. 위치 2개 설치에서 Home Assistant 이벤트 루프의 약 31%가 이 재처리에 쓰였습니다(HA 2026.11.0, 샘플링 측정).

• 다른 위치에 있는 알려진 기기의 상태 이벤트는 공유 순번만 앞으로 옮기고 버립니다. 그래서 이 위치의 다음 이벤트가 순번 누락으로 오인되지 않습니다.
• 순번 누락, 처음 보는 기기, 인벤토리 이벤트는 지금처럼 인벤토리 전체를 다시 받습니다. 기기가 위치를 옮기면 Bridge가 인벤토리 이벤트를 보내므로 그때 반영됩니다.
• Bridge 코드는 바뀌지 않았습니다. 버전 정렬 규칙에 따라 Bridge 앱 버전도 1.8.69입니다.

업데이트

1. HACS 통합을 1.8.69로 업데이트하고 Home Assistant를 재시작합니다.
2. Bridge 앱도 1.8.69로 업데이트합니다(동작 변경 없음, 버전 정렬).

자동 검증(다른 위치 이벤트에서 인벤토리 재요청 없음, 순번 연속성 유지)과 실제 설치의 CPU 확인은 구분됩니다.

SmartThings Web 1.8.68

1.8.68

Home Assistant 2026.11부터 DeviceEntry.config_entries는 폐기 예정 속성입니다. 이 속성을 읽을 때마다 Home Assistant는 호출한 통합을 찾으려고 콜스택 전체와 불러온 모듈 전체를 훑습니다. 통합은 오래된 기기 카드를 정리할 때 기기 레지스트리 전체를 돌면서 이 속성을 읽었습니다. 그래서 기기가 많은 설치(실측 818개)에서는 Home Assistant 이벤트 루프 CPU를 크게 썼습니다.

• 오래된 Bridge 기기 카드 정리는 이 설정 항목의 기기만 레지스트리 인덱스(device_registry.async_entries_for_config_entry)로 가져옵니다.
• 기기 소유 항목은 2026.11의 config_entry_id로 판단합니다. 이전 Core와 복원된 composite 기기는 지금처럼 config_entries를 씁니다. 방(영역) 동기화의 소유 판단도 같은 방식으로 바꿨습니다.
• 정리 규칙은 그대로입니다. 다른 설정 항목과 공유하는 기기는 지우지 않고 이 항목만 분리합니다. 위치(loc_N) 카드는 유지합니다.
• Bridge 코드는 바뀌지 않았습니다. 버전 정렬 규칙에 따라 Bridge 앱 버전도 1.8.68입니다.

업데이트

1. HACS 통합을 1.8.68로 업데이트하고 Home Assistant를 재시작합니다.
2. Bridge 앱도 1.8.68로 업데이트합니다(동작 변경 없음, 버전 정렬).

자동 검증(레지스트리 인덱스 사용, 폐기 예정 속성 미사용)과 실제 설치의 CPU 확인은 구분됩니다.

SmartThings Web 1.8.67

1.8.67

로그인 후 find api/device의 실제 응답이 정확히 [null, null]일 때, 이 응답을 기기 카드 형식 오류로 판단해 snapshot:device_cards:response_shape로 차단하는 문제가 있었습니다.

• 해당 요청에서 확인한 [null, null]만 데이터 없는 응답으로 건너뜁니다. 빈 기기 목록이나 동기화 완료로 처리하지 않으며 기존 기기와 정상 카드 개수를 보존합니다. 다른 잘못된 응답의 형식 검사는 계속 적용됩니다.
• 1.8.66에서 이 응답의 진단과 카드 형식 오류만 저장된 경우, 새 세션에서 모든 필수 스냅샷과 기기 이벤트를 오류 없이 다시 확인하면 해당 차단을 해제합니다. 다른 오류 이력과 변경 횟수는 보존하고 프로토콜 계약은 6을 유지합니다.

업데이트

1. Bridge 앱을 1.8.67로 업데이트하고 재시작합니다.
2. HACS 통합을 1.8.67로 업데이트합니다. Home Assistant가 재시작을 요청하면 재시작합니다.
3. 로그인 후 앱 버전과 연결 무결성을 확인합니다.

정상 카드 응답이 계속 오지 않으면 데이터 없는 응답만으로 준비 완료가 되지는 않습니다. 보고된 응답을 재현한 자동 검증과 실제 오류 사용자 환경의 업데이트 후 확인은 구분됩니다.

SmartThings Web 1.8.66

1.8.66

로그인 후 snapshot:device_cards:response_shape가 계속 표시되는 환경에서 원인을 확인할 수 있도록 오류 진단 복사 기능을 추가했습니다.

사용 방법

1. 오류가 발생한 사용자의 SmartThings Web Bridge 앱을 1.8.66으로 업데이트합니다.
2. Bridge 웹 UI를 열고, 오류가 표시된 상태에서 오류 진단 복사를 누릅니다. Home Assistant 통합과 페어링하기 전에도 사용할 수 있습니다.
3. 복사된 내용을 문제 신고에 첨부합니다. 자동 복사가 제한된 브라우저에서는 화면에 표시된 텍스트를 직접 복사합니다.

포함된 변경

• 응답 타입, 알려진 오류 코드, 카드 필드의 존재 여부를 요약합니다. 기기 이름·식별자 값·인증 정보·원문 메시지는 내보내지 않습니다.
• 실제로 형식 검사에서 거부된 응답의 구조를 오류 종류별로 저장해 재시작 후에도 확인할 수 있습니다.
• 이전 버전에 저장된 응답만 있으면 오류 원인으로 확정하지 않은 후보로 구분합니다. 저장 기록이 없으면 자료가 없음을 표시합니다.
• 진단은 상태를 읽기만 하며, 기록 실패가 기존 무결성 판정과 상태 전이를 방해하지 않도록 분리했습니다.
• Bridge 앱과 HACS 통합의 배포 버전은 1.8.66입니다. 진단 버튼은 Bridge 앱에 추가됩니다.

이번 릴리스는 보고된 다른 사용자 환경의 실패 응답을 확보하기 위한 진단 업데이트입니다. 그 환경에서 오류가 해결됐다고 확인한 버전은 아닙니다. 프로토콜 계약 6과 기존 오류 판정을 유지합니다.