Changes for page Losant

Last modified by Xiaoling on 2023/04/11 08:54

From version 24.6
edited by Xiaoling
on 2023/04/11 08:52
Change comment: There is no comment for this version
To version 24.1
edited by Xiaoling
on 2022/09/05 11:04
Change comment: Uploaded new attachment "image-20220905110438-1.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -5,25 +5,26 @@
5 5  
6 6  = 1.  Indoor Tracking Examples base on iBeacon =
7 7  
8 +
8 8  == 1.1  Create a Losant Webhook ==
9 9  
10 10  
11 11  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/]].
12 12  
13 -Once you've created a new application, click (% style="color:blue" %)**Webhooks** (%%)and then (% style="color:blue" %)**Add Webhook**.
14 +Once you've created a new application, click **(% style="color:blue" %)Webhooks** (%%)and then **(% style="color:blue" %)Add Webhook**.
14 14  
15 -
16 16  [[image:image-20220905084626-2.png]]
17 17  
18 18  
19 19  
20 -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]].
21 21  
21 +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]].
22 22  
23 23  [[image:image-20220905084724-3.png]]
24 24  
25 25  
26 26  
27 +
27 27  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/]]
28 28  
29 29  
... ... @@ -30,32 +30,34 @@
30 30  [[image:image-20220905084736-4.png]]
31 31  
32 32  
33 -== 1.2  Configure TTS to Use the Losant Webhook ==
34 34  
35 35  
36 -In the TTS application , click on (% style="color:blue" %)**Integrations**(%%), then (% style="color:blue" %)**Webhooks**(%%), and then (% style="color:blue" %)**Add webhook**.
36 +== 1.2  Configure TTS to Use the Losant Webhook ==
37 37  
38 38  
39 +In the TTS application , click on **(% style="color:blue" %)Integrations**(%%), then **(% style="color:blue" %)Webhooks**(%%), and then **(% style="color:blue" %)Add webhook**.
40 +
39 39  [[image:image-20220905084816-5.png]]
40 40  
41 41  
42 42  
43 -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]].
44 44  
46 +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]].
45 45  
46 46  [[image:image-20220905084846-6.png]]
47 47  
48 48  
51 +
49 49  Enter the following information into the Losant Webhook configuration:
50 50  
51 -* (% 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.
52 -* (% 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.
54 +* **(% 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.
55 +* **(% 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.
53 53  
57 +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]].
54 54  
55 -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]].
59 +[[image:image-20220905084936-7.png]]
56 56  
57 57  
58 -[[image:image-20220905084936-7.png]]
59 59  
60 60  
61 61  == 1.3  Create a Losant Application Workflow to Receive Data from the LoRaWAN Sensor and Confirm Data Flow to Losant via Uplinks ==
... ... @@ -63,33 +63,35 @@
63 63  
64 64  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.
65 65  
66 -Click on (% style="color:blue" %)**Workflows**(%%) and then in the Application Workflow section, click (% style="color:blue" %)**Add** (%%)to create a new Application Workflow.
69 +Click on **(% style="color:#037691" %)Workflows**(%%) and then in the Application Workflow section, click **(% style="color:#037691" %)Add** (%%)to create a new Application Workflow.
67 67  
68 -
69 69  [[image:image-20220905085017-8.png]]
70 70  
71 71  
72 -Enter a name for your Application Workflow (as well as a description if you'd like) and click (% style="color:blue" %)**Create Workflow**.
73 73  
74 74  
76 +Enter a name for your Application Workflow (as well as a description if you'd like) and click **Create Workflow**.
77 +
75 75  [[image:image-20220905091131-22.png]]
76 76  
77 77  
78 -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]].
79 79  
82 +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 **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]].
80 80  
81 81  [[image:image-20220905085051-10.png]]
82 82  
83 83  
87 +
84 84  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.
85 85  
86 86  
87 -(% 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.
91 +**(% 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.
88 88  
89 -
90 90  [[image:image-20220905085115-11.png]]
91 91  
92 92  
96 +
97 +
93 93  == 1.4  Create a device ==
94 94  
95 95  
... ... @@ -96,44 +96,48 @@
96 96  [[image:image-20220905085132-12.png]]
97 97  
98 98  
99 -**Select the appropriate equipment. In this example, select a Standalone equipment**
100 100  
105 +
106 +Select the appropriate equipment. In this example, select a Standalone equipment
107 +
101 101  [[image:image-20220905085201-13.png]]
102 102  
103 103  
104 104  
105 -**Name is required, others can be added later**
106 106  
113 +Name is required, others can be added later
107 107  
108 108  [[image:image-20220905085219-14.png]]
109 109  
110 110  
111 -**Add equipment in the workflow so that data can flow to the equipment**
112 112  
119 +
120 +Add equipment in the workflow so that data can flow to the equipment
121 +
113 113  [[image:image-20220905085236-15.png]]
114 114  
115 115  
116 116  
117 -**Refer to the data in debug and add parameters to the device.**
118 118  
127 +Refer to the data in debug and add parameters to the device
128 +
119 119  [[image:image-20220905085253-16.png]]
120 120  
121 121  
122 122  
123 -**Create a new dashboard.**
133 +Create a new dashboard
124 124  
125 -
126 126  [[image:image-20220905085323-17.png]]
127 127  
128 128  
129 129  
130 -[[image:image-20220905110438-1.png]]
131 131  
132 132  
141 +[[image:image-20220905085337-18.png]]
133 133  
134 134  
135 -Select the appropriate template.
136 136  
145 +Select the appropriate template
137 137  
138 138  [[image:image-20220905085355-19.png]]
139 139  
... ... @@ -140,8 +140,8 @@
140 140  
141 141  
142 142  
143 -Set beacon and position.
144 144  
153 +Set beacon and position
145 145  
146 146  [[image:image-20220905085417-20.png]]
147 147