Skip to main content

Installing UAC Software

UAC Setup Guide​

This document contains instructions on how to install and setup RIWA2-RT provided all of the OS and hardware requirements are met according to the specifications provided.

Operating System Requirements​

  • OS: Ubuntu 22.04.5 LTS (64-bit).
  • Kernel: Must be running Linux kernel version between 6.5.0-15-generic and 6.8.0-52-generic.
  • Architecture: x86_64 (Intel/AMD systems only).
note

If your current kernel version is outside the supported range, refer to the Kernel Rollback Guide for detailed instructions.

Installing the RIWA UAC​

Locating Your RIWA UAC Download​

Before starting with the installation, you should have received an executable named

riwa-installer_obara_v{version_number}_linux_amd64
note

{version_number} is a placeholder and thus the file you received will not actually appear as riwa-installer_obara_v{version_number}_linux_amd64 but something similar to riwa-installer_obara_v1.0.0_linux_amd64

After confirming this file has been downloaded, on your Ubuntu desktop to access your Downloads folder, you will need to start by pressing the file button on your task bar.

desktop

Once inside your Home directory folder, you can click on the Downloads button on the vertical tab bar to direct yourself to the Downloads folder.

downloads

Now inside of your Downloads directory, you should see your downloaded copy of the RIWA UAC Software

uac_folder

To start the installation of your RIWA UAC Software, right-click anywhere inside of the folder and press Open in Terminal

uac_download

Setting Up UAC Install​

From here, you may be required to turn the file into a proper executable to install the RIWA UAC Software. To ensure the RIWA UAC file you downloaded is a proper executable, run the following command in your terminal:

sudo chmod +x ./riwa-installer_obara_v{version_number}_linux_amd64

chmod_uac

After ensuring your RIWA UAC Software is a proper executable, you can install your UAC by running the following command in the terminal:

./riwa-installer_obara_v{version_number}_linux_amd64

or

./riwa-installer_obara_v{version_number}_linux_amd64 install

uac_install

After starting the installation for your RIWA UAC, you will be asked to enter some information regarding the installation of the software. You will be asked to enter the following information:

  • UAC Serial Port
  • USBoard MAC Address
  • Start services after installation [defaulted to yes]
  • Start services automatically on boot [defaulted to yes]
note

both the UAC Serial Port and USBoard MAC Address can be configured after the installation by running the command configuration_manager in a terminal and locating either obara_config.json or usboard_config.json.

uac_installer

Once you have finished configuring your RIWA UAC installation, you should see a message similar to the one shown in the image below. This message confirms that the RIWA UAC installation completed successfully.

uac_success

Launching the RIWA UAC​

To launch the RIWA UAC, start by right-clicking on the desktop and pressing the Open in Terminal button which will open a new terminal window.

open_terminal

Now inside of the terminal, to start the RIWA UAC software, run the following command in the terminal:

riwa start

uac_start

After the application has started, you should see a message in the terminal similar to the one shown below.

uac_launched

Once you have ensured the RIWA UAC is launched, you can begin to open up the Live Monitor. To start, click the grid button on the task bar labeled Show Applications.

show_applications

Once inside your applications, you will need to find the application named RIWA2 Live Monitor. Double click on the application to launch it.

live_monitor

Once the Live Monitor launches, ensure that the Analyzer Connection, Board Connection, Signal Strength, and Controller Connection are all live to signal that your application is live and running. Once this is confirmed, you can begin to use the application.

live_monitor_launched

Viewing Logs​

To view detailed logs generated by the RIWA UAC for debugging purposes:

  1. Open up the Files application.
  2. Navigate to your Home directory by clicking the option on the side bar.
  3. On your keyboard, press Ctrl+h to show hidden files and folders in the directory (ensure you can see files / folders starting with .).
  4. Start by double clicking the folder called .local to enter its directory.
  5. From here, follow this file path: /.local/tessonics/riwa2/logs.
  6. Inside of the logs directory, you will be able to view all logs generated by the RIWA UAC application.
tip

Sort files by last modified to quickly locate the most recent logs.

You can also view logs live by running the following command in a terminal window:

riwa

This will present you with the RIWA UAC CLI tool which will provide the logs above in real time. For further documentation on the RIWA UAC CLI, refer to the embedded documentation.

Updating and Uninstalling​

To apply updates or reinstall a newer version of the software, follow the following instructions:

Update RIWA UAC​

Once inside the same directory as your new RIWA UAC version, open a terminal and run the following command and follow the provided instructions:

riwa-installer_obara_v{version_number}_linux_amd64 update

Uninstall RIWA UAC​

To uninstall the RIWA UAC, inside of a terminal run the following command and follow the provided instructions:

riwa uninstall
important

For futher documentation on using the RIWA UAC, please refer to the UAC Auto Launch, Disk Monitor, and CLI Tool documentation and filter by the version you are using.