Wiki source code of AVNET/IOTConnect
Last modified by Xiaoling on 2024/12/18 14:57
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | **~ Table of Contents:** | ||
2 | |||
3 | {{toc/}} | ||
4 | |||
5 | |||
6 | = 1. AVNET/IOTConnect = | ||
7 | |||
8 | == 1.1 What is IoTConnect == | ||
9 | |||
10 | |||
11 | IoTConnect is a secured, cloud-based enterprise IoT and AI platform. It simplifies the complex. It jumpstarts the development of IoT-enabled systems, turning real-time data into actionable value-driven insights. It enables making an informed decision quickly, consequently sparking innovation. | ||
12 | |||
13 | IoTConnect brings IoT hardware, software, applications, data analytics and artificial intelligence capabilities. It comes with a feature-rich tool kit that is easy to use and significantly reduces complexity, cost and time-to-market. | ||
14 | |||
15 | In this guide, you will learn how to connect a dragino gateway to the LNS solution provided by AVNET/IOTConnect. | ||
16 | |||
17 | |||
18 | == 1.2 Login or crate an account == | ||
19 | |||
20 | |||
21 | **[[Login or crate an account>>https://subscription.iotconnect.io/subscribe]]**to get started with IoTConnect and start using IoTConnect Console. | ||
22 | |||
23 | Once you have an account,get started by following steps for adding Gateway,Device and Intergrations. | ||
24 | |||
25 | |||
26 | == 1.3 List the support products and Requirements == | ||
27 | |||
28 | |||
29 | LoRaWAN Gateway model: Existing Gateway | ||
30 | |||
31 | |||
32 | = 2. Configure Gateway connection to IoTConnect = | ||
33 | |||
34 | |||
35 | (% style="color:blue" %)**Below list the support products and Requirements:** | ||
36 | |||
37 | 1. LoRaWAN Gateway model: [[LIG16>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]],[[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]],[[LPS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/200-lps8n.html]],[[LG308N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/229-lg308n.html]] ,[[DLOS8N>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/225-dlos8n.html]] ,[[LPS8V2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] | ||
38 | |||
39 | (% style="color:blue" %)**What do you need to prepare?** | ||
40 | |||
41 | A gateway that can access the internet normally. | ||
42 | |||
43 | |||
44 | For more information, please refer to the official IOTConnect documentation: [[Wireless Device – docs.iotconnect.io>>url:https://docs.iotconnect.io/iotconnect/user-manuals/devices/device/wireless-device/]] | ||
45 | |||
46 | |||
47 | == Step 1. Log in IoTConnect == | ||
48 | |||
49 | |||
50 | Log in to your dashboard at [[Avnet / IOTConnect login>>https://login.iotconnect.io/Account/Login?ReturnUrl=%2Fconnect%2Fauthorize%2Fcallback%3Fclient_id%3Diotconnect.aws%26redirect_uri%3Dhttps%253A%252F%252Fconsole.iotconnect.io%252Fcallback%26response_type%3Did_token%2520token%26scope%3Dopenid%2520profile%2520iotconnect.api.fullaccess%26state%3D01f9e4527d6d4638a5a840a37dc9061d%26nonce%3D5aed230483234f93a1e267751e180d2a%26acr_values%3DsolutionCode%253AAFD9B0BA-0AA5-4690-9A7A-656A0000D62C]] | ||
51 | |||
52 | (% class="wikigeneratedid" id="H" %) | ||
53 | [[image:image-20240401101022-1.png||height="598" width="1107"]] | ||
54 | |||
55 | == Step 2. Create a template == | ||
56 | |||
57 | |||
58 | To create a template for your organization: | ||
59 | |||
60 | 1. From the left navigation, mouseover the **Devices** module. In the middle and toward the down, select **Templates**. | ||
61 | 1. Along the top and toward the right, select **Create Template**. | ||
62 | 1. Enter data in the following fields: | ||
63 | |||
64 | * | ||
65 | ** **Template Code**: Enter a unique code for the template. Once entered, you cannot change. | ||
66 | ** **Template Name**: Enter a unique name for the template. | ||
67 | ** **Authentication Type**: We offer a X.509 authentication to secure online communications and verify the identity of individuals or devices on a network. | ||
68 | ** **Device Message Version**: Select the **device message version.** The platform displays the data type while editing a template based on a device message version. | ||
69 | |||
70 | 4. Click **Save** to create a template. | ||
71 | |||
72 | [[image:image-20240401102119-2.png||height="581" width="1126"]] | ||
73 | |||
74 | [[image:https://docs.iotconnect.io/wp-content/uploads/2023/12/Create-Template-1.png||alt="img" height="194" width="1126"]] | ||
75 | |||
76 | |||
77 | Attributes are device properties that you want a template’s devices to measure. It can be anything from temperature, humidity, luminosity, wattage, to CO2 concentration. | ||
78 | |||
79 | [[image:image-20240401102658-3.png||height="583" width="1131"]] | ||
80 | |||
81 | |||
82 | == Step 3. Create a LoRaWAN Gateway == | ||
83 | |||
84 | |||
85 | To create a LoRaWAN gatway device for your organization: | ||
86 | |||
87 | 1. From the left navigation, mouseover the **Devices** module. Click **Wireless Device**. | ||
88 | 1. Along the bottom center toward the left, select **LoRaWAN gateway.** | ||
89 | 1. Enter data in the following fields: | ||
90 | |||
91 | [[image:image-20240401103307-5.png||height="592" width="1147"]] | ||
92 | |||
93 | * | ||
94 | ** **Gateway Name:** Enter the display name for a Gateway device. | ||
95 | ** **EUI Code:** Provide the gateway EUI that you identified in the previous section.You can find it either on a sticker at the back of the device or in the **Web UI > LoRaWAN~-~-Basic station** | ||
96 | ** **Frequency Band:** Choose a frequency band for the geographic region e.g. US915 for North America, EU868 for Europe. | ||
97 | |||
98 | Once you create and store gateway credentials, you will get the certificate file under the zip to onboard your gateway. Upload the following files to your gateway: | ||
99 | |||
100 | * **<gateway id>.cert.pem:** Gateway device certificate file. | ||
101 | * **<gateway id>.private.key:** Gateway device private key file. | ||
102 | |||
103 | [[image:image-20240401103615-6.png||height="355" width="1138"]] | ||
104 | |||
105 | |||
106 | 4. CUPS URI and LNS URI can be found on the **Settings~-~->Key Vaylt** interface | ||
107 | |||
108 | 5. Download **Server Trust Certificates** | ||
109 | |||
110 | [[image:image-20240401104152-8.png||height="589" width="1142"]] | ||
111 | |||
112 | [[image:image-20240401104653-9.png||height="588" width="1140"]] | ||
113 | |||
114 | == Step 4. Access the gateway GUI == | ||
115 | |||
116 | |||
117 | To configure the gateway, access it via the Web UI. To learn how to do that, refer to the Quick Start Guide for each gateway. | ||
118 | |||
119 | Users need to fill in the LNS URI and upload the Certificate. | ||
120 | |||
121 | [[image:image-20240401103813-7.png||height="688" width="1082"]] | ||
122 | |||
123 | |||
124 | == Step 5. Configure Station == | ||
125 | |||
126 | |||
127 | Users need to fill in the CUPS URI, LNS URI and upload the Certificate. | ||
128 | |||
129 | (% style="color:red" %)**Note:**(%%) The uploaded Private Key and Cert Pem cannot be displayed and the Service Provider does not have AVNET/IOTConnect, we will fix and add it in the next firmware release | ||
130 | |||
131 | Users can now use Amazon IoT Basic Station for testing. | ||
132 | |||
133 | [[image:image-20240401105010-10.png||height="691" width="1112"]] | ||
134 | |||
135 | |||
136 | == Trouble Shooting == | ||
137 | |||
138 | |||
139 | User can check the station log in the(% style="color:blue" %)** LogRead ~-~-> System Log **(%%)page. | ||
140 | |||
141 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/Notes%20for%20TTN/WebHome/image-20220526135845-15.png?rev=1.1||alt="image-20220526135845-15.png"]] | ||
142 | |||
143 | |||
144 | and recode the station log in the(% style="color:blue" %)** LogRead ~-~-> Recode Log**(%%) page. | ||
145 | |||
146 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/Notes%20for%20TTN/WebHome/image-20220526135940-16.png?rev=1.1||alt="image-20220526135940-16.png"]] | ||
147 | |||
148 | |||
149 | = 3. Configure LoRaWAN node connection to IoTConnect = | ||
150 | |||
151 | |||
152 | Following is an example for how to join the IoTConnect LoRaWAN Network. | ||
153 | |||
154 | The gateway is already set up to connect to the IoTConnect, so we now need to configure the IoTConnect server. | ||
155 | |||
156 | **We take LHT65N as an example.** | ||
157 | |||
158 | Create a device in Chirp Wireless with the OTAA keys from **LHT65N**. | ||
159 | |||
160 | Each **LHT65N** is shipped with a sticker with the default device EUI as below: | ||
161 | |||
162 | [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS02%20-%20LoRaWAN%20Door%20Sensor%20User%20Manual/WebHome/image-20230426084924-1.png?width=493&height=229&rev=1.1||alt="image-20230426084924-1.png"]] | ||
163 | |||
164 | |||
165 | To create a LoRaWAN device for your organization: | ||
166 | |||
167 | 1. From the left navigation, mouseover the **Devices** module. Click **Wireless Device**. | ||
168 | 1. Along the top and toward the right, select Create **Device**. | ||
169 | 1. Enter data in the following fields: | ||
170 | |||
171 | [[image:image-20240401110347-11.png||height="759" width="1051"]] | ||
172 | |||
173 | |||
174 | * **Transmission type:** Select for LoRaWAN. | ||
175 | * **Unique ID:** Enter the unique ID of a device. | ||
176 | * **Display Name:** Enter the display name for a device. | ||
177 | * **Device Profile Name:** A descriptive name of your choice for this profile, e.g. “Workshop device profile of “. | ||
178 | * **DevEUI:** Unique identifier assigned by the manufacturer. | ||
179 | * **AppEUI:** Shared secret between device and the application. | ||
180 | * **AppKey:** Uniquely identifies a join server (was renamed to JoinEUI in OTAA v.1.1). | ||
181 | * **Max EIRP:** Please enter the default value 15. | ||
182 | * **Class Specification:** Select your choice of Class A, Class B, Class C. | ||
183 | * **Gateway:** Select the associate gateway. | ||
184 | * **Mac version:** This parameter should specify the most recent version of LoRaWAN specification supported by your device. Unless device documentation states otherwise, please select 1.0.3. | ||
185 | * **Regional Parameters Version:** Please select RP002-1.0.1, unless specified otherwise in your device documentation. | ||
186 | * **Device Manufacturer:**Select your device OEM. | ||
187 | * **Entity:** Select the entity for your device. | ||
188 | * **Template:** Select the template for your device. | ||
189 | * **Notes:** You can add required notes for a device. | ||
190 | |||
191 | When the lorawan node successfully connects to IoTConnect, the user can check in the **Live Data** interface | ||
192 | |||
193 | [[image:image-20240401111020-13.png||height="651" width="1261"]] |