piVCCU

Prequisites

Armbian
At least kernel 4.14 (Mainline is prefered)
The HM-MOD-RPI-PCB and the RPI-RF-MOD are only working on supported platforms

Installation

Create full backup of your SD card

Add the public key of the repository

wget -q -O - https://apt.pivccu.de/piVCCU/public.key | sudo tee /usr/share/keyrings/pivccu.asc

Add the package repository

echo "deb [signed-by=/usr/share/keyrings/pivccu.asc] https://apt.pivccu.de/piVCCU stable main" | sudo tee /etc/apt/sources.list.d/pivccu.list
sudo apt update

Instead of stable you can also use the testing tree, but be aware testing sometimes means not that stable.

Install the matching kernel headers

sudo apt install build-essential bison flex libssl-dev
sudo apt install `dpkg --get-selections | grep 'linux-image-' | grep '\sinstall' | sed -e 's/linux-image-\([a-z0-9-]\+\).*/linux-headers-\1/'`

If you are using a HB-RF-ETH, install the neccessary support package
```
sudo apt install hb-rf-eth
```
Install the neccessary device tree patches (You can skip this step, if you do not use the HM-MOD-RPI-PCB or RPI-RF-MOD on GPIO header, for the HB-RF-USB(-2) and HB-RF-ETH this step is not neccessary)
```
sudo apt install pivccu-devicetree-armbian
```
Install the neccessary kernel modules
```
sudo apt install pivccu-modules-dkms
```
Add network bridge (if you are using wifi please refer to the debian documentation how to configure the network and the bridge)
- Verify, that eth0 is the name of your primary network interface:
```
 sudo nmcli connection show --active
```
- Update your config. (Replace eth0 if necessary)
```
 sudo apt install bridge-utils
 sudo nmcli connection add ifname br0 type bridge con-name br0
 sudo nmcli connection add type bridge-slave ifname eth0 master br0
```
- You can use an static IP address, too:
```
 nmcli connection modify br0 ipv4.addresses "<address>/<prefix>" ipv4.gateway "<gateway>" ipv4.dns "<dns1>,<dns2>" ipv4.method "manual"
```
  Replace <address>, , , , with your settings.
  ist the subnet prefix (e.g. 24 for netmask 255.255.255.0)
Reboot the system
```
sudo reboot
```
Install CCU container
```
sudo apt install pivccu3
```
Start using your new virtualized CCU, you can get the IP of the container using
```
   sudo pivccu-info
```

This site is open source. Improve this page.