Introduction

This example will go through the entire deployment process using the PLT-DEMO board, test plan, and code. This tutorial assumes you have gone through Getting Started with your First Deployment articles. If you have not, please review them first. Adapt this code as needed to the specifics of your project.  

Requirements

• PLT
• PLTCloud Account
• PLT Demo board
• PLT Demo Files
  • pltdemo-zephyr-fw-0.1.2.hex
  • suite-PLTDEMO-zephyr-0.1.2.yaml
• Amazon AWS Account

Tutorial

Download Example Files

1. Download the .hex and .yaml files from the plt github. 

Create the Demo Project (Reference)

1. Go to Project Menu → Manage Project → Add Project
2. In the Name field, enter "Demo"
   
3. In the Description, field enter "Example Getting Started Project"
4. Click Create

Create Report Repository (Reference)

1. On S3, create a Bucket with the name "plt-demo-reports" and select "us-west-2" for the region.  
2. On PLT Cloud, click the Details icon → Report Connector → Add Destination
3. Enter “plt-demo-reports” in the S3 Bucket Field and “Demo” in the Report Prefix field. 
4. Select .json for the Report Format
5. Click Add
6. On the Report Connector Details page, expand the S3 Bucket Policy section. You will see a .json formatted text like the one below:
   

   1. 1. {
           "Version": "2012-10-17",
           "Id": "",
           "Statement": [
             {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                 "AWS": [
                   "arn:aws:iam::627014326704:role/plt-archiver-production"
                 ]
               },
               "Action": [
                 "s3:PutObject",
                 "s3:GetObject",
                 "s3:ListBucket",
                 "s3:GetObjectACL",
                 "s3:PutObjectACL"
               ],
               "Resource": [
                 "arn:aws:s3:::plt-demo-reports",
                 "arn:aws:s3:::plt-demo-reports/*"
               ]
             }
           ]
         }

7. Copy the json text.
   
8. Log in to S3 if you have not already done so
9. In plt-demo-reports bucket navigate to the Permissions tab
10. Click Edit in and paste the json it the text box
11. Click Save 

Enroll Your PLT

See Add a PLT to PLTcloud for details

Deploy Demo Code

Code deployment consists of adding elements, grouping those files in a release, and deploying to a deployment group

Create a Deployment Group (Reference)

1. 1. On the Deployment Group List page, click Add Deployment Group
   2. In the name field, enter “Demo”
   3. In the Description field, enter “Demo deploy test”

Add Files (Reference)

1. 1. From the PLTcloud Homepage, go to Files → Add File
   2. Click the File icon. Navigate to the “suite-PLTDEMO-zephyr-0.1.2.yaml” file and click Open
   3. Enter “Demo Test Plan” in the Description field
      
   4. Repeat step 1 to add “pltdemo-zephyr-fw-0.1.2.hex” and enter “Demo hex” in the Description field

Create a Release (Reference)

1. 1. From the PLT Cloud Homepage left-hand menu, select Releases → Add Release
   2. In the Version field, enter “0.1” 
   3. In the Description field, enter “Demo Release”
   4. Click the “suite-PLTDEMO-zephyr-0.1.2.yaml” and “pltdemo-zephyr-fw-0.1.2.hex” checkboxes to include them in the release

Deploy Code (Reference)

1. 1. On the Release List page, click the Deploy button
   2. In the Version list, select 0.1  
   3. In the Deployment Group List, select Demo
   4. Click Select
   5. Click Deploy

Download Test Suite to the PLT (Reference)

1. 1. In the PLT, Navigate to Main Menu → Check for Updates
   2. Press the Enter key to install the Demo Release 
   3. The PLT will restart and display “Demo Test Plan” on the screen

Run Test Plan (Reference)

1. 1. Connect the PLT_DEMO hardware to the SWD port using the tag connect cable
   2. Press Run on the PLT screen
   3. The test plan will run and display “PASSED” upon completion. 

View Report (Reference)

1. 1. In PLTcloud select Reports from the left-hand menu. 
   2. You will see the report of the test you just ran marked as “PLT Demo Test Plan'' under Test Plan Title. Select the Details icon on the left-hand side of the row. 
   3. The full report will open, and you will see the results of each step and their timestamps.