SwitchBot Lock, Lock Pro i Lock Ultra w Home Assistant  kompletny poradnik integracji, montażu i diagnostyki

Bluetooth, ESPHome Bluetooth Proxy, SwitchBot Cloud, Matter przez Hub 2/3, bezpośredni Matter over Wi‑Fi, keypad, fingerprint, kalibracja, czujnik drzwi, baterie i bezpieczne automatyzacje.

Dla kogo jest ten artykuł

Ten poradnik jest dla osoby, która rozważa zakup zamka SwitchBot do polskich lub europejskich drzwi i chce wiedzieć nie tylko, czy urządzenie „da się dodać” do Home Assistanta, ale czy będzie działało stabilnie po pół roku, co stanie się po utracie internetu, czy zamek potrafi cofnąć zapadkę, jak sprawdzić stan drzwi, jaką wersję kupić oraz czy potrzebny jest dodatkowy hub.

Nie zakładam, że znasz Matter, Bluetooth Proxy ani różnicę między ryglem i zapadką. Każdy z tych tematów wyjaśniam od podstaw, a później przechodzę do konfiguracji, automatyzacji i diagnostyki realnych problemów zgłaszanych przez użytkowników.

SwitchBot Lock, Lock Pro, Lock Pro Matter Enabled i Lock Ultra — czego nie wolno ze sobą mieszać

Największym źródłem nieporozumień jest to, że pod słowem „SwitchBot Lock” kryje się kilka urządzeń o podobnej funkcji, ale innej mechanice, zasilaniu i łączności. Ogólna zasada jest następująca:

Najważniejsze pytanie przed zakupem: czy chcesz korzystać z bezpośredniego Bluetooth, z chmury SwitchBot, z mostu Matter w Hub 2/Hub 3/Hub Mini Matter Enabled, czy z bezpośredniego Matter over Wi‑Fi w wersji Lock Pro Matter Enabled? Odpowiedź wpływa na koszt zestawu, opóźnienia, prywatność, dostępne encje i zachowanie po awarii internetu.

Czy SwitchBot pasuje do polskich drzwi?

SwitchBot to zamek retrofitowy: napęd montuje się od wewnętrznej strony drzwi na istniejącym kluczu, pokrętle albo odpowiednim adapterze. Zaletą jest brak konieczności natychmiastowej wymiany całego zamka. Wadą jest to, że kompatybilność zależy od geometrii drzwi, wkładki i szyldu, a nie tylko od rodzaju cylindra.

1. Wkładka musi pracować lekko

Przed montażem otwórz drzwi i kilka razy przekręć klucz ręką. Następnie zamknij drzwi i powtórz test. Jeżeli przy zamkniętych drzwiach trzeba dociskać skrzydło, unosić klamkę lub używać znacznie większej siły, problemem nie jest smart lock. Najpierw należy wyregulować drzwi, zaczep albo wkładkę. Silnik zamka może chwilowo pokonać opór, ale zużyje więcej energii, będzie głośniejszy, może raportować zacięcie i z czasem stracić poprawne punkty kalibracji.

2. Funkcja awaryjna wkładki nadal ma znaczenie

Jeżeli od wewnątrz pozostaje klucz, a z zewnątrz chcesz korzystać z drugiego klucza, wkładka powinna umożliwiać otwarcie mimo klucza włożonego po drugiej stronie. W Polsce funkcję tę opisuje się często jako funkcję awaryjną, bezpieczne sprzęgło lub możliwość obustronnego otwarcia. Zrób test dwoma kluczami przed montażem. Nie ufaj wyłącznie nazwie handlowej wkładki.

3. Drzwi z podnoszoną klamką

W drzwiach wielopunktowych użytkownik często musi najpierw unieść klamkę, aby wysunąć dodatkowe rygle, a dopiero potem obrócić klucz. Retrofitowy napęd nie podniesie klamki. Może automatycznie obrócić wkładkę dopiero wtedy, gdy człowiek wykonał etap mechaniczny. Automatyczne ryglowanie bez sprawdzenia tej cechy może skończyć się próbami silnika, błędem kalibracji albo pozornym stanem „locked”, mimo że mechanizm nie został poprawnie zaryglowany.

4. Cofnięcie zapadki nie jest tym samym co odryglowanie

W mieszkaniu bez klamki od zewnątrz samo odryglowanie nie otwiera drzwi. Napęd musi wykonać dodatkowy obrót i na moment cofnąć zapadkę. SwitchBot w aplikacji może nazywać tę funkcję „unlock”, „open door” lub „unlock deadbolt” zależnie od modelu, kalibracji i wersji integracji. Home Assistant nie zawsze pokazuje te funkcje osobno. Dlatego przed zakupem trzeba ustalić, czy wystarczy Ci stan unlocked, czy potrzebujesz także fizycznego zwolnienia zapadki.

5. Miejsce na napęd

Zmierz odległość od osi wkładki do klamki, krawędzi skrzydła, szyldu i ewentualnej zabudowy. Lock Pro ma około 120 × 59 × 83,9 mm i z bateriami waży około 435 g. To więcej niż sugerują zdjęcia produktowe. Napęd nie może zahaczać o klamkę, rozetę ani ramę podczas otwierania drzwi.

Co dokładnie trzeba kupić

Sam zamek nie zawsze tworzy kompletny zestaw. W zależności od oczekiwanej integracji mogą być potrzebne:

