Setting up the AWS Panorama Appliance Developer Kit - AWS Panorama

Setting up the AWS Panorama Appliance Developer Kit

To get started using your AWS Panorama Appliance Developer Kit, register it in the AWS Panorama console and update its software. During the setup process, you create an appliance resource in AWS Panorama that represents the physical appliance, and copy files to the appliance with a USB drive. The appliance uses these certificates and configuration files to connect to the AWS Panorama service. Then you use the AWS Panorama console to update the appliance's software and connect cameras.

Prerequisites

To follow this tutorial, you need an AWS Panorama Appliance Developer Kit and the following hardware:

  • Display – A display with HDMI input for viewing the sample application output

  • USB drive (included) – A FAT32-formatted USB flash memory drive with at least 1 GB of storage, for transferring an archive with configuration files and a certificate to the AWS Panorama Appliance Developer Kit

  • Camera – An IP camera that outputs an RTSP video stream for providing input to the camera. The developer kit can automatically discover streams from cameras that support ONVIF Profile S.

The tutorial uses a sample computer vision model and application code. Download the model and code before you get started.

The AWS Panorama console uses other AWS services to assemble application components, manage permissions, and verify settings. To register a developer kit and deploy the sample application, you need access to the following services:

  • Amazon Simple Storage Service (Amazon S3) – To store model and Lambda function artifacts, and can be used for application output.

  • AWS Lambda – To manage function code, configuration, and versions.

  • AWS Identity and Access Management (IAM) – On first run, to create roles used by the AWS Panorama service, the AWS Panorama console, the AWS Panorama Appliance Developer Kit, AWS IoT Greengrass, SageMaker, and Lambda functions.

If you don't have permission to create roles in IAM, have an administrator open the AWS Panorama console and accept the prompt to create service roles. For the Lambda function's permissions, you can create an execution role with basic permissions ahead of time, in which case you only need permission to pass the role.

Register and configure the developer kit

The AWS Panorama Appliance is a hardware device that connects to network-enabled cameras over a local network connection. It uses a Linux-based operating system that includes the AWS Panorama Application SDK and supporting software for running computer vision applications.

To connect to AWS for appliance management and application deployment, the AWS Panorama Appliance Developer Kit uses device certificates. You use the AWS Panorama console to generate certificates that authenticate the developer kit and authorize it to call AWS API operations.

When you set up the AWS Panorama Appliance Developer Kit, enable SSH to so that you can connect to it for testing and debugging. To enable Wi-Fi, configure an SSID and password during setup. Enabling Wi-Fi does not disable Ethernet, and a wired connection is required to complete setup prior to updating the appliance's software.

To register an AWS Panorama Appliance Developer Kit

  1. Open the AWS Panorama console Getting started page.

  2. Choose Set up appliance.

  3. Follow the instructions to create the appliance resource, configure network access, and download an archive with the device certificate and configuration files.

  4. Copy the configuration archive to the root directory of the USB drive.

  5. Connect the USB drive to the developer kit and turn it on.

  6. The developer kit copies the configuration archive and network configuration file to itself, connects to the network, and connects to the AWS Cloud. To continue, choose Next.

  7. Do not add cameras at this time. Proceed through the remaining steps to complete setup.

Upgrade the developer kit software

The AWS Panorama Appliance Developer Kit has several software components, including a Linux operating system, the AWS Panorama application SDK, and supporting computer vision libraries and frameworks. To ensure that you can use the latest features and applications with your developer kit, upgrade its software after setup and whenever an update is available.

To update the appliance software

  1. Open the AWS Panorama console Appliances page.

  2. Choose an appliance.

  3. Choose Settings

  4. Under System software, choose Install version.

Important

Before you continue, remove the USB drive from the developer kit and format it to delete its contents. The configuration archive contains sensitive data and is not deleted automatically.

The upgrade process can take 30 minutes or more.

Add a camera stream

After the software upgrade completes, add a camera stream.

To add a camera stream to the AWS Panorama Appliance

  1. Open the AWS Panorama console Appliances page.

  2. Choose an appliance.

  3. Choose Inputs.

  4. Choose Add camera.

    
          Add streams to an AWS Panorama appliance on the console.
  5. Choose a connection mode. Try Automatic first. If it doesn't find your camera stream, use Manual.

    • Automatic – The AWS Panorama Appliance discovers cameras on the local network. Choose a camera and then choose a stream to add. If the camera has multiple streams, repeat the process to add additional streams.

    • Manual – Enter the IP address of the camera and the RTSP URL of a stream.

    Both workflows support password-protected cameras.

  6. Choose Confirm.

Next steps

If you encountered errors during setup, see Troubleshooting.

To deploy a sample application, continue to the next topic.