Instructions to install Domoticz and OpenZWave
This was a fresh install on a new RPi3.
Since I needed OpenZWave, I had to rebuild Domoticz
Installing from Source
Build times reported are when using a Raspberry Pi 3, using "make -j 3"
(Older revisions of the raspberry pi could take up to 10x longer to compile)
You also might need to install GCC 4.6 and compile with this version as 4.9 takes to much memory
Creating a large swap file does not solve the problem, and build with 'make -j 3'
If you are using an old version of the Raspberry Pi, remove the "-j 4" from the make commands!
sudo apt-get install cmake make gcc g++ libssl-dev git curl libcurl4-openssl-dev libusb-dev wiringpi
Now build and install the Boost library.
mkdir boost
cd boost
wget http://sourceforge.net/projects/boost/files/boost/1.60.0/boost_1_60_0.tar.gz/download
tar xvfz download
rm download
cd boost_1_60_0/
./bootstrap.sh
./b2 stage threading=multi link=static --with-thread --with-date_time --with-system --with-atomic --with-regex
sudo ./b2 install threading=multi link=static --with-thread --with-date_time --with-system --with-atomic --with-regex
cd ../../
rm -Rf boost/
Build Support for OpenZWave
If you need support for ZWave, you need to compile open-zwave before compiling domoticz Make sure to follow the below steps, you will end up with a folder layout like:
- open-zwave-read-only
- dev-domoticz
sudo apt-get install libudev-dev
For the first time, you need to clone the code (copy) from GitHub into your system:
git clone https://github.com/OpenZWave/open-zwave open-zwave-read-only
Refresh the source and Build OpenZWave(1m23.057s for initial build (rpi2 3 minutes))
cd open-zwave-read-only
git pull
make -j 3
go back to the top folder (your Home directory):
cd ..
Domoticz Source
For the first time, you need to checkout the source from GitHub onto your system:
git clone https://github.com/domoticz/domoticz.git dev-domoticz
Build Domoticz (21m15.899s on a raspberry pi 3 , 35m0.646s on a raspberry pi 2 for initial build)
If you have updated dev-domoticz, the make step will only re-build those files that have been changed - although if a header-file common to a lot of source files has been changed, this will still take a long time
Note building on pi 3 with image september jessy with gcc 4.9, you need bigger swapspace 512 instead of 100 (see
this or else it will take ages...
cd /etc/dphys-swapfile
CONF_SWAPFILE=512
free -m
Change to the Domoticz directory, and start building
cd dev-domoticz
cmake -DCMAKE_BUILD_TYPE=Release CMakeLists.txt
make
The build failed with "make -j 3", so changed to "make" , and it worked with no errors
took about an hour on my pi3 to build
Make Domoticz startup at boot time (Also needed for Web Update)
cd /dev-domoticz
sudo cp domoticz.sh /etc/init.d
sudo chmod +x /etc/init.d/domoticz.sh
sudo update-rc.d domoticz.sh defaults
Edit the startup script and change the USERNAME, DAEMON and DAEMON_ARGS parameters to reflect your current settings
sudo nano /etc/init.d/domoticz.sh
Make sure the lines look like this:
USERNAME=USER
DAEMON=/home/$USERNAME/dev-domoticz/$NAME
DAEMON_ARGS="-daemon -www 8080"
if you are using the default user name, it should say:
USERNAME=pi
If you want to use another web interface port change:
DAEMON_ARGS="-daemon -www 8080"
Test Domoticz (Important to get the file ownerships right!)
cd ~/dev-domoticz
sudo ./domoticz
Start Domoticz
sudo service domoticz.sh start
Now connect with a browser to see if it is up and running.
You can now start/stop/restart domoticz with:
sudo /etc/init.d/domoticz.sh start to start Domoticz
sudo /etc/init.d/domoticz.sh stop to stop Domoticz
sudo /etc/init.d/domoticz.sh restart to restart Domoticz
sudo /etc/init.d/domoticz.sh status to check the status of Domoticz (running/not running)
Updating Domoticz
Binary install update
Use the Web Interface to update Domoticz (Setup->Check for Updates)
If this fails for any reason (e.g. partial download giving segmentation fault) then you should manually update by:
Stable:
sudo /etc/init.d/domoticz.sh stop
cd ~/dev-domoticz
./updaterelease
Beta:
./updaterelease
./updatebeta
Source Update
Login to your Raspberry Pi with the 'pi' user and issue:
cd domoticz
git pull
make -j 4
Install watchdog
sudo modprobe bcm2708_wdog
echo "bcm2708_wdog" | sudo tee -a /etc/modules
Install the software watchdog daemon
sudo apt-get install watchdog
sudo update-rc.d watchdog defaults
Configure the watchdog daemon
Open /etc/watchdog.conf with your favorite editor (mine is nano).
sudo nano /etc/watchdog.conf
Uncomment the line that starts with #watchdog-device by removing the hash (#) to enable the watchdog daemon to use the watchdog device. Uncomment the line that says #max-load-1 = 24 by removing the hash symbol to reboot the device if the load goes over 24 over 1 minute. A load of 25 of one minute means that you would have needed 25 Raspberry Pis to complete that task in 1 minute. You may tweak this value to your liking.
If you only want to setup the watchdog to restart in case your system hangs, continue to the section Start the watchdog daemon
Use watchdog to check Domoticz
This script relies on the fact that the Domoticz.log is written in /tmp/ newer installs have this option disabled by default. To make this script work you must enable the logfile.
sudo nano /etc/init.d/domoticz.sh
and change the line OPTIONS="-www 8080" to:
OPTIONS="-www 8080 -loglevel=1 -log /tmp/domoticz.log"
(* Alternative ) In my case, the option must be set up like this
DAEMON_ARGS="$DAEMON_ARGS -www 8080 -loglevel=1"
DAEMON_ARGS="$DAEMON_ARGS -sslwww 443"
DAEMON_ARGS="$DAEMON_ARGS -log /tmp/domoticz.log"
Setup mailer:
sudo apt-get install sendmail-bin
sudo apt-get install mutt
If mutt does not install, then try updating your pi first by running:
sudo apt-get update
Then continue to:
cd /home/pi
create the file .muttrc with the following content: (vi .muttrc or nano .muttrc)
# basic .muttrc for use with Gmail
# Change the following six lines to match your Gmail account details
set imap_user = "username@gmail.com"
set imap_pass = ""
set smtp_url = "smtp://username@smtp.gmail.com:587/"
set smtp_pass = ""
set from = "username@gmail.com"
set realname = "Firstname Lastname"
#
# # Change the following line to a different editor you prefer.
set editor = 'vim + -c "set textwidth=72" -c "set wrap"'
# Basic config
set folder = "imaps://imap.gmail.com:993"
set spoolfile = "+INBOX"
set imap_check_subscribed=yes
set hostname = gmail.com
set mail_check = 120
set timeout = 300
set imap_keepalive = 300
set postponed = "+[GMail]/Drafts"
set header_cache=~/.mutt/cache/headers
set message_cachedir=~/.mutt/cache/bodies
set certificate_file=~/.mutt/certificates
set move = no
set include
set sort = 'threads'
set sort_aux = 'reverse-last-date-received'
set auto_tag = yes
set pager_index_lines = 10
ignore "Authentication-Results:"
ignore "DomainKey-Signature:"
ignore "DKIM-Signature:"
hdr_order Date From To Cc
alternative_order text/plain text/html *
auto_view text/html
bind editor <Tab> complete-query
bind editor ^T complete
bind editor <space> noop
# # Gmail-style keyboard shortcuts
macro index,pager am "<enter-command>unset trash\n <delete-message>" "Gmail archive message" # different from Gmail, but wanted to keep "y" to show folders.
macro index,pager d "<enter-command>set trash=\"imaps://imap.googlemail.com/[GMail]/Bin\"\n <delete-message>" "Gmail delete message"
macro index,pager gi "<change-folder>=INBOX<enter>" "Go to inbox"
macro index,pager ga "<change-folder>=[Gmail]/All Mail<enter>" "Go to all mail"
macro index,pager gs "<change-folder>=[Gmail]/Starred<enter>" "Go to starred messages"
macro index,pager gd "<change-folder>=[Gmail]/Drafts<enter>" "Go to drafts"
macro index,pager gl "<change-folder>?" "Go to 'Label'" # will take you to a list of all your Labels (similar to viewing folders).
edit the first lines to setup your gmail account info
Create a mail script in /home/pi:
cd /home/pi/
sudo nano mailIP
Paste the following (repalce YOURMAIL with full email address of where you want the email sent i.e. fred@hotmail.com):
#!/bin/sh
mailreciever=YOURMAIL
today=$(date)
#my_ip=`ifconfig | grep 'inet addr:'| grep -v '127.0.0.1' | cut -d: -f2 | awk '{print $1}'`
my_ip=`wget -q -O - checkip.dyndns.org|sed -e 's/.*Current IP Address: //' -e 's/<.*$//'`
my_pi="Domoticz RaspberryPi has rebooted! "
message="Your Pi has rebooted at $today. Current IP address = $my_ip"
echo $message > message.txt
mutt -s "${my_pi}" ${mailreciever} < message.txt
The commented line fetches the internal ip, example fetches external ip.
Make sure the mailIP can be executed:
sudo chmod +x mailIP
Test the script by running it:
./mailIP
Setup rc.local to send the mail at each reboot: Edit /etc/rc.local:
sudo nano /etc/rc.local
Add this above the exit 0 line:
sudo /home/pi/mailIP &
Make sure the rc.local can be executed:
sudo chmod 0755 /etc/rc.local
sudo bash
cp /home/pi/.muttrc /root
sudo nano /etc/watchdog.conf
Uncomment the lines file and change and set them to:
file = /tmp/domoticz.log
change = 300
This setting will restart the pi when domoticz.log hasn't been updated in 5 minutes, the time is in seconds (tested).
Be sure to remember this when stopping the domoticz service by hand!
and for new system , that do nothing yet, you can prevent unwanted reboot by adding a script like this :
cd /home/pi/domoticz/scripts/lua
nano script_time_domotizAlive.lua
commandArray = {}
print('Domoticz alive !')
return commandArray
Start the watchdog daemon
sudo service watchdog start
