• CUWB v5.0
Software Packages

Download and Install Using PPA

The CUWB Software Suite is available for installation through a Personal Package Archive (PPA) in Linux. To download and install the latest CUWB Software follow the instructions below.

  1. Follow best practices and review the install.sh script.
  2. bash <(wget -qO- https://cuwb.io/docs/v5.0/assets/install.sh)
  3. Paste into an Ubuntu 22.04/24.04 terminal and press Enter

Download Debian Packages

Direct Download

Click the download link below to download the desired package.

Version Name OS SHA256
1.4.0 cdp-logger Ubuntu 22.04+
6.1.0-cuwb5.0 cuwb-firmware-an302 Ubuntu 22.04+
6.1.0-cuwb5.0 cuwb-firmware-pt301 Ubuntu 22.04+
5.0.0-cuwb5.0 cuwb-manager1 Ubuntu 22.04
5.0.0-cuwb5.0 cuwb-manager1 Ubuntu 24.04
1.17.1 cuwb-migrate Ubuntu 22.04
1.17.1 cuwb-migrate Ubuntu 24.04
1.2.0 cuwb-usb-interface Ubuntu 22.04+
2.1.1 cuwb-viewer Ubuntu 22.04+

1. Requires cuwb-migrate

File SHA256 values are provided for users to check file integrity. To calculate the file SHA in linux use the following terminal command (where [FileName] should be replaced with the name of the downloaded file):

sha256sum [FileName]

PPA Download

The latest DEB packages can be downloaded from the PPA for installation off-line. Type the commands below into a terminal window to gather the appropriate packages for installation.

jammy below can be replaced with any compatible Linux OS version. See the downloads table above for the most up to date supported OS options.

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 13FB78B5
sudo add-apt-repository 'deb [arch=amd64] https://ppa.cuwb.io/official/ jammy main'
sudo apt update
mkdir /tmp/cuwb-packages
sudo apt -d -o Dir::Cache::Archives=/tmp/cuwb-packages install cuwb-all

The above commands gather the DEB packages needed to install all cuwb software. Users may change cuwb-all in the code above to any of the available packages to gather installation data for just that package. For example, to install the CUWB Viewer, the user would change cuwb-all in the code above to cuwb-viewer.

The instructions above gather all CUWB packages as well as software packages external to the CUWB system. It will not include packages that are already installed on the original Linux PC. To ensure proper operation it is suggested that the source and target PC be identical in regard to the packages currently installed.

Offline Installation Guide

The CUWB Software Suite can also be installed on a computer without internet connection by preparing the packages on a different machine with internet connection in advance.

Linux Overview

For users unfamiliar with Linux systems it is encouraged to spend some time familiarizing yourself with the environment before installing the CUWB Software. The following is a list of topics that will be used in standard usage of the CUWB System.

  • File navigation via the Command Line
  • APT Package Manager
  • Net Tools

Prepare Packages

Download the packages from the Current Downloads Available section and place them onto a USB drive or other transfer method. Transfer the files to the desired Linux PC.

Additionally there are some prerequisite packages that are not installed in a default Ubuntu install. Use dpkg -l | grep <package_name> on the Host PC for the following packages to check if they are installed. If not, obtain the respective DEB package and store it with all the downloaded CUWB Packages.

  • libc6 (Ensure the version is 2.23 or higher)
  • libqt5core5
  • libqt5network5
  • net-tools
  • python3-setuptools
  • redis-server
  • supervisor

CUWB Viewer Prerequisites

In addition to the list above the following prerequisites are also required for the installation of the CUWB Viewer

  • liblttng-ust1
  • liblttng-ust-common1
  • liblttng-ust-ctl5
  • dotnet-host-8.0
  • dotnet-hostfxr-8.0
  • dotnet-runtime-8.0

(Optional) Zip Packages for transfer

Once the packages have been gathered run the following commands in a terminal window to combine the output into a single, easy to manage, file.

tar -cvzf cuwb-packages.tar.gz cuwb-packages

The result is a single file cuwb-package.tar.gz that can be moved between machines for installation. After transferring the file to the desired Linux PC run the following commands from a terminal window to unzip the file.

tar -xvzf cuwb-packages.tar.gz
cd cuwb-packages

Package Installation

After transferring the packages, navigate to the directory the packages are stored in and type the following command into a terminal window to install the packages.

sudo apt install ./<package_name>.deb //Repeat this step for each downloaded package

If using individual debian packages, CUWB Migrate DEB must be installed prior to CUWB Manager DEB.

On Ubuntu 24.04 users may see the following message upon installation: “Download is performed unsandboxed as root as file ‘/home/ciholas/Downloads/cuwb-packages/cuwb-manager_5.0.0+noble_amd64.deb’ couldn’t be accessed by user ‘_apt’. - pkgAcquire::Run (13: Permission denied).” This is an expected message when installing in Ubuntu 24.04 and is not an error.

CUWB Manager Installation

The CUWB Manager package installation will launch an installation GUI from the terminal it is being installed in. For information about those options see the CUWB Manager Manual

CUWB Firmware Installation

The CUWB Firmware package installation will place the CIF file for the associated device(s) at /usr/lib/cuwb/device-images/. After confirming the file is present in that location, the associated device(s) can now be bootloaded.

Package Update

To update a deb package follow the Package Installation step again with the new version of the package. APT automatically handles uninstalling the old version of the package.

Package Removal

To view the names of all the CUWB Packages installed on a machine use the following terminal commands:

dpkg -l | grep cuwb
dpkg -l | grep cdp-logger

To remove a package you can use either of the following commands:

sudo apt remove <package_name>

OR

sudo dpkg -r <package_name>

GitHub Projects

Please visit the Ciholas GitHub site for example software and tool downloads. The following are a few of the available projects on GitHub:

Project Link Description
cdp-py Python Library for encoding/decoding Ciholas Data Protocol
cuwb-monitor Python program for processing and displaying CDP packets in real time
cdp-examples Basic examples of how to process Ciholas Data Protocol in various languages

APPENDIX A : License Terms and Conditions