Skip to content

Commit 62b5781

Browse files
authored
Merge pull request #200001 from timlt/fix-tshoot
update author
2 parents a207b9e + eb415ab commit 62b5781

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

articles/iot-develop/troubleshoot-embedded-device-quickstarts.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: Troubleshooting the Azure RTOS embedded device quickstarts
33
description: Steps to help you troubleshoot common issues when using the Azure RTOS embedded device quickstarts
4-
author: JimacoMS4
5-
ms.author: v-jbrannian
4+
author: timlt
5+
ms.author: timlt
66
ms.service: iot-develop
77
ms.topic: troubleshooting
88
ms.date: 06/10/2021
9+
ms.custom: contperf-fy22q4
910
---
1011

1112
# Troubleshooting the Azure RTOS embedded device quickstarts
@@ -37,7 +38,7 @@ This issue can occur when you attempt to build the project. It's the result of t
3738

3839
### Description
3940

40-
The issue can occur because the path to an object file exceeds the default maximum path length in Windows. Examine the build output for a message similar to the following:
41+
The issue can occur because the path to an object file exceeds the default maximum path length in Windows. Examine the build output for a message similar to the following example:
4142

4243
```output
4344
-- Configuring done
@@ -62,13 +63,13 @@ CMake Warning in C:/embedded quickstarts/areallyreallyreallylongpath/getting-sta
6263

6364
You can try one of the following options to resolve this error:
6465
* Clone the repository into a directory with a shorter path and try again.
65-
* Follow the instructions in [Maximum Path Length Limitation](/windows/win32/fileio/maximum-file-path-limitation) to enable long paths in Windows 10, version 1607 and later.
66+
* Follow the instructions in [Maximum Path Length Limitation](/windows/win32/fileio/maximum-file-path-limitation) to enable long paths in Windows 11 and Windows 10, version 1607 and later.
6667

6768
## Issue: Device can't connect to Iot hub
6869

6970
### Description
7071

71-
The issue can occur after you've created Azure resources, and flashed your device. When you try to connect your newly flashed device to Azure IoT, you see a console message like the following:
72+
The issue can occur after you've created Azure resources, and flashed your device. When you try to connect your newly flashed device to Azure IoT, you see a console message like the following example:
7273

7374
```output
7475
Unable to resolve DNS for MQTT Server
@@ -82,7 +83,7 @@ Unable to resolve DNS for MQTT Server
8283

8384
### Description
8485

85-
After you flash a device that uses a Wi-Fi connection and try to connect to your Wi-Fi network, you get an error message that Wi-Fi is unable to connect.
86+
After you flash a device that uses a Wi-Fi connection, you get an error message that Wi-Fi is unable to connect.
8687

8788
### Resolution
8889

@@ -93,7 +94,7 @@ After you flash a device that uses a Wi-Fi connection and try to connect to your
9394

9495
### Description
9596

96-
You can't complete the process of flashing your device. You'll know this if you experience any of the following symptoms:
97+
You can't complete the process of flashing your device. The following symptoms indicate that flashing is incomplete:
9798

9899
* The **.bin* image file that you built doesn't copy to the device.
99100
* The utility that you're using to flash the device gives a warning or error.
@@ -110,7 +111,7 @@ You can't complete the process of flashing your device. You'll know this if you
110111

111112
### Description
112113

113-
After you flash your device and connect it to your computer, you get a message like the following in your terminal software:
114+
After you flash your device and connect it to your computer, you get output like the following message in your terminal software:
114115

115116
```output
116117
Failed to initialize the port.
@@ -148,7 +149,7 @@ After you flash your device successfully and connect it to your computer, you se
148149

149150
### Description
150151

151-
After you flash your device and connect it to your computer, you get a repeated message like the following in your terminal window:
152+
After you flash your device and connect it to your computer, you get output like the following message in your terminal window:
152153

153154
```output
154155
Failed to publish temperature
@@ -162,7 +163,7 @@ Failed to publish temperature
162163

163164
### Description
164165

165-
Because [Defender for IoT module](/azure/defender-for-iot/device-builders/iot-security-azure-rtos) is enabled by default from the device end, you might observe extra messages that are caused by that.
166+
Because [Defender for IoT module](/azure/defender-for-iot/device-builders/iot-security-azure-rtos) is enabled by default from the device end, you might observe extra messages in the output.
166167

167168
### Resolution
168169

0 commit comments

Comments
 (0)