• Lock Pro lub Lock Ultra — napęd montowany od środka;
• Keypad, Keypad Touch albo Keypad Vision — kody PIN, odcisk palca lub inne metody wejścia;
• Hub 2, Hub 3 albo Hub Mini Matter Enabled — gdy chcesz wystawić zwykły zamek do Matter jako urządzenie podrzędne albo korzystać z usług chmurowych;
• ESPHome Bluetooth Proxy — gdy Home Assistant jest daleko od drzwi i chcesz sterować lokalnie po BLE;
• opcjonalny zestaw akumulatorowy — w Lock Pro zamiast zwykłych baterii AA;
• magnes lub czujnik pozycji drzwi — do rozróżniania „zamek odryglowany” od „drzwi fizycznie otwarte”.

Dla najprostszego lokalnego systemu wystarczą zamek i stabilny Bluetooth w Home Assistant. Dla Matter przez most potrzebny jest kompatybilny hub. Dla bezpośredniego Matter over Wi‑Fi trzeba kupić wariant wyraźnie oznaczony jako Lock Pro Matter Enabled, a nie zwykły Lock Pro.

Pięć sposobów integracji SwitchBot z Home Assistant

Metoda 1: natywna integracja SwitchBot Bluetooth

To najbardziej bezpośrednia droga dla obsługiwanych modeli. Home Assistant komunikuje się z zamkiem przez Bluetooth, bez chmury i bez huba producenta. Status oraz komendy pozostają w sieci lokalnej. Lock Ultra znajduje się na liście urządzeń certyfikowanych dla integracji SwitchBot Bluetooth, a obsługa Lock Pro była rozwijana w kolejnych wersjach Home Assistanta.

Zalety: lokalność, brak dodatkowego huba, niski koszt, działanie bez internetu. Wady: Bluetooth ma krótki zasięg, zamek wymaga dobrego sygnału, a obsługa nowych rewizji firmware może czasem wyprzedzać parser integracji.

Metoda 2: ESPHome Bluetooth Proxy

Proxy nie jest osobną integracją zamka. To zdalne „ucho Bluetooth” dla Home Assistanta. ESP32 montujesz w pobliżu drzwi, a urządzenie przekazuje reklamy i aktywne połączenia BLE przez sieć do HA. Jest to zwykle najlepsze rozwiązanie, gdy serwer działa w piwnicy, szafie rackowej albo po drugiej stronie mieszkania.

esphome:
  name: bluetooth-proxy-drzwi

esp32:
  board: esp32dev
  framework:
    type: esp-idf

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

api:
  encryption:
    key: !secret api_key

ota:
  - platform: esphome
    password: !secret ota_password

logger:

esp32_ble_tracker:
  scan_parameters:
    active: true

bluetooth_proxy:
  active: true

Proxy powinno mieć stabilne Wi‑Fi i znajdować się w odległości kilku metrów od zamka. Nie chowaj go za metalową rozdzielnicą ani bezpośrednio przy access poincie, który może generować silne zakłócenia w paśmie 2,4 GHz.

Metoda 3: SwitchBot Cloud

Integracja chmurowa używa konta SwitchBot i połączenia przez serwery producenta. Jest wygodna, jeżeli masz już hub, zależy Ci na akcesoriach widocznych tylko w aplikacji albo Bluetooth jest niestabilny. Ceną są opóźnienia, zależność od internetu, limity API i ryzyko zmian po stronie usługi.

Chmura może być rozsądną warstwą pomocniczą, ale nie powinna być jedynym sposobem wejścia do domu. Fizyczny klucz, lokalna klawiatura lub ręczne pokrętło muszą nadal działać.

Metoda 4: Matter Bridge przez Hub 2, Hub 3, Hub Mini Matter Enabled lub inne wspierane urządzenie mostkujące

W tej architekturze sam zamek komunikuje się z hubem SwitchBot, a hub wystawia go do Home Assistanta jako urządzenie Matter. W aplikacji SwitchBot trzeba wejść w ustawienia Matter huba i dodać zamek jako secondary device, czyli urządzenie podrzędne. Samo sparowanie huba z Home Assistantem nie powoduje automatycznie pojawienia się wszystkich urządzeń.

Matter działa lokalnie między Home Assistantem i hubem, lecz zamek nadal zależy od wewnętrznej komunikacji z hubem. Liczba urządzeń podrzędnych może być ograniczona zależnie od modelu huba i firmware. Niektóre mosty, na przykład Plug Mini EU działający jako Matter Bridge, obsługują tylko małą liczbę sub-device.

Metoda 5: bezpośredni Matter over Wi‑Fi w Lock Pro Matter Enabled

To nowa, odrębna wersja Lock Pro. Łączy się z kontrolerem Matter bez konieczności używania huba SwitchBot jako mostu. Producent opisuje tę wersję jako Matter over Wi‑Fi. W praktyce oznacza to, że zamek dołącza do domowego Wi‑Fi 2,4 GHz i jest commissioningowany bezpośrednio do Home Assistanta.

Którą metodę wybrać?

Nie dodawaj od razu wszystkich metod „na zapas”. Dwie integracje sterujące tym samym zamkiem mogą generować zdublowane encje, sprzeczne stany i jednoczesne próby aktywnego połączenia BLE. Najpierw wybierz metodę główną. Drugą dodawaj tylko wtedy, gdy wiesz, jaką konkretną funkcję ma uzupełnić.

Montaż krok po kroku

1. Sprawdź mechanikę bez zamka. Klucz ma obracać się płynnie przy drzwiach otwartych i zamkniętych.
2. Sprawdź awaryjne otwieranie. Włóż klucz od wewnątrz i spróbuj użyć drugiego od zewnątrz.
3. Zrób zdjęcie wkładki i szyldu. Przyda się przy wyborze adaptera i późniejszym serwisie.
4. Odtłuść powierzchnię. Taśma klejąca trzyma dobrze tylko na czystej, stabilnej powierzchni.
5. Dobierz adapter. Adapter nie może mieć luzu, ale nie powinien też klinować klucza lub pokrętła.
6. Ustaw napęd współosiowo. Przekoszony uchwyt zwiększa obciążenie silnika.
7. Zamontuj magnes czujnika drzwi. Nie kalibruj stanu drzwi, zanim magnes nie jest w docelowym miejscu.
8. Przeprowadź kalibrację przy otwartych drzwiach. Najpierw uczysz pozycje mechanizmu bez ryzyka zatrzaśnięcia się poza domem.
9. Wykonaj minimum 10 cykli testowych. Ręcznie, z aplikacji, z Home Assistanta i z zewnątrz kluczem.
10. Dopiero na końcu uruchom auto-lock. Automatyka nie może maskować błędów montażu.

