Getting started with Vizi-AI on Windows

Reading Time: 11 minutes

Head of Engineering and Architecture for ADLINK Technology

Introduction

The ADLINK Vizi-AI is a small AI computer for developers, designed to get you started with AI and Vision. After following along with this brief guide, you’ll be ready to start using our solutions.

  1. Gigabit ethernet port
  2. USB 3.0 ports (x2)
  3. USB 2.0 ports (x2)
  4. HDMI output port
  5. 40-pin expansion header
  6. microSD card slot for main storage

Box contents

The following items included with your Vizi-Ai:

Please note that you can also source your own power supply if required. Other regions, such as the UK, will require an adapter to plug in the provided power supply.

Setting up your host PC

To setup your home PC to take advantage of the amazing User Experience and tools that ADLINK provide out of the box you will need to ensure that your host PC is setup correctly.

To do this you must:

  1. Ensure that you have Virtualization enabled in your BIOS (Guide to enable Virtualization)
  2. Disable Hyper-V from your Windows Environment (Guide to disabling Hyper-V)

Once you have ensured that you have your Windows host configured as above there are some pre-requisites to download and install before we can start to install and configure the ADLINK software.

Installing 3rd Party Applications

  1. Virtualbox (Guide to installing VirtualBox)
  2. Balena Etcher (Guide to installing Balena Etcher)

Vizi-AI Software

You should have received a pre-installed version of the Vizi-AI platform on an SD card purchased with your Vizi-AI, however if you wish to download and reinstall or upgrade the Vizi-AI then the instructions can be found here (Guide to re-install or upgrade your Vizi-AI)

Vizi-AI utilizes the power of ADLINK Edge’s Profile Builder tool to ensure you have an awesome user experience when provisioning and using your Vizi-AI.

