Baza wiedzy Sinum

Integracja z kotłem Viessmann

Integracja z kotłem Viessmann umożliwia zdalne monitorowanie i sterowanie ogrzewaniem (CO) oraz ciepłą wodą użytkową (CWU).

Przed rozpoczęciem – uzyskanie Client ID

Aby korzystać z integracji, musisz najpierw uzyskać własny Client ID z portalu Viessmann Developer.

Założenie konta i dodanie kotła do aplikacji ViCare

  1. Pobierz aplikację ViCare na telefon (iOS/Android).

  2. Załóż konto Viessmann w aplikacji.

  3. Dodaj swój kocioł do aplikacji ViCare zgodnie z instrukcją producenta.

  4. Upewnij się, że kocioł jest widoczny i działa w aplikacji.

Logowanie do Viessmann Developer Portal

  1. Wejdź na stronę developer.viessmann-climatesolutions.com.

  2. Zaloguj się tymi samymi danymi co do aplikacji ViCare (email i hasło).

Utworzenie nowego klienta (Client)

  1. Kliknij My Dashboard w górnym menu strony. 

  2. Znajdź sekcję „Your clients”.

  3. Kliknij przycisk „+ Add”.

  4. Wypełnij formularz:

    • Name – dowolna nazwa (np. „sinum”, „moja_integracja”),

    • Redirect URIs – wpisz http://localhost:4200/.

  5. Kliknij „Create Client”.

Skopiowanie wygenerowanego Client ID

Po utworzeniu klienta zostanie wygenerowany Client ID – długi ciąg znaków.

  1. Skopiuj wygenerowany Client ID (np. a57a6ca6c0cc1f7f55ddb89b0e5cbc31).

  2. Użyj go w konfiguracji urządzenia.

🔧 Pierwsza konfiguracja

Po uzyskaniu Client ID możesz skonfigurować połączenie z API Viessmann.

  1. Kliknij ikonę ⋯ (menu) w prawym górnym rogu ekranu głównego.

  2. Wybierz Konfiguracja.

Wprowadzenie danych logowania

Pole Opis
Client ID Wklej identyfikator Client ID uzyskany z portalu Viessmann Developer Portal.
Email Adres e-mail konta Viessmann (ten sam, który jest używany w aplikacji ViCare).
Hasło Hasło do konta Viessmann.

 

Logowanie

  1. Kliknij przycisk Zaloguj.

  2. Poczekaj na wyświetlenie komunikatu „✓ Zalogowano!”.

  3. W przypadku wyświetlenia komunikatu o błędzie sprawdź poprawność wprowadzonych danych logowania.

Wybór harmonogramu CWU (opcjonalnie)

Jeżeli chcesz korzystać z trybu harmonogramu dla CWU:

  1. W polu Plan pracy CWU wybierz harmonogram przekaźników.

  2. Upewnij się, że harmonogram został wcześniej utworzony w systemie (typ harmonogramu: relay_control).

Zakończenie konfiguracji

Kliknij przycisk Zakończ konfigurację, aby zapisać ustawienia i przejść do ekranu głównego.

🏠Ekran główny

Ekran główny prezentuje najważniejsze informacje dotyczące stanu pracy kotła.

Sekcja CO (Ogrzewanie)

Element Opis
CO: 42,6°C Aktualna temperatura zasilania instalacji grzewczej.
🔥 Ikona ognia pojawia się, gdy kocioł aktualnie ogrzewa obieg CO.
Tryb Lista rozwijana umożliwiająca wybór trybu pracy: GRZANIE / CZUWANIE.
Zadana Suwak umożliwiający ustawienie temperatury zadanej w zakresie 20–82°C.

Sekcja CWU (Ciepła woda użytkowa)

Element Opis
CWU: 43,8°C Aktualna temperatura zasobnika CWU.
🔥 Ikona ognia pojawia się, gdy kocioł aktualnie ogrzewa zasobnik CWU.
Tryb Lista rozwijana umożliwiająca wybór trybu pracy: Zrównoważony, Wyłączony, Harmonogram.
Status Wyświetla aktualny stan pracy CWU w trybie harmonogramu.
Dogrzej Przycisk umożliwiający jednorazowe dogrzanie zasobnika CWU.
Zadana CWU Suwak umożliwiający ustawienie temperatury zadanej CWU.

Sekcja statusu

Element Opis
Kocioł: praca / off Informacja, czy palnik kotła jest aktualnie aktywny.
Modulacja: 16,9% Aktualna moc palnika wyrażona w procentach.

🔥Sterowanie ogrzewaniem (CO)

Dostępne tryby CO

Tryb Opis
GRZANIE Ogrzewanie aktywne — kocioł pracuje do osiągnięcia temperatury zadanej.
CZUWANIE Ogrzewanie wyłączone — aktywna jedynie funkcja ochrony przed zamarzaniem.


Zmiana temperatury zadanej

  1. Użyj suwaka Zadana lub przycisków – / +.

  2. Aktualna wartość temperatury wyświetlana jest po prawej stronie suwaka.

  3. Zakres regulacji temperatury wynosi 20–82°C.

  4. Zmiana temperatury jest wysyłana do kotła natychmiast po jej ustawieniu.

