Wiki source code of AVNET/IOTConnect
Last modified by Kilight Cao on 2024/04/01 11:11
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 | 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. | ||
11 | |||
12 | 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. | ||
13 | |||
14 | In this guide, you will learn how to connect a dragino gateway to the LNS solution provided by AVNET/IOTConnect. | ||
15 | |||
16 | |||
17 | == 1.2 Login or crate an account == | ||
18 | |||
19 | |||
20 | **[[Login or crate an account>>https://subscription.iotconnect.io/subscribe]]**to get started with IoTConnect and start using IoTConnect Console. | ||
21 | |||
22 | Once you have an account,get started by following steps for adding Gateway,Device and Intergrations. | ||
23 | |||
24 | |||
25 | == 1.3 List the support products and Requirements == | ||
26 | |||
27 | |||
28 | LoRaWAN Gateway model: Existing Gateway | ||
29 | |||
30 | |||
31 | = 2. Configure Gateway connection to IoTConnect = | ||
32 | |||
33 | (% style="color:blue" %)**Below list the support products and Requirements:** | ||
34 | |||
35 | 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]] | ||
36 | |||
37 | (% style="color:blue" %)**What do you need to prepare?** | ||
38 | |||
39 | A gateway that can access the internet normally. | ||
40 | |||
41 | |||
42 | 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/]] | ||
43 | |||
44 | |||
45 | == Step 1. Log in IoTConnect == | ||
46 | |||
47 | 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]] | ||
48 | |||
49 | (% class="wikigeneratedid" id="H" %) | ||
50 | [[image:image-20240401101022-1.png||height="598" width="1107"]] | ||
51 | |||
52 | == Step 2. Create a template == | ||
53 | |||
54 | To create a template for your organization: | ||
55 | |||
56 | 1. From the left navigation, mouseover the **Devices** module. In the middle and toward the down, select **Templates**. | ||
57 | 1. Along the top and toward the right, select **Create Template**. | ||
58 | 1. Enter data in the following fields: | ||
59 | |||
60 | * | ||
61 | ** **Template Code**: Enter a unique code for the template. Once entered, you cannot change. | ||
62 | ** **Template Name**: Enter a unique name for the template. | ||
63 | ** **Authentication Type**: We offer a X.509 authentication to secure online communications and verify the identity of individuals or devices on a network. | ||
64 | ** **Device Message Version**: Select the **device message version.** The platform displays the data type while editing a template based on a device message version. | ||
65 | |||
66 | 4. Click **Save** to create a template. | ||
67 | |||
68 | [[image:image-20240401102119-2.png||height="581" width="1126"]] | ||
69 | |||
70 | [[image:https://docs.iotconnect.io/wp-content/uploads/2023/12/Create-Template-1.png||alt="img" height="194" width="1126"]] | ||
71 | |||
72 | |||
73 | 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. | ||
74 | |||
75 | [[image:image-20240401102658-3.png||height="583" width="1131"]] | ||
76 | |||
77 | |||
78 | == Step 3. Create a LoRaWAN Gateway == | ||
79 | |||
80 | To create a LoRaWAN gatway device for your organization: | ||
81 | |||
82 | 1. From the left navigation, mouseover the **Devices** module. Click **Wireless Device**. | ||
83 | 1. Along the bottom center toward the left, select **LoRaWAN gateway.** | ||
84 | 1. Enter data in the following fields: | ||
85 | |||
86 | [[image:image-20240401103307-5.png||height="592" width="1147"]] | ||
87 | |||
88 | * | ||
89 | ** **Gateway Name:** Enter the display name for a Gateway device. | ||
90 | ** **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** | ||
91 | ** **Frequency Band:** Choose a frequency band for the geographic region e.g. US915 for North America, EU868 for Europe. | ||
92 | |||
93 | 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: | ||
94 | |||
95 | * **<gateway id>.cert.pem:** Gateway device certificate file. | ||
96 | * **<gateway id>.private.key:** Gateway device private key file. | ||
97 | |||
98 | [[image:image-20240401103615-6.png||height="355" width="1138"]] | ||
99 | |||
100 | |||
101 | 4.CUPS URI and LNS URI can be found on the **Settings~-~->Key Vaylt** interface | ||
102 | |||
103 | 5.Download **Server Trust Certificates** | ||
104 | |||
105 | [[image:image-20240401104152-8.png||height="589" width="1142"]] | ||
106 | |||
107 | [[image:image-20240401104653-9.png||height="588" width="1140"]] | ||
108 | |||
109 | == Step 4. Access the gateway GUI == | ||
110 | |||
111 | 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. | ||
112 | |||
113 | Users need to fill in the LNS URI and upload the Certificate. | ||
114 | |||
115 | [[image:image-20240401103813-7.png||height="688" width="1082"]] | ||
116 | |||
117 | |||
118 | == Step 5. Configure Station == | ||
119 | |||
120 | Users need to fill in the CUPS URI, LNS URI and upload the Certificate. | ||
121 | |||
122 | (% 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 | ||
123 | |||
124 | Users can now use Amazon IoT Basic Station for testing. | ||
125 | |||
126 | [[image:image-20240401105010-10.png||height="691" width="1112"]] | ||
127 | |||
128 | |||
129 | == Trouble Shooting == | ||
130 | |||
131 | User can check the station log in the(% style="color:blue" %)** LogRead ~-~-> System Log **(%%)page. | ||
132 | |||
133 | [[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"]] | ||
134 | |||
135 | |||
136 | |||
137 | and recode the station log in the(% style="color:blue" %)** LogRead ~-~-> Recode Log**(%%) page. | ||
138 | |||
139 | [[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"]] | ||
140 | |||
141 | |||
142 | = 3. Configure LoRaWAN node connection to IoTConnect = | ||
143 | |||
144 | Following is an example for how to join the IoTConnect LoRaWAN Network. | ||
145 | |||
146 | The gateway is already set up to connect to the IoTConnect, so we now need to configure the IoTConnect server. | ||
147 | |||
148 | **We take LHT65N as an example.** | ||
149 | |||
150 | |||
151 | Create a device in Chirp Wireless with the OTAA keys from **LHT65N**. | ||
152 | |||
153 | Each **LHT65N** is shipped with a sticker with the default device EUI as below: | ||
154 | |||
155 | [[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"]] | ||
156 | |||
157 | |||
158 | To create a LoRaWAN device for your organization: | ||
159 | |||
160 | 1. From the left navigation, mouseover the **Devices** module. Click **Wireless Device**. | ||
161 | 1. Along the top and toward the right, select Create **Device**. | ||
162 | 1. Enter data in the following fields: | ||
163 | |||
164 | [[image:image-20240401110347-11.png||height="759" width="1051"]] | ||
165 | |||
166 | |||
167 | * **Transmission type:** Select for LoRaWAN. | ||
168 | * **Unique ID:** Enter the unique ID of a device. | ||
169 | * **Display Name:** Enter the display name for a device. | ||
170 | * **Device Profile Name:** A descriptive name of your choice for this profile, e.g. “Workshop device profile of “. | ||
171 | * **DevEUI:** Unique identifier assigned by the manufacturer. | ||
172 | * **AppEUI:** Shared secret between device and the application. | ||
173 | * **AppKey:** Uniquely identifies a join server (was renamed to JoinEUI in OTAA v.1.1). | ||
174 | * **Max EIRP:** Please enter the default value 15. | ||
175 | * **Class Specification:** Select your choice of Class A, Class B, Class C. | ||
176 | * **Gateway:** Select the associate gateway. | ||
177 | * **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. | ||
178 | * **Regional Parameters Version:** Please select RP002-1.0.1, unless specified otherwise in your device documentation. | ||
179 | * **Device Manufacturer:**Select your device OEM. | ||
180 | * **Entity:** Select the entity for your device. | ||
181 | * **Template:** Select the template for your device. | ||
182 | * **Notes:** You can add required notes for a device. | ||
183 | |||
184 | When the lorawan node successfully connects to IoTConnect, the user can check in the **Live Data** interface | ||
185 | |||
186 | [[image:image-20240401111020-13.png||height="651" width="1261"]] |