Skip to content

Commit f744099

Browse files
committed
fixed requirements
1 parent 6e21f55 commit f744099

File tree

1 file changed

+5
-9
lines changed

1 file changed

+5
-9
lines changed

articles/iot-hub/quickstart-control-device-python.md

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,8 @@ The quickstart uses two pre-written Python applications:
2626
* A back-end application that calls the direct methods on the simulated device. To call a direct method on a device, this application connects to service-side endpoint on your IoT hub.
2727

2828
> [!IMPORTANT]
29-
> In this article, the back-end application uses the Python V1 service client (the device application uses the Python V2 device client). The V1 service client has platform-specific requirements for the version of Python installed on your development machine. These are noted in the prerequisites section.
29+
> In this article, the back-end application uses the Python V1 service client and the device application uses the Python V2 device client. The V1 service client is located in the [v1-deprecated branch](https://github.com/Azure/azure-iot-sdk-python/tree/v1-deprecated) of the Azure IoT Python SDK GitHub repository. The Pip package for the V1 service client, *azure-iothub-service-client*, has strict, platform-specific requirements -- including the version of Python installed on your development machine. These requirements are noted in the **Prerequisites** section.
3030
>
31-
> **Additionally, pip installation of the V1 service client is only supported for Windows.**
32-
>
33-
>For this reason, on non-Windows platforms, you need to build the SDK to use the V1 service client. Code for the V1 service client is in the [v1-deprecated branch](https://github.com/Azure/azure-iot-sdk-python/tree/v1-deprecated) of the Azure IoT Python SDK. Follow the [devbox setup instructions](https://github.com/Azure/azure-iot-sdk-python/blob/v1-deprecated/doc/python-devbox-setup.md) for your platform to build the V1 service client. We recommend building for the Python 3.x version specified for your platform in the instructions.
3431
3532
[!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
3633

@@ -46,12 +43,14 @@ az extension add --name azure-cli-iot-ext
4643

4744
If you haven't already done so, download the sample Python project from https://github.com/Azure-Samples/azure-iot-samples-python/archive/master.zip and extract the ZIP archive.
4845

49-
The following prerequisites are required for the V1 IoT Hub service client on Windows. For other platforms, see the **Important** note at the beginning of this article.
46+
The following prerequisites are required to install V1 IoT Hub service client Pip package on Windows.
5047

51-
* Make sure you have [Python version **3.6.x**](https://www.python.org/downloads/) installed. **This specific version is required for the V1 IoT Hub service client on Windows.**
48+
* Make sure you have [Python version **3.6.x**](https://www.python.org/downloads/) installed.
5249

5350
* Make sure you have the [Microsoft Visual C++ Redistributable for Visual Studio](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) installed.
5451

52+
For other platforms, see the [Python Pip package distribution table](https://github.com/Azure/azure-iot-sdk-python/blob/v1-deprecated/doc/python-devbox-setup.md#python-pip-package-distribution-table) in the V1 SDK documentation. Make sure the Python 3.x version specified for your platform and any associated requirements are installed on your development machine. Installing Python 3.x rather than 2.7 enables async operations in the V2 device client.
53+
5554
## Create an IoT hub
5655

5756
If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-python.md), you can skip this step.
@@ -135,9 +134,6 @@ The simulated device application connects to a device-specific endpoint on your
135134
136135
The back-end application connects to a service-side endpoint on your IoT Hub. The application makes direct method calls to a device through your IoT hub and listens for acknowledgments. An IoT Hub back-end application typically runs in the cloud.
137136
138-
> [!NOTE]
139-
> **Pip installation of the V1 service client is only supported for Windows.** For other platforms, you need to build the SDK to use the V1 service client. For more information, see the **Important** note at the beginning of this article.
140-
141137
1. In another local terminal window, navigate to the root folder of the sample Python project. Then navigate to the **iot-hub\Quickstarts\back-end-application** folder.
142138
143139
1. Open the **BackEndApplication.py** file in a text editor of your choice.

0 commit comments

Comments
 (0)