====== Home Assistant ======

{{tag>[homeassistant domotic]}}


  * [[https://home-assistant.io/|home assistant]]
  * [[https://www.raspberrypi.org/|raspberry]]
  * https://github.com/scipioni/home-assistant-example
===== Install =====

  * [[https://github.com/happyleavesaoc/my-home-automation/tree/master/homeassistant|example 1]]
  * pip3 install urllib3==1.20 --upgrade --target ~/.homeassistant/deps/  (telegram notify solved)

==== upgrade ====

<code bash>
pip install -U homeassistant
</code>

and after restart home assistant

==== with fabric ====

  * https://github.com/home-assistant/fabric-home-assistant

==== hass ====

<code bash>
sudo apt install python3 python3-venv incron mc python3-dev libffi-dev libssl-dev
python3 -m venv ~/venv
. ~/venv/bin/activate
echo "source ~/venv/bin/activate" >> ~/.bashrc
pip install -U pip wheel
pip install homeassistant
</code>

service 
<file txt /etc/systemd/system/hass.service>
[Unit]
Description=homeassistant
After=network.target

[Service]
Type=simple
User=pi
ExecStart=/home/pi/venv/bin/hass -c "/home/pi"

[Install]
WantedBy=multi-user.target
</file>

enable service
<code bash>
systemctl daemon-reload
systemctl enable hass
</code>


configuration example
<code bash>
sudo apt install git mc
git clone https://github.com/scipioni/home-assistant-example.git home-assistant-scipio
</code>


==== z-wave ====

Installazione ZWave su raspberry pi

<code>

opzionale, rimuovere docker se si hanno installazioni vecchie:
sudo apt-get purge -y docker-engine docker docker.io docker-ce docker-ce-cli
sudo apt-get autoremove -y --purge docker-engine docker docker.io docker-ce  


sudo apt update
sudo apt install raspberrypi-kernel raspberrypi-kernel-headers
sudo apt install ca-certificates curl gnupg lsb-release

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
(se ci sono errori dpkg, riprovare dopo un reboot)

sudo systemctl enable docker
sudo systemctl start docker

ls /dev/serial/by-id/
copiare il nome della chiavetta usb (es usb-0658_0200-if00)

mkdir zwave
cd zwave
wget https://raw.githubusercontent.com/zwave-js/zwavejs2mqtt/master/docker/docker-compose.yml
nano docker-compose.yml
incollare il nome della chiavetta al posto di "insert_stick_reference_here"
salvare

sudo docker compose up -d
</code>

Visitare http://ip-raspberry:8091

Andare sulle settings dal menu laterale

**Sezione Zwave**

serial port: lasciare /dev/zwave (la mappatura viene fatta dal docker compose)

generare tutte e 4 le chiavi, S2 e S0, premendo sui pulsanti con le frecce circolari

**Sezione general**

enable log

scorrere in basso

abilitare "disable MQTT gateway"

**Sezione Home Assistant**

Abilitare WS server

**Salvare**

Dall'interfaccia di home assistant installare l'integrazione ZwaveJS

Inserire come url:
<code>
ws://localhost:3000
</code>
Ora homeassistant è pronto per cercare nuovi dispositivi zwave, dalla schermata di configurazione dell'integrazione ZwaveJS


==== configurazioni z-wave vecchie ====

TKB Home TZ10.XX / TZ10.36 termostato [[reference|<Product type="0201" id="0501" name="TZ10.XX Wall Thermostat" config="wenzhou/tz10.xml"/>]]

<file txt /etc/udev/rules.d/local.conf>
SUBSYSTEM=="tty", ACTION=="add", ATTRS{idVendor}=="0658", ATTRS{idProduct}=="0200", SYMLINK+="zwave"
</file>

Add to ~/lib/lib/python3.5/site-packages/python_openzwave/ozw_config/manufacturer_specific.xml
near <Manufacturer id="0118" name="Wenzhou TKB Control System">
<code>
<Product type="0201" id="0501" name="TZ10.XX Wall Thermostat" config="wenzhou/tz10.xml"/>
</code>

wenzhou/tz10.xml
<code>
<?xml version="1.0" encoding="utf-8"?>
<Product xmlns='http://code.google.com/p/open-zwave/'>
   <!-- COMMAND_CLASS_BASIC does not respond to requests -->
  <CommandClass id="32" action="remove" />
  <!-- This thermostat's setpoint descriptions are 0 based -->
  <CommandClass id="66">
                <Value type="string" genre="user" instance="1" index="0" label="Operating State" units=" mode" value="Idle" />
  </CommandClass>
  <CommandClass id="67" base="0" override_precision="2" />
</Product>
</code>
===== reverse proxy =====

<file txt /etc/nginx/sites-enabled/homeassistant>
server {
    listen 80;
    server_name  "scipio.csgalileo.org";
 
    # create this folder empty
    location /.well-known/acme-challenge {
        root /var/www;
        allow all;
    }
 
    location / {
        return 301 https://$server_name$request_uri;
    }
}

server {
  listen 443 ssl;
  server_name  "scipio.csgalileo.org";
  ssl on;
 
  proxy_buffering off;
  location / {
    proxy_pass http://localhost:8123/;
    proxy_set_header Host $host;
  }
 
  ssl_certificate /etc/ssl/certs/scipio.csgalileo.org.cer;
  ssl_certificate_key /etc/ssl/private/scipio.csgalileo.org.key;
}
</file>

===== MQTT =====

<code>
apt install mosquitto
</code>

<code bash>
mosquitto_passwd /etc/mosquitto/pwfile scipio
</code>


===== zones =====

<code>
mosquitto_passwd /etc/mosquitto/pwfile simo
</code>


~/.homeassistant/known_devices.yaml
<file>
</file>

===== github =====

setup
<code bash>
git config --global push.default simple
git clone https://github.com/scipioni/home-assistant.git
cd home-assistant
git remote add upstream https://github.com/home-assistant/home-assistant.git
git fetch -v

# script/setup
</code>

create a branch with expected work
<code bash>
git branch telegram-webhooks
git checkout telegram-webhooks
git push --set-upstream origin telegram-webhooks
</code>

everyday work on branch
<code bash>
...
git add 
git commit
git push
</code>

rebase before pull request
<code bash>
git fetch upstream dev
git rebase upstream/dev

# in case of conflicts
... edit conflicts
git add ...
git rebase --continue

# -f is necessary (Git will reject it because there isn't a direct path from the commit on the server to the commit on your branch)
git push -f 
</code>

now in github project "new pull request"

===== github docs =====

<code bash>
git clone https://github.com/scipioni/home-assistant.git
cd home-assistant.github.io.git
git remote add upstream https://github.com/home-assistant/home-assistant.github.io.git
git fetch -v

# script/setup
</code>

create a branch with expected work
<code bash>
git branch telegram-webhooks
git checkout telegram-webhooks
git push --set-upstream origin telegram-webhooks
</code>

ruby
<code bash>
sudo apt install y ruby ruby-dev
sudo gem install bundler
cd home-assistant.github.io.git
bundle
rake generate
</code>

test site
<code bash>
rake preview
</code>

everyday work on branch
<code bash>
...
git add 
git commit
git push
</code>

rebase before pull request
<code bash>
git fetch upstream next
git rebase upstream/next

# in case of conflicts
... edit conflicts
git add ...
git rebase --continue

# -f is necessary (Git will reject it because there isn't a direct path from the commit on the server to the commit on your branch)
git push -f 
</code>

now in github project "new pull request"

===== motion =====

Install latest release from https://github.com/Motion-Project/motion

<file txt /etc/motion/motion.conf>
on_picture_save /usr/bin/motion-homeassistant %f
</file>

<file bash /usr/bin/motion-homeassistant>
#!/bin/sh

F=$1
ln -sf $(basename $F) $(dirname $F)/lastsnap.jpg
</file>

<file yaml config.yaml>
camera:
  - platform: local_file
    name: soggiorno
    file_path: /media/usb0/photo/lastsnap.jpg
</file>

===== sensors =====

  * /dev-service -> zwave -> set_config_parameter

disable LED on fibardo FGMS-001
<code>
{
"node_id": 3,
"parameter": 80,
"value": 0
}
</code>

Foscam IP camera
<code bash>
vlc rtsp://hass:password1@192.168.2.14:554/videoMain
</code>

===== automation =====

create a virtual switch
<file yaml input_boolean.yaml>
motion_detected:
  name: Motion rilevato
  initial: off
  icon: mdi:run
</file>

we can turn on this virtual switch with as web service
<code bash>
curl -X POST -H "x-ha-access: xxx" -H "Content-Type: application/json" -d '{"state": "on"}' \
 http://localhost:8123/api/states/input_boolean.motion_detected
</code>

automation that reset virtual switch after 2 seconds
<file yaml automation/on-motion.yaml>
alias: 'reset motion state'
trigger:
  platform: state
  entity_id: input_boolean.motion_detected
  to: 'on'
action:
  # after two seconds reset motion_detected state
  - delay: '00:00:02'
  - service: input_boolean.turn_off
    data:
      entity_id: input_boolean.motion_detected
</file>

===== camera motion =====

  * https://github.com/hokus15/home-assistant-config

<code bash>
sudo apt install incron
</code>

<code bash>
echo hass > /etc/incron.allow
</code>

as hass user edit incron table '''incrontab -e''' (incrontab -l to see)
<code>
/media/usb0/photo/C1_00626E611E80/snap/ IN_CLOSE_WRITE echo "$$ $@ $# $% $&"
</code>

===== grafana =====

<graphviz dot>
digraph G {

graph [rankdir = "LR" splines="true" remincross="true"];
node [fontsize = "10" shape = "box" style="filled" color=black penwidth=1 fillcolor="/blues6/1:/blues6/4" ranksep=1.5];
edge [weight=1.0  arrowsize=0.5  color="#999999"  fontsize = "10" penwidth=1];

hass -> influxdb -> grafana -> browser


}  

</graphviz>



Add influxdb datasource{{ :projects:internetofthings:datasource-influxdb.png?direct |}}


===== alexa =====

  * https://home-assistant.it/integrare-alexa-in-home-assistant-senza-usare-il-cloud-e-a-costo-zero/

Modificare https://github.com/mike-grant/haaska per il multiclient.

haaska.py gira come servizio sui lambda server amazon. Anziché leggere la configurazione (ad esempio bearer_token) da file,
prevedere una chiamata ad un web service esterno (ad esempio https://ha.csagalileo.org/alexa?client=id_client_alexa) da cui recuprare i dati. Ovviamente va mappato id_client_alexa con albertis

Sniffare i metodi:
  * def get(self, endpoint):
  * def post(self, endpoint, data, wait=False):