You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Manually create and deploy an Azure Precept Devkit
2
+
title: How to do a manual default container deployment to Azure Percept DK
3
3
description: this article shows the audience how to manually create and deploy an Azure Precept Devkit
4
4
author: nkhuyent
5
5
ms.author: keithke
@@ -10,71 +10,77 @@ ms.custom: template-how-to
10
10
---
11
11
12
12
13
-
# Manually create and deploy an Azure Precept Devkit
14
-
The following guide is to help customers manually deploy a factory fresh IoT Edge deployment to existing Azure Percept devices. We have also included the steps to manually create your Azure Percept IoT Edge device instance.
13
+
# How to do a manual default container deployment to Azure Percept DK
14
+
15
+
The following guide is to help customers manually deploy a factory fresh IoT Edge deployment to existing Azure Percept devices. We've also included the steps to manually create your Azure Percept IoT Edge device instance.
15
16
16
17
## Prerequisites
17
18
18
-
- Highly recommended: Update your Percept Devkit to the [latest version](./software-releases-usb-cable-updates.md)
19
-
- Azure account with IoT Hub created
19
+
- Highly recommended: Update your Azure Percept DK to the [latest version](./software-releases-usb-cable-updates.md)
- Install the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension for VSCode
22
-
- Find the software image version running on your Percept Devkit (see below).
23
+
- Find the software image version running on your Azure Percept Devkit (see below)
23
24
24
-
## How to identify your Azure Percept Devkit software version
25
+
## Identify your Azure Percept DK software version
25
26
26
-
SSH (Secure Shell) into your devkit and run the following command then write down the output for later reference.
27
+
Using SSH (Secure Shell), run the command line below. Write down the output for later reference.
27
28
28
29
`cat /etc/adu-version`
29
30
30
31
Example output: 2021.111.124.109
31
32
32
-
## Create an Azure IoT Edge device for the Devkit
33
-
If you have a device already created, you can skip to the [Manually deploy the deployment.json to the device](#manually-deploy-the-deploymentjson-to-the-azure-percept-device) section.
34
-
1. Go to [Azure portal](https://portal.azure.com) and select the **IoT Hub** where you will create the device.
33
+
## Create an Azure IoT Edge device for the Azure Percept DK
34
+
If you already have an IoT Edge device instance created in your subscription for the devkit, you can skip to the [Manually deploy the deployment.json to the Azure Percept DK](#manually-deploy-the-deploymentjson-to-the-azure-percept-dk) section.
35
+
1. Go to [Azure portal](https://portal.azure.com) and select the **IoT Hub** where you'll create the device
35
36
2. Navigate to **IoT Edge** and select **Add an IoT Edge device**
36
-
3. On the **Create a Device** screen, name your device in the **Device ID** section and leave all other fields as default, then click the **Save** button.
37
-
37
+
3. On the **Create a Device** screen, name your device in the **Device ID** section and leave all other fields as default, then select **Save**
38
+
:::image type="content" source="./media/manually-deploy-azure-precept-devkit-images/create-device.png" alt-text="create new device":::
38
39
39
-
1. Select your newly created device.
40
-
40
+
1. Select your newly created device
41
+
:::image type="content" source="./media/manually-deploy-azure-precept-devkit-images/select-new-device.png" alt-text="select new device.":::
41
42
42
-
2. Copy the **Primary Connection String**. We will use this copied text in the Azure Percept Onboarding/setup web pages.
1.Setup your Devkit using the main instructions and **STOP** at to the **Select your preferred configuration** page
49
+
1.Set up your devkit using the main instructions and **STOP** at to the **Select your preferred configuration** page
49
50
1. Select **Connect to an existing device**
50
-
1. Paste the **Primary Connection String** that you copied from the earlier steps.
51
-
2.Click Finish.
52
-
3. The **Device setup complete!** page should now display.
51
+
1. Paste the **Primary Connection String** that you copied from the earlier steps
52
+
2.Select Finish
53
+
3. The **Device set up complete!** page should now display
53
54
**If this page does not disappear after 10 secs, don’t worry. Just go ahead with the next steps**
54
-
4. You will be disconnected from the Devkit’s Wi-Fi hotspot. Reconnect your computer to your main Wi-Fi (if needed).
55
-
56
-
57
-
## Manually deploy the deployment.json to the Azure Percept device
58
-
The deployment.json files are a representation of all default modules necessary to begin using the Azure Percept devkit.
59
-
1. Download the appropriate deployment.json from [GitHub](https://github.com/microsoft/azure-percept-advanced-development/tree/main/default-configuration) for your reported software version. Refer to the [How to Identify your Azure Percept Devkit software version](#how-to-identify-your-azure-percept-devkit-software-version) section above.
60
-
1. For 2021.111.124.xxx and later -----> use [default-deployment-2112.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2112.json)
61
-
2. For 2021.109.129.xxx and lower use ----> use [default-deployment-2108.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2108.json)
62
-
2. Launch VSCode and Sign into Azure. Be sure you have installed the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension
63
-
3. Connect to your subscription and select your IoTHub
64
-
4. Locate your IoT Edge Device then right click it and choose **Create deployment for a Single Device**.
65
-
66
-
67
-
5. Navigate to the "Deployment.json" you saved from step 1 and use this.
68
-
6. Deployment will take 1-5 mins to fully complete.
69
-
1. For those interested in watching the IoT Edge log as this deployment is going on, you can SSH into your Azure Percept devkit and watch the iotedge logs by issuing the command below.
55
+
4. You'll be disconnected from the devkit’s Wi-Fi hotspot, reconnect your computer to your main Wi-Fi (if needed)
56
+
57
+
58
+
## Manually deploy the deployment.json to the Azure Percept DK
59
+
60
+
The deployment.json files are a representation of all default modules necessary to begin using the Azure Percept DK.
61
+
1. Download the appropriate deployment.json from [GitHub](https://github.com/microsoft/azure-percept-advanced-development/tree/main/default-configuration) for your reported software version. Refer to the [Identify your Azure Percept DK software version](#identify-your-azure-percept-dk-software-version) section above.
62
+
1. For 2021.111.124.xxx and later, use [default-deployment-2112.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2112.json)
63
+
2. For 2021.109.129.xxx and lower, use [default-deployment-2108.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2108.json)
64
+
2. Launch VSCode and Sign into Azure. Be sure you've installed the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension.
65
+
66
+
67
+
68
+
3. Connect to your subscription and select your IoT Hub
69
+
4. Locate your IoT Edge Device then right select it and choose **Create deployment for a Single Device**.
70
+
71
+
72
+
73
+
5. Navigate to the "Deployment.json" you saved from step 1 and select it. Then select OK.
74
+
6. Deployment will take 1-5 minutes to fully complete
75
+
1. If you are interested in watching the Azure IoT Edge log while the deployment is going on, you can SSH into your Azure Percept DK and watch the Azure IoT Edge logs by issuing the command below.
70
76
`sudo journalctl -u iotedge -f`
71
-
7. Your Devkit is now ready to use!
77
+
7. Your Azure Percept DK is now ready to use!
72
78
73
79
74
80
<!-- 5. Next steps
75
-
Required. Provide at least one next step and no more than three. Include some
76
-
context so the customer can determine why they would click the link.
81
+
@@ -77,4 +76,4 @@ context so the customer can determine why they would click the link.
77
82
-->
78
83
79
84
## Next steps
80
-
Navigate to the [Azure Percept portal](https://portal.azure.com/#blade/AzureEdgeDevices/Main/overview) for more AI models.
85
+
Navigate to the [Azure Percept Studio](https://ms.portal.azure.com/#blade/AzureEdgeDevices/Main/overview) for more AI models.
0 commit comments