This commit is contained in:
Dane Walton 2021-04-29 13:20:33 -07:00 коммит произвёл GitHub
Родитель 28d9079515
Коммит 5de954f909
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
7 изменённых файлов: 121 добавлений и 0 удалений

Просмотреть файл

@ -0,0 +1,5 @@
{
"image": "aziotbld/embedded-codespace",
"postCreateCommand": "chmod +x /workspaces/azure-sdk-for-c/.devcontainer/post_build.sh && /workspaces/azure-sdk-for-c/.devcontainer/post_build.sh",
"extensions": ["webfreak.debug", "ms-vscode.cpptools" ]
}

Просмотреть файл

@ -0,0 +1,16 @@
cd /workspaces/azure-sdk-for-c
mkdir .vscode
cp ./.vscode-config/codespaces-launch.json ./.vscode/launch.json
cp ./.vscode-config/codespaces-tasks.json ./.vscode/tasks.json
mkdir cert
cd cert
openssl ecparam -out device_ec_key.pem -name prime256v1 -genkey
openssl req -new -days 30 -nodes -x509 -key device_ec_key.pem -out device_ec_cert.pem -subj "/CN=paho-sample-device1"
openssl x509 -noout -text -in device_ec_cert.pem
rm -f device_cert_store.pem
cat device_ec_cert.pem device_ec_key.pem > device_cert_store.pem
openssl x509 -noout -fingerprint -in device_ec_cert.pem | sed 's/://g'| sed 's/\(SHA1 Fingerprint=\)//g' | tee fingerprint.txt

3
.gitignore поставляемый
Просмотреть файл

@ -322,3 +322,6 @@ fingerprint.txt
# vcpkg
/vcpkg
# Cert
/cert

Просмотреть файл

@ -0,0 +1,71 @@
{
"version": "2.0.0",
"inputs": [
{
"id": "device_id",
"description": "Device ID",
"type": "promptString"
},
{
"id": "hostname",
"description": "IoT Hub Hostname",
"type": "promptString"
}
],
"configurations": [
{
"name": "IoT Telemetry",
"type": "gdb",
"request": "launch",
"env": {
"AZ_IOT_HUB_DEVICE_ID": "${input:device_id}",
"AZ_IOT_HUB_HOSTNAME": "${input:hostname}",
"AZ_IOT_DEVICE_X509_CERT_PEM_FILE_PATH": "/workspaces/azure-sdk-for-c/cert/device_cert_store.pem"
},
"target": "./build/sdk/samples/iot/paho_iot_hub_telemetry_sample",
"cwd": "${workspaceRoot}",
"preLaunchTask": "build"
},
{
"name": "IoT C2D",
"type": "gdb",
"request": "launch",
"env": {
"AZ_IOT_HUB_DEVICE_ID": "${input:device_id}",
"AZ_IOT_HUB_HOSTNAME": "${input:hostname}",
"AZ_IOT_DEVICE_X509_CERT_PEM_FILE_PATH": "/workspaces/azure-sdk-for-c/cert/device_cert_store.pem"
},
"target": "./build/sdk/samples/iot/paho_iot_hub_c2d_sample",
"cwd": "${workspaceRoot}",
"preLaunchTask": "build"
},
{
"name": "IoT Methods",
"type": "gdb",
"request": "launch",
"env": {
"AZ_IOT_HUB_DEVICE_ID": "${input:device_id}",
"AZ_IOT_HUB_HOSTNAME": "${input:hostname}",
"AZ_IOT_DEVICE_X509_CERT_PEM_FILE_PATH": "/workspaces/azure-sdk-for-c/cert/device_cert_store.pem"
},
"target": "./build/sdk/samples/iot/paho_iot_hub_methods_sample",
"cwd": "${workspaceRoot}",
"preLaunchTask": "build"
},
{
"name": "IoT Twin",
"type": "gdb",
"request": "launch",
"env": {
"AZ_IOT_HUB_DEVICE_ID": "${input:device_id}",
"AZ_IOT_HUB_HOSTNAME": "${input:hostname}",
"AZ_IOT_DEVICE_X509_CERT_PEM_FILE_PATH": "/workspaces/azure-sdk-for-c/cert/device_cert_store.pem"
},
"target": "./build/sdk/samples/iot/paho_iot_hub_twin_sample",
"cwd": "${workspaceRoot}",
"preLaunchTask": "build"
}
]
}

Просмотреть файл

@ -0,0 +1,10 @@
{
"version": "2.0.0",
"tasks": [
{
"label": "build",
"type": "shell",
"command": "mkdir -p build && cd build && rm -rf * && cmake -DTRANSPORT_PAHO=ON -DCMAKE_BUILD_TYPE=Debug .. && cmake --build ."
}
]
}

Просмотреть файл

@ -5,6 +5,7 @@
- [Azure IoT Samples](#azure-iot-samples)
- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Github Codespaces](#github-codespaces)
- [Prerequisites](#prerequisites)
- [Getting Started](#getting-started)
- [Create an Authenticated Device](#create-an-authenticated-device)
@ -56,6 +57,21 @@ More detailed step-by-step guides on how to run an IoT Hub Client sample from sc
To view scenario-focused examples using the API calls, please view the Azure IoT Client [introductory examples](https://github.com/Azure/azure-sdk-for-c/blob/master/sdk/docs/iot/README.md#examples). General [coding patterns](https://github.com/Azure/azure-sdk-for-c/blob/master/sdk/docs/iot/coding_patterns.md) that are MQTT stack agnostic are also available to view.
## Github Codespaces
You can use Github Codespaces to be up and running quickly! Here are the steps to follow (assuming you already have an IoT Hub set up).
1. Select the "Open with Codespaces" prompt on Github and then "New codespace".
![codespace](./docs/img/codespace.png)
1. Once the Codespace is open, all required build tools, extensions, and debugging tools will be setup for you.
1. Hit Control-Shift-B on your keyboard to build the SDK and samples.
1. Navigate to the `cert/` directory and find the fingerprint for the certificate that was generated for you.
1. In the Azure IoT Hub portal, add a device using Self-Signed Cert authentication. Paste the fingerprint in for Primary and Secondary. Add the device.
1. Back in the Codespace, navigate to the "Run" tab on the left side (arrow with a bug).
1. Select any of the samples and hit the green run button.
1. Paste you Device ID and IoT Hub Hostname in the prompts that pop up. Hit enter and the sample should be running!
1. Note you can use the device explorer to monitor/interact with the samples.
## Prerequisites
To run the samples, ensure you have the following programs and tools installed on your system:

Двоичные данные
sdk/samples/iot/docs/img/codespace.png Normal file

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 78 KiB