piVCCU

Prequisites

• Debian or Ubuntu based distribution
• armhf or arm64 architecture (no x64 at the moment!)
• At least kernel 4.14 (Mainline is prefered)
• HM-MOD-RPI-PCB is supported only on Armbian and on supported hardware platforms

Installation

1. Create full backup of your SD card
2. Add the public key of the repository

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

3. 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.

4. Install the neccessary packages for building kernel modules

   sudo apt install build-essential bison flex libssl-dev
   

5. Install the matching kernel headers, this highly depends on your distribution

6. Install the neccessary kernel modules

   sudo apt install pivccu-modules-dkms
   

7. If you are using a HB-RF-ETH, install the neccessary support package

   sudo apt install hb-rf-eth
   

8. 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 ip link show | cut -d' ' -f2 | cut -d: -f1 | grep -e '^e.*'
     

   • Update your config. (Replace eth0 if necessary)

      sudo apt install bridge-utils
      sudo bash -c 'cat << EOT > /etc/network/interfaces
      source-directory /etc/network/interfaces.d
     
      auto lo
      iface lo inet loopback
        
      iface eth0 inet manual
        
      auto br0
      iface br0 inet dhcp
        bridge_ports eth0
      EOT'
     

   • You can use an static IP address, too. In that case use instead:

      sudo apt install bridge-utils
      sudo bash -c 'cat << EOT > /etc/network/interfaces
      source-directory /etc/network/interfaces.d
     
      auto lo
      iface lo inet loopback
        
      iface eth0 inet manual
        
      auto br0
      iface br0 inet static
        bridge_ports eth0
        address <address>
        netmask <netmask>
        gateway <gateway>
        dns-nameservers <dns1> <dns2>
      EOT'
     

   • To use Wireless LAN, please take a look here
9. Reboot the system

   sudo reboot
   

10. Install CCU container

    sudo apt install pivccu3
    

11. 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.