Podczas kalibracji europejskiej wersji producent zaleca, aby w kroku odryglowania przekręcić pokrętło nieco dalej niż sam punkt odblokowania i wykonać to w krótkim czasie wskazanym przez aplikację. Gdy kalibracja nie rozpoznaje pytania o klucz lub zapadkę, warto zacząć od początku zamiast wielokrotnie korygować punkt końcowy.

Konfiguracja Bluetooth w Home Assistant

1. Zaktualizuj Home Assistant Core i ESPHome do aktualnych stabilnych wersji.
2. Sprawdź w Ustawienia → Urządzenia i usługi → Bluetooth, czy zamek jest widoczny.
3. Jeżeli nie jest, zbliż serwer lub uruchom Bluetooth Proxy.
4. Dodaj integrację SwitchBot albo zaakceptuj automatycznie wykryte urządzenie.
5. Nie wyłączaj Bluetooth w telefonie podczas pierwszej konfiguracji w aplikacji producenta.
6. Po dodaniu przetestuj osobno odczyt stanu oraz komendy sterujące.

Sam fakt, że Home Assistant widzi reklamę BLE, nie oznacza jeszcze, że aktywne sterowanie będzie stabilne. Reklamy mogą docierać z większej odległości niż połączenie wymagane do wysłania komendy. Dla zamków liczy się nie tylko RSSI, ale również liczba dostępnych slotów aktywnych w proxy i jakość Wi‑Fi proxy.

Jak rozpoznać problem z zasięgiem

• stan aktualizuje się, ale komenda kończy się timeoutem;
• zamek reaguje dopiero po kilku lub kilkunastu sekundach;
• po restarcie HA działa chwilę poprawnie;
• telefon przy drzwiach steruje natychmiast, a HA nie;
• logi pokazują brak możliwości utworzenia aktywnego połączenia BLE.

Matter przez Hub 2, Hub 3 lub Hub Mini

1. Dodaj zamek i hub do aplikacji SwitchBot.
2. Zaktualizuj firmware obu urządzeń.
3. Upewnij się, że hub ma stabilne Wi‑Fi 2,4 GHz.
4. W ustawieniach huba otwórz Matter Setup.
5. Dodaj zamek jako secondary device.
6. W Home Assistant uruchom integrację Matter i wybierz dodanie nowego urządzenia.
7. Zeskanuj lub wpisz kod Matter huba.
8. Po dodaniu odczekaj, aż bridge utworzy urządzenia podrzędne.

Najczęstszy błąd polega na sparowaniu samego huba i oczekiwaniu, że zamek pojawi się automatycznie. Trzeba go wcześniej wybrać na liście urządzeń podrzędnych w aplikacji SwitchBot. Jeżeli limit sub-device jest zajęty, usuń niepotrzebne urządzenie i ponów synchronizację.

W tej architekturze Home Assistant widzi standardowe funkcje klastra Door Lock. Nie zakładaj, że uzyskasz wszystkie funkcje aplikacji producenta. Zaawansowane tryby, dokładne logi, niektóre alarmy, konfiguracja Keypada czy specjalne polecenie cofnięcia zapadki mogą pozostać poza standardem Matter.

Bezpośredni Matter over Wi‑Fi w Lock Pro Matter Enabled

Ten wariant nie potrzebuje huba producenta do podstawowego połączenia Matter. Nadal potrzebujesz działającego kontrolera Matter w Home Assistant oraz telefonu używanego do commissioningu. Wszystkie urządzenia powinny mieć poprawną łączność w sieci lokalnej, a telefon i zamek muszą korzystać z dostępnego Wi‑Fi 2,4 GHz podczas konfiguracji.

1. Dodaj Lock Pro Matter Enabled do aplikacji SwitchBot i wykonaj kalibrację.
2. Zaktualizuj firmware.
3. W ustawieniach zamka otwórz sekcję Matter Setup i skopiuj kod.
4. W Home Assistant wybierz Dodaj urządzenie Matter.
5. Wprowadź kod lub zeskanuj QR.
6. Po zakończeniu sprawdź, czy stan zmienia się także po ręcznym obrocie pokrętła.

Matter over Wi‑Fi nie wymaga Thread Border Routera. Wymaga natomiast sprawnego multicastu, mDNS i komunikacji IP między kontrolerem Matter i urządzeniem. Przy VLAN-ach nie wystarczy zwykłe dopuszczenie internetu. Potrzebne są reguły umożliwiające lokalne wykrywanie i sesje Matter.

Keypad, fingerprint, NFC i dostęp gościnny

Akcesoria wejściowe są jednym z największych atutów SwitchBot. Kod PIN lub odcisk palca pozwala wejść bez telefonu, a zamek nadal może działać lokalnie nawet podczas awarii Home Assistanta. Trzeba jednak rozdzielić dwie rzeczy:

• zarządzanie poświadczeniami w aplikacji SwitchBot — zwykle pełny zakres funkcji producenta;
• zarządzanie użytkownikami przez Matter/Home Assistant — zależy od modelu, firmware i tego, czy bridge przekazuje odpowiednie klastry.

