CUWB Viewer Manual Rev 1.1

Description

The Viewer is a 3D visualization of the Ciholas Ultra-Wideband (CUWB) Real Time Location System (RTLS). It provides a user interface displaying the locations of CUWB network devices, such as Anchors and Tags in real time. The Viewer also presents basic system information, such as device status, statistics, sensor plotting, and more.

Installation

PPA Install and Setup

Follow the instructions below for CUWB Viewer installation. When prompted in the ‘CUWB Applications Selection”, ensure that CUWB Viewer is selected for installation.

System Requirements

• OS: Ubuntu 16.04 Xenial or Ubuntu 18.04 Bionic
• CPU: 64-bit dual core or better with SSE2 instruction set support
• GPU: Graphics card with DX10 (shader model 4.0) capabilities
• WAN: Must be able to reach ppa.cuwb.io via port 443
• RAM: 2GB or better
• HD: 200MB or more (plus any additional required by logging)

General System Usage

Launch CUWB Viewer

Once the CUWB Viewer has been installed launch the application through the Linux applications menu, or type the following into a terminal window:

cuwb-viewer

Network Configuration

On the initial run of the Viewer, no configuration file will be loaded. A network selection tool will pop up populated with all available networks the Viewer detects. The network window will also include default network settings properly configured for CUWB Network defaults. To get started select a network from this, and close the dialog.

To return to the network selection dialog select “Edit->Network Selection” from the menu. Users may also add new networks using the “Edit->Network Settings” dialog.

By default, the Viewer will listen on the CUWB Network configuration channel (IP 239.255.76.67, port 7671, interface 0.0.0.0). This allows the system to discover available network. These networks can be selected through the Network Selection dialog.

Default Configuration

To prevent the network selection dialog from appearing when the Viewer application boots, save the network configuration using the “File->Save Configuration” menu item. This will save the network settings to the default configuration.

The default configuration file, “viewer_default.db”, can be found in the [/usr/lib/cuwb/viewer/cuwb-viewer_Data/StreamingAssets/] folder. This file will load on boot and restore all settings that a user has saved for a given CUWB Network setup.

Initial View

After the initial boot animation the user will be presented with a blank screen showing only a 3D 10 meter grid. Upon reception of CDP data from a CUWB Network the grid will grow and form around the representations of the system tags and anchors.

Device Color Table

By default tags are represented as spheres and anchors are cubes. The color of the device is used to indicate the connectivity and synchronization status.

Mouse Controls

Drag View

The system view may be changed via the middle mouse button or mouse wheel. Holding the middle mouse button and dragging the mouse will move the user’s view in the same direction that the mouse is dragged.

Rotate View

To rotate the view, press and hold shift while dragging the mouse with the center button held. When the shift key is pressed, a sphere will appear on the screen that represent the point of rotation. The point of rotation is selected relative to the current cursor location. If no object is underneath the mouse, the rotation point will be located in the center of the visible grid. If the center of the grid is not visible, a point in the center of the screen will be used.

Zoom View

To zoom in and out, scroll the mouse wheel. Zoom direction and speed may be adjusted in the “Edit->User Configs” dialog.

Object selection

The left mouse button serves as the object selector. Selected objects may be configured through the main menu in the “Device Config” dialog, or by pressing ‘C’ once selected. To see current statistics for an object choose the “Device Info” dialog, or press ‘I’ on the keyboard once selected.

Selected Tags and Anchors will appear with a cyan highlight. Imported objects that are selected will appear with a yellow highlight.

Distance Measurement

Distance measurement is done quickly by left clicking on an object and dragging the selection over to another object. The result will be a dark line between the object with a distance measurement displayed in the center.

Keyboard Controls

Camera Shortcuts

General Shortcuts

Object Transform

Note: these transforms only work on selected objects.

Menu Bar Options

The main menu bar has the following submenus:

1. Supports most common image formats: JPG, BMP, PNG, etc.
2. Supports most common 3D object formats: OBJ, FBX, DAE, etc.
3. Menus only visible when an object is selected

Heatmap Mode

Enabling this mode changes the coloring of anchors to reflect their usage in tracking the selected tag. The location algorithm weights data from anchors depending on the quality of the tag beacon reception. Anchor coloring in heatmap mode reflects the relative anchor weighting used by the location algorithm. The table below describes the heatmap color scheme.

Heatmap Color Table

Device Options

The device configuration options supported by the system are as follows:

The above options can be configured by highlighting the device and clicking on the options button. They can be toggled for devices simultaneously in the main menu bar “View” menu.

* This value can only be set via the Device Settings dialog found in View->Device Settings.

CUWB Viewer Manual Manual Change Log

CUWB Viewer Manual Rev 1.1