Installation

Install openHabian with OpenHab

1. Install latest stable version of openHABian on SD card using instruction https://www.openhab.org/docs/installation/openhabian.html
   1. First boot requires to be connect to internet via cable (preferably) and can take a first long coffee break (~1 hour 15 minutes)
   2. You can watch progress on http://your-ip:81/ page.
   3. Initial login and passwords to operating system are openhabian/openhabian
2. Login to operating system shell as openhabian. Execute sudo openhabian-config to set following configuration:
   1. Set you host name (menu 30 -> 31)
   2. Install Mosquitto (menu 20 -> 23), use blank password for unencrypted communication despite of insisting for prividing password.
3. Change password for openhubian
   1. Type in terminal passwd. provide current password openhabian and change to different one.
4. Open openHAB console on page http://your-ip:8080
   1. Create admin account
   2. Begin setup
   3. Point location or you home
   4. Skip proposed storage Add-ons
   5. Skip install discovered Add-ons, it is safer to install them manually in later phase, one by one.
   6. Install following Add-ons
      1. Astro Binding
      2. MQTT Binding
      3. NTP Binding
      4. HomeKit Integration
      5. TP-Link Smart Home Binding
5. Back to terminal and create pshactor user. This account will be used for PkamSmartHome actor service.
   1. Execute sudo adduser pshactor
   2. Provide additional details if would like to.
   3. Execute sudo usermod -aG sudo pshactor
   4. Exectue sudo usermod -a -G gpio pshactor
   5. Exectue sudo chown root.gpio /dev/mem && sudo chmod g+rw /dev/mem
6. Reboot system sudo reboot

PkamSmartHome Actor installation

1. Login to terminal as pshactor
2. Download project
   1. Add ssh key to GitHab
   2. Download project from git

   git clone git@github.com:piotrkaminski/PkamSmartHome.git
   

3. Initialize PSH Actor environment

   cd ~/PkamSmartHome/psh-actor
   ./install-environment.sh
   

4. Update OpenHab configuration

   cd ~/PkamSmartHome/openhab
   sudo ./install-config.sh
   

5. Install service and set to be automatically started after machine boots

   cd ~/PkamSmartHome/linux-service
   sudo ./install-service.sh
   

6. Service psh-actor is already started. Status can be checked by

   sudo systemctl status psh-actor
   

Add auto-discovered Things

1. Login into admin console http://your-ip:8080
2. Go to Settings -> Things -> Inbox
3. Each auto discovered Thing should be added by
   1. Click on Thing name
   2. Click 'Add as Thing'

Executables Update

PkamSmartHome Actor update

This step is needed when configuration of system is updated via GitHub. Initial installation does not require this step.

1. Update code

   cd ~/PkamSmartHome
   git pull
   sudo systemctl restart psh-actor
   

Reset installation

This step puts all points into standard (initial) mode. Initial installation does not require this step.

Reset all points in PkamSmartHome Actor

cd ~/PkamSmartHome/psh-actor
./reset-all-points.sh