Skip to Content
Last modified by Xiaoling on 2023/12/27 09:15
From version 74.2
edited by Xiaoling
on 2022/10/11 09:44
Change comment: There is no comment for this version
To version 80.1
edited by Edwin Chen
on 2022/10/22 00:15
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
Content
... ... @@ -205,7 +205,9 @@
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**
208 208  
210 +
209 209  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
210 210  |=(% 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
211 211  |=(% 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
... ... @@ -250,50 +250,46 @@
250 250  
251 251  Use can also get the Device Status uplink through the downlink command:
252 252  
253 -TrackerD Model：0x40
254 254  
255 -(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %)
256 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit
257 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD
258 258  
259 -(% style="color:blue" %)**SMOD：**
257 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
260 260  
261 -(% style="color:red" %)**1 :** (%%) GPS ONLY
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 262  
263 -(% style="color:red" %)**2 :** (%%) BLE ONLY
263 +(% style="color:blue" %)** SMOD：**
264 264  
265 -(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
265 +(% style="color:red" %)** 1 :** (%%) GPS ONLY
266 266  
267 +(% style="color:red" %)** 2 :** (%%) BLE ONLY
267 267  
268 -(% style="color:blue" %)**GPS MOD:**
269 +(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
269 269  
270 -(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values
271 271  
272 -(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values
272 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
273 273  
274 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
274 274  
275 -(% style="color:blue" %)**BLE MOD:**
276 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
276 276  
277 -(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon
278 278  
279 -TrackerD Status:  0x02
279 +(% style="color:blue" %)** BLE_Settings:**
280 280  
281 -(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %)
282 -|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit
283 -|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode
281 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
284 284  
285 -(% style="color:red" %)**0 : **(%%) Transport Mode
286 286  
287 -(% style="color:red" %)**1 :  **(%%) AT+LON
288 288  
289 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
285 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
290 290  
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"]]
291 291  
292 -
293 293  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
294 294  
295 295  
296 -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.
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,
297 297  
298 298  
299 299  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -349,12 +349,12 @@
349 349  
350 350  ==== (% style="color:blue" %)**Alarm:**(%%) ====
351 351  
352 -Example:  0x4B & 0x40 >> 6 = 0x01
350 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
353 353  
354 354  
355 355  ==== (% style="color:blue" %)**BAT:**(%%) ====
356 356  
357 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
355 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
358 358  
359 359  (((
360 360  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -366,19 +366,37 @@
366 366  * 3.40v ~~ 3.69v:  20% ~~ 40%
367 367  * < 3.39v:  0~~20%
368 368  
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 +
369 369  ==== (% style="color:blue" %)**LON:**(%%) ====
370 370  
384 +**Example:** (0x60>>5) & 0x01=1.
385 +
371 371  Enable/Disable LED activity for uplink
372 372  
373 373  (((
374 -0x00:  Disable LED indicator.
389 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
375 375  )))
376 376  
377 377  (((
378 -0x01:  Enable LED indicator (Default Value)
393 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
379 379  )))
380 380  
381 381  
397 +
382 382  ==== (% style="color:blue" %)**Hum:**(%%) ====
383 383  
384 384  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -393,7 +393,7 @@
393 393  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
394 394  
395 395  
396 -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)
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)
397 397  
398 398  
399 399  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -412,7 +412,7 @@
412 412  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
413 413  
414 414  
415 -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.
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.
416 416  
417 417  
418 418  (% style="color:red" %)**Note for this mode:**
... ... @@ -419,6 +419,7 @@
419 419  
420 420  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
421 421  * 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
422 422  
423 423  The payload is 15 bytes, as below.
424 424  
... ... @@ -434,7 +434,9 @@
434 434  
435 435  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
436 436  
454 +TrackerD supports BLE scans for indoor positioning. User can set **SMOD** to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon before each uplink.
437 437  
456 +
438 438  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
439 439  |=(% scope="row" style="width: 60px;" %)(((
440 440  **Size(bytes)**
... ... @@ -454,7 +454,7 @@
454 454  [[image:1664502425687-834.png]]
455 455  
456 456  
457 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
476 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
458 458  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
459 459  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
460 460  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -473,8 +473,9 @@
473 473  [[image:1664502649601-895.png]]
474 474  
475 475  
476 -Add the decoder from this link:
495 +Add the decoder from this link: 
477 477  
497 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
478 478  
479 479  Save the change the uplink message will be parsed. As below:
480 480  
... ... @@ -517,8 +517,9 @@
517 517  == 2.7  Datalog Feature ==
518 518  
519 519  
520 -total 273 entries,by default disable
540 +total 273 entries,by default,
521 521  
542 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
522 522  
523 523  Example use case.
524 524  
... ... @@ -752,42 +752,38 @@
752 752  === 3.2.7 Set Positioning Mode ===
753 753  
754 754  
755 -SMOD define the how TrackerD scan and uplink data:
776 +SMOD define how TrackerD scan and uplink data:
756 756  
757 757  
758 758  * (% style="color:blue" %)**AT Command:**
759 759  
760 -(% style="color:#037691" %)**AT+SMOD=aa,bb**
781 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
761 761  
762 762  (% style="color:#037691" %)** aa:**
763 763  
764 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
765 -* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
766 -* (% 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
785 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
786 +* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
787 +* (% 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.
767 767  
768 768  (% style="color:#037691" %)**bb:**
769 769  
770 -(% style="color:#037691" %)** if aa = 1: **
791 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
792 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
771 771  
772 -* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
773 -* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
794 +(% style="color:#037691" %)**cc:   **
774 774  
775 -(% style="color:#037691" %)** if aa = 2: **
796 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
776 776  
777 -* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
798 +(% style="color:blue" %)**Example:**
778 778  
779 - **Example:**
800 + AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
801 + AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
802 + AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
780 780  
781 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
782 782  
783 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
784 -
785 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
786 -
787 -
788 788  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
789 789  
790 -(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
807 +(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
791 791  
792 792  
793 793  
... ... @@ -804,7 +804,7 @@
804 804  
805 805  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
806 806  
807 -Example:  AT+FTIME=150
824 +**Example:**  AT+FTIME=150
808 808  
809 809  
810 810  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -841,7 +841,7 @@
841 841  
842 842  * (% style="color:blue" %)**AT Command:**
843 843  
844 -(% style="color:#037691" %)**AT+CFM=xx. **
861 +(% style="color:#037691" %)**AT+CFM=xx**
845 845  
846 846  
847 847  **~ Example:**
... ... @@ -857,6 +857,44 @@
857 857  
858 858  
859 859  
877 +=== 3.2.10  Auto Send None-ACK messages ===
878 +
879 +
880 +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.
881 +
882 +
883 +* (% style="color:blue" %)**AT Command: AT+PNACKMD**
884 +
885 +The default factory setting is 0.
886 +
887 +
888 +**Command Example Function Response:**
889 +
890 +(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
891 +
892 +
893 +* (% style="color:blue" %)**Downlink Command: 0x34**
894 +
895 +Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
896 +
897 +
898 +=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
899 +
900 +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.
901 +
902 +Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.
903 +
904 +(% style="color:blue" %)**AT Command:**(%%)
905 + AT+BLEMASK=123456     ~/~/ Set BLEMASK = 123456
906 + AT+BLEMASK=0  ~/~/ disable BLEMASK
907 +
908 +
909 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%)
910 +Example:
911 +0xA5010203040506    ~/~/ Set BLEMASK to 123456
912 +
913 +
914 +
860 860  = 4. Setting for Different Scenarios =
861 861  
862 862