You will need to download the Edge Profile Builder image from here (https://vizi-ai-ppa.s3.eu-west-2.amazonaws.com/Win-mac/ADLINK-Edge-Profile-Builder.ova) to use your Vizi-AI

Installing the platform

The following steps are required to install the Platform on the Vizi-Ai device:

Physical Setup of your Vizi-AI

The following image shows how to connect your Vizi-Ai device:

PLEASE NOTE: THE FOLLOWING ACTIONS MUST BE PERFORMED BEFORE THE DEVICE IS POWERED ON:

  1. The supplied Micro-SD card must be inserted as shown below.
  2. The network cable must be inserted and connected directly to your router or switch.
    Please note most commercially available network booster devices will not work with your Vizi-AI.

Vizi-AI physical setup

Connect your device in the following order

  1. Insert the microSD memory card into the microSD memory card slot.
  2. The network cable should be inserted into the socket marked LAN0. Please note that the socket marked LAN1 is disabled.
  3. Connect the included power supply to the power socket on the Vizi-AI.

Powering on your Vizi-AI

The Vizi-Ai device will now power-on, displaying a red and green light, as well as starting up the internal fan.

The fully automatic installation process will now begin. When it has finished the Vizi-AI will reboot itself, and is then ready for use.

If you have a display connected you will also see the Debian login prompt on the device.

When using a Sandisk SDSQXA1-128G-GN6MA microSD memory card, it takes around 2 minutes before the device is discoverable after initial power on.

Slower cards may take significantly longer the reason for this is the Vizi-AI platform was packaged to be able to utilise a variety of different size microSD cards, minimum being the 32GB card supplied, to make use of all the space available during the first power up the software unpacks and fills the entirety of the microSD card ensuring it is available to you if you require the storage space in the future.

If you wish to connect a keyboard and monitor to login to the Vizi-AI device then the initial password for the “root” user on the Vizi-AI is “root”. You may wish to change this by logging in and using the “passwd” command.

The Vizi-AI includes an SSH server, but this is not enabled by default. If you wish to use the SSH server you will need to configure it and enable it.

In a previous step you downloaded the Profile Builder software now we are going to configure it for first use.

The guide below will comprehensively show you how to set everything up and ensure it is configured perfectly.

The ADLINK Edge Profile Builder is supplied to you as a virtual machine presented as an .ova file, this file should be located within your downloads area.

Navigate to your downloads are and find the file called “ADLINK-Edge-Profile-Builder.ova” double click on this file and it will launch the VirtualBox application for installation.

When VirtualBox loads after you have double clicked on the downloaded software, it will automatically open the import utility. We have provided you with all of the out of the box settings you will require, simply click Import to start the process.

A progress bar will show you the current status of the import and provide you with an estimate for completion.

Before starting the VM for the first time you must open the settings area.

Once the settings area is open, simply select the Network tab and then click ok, this is due to the robust nature of our datariver networking for the VM we must initialise the network this way.

You will see an “invalid settings detected” notification, highlighted below in green, this is because we have limited the amount of Video memory the VM has been given.

We do not use the VM UI at all so this is not required to be any higher.

Now we can start the VM, there are multiple ways to run the VM for example “headless state” which runs everything in the background, alternatively you can simply click start.

You will see the VM start up and go through a normal boot of a Debian installed operating system.

Once you see the below on the screen you know the VM is up and running and you can now access profile builder.

To access profile builder, open your web browser and navigate to http://localhost:8082 this will open profile builder for your first-time use.

If this is your first time using Edge Profile Builder you will be presented with several licenses that you must accept to use it.


Once you have accepted the relevant licenses to use profile builder you will be presented with a getting started guide explaining the steps to get Profile Builder configured correctly.

If you desire to use the Azure IoT device management connection service then please configure this, but for now simply click Skip this step.

You will then be presented with the Profile Builder dashboard.

Azure IoT Hub

If you want to setup and use an Azure IoT Hub with Profile Builder to deploy the Vizi-AI apps instructions can be found here (Guide to Setting up an Azure IoT Hub to use with Profile Builder)

Install the starter kit on the Vizi-AI

The ADLINK Edge Profile Builder Devices page allows you to discover and register devices with your connected device management services.

Your Vizi-Ai device can be registered with our starter-kit template profile. This profile contains all of the essential applications to get you up and running with Vizi-Ai.

To begin registering your device, open the Devices page and select the three dots (…) on the right of the device, then choose the option to Register device.

If your device does not display in the list of unregistered devices, verify that your Vizi-Ai device and the device you are using to access the ADLINK Edge Profile builder are on the same network i.e. both plugged into your switch or router.

Try pinging the target from the host, and the host from the target. Please note that devices may not appear if you are using a VPN, or your router does not support multicast.

To register a new device, you must accept the licenses that ADLINK and 3rd party software vendors request to be accepted before you can use your Vizi-AI.

The Register a device dialog will appear. When registering a new device, you are given a choice between registering the device with Azure IoT Hub or deploying directly to the device across the Data River within your local network.

For this guide we will need to select Local Registration and click Next to continue.

Next you will be required to add a device alias, this is the name you want to call your Vizi-AI within the network. Then click Next to continue.

The next step is to decide whether to use a local profile or a template, as we do not have any local profiles yet please select to use a template and click next.

You will be presented with the vision category of templates, click install to install the vizi-ai-starter-kit template.

The vizi-ai-starter-kit this contains the apps that make up Vizi and includes:

The device is now being registered in your local network.

Once the connection has been successful at this point your Profile and therefore apps will start to be downloaded and deployed to your Vizi-AI.

Depending on your internet speed this can take some time to download and install.

As you can see the device has been registered.

How do I view what I have just done?

We have just deployed the scenario below where we have a frame streamer that is able to be configured to use a webcam (Guide to using a webcam with your Vizi-AI)

However in the template profile we have installed a frame streamer that is streaming a stock video onto the DataRiver.

This is then being consumed by our inferencing Engine to provide object classification (the default model we provide out of the box) to understand what images are being sent onto the data river.

Viewing what is happening on my Vizi-AI

Once you have deployed your profile, and the apps can take 5-10 mins to deploy depending on your internet speed.

Click refresh as shown below in the devices tab.

You will see a logo for Portainer become available next to the name of your Vizi-AI, if you want to use Portainer to manage and see what is happening on your Vizi-AI the instructions to use Portainer are located here (Guide to using Portainer)..

In the latest release of the ADLINK Edge Platform and Profile builder we have provided the ability to see what the status of your apps are, click on your devices name to open the device details.

You will be presented with the Device details for your device showing the Vizi-AI apps and there current status, if you open this screen before the apps have downloaded then you may need to wait a few minutes before clicking Refresh.

Now I will guide you through how to view the inferenced results and frames that have been captured by using ADLINK Stream Viewer which is shown in the diagram above.

View your inferenced results and video

ADLINK’s Stream Viewer app allows a user to take the frames that have been captured and merge them together into an RTSP stream, commercial tools can be used to view this stream however we have incorporated into Edge Profile Builder the ability to view this stream.

To get started navigate to the Vision tab:

Select the ‘Streams’ tab.

Select to view the demoStream which is produced by the Vizi software described above.

You may see a spinning icon for a short amount of time, this is while Profile Builder is connecting to the Stream Viewer app and initiating the process of communication with the Data River, we don’t set the Stream Viewer to do this all of the time to save processing on the Data River.

Once your stream has been detected you will be shown the outputs from what we have just provisioned on your Vizi.

Add a Project to Edit the Profile and App Configuration

To add apps to the profile or configure existing apps you must create a project for the Vizi. Open the ‘Projects’ tab and click ‘Create project’.

Enter a ‘Project title’ and ‘Description’ and click ‘Create’.

The new project appears in the list of projects, now we can add the profile to the project, click ‘Download profile’.

Scroll down the list to locate and select the vizi-ai-starter-kit and click Next.

In the ‘Project’ drop-down choose the Vizi project you created earlier, enter a ‘Group’, if required and click Download.

The download may take some time depending on your internet connection.

When it is complete click ‘Finish’.

To deploy a profile and edit or add an application click on the ‘vizi-ai-start-kit’ profile.

Troubleshooting

1.  If you are having problems viewing the city scene provided by default above. Then we recommend trying a few things:

  1. Ensure you have a wired ethernet connection to the same switch/router that the Vizi is plugged into and turn off your wifi
  2. If step 1 does not work ensure that your Vizi and your PC are the only devices connected to that switch or router
  3. If you are using a VPN you may want to shut it down

Below you can find the download links for each individual app.

ADLINK Frame Streamer User Guide – Download

ADLINK OpenVINO Inference Engine User Guide – Download

ADLINK Model Manager User Guide – Download

ADLINK Training Streamer User Guide – Download

ADLINK AWS Model Streamer User Guide – Download

Stay in touch

Sign up to our email list to be notified of the latest industry news