<
From version < 16.1 >
edited by Xiaoling
on 2023/01/05 13:50
To version < 16.2 >
edited by Xiaoling
on 2023/01/05 13:52
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,9 +1,11 @@
1 1  **Table of Contents:**
2 2  
3 +{{toc/}}
3 3  
4 4  
5 5  
6 6  
8 +
7 7  = 1. Deployment Guide =
8 8  
9 9  
... ... @@ -13,10 +13,11 @@
13 13  == 1.1 Prerequisites ==
14 14  
15 15  
16 -1. Access to an Azure account. [[Create a new account>>url:https://signup.azure.com/]]
18 +1.  Access to an Azure account. [[Create a new account>>url:https://signup.azure.com/]]
17 17  
18 -1. An application in The Things Stack. [[See instructions>>url:https://www.thethingsindustries.com/docs/integrations/adding-applications/]]
20 +2. An application in The Things Stack. [[See instructions>>url:https://www.thethingsindustries.com/docs/integrations/adding-applications/]]
19 19  
22 +
20 20  == 1.2 Create API Key ==
21 21  
22 22  
... ... @@ -58,7 +58,7 @@
58 58  
59 59  [[image:image-20230105112836-2.png]]
60 60  
61 -Click (% style="color:blue" %)**Review + Create**(%%), then (% style="color:#037691" %)**Create**.
64 +Click (% style="color:blue" %)**Review + Create**(%%), then (% style="color:blue" %)**Create**.
62 62  
63 63  
64 64  (% style="color:red" %)**Note:**
... ... @@ -65,17 +65,19 @@
65 65  
66 66  Creating all resources can take up to five minutes. ☕
67 67  
68 -When the deployment is done, you’ll see the status .Your deployment is complete
71 +When the deployment is done, you’ll see the status .Your deployment is complete.
69 69  
73 +
70 70  [[image:image-20230105112836-3.png]]
71 71  
72 72  
73 73  After the deployment has finished, click (% style="color:blue" %)**Outputs**.
74 74  
75 -[[image:image-20230105112836-4.png]]
79 +[[image:image-20230105135055-2.png]]
76 76  
77 -The two outputs can now be copied into your integration settings as (% style="color:blue" %)**Azure IoT Hub hostname**(%%) and (% style="color:#037691" %)**Azure IoT Hub access key**(%%). Click on (% style="color:blue" %)**Enable/Update Azure IoT Hub integration**.
78 78  
82 +The two outputs can now be copied into your integration settings as (% style="color:blue" %)**Azure IoT Hub hostname**(%%) and (% style="color:blue" %)**Azure IoT Hub access key**(%%). Click on (% style="color:blue" %)**Enable/Update Azure IoT Hub integration**.
83 +
79 79  [[image:image-20230105112836-5.png]]
80 80  
81 81  
... ... @@ -97,8 +97,9 @@
97 97  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.
98 98  
99 99  
100 -(% style="color:blue" %)**Creating Devices:**
105 +== 2.1 Creating Devices ==
101 101  
107 +
102 102  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.
103 103  
104 104  (% style="color:blue" %)**Creating**(%%) a device allows you to add any LoRaWAN device by manually entering its information and security keys.
... ... @@ -109,8 +109,10 @@
109 109  
110 110  [[image:image-20230105112836-6.png]]
111 111  
118 +
112 112  As (% style="color:blue" %)**Device ID**(%%), enter any device ID you like. Hit (% style="color:blue" %)**Save**.
113 113  
121 +
114 114  (% style="color:red" %)**Note:**
115 115  
116 116  See [[ID and EUI constraints>>url:https://www.thethingsindustries.com/docs/reference/id-eui-constraints/]] for guidelines about choosing a unique ID.
... ... @@ -117,38 +117,42 @@
117 117  
118 118  [[image:image-20230105112836-7.png]]
119 119  
128 +
120 120  You will now have to setup the LoRaWAN specific settings of the device. Click on (% style="color:blue" %)**Device Twin**.
121 121  
122 -[[image:image-20230105112836-8.png]]
131 +[[image:image-20230105134348-1.png]]
123 123  
133 +
124 124  You will now be presented with a JSON document containing the Device Twin. You now have to add a new object called tags, which will contain an object called lorawan with the LoRaWAN specific tags. You will have to specify the following tags:
125 125  
126 -* (% style="color:#037691" %)devEui:(%%) the hexadecimal LoRaWAN DevEUI.
136 +* (% style="color:#037691" %)**devEui:**(%%) the hexadecimal LoRaWAN DevEUI.
127 127  
128 -* (% style="color:#037691" %)joinEui:(%%) the hexadecimal LoRaWAN JoinEUI (or AppEUI).
138 +* (% style="color:#037691" %)**joinEui:**(%%)** **the hexadecimal LoRaWAN JoinEUI (or AppEUI).
129 129  
130 -* (% style="color:#037691" %)lorawanVersion:(%%) either 1.0, 1.0.1, 1.0.2, 1.0.3 or 1.1.
140 +* (% style="color:#037691" %)**lorawanVersion:**(%%) either 1.0, 1.0.1, 1.0.2, 1.0.3 or 1.1.
131 131  
132 -* (% style="color:#037691" %)regionalParametersVersion:(%%) either 1.0, 1.0.1, 1.0.2 (or 1.0.2-a), 1.0.2-b, 1.0.3-a, 1.1-a or 1.1-b.
142 +* (% style="color:#037691" %)**regionalParametersVersion:**(%%) either 1.0, 1.0.1, 1.0.2 (or 1.0.2-a), 1.0.2-b, 1.0.3-a, 1.1-a or 1.1-b.
133 133  
134 -* (% style="color:#037691" %)appKey:(%%) the hexadecimal LoRaWAN AppKey.
144 +* (% style="color:#037691" %)**appKey:**(%%) the hexadecimal LoRaWAN AppKey.
135 135  
136 -* (% style="color:#037691" %)nwkKey:(%%) the hexadecimal LoRaWAN NwkKey (only when using LoRaWAN 1.1 or higher).
146 +* (% style="color:#037691" %)**nwkKey:**(%%) the hexadecimal LoRaWAN NwkKey (only when using LoRaWAN 1.1 or higher).
137 137  
138 -* (% style="color:#037691" %)frequencyPlanId:(%%) the frequency plan ID. See [[Frequency Plans>>url:https://www.thethingsindustries.com/docs/reference/frequency-plans/]] for the supported values.
148 +* (% style="color:#037691" %)**frequencyPlanId:**(%%) the frequency plan ID. See [[Frequency Plans>>url:https://www.thethingsindustries.com/docs/reference/frequency-plans/]] for the supported values.
139 139  
140 140  If your end device is a part of the [[LoRaWAN Device Repository>>url:https://www.thethingsindustries.com/docs/integrations/payload-formatters/device-repo/]], you may provide the identifiers of the device as part of an optional versionIdentifiers object. You can specify the following information as part of the identifiers:
141 141  
142 -* (% style="color:#037691" %)bandId:(%%) the band ID.
152 +* (% style="color:#037691" %)**bandId:**(%%) the band ID.
143 143  
144 -* (% style="color:#037691" %)brandId:(%%) the brand ID.
154 +* (% style="color:#037691" %)**brandId:**(%%) the brand ID.
145 145  
146 -* (% style="color:#037691" %)firmwareVersion:(%%) the firmware version.
156 +* (% style="color:#037691" %)**firmwareVersion:**(%%) the firmware version.
147 147  
148 -* (% style="color:#037691" %)hardwareVersion:(%%) the hardware version.
158 +* (% style="color:#037691" %)**hardwareVersion:**(%%) the hardware version.
149 149  
150 -* (% style="color:#037691" %)modelId:(%%) the model ID.
160 +* (% style="color:#037691" %)**modelId:**(%%) the model ID.
151 151  
162 +
163 +
152 152  (% style="color:red" %)**Note:**
153 153  
154 154  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/]].
... ... @@ -189,12 +189,15 @@
189 189  
190 190  }
191 191  
204 +
192 192  [[image:image-20230105112836-9.png]]
193 193  
194 194  Click on (% style="color:blue" %)**Save**(%%) in the top-left corner. The end device will now be created in The Things Stack.
195 195  
196 -(% style="color:blue" %)**Deleting Devices:**
197 197  
210 +== 2.2 Deleting Devices ==
211 +
212 +
198 198  In the Azure Console, open your Azure IoT Hub resource. In the menu on the left, click (% style="color:blue" %)**IoT Devices**.
199 199  
200 200  Click on the checkbox in front of the device you want to delete, then click (% style="color:blue" %)**Delete**.
... ... @@ -203,15 +203,20 @@
203 203  
204 204  The end device will be deleted from Azure IoT Hub and The Things Stack.
205 205  
206 -(% style="color:blue" %)Example(TrackerD):
207 207  
222 +(% style="color:blue" %)**Example(TrackerD):**
223 +
208 208  [[image:image-20230105112836-11.png]]
209 209  
226 +
210 210  [[image:image-20230105112836-12.png]]
211 211  
212 212  
213 -(% style="color:blue" %)Example(LHT65N):
230 +(% style="color:blue" %)**Example(LHT65N):**
214 214  
215 -[[image:image-20230105112836-13.png]]
232 +[[image:image-20230105112836-13.png||height="698" width="1326"]]
216 216  
234 +
217 217  [[image:image-20230105112836-14.png]]
236 +
237 +
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0