Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 81.1
edited by Edwin Chen
on 2022/10/22 00:24
Change comment: There is no comment for this version
To version 74.1
edited by Edwin Chen
on 2022/10/11 00:10
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -205,9 +205,7 @@
205 205  
206 206  Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours.
207 207  
208 -Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
209 209  
210 -
211 211  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
212 212  |=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1
213 213  |=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status
... ... @@ -215,13 +215,13 @@
215 215  [[image:1665301570342-765.png]]
216 216  
217 217  
218 -(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
216 +Example of Device Status:  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT52%20-%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220621105116-11.png?rev=1.1||alt="image-20220621105116-11.png"]]
219 219  
220 -(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
218 +**Sensor Model**: For TrackerD, this value is 0x13.
221 221  
222 -(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
220 +**Firmware Version**: 0x0100, Means: v1.0.0 version.
223 223  
224 -(% style="color:#037691" %)**Frequency Band**:
222 +**Frequency Band**:
225 225  
226 226  *0x01: EU868
227 227  
... ... @@ -243,55 +243,20 @@
243 243  
244 244  *0x0a: AS923-3
245 245  
246 -Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
244 +**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
247 247  
248 -(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
246 +**BAT**: shows the battery voltage for TrackerD.
249 249  
248 +Ex1: 0x0B3A = 2874mV
250 250  
251 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
252 -
253 253  Use can also get the Device Status uplink through the downlink command:
254 254  
255 255  
256 256  
257 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
258 -
259 -(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
260 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
262 -
263 -(% style="color:blue" %)** SMOD：**
264 -
265 -(% style="color:red" %)** 1 :** (%%) GPS ONLY
266 -
267 -(% style="color:red" %)** 2 :** (%%) BLE ONLY
268 -
269 -(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
270 -
271 -
272 -(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
273 -
274 -(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
275 -
276 -(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
277 -
278 -
279 -(% style="color:blue" %)** BLE_Settings:**
280 -
281 -(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
282 -
283 -
284 -
285 -(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
286 -
287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %)
288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit
289 -|(% style="width:77px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]]
290 -
291 291  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
292 292  
293 293  
294 -Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,
257 +User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band.
295 295  
296 296  
297 297  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -315,6 +315,7 @@
315 315  |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
316 316  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
317 317  
281 +
318 318  ==== (% style="color:blue" %)**FLAG:**(%%) ====
319 319  
320 320  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
... ... @@ -347,12 +347,12 @@
347 347  
348 348  ==== (% style="color:blue" %)**Alarm:**(%%) ====
349 349  
350 -**Example: ** 0x4B & 0x40 >> 6 = 0x01
314 +Example:  0x4B & 0x40 >> 6 = 0x01
351 351  
352 352  
353 353  ==== (% style="color:blue" %)**BAT:**(%%) ====
354 354  
355 -**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
319 +Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
356 356  
357 357  (((
358 358  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -364,37 +364,19 @@
364 364  * 3.40v ~~ 3.69v:  20% ~~ 40%
365 365  * < 3.39v:  0~~20%
366 366  
367 -==== (% style="color:blue" %)**MOD:**(%%) ====
368 -
369 -**Example: ** (0x60>>6) & 0x3f =1
370 -
371 -**Set the format of GPS data uplink link：**
372 -
373 -(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
374 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
375 -
376 -
377 -**Set the format of BLE data uplink link：**
378 -
379 -(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
380 -
381 -
382 382  ==== (% style="color:blue" %)**LON:**(%%) ====
383 383  
384 -**Example:** (0x60>>5) & 0x01=1.
385 -
386 386  Enable/Disable LED activity for uplink
387 387  
388 388  (((
389 -(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
336 +0x00:  Disable LED indicator.
390 390  )))
391 391  
392 392  (((
393 -(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
340 +0x01:  Enable LED indicator (Default Value)
394 394  )))
395 395  
396 396  
397 -
398 398  ==== (% style="color:blue" %)**Hum:**(%%) ====
399 399  
400 400  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -409,7 +409,7 @@
409 409  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
410 410  
411 411  
412 -The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
358 +The default uplink payload includes totally 11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
413 413  
414 414  
415 415  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -428,7 +428,7 @@
428 428  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
429 429  
430 430  
431 -Set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
377 +Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
432 432  
433 433  
434 434  (% style="color:red" %)**Note for this mode:**
... ... @@ -435,7 +435,6 @@
435 435  
436 436  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
437 437  * b) TrackerD will send data in (% style="color:blue" %)**CONFIRMED Mode**(%%) when PNACKMD=1, but TrackerD won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink, if TrackerD gets an ACK, TrackerD will consider there is a network connection and resend all NONE-ACK Messages.
438 -* c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL
439 439  
440 440  The payload is 15 bytes, as below.
441 441  
... ... @@ -451,11 +451,7 @@
451 451  
452 452  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
453 453  
454 -TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink.
455 455  
456 -User can set [[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]] so TrackerD will only search the iBeacons which have UUID match the BLEMASK.
457 -
458 -
459 459  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
460 460  |=(% scope="row" style="width: 60px;" %)(((
461 461  **Size(bytes)**
... ... @@ -475,7 +475,7 @@
475 475  [[image:1664502425687-834.png]]
476 476  
477 477  
478 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
419 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
479 479  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
480 480  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
481 481  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -494,9 +494,8 @@
494 494  [[image:1664502649601-895.png]]
495 495  
496 496  
497 -Add the decoder from this link: 
438 +Add the decoder from this link:
498 498  
499 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
500 500  
501 501  Save the change the uplink message will be parsed. As below:
502 502  
... ... @@ -506,10 +506,16 @@
506 506  
507 507  == 2.5 Integrate with Datacake ==
508 508  
449 +
450 +(((
509 509  After TrackerD sends data to LoRaWAN server such as TTN, use can pass the data to Datacake and plot out, currently only support GPS plot.
452 +)))
510 510  
454 +(((
511 511  Instruction is here:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Data%20Cake/#H7.Example~~-~~-AddTrackerDGPSTrackingInDataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Data%20Cake/#H7.Example--AddTrackerDGPSTrackingInDataCake]]
456 +)))
512 512  
458 +
513 513  [[image:1664502695771-538.png]]
514 514  
515 515  
... ... @@ -517,13 +517,15 @@
517 517  == 2.6 Integrate with Tago ==
518 518  
519 519  
466 +(((
467 +After TrackerD sends data to LoRaWAN server such as TTN, use can pass the data to Datacake and plot out, currently only support GPS plot.
468 +)))
520 520  
521 -After TrackerD sends data to LoRaWAN server such as TTN, user can pass the data to Datacake and plot out, currently only support GPS plot.
522 -
470 +(((
523 523  Instruction is here: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Tago.IO/#H3.A0Example-CreateTrackerD2FLGT92positioningwidget>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Tago.IO/#H3.A0Example-CreateTrackerD2FLGT92positioningwidget]]
472 +)))
524 524  
525 525  
526 -
527 527  [[image:1664502715371-321.png]]
528 528  
529 529  
... ... @@ -531,9 +531,8 @@
531 531  == 2.7  Datalog Feature ==
532 532  
533 533  
534 -total 273 entries,by default,
482 +total 273 entries,by default disable
535 535  
536 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
537 537  
538 538  Example use case.
539 539  
... ... @@ -553,7 +553,7 @@
553 553  
554 554  
555 555  (((
556 -Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exits alert mode.
503 +Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode.
557 557  )))
558 558  
559 559  
... ... @@ -561,7 +561,7 @@
561 561  Two ways to exit alarm mode:
562 562  )))
563 563  
564 -* Server sends a downlink command to exit.
511 +* Server send a downlink command to exit.
565 565  * User fast press the RED button 10 times.
566 566  
567 567  (((
... ... @@ -649,9 +649,11 @@
649 649  [[image:1664503022490-662.png]]
650 650  
651 651  
599 +
652 652  [[image:1664503035713-500.png]]
653 653  
654 654  
603 +
655 655  [[image:1664503047675-651.png]]
656 656  
657 657  
... ... @@ -765,38 +765,42 @@
765 765  === 3.2.7 Set Positioning Mode ===
766 766  
767 767  
768 -SMOD define how TrackerD scan and uplink data:
717 +SMOD define the how TrackerD scan and uplink data:
769 769  
770 770  
771 771  * (% style="color:blue" %)**AT Command:**
772 772  
773 -(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
722 +(% style="color:#037691" %)**AT+SMOD=aa,bb**
774 774  
775 775  (% style="color:#037691" %)** aa:**
776 776  
777 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
778 -* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
779 -* (% style="color:red" %)**3: GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning.
726 +* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
727 +* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
728 +* (% style="color:#037691" %)**3: GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning
780 780  
781 781  (% style="color:#037691" %)**bb:**
782 782  
783 -* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
784 -* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
732 +(% style="color:#037691" %)** if aa = 1: **
785 785  
786 -(% style="color:#037691" %)**cc:   **
734 +* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
735 +* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
787 787  
788 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
737 +(% style="color:#037691" %)** if aa = 2: **
789 789  
790 -(% style="color:blue" %)**Example:**
739 +* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
791 791  
792 - AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
793 - AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
794 - AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
741 + **Example:**
795 795  
743 + AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
796 796  
745 + AT+ SMOD =1,1    **~-~->**  GPS +BAT State
746 +
747 + AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
748 +
749 +
797 797  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
798 798  
799 -(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
752 +(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
800 800  
801 801  
802 802  
... ... @@ -813,7 +813,7 @@
813 813  
814 814  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
815 815  
816 -**Example:**  AT+FTIME=150
769 +Example:  AT+FTIME=150
817 817  
818 818  
819 819  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -850,7 +850,7 @@
850 850  
851 851  * (% style="color:blue" %)**AT Command:**
852 852  
853 -(% style="color:#037691" %)**AT+CFM=xx**
806 +(% style="color:#037691" %)**AT+CFM=xx. **
854 854  
855 855  
856 856  **~ Example:**
... ... @@ -866,44 +866,6 @@
866 866  
867 867  
868 868  
869 -=== 3.2.10  Auto Send None-ACK messages ===
870 -
871 -
872 -TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
873 -
874 -
875 -* (% style="color:blue" %)**AT Command: AT+PNACKMD**
876 -
877 -The default factory setting is 0.
878 -
879 -
880 -**Command Example Function Response:**
881 -
882 -(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
883 -
884 -
885 -* (% style="color:blue" %)**Downlink Command: 0x34**
886 -
887 -Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
888 -
889 -
890 -=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
891 -
892 -BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. LBT1 will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID.
893 -
894 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.
895 -
896 -(% style="color:blue" %)**AT Command:**(%%)
897 - AT+BLEMASK=123456     ~/~/ Set BLEMASK = 123456
898 - AT+BLEMASK=0  ~/~/ disable BLEMASK
899 -
900 -
901 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%)
902 -Example:
903 -0xA5010203040506    ~/~/ Set BLEMASK to 123456
904 -
905 -
906 -
907 907  = 4. Setting for Different Scenarios =
908 908  
909 909