Nie zakładaj, że PIN utworzony w Home Assistant zostanie automatycznie zsynchronizowany z każdym Keypadem SwitchBot. Po utworzeniu kodu zawsze wykonaj fizyczny test, a następnie sprawdź, czy dziennik poprawnie rozpoznaje użytkownika. Dla najmu krótkoterminowego ważne są również harmonogramy ważności kodów i możliwość ich natychmiastowego unieważnienia.

Minimalne zasady bezpieczeństwa kodów

• nie używaj dat urodzenia, numeru mieszkania ani prostych sekwencji;
• każdy domownik powinien mieć osobny kod;
• serwis i sprzątanie powinny korzystać z kodów czasowych;
• po zgubieniu telefonu lub zmianie personelu usuń stare uprawnienia;
• powiadomienia o błędnych próbach traktuj jako sygnał diagnostyczny, nie automatyczny dowód włamania.

Zasilanie i scenariusz awaryjny

Lock Pro

Standardowy Lock Pro korzysta z czterech baterii AA. Producent podaje orientacyjnie 6–9 miesięcy pracy, a z opcjonalnym Dual Power Pack około 9–12 miesięcy, zależnie od liczby operacji, temperatury, oporu drzwi i sposobu komunikacji. Nie mieszaj baterii różnych marek, typów ani stopnia zużycia.

Lock Ultra

Lock Ultra ma bardziej rozbudowany system zasilania. W zestawach producent opisuje główny pakiet z trzema ogniwami 18350 o łącznej pojemności około 4200 mAh, baterię zapasową CR123A mogącą podtrzymać wiele awaryjnych operacji oraz tryb mikro-zasilania pozwalający na kilka ostatnich odblokowań. Dokładna konfiguracja zależy od wersji i rynku.

Żaden system zasilania nie zastępuje fizycznej drogi awaryjnej. Co najmniej jedna z metod powinna działać bez telefonu, internetu, Home Assistanta i huba. W zależności od drzwi może to być klucz od zewnątrz, mechaniczne pokrętło od środka, keypad z lokalnymi kodami albo zapasowe zasilanie.

Stany zamka: locked, unlocked, locking, unlocking, jammed i half-lock

Home Assistant może pokazywać więcej niż dwa stany. Są one ważne dla automatyzacji:

• locked — napęd uważa, że dotarł do pozycji zaryglowanej;
• unlocked — rygiel został cofnięty do zapamiętanej pozycji;
• locking / unlocking — operacja trwa;
• jammed — wykryto opór lub brak dotarcia do punktu końcowego;
• half-lock — stan pośredni obsługiwany przez niektóre nowsze modele i integracje, między innymi Lock Ultra;
• unknown / unavailable — brak wiarygodnej informacji albo utrata łączności.

Stan zamka nie mówi automatycznie, czy skrzydło drzwi jest zamknięte. Możesz mieć rygiel cofnięty i drzwi zamknięte, rygiel wysunięty przy otwartych drzwiach albo zamek raportujący pozycję krańcową mimo niedomkniętego skrzydła. Dlatego automatyczne ryglowanie powinno korzystać także z czujnika drzwi.

Gotowe automatyzacje Home Assistant

1. Automatyczne ryglowanie dopiero po zamknięciu drzwi

alias: Drzwi wejściowe - bezpieczne automatyczne ryglowanie
mode: restart
trigger:
  - platform: state
    entity_id: binary_sensor.drzwi_wejsciowe
    to: "off"
    for: "00:00:30"
condition:
  - condition: state
    entity_id: lock.switchbot_drzwi
    state: "unlocked"
action:
  - service: lock.lock
    target:
      entity_id: lock.switchbot_drzwi
  - delay: "00:00:08"
  - condition: template
    value_template: "{{ not is_state('lock.switchbot_drzwi', 'locked') }}"
  - service: notify.mobile_app_telefon
    data:
      title: "Nie udało się zaryglować drzwi"
      message: "Sprawdź mechanikę drzwi i stan zamka SwitchBot."

2. Ostrzeżenie o otwartych drzwiach wieczorem

alias: Drzwi wejściowe otwarte po 22
mode: single
trigger:
  - platform: state
    entity_id: binary_sensor.drzwi_wejsciowe
    to: "on"
    for: "00:03:00"
condition:
  - condition: time
    after: "22:00:00"
    before: "06:00:00"
action:
  - service: notify.mobile_app_telefon
    data:
      title: "Drzwi wejściowe są otwarte"
      message: "Drzwi pozostają otwarte od co najmniej 3 minut."

3. Powiadomienie o niskiej baterii

alias: SwitchBot - niski poziom baterii
mode: single
trigger:
  - platform: numeric_state
    entity_id: sensor.switchbot_lock_battery
    below: 25
action:
  - service: notify.mobile_app_telefon
    data:
      title: "Bateria zamka poniżej 25%"
      message: >-
        Poziom baterii: {{ states('sensor.switchbot_lock_battery') }}%.
        Zaplanuj wymianę lub ładowanie.

4. Nocna kontrola zamka bez automatycznego odryglowania

alias: Nocna kontrola drzwi wejściowych
trigger:
  - platform: time
    at: "23:00:00"
condition:
  - condition: or
    conditions:
      - condition: state
        entity_id: lock.switchbot_drzwi
        state: "unlocked"
      - condition: state
        entity_id: binary_sensor.drzwi_wejsciowe
        state: "on"
action:
  - service: notify.mobile_app_telefon
    data:
      title: "Kontrola drzwi"
      message: >-
        Zamek: {{ states('lock.switchbot_drzwi') }},
        drzwi: {{ states('binary_sensor.drzwi_wejsciowe') }}.

