Skip to Content

Wiki source code of Losant

Version 24.4 by Xiaoling on 2022/09/05 11:07
Hide last authors
Xiaoling 23.2 1 **Table of Contents:**
2
3 {{toc/}}
4
5
Xiaoling 8.2 6 = 1.  Indoor Tracking Examples base on iBeacon =
7
8
Xiaoling 23.5 9 == 1.1  Create a Losant Webhook ==
Xiaoling 23.2 10
Xiaoling 8.2 11
12 If you do not have a Losant Account, you can sign up for a free [[Losant Developer Sandbox>>url:https://www.losant.com/iot-platform/sandbox]] account. Once you have an account, [[create a new application>>url:https://docs.losant.com/applications/overview/#creating-applications]]. You can start from a blank application or from a [[Losant Application Template>>url:https://docs.losant.com/templates/overview/]], like [[The Things Network Application Template>>url:https://docs.losant.com/templates/the-things-network/]].
13
Xiaoling 24.2 14 Once you've created a new application, click (% style="color:blue" %)**Webhooks** (%%)and then (% style="color:blue" %)**Add Webhook**.
Xiaoling 8.2 15
Xiaoling 24.4 16
Xiaoling 8.2 17 [[image:image-20220905084626-2.png]]
18
19
20
Xiaoling 23.2 21
Xiaoling 24.2 22 Enter a (% style="color:blue" %)**Webhook Name**(%%) and then click (% style="color:blue" %)**Create Webhook**(%%). You may also enter a username and password to use Basic Auth. If you use Basic Auth, you will need to [[edit your Losant Webhook in TTS>>url:https://docs.losant.com/guides/how-to-integrate-with-the-things-stack/#editing-your-losant-webhook-in-tts]].
Xiaoling 23.2 23
Xiaoling 24.4 24
Xiaoling 8.2 25 [[image:image-20220905084724-3.png]]
26
27
Xiaoling 23.2 28
29
Xiaoling 8.2 30 Once the Webhook is created, copy the unique identifier from the URL that comes after [[https:~~/~~/triggers.losant.com/webhooks/.>>url:https://triggers.losant.com/webhooks/]]
31
Xiaoling 23.2 32
Xiaoling 8.2 33 [[image:image-20220905084736-4.png]]
34
35
36
37
Xiaoling 23.5 38 == 1.2  Configure TTS to Use the Losant Webhook ==
Xiaoling 8.2 39
40
Xiaoling 24.2 41 In the TTS application , click on (% style="color:blue" %)**Integrations**(%%), then (% style="color:blue" %)**Webhooks**(%%), and then (% style="color:blue" %)**Add webhook**.
Xiaoling 8.2 42
Xiaoling 24.4 43
Xiaoling 8.2 44 [[image:image-20220905084816-5.png]]
45
46
47
48
Xiaoling 24.2 49 Click on the [[Losant Webhook>>url:https://www.thethingsindustries.com/docs/integrations/cloud-integrations/losant/]] tile. If you are using Basic Auth for this Webhook or need to subscribe to more than just (% style="color:blue" %)**uplink**(%%) messages, then please review the end of this How-To Guide in the section named [[Editing Your Losant Webhook in TTS>>url:https://docs.losant.com/guides/how-to-integrate-with-the-things-stack/#editing-your-losant-webhook-in-tts]].
Xiaoling 23.2 50
Xiaoling 24.4 51
Xiaoling 8.2 52 [[image:image-20220905084846-6.png]]
53
54
55
56 Enter the following information into the Losant Webhook configuration:
57
Xiaoling 24.2 58 * (% style="color:blue" %)**Webhook ID:**(%%) Make up any name that you would like. This does not have to be the ID of the webhook as it is stored in Losant.
59 * (% style="color:blue" %)**Unique ID of Losant Webhook URL:**(%%) This is the Losant Webhook unique ID that was copied to the clipboard in LOSANT Webhooks.
Xiaoling 8.2 60
Xiaoling 24.2 61 Finally, click (% style="color:blue" %)**Create Losant webhook**(%%). If you need to configure additional options ((% style="color:red" %)e.g. Basic Auth or additional messages to subscribe to)(%%), use the TTS Custom Webhook Template or add these options once the Webhook in TTS is created by following the last section of this guide, [[Editing Your Losant Webhook in TTS>>url:https://docs.losant.com/guides/how-to-integrate-with-the-things-stack/#editing-your-losant-webhook-in-tts]].
Xiaoling 8.2 62
Xiaoling 24.4 63
Xiaoling 8.2 64 [[image:image-20220905084936-7.png]]
65
66
67
68
Xiaoling 23.5 69 == 1.3  Create a Losant Application Workflow to Receive Data from the LoRaWAN Sensor and Confirm Data Flow to Losant via Uplinks ==
Xiaoling 8.2 70
Xiaoling 22.2 71
Xiaoling 23.2 72 Since TTS is now configured to forward data to the Losant Webhook, let's create a [[Losant Application Workflow>>url:https://docs.losant.com/workflows/application-workflows/]] to receive the data from TTS.
Xiaoling 8.2 73
Xiaoling 24.2 74 Click on (% style="color:blue" %)**Workflows**(%%) and then in the Application Workflow section, click (% style="color:blue" %)**Add** (%%)to create a new Application Workflow.
Xiaoling 8.2 75
Xiaoling 24.2 76
Xiaoling 22.2 77 [[image:image-20220905085017-8.png]]
78
Xiaoling 8.2 79
80
Xiaoling 22.2 81
Xiaoling 24.2 82 Enter a name for your Application Workflow (as well as a description if you'd like) and click (% style="color:blue" %)**Create Workflow**.
Xiaoling 22.2 83
Xiaoling 23.2 84 [[image:image-20220905091131-22.png]]
Xiaoling 8.2 85
Xiaoling 23.2 86
87
Xiaoling 24.4 88
Xiaoling 24.2 89 Drag and drop the [[Webhook Trigger Node>>url:https://docs.losant.com/workflows/triggers/webhook/]] and the [[Debug Node>>url:https://docs.losant.com/workflows/outputs/debug/]] onto the visual workflow engine's canvas and connect them together. If you have only one webhook in this Losant application, it will be automatically selected for the Webhook Trigger. If you have multiple webhooks, select the one that was created in Webhook. Next, click (% style="color:blue" %)**Save and Deploy**(%%). Now that this workflow is deployed, click on the [[Debug Panel>>url:https://docs.losant.com/workflows/debugging-workflows/#debug-node-messages]].
Xiaoling 23.2 90
Xiaoling 24.4 91
Xiaoling 22.2 92 [[image:image-20220905085051-10.png]]
93
Xiaoling 8.2 94
Xiaoling 23.2 95
Xiaoling 8.2 96 When TTS receives new data from the sensor, it will send that data to Losant over the Losant Webhook and trigger this workflow. Each time this workflow runs, new data will be displayed in the Debug Panel as shown below.
97
98
Xiaoling 24.2 99 (% style="color:red" %)**Note:**(%%) If TTS is not automatically decoding your data as shown below in(% style="color:blue" %)** data.body.uplink_message.decoded_payload**(%%), then you can decode your LoRaWAN device data in this Losant Application Workflow. Check out the blog post [[How To Decode and Visualize Your LoRaWAN Sensor Data Using TTS and Losant>>url:https://www.losant.com/blog/how-to-decode-and-visualize-your-lorawan-sensor-data-using-the-things-network-and-losant]] to learn more about decoding LoRaWAN data in Losant.
Xiaoling 23.2 100
Xiaoling 24.2 101
Xiaoling 22.2 102 [[image:image-20220905085115-11.png]]
103
104
105
Xiaoling 8.2 106
Xiaoling 23.5 107 == 1.4  Create a device ==
Xiaoling 8.2 108
Xiaoling 22.2 109
110 [[image:image-20220905085132-12.png]]
111
112
Xiaoling 8.2 113
Xiaoling 23.2 114
Xiaoling 8.2 115 Select the appropriate equipment. In this example, select a Standalone equipment
116
Xiaoling 24.2 117
Xiaoling 22.2 118 [[image:image-20220905085201-13.png]]
119
Xiaoling 8.2 120
Xiaoling 23.2 121
122
Xiaoling 8.2 123 Name is required, others can be added later
124
Xiaoling 24.2 125
Xiaoling 22.2 126 [[image:image-20220905085219-14.png]]
127
Xiaoling 8.2 128
Xiaoling 23.2 129
130
Xiaoling 8.2 131 Add equipment in the workflow so that data can flow to the equipment
132
Xiaoling 24.2 133
Xiaoling 22.2 134 [[image:image-20220905085236-15.png]]
135
Xiaoling 8.2 136
Xiaoling 23.2 137
138
Xiaoling 24.2 139 Refer to the data in debug and add parameters to the device.
Xiaoling 8.2 140
Xiaoling 24.2 141
Xiaoling 23.2 142 [[image:image-20220905085253-16.png]]
Xiaoling 22.2 143
144
Xiaoling 23.2 145
Xiaoling 8.2 146
Xiaoling 24.2 147 Create a new dashboard.
Xiaoling 22.2 148
Xiaoling 8.2 149
Xiaoling 24.2 150 [[image:image-20220905085323-17.png]]
Xiaoling 8.2 151
Xiaoling 22.2 152
Xiaoling 23.2 153
Xiaoling 24.2 154 [[image:image-20220905110438-1.png]]
Xiaoling 23.2 155
156
157
Xiaoling 8.2 158
Xiaoling 24.3 159 Select the appropriate template.
160
161
Xiaoling 22.2 162 [[image:image-20220905085355-19.png]]
163
Xiaoling 8.2 164
Xiaoling 23.2 165
166
Xiaoling 24.3 167 Set beacon and position.
Xiaoling 23.2 168
Xiaoling 8.2 169
Xiaoling 22.2 170 [[image:image-20220905085417-20.png]]
171
172
173
174 [[image:image-20220905085437-21.png]]
175
Xiaoling 8.2 176
177
Xiaoling 24.3 178