💡Zalecana konfiguracja — styk beznapięciowy

Dla zapewnienia niezawodnego sterowania pracą kotła zaleca się stosowanie styku beznapięciowego zamiast wyłącznie sterowania przez API.

Dlaczego styk beznapięciowy?

Metoda Zalety Wady
Tylko API Prosta konfiguracja. Wymaga dostępu do internetu, możliwe opóźnienia.
Styk beznapięciowy Działanie lokalne, wysoka niezawodność. Wymaga wykonania okablowania.

Uwaga:
API Viessmann działa w oparciu o połączenie internetowe. W przypadku awarii sieci lub serwerów Viessmann sterowanie kotłem może nie działać. Styk beznapięciowy funkcjonuje niezależnie od internetu i zapewnia wyższą niezawodność działania.

Konfiguracja styku beznapięciowego

  1. Podłącz styk beznapięciowy do wejścia termostatu pokojowego („pokojówki”) w kotle Viessmann.

  2. Ustaw kocioł w trybie stałego grzania — CO: GRZANIE.

  3. Styk steruje pracą kotła:

    • styk zamknięty — kocioł grzeje,

    • styk otwarty — kocioł oczekuje.

  4. Skonfiguruj wirtualny styk w systemie Sinum (szczegóły w kolejnej sekcji).

Konfiguracja wirtualnego styku w systemie Sinum

Szczegółowa instrukcja konfiguracji wirtualnego styku dostępna jest w bazie wiedzy Sinum:
🔗 Konfiguracja ogrzewania — wirtualny styk

Skrócona instrukcja

  1. Przejdź do Ustawienia → Urządzenia → Urządzenia wirtualne.

  2. Kliknij + i wybierz Wirtualny styk.

  3. Nadaj nazwę urządzeniu oraz przypisz:

    • Urządzenia wymagane — termostaty do obsługi,

    • Urządzenia dodatkowe — przekaźnik ogrzewania.

  4. Zapisz konfigurację.

Schemat działania

Podsumowanie zalecanej konfiguracji

Element Ustawienie
Tryb CO w urządzeniu Viessmann GRZANIE (stałe)
Sterowanie pracą kotła Wirtualny styk w systemie Sinum
Połączenie fizyczne Styk beznapięciowy → wejście pokojówki kotła

Sterowanie ciepłą wodą (CWU)

Dostępne tryby CWU

Tryb Opis
Zrównoważony CWU włączone — kocioł podgrzewa wodę, gdy temperatura spadnie poniżej zadanej.
Wyłączony CWU wyłączone — brak podgrzewania wody użytkowej.
Harmonogram CWU sterowane według harmonogramu (wymaga wcześniejszej konfiguracji).

Zmiana temperatury zadanej CWU

  1. Użyj suwaka Zadana CWU lub przycisków – / +.

  2. Zakres regulacji zależy od ustawień kotła (typowo 30–60°C).

Tryb harmonogramu CWU

Tryb harmonogramu pozwala automatycznie włączać i wyłączać CWU zgodnie z wcześniej zdefiniowanym planem.

Wymagania:

  • Utworzony harmonogram przekaźników typu relay_control w systemie.

  • Harmonogram wybrany w konfiguracji urządzenia.

Działanie:

  1. System sprawdza stan harmonogramu co minutę.

  2. Gdy harmonogram wskazuje ON → CWU przełącza się na Zrównoważony.

  3. Gdy harmonogram wskazuje OFF → CWU przełącza się na Wyłączony.

Status harmonogramu:
Obok pola trybu wyświetlany jest aktualny stan:

  • CWU: włączone — harmonogram włączył CWU,

  • CWU: wyłączone — harmonogram wyłączył CWU.

Uwaga: Opcja Harmonogram pojawia się w liście trybów tylko wtedy, gdy harmonogram został wybrany w konfiguracji urządzenia.

Funkcja „Dogrzej CWU”

Funkcja umożliwia jednorazowe dogrzanie wody użytkowej niezależnie od aktualnego trybu CWU.

Widoczność przycisku:

  • Przyciski Dogrzej są widoczne, gdy tryb CWU to Wyłączony lub Harmonogram.

  • W trybie Zrównoważony przycisk jest ukryty (CWU i tak jest aktywne).

Działanie:

  1. Kliknij przycisk Dogrzej.

  2. CWU zostaje włączone na 1 godzinę.

  3. W polu statusu wyświetlany jest pozostały czas dogrzewania, np. „Dogrzewanie: 45:30”.

  4. Dogrzewanie kończy się, gdy:

    • upłynie 1 godzina, lub

    • temperatura CWU osiągnie wartość zadaną.

Po zakończeniu dogrzewania:

  • Jeśli poprzedni tryb był Harmonogram → system sprawdza harmonogram i przywraca odpowiedni tryb.

  • Jeśli poprzedni tryb był Wyłączony → system wyłącza CWU.

Przerwanie dogrzewania:
Zmiana trybu CWU na dowolny inny automatycznie przerywa dogrzewanie.