Wiki source code of How to creat dashboard for a device?
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 | **Table of Contents:** | ||
| 4 | |||
| 5 | {{toc/}} | ||
| 6 | |||
| 7 | |||
| 8 | = 1. Overview: = | ||
| 9 | |||
| 10 | After device data arrive to the platform via the method of [[Connect Device to ThingsEye>>https://wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F/#]]. We can creat the Dashboard for the specify device. so to view the sensor detail of each device. | ||
| 11 | |||
| 12 | |||
| 13 | Note: We can create only one rule chain, device profile and dashboard for one type of devices. | ||
| 14 | |||
| 15 | |||
| 16 | = 2. For devices which already have dashboard / profile/ rule chain. = | ||
| 17 | |||
| 18 | == 2.1 Get the json files == | ||
| 19 | |||
| 20 | where to get:[[https:~~/~~/github.com/ThingsEye-io/te-platform/tree/main/Devices/Dragino>>path:/xwiki/bin/get/Main/How%20to%20import%20and%20use%20the%20dashboard%3F/?sheet=CKEditor.ResourceDispatcher&outputSyntax=plain&language=&type=doc&reference=&typed=]] | ||
| 21 | |||
| 22 | what files to get:Select the model you need and download three JSON files from it | ||
| 23 | |||
| 24 | Such as: | ||
| 25 | |||
| 26 | * [[sn50v3_nb_mod9_dashboard_.json>>url:https://github.com/ThingsEye-io/te-platform/blob/main/Devices/Dragino/SN50v3-NB-Mod9/sn50v3_nb_mod9_dashboard_.json]] | ||
| 27 | * [[sn50v3_nb_mod9_device_profile.json>>url:https://github.com/ThingsEye-io/te-platform/blob/main/Devices/Dragino/SN50v3-NB-Mod9/sn50v3_nb_mod9_device_profile.json]] | ||
| 28 | * [[sn50v3_nb_mod9_rule_chain.json>>url:https://github.com/ThingsEye-io/te-platform/blob/main/Devices/Dragino/SN50v3-NB-Mod9/sn50v3_nb_mod9_rule_chain.json]] | ||
| 29 | |||
| 30 | == 2.2 Import Rule chain == | ||
| 31 | |||
| 32 | Firstly, we need to import the rule chain. The rule chain tells platform how we should handel the uplink and downlink for this device. | ||
| 33 | |||
| 34 | Open rule chains, click on the "+" in the upper right corner, | ||
| 35 | |||
| 36 | select "import rule chain", and then drag the downloaded JSON file with the suffix "_rule_chain" into the text box | ||
| 37 | |||
| 38 | * Only need to import once for same type of devices. | ||
| 39 | |||
| 40 | ****[[image:1729040952504-811.png||height="556" width="1138"]] | ||
| 41 | |||
| 42 | [[image:1729066864346-718.png||height="596" width="1140"]] | ||
| 43 | |||
| 44 | == 2.3 Import Device profile and select the rule chain == | ||
| 45 | |||
| 46 | === 2.3.1 Import Device profile === | ||
| 47 | |||
| 48 | At this step, we need to import the device profile first, as shown in the figure. | ||
| 49 | |||
| 50 | First, we need to open the device profiles, click on the "+" in the upper right corner, select "import device profile", | ||
| 51 | |||
| 52 | and then select the file with the suffix "_device_defiles" that we have already downloaded. Drag it into the text box. | ||
| 53 | |||
| 54 | [[image:1729041156898-931.png||height="523" width="1144"]] | ||
| 55 | |||
| 56 | [[image:1729066636027-958.png||height="603" width="1143"]] | ||
| 57 | |||
| 58 | === 2.3.2 Modify the rule chain in the device profiles === | ||
| 59 | |||
| 60 | After importing the rule chain and device profile, we need to link them together. | ||
| 61 | |||
| 62 | At this point, we need to modify the rule chain on the device profiles page. | ||
| 63 | |||
| 64 | In this section, first we need to open the device profiles module again, | ||
| 65 | |||
| 66 | click on the newly imported device profile file, and then click on the top right corner“ 🖊” After entering the editing mode, | ||
| 67 | |||
| 68 | we will see the Default rule chain under the details section. | ||
| 69 | |||
| 70 | Click on it and select the corresponding rule chain we have newly imported, | ||
| 71 | |||
| 72 | then click the "√" in the upper right corner to save it. | ||
| 73 | |||
| 74 | [[image:1729041627624-611.png||height="567" width="1148"]] | ||
| 75 | |||
| 76 | [[image:1729041918618-753.png||height="558" width="1151"]] | ||
| 77 | |||
| 78 | == 2.4 Import Dashboard and link to each device == | ||
| 79 | |||
| 80 | After importing the rule chain and device profile, we need to import the dashboard and configure its datasource. | ||
| 81 | |||
| 82 | === ** **2.4.1 Import dashboard === | ||
| 83 | |||
| 84 | Firstly, we need to open the dashboard module, | ||
| 85 | |||
| 86 | click on the "+" in the upper right corner, select "import dashboard", | ||
| 87 | |||
| 88 | then we shoud drag the downloaded _dashboard file into the text box. | ||
| 89 | |||
| 90 | [[image:1728978901199-201.png||height="591" width="1156"]] | ||
| 91 | |||
| 92 | [[image:1729066158155-749.png||height="603" width="1165"]] | ||
| 93 | |||
| 94 | |||
| 95 | === 2.4.2 Modify the datasource of each module in the dashboard === | ||
| 96 | |||
| 97 | After importing the dashboard, we need to link it with our input device, | ||
| 98 | |||
| 99 | So we need to change the input device of each module in the dashboard , and the corresponding device name is the IMEI of the device we are connected to. | ||
| 100 | |||
| 101 | (For example, if our input device IMEI is 863663062789483, then our input device name is 863663062789483) | ||
| 102 | |||
| 103 | |||
| 104 | In this section, we should first open our newly imported dashboard and click on "Edit mode" in the upper right corner to edit it. | ||
| 105 | |||
| 106 | Afterwards, select the module to be modified and click on the top right corner of the module“ 🖊” Enter the editing interface, | ||
| 107 | |||
| 108 | then find the Datasource section, select the corresponding device name, and click "Apply" in the upper right corner. | ||
| 109 | |||
| 110 | * Need to repeat for every new device. | ||
| 111 | * Make sure the device already creat in the platform. | ||
| 112 | |||
| 113 | [[image:1729042442077-819.png||height="580" width="1160"]] | ||
| 114 | |||
| 115 | [[image:1729042599152-568.png||height="571" width="1166"]] | ||
| 116 | |||
| 117 | [[image:1729042895928-321.png||height="565" width="1165"]] | ||
| 118 | |||
| 119 | Now our dashboard has been successfully imported and the data can be displayed after processing. | ||
| 120 | |||
| 121 | Next, we only need to transfer the data in and we can see the data displayed on the dashboard. | ||
| 122 | |||
| 123 | [[image:1728978901221-951.png||height="591" width="1134"]] | ||
| 124 | |||
| 125 | = 3. For devices doesn't have dashboard / profile/ rule chain. = | ||
| 126 | |||
| 127 | == 2.1 Creat the dashboard and add branch == | ||
| 128 | |||
| 129 | === 2.1.1 Create Dashboard === | ||
| 130 | |||
| 131 | [[image:1730340927404-430.png]] | ||
| 132 | |||
| 133 | [[image:1730340927412-610.png]] | ||
| 134 | |||
| 135 | Assigning users and groups is not necessary and can be done uniformly after completing the overall project creation | ||
| 136 | |||
| 137 | == 2.2 Add a branch == | ||
| 138 | |||
| 139 | [[image:1730341060305-544.png]] | ||
| 140 | |||
| 141 | How many interfaces do you need to display, and how many statuses you need to create. | ||
| 142 | |||
| 143 | [[image:1730341060308-892.png]] | ||
| 144 | |||
| 145 | After creating the branch, you can add widgets into your dashboard and decorate it. | ||
| 146 | |||
| 147 | [[image:1730341060310-449.png]] | ||
| 148 | |||
| 149 | == 2.3 Connect Sensors == | ||
| 150 | |||
| 151 | === 2.3.1 Add LoRaWAN Sensors === | ||
| 152 | |||
| 153 | You can connect the device through the link below: | ||
| 154 | |||
| 155 | **source:**[[https:~~/~~/wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F>>https://wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F/]] | ||
| 156 | |||
| 157 | === 2.3.2 Add NB-IoT Sensors === | ||
| 158 | |||
| 159 | You can connect the device through the link below: | ||
| 160 | |||
| 161 | **source:**[[https:~~/~~/wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F>>https://wiki.thingseye.io/xwiki/bin/view/Main/How%20to%20connect%20my%20devices%20to%20ThingsEye%3F/]] | ||
| 162 | |||
| 163 | == 2.4 Creat group and add device == | ||
| 164 | |||
| 165 | [[image:1730341200415-449.png]] | ||
| 166 | |||
| 167 | [[image:1730341200420-412.png]] | ||
| 168 | |||
| 169 | [[image:1730341200421-190.png]] | ||
| 170 | |||
| 171 | [[image:1730341200424-882.png]] | ||
| 172 | |||
| 173 | == 2.5 Creat entity alias and connect == | ||
| 174 | |||
| 175 | === 2.5.1 Creat entity alias === | ||
| 176 | |||
| 177 | [[image:1730341268104-527.png]] | ||
| 178 | |||
| 179 | [[image:1730341268106-565.png]] | ||
| 180 | |||
| 181 | === 2.5.2 Connect entity === | ||
| 182 | |||
| 183 | [[image:1730341268108-632.png]] | ||
| 184 | |||
| 185 | == 2.6 Creat actions == | ||
| 186 | |||
| 187 | [[image:1730341395062-192.png]] | ||
| 188 | |||
| 189 | [[image:1730341395069-644.png]] | ||
| 190 | |||
| 191 | = 3.Set up Alarm = | ||
| 192 | |||
| 193 | == 3.1 Creat device profiles == | ||
| 194 | |||
| 195 | [[image:1730341507235-819.png||height="636" width="1260"]] | ||
| 196 | |||
| 197 | == 3.2 Set up Alarm == | ||
| 198 | |||
| 199 | [[image:1730341543316-750.png||height="629" width="1260"]] | ||
| 200 | |||
| 201 | [[image:1730341543319-574.png]] | ||
| 202 | |||
| 203 | == 3.3 replace device profile == | ||
| 204 | |||
| 205 | [[image:1730341567947-831.png||height="629" width="1266"]] | ||
| 206 | |||
| 207 | = 4. create rule chain = | ||
| 208 | |||
| 209 | == 4.1 creat rule chain == | ||
| 210 | |||
| 211 | [[image:1730341620059-499.png||height="621" width="1263"]] | ||
| 212 | |||
| 213 | [[image:1730341620061-922.png||height="612" width="1263"]] | ||
| 214 | |||
| 215 | Regarding the rule chain, you can see the relevant explanation below: | ||
| 216 | |||
| 217 | [[https:~~/~~/wiki.thingseye.io/xwiki/bin/view/Main/Basic%20configuration%20of%20rule%20chains/>>https://wiki.thingseye.io/xwiki/bin/view/Main/Basic%20configuration%20of%20rule%20chains/]] | ||
| 218 | |||
| 219 | == 4.2 replace rule chain == | ||
| 220 | |||
| 221 | [[image:1730341620064-656.png||height="628" width="1265"]] | ||
| 222 | |||
| 223 | |||
| 224 | {{{Hope this article can be helpful to you.Good luck to you!}}} |