Nie polecam automatycznego odryglowania wyłącznie na podstawie wejścia telefonu do strefy domu. GPS może zadziałać z opóźnieniem lub zbyt wcześnie. Bezpieczniejszy scenariusz łączy kilka warunków i kończy się potwierdzeniem na telefonie albo zegarku.

Najczęstsze problemy i rozwiązania

Problem 1: zamek nie pojawia się w Home Assistant przez Bluetooth

Przyczyny: zbyt duża odległość, brak obsługi konkretnej rewizji firmware, urządzenie pozostające w złym stanie rejestru, aktywne połączenie aplikacji telefonu albo nieobsługiwany model.

Rozwiązanie: zaktualizuj HA, sprawdź wykrycie w integracji Bluetooth, ustaw proxy blisko drzwi, zamknij aplikację SwitchBot na czas testu i uruchom ponownie urządzenie. W pojedynczych przypadkach użytkownicy znajdowali osierocony wpis urządzenia z pustą listą config entries w rejestrze HA. Ręczna edycja plików `.storage` jest jednak operacją ryzykowną i powinna być poprzedzona pełnym backupem; nie zaczynaj od niej.

Problem 2: stan przełącza się co kilka sekund między locked i unlocked

Zgłoszenia dotyczące Lock Pro i Lock Ultra wskazywały na błędną interpretację danych BLE po operacji lub po zmianie firmware. Najpierw zaktualizuj Home Assistant do wersji zawierającej poprawkę parsera. Nie próbuj „naprawiać” kalibracji, jeżeli fizyczny zamek działa prawidłowo, a zmienia się wyłącznie stan w interfejsie.

Problem 3: encja zostaje na locking albo unlocking

Jeżeli zamek wykonał ruch, ale stan pośredni nie znika, sprawdź, czy kolejna reklama BLE dociera do HA. Przeładownie integracji może chwilowo pomóc, ale docelowo potrzebna jest aktualizacja integracji, stabilniejszy proxy albo korekta firmware. Zapisz log diagnostyczny przed przeładowaniem, ponieważ po restarcie tracisz najważniejszy moment błędu.

Problem 4: po komendzie unlock drzwi się otwierają zamiast tylko odryglować

W niektórych konfiguracjach pozycja odblokowania została skalibrowana razem z cofnięciem zapadki. Powtórz kalibrację i rozdziel pozycję odryglowaną od krótkiego ruchu „open door”. Jeżeli integracja wystawia tylko jedną komendę, sprawdź, czy Matter albo Bluetooth daje bogatszy zestaw funkcji dla Twojej wersji urządzenia.

Problem 5: zamek nie rygluje drzwi wielopunktowych

Napęd nie podnosi klamki. Użytkownik musi najpierw mechanicznie przygotować rygle. Możesz dodać przypomnienie po zamknięciu drzwi, ale nie istnieje bezpieczna automatyzacja, która zastąpi fizyczne podniesienie klamki, chyba że drzwi mają osobny napęd elektromechaniczny.

Problem 6: Home Assistant widzi hub Matter, ale nie widzi zamka

Wejdź do SwitchBot App → ustawienia huba → Matter Setup → Secondary Devices i dodaj Lock Pro lub Lock Ultra. Sprawdź również limit urządzeń podrzędnych. Sam hub może być poprawnie sparowany, a lista sub-device pozostać pusta.

Problem 7: Matter nie chce się sparować

Sprawdź aktualny firmware, poprawność kodu, Wi‑Fi 2,4 GHz, multicast i mDNS. Jeżeli urządzenie było wcześniej dodane do innego ekosystemu, wygeneruj kod Multi-Admin w istniejącym ekosystemie zamiast wykonywać reset. W przypadku bridge’a kod dotyczy huba, nie samego zamka.

Problem 8: kalibracja po aktualizacji firmware nie kończy się

Istniały zgłoszenia, w których aktywna integracja Home Assistant próbowała komunikować się z zamkiem podczas kalibracji w aplikacji, zakłócając procedurę. Na czas kalibracji wyłącz integrację SwitchBot lub zatrzymaj Bluetooth Proxy, wykonaj kalibrację w aplikacji, a dopiero potem ponownie uruchom HA.

Problem 9: Door Sensor pokazuje zły stan

Sprawdź położenie magnesu i ponów kalibrację stanu drzwi. Metalowa ościeżnica, zbyt duża szczelina albo przesunięcie magnesu mogą powodować niestabilny odczyt. Jeżeli integracja chmurowa nie wystawia osobnego sensora, dodaj niezależny kontaktron Zigbee lub Z-Wave. Dla krytycznej automatyzacji niezależny czujnik jest często bardziej przewidywalny.

Problem 10: bateria znika znacznie szybciej niż deklaruje producent

Sprawdź opór mechanizmu, liczbę operacji, temperaturę, częstotliwość aktywnych połączeń BLE i jakość sygnału. Silnik walczący z niedopasowanymi drzwiami potrafi zużyć wielokrotnie więcej energii niż w warunkach testowych.

Problem 11: ręczne użycie klucza nie aktualizuje stanu

Model lub metoda integracji może opierać się na okresowych reklamach. Poczekaj na następną aktualizację, sprawdź zasięg i ponów kalibrację. Jeżeli stan mechaniczny jest dla Ciebie krytyczny, zweryfikuj go osobnym czujnikiem położenia rygla albo automatyzacją porównującą kilka sygnałów.

Problem 12: zamek jest dostępny przez Matter, ale brakuje Keypada i historii

To nie musi być błąd. Matter może wystawiać tylko podstawowy klaster zamka. Konfiguracja odcisków, rozbudowane logi i część alarmów pozostają w aplikacji SwitchBot. Korzystaj z Matter do podstawowego sterowania, a aplikację producenta pozostaw do administracji akcesoriami.

VLAN, Wi‑Fi i bezpieczeństwo sieci

