Quick Start

This guide will start you on your vision AI journey with the Vision AI DevKit, taking you from setting up your Microsoft Azure account to seeing video output of recognized objects by the DevKit camera. We will use a VisionSample model for this process, which has been trained to recognize up to 183 different objects.

Flow chart of the steps taken for the first use of the Vision AI Dev Kit, covered in the 'What you will do' section of this document

What you will do

  • Connect the Vision AI DevKit camera to Wi-Fi
  • Create necessary Azure IoT resources (Resource Group, IoT Hub, IoT Edge device)
  • Connect the Vision AI DevKit camera to a created IoT Edge Device
  • See video output from the camera to a connected monitor or connected video streaming client

What you will need

Configure your DevKit

Azure account

The Vision AI DevKit is configured to work with Microsoft Azure IoT resources. To get started, you will need a new or existing Azure account. You can create a free account by visiting this link: https://azure.microsoft.com/free.

Setup your DevKit camera

These steps will configure your DevKit camera for Wi-Fi and connect the the camera to the IoT Edge device you created earlier in Azure IoT Hub.

Connect your PC to the camera’s Wi-Fi access point

  • Within 10 seconds of first power up, you should see three flashing RED LED lights. This indicates the device is in Wi-Fi access point mode. If your device is not flashing RED, press the power button for 5 seconds to turn on the DevKit hardware access point.

Guide to DevKit camera LEDs


Device state

LED1

LED2

LED3

Description

Setup

Blink Red

Blink Red

Blink Red

Device is ready for setup.

Connected to WiFi

Blink Green

Blink Green

Blink Green

WiFi connected to internet access/not connected to IoT Hub

Powering ON/OFF

Red

Red

Red

Device is powering on/off and/or performing system restore

IoT Hub Connected

Green

Green

Green

Connected to IoT Hub, downloading manifest/modules, executing modules

Offline

Amber

Amber

Amber

Device is setup but not connected to WiFi. Modules running in Offline mode.

Reboot

Red





Device is rebooting
  • From your PC, connect to a Wi-Fi network named MSIOT_xxxxxx (xxxxxx is the last 6 characters of the device’s Wi-Fi MAC address, e.g. MSIOT_BD097D).

Notes

  • The label at the bottom of the device will have the default Wi-Fi access point password. If there is no label, see Troubleshooting Wi-Fi Issues.
  • If you have connected your device to a display via the HDMI port, the display will show a gray pattern. You will not see any text or images on your display until the IoT Edge runtime has been deployed to the device.

Configure the camera for your Wi-Fi network

  1. Use your computer’s web browser to visit http://setupaicamera.ms. If you do not see the below screen, verify your computer is connected to the Dev Kit hardware’s access point.

    Vision AI Developer Kit starting screen

  2. Tapping Next will open the SSH configuration screen, where you can create a new Wi-Fi access point passphrase for the camera, if desired. All settings can be left at their defaults.

    Vision AI Developer Kit SSH config screen

  3. Tapping Next will open the Wi-Fi settings page, where you will connect your Vision AI DevKit to the Wi-Fi network it will use during normal operation.

    Vision AI Developer Kit Wi-Fi Settings screen

    • Select the Wi-Fi network your camera will connect to from the drop down box, then enter the Wi-Fi passphrase. You will see a confirmation screen when the camera successfully connects to your selected Wi-Fi network.
    • The Wi-Fi passphrase cannot have spaces (even at the end of the passphrase string), or the camera will be unable to connect to the Wi-Fi network.
  4. Tapping Next will take you to the connecting and connected screens.

    Vision AI Developer Kit Wi-Fi Settings screen

    Vision AI Developer Kit Wi-Fi Settings screen

Configure your camera to connect to Azure as an IoT Edge device

Tapping Next starts the process of creating the necessary Azure resources, then connecting the camera to these resources.

  1. You will see the following screen. You should copy the device code for use in the next step.

    Result screen presenting your unique device code for connection to Azure IoT

    Note: If you already have an Azure IoT Edge device connection string associated with the Vision AI Dev Kit, click the `Already have a connection string?’ link and enter that connection string. However, in order to get the full first use experience, the existing connection string must have been used with Vision AI Dev Kit device arlier. A different IoT Edge connection string will not load the default vision sample module to the device.

  2. Tap Next and insert the device code you received in the previous screen.

    Dialog box for inserting the unique device code into

  3. You should reach the following screen when your code is accepted. (Press ‘OK’ to close the pop-up message, if seen.)

    Screen confirming connection to Azure, then allowing selection of your Azure account

    • Use the Switch directory link to choose the GUID of your Azure account.
    • Use the Select your IoT Hub link to choose an existing IoT Hub, or create a new one.
  4. Click Next, then input a name for your DevKit camera in this screen.

    Dialog box for inputing a name for the DevKit camera

    • Click Next and you should see the following screen:

      Screen showing the camera downloading the Azure IoT Edge runtime

    • You will see the following screen showing your DevKit camera is ready to recognize objects.

      Screen confirming camera is setup and providing the RTSP string for viewing camera output over the wire

View DevKit camera output

You can view the DevKit camera output with a web browser, using the URL given on the final device setup page. You can also connect an HDMI montior to the HDMI port on the camera directly or a video playback application (such as VLC Player) that supports RTSP video. Note: If using a cable, there should be no adapters at either end.

For more information on using RTSP streaming, see the topic View RTSP video stream.

Basic setup

After setting up the device, you will have a following setup.

Next steps

In this quick start, you configured the Vision AI DevKit camera to display output for objects recognized by the VisionSample model to a monitor or RTSP capable video player.

From here, your next step is to create and deploy a custom vision ML model using the Azure Custom Vision service.

Create and deploy a vision ML model using the Azure Custom Vision service

Updated: