Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.Xiaoling
	1	+XWiki.Kilight

Content

...	...	@@ -4,24 +4,15 @@
4	4
5	5
6	6
7		-= 1. Introduction =
8	8
9	9
10		-Azure IoT Hub is designed around standalone end devices communicating directly with the hub. Each end device must connect to the hub via one of the supported communication protocols ([[MQTT>>url:https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-mqtt-support]] / [[AMQP>>url:https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-amqp-support]]). These protocols are inherently stateful - each individual end device must have one connection always open in order to send and receive messages from the Azure IoT Hub.
	9	+= 1. Deployment Guide =
11	11
12		-The Azure IoT Hub integration prefers to use an asynchronous, stateless communication style. When uplink messages are received from an end device, the integration connects on demand to the Azure IoT Hub and submits the message, and also updates the Device Twin. The data plane protocol used between The Things Stack and Azure IoT Hub is [[MQTT>>url:https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-mqtt-support]], and the connections are always secure using [[TLS 1.2>>url:https://datatracker.ietf.org/doc/html/rfc5246]].
13	13
14		-(% class="wikigeneratedid" %)
15		-[[image:image-20230511145209-1.png||height="600" width="813"]]
16		-
17		-
18		-= 2. Deployment Guide =
19		-
20		-
21	21	Learn how to deploy the Azure IoT Hub integration for The Things Stack.
22	22
23	23
24		-== 2.1 Prerequisites ==
	15	+== 1.1 Prerequisites ==
25	25
26	26
27	27	1.  Access to an Azure account. [[Create a new account>>url:https://signup.azure.com/]]
...	...	@@ -29,7 +29,7 @@
29	29	2. An application in The Things Stack. [[See instructions>>url:https://www.thethingsindustries.com/docs/integrations/adding-applications/]]
30	30
31	31
32		-== 2.2 Create API Key ==
	23	+== 1.2 Create API Key ==
33	33
34	34
35	35	Go to your application in The Things Stack Console, navigate to (% style="color:blue" %)**Integrations → Azure IoT**(%%) on the left hand menu and click on (% style="color:blue" %)**Expand** (%%)next to (% style="color:blue" %)**Azure IoT Hub**(%%). Now click on (% style="color:blue" %)**Generate API Key**.
...	...	@@ -43,7 +43,7 @@
43	43	Leave the integration page open, as you will need to copy in your (% style="color:blue" %)**Azure IoT Hub hostname** (%%)and (% style="color:blue" %)**Azure IoT Hub access key**(%%) before saving the integration.
44	44
45	45
46		-== 2.3 Deploy Azure Resource Manager Template ==
	37	+== 1.3 Deploy Azure Resource Manager Template ==
47	47
48	48
49	49	[[Deploy template>>url:https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fttsiothubintegration.blob.core.windows.net%2Fintegration-releases%2Flatest%2Fmain.json]]
...	...	@@ -51,7 +51,7 @@
51	51	View template as [[JSON>>url:https://ttsiothubintegration.blob.core.windows.net/integration-releases/latest/main.json]] or [[Bicep>>url:https://ttsiothubintegration.blob.core.windows.net/integration-releases/latest/main.bicep]]
52	52
53	53
54		-== 2.4 Settings ==
	45	+== 1.4 Settings ==
55	55
56	56
57	57	The following parameters configure the integration:
...	...	@@ -93,11 +93,12 @@
93	93	[[image:image-20230105112836-5.png]]
94	94
95	95
96		-= 3. Managing Devices =
	87	+= 2. Managing Devices =
97	97
98	98
99	99	The Azure IoT Hub integration for The Things Stack synchronizes the device registry: you can create devices in Azure IoT Hub which trigger an Azure Function that creates the device in The Things Stack.
100	100
	92	+
101	101	(% style="color:red" %)**Note:**
102	102
103	103	Devices that you create in The Things Stack are automatically created as Azure IoT Hub devices as soon as they activate or send their first uplink message.
...	...	@@ -110,7 +110,7 @@
110	110	Devices are created automatically as they join the network or send an uplink message. For the name of new devices, the end device ID in The Things Stack is used as the device ID in Azure IoT Hub.
111	111
112	112
113		-== 3.1 Creating Devices ==
	105	+== 2.1 Creating Devices ==
114	114
115	115
116	116	You can use Azure IoT Hub to create and claim devices in The Things Stack. This is useful to manage all your devices in one place, without having to use The Things Stack Console, CLI or API.
...	...	@@ -167,6 +167,7 @@
167	167
168	168	* (% style="color:#037691" %)**modelId:**(%%) the model ID.
169	169
	162	+
170	170	(% style="color:red" %)**Note:**
171	171
172	172	If the version identifiers are provided, the end device will automatically load the [[Payload Formatters>>url:https://www.thethingsindustries.com/docs/integrations/payload-formatters/]] from [[LoRaWAN Device Repository>>url:https://www.thethingsindustries.com/docs/integrations/payload-formatters/device-repo/]].
...	...	@@ -213,7 +213,7 @@
213	213	Click on (% style="color:blue" %)**Save**(%%) in the top-left corner. The end device will now be created in The Things Stack.
214	214
215	215
216		-== 3.2 Deleting Devices ==
	209	+== 2.2 Deleting Devices ==
217	217
218	218
219	219	In the Azure Console, open your Azure IoT Hub resource. In the menu on the left, click (% style="color:blue" %)**IoT Devices**.