Dla połączenia Bluetooth zamek nie musi być w Wi‑Fi. ESPHome Proxy powinno znajdować się w VLAN-ie IoT, ale musi mieć dostęp do Home Assistanta przez natywne API. Dla huba Matter albo Lock Pro Matter Enabled wymagane są lokalne połączenia IP.

• zezwól kontrolerowi Home Assistant na inicjowanie połączeń do urządzenia IoT;
• nie blokuj bezrefleksyjnie multicastu i mDNS między potrzebnymi segmentami;
• ogranicz dostęp urządzenia IoT do pozostałej sieci Main;
• zapewnij DNS i NTP;
• dla huba chmurowego dopuść tylko potrzebny ruch wychodzący;
• nie wystawiaj bezpośrednio interfejsu huba ani Home Assistanta do internetu.

Zamek jest urządzeniem bezpieczeństwa, ale nie należy tworzyć wokół niego tak restrykcyjnych reguł, że przestaje działać lokalne wykrywanie. Segmentacja ma ograniczać skutki kompromitacji, a nie losowo zrywać protokół.

Test odbiorowy po instalacji

1. Otwórz i zamknij drzwi ręcznie 10 razy.
2. Sprawdź klucz z zewnątrz przy napędzie zamontowanym od środka.
3. Przetestuj lock i unlock z aplikacji SwitchBot.
4. Przetestuj te same polecenia z Home Assistant.
5. Sprawdź cofnięcie zapadki, jeżeli go potrzebujesz.
6. Odłącz internet i ponów test lokalny.
7. Wyłącz Home Assistant i sprawdź keypad, klucz i pokrętło.
8. Zasymuluj niedomknięte drzwi i sprawdź alarm.
9. Sprawdź zachowanie po ręcznym obrocie klucza.
10. Sprawdź, czy stan baterii jest wystawiany.
11. Uruchom automatyczne ryglowanie dopiero po potwierdzeniu czujnika drzwi.
12. Zrób pełny backup Home Assistanta.

Czy SwitchBot Lock Pro lub Ultra warto kupić?

Warto, gdy: chcesz retrofit bez wymiany całego zamka, potrzebujesz wielu adapterów, zależy Ci na keypadzie lub fingerprint, akceptujesz ekosystem SwitchBot i chcesz wybrać między BLE, Matter oraz chmurą.

Zastanów się, gdy: masz drzwi wielopunktowe z obowiązkowym podnoszeniem klamki, potrzebujesz zawsze niezawodnego cofania zapadki przez standardową encję Matter albo nie chcesz żadnej aplikacji producenta nawet do aktualizacji firmware i kalibracji.

Nie kupuj w ciemno, gdy: oferta nie podaje, czy jest to zwykły Lock Pro, zestaw z hubem, czy Lock Pro Matter Enabled. Te produkty mogą wyglądać podobnie, ale wymagają innej infrastruktury.

FAQ — najczęstsze pytania użytkowników

Czy SwitchBot działa bez internetu?

Tak, gdy korzystasz z lokalnego Bluetooth, Bluetooth Proxy albo lokalnego sterowania Matter. Aplikacja chmurowa i część funkcji huba mogą wymagać internetu.

Czy potrzebuję SwitchBot Hub?

Nie do lokalnego Bluetooth. Potrzebujesz go do klasycznego mostkowania zwykłego Lock Pro lub Lock Ultra do Matter oraz do części funkcji zdalnych. Osobny Lock Pro Matter Enabled może działać bez huba producenta.

Czy Home Assistant Container obsługuje Matter?

Matter Server można uruchomić również jako osobny komponent, ale oficjalnie najprostszą i wspieraną ścieżką jest Home Assistant OS z dodatkiem Matter Server. Nie należy już twierdzić, że Container „w ogóle nie obsługuje Matter”, jednak konfiguracja jest bardziej zaawansowana.

Czy można nadal otworzyć drzwi kluczem?

Tak, jeżeli wkładka i sposób montażu na to pozwalają. Przed montażem sprawdź funkcję awaryjną wkładki dwoma kluczami.

Czy zamek podniesie klamkę?

Nie. Retrofit obraca klucz lub pokrętło. Nie zastąpi mechanicznego podniesienia klamki w drzwiach wielopunktowych.

Czy Matter pokaże fingerprint i wszystkie kody?

Niekoniecznie. Standard i bridge mogą wystawić tylko podstawowy stan oraz lock/unlock. Zarządzanie akcesoriami często pozostaje w aplikacji SwitchBot.

Czy można dodać zamek jednocześnie przez Matter i Bluetooth?

Technicznie bywa to możliwe, ale tworzy zdublowane encje i może prowadzić do sprzecznych stanów. Używaj jednej metody jako głównej, a drugiej tylko dla konkretnej brakującej funkcji.

Dlaczego Home Assistant widzi stan, ale nie może sterować?

Odczyt reklam BLE wymaga mniej niż aktywne połączenie. Przenieś proxy bliżej drzwi i sprawdź liczbę aktywnych połączeń Bluetooth.

Czy deklarowany rok pracy na baterii jest realny?

Możliwy w dobrych warunkach, ale nie jest gwarancją. Ciężko pracująca wkładka, mróz, częste operacje i słaby sygnał skracają czas pracy.

Czy Lock Ultra jest bezpieczniejszy od Lock Pro?

Ma bardziej rozbudowane zasilanie awaryjne i nowszą mechanikę, ale bezpieczeństwo całego systemu zależy również od wkładki, drzwi, kodów, konta i procedury awaryjnej.

Szczegółowe porównanie modeli — który SwitchBot ma sens w 2026 roku

Stary SwitchBot Lock

