4. Installation

4.1. Installing from Repository

If you are using Debian, Raspbian, or Ubuntu, you can install the HomeMatic BidCoS module from the repository. Please run the following command as root:

apt-get install homegear-homematicbidcos

4.2. Manually Install Debian/Raspbian/Ubuntu Package

Download the HomeMatic BidCoS package (homegear-homematicbidcos) from the Homegear nightly download page or the APT repository. Then install the package as root using dpkg:

dpkg -i homegear-homematicbidcos_*.deb
apt-get -f install

The command apt-get -f install installs any missing dependencies.

4.3. Compiling from Source

4.3.1. Compiling Current GitHub Source Using Docker Image

See the Homegear documentation.

4.3.2. Manually Compiling Homegear-HomeMaticBidCoS

4.3.2.1. Prerequisites

First install all dependencies:

Homegear

Libgpg-error devel

GnuTLS devel

Libgcrypt devel

4.3.2.1.1. Debian/Raspbian/Ubuntu

Run the following on Debian, Raspbian, or Ubuntu:

apt-get install libgpg-error-dev libgnutls28-dev (libgcrypt11-dev or libgcrypt20-dev)

4.3.2.1.2. openSUSE Leap

On openSUSE Leap, run the following:

zypper install libtool libgnutls-devel libgpg-error-devel libgcrypt-devel

4.3.2.2. Compiling

Next, you need to download Homegear-HomeMaticBidCoS and extract it:

wget https://github.com/Homegear/HomeGear-HomeMaticBidCoS/archive/master.zip
unzip master.zip
rm master.zip

Change into the extracted directory and run makeRelease.sh or makeDebug.sh. You can pass the number of build threads to the script to speed up the compilation process:

cd Homegear-HomeMaticBidCoS-master
./makeRelease.sh 4

4.3.2.3. Configuration

4.3.2.3.1. Installing Configuration Files

Install the default configuration file:

cp -R misc/Config\ Directory/homematicbidcos.conf /etc/homegear/families

Install the device description files:

mkdir /etc/homegear/devices/0
cp misc/Device\ Description\ Files/* /etc/homegear/devices/0

Install the firmware update download script and execute it:

mkdir -p /usr/share/homegear/firmware
cp Data\ Directory/firmware/* /usr/share/homegear/firmware
chmod +x /usr/share/homegear/firmware/GetFirmwareUpdatesHomeMaticBidCoS.sh
/usr/share/homegear/firmware/GetFirmwareUpdatesHomeMaticBidCoS.sh

4.3.2.3.2. Communication Modules

See Communication Modules for instructions on how to configure communication modules.

4.3.2.4. First Start

Now you need to restart Homegear. On Debian, Raspbian, or Ubuntu, you do this with:

service homegear restart

And watch the log file with the following command to make sure that everything is working properly:

tail -n 1000 -f /var/log/homegear/homegear.log