Summary

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

Details

Page properties

Content

...	...	@@ -4,23 +4,32 @@
4	4
5	5
6	6
	7	+= 1. Introduction =
7	7
	9	+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.
8	8
9		-= 1. Deployment Guide =
	11	+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]].
10	10
	13	+(% class="wikigeneratedid" %)
	14	+[[image:image-20230511145209-1.png||height="600" width="813"]]
11	11
	16	+
	17	+= 2. Deployment Guide =
	18	+
	19	+
12	12	Learn how to deploy the Azure IoT Hub integration for The Things Stack.
13	13
14	14
15		-== 1.1 Prerequisites ==
16	16
	24	+== 2.1 Prerequisites ==
17	17
	26	+
18	18	1.  Access to an Azure account. [[Create a new account>>url:https://signup.azure.com/]]
19	19
20	20	2. An application in The Things Stack. [[See instructions>>url:https://www.thethingsindustries.com/docs/integrations/adding-applications/]]
21	21
22	22
23		-== 1.2 Create API Key ==
	32	+== 2.2 Create API Key ==
24	24
25	25
26	26	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**.
...	...	@@ -34,7 +34,7 @@
34	34	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.
35	35
36	36
37		-== 1.3 Deploy Azure Resource Manager Template ==
	46	+== 2.3 Deploy Azure Resource Manager Template ==
38	38
39	39
40	40	[[Deploy template>>url:https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fttsiothubintegration.blob.core.windows.net%2Fintegration-releases%2Flatest%2Fmain.json]]
...	...	@@ -42,7 +42,7 @@
42	42	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]]
43	43
44	44
45		-== 1.4 Settings ==
	54	+== 2.4 Settings ==
46	46
47	47
48	48	The following parameters configure the integration:
...	...	@@ -84,7 +84,7 @@
84	84	[[image:image-20230105112836-5.png]]
85	85
86	86
87		-= 2. Managing Devices =
	96	+= 3. Managing Devices =
88	88
89	89
90	90	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.
...	...	@@ -102,7 +102,7 @@
102	102	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.
103	103
104	104
105		-== 2.1 Creating Devices ==
	114	+== 3.1 Creating Devices ==
106	106
107	107
108	108	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.
...	...	@@ -159,7 +159,6 @@
159	159
160	160	* (% style="color:#037691" %)**modelId:**(%%) the model ID.
161	161
162		-
163	163	(% style="color:red" %)**Note:**
164	164
165	165	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/]].
...	...	@@ -206,7 +206,7 @@
206	206	Click on (% style="color:blue" %)**Save**(%%) in the top-left corner. The end device will now be created in The Things Stack.
207	207
208	208
209		-== 2.2 Deleting Devices ==
	217	+== 3.2 Deleting Devices ==
210	210
211	211
212	212	In the Azure Console, open your Azure IoT Hub resource. In the menu on the left, click (% style="color:blue" %)**IoT Devices**.