Skip to Content

Wiki source code of Notes for Helium

Version 99.1 by Kilight Cao on 2023/03/20 14:32
Hide last authors
Xiaoling 88.2 1 **~ Table of Contents:**
Xiaoling 1.1 2
Xiaoling 57.7 3 {{toc/}}
Xiaoling 1.1 4
5
Xiaoling 57.9 6
7
Xiaoling 88.3 8 = **1.  Use Dragino Gateways/Hotspots with Helium** =
Xiaoling 1.1 9
Xiaoling 88.3 10 == **1.1  Support Models** ==
Xiaoling 1.1 11
Xiaoling 88.3 12
Kilight Cao 81.1 13 //There are three types of hotspots that can connect to Helium. They are (% style="color:#4f81bd" %)**full-hotspot**(%%), (% style="color:#4f81bd" %)**light hotspot** (%%)and (% style="color:#4f81bd" %)**data-only hotspot**(%%). Definition of these three types of hotspots can be found here: [[of Helium Hotspots>>url:https://docs.helium.com/mine-hnt%7CTypes]]. Different hotspots support different mining abilities.//
Xiaoling 1.1 14
Xiaoling 1.18 15 (((
Kilight Cao 81.1 16 //Dragino has different gateway models that support different types.//
Xiaoling 1.18 17 )))
Xiaoling 1.1 18
Xiaoling 57.3 19 (% border="1" style="background-color:#ffffcc; width:510px" %)
Xiaoling 36.4 20 |(% colspan="4" style="width:589px" %)(% style="color:green" %)**Dragino Hotspots for Helium**
21 |(% style="color:green; width:132px" %)**Model**|(% style="color:green; width:126px" %)**Hotspot Types**|(% style="color:green; width:121px" %)**Mining Ability**|(% style="color:green; width:203px" %)**Configure Instruction**
22 |(% style="width:132px" %)(((
Xiaoling 36.3 23 [[LPS8>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[DLOS8>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]],
24
25 [[LG308>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]],[[LIG16>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/171-lig16.html]]
Xiaoling 88.10 26 )))|(% style="color:#4f81bd; width:126px" %)**Data-Only Hotspot**|(% style="width:121px" %)[[Helium Link>>url:https://docs.helium.com/mine-hnt/data-only-hotspots]]|(% style="width:203px" %)[[Data-Only Hotspot Instruction>>||anchor="H2.A0ConnectData-OnlyHotspottoHelium"]]
Xiaoling 57.16 27 |(% style="width:132px" %)[[HP0D>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/195-hp0d.html]]|(% style="color:#4f81bd; width:126px" %)**Full Hotspo**t|(% style="width:121px" %)[[Helium Link>>url:https://docs.helium.com/mine-hnt/full-hotspots]]|(% style="color:green; width:203px" %)[[Full Hotspot Instuction-Not Finish>>doc:Main.User Manual for All Gateway models.HP0D.WebHome]]
Xiaoling 1.1 28
Xiaoling 88.11 29 (% style="color:blue" %)**Frequencies on the Helium Network**
Xiaoling 1.1 30
Kilight Cao 82.1 31 * //The frequencies currently available are CN470/EU868/US915/AU915//
Xiaoling 1.1 32
Kilight Cao 81.1 33 (% style="color:red" %)**Note: more information refer to this link [[Helium Frequency plan>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans/]]**
Xiaoling 1.1 34
Xiaoling 37.4 35
Xiaoling 88.4 36
Xiaoling 88.3 37 = **2.  Connect Data-Only Hotspot to Helium** =
Xiaoling 1.1 38
Xiaoling 88.3 39 == **2.1  Prerequisites** ==
Xiaoling 1.1 40
Xiaoling 1.2 41
Kilight Cao 82.1 42 * //Firmware Requirement: > [[lgw~~-~~-build-v5.4.1640315898>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]//
Xiaoling 1.2 43
Xiaoling 97.2 44
Xiaoling 88.4 45 == **2.2  Step 1: Configure Frequency Band** ==
46
47
Kilight Cao 82.1 48 //Each country has a requirement for frequency region. Choose the right one for your area.//
49
Xiaoling 61.2 50 [[image:image-20220531175337-1.png]]
Xiaoling 1.2 51
52
Xiaoling 37.4 53
Xiaoling 88.4 54 == **2.3  Step 2: Download the Helium-gateway-rs** ==
Xiaoling 1.2 55
Xiaoling 88.4 56
Kilight Cao 82.1 57 //Click Download Helium Server and the gateway will download the Helium-gateway-rs//
Xiaoling 1.2 58
Xiaoling 97.2 59
Kilight Cao 82.1 60 [[image:image-20220615150600-1.png||height="559" width="1045"]]
Xiaoling 1.2 61
Kilight Cao 84.1 62
Kilight Cao 82.1 63 //**Start download to Helium-gateway-rs**//
Xiaoling 1.2 64
Kilight Cao 82.1 65 [[image:image-20220615150627-2.png||height="598" width="1044"]]
Xiaoling 1.2 66
Kilight Cao 82.1 67 //**Helium-gatewayrs download success**//
Xiaoling 1.2 68
Xiaoling 37.4 69
Kilight Cao 82.1 70 //**If download fails, click and download again**//
Xiaoling 1.2 71
Kilight Cao 82.1 72 [[image:image-20220615150717-3.png||height="605" width="1039"]]
Xiaoling 1.2 73
74
Xiaoling 88.17 75
Xiaoling 88.4 76 == **2.4  Step 3: Install the Helium-gateway-rs** ==
Xiaoling 37.4 77
Xiaoling 1.2 78
Kilight Cao 82.1 79 //Click **Install Helium Server** to install gateway-rs.//
Xiaoling 1.2 80
Kilight Cao 82.1 81 [[image:image-20220615150734-4.png||height="619" width="1035"]]
Xiaoling 1.2 82
83 Install the Helium gateway-rs
84
Xiaoling 88.5 85
Kilight Cao 82.1 86 (% style="color:red" %)**Note: User will see the echo characters of Helium gateway-rs have been installed successfully.**
Xiaoling 1.2 87
Xiaoling 37.4 88
Xiaoling 1.2 89
Xiaoling 88.5 90 == **2.5  Step 4: Save&start the Helium Server** ==
Kilight Cao 80.1 91
Xiaoling 88.5 92
Kilight Cao 82.1 93 //By default, Region is US915, After configuring the Configure Frequency Band, click Save&Apply on the Helium IoT screen to modify the Region.//
Kilight Cao 80.1 94
Xiaoling 88.17 95
Kilight Cao 82.1 96 [[image:image-20220615150903-5.png||height="592" width="1031"]]
Kilight Cao 80.1 97
Xiaoling 1.2 98
Xiaoling 88.17 99
Xiaoling 88.6 100 //Click (% style="color:red" %)**Save&Apply**(%%) and gateway will start to connect the Helium. The UI shows the connect status.//
Xiaoling 1.2 101
Kilight Cao 82.1 102 [[image:image-20220615151057-6.png||height="580" width="1026"]]
Xiaoling 1.2 103
Xiaoling 37.4 104
Xiaoling 1.2 105
Xiaoling 88.6 106 == **2.6  Step 5: Check Gateway Connection before onboarding** ==
Xiaoling 1.2 107
Xiaoling 88.6 108
Kilight Cao 82.1 109 //A hotspot can transfer data to Helium after finishing step4. We can add a device to Helium and see if the device can join Helium. For example, we add an LGT92 sensor and see below info.//
110
Xiaoling 1.8 111 (((
Kilight Cao 82.1 112 //Check end device event from [[Helium Console>>url:https://staging-console.helium.wtf/]], We can see the LGT92 data arrived Helium via our hotspot.//
Xiaoling 1.8 113 )))
Xiaoling 1.2 114
Xiaoling 57.7 115 [[image:image-20220526094537-1.png||height="395" width="1323"]]
Xiaoling 1.2 116
117
Kilight Cao 82.1 118 (% style="color:red" %)**Note: The hotspot is not valid for search in Helium Console before onboarding.**
Xiaoling 1.2 119
Xiaoling 37.4 120
Xiaoling 1.2 121
Xiaoling 88.7 122 == **2.7  Step 6: Onboarding Data-Only Hotspot** ==
123
124
Edwin Chen 88.1 125 (% style="color:red" %)**Note: Onboarding a Data-Only hotspot is necessary for downlink to work. otherwise, the downlink message for LoRa won't work .**
Xiaoling 1.2 126
Xiaoling 88.7 127
Kilight Cao 82.1 128 //User can refer [[this link>>url:https://docs.helium.com/mine-hnt/data-only-hotspots]] for how to onboarding a data-only hotspot. After onboarding the data-only hotspot, user can see the hotspot on Helium Console.//
Xiaoling 1.2 129
Kilight Cao 82.1 130 //Below are the steps we do as per above link here.//
Xiaoling 1.2 131
Kilight Cao 82.1 132
Xiaoling 1.10 133 (((
Xiaoling 88.13 134 (% style="color:blue" %)//**1. Set up Helium-Wallet in my computer. [[https:~~/~~/docs.helium.com/wallets/cli-wallet>>url:https://docs.helium.com/wallets/cli-wallet]]. and funds this wallet. From this step, we got the wallet info as below.**//
Xiaoling 1.10 135 )))
Xiaoling 1.2 136
Xiaoling 1.8 137 (% class="box" %)
138 (((
139 [root@iZt4n22vqvm7ajogrfiif6Z helium-wallet-v1.6.4-x86-64-linux]# helium-wallet info
140 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
141 ~| Key  | Value  |
142 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
143 ~| Address  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux |
144 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
145 ~| Network  | mainnet  |
146 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
147 ~| Type  | ed25519  |
148 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
Xiaoling 1.9 149 ~| Sharded  | (% style="color:purple" %)false (%%) |
Xiaoling 1.8 150 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
151 ~| PwHash  | Argon2id13  |
152 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
153 ~| Balance  | 18.76580626  |
154 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
155 ~| DC Balance  | 0  |
156 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
157 ~| Securities Balance | 0.00000000  |
158 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
159 )))
Xiaoling 1.2 160
Xiaoling 88.17 161
Xiaoling 1.18 162 (((
Kilight Cao 82.1 163 (% style="color:red" %)**Note: The wallet Address is 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux. and have about 18 HNT balance.**
Xiaoling 1.18 164 )))
Xiaoling 1.2 165
166
Xiaoling 88.7 167
Xiaoling 1.10 168 (((
Xiaoling 88.13 169 (% style="color:blue" %)//**2. Get txn. In the data-only hotspot. run below command to add a hotspot, owner is the owner wallet of this hotspot, payer is the payer to pay transaction cost.**//
Xiaoling 1.10 170 )))
Xiaoling 1.2 171
Xiaoling 1.8 172 (% class="box" %)
173 (((
Xiaoling 1.10 174 root@123123:~~# helium_gateway add ~-~-owner 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux ~-~-payer 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux
Xiaoling 1.9 175
176 {
177 (% style="color:red" %)"address": "146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm",
178
179 (% style="color:red" %)
180 "fee": (% style="color:black" %)65000,
181
182 (% style="color:red" %)
183 "mode": "dataonly",
184
185 (% style="color:red" %)
186 "owner": "13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux",
187
188 (% style="color:red" %)
189 "payer": "13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux",
190
191 (% style="color:red" %)
192 "staking fee"(% style="color:black" %): 1000000,
193
194 (% style="color: red;" %)
195 "txn": "CrMBCiEBcJ9JnnIW50i+xEJRtFRVqyosuR4CzJVf3m7qGEF+WZYNhVgLtajtf4elKPoA3NkvAphTQTACohAXCfSZ5yNupaL/FxaNGQgV+P9UHLWzicPhTh7YVEOl2BOMCEPUDo+wM="
196
197 }
Xiaoling 1.8 198 )))
Xiaoling 1.2 199
Xiaoling 1.10 200 (((
Kilight Cao 83.1 201 //We got the txn info from this step.//
Kilight Cao 82.1 202
203
Xiaoling 88.7 204
Xiaoling 88.13 205 (% style="color:blue" %)//**3. Add Hotspot. In the computer with helium wallet. run below command, replace the txn with the txn you got in above step.**//
Xiaoling 88.7 206
207
Kilight Cao 83.1 208 (% style="color:red" %)**Note: below are two commands, the command without ~-~-commit is the preview mode.**
Kilight Cao 82.1 209
Xiaoling 88.7 210
Kilight Cao 83.1 211 //Check every detail in this mode and run the command with ~-~-commit to commit to the Helium Blockchain.//
Xiaoling 1.10 212 )))
Xiaoling 1.2 213
Xiaoling 1.8 214 (% class="box" %)
215 (((
216 [root@]# helium-wallet hotspots add CrMBCiEBcJ9JnnIW50i+xEJRtFRVqyosuR4CzJVf3m7qGEF+WZYNhVgLtajtf4elKPoA3NkvAphTQTACohAXCfSZ5yNupaL/FxaNGQgV+P9UHLWzicPhTh7YVEOl2BOMCEPUDo+wM=
Xiaoling 1.2 217 Password: [hidden]
Xiaoling 1.11 218 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
219 ~| Key  | Value  |
220 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
221 ~| Address  | 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm  |
222 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
223 ~| Payer  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
224 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
225 ~| Owner  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
226 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
227 ~| Fee (DC)  | 65000  |
228 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
229 ~| Staking fee (DC) | 1000000  |
230 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
231 ~| Hash  | none  |
232 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
Xiaoling 1.9 233 \\Preview mode: use ~-~-commit to submit the transaction to the network
Xiaoling 1.8 234 [root@]# helium-wallet hotspots add CrMBCiEBcJ9JnnIW50i+xEJRtFRVqyosuR4CzJVf3m7qGEF+WZYNhVgLtajtf4elKPoA3NkvAphTQTACohAXCfSZ5yNupaL/FxaNGQgV+P9UHLWzicPhTh7YVEOl2BOMCEPUDo+wM= ~-~-commit
Xiaoling 1.2 235 Password: [hidden]
Xiaoling 1.12 236 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
237 ~| Key  | Value  |
238 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
239 ~| Address  | 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm  |
240 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
241 ~| Payer  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
242 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
243 ~| Owner  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
244 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
245 ~| Fee (DC)  | 65000  |
246 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
247 ~| Staking fee (DC)  | 1000000  |
248 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
249 ~| Hash  | i6BQAI4Ehnd7nb8zfvegprhO2fOI1rj4UEPbAVC2sWk  |
250 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
Xiaoling 1.8 251 )))
Xiaoling 1.2 252
Xiaoling 1.18 253 (((
Xiaoling 88.7 254
255
Xiaoling 88.13 256 (% style="color:blue" %)//**4. Assert Location. In helium Wallet. run below command, note, the ~-~-gateway should input gateway address from step 2.**//
Xiaoling 1.18 257 )))
Xiaoling 1.2 258
Xiaoling 1.8 259 (% class="box" %)
260 (((
261 [root@]# helium-wallet hotspots assert ~-~-gateway 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm ~-~-lat=22.706922 ~-~-lon=114.242538 ~-~-mode dataonly
Xiaoling 1.2 262 Password: [hidden]
Xiaoling 1.13 263 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
264 ~| Key  | Value  |
265 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
266 ~| Address  | 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm |
267 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
268 ~| Location  | 8c411c02148d7ff  |
269 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
270 ~| Payer  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
271 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
272 ~| Nonce  | 1  |
273 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
274 ~| Fee (DC)  | 55000  |
275 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
276 ~| Staking Fee (DC) | 500000  |
277 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
278 ~| Gain (dBi)  | 1.2  |
279 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
280 ~| Elevation  | 0  |
281 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
282 ~| Hash  | none  |
283 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
Xiaoling 1.9 284 \\Preview mode: use ~-~-commit to submit the transaction to the network
Xiaoling 37.3 285 //[root@]# helium-wallet hotspots assert ~-~-gateway 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm ~-~-lat=22.706922 ~-~-lon=114.242538 ~-~-mode dataonly ~-~-commit//
Xiaoling 1.2 286 Password: [hidden]
Xiaoling 1.14 287 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
288 ~| Key  | Value  |
289 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
290 ~| Address  | 146XjfUJXAkthGzBGnifwxWV4tVKyayN76JGZ21TE5jcoUNubJm  |
291 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
292 ~| Location  | 8c411c02148d7ff  |
293 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
294 ~| Payer  | 13oLxfjxcYajvfkxxxxxxxxxxxxxxxxxxxxxfY3yp4cz8r1NNux  |
295 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
296 ~| Nonce  | 1  |
297 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
298 ~| Fee (DC)  | 55000  |
299 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
300 ~| Staking Fee (DC) | 500000  |
301 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
302 ~| Gain (dBi)  | 1.2  |
303 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
304 ~| Elevation  | 0  |
305 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
306 ~| Hash  | P1P8olxrzPJ1f3HWiLxcSincdF5fDLLCt2HbpYBhWwk  |
307 +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+
Xiaoling 1.8 308 )))
Xiaoling 1.2 309
Xiaoling 88.17 310
Xiaoling 1.18 311 (((
Xiaoling 88.7 312 (% style="color:red" %)**Note: The add hotspot and assert location step might need some time to be effect.**
Xiaoling 1.18 313 )))
Xiaoling 1.2 314
Xiaoling 1.15 315 (((
Kilight Cao 83.1 316 //After above steps finish, the mobile helium wallet should be able to show that this hotspot has been added to the helium blockchain.//
Xiaoling 37.4 317
Xiaoling 88.7 318
Xiaoling 37.4 319
Xiaoling 1.15 320 )))
Xiaoling 1.2 321
Xiaoling 88.7 322 == **2.8  Debug Connection** ==
Xiaoling 1.2 323
Xiaoling 88.7 324 === **2.8.1  Check pkt-fwd running Log** ===
Xiaoling 1.2 325
326
Kilight Cao 83.1 327 //This command can check if the LoRa Radio part runs correctly and if the gateway receives LoRa packets from LoRaWAN sensors.//
328
Xiaoling 1.15 329 (((
Kilight Cao 83.1 330 //Below logs shows the gateway receive two LoRaWAN packets.//
Xiaoling 1.15 331 )))
Xiaoling 1.2 332
Xiaoling 1.15 333 (% class="box" %)
334 (((
335 root@123123:~~# logread -f
336 Sun Nov 14 14:28:10 2021 daemon.info lora_pkt_fwd[3145]: INFO~~ [down] PULL_ACK received in 244 ms
Xiaoling 1.2 337 Sun Nov 14 14:28:11 2021 user.notice iot_keep_alive: Internet Access OK: via eth1
338 Sun Nov 14 14:28:11 2021 user.notice iot_keep_alive: use WAN or WiFi for internet access now
Xiaoling 1.15 339 Sun Nov 14 14:28:14 2021 daemon.info lora_pkt_fwd[3145]: PKT_FWD~~ DATA_UNCONF_UP-> {**"DevAddr": "1202EE72", "FCtrl": ["ADR": 1, "ADRACKReq": 0, "ACK": 0, "RFU" : "RFU", "FOptsLen": 0], "FCnt": 16390, "FPort": 2, "MIC": "3D55454B"**}
340 Sun Nov 14 14:28:14 2021 daemon.info lora_pkt_fwd[3145]: RXTX~~ {**"rxpk":[{"tmst":312204124,"time":"2021-11-14T14:28:14.688556Z","chan":0,"rfch":1,"freq":868.100000,"stat":1,"modu":"LORA","datr":"SF12BW125","codr":"4/5","lsnr":-11.2,"rssi":-137,"size":24,"data":"QHLuAhKABkACJg8A5dKDACUrBVNLRVU9"**}]}
341 Sun Nov 14 14:28:16 2021 daemon.info lora_pkt_fwd[3145]: PKT_FWD~~ DATA_UNCONF_UP-> {**"DevAddr": "260BDA6A", "FCtrl": ["ADR": 1, "ADRACKReq": 0, "ACK": 0, "RFU" : "RFU", "FOptsLen": 0], "FCnt": 1382, "FPort": 2, "MIC": "1CA5DAB7"**}
342 Sun Nov 14 14:28:16 2021 daemon.info lora_pkt_fwd[3145]: RXTX~~ {**"rxpk":[{"tmst":313985732,"time":"2021-11-14T14:28:16.446560Z","chan":7,"rfch":0,"freq":867.900000,"stat":1,"modu":"LORA","datr":"SF7BW125","codr":"4/5","lsnr":10.2,"rssi":-93,"size":42,"data":"QGraCyaAZgUCHMiipojXTdASx9QZcIVAQApHArEe+iGqt9pMSJ232qUc"**}]}
Xiaoling 1.2 343 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]:
Xiaoling 1.15 344 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ ~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~# Report at: 2021-11-14 14:28:19 UTC ~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#~#
345 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ ~#~## [UPSTREAM] ~#~##
346 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ # RF packets received by concentrator: 6
347 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ # CRC_OK: 100.00%, CRC_FAIL: 0.00%, NO_CRC: 0.00%
348 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ # RF packets forwarded: 6 (161 bytes)
349 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ # PUSH_DATA datagrams sent: 6 (1493 bytes)
350 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ # PUSH_DATA acknowledged: 0.00%
351 Sun Nov 14 14:28:19 2021 daemon.info lora_pkt_fwd[3145]: REPORT~~ ~#~## [DOWNSTREAM] ~#~##
352 )))
Xiaoling 1.2 353
Xiaoling 37.4 354
Xiaoling 1.2 355
Xiaoling 88.7 356 === **2.8.2  Check gateway-rs Log** ===
Xiaoling 1.2 357
Xiaoling 88.7 358
Kilight Cao 83.1 359 //SSH to gateway and run **logread | grep helium_gateway** to check Gateway-rs running log.//
360
Xiaoling 67.2 361 [[image:image-20220531175809-7.png]]
Xiaoling 1.2 362
363
Xiaoling 88.7 364 (% style="color:red" %)**Note**: **logread is dynamic and FIFO, so helium log might be overwritten by other processes info in system.**
Xiaoling 1.2 365
Xiaoling 37.4 366
Xiaoling 88.17 367
Xiaoling 88.7 368 === **2.8.3  View the public key address and animal name** ===
Xiaoling 1.2 369
Kilight Cao 83.1 370
Xiaoling 1.16 371 (% class="box" %)
372 (((
373 (((
374 (((
375 {{{root@123123:~# helium_gateway key info }}}
376 {
377 )))
378 )))
Xiaoling 1.2 379
Xiaoling 1.16 380 (((
381 (% style="color:red" %){{{"address": "13KmbKLdpDfECx19kB2nX4suSzz3GskA4JVqKHAKiJ89kuyJx8T",}}}
382 {{{"name": "great-mint-lizard"}}}(%%)
383 (% style="color:black" %)}
384 )))
385 )))
386
Xiaoling 68.2 387 [[image:image-20220531175844-8.png]]
Xiaoling 1.2 388
389 Hostpot key and animal name
390
Xiaoling 37.4 391
Xiaoling 1.2 392
Xiaoling 88.7 393 === **2.8.4  Backup/Restor gateway-rs key** ===
394
395
Xiaoling 1.17 396 (((
Kilight Cao 83.1 397 //For the date-only hotspots, the key is the only unique identifier, the users can backup the key by the button of Download. And once the uses upgrade the gateway or the gateway lose the key, the gateway-rs will generate a new key for which the data-only hotspot is the new unit. so if the user would restore to last time which can upload your backup key to the gateway by the button of upload.//
Xiaoling 1.17 398 )))
Xiaoling 1.2 399
Xiaoling 69.2 400 [[image:image-20220531175919-9.png]]
Xiaoling 1.2 401
402
Kilight Cao 99.1 403 === **2.8.5  How to manually download helium gateway-rs via SSH access to the gateway Linux console** ===
Xiaoling 37.4 404
Kilight Cao 99.1 405
406 (% class="box infomessage" %)
407 (((
408 cd /tmp;wget -O helium-gateway-rs-dragino.ipk [[https:~~/~~/github.com/helium/gateway-rs/releases/download/v1.0.0-alpha.33/helium-gateway-v1.0.0-alpha.33-dragino.ipk>>https://github.com/helium/gateway-rs/releases/download/v1.0.0-alpha.33/helium-gateway-v1.0.0-alpha.33-dragino.ipk]]
409
410 opkg install helium-gateway-rs-dragino.ipk
411 )))
412
413 [[image:image-20230320141404-1.png]]
414
415
Xiaoling 88.7 416 == **2.9  Forward the data to the other server** ==
Xiaoling 1.2 417
Xiaoling 88.7 418 === **2.9.1  Introduction** ===
Xiaoling 1.2 419
Kilight Cao 83.1 420
Xiaoling 1.18 421 (((
Kilight Cao 83.1 422 //The Dragino gateway has supports the double server settings.//
Xiaoling 1.18 423 )))
Xiaoling 1.2 424
Xiaoling 1.18 425 (((
Kilight Cao 83.1 426 //Users can back to the page of Semtech UDP to configure other server settings.//
Xiaoling 37.4 427
Xiaoling 88.17 428
Xiaoling 37.4 429
Xiaoling 1.18 430 )))
Xiaoling 1.2 431
Xiaoling 88.7 432 === **2.9.2  Example** ===
Xiaoling 1.2 433
434
Kilight Cao 83.1 435 //The following takes The Things Network as another LoRaWAN server as an example.//
Xiaoling 37.4 436
Xiaoling 1.2 437
Kilight Cao 83.1 438
Xiaoling 88.7 439 ==== (% style="color:blue" %)**Step 1: Back to Semtech UDP page**(%%) ====
Kilight Cao 83.1 440
Xiaoling 88.7 441
Xiaoling 70.2 442 [[image:image-20220531180002-10.png]]
Xiaoling 1.2 443
444 Back to Semtech UDP page
445
Xiaoling 37.4 446
Xiaoling 88.8 447
Xiaoling 88.7 448 ==== (% style="color:blue" %)**Step 2: Configure the double server forwarding**(%%) ====
Xiaoling 1.2 449
Kilight Cao 83.1 450
Xiaoling 71.2 451 [[image:image-20220531180048-11.png]]
Xiaoling 1.2 452
453
Kilight Cao 83.1 454 //The user can configure the secondary server and then click the button of **Save&Apply**.//
Xiaoling 1.2 455
Xiaoling 37.4 456
Xiaoling 88.17 457
Xiaoling 88.8 458 == **2.10  Connect Full Hotspot to Helium** ==
Xiaoling 1.2 459
460
461
Xiaoling 88.8 462 = **3.  Use Dragino Sensors with Helium** =
Xiaoling 1.2 463
464
Xiaoling 88.8 465 == **3.1  How to add up user's end-node with Helium console** ==
Kilight Cao 83.1 466
467
Xiaoling 88.8 468 === **3.1.1  Step 1: Login the Helium console** ===
469
470
Kilight Cao 83.1 471 //User can Login the [[Helium Console>>url:https://staging-console.helium.wtf/]]//
472
Xiaoling 72.2 473 [[image:image-20220531180150-12.png]]
Xiaoling 1.2 474
475 login Helium console
476
Xiaoling 37.4 477
Xiaoling 1.2 478
Xiaoling 88.8 479 === **3.1.2  Step 2: Add up your end-node's key** ===
Xiaoling 1.2 480
Xiaoling 88.8 481
Kilight Cao 83.1 482 //User add up end-node's key from console ~-~->dervice//
483
Xiaoling 73.2 484 [[image:image-20220531180224-13.png]]
Xiaoling 1.2 485
486 To add a device
487
Xiaoling 37.4 488
Xiaoling 1.2 489
Xiaoling 88.8 490 === **3.1.3  Step 3: Activate the end-node** ===
Kilight Cao 83.1 491
Xiaoling 88.8 492
Xiaoling 1.17 493 (((
Kilight Cao 83.1 494 //Users can activate the end-node with OTAA in which the end-node will Join the network from the Helium server **Eventually you will see traffic**//
Xiaoling 1.17 495 )))
Xiaoling 1.2 496
Xiaoling 59.2 497 [[image:image-20220531105239-2.png]]
Xiaoling 1.2 498
499 end-node traffic.
500
Xiaoling 59.2 501
Xiaoling 97.2 502
Edwin Chen 95.1 503 === **3.1.4 Check Raw Payload for End Node** ===
Xiaoling 1.2 504
Xiaoling 97.2 505
Edwin Chen 95.1 506 Users can check what the end node has uplinked by checking the raw payload. as below:
507
Bei Jinggeng 97.1 508 [[image:image-20220912161818-1.png]]
Edwin Chen 95.1 509
510
Xiaoling 97.2 511
Xiaoling 88.8 512 == **3.2  How to use decoder** ==
Xiaoling 1.2 513
Xiaoling 88.8 514 === **3.2.1  Step 1: Users can create decoders on functions** ===
Kilight Cao 83.1 515
Xiaoling 88.8 516
Xiaoling 60.2 517 [[image:image-20220531105325-3.png]]
Xiaoling 1.2 518
519 Decoder.
520
Xiaoling 60.3 521
Xiaoling 1.2 522
Xiaoling 88.8 523 === **3.2.2  Step 2: Add a decoder in functions and apply it to the specified label** ===
Kilight Cao 83.1 524
Xiaoling 88.8 525
Xiaoling 57.7 526 [[image:image-20220526095629-6.png]]
Xiaoling 1.2 527
528
Xiaoling 57.7 529 [[image:image-20220526095553-5.png]]
Xiaoling 1.2 530
Xiaoling 44.2 531
Xiaoling 57.7 532 [[image:image-20220526100057-8.png||height="352" width="1133"]]
Xiaoling 44.2 533
Kilight Cao 83.1 534 **//Add decoder complete.//**
Xiaoling 1.2 535
Xiaoling 44.2 536
Xiaoling 88.8 537
538 === **3.2.3  Where is the decoder？** ===
539
540
Bei Jinggeng 86.1 541 [[console-decoders/Dragino at master · helium/console-decoders · GitHub>>url:https://github.com/helium/console-decoders/tree/master/Dragino]]
542
543 [[image:image-20220617140118-1.png||height="550" width="883"]]
544
Xiaoling 1.2 545
Kilight Cao 83.1 546
Xiaoling 88.8 547 == **3.3  How to send a downlink to end device from Helium** ==
548
549
Xiaoling 1.17 550 (((
Kilight Cao 83.1 551 //The Helium server needs to convert to Base64 format when sending the downlink command. Please refer to the following example~://
Xiaoling 1.17 552 )))
Xiaoling 1.2 553
Xiaoling 1.17 554 (((
Kilight Cao 83.1 555 //The Downlink command comes from this link：[[End Device Downlink Command>>End Device AT Commands and Downlink Command]]//
Xiaoling 1.17 556 )))
Xiaoling 1.2 557
Xiaoling 1.17 558 (((
Kilight Cao 83.1 559 //Change Uplink Interval:Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds//
Xiaoling 1.17 560 )))
Xiaoling 1.2 561
Xiaoling 1.17 562 (% class="box" %)
563 (((
Xiaoling 88.8 564 **01 00 00 3C ~-~-> AQAAPA==**
Xiaoling 1.17 565 )))
Xiaoling 1.2 566
Xiaoling 57.7 567 [[image:image-20220524171341-21.png]]
Xiaoling 1.2 568
569 Downlink
570
Xiaoling 46.2 571
Xiaoling 1.2 572
Xiaoling 88.8 573 == **3.4  How to add integration to different IoT Servers** ==
Xiaoling 1.2 574
Xiaoling 88.8 575 === **3.4.1  TagoIO** ===
Xiaoling 1.2 576
Xiaoling 88.8 577
Kilight Cao 83.1 578 **//The steps to add integration are very simple. Please see the following process.//**
579
580
Xiaoling 57.7 581 [[image:image-20220526102429-23.png||height="630" width="1198"]]
Xiaoling 1.2 582
583
Xiaoling 46.2 584
Kilight Cao 83.1 585 **//Generate the authorization code and then copy it.//**
Xiaoling 1.2 586
Kilight Cao 83.1 587
Xiaoling 57.7 588 [[image:image-20220526100452-10.png||height="314" width="1188"]]
Xiaoling 1.2 589
590
Xiaoling 46.2 591
Kilight Cao 83.1 592 //**Apply Integration to Label.**//
Xiaoling 1.2 593
Kilight Cao 83.1 594
Xiaoling 57.7 595 [[image:image-20220526100802-13.png]]
Xiaoling 1.2 596
Xiaoling 48.2 597
Xiaoling 1.2 598
Xiaoling 57.7 599 [[image:image-20220526100927-14.png]]
Xiaoling 48.2 600
Xiaoling 1.2 601
Xiaoling 48.2 602
Kilight Cao 83.1 603 **//Click LoRaWAN Helium,select the device.//**
Xiaoling 1.2 604
Kilight Cao 83.1 605
Xiaoling 57.7 606 [[image:image-20220526101215-15.png||height="599" width="1117"]]
Xiaoling 1.2 607
608
Xiaoling 50.2 609
Kilight Cao 83.1 610 **//Fill in DEVEUI and create my device.//**
Xiaoling 1.2 611
Kilight Cao 83.1 612
Xiaoling 57.7 613 [[image:image-20220526101419-16.png]]
Xiaoling 1.2 614
615 TagoIO.
616
Xiaoling 50.2 617
Xiaoling 1.2 618
Xiaoling 88.8 619 === **3.4.2  Cayenne** ===
Xiaoling 1.2 620
Xiaoling 88.8 621
Kilight Cao 83.1 622 //The process of creating devices is similar to Tago.//
623
Xiaoling 57.7 624 [[image:image-20220526101616-18.png||height="456" width="1097"]]
Xiaoling 1.2 625
626 Cayenne.
627
628
Xiaoling 57.7 629 [[image:image-20220526101547-17.png||height="656" width="1092"]]
Xiaoling 54.2 630
Xiaoling 1.2 631 Cayenne.
632
633
Xiaoling 57.7 634 [[image:image-20220526101702-19.png||height="528" width="1109"]]
Xiaoling 54.2 635
Xiaoling 1.2 636 Cayenne.
637
Xiaoling 54.2 638
Xiaoling 57.7 639 [[image:image-20220526102303-22.png]]
Xiaoling 1.2 640
641 Cayenne.
642
Xiaoling 54.2 643
Xiaoling 57.7 644 [[image:image-20220526102114-21.png]]
Xiaoling 1.2 645
646 Cayenne.
647
648
Xiaoling 57.7 649 [[image:image-20220526101940-20.png||height="543" width="1044"]]
Xiaoling 54.2 650
Xiaoling 1.2 651 Cayenne.
652
Xiaoling 54.2 653
Xiaoling 1.2 654
Xiaoling 88.8 655 == **3.5  Trouble Shooting** ==
Xiaoling 1.2 656
Kilight Cao 83.1 657
Edwin Chen 93.1 658 === **3.5.1 Data-Only Hotspot is not connecting to Helium console** ===
Xiaoling 88.8 659
Xiaoye 91.1 660
Edwin Chen 93.1 661 //**The Data-only hotspot has finished the software installation and confirmation, But it is not connecting to Helium Console. The possibility is:**//
Xiaoye 91.1 662
663
Edwin Chen 93.1 664 1). The hotspot does not finish the onboarding to the helium blockchain.
Xiaoye 91.1 665
Xiaoye 92.1 666 after the 23 version of the gateway-rs, Helium requests the user to onboarding the devices to the blockchain, otherwise, your devices can't connect to the helium console. ~-~--> Please refer to [[Step 2.7>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Helium/#H2.7A0Step6:OnboardingData-OnlyHotspot]] to do it.
Xiaoye 91.1 667
668
Xiaoling 97.2 669
Edwin Chen 93.1 670 === **3.5.2 End Device can't join Helium via hotspot, stuck in cycle of Joining-Accept. ** ===
Xiaoye 91.1 671
672
Edwin Chen 93.1 673 Make sure your blockchain region is the same as your hotspot settings. For example, as below, the blockchain is CN region, and software is configure to EU. The hotspot is able to get the OTAA Join Request from End Device on EU region. but due to block chain is CN region, Server will send the Join -Accept in CN region, so end device can't get the OTAA Join Accept.
Xiaoye 91.1 674
675
Edwin Chen 93.1 676 For example, if you are in USA, you have to use the US915 frequency plan. More frequency plans details on the helium network: [[https:~~/~~/docs.helium.com/lorawan-on-helium/frequency-plans>>url:https://docs.helium.com/lorawan-on-helium/frequency-plans]]
Xiaoye 91.1 677
678
679
Edwin Chen 93.1 680 === **3.5.3  Trouble to Join Helium** ===
Xiaoye 91.1 681
Edwin Chen 93.1 682
Xiaoling 1.17 683 (((
Kilight Cao 83.1 684 **//Assume the device is powered correctly. If you don't see data in Helium. The possibilities are~://**
685
686
Xiaoling 1.17 687 )))
Xiaoling 1.2 688
Xiaoling 1.17 689 (((
Kilight Cao 83.1 690 //1) You are out of Helium Gateway coverage. (If you have other end nodes, you can check whether they work and what is the signal strength you see in the platform)//
Xiaoling 1.17 691 )))
Xiaoling 1.2 692
Xiaoling 1.17 693 (((
Kilight Cao 83.1 694 //2) Your end node frequency band doesn't match the Helium gateway frequency band. (Please double-check if frequency band matches)//
Xiaoling 1.17 695 )))
Xiaoling 1.2 696
Xiaoling 1.17 697 (((
Kilight Cao 83.1 698 //3) You have input the wrong keys into Helium Platform ( You can send us the screenshots for the keys and Dragino support team can check for you)//
Xiaoling 54.2 699
Xiaoling 97.2 700
Xiaoling 54.2 701
Xiaoling 1.17 702 )))
Xiaoling 1.2 703
Edwin Chen 93.1 704 === **3.5.4  Packet Loss for AU915 / US915 Band** ===
Xiaoling 1.2 705
Kilight Cao 83.1 706
Xiaoling 1.17 707 (((
Kilight Cao 83.1 708 //The node working on the AU915/US915 frequency has packet loss or the frequency channel and the gateway channel are different.//
Xiaoling 1.17 709 )))
Xiaoling 1.2 710
Xiaoling 1.17 711 (((
Kilight Cao 83.1 712 //The reason for this problem is that the node does not lock the channel after joining the network.//
Xiaoling 88.8 713
714
Xiaoling 1.17 715 )))
Xiaoling 1.2 716
Xiaoling 1.17 717 (((
Xiaoling 88.14 718 (% style="color:red" %)**Solution:**
Kilight Cao 83.1 719
720
Xiaoling 1.17 721 )))
Xiaoling 1.2 722
Xiaoling 1.17 723 (((
Kilight Cao 83.1 724 //(1) If the user does not have a device to upgrade the firmware, you can use the AT+CHE command or the downlink command to set the channel. It is best to turn off the adaptive rate (ADR).Reset the device after setting the channel.//
Xiaoling 1.17 725 )))
Xiaoling 1.2 726
Xiaoling 1.17 727 * (((
Xiaoling 88.8 728 (% style="color:blue" %)**//AT Command: AT+CHE//**
Xiaoling 1.17 729 )))
Xiaoling 1.2 730
Xiaoling 1.17 731 * (((
Xiaoling 88.8 732 //**Example: ** (% style="color:#037691" %)**AT+CHE=2**(%%)  ~/~/set channel mode to 1//
Xiaoling 1.17 733 )))
Xiaoling 1.2 734
Xiaoling 1.17 735 * (((
Xiaoling 88.8 736 (% style="color:blue" %)**//Downlink Command: 0x24//**
Xiaoling 88.9 737
738
Xiaoling 1.17 739 )))
Xiaoling 1.2 740
Xiaoling 1.17 741 (((
Kilight Cao 83.1 742 //Format: Command Code (0x24) followed by 1 bytes channel value.//
Xiaoling 1.17 743 )))
Xiaoling 1.2 744
Xiaoling 88.9 745
Xiaoling 1.17 746 (((
Edwin Chen 87.1 747 //If the downlink payload=0x2402, it means set channel mode to use sub-band 2, while type code is 24.//
Xiaoling 1.17 748 )))
Xiaoling 1.2 749
Xiaoling 1.17 750 * (((
Xiaoling 88.8 751 //**Example 1**: Downlink Payload: (% style="color:#037691" %)**0x2402** (%%) ~/~/ set channel mode to 2//
Xiaoling 1.2 752
Kilight Cao 83.1 753
Xiaoling 1.17 754 )))
Xiaoling 1.2 755
Xiaoling 1.17 756 (((
Kilight Cao 83.1 757 //(2) If the user has a device to upgrade the firmware, it is better to upgrade the device to the latest version. The latest version has fixed the problem that the AU915/US915 frequency does not lock the channel.//
Xiaoling 1.17 758 )))
Xiaoling 1.2 759
Xiaoling 1.17 760 (((
Kilight Cao 83.1 761 //The latest firmware for end node will have this bug fixed.//
Edwin Chen 94.1 762
763
Xiaoling 97.2 764
Edwin Chen 94.1 765 === **3.5.5  ADR doesn't work in EU868 band.** ===
766
Xiaoling 97.2 767
Edwin Chen 94.1 768 See possibility reason from this link: [[https:~~/~~/github.com/helium/router/issues/858 >>https://github.com/helium/router/issues/858]]
769
770
771
Xiaoling 1.17 772 )))