- Setting up your host PC
- Installing the platform
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.
- Gigabit ethernet port
- USB 3.0 ports (x2)
- USB 2.0 ports (x2)
- HDMI output port
- 40-pin expansion header
- microSD card slot for main storage
The following items included with your Vizi-Ai:
- Vizi-Ai device
- European or American power adapter
- micro-SD card (this can be in a case or within your Vizi-AI already)
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 install a pre-requisite 3rd party program.
Installing 3rd Party Applications
- Virtualbox (Guide to installing VirtualBox for Mac)
You should have received a pre-installed version of the Vizi-AI platform on a micro- 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 a awesome user experience when provisioning and using your Vizi-AI.
ADLINK Edge Profile Builder
You will need to download the Edge Profile Builder virtual machine 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, please note the download is 2.5GB download time will depend on your internet connection.
You Mac may require you to Allow the connection to goto50.ai if you have never downloaded any of our software previously.
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:
- The supplied Micro-SD card must be inserted as shown below if not already inserted.
- 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
- Insert the microSD memory card into the microSD memory card slot, it may already have been inserted during the manufacturing process.
- The network cable should be inserted into the socket marked LAN0. Please note that the socket marked LAN1 is disabled.
- 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.
Setting up your ADLINK Profile Builder
In a previous step you downloaded the Profile Builder software now we are going to configure it for first use.
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, please not if you have Paralells installed you will need to right click on the image and select to open with VirtualBox.
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, select the Network tab we need to do this is due to the robust nature of our datariver networking for the VM we must initialize the network this way.
You will see an “invalid settings detected” notification, at the bottom of the screen, this is intentional as 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.
Select adapter 2, then click Ok.
Next click start to start the VM
Due to changes with Mac security you will need to provide VirtualBox with the correct permission to run a VM. Click Open System Preferences.
Click on the padlock in the bottom left hand corner of your screen to enable changes to be made.
Enter your password and click Unlock.
Next tick the checkbox next to VirtualBox and then click the Red dot to close the system preferences.
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:
- Frame Streamer
- OpenVino inference Engine
- Training Streamer
- Model Manager
- AWS Model Streamer
- Stream Viewer
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 dropdown button next to “Inference Engines (1)” and click Streams
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.
1. If you are having problems viewing the city scene provided by default above. Then we recommend trying a few things:
- Ensure you have a wired ethernet connection to the same switch/router that the Vizi is plugged into and turn off your wifi
- If step 1 does not work ensure that your Vizi and your PC are the only devices connected to that switch or router
- If you are using a VPN you may want to shut it down
Below you can find the download links for each individual app.