====== Domoticz ======

===== Instalacja =====

<code bash>
pkg install domoticz
</code>

Uruchamianie:

<file bash /etc/rc.conf>
domoticz_enable="YES"
domoticz_args="-syslog -daemon -wwwbind 0.0.0.0 -sslwww 0
</file>

==== Uprawnienia ====

Domyślny użytkownik to ''domoticz''. Uprawnienia standardowo są wystarczające, jednak w przypadku instalacji dodatkowych pluginów, trzeba dodać kilka lokalizacji do zapisu:

  * jeśli plugin potrzebuje zapisu do swojego katalogu to:
<code bash>
chown domoticz:domoticz /usr/local/domoticz/plugins/nazwa_pluginu
</code>

  * jeśli plugin dodatkowo chce wgrać swoją templatkę do strony WWW to:
<code bash>
chown domoticz:domoticz /usr/local/domoticz/www/templates
</code>

  * jeśli zamierzasz korzystać z automatycznych backupów:
<code bash>
mkdir /usr/local/domoticz/backups
chown domoticz:domoticz /usr/local/domoticz/backups
</code>

==== Reverse proxy ====

Przykładowa konfiguracja dla nginx:

<file bash>
server {
  listen 80;
  server_name domoticz;

  access_log /var/log/nginx/domoticz-access.log;
  error_log /var/log/nginx/domoticz-error.log;

  location / {
    return 301 https://$server_name$request_uri;  # enforce https
  }

  # Let's Encrypt
  location /.well-known {
    root /usr/local/www;
  }
}

##
# Connection header for WebSocket reverse proxy
##
map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

server {
  listen  443 ssl http2;
  server_name domoticz;

  access_log /var/log/nginx/domoticz-access.log;
  error_log /var/log/nginx/domomoticz-error.log;

  ssl_certificate     /usr/local/etc/letsencrypt/live/domoticz-host/fullchain.pem;
  ssl_certificate_key /usr/local/etc/letsencrypt/live/domoticz-host/privkey.pem;

  location / {
    proxy_pass http://127.0.0.1:8080;

    proxy_http_version 1.1;
    proxy_read_timeout 90;

    ### Set headers ###
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Scheme $scheme;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    add_header       X-Frame-Options SAMEORIGIN;
  }
}
</file>
===== Pluginy =====

Standardowo wszystkie pluginy lądują w:
<code>
/usr/local/domoticz/plugins
</code>

Ich instalacja to zwykle pobranie odpowiedniego repozytorium Git oraz umieszczenie go w swoim katalogu w w/w lokalizacji.

==== deCONZ ====

Plugin do komunikacji z bramką ZigBee opartą na oprogramowaniu deCONZ:

<code bash>
cd /usr/local/domoticz
git clone https://github.com/Smanar/Domoticz-deCONZ.git
chown -R domoticz:domoticz /usr/local/domoticz/Domoticz-deCONZ
chown domoticz:domoticz /usr/local/domoticz/www/templates
</code>

==== Midea AC ====

Potrzebne będą dwa repozytoria:

<code bash>
mkdir /root/git
cd /root/git
git clone https://github.com/mac-zhou/midea-msmart.git
git clone https://github.com/hubertverstraete/Qlima.git
cd Qlima; git switch 8370_devices
</code>

Drugie repo to fork z https://github.com/awalsum/Qlima -- autor forka dostował plugin do nowej wersji bibliteki midea-msmart oraz dodał w branchu ''8370_devices'' obsługę protokołu v3.

Dodatkowo zależności bibliotek:
<code bash>
pkg install py38-click py38-pycryptodome py38-requests py38-ifaddr
</code>

Instalacja pluginu:
<code bash>
mkdir /usr/local/domoticz/plugins/Qlima
cd /usr/local/domoticz/plugins/Qlima
cp -Rpn /root/git/midea-msmart/msmart .
cp -Rpn /root/git/Qlima/* .
</code>

===== Personalizacja =====

Dodatkowe ikony do Domoticza: https://drive.google.com/drive/u/0/folders/0B-ZLFoCiqzMRSkFaaWdHV1Qxbm8

Tutorial jak tworzyć ikony: https://gadget-freakz.com/domoticz-icons/