# V1 Evaluation Kit Demo Set-up

**URL:** <https://forum.altosradar.com/t/v1-evaluation-kit-demo-set-up/27>\
**Category:** Guides\
**Tags:** demo, guide\
**Created:** [May 11, 2024, 4:27am UTC](https://forum.altosradar.com/t/v1-evaluation-kit-demo-set-up/27 "2024-05-11T04:27:41Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![rveres](https://avatars.discourse-cdn.com/v4/letter/r/c68b51/32.png) [@rveres](https://forum.altosradar.com/u/rveres)\
**Post date:** [May 11, 2024, 4:27am UTC](https://forum.altosradar.com/t/v1-evaluation-kit-demo-set-up/27/1 "2024-05-11T04:27:41Z")

</div>

# Introduction

Hello, and welcome to Altos Radar! We’re happy you have chosen to evaluate our product. To make the set-up process smooth, this guide will walk you through the steps.

## Components

First, let’s make sure you have all the required components. Your sample kit should contain the following; if it does not, stop and contact us at [support@altosradar.com](mailto:support@altosradar.com).

1. Altos Radar V1 imaging radar sample
2. Cable harness

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/489f81caf4ac48313fabddb81bbdf2a7d30089c2.jpeg)

You also need an ethernet cable and a power adapter. This depends on your specific use case (standalone, mounted on test vehicle, etc.) and will be communicated to you when you purchase your evaluation kit.

Additionally, you will also need a laptop on which you can install Ubuntu (highly recommended). If you cannot natively install Ubuntu, you can also use a virtual machine (more details provided later).

If your laptop does not have an ethernet port, you will need a USB-A/USB-C adapter.

> [@](#):
>
> ### ⚠ Warning
> 
> Not all USB-A/USB-C adapters will work with the Altos V1 sample, and faulty adapters have been known to cause problems during operation. For a list of functioning and problematic adapters, see this forum post: [forum.altosradar.com/t/known-good-ethernet-to-usb-adapters-for-altos-v1-radar/21](https://forum.altosradar.com/t/known-good-ethernet-to-usb-adapters-for-altos-v1-radar/21).

Now that you have all the components, we will set up the software required for operation.

# Software Setup

In this stage, we will set up the software required.

### Install Ubuntu Natively (Recommended)

Evaluating the Altos V1 radar sample requires Ubuntu 20.04 (Focal Fossa) or higher. We highly recommend installing Ubuntu natively on a dedicated laptop for the demo.

> [@](#):
>
> ### ⚠ Warning
> 
> You must use Ubuntu 20.04 or higher, as it is required for ROS Noetic or ROS2. Operation cannot be guaranteed for other versions.

Please reference the following guide to install Ubuntu natively on your laptop: [phoenixnap.com/kb/install-ubuntu-20-04](https://phoenixnap.com/kb/install-ubuntu-20-04). You can download the AMD64 Ubuntu 20.04 image here: [releases.ubuntu.com/focal](https://releases.ubuntu.com/focal/).

### Install Ubuntu in a Virtual Machine (Alternative, Not Recommended)

If you do not have access to a dedicated laptop on which you can install Ubuntu 20.04, you can also install the operating system in a virtual machine on a Windows host. However, this is discouraged, since correct operation cannot be guaranteed.

> [@](#):
>
> ### ⚠ Warning
> 
> Correct evaluation of the demo using a VM is not ensured and is therefore not recommended. Using a VM is known to cause issues with 3D graphics required for displaying the point cloud. VM operation was tested on a Windows 11 host machine running VMWare Workstation.

VMWare Workstation Player running on a Windows host machine is required. Download and install VMWare Workstation Player: [www.vmware.com/products/workstation-player/workstation-player-evaluation.html](http://www.vmware.com/products/workstation-player/workstation-player-evaluation.html).

Reference the following guide to install Ubuntu 20.04 as a virtual machine: [robodev.blog/ros-installation-part-1-install-ubuntu-2004](https://robodev.blog/ros-installation-part-1-install-ubuntu-2004). You can download the AMD64 Ubuntu 20.04 ISO image here: [releases.ubuntu.com/focal](https://releases.ubuntu.com/focal/).

### Install ROS Noetic as Example

Boot the machine on which you installed Ubuntu 20.04.

Install ROS Noetic on your machine using the following guide: [wiki.ros.org/noetic/Installation/Ubuntu](https://wiki.ros.org/noetic/Installation/Ubuntu).

> [@](#):
>
> ### ⚠ Warning
> 
> Ensure you install the correct ROS version: ROS Noetic.

> [@](#):
>
> ### 🙂 Tip
> 
> If you use ROS2, you can refer to the repository in [GitHub - Altos-Radar/altosRadarRos2: Altos Radar ros2 driver](https://github.com/Altos-Radar/altosRadarRos2)

### Install Demo Software

> [@](#):
>
> ### 🙂 Tip
> 
> For ROS2 user, please build the ROS2 driver above.

Open a terminal prompt and run the following commands:

```auto
mkdir ~/altos
cd ~/altos
git clone https://github.com/Altos-Radar/altosRadarRos.git
cd altosRadarRos
catkin_make

```

> [@](#):
>
> ### ⚠ Warning
> 
> If you use the _ **8m super short range mode** _, please checkout the _ **nearRangeMode** _ branch in the repository before build.

Wait a moment for the demo software to build.

# Hardware Setup

We will now set up the hardware required for the demo.

### Connect Components

First, connect the male power source to the female power port on the harness. Ensure the power source is properly connected. This will depend on your specific use case and power adapter; in the following images, the radar is used in standalone mode with a 12V 3A 5.5x2.1 mm power source. (9-36V and 25+W is needed)

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/d1a216cde39fc013959748458bb4f7da03ae2351.jpeg)

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/a59ffac6dc6a876744c67797151a01f8c62fac1c.jpeg)

Next, connect the ethernet cable to the female adapter on the harness.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/77551cda873dab9d793ea6258a7529074d1617ad.jpeg)

Next, connect the harness to the female port on the back of the V1 sample.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/2183c1d53e2ae478acf944eb488c5dbbfa752f74.jpeg)

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/6c865e3b92dc2b3192aac8f86e2e6c74e01da3c2.jpeg)

Connect the ethernet cable from the V1 sample to your laptop on which you performed the software setup. If using a USB-C/USB-A adapter, please see the warning regarding approved adapters in the “Components” section.

Plug in the power source. The board will now power on, which should take approximately 20 seconds.

> [@](#):
>
> ### ⚠ Warning
> 
> Once the V1 sample powers on and begins normal operation, it will quickly heat up. When handling the board during or after operation, use caution.

# Demo Setup

We will now configure Ubuntu and start the demo application.

> [@](#):
>
> ### ⚠ Warning
> 
> If you are running Ubuntu in a VM, you may need to perform additional configuration. Please see the following forum post for details: [forum.altosradar.com/t/running-evaluation-kit-demo-application-on-a-virtual-machine/25](https://forum.altosradar.com/t/running-evaluation-kit-demo-application-on-a-virtual-machine/25).

## Configure Network

Your board should be powered on and connected via ethernet (using an approved adapter if necessary) to the laptop on which you prepared the necessary software.

Open Settings in Linux and navigate to the Network tab.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/afe258ec2d51333f682abd527e8fd7f96e191c19.png)

If your machine has a separate network card, you will see multiple devices as in the screenshot above. Find the device that corresponds to the ethernet connection to the V1 sample. In the above image, a USB-C adapter was used, so the device appears as “USB Ethernet.”

Click the gear icon next to the network device corresponding to the ethernet connection to the V1 sample. Navigate to the IPv4 tab. Under the IPv4 Method section, select Manual. Under the Addresses section, add a new entry with the following values:

```auto
Address: 192.168.3.1
Netmask: 255.255.255.0

```

Leave the Gateway field empty. The window should now appear like this.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/c7548f144a066508eab657d5710397755b733f42.png)

Apply the changes.

## Configure Radar

Before starting the demo, some basic calibration information, such as the height of the radar, must be entered. The “z” information output from the radar is correct only when the height of the radar is entered properly.

The Altos V1 sample has an embedded web server to make this calibration simple.

First, open a web browser (Firefox) and navigate to the following address:

```auto
192.168.3.10

```

You should see a page such as the following.

> [@](#):
>
> ### ⚠ Warning
> 
> If you are using V2 sample, please go to [Altos V2 User Guide - Guides - Altos Radar Community](https://forum.altosradar.com/t/altos-v2-user-guide/35) to configure Radar.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/74fc613dd87071e5a67423a3d5387110895c5c18.png)

Your radar should now be mounted or positioned for the demo. Measure the distance from the center of the radar to the ground. Under the “Alg params config” section, enter the measured radar height in the “RadarHeight” flag in **centimeters**.

Press submit to save the configuration changes.

After configuration, restart the sensor by disconnecting and reconnecting power (by removing and re-attaching the cable harness from the female port on the V1 sample).

## Start the Demo

Point the black-facing side of your connected V1 sample at a suitable environment for the demo. Open a terminal window and run the following commands to start the demo application.

```auto
cd ~/altos/altosRadarRos
./start.sh

```

A rviz window and two terminal windows should appear as the demo begins execution. After a few moments, you should see a point cloud as in the image below.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/229b06bac457f211fe42d06b98ece4948f3ba2bc.jpeg)

To stop the demo, enter Ctrl+C in the two terminal windows that spawned. The point cloud display and terminal windows will exit.

If you do not see a point cloud, please verify that your machine is receiving data from the sensor by navigating to the terminal window that lists the received data packets. You should a series of messages such as those shown in the following image.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/54d148e12d119ab1cafea4d91ec873bcb2abbd27.jpeg)

If you instead see the following message, your machine is not receiving data from the sensor.

 ![image](https://canada1.discourse-cdn.com/flex003/uploads/altosradar/original/1X/6da22244192c8a483e70940ca424f86d5831ed4b.jpeg)

Ensure all the connections in the Hardware Setup section were properly made and that the connection between the V1 sample and your machine is secure. You may also try to restart the demo application.

If you are still having issues with the demo, please see the next section, Support.

# Support

If you are still having issues with the demo application or cannot see a point cloud after following the steps above, please make a post under the #Support category on the Altos Radar forums: [forum.altosradar.com/c/support/6](https://forum.altosradar.com/c/support/6).

To ensure we can resolve the problems you are facing efficiently, please give us the complete technical specification of the set-up on which you have configured the demo software to run and any steps required to reproduce it. Additionally, provide any necessary logs that detail the issue.

If you require further assistance, you can contact our team directly by emailing [support@altosradar.com](mailto:support@altosradar.com). We will reply to you as soon as possible.