Najstarszy model nadal może być atrakcyjny na rynku wtórnym, szczególnie gdy kosztuje wyraźnie mniej niż Lock Pro. Ma jednak słabszy napęd, mniej wygodny mechanizm ręcznego sterowania i węższą kompatybilność z nietypowymi wkładkami. Kupno używanego egzemplarza ma sens tylko wtedy, gdy możesz sprawdzić stan uchwytu, taśmy, adapterów i baterii oraz potwierdzić, że urządzenie nie jest przypisane do konta poprzedniego właściciela.

Do prostych drzwi z lekko pracującą wkładką i lokalnym Bluetooth może wystarczyć. Nie jest jednak najlepszym wyborem do ciężkich drzwi, częstego użytkowania, najmu lub instalacji, w której zamek codziennie wykonuje wiele automatycznych cykli.

SwitchBot Lock Pro

To najbardziej uniwersalny model dla osoby, która chce retrofit bez wymiany wkładki i nie potrzebuje najnowszego systemu zasilania Ultra. Quick Key pozwala ręcznie sterować zamkiem od środka, zestaw adapterów zwiększa kompatybilność, a cztery baterie AA są łatwo dostępne. Lock Pro jest rozsądnym wyborem, gdy Home Assistant będzie łączył się lokalnie po Bluetooth lub gdy masz już kompatybilny hub SwitchBot.

Trzeba jednak uważać na oferty. Sprzedawcy mogą używać słowa „Matter” dla zestawu Lock Pro + Hub 2, mimo że sam zamek nie jest bezpośrednim urządzeniem Matter. W takiej sytuacji po usunięciu huba integracja Matter przestanie działać.

SwitchBot Lock Pro Matter Enabled

Ten wariant jest szczególnie ciekawy dla nowej instalacji, w której chcesz ograniczyć liczbę urządzeń pośrednich. Bezpośredni Matter over Wi‑Fi upraszcza architekturę, ale zwiększa znaczenie jakości sieci Wi‑Fi przy drzwiach. Zamek nie korzysta z energooszczędnego Thread, dlatego realny czas pracy trzeba oceniać po kilku miesiącach we własnych warunkach.

Przed zakupem sprawdź, czy dana wersja regionalna faktycznie zawiera bezpośredni Matter, jakie akcesoria są w zestawie oraz czy producent udostępnia wszystkie potrzebne funkcje przez standard. Sam napis „Matter Enabled” nie gwarantuje, że Home Assistant pokaże fingerprint, historię, zaawansowaną kalibrację lub osobną komendę zwolnienia zapadki.

SwitchBot Lock Ultra

Ultra jest najlepszą propozycją dla osoby, która stawia na mechanikę, kulturę pracy, szeroką zgodność i zasilanie awaryjne. Producent deklaruje zgodność z większością single deadbolt, jimmy proof i mortise locks przy użyciu adapterów. W Europie nadal trzeba dokładnie sprawdzić konkretną wkładkę i szyld, ponieważ marketingowe „99,9% drzwi” nie zastępuje pomiaru.

Ultra ma sens również wtedy, gdy zależy Ci na rozbudowanym zestawie wejścia bez telefonu, na przykład Keypad Vision, fingerprint lub NFC. Z punktu widzenia Home Assistanta jego przewagą jest obsługa Bluetooth i stopniowo rozwijane stany, w tym half-lock. Ograniczeniem pozostaje to, że aplikacja SwitchBot może oferować więcej niż standardowa encja zamka.

Migracja między Bluetooth, chmurą i Matter

Zmiana metody integracji nie powinna zaczynać się od usuwania działającego zamka. Najpierw zapisz nazwy encji, automatyzacje, dashboardy, kody użytkowników i ustawienia auto-lock. Zrób pełny backup Home Assistanta oraz zrzuty ekranu ustawień w aplikacji SwitchBot.

Z chmury na Bluetooth

1. Uruchom Bluetooth Proxy blisko drzwi i potwierdź stabilny odczyt przez kilka dni.
2. Dodaj lokalną integrację, ale nie zmieniaj jeszcze automatyzacji.
3. Porównuj stan encji chmurowej i lokalnej.
4. Przenieś najpierw powiadomienia, później sterowanie.
5. Dopiero po stabilnym okresie usuń zależność od chmury.

Z Bluetooth na Matter Bridge

Najpierw dodaj zamek jako secondary device w hubie. Po pojawieniu się encji Matter sprawdź, czy dostępne są wszystkie potrzebne funkcje. Często Matter daje szybsze lock/unlock, ale mniej informacji diagnostycznych. Jeżeli brakuje sensora baterii lub drzwi, możesz pozostawić Bluetooth wyłącznie do odczytu, lecz unikaj wysyłania poleceń z dwóch integracji.

Zmiana huba albo reset Matter

Usunięcie bridge’a może usunąć wszystkie urządzenia podrzędne z Home Assistanta i zmienić identyfikatory encji po ponownym dodaniu. Dlatego najpierw wyłącz automatyzacje, zanotuj entity_id i usuń stary fabric w kontrolowany sposób. Nie resetuj zamka mechanicznie tylko dlatego, że Matter Bridge przestał odpowiadać — problem może dotyczyć wyłącznie huba.

Jak uniknąć bałaganu

• nazwij encje z dopiskiem `_ble`, `_matter` lub `_cloud` na etapie testów;
• stwórz grupę diagnostyczną porównującą stany;
• nie używaj jednocześnie dwóch encji do auto-lock;
• po migracji usuń stare wyzwalacze urządzeniowe i zastąp je wyzwalaczami encji;
• przetestuj scenariusz po restarcie HA, huba i routera.

Praktyczne konfiguracje dla różnych domów

Mieszkanie w bloku, drzwi bez klamki od zewnątrz

