Skip to Content
Last modified by Xiaoling on 2023/12/27 09:15
From version 74.3
edited by Xiaoling
on 2022/10/11 09:46
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,30 +366,37 @@
366 366  * 3.40v ~~ 3.69v:  20% ~~ 40%
367 367  * < 3.39v:  0~~20%
368 368  
369 -
370 -(% class="wikigeneratedid" %)
371 371  ==== (% style="color:blue" %)**MOD:**(%%) ====
372 372  
373 -Set the format of GPS data uplink link
369 +**Example: ** (0x60>>6) & 0x3f =1
374 374  
375 -0x00:  Enable uploading on-board Temperature and humidity values
371 +**Set the format of GPS data uplink link：**
376 376  
377 -0x01:  Disable uploading on-board Temperature and humidity values
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
378 378  
379 379  
377 +**Set the format of BLE data uplink link：**
378 +
379 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
380 +
381 +
380 380  ==== (% style="color:blue" %)**LON:**(%%) ====
381 381  
384 +**Example:** (0x60>>5) & 0x01=1.
385 +
382 382  Enable/Disable LED activity for uplink
383 383  
384 384  (((
385 -0x00:  Disable LED indicator.
389 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
386 386  )))
387 387  
388 388  (((
389 -0x01:  Enable LED indicator (Default Value)
393 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
390 390  )))
391 391  
392 392  
397 +
393 393  ==== (% style="color:blue" %)**Hum:**(%%) ====
394 394  
395 395  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -404,7 +404,7 @@
404 404  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
405 405  
406 406  
407 -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)
408 408  
409 409  
410 410  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -423,7 +423,7 @@
423 423  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
424 424  
425 425  
426 -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.
427 427  
428 428  
429 429  (% style="color:red" %)**Note for this mode:**
... ... @@ -430,6 +430,7 @@
430 430  
431 431  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
432 432  * 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
433 433  
434 434  The payload is 15 bytes, as below.
435 435  
... ... @@ -445,7 +445,9 @@
445 445  
446 446  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
447 447  
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.
448 448  
456 +
449 449  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
450 450  |=(% scope="row" style="width: 60px;" %)(((
451 451  **Size(bytes)**
... ... @@ -465,7 +465,7 @@
465 465  [[image:1664502425687-834.png]]
466 466  
467 467  
468 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
476 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
469 469  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
470 470  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
471 471  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -484,8 +484,9 @@
484 484  [[image:1664502649601-895.png]]
485 485  
486 486  
487 -Add the decoder from this link:
495 +Add the decoder from this link: 
488 488  
497 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
489 489  
490 490  Save the change the uplink message will be parsed. As below:
491 491  
... ... @@ -528,8 +528,9 @@
528 528  == 2.7  Datalog Feature ==
529 529  
530 530  
531 -total 273 entries,by default disable
540 +total 273 entries,by default,
532 532  
542 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
533 533  
534 534  Example use case.
535 535  
... ... @@ -763,42 +763,38 @@
763 763  === 3.2.7 Set Positioning Mode ===
764 764  
765 765  
766 -SMOD define the how TrackerD scan and uplink data:
776 +SMOD define how TrackerD scan and uplink data:
767 767  
768 768  
769 769  * (% style="color:blue" %)**AT Command:**
770 770  
771 -(% style="color:#037691" %)**AT+SMOD=aa,bb**
781 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
772 772  
773 773  (% style="color:#037691" %)** aa:**
774 774  
775 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
776 -* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
777 -* (% 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.
778 778  
779 779  (% style="color:#037691" %)**bb:**
780 780  
781 -(% style="color:#037691" %)** if aa = 1: **
791 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
792 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
782 782  
783 -* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
784 -* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
794 +(% style="color:#037691" %)**cc:   **
785 785  
786 -(% style="color:#037691" %)** if aa = 2: **
796 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
787 787  
788 -* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
798 +(% style="color:blue" %)**Example:**
789 789  
790 - **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
791 791  
792 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
793 793  
794 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
795 -
796 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
797 -
798 -
799 799  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
800 800  
801 -(% 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
802 802  
803 803  
804 804  
... ... @@ -815,7 +815,7 @@
815 815  
816 816  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
817 817  
818 -Example:  AT+FTIME=150
824 +**Example:**  AT+FTIME=150
819 819  
820 820  
821 821  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -852,7 +852,7 @@
852 852  
853 853  * (% style="color:blue" %)**AT Command:**
854 854  
855 -(% style="color:#037691" %)**AT+CFM=xx. **
861 +(% style="color:#037691" %)**AT+CFM=xx**
856 856  
857 857  
858 858  **~ Example:**
... ... @@ -868,6 +868,44 @@
868 868  
869 869  
870 870  
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 +
871 871  = 4. Setting for Different Scenarios =
872 872  
873 873