IntelligentHome

Aplikacja pozwalająca wydawać polecenia przesyłane poprzez sieć do inteligentnego domu, a dokładnie serwera MQTT. Serwer MQTT może być uruchomiony zarówno lokalnie jak i na chmurze.
Aplikacja również sluży do nasłuchiwania konkretnych zdarzeń w celu wizualizowania stanu poszczególnych urządzeń. Wizualizacja odbywa się za pomocą pythonowego GUI tkinter po wczytaniu danych konfiguracyjnych (przykład)

Stack technologiczny

Python
Tkinter GUI
Mosquitto MQTT Broker

Instrukcja uruchomienia

Na systemie operacyjnym należy mieć zainstalowany python
Pobrać mosquitto mqtt broker i uruchomić broker na porcie 1883 (domyślny) Instukacja
Następnie wykonać serie poleceń

git clone https://github.com/nazkord/IntelligentHome.git
cd IntelligentHome-master
pip install -r requirements.txt
python main.py

Konfiguracja

Cała konfiguracja aplikacji jest wczytywana z pliku config.json

Przykładowa konfiguracja pokoju

{
    "name": "bedroom",
    "lighting": [
      {
        "name": "main",
        "colors": [
          "daylight",
          "blue",
          "cyan"
        ]
      },
      {
        "name": "wardrobe",
        "colors": [
          "daylight",
          "red",
          "yellow"
        ]
      },
      {
        "name": "bed",
        "colors": [
          "daylight",
          "pink",
          "yellow",
          "magenta",
          "green",
          "red",
          "cyan"
        ]
      }
    ]
}

"name" – nazwa pokoju
"lighting" – tablica oświetlenia w pokoju

Przykładowa konfiguracja lampy

{
    "name": "main",
    "colors": [
      "daylight",
      "blue",
      "cyan"
    ]
}

"name" – nazwa oświetlenia/lampy
"colors" – tablica możliwych oświetlanych kolorów

Interfejs

Widok głównego ekranu aplikacji

U góry znajduję się menubar z którego wybiera się konkretny pokój. Po wybraniu konkretnego pokoju wyświetlana jest lista świateł.

Także z poziomu każdego pokoju/ekranu można wyjść z aplikacji korzystając z przycisku exit
Każde światło domyślnie jest wyłaczone, więc najpierw należy go włączyć

Po włączeniu światła wyświetlane są wszystkie jego parametry, które można z łatwością zmieniać klikając przycisk change

Zmienione parametry

Działanie aplikacji

Po każdym wciśnięciu przycisku change wysyłany jest za pomocą Publisher'a komunikat z odpowiednim tematem do brokera MQTT.
W osobnym wątku uruchomiony jest Subscriber, który nasłuchuje zdarzenia wysyłane z urzadzeń, dzięki czemu wizualizacja pilota jest zawsze aktualna.

Testowanie

Aby samemu przetestować działanie aplikacji, należy za pomocą wiersza poleceń wysłać przykładowe komunikaty do brokera MQTT. Przykłady komunikat:

Temat: room/<room_name>/light/<light_name>/<parameter_to_change>
Treść: <new value of parameter>
Wysyłanie komunikatu odbywa się za pomocą mosquitto_pub
Przykładowe wysyłanie komunikatu:
mosquitto_pub -t room/bathroom/light/main/power -m ON Przykład działania:
Uruchomione komendy oraz logi z subscriber'a

Zaktualizowany widok pilota

Rozwijanie aplikacji

Aplikacja jest otwarta na kolejne rozszerzenia, dzięki temu, że przy jej tworzeniu, użyłem dużo klas, które pozwalają w łatwy sposób rozszerzyć aplikacje o nowe urządzenia. Aby wprowadzić kolejne urządzenia w pokojach (drzwi, okna) wystarczy wykonać następujące kroki:

Dodać nowe urządzenie do pliku konfiguracyjnego JSON
Dodać metodę parsującą te urządzenie do Parser'a
Dodać UI odpowiadający za wyświetlenie oraz zmianę parametrów tego urządzenia
Dodać do Subscriber'a metodę aktualizującą stan urządzenia.

Done by nazkord

nazkord / IntelligentHome