Najważniejsza jest funkcja cofnięcia zapadki. Wybierz model i metodę integracji dopiero po potwierdzeniu, że Home Assistant potrafi wykonać potrzebną komendę. Dobrym zestawem jest Lock Pro lub Ultra, lokalny keypad i Bluetooth Proxy przy przedpokoju. Auto-lock powinien uruchamiać się po kontaktronie, ale auto-unlock najlepiej pozostawić jako ręczne potwierdzenie.

Dom jednorodzinny z drzwiami wielopunktowymi

Przed zakupem sprawdź, czy drzwi wymagają podniesienia klamki. Jeżeli tak, smart lock nie zapewni pełnej automatyzacji. Użyj kontaktronu, powiadomienia „podnieś klamkę i zarygluj” oraz nocnego sprawdzania stanu. W domu przydatny jest niezależny czujnik drzwi, ponieważ magnes zamka może nie raportować dobrze na grubej lub metalowej ościeżnicy.

Najem krótkoterminowy

Tu ważniejsza od samego Matter jest administracja kodami. Sprawdź możliwość tworzenia kodów czasowych, historię użycia, awaryjny dostęp właściciela i działanie keypada bez internetu. Home Assistant może automatyzować przygotowanie mieszkania, ale nie powinien być jedynym systemem wydającym poświadczenia. Po każdej zmianie gościa wykonuj fizyczny test kodu.

Biuro lub lokal usługowy

Potrzebne są osobne konta i kody, rejestr zdarzeń, harmonogram oraz procedura na wypadek utraty łączności. Nie używaj jednego wspólnego PIN-u. Rozważ dwa niezależne kanały alarmowania: Home Assistant oraz aplikację producenta. W przypadku wielu wejść sprawdź limity huba i liczbę aktywnych połączeń Bluetooth Proxy.

Aktualizacje firmware — jak robić je bezpiecznie

Aktualizacja może poprawić bezpieczeństwo i obsługę integracji, ale w zamku wejściowym nie warto instalować jej tuż przed wyjazdem, nocą ani wtedy, gdy nie masz fizycznego klucza. Najbezpieczniejsza procedura wygląda tak:

1. Sprawdź changelog i aktualne zgłoszenia użytkowników.
2. Naładuj lub wymień baterie przed aktualizacją.
3. Otwórz drzwi i pozostaw je otwarte podczas pierwszej kalibracji.
4. Wyłącz automatyczne ryglowanie w Home Assistant.
5. W razie problemów zatrzymaj integrację BLE, aby nie konkurowała z aplikacją.
6. Po aktualizacji wykonaj ponowny test stanu, lock, unlock, open door i ręcznego klucza.
7. Sprawdź, czy entity_id i dostępne funkcje nie zmieniły się.

Nie każda aktualizacja wymaga ponownej kalibracji, ale po zmianie sposobu raportowania pozycji warto ją zweryfikować. Gdy po aktualizacji HA pokazuje błędny stan, najpierw sprawdź, czy pojawiła się poprawka integracji, zamiast wielokrotnie przestawiać mechaniczne punkty końcowe.

Konserwacja raz w miesiącu i raz na pół roku

Co miesiąc

• sprawdź poziom baterii i historię nagłych spadków;
• wykonaj ręczny test klucza z zewnątrz;
• sprawdź, czy uchwyt i adapter nie mają luzu;
• przetestuj keypad oraz co najmniej jeden kod awaryjny;
• sprawdź, czy czujnik drzwi nie zmienił położenia.

Co sześć miesięcy

• sprawdź regulację drzwi i zaczepu;
• wyczyść powierzchnię urządzenia i styki baterii;
• przejrzyj listę użytkowników i usuń nieaktualne kody;
• sprawdź backup Home Assistanta i dokumentację awaryjną;
• przetestuj działanie bez internetu;
• zweryfikuj, czy automatyzacje nie używają starych encji.

Nie smaruj wkładki przypadkowym olejem. Niektóre środki wiążą kurz i z czasem pogarszają pracę. Stosuj preparat przeznaczony do konkretnego typu cylindra lub skonsultuj się z producentem wkładki.

Źródła i materiały wykorzystane przy researchu

Artykuł powstał na podstawie dokumentacji Home Assistant, dokumentacji i stron produktowych SwitchBot oraz zgłoszeń użytkowników w GitHub Issues i Home Assistant Community. Najważniejsze materiały:

• Home Assistant — integracja SwitchBot Bluetooth;
• Home Assistant — integracja SwitchBot Matter i ogólna dokumentacja Matter;
• SwitchBot — specyfikacje Lock Pro, Lock Pro Matter Enabled i Lock Ultra;
• SwitchBot Support — kalibracja zamka oraz dodawanie urządzeń podrzędnych do Matter;
• GitHub Home Assistant Core — zgłoszenia dotyczące przełączania stanów, utknięcia na locking/unlocking, kalibracji i funkcji open door;
• Home Assistant Community — wątki o Lock Pro przez Matter, Bluetooth Proxy i różnicach między integracjami.

Stan informacji: sierpień 2026. Funkcje integracji, listy certyfikowanych urządzeń i firmware zamków mogą się zmieniać, dlatego przed zakupem konkretnej wersji należy sprawdzić aktualną kartę produktu i dokumentację integracji.

Co dalej w serii

W kolejnej części opiszę LOQED, Danalock i mniej popularne zamki: które rozwiązania nadal mają sens, które zostały porzucone, jak wygląda lokalna integracja i kiedy używany zamek Z-Wave jest okazją, a kiedy ryzykiem.

Cała seria: zamki do drzwi w Home Assistant

Przejdź do poradnika zakupowego, konkretnej marki albo gotowych automatyzacji. Każda część odpowiada na inną intencję i uzupełnia pozostałe artykuły.