Last modified by Kilight Cao on 2025/07/23 16:27
From version 177.1
edited by kai
on 2024/07/29 17:25
on 2024/07/29 17:25
Change comment:
Uploaded new attachment "image-20240729172500-14.png", version {1}
To version 235.1
edited by Kilight Cao
on 2025/07/23 16:25
on 2025/07/23 16:25
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 36 added, 0 removed)
- 1750035004731-376.png
- 1750035991532-434.png
- 1751538862245-924.png
- 1753258256594-216.png
- 1753258480811-335.png
- 1753258821265-310.png
- image-20241126175509-1.png
- image-20241126180135-2.png
- image-20241126180223-3.png
- image-20241126181024-4.png
- image-20241126181837-5.png
- image-20241126182007-6.png
- image-20241126182135-7.png
- image-20241126183032-8.png
- image-20241126183803-9.png
- image-20241126184136-10.png
- image-20241126184211-11.png
- image-20241126184303-12.png
- image-20241126184523-13.png
- image-20241126184906-14.png
- image-20241126190131-15.png
- image-20241126190251-16.png
- image-20241126190737-17.png
- image-20241126191118-18.png
- image-20241126192009-19.png
- image-20241126192122-20.png
- image-20241126192130-21.png
- image-20241126192246-22.png
- image-20241126192315-23.png
- image-20241126192415-24.png
- image-20241126193252-25.png
- image-20241126193458-26.png
- image-20241126193609-27.png
- image-20241126194018-28.png
- image-20241126194123-29.png
- image-20250121235119-1.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. kai1 +XWiki.Kilight - Content
-
... ... @@ -45,6 +45,10 @@ 45 45 |(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %) 46 46 |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %) 47 47 48 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %) 49 +|(% style="background-color:#4f81bd; color:white; width:152px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:169px" %)**AT+QCGDEFCONT=**|(% style="background-color:#4f81bd; color:white; width:427px" %)**Command Explanation**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Comments** 50 +|(% style="width:152px" %)**[[1NCE>>https://1nce.com]]/[[NB card purchased by the customer>>https://1nce.com]]**|(% style="width:169px" %)iot.1nce.net/xxx|(% style="width:427px" %)This command sets the PSD connection settings for PDN connection on power-up. When the MT attaches to the NB-IoT network on power-on, a PDN connection setup is performed. Therefore, PDN connection settings are stored in NVRAM so that they can be used by the modem during the attachment.|(% style="width:135px" %) 51 + 48 48 == 2.2 Speed Up Network Attach time == 49 49 50 50 ... ... @@ -284,6 +284,7 @@ 284 284 285 285 ==== 3.4.1.1 Create Device ==== 286 286 291 + 287 287 (% style="color:blue" %)**Add Device**(%%) in DataCake. 288 288 289 289 [[image:image-20230808162301-1.png||height="453" width="952"]] ... ... @@ -354,8 +354,11 @@ 354 354 355 355 **Step6: Please add the decoder at the payload decoder of the device configuration.** 356 356 357 -**Decoder location:**[[dragino-end-node-decoder/Datacake-Dragino_NB at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB]] 362 +**Decoder location: **[[dragino-end-node-decoder/Datacake-Dragino_NB at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB]] 358 358 364 +**Due to version update, please use the following decoder for the new version firmware:** 365 +[[dragino-end-node-decoder/Datacake-Dragino_NB_New_Version at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB_New_Version]] 366 + 359 359 [[image:image-20240129172056-7.png||height="457" width="816"]] 360 360 361 361 [[image:image-20240129173116-9.png||height="499" width="814"]] ... ... @@ -386,6 +386,61 @@ 386 386 (% style="color:blue" %)**AT+SERVADDR=67.207.76.90,4445** 387 387 388 388 397 +== 3.5 Telemetry2U == 398 + 399 + 400 +=== Configuring the Dragino NB Sensor Settings === 401 + 402 + 403 +(% style="color:blue" %)**AT+SERVADDR=telemetry2u.com,4483**(%%) – Sets the server address and port for sending data to the Telemetry2U IoT platform. 404 + 405 +(% style="color:blue" %)**AT+APN=simbase**(%%) – Sets the APN required for LTE-M connectivity using a Simbase global SIM card. 406 + 407 +(% style="color:blue" %)**ATZ**(%%) – Reboots the device to apply the changes. It won’t transmit to Telemetry2U until added and configured on the platform. 408 + 409 +(% style="color:blue" %)**AT+CFG**(%%) – Displays the current configuration. Take note of the 8-byte (HEX) **DEUI**, which you’ll need in the next setup step. 410 + 411 +And that’s it! These simple steps will get your device up and running on our Telemetry2U servers in no time. 412 + 413 + 414 +**Step 1: Log in Telemetry2U** 415 + 416 + 417 +Users can register a Telemetry2U account for their first use 418 + 419 +**[[https:~~/~~/telemetry2u.com/Identity/Account/Register>>https://telemetry2u.com/Identity/Account/Register]]** 420 + 421 + 422 +**Step 2: Add the device** 423 + 424 +[[image:1753258256594-216.png||height="686" width="1382"]] 425 + 426 + 427 +**1. Select Network provide:**Users need to select Telemetry2U NB-IoT over UDP in order to connect to the platform 428 + 429 +**2. Select device type:**Select the template you need to use 430 + 431 +**3. Fill in Description:**Fill in the unique description 432 + 433 +4. **Fill in IMEI:**The IMEI corresponds to the IME of the device 434 + 435 +After completion, click "**Greate**" 436 + 437 +[[image:1753258480811-335.png||height="789" width="1380"]] 438 + 439 + 440 +**Step 3: Check the data** 441 + 442 + 443 +[[image:1753258821265-310.png||height="681" width="1365"]] 444 + 445 + 446 + 447 +For more information, please refer to the user manual on the Telemetry2U official website: 448 + 449 +**[[https:~~/~~/telemetry2u.com/Documentation/dragino-lte-m-nb-iot-sensors-iot-platform-integration>>https://telemetry2u.com/Documentation/dragino-lte-m-nb-iot-sensors-iot-platform-integration]]** 450 + 451 + 389 389 == 3.5 Node-Red (via MQTT) == 390 390 391 391 === 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] === ... ... @@ -505,7 +505,6 @@ 505 505 506 506 === 3.6.2 Simulate with MQTT.fx === 507 507 508 - 509 509 [[image:image-20230802112413-39.png]] 510 510 511 511 [[image:image-20230802112413-40.png||height="525" width="980"]] ... ... @@ -537,7 +537,6 @@ 537 537 [[image:image-20230802112413-43.png||height="407" width="825"]] 538 538 539 539 540 - 541 541 == 3.7 ThingsBoard.Cloud (via COAP) == 542 542 543 543 === 3.7.1 Configure ThingsBoard === ... ... @@ -564,7 +564,7 @@ 564 564 ==== 3.7.1.2 COAP Integration Setup ==== 565 565 566 566 567 -Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“CoAP Integration”**(%%), select type **COAP 628 +Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“CoAP Integration”**(%%), select type **COAP **(% style="color:blue" %); 568 568 569 569 [[image:image-20240729144058-4.png||height="506" width="1021"]] 570 570 ... ... @@ -576,23 +576,37 @@ 576 576 577 577 ==== 3.7.1.3 Add COAP Integration ==== 578 578 579 -==== [[image:image-20240729161543-9.png||height="500" width="1009"]] ==== 580 580 641 +(% class="wikigeneratedid" id="H" %) 642 +[[image:image-20240729161543-9.png||height="500" width="1009"]] 581 581 644 + 582 582 === 3.7.2 Node Configuration(Example: Connecting to the Thingsboard platform) === 583 583 584 584 ==== 3.7.2.1 Instruction Description ==== 585 585 649 + 650 +* AT+PRO=1,0(HEX format uplink) &AT+PRO=1,5(JSON format uplink) 586 586 * AT+SERVADDR=COAP Server Address,5683 587 587 588 588 Example: AT+SERVADDR=int.thingsboard.cloud,5683(The address is automatically generated when the COAP integration is created) 589 589 655 +[[image:image-20240729172305-12.png||height="361" width="624"]] 656 + 590 590 Note:The port for the COAP protocol has been fixed to 5683 591 591 592 -AT+URL1=11,character length,"" 593 593 594 -I fthe moduleused is BC660K,onlyoneURLdirective needs to be configured,e.g.AT+URL1=11,38,"i/faaaa241f-af4a-b780-4468-c671bb574858"660 +* AT+URI1=11,(% style="color:red" %)**character length**(%%),"Needs to be consistent with the CoAP endpoint URL in the platform", 595 595 662 +-NB/NS products use the (% style="color:red" %)**BC660K**(%%) module, only need to configure (% style="color:red" %)**only one URL**(%%) command. 663 + 664 +e.g. 665 + 666 +* AT+URI1=11,38, "i/faaaa241f-af4a-b780-4468-c671bb574858" 667 + 668 +[[image:image-20240729172415-13.png||height="401" width="694"]] 669 + 670 + 596 596 == 3.8 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) == 597 597 598 598 === 3.8.1 Create device & Get Credentials === ... ... @@ -697,12 +697,157 @@ 697 697 Users can refer to [[Dragino NB device connection to AWS platform instructions>>http://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H1.LogintotheplatformandfindIoTcore]] 698 698 699 699 775 +== 3.11 ThingsEye (via MQTT) == 700 700 777 +=== 3.11.1 Configure ThingsEye === 701 701 779 +==== 3.11.1.1 Create MQTT integration ==== 780 + 781 + 782 +Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“MQTT Integration_NB”**(%%), select type (% style="color:blue" %)**MQTT**; 783 + 784 +[[image:image-20241126175509-1.png||height="518" width="1081"]] 785 + 786 + 787 +Next, directly select to create a new Uplink data converter and downlink data converter. 788 + 789 +[[image:image-20241126180135-2.png||height="535" width="1092"]] 790 + 791 +[[image:image-20241126180223-3.png||height="518" width="1093"]] 792 + 793 + 794 +(% style="color:blue" %)**Add a topic filter:** 795 + 796 +Consistent with the theme of the node setting. 797 + 798 +(% style="color:red" %)**Note: Recommended MQTT broker: lns1.thingseye.io 8883, fixed use. Topic can be changed on their own, but it need to be consistent with the node's publish and subscribe topic.** 799 + 800 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 801 + 802 +[[image:image-20241126181024-4.png||height="521" width="1081"]] 803 + 804 + 805 +==== 3.11.1.2 Add credentials to the MQTT integration ==== 806 + 807 + 808 +Click on the MQTT integration you just created. 809 + 810 +[[image:image-20241126181837-5.png||height="365" width="1079"]] 811 + 812 + 813 +Click the edit icon in the upper right corner to enter the edit mode. 814 + 815 +[[image:image-20241126184523-13.png||height="330" width="1075"]] 816 + 817 + 818 +(% style="color:blue" %)**Add credential files.** 819 + 820 +Click this [[link>>https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates. 821 + 822 +[[image:image-20241126183032-8.png||height="757" width="976"]] 823 + 824 +When the addition is complete, save the Settings. 825 + 826 +[[image:image-20241126184303-12.png||height="284" width="975"]] 827 + 828 +[[image:image-20241126184211-11.png||height="161" width="977"]] 829 + 830 + 831 +==== 3.11.1.3 Setup uplink and downlink converters ==== 832 + 833 + 834 +First, you need to download the [[**MQTT uplink/downlink JS** **code**>>https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]]. 835 + 836 +* (% style="color:blue" %)**Uplink Converter** 837 + 838 +The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume. 839 + 840 +Go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page, and find that MQTT uplink converter that was newly created when the integration was created. 841 + 842 +[[image:image-20241126184906-14.png||height="424" width="1100"]] 843 + 844 +Enter edit mode and apply **MQTT uplink JS code** to this uplink converter. 845 + 846 +[[image:image-20241126190131-15.png||height="542" width="1103"]] 847 + 848 + 849 +* (% style="color:blue" %)**Downlink Converter** 850 + 851 +Go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page, and find that MQTT downlink converter that was newly created when the integration was created. 852 + 853 +[[image:image-20241126190251-16.png||height="372" width="1113"]] 854 + 855 +Enter edit mode and apply **MQTT downlink JS code** to this downlink converter. 856 + 857 +[[image:image-20241126190737-17.png||height="527" width="1114"]] 858 + 859 + 860 +=== 3.11.2 Simulate with MQTT.fx === 861 + 862 + 863 +[[image:image-20241126191118-18.png||height="605" width="835"]] 864 + 865 +[[image:image-20241126193252-25.png||height="663" width="803"]] 866 + 867 + 868 +=== 3.11.3 Configure -NB node === 869 + 870 + 871 +First you need to configure the certificate to the -NB node. Follow the instructions in this **[[link>>https://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H4.1.2Configurecertificate]]** to configure the certificate. 872 + 873 +Screenshot of successful certificate configuration: 874 + 875 +* Configuring the CA Certificate 876 + 877 +[[image:image-20241126192009-19.png||height="431" width="697"]] 878 + 879 +[[image:image-20241126192130-21.png||height="426" width="694"]] 880 + 881 +* Configure client certificate 882 + 883 +[[image:image-20241126192246-22.png||height="397" width="693"]][[image:image-20241126192315-23.png||height="402" width="645"]] 884 + 885 +* Configure client private key 886 + 887 +[[image:image-20241126192415-24.png||height="435" width="737"]] 888 + 889 + 890 +When the certificate is configured, burn the boot program, burn the working firmware, and then restart the device. 891 + 892 +Then configure the -NB node to connect to the ThingsEye platform: 893 + 894 +(% style="color:blue" %)**AT Commands** 895 + 896 +* (% style="color:#037691" %)**AT+PRO=3,5 **(%%)** **~/~/ Use MQTT Connection & Json Payload 897 +* (% style="color:#037691" %)**AT+SERVADDR=lns1.thingseye.io,8883** 898 +* (% style="color:#037691" %)**AT+SUBTOPIC=8899 **(%%)~/~/ Consistent with the Topic of MQTT integration created by ThingsEye 899 +* (% style="color:#037691" %)**AT+PUBTOPIC=8899 **(%%)~/~/ Consistent with the Topic of MQTT integration created by ThingsEye 900 +* (% style="color:#037691" %)**AT+CLIENT=NULL** 901 +* (% style="color:#037691" %)**AT+UNAME=NULL** 902 +* (% style="color:#037691" %)**AT+PWD=NULL** 903 +* (% style="color:#037691" %)**AT+TLSMOD=1,2** 904 + 905 +Test Uplink by click the button for 1~~3 seconds, the MQTT integration in ThingsEye allows you to view the data upstream from the device: 906 + 907 +[[image:image-20241126193458-26.png||height="375" width="1012"]] 908 + 909 +[[image:image-20241126193609-27.png||height="424" width="1014"]] 910 + 911 + 912 +Go to (% style="color:blue" %)**"Device" **(%%) -> (% style="color:blue" %)** "Search Device"**(%%), enter the (% style="color:blue" %)** IMEI**(%%) of the device to find the device. 913 + 914 +[[image:image-20241126194018-28.png||height="318" width="1076"]] 915 + 916 +You can view the data that has just been uplink on the device: 917 + 918 +[[image:image-20241126194123-29.png||height="486" width="1073"]] 919 + 920 + 702 702 = 4. MQTT/UDP/TCP downlink = 703 703 704 704 == 4.1 MQTT (via MQTT.fx) == 705 705 925 + 706 706 Configure MQTT connections properly and send downlink commands to configure nodes through the Publish function of MQTT.fx//.// 707 707 708 708 **1.** Configure node MQTT connection (via MQTT.fx): ... ... @@ -743,11 +743,6 @@ 743 743 (% style="color:red" %)**Note: Users can edit the hex command in advance. When the node uplink, directly click the publish button several times to increase the success rate of command configuration.** 744 744 745 745 746 - 747 - 748 - 749 - 750 - 751 751 = 5. FAQ = 752 752 753 753 == 5.1 What is the usage of Multi Sampling and One Uplink? == ... ... @@ -763,8 +763,8 @@ 763 763 1. Give more sampling data points. 764 764 1. Increase reliable in transmission. For example. If user set 765 765 1*. **AT+TR=1800** ~/~/ The unit is seconds, and the default is to record data once every 1800 seconds (30 minutes, the minimum can be set to 180 seconds) 766 -1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 767 -1*. **AT+TDC=7200** ~/~/ Uplink every 2 hours. 981 +1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 982 +1*. **AT+TDC=7200** ~/~/ Uplink every 2 hours. 768 768 1*. this will mean each uplink will actually include the 6 uplink data (24 set data which cover 12 hours). So if device doesn't lost 6 continue data. There will not data lost. 769 769 770 770 == 5.2 Why the uplink JSON format is not standard? == ... ... @@ -777,6 +777,14 @@ 777 777 [[image:image-20240229233154-1.png]] 778 778 779 779 995 +== 5.3 What is the data consumption for different transfer mode? == 996 + 997 + 998 +For the data consumption of NB-IoT End node in different transfer mode, reference link: 999 + 1000 +[[https:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Traffic%20Statistics%20~~-~~-%20NBCB/>>https://wiki.dragino.com/xwiki/bin/view/Main/Traffic%20Statistics%20--%20NBCB/]] 1001 + 1002 + 780 780 = 6. Trouble Shooting: = 781 781 782 782 == 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. == ... ... @@ -856,27 +856,47 @@ 856 856 [[image:image-20240226111928-1.png]] 857 857 858 858 859 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 What is the Downlink Command bytheNBdevice?(%%)==1082 +== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 (%%)What is the Downlink Command Format for NB Devices? == 860 860 1084 + 1085 +Firstly, it is recommended that users upgrade the firmware of the -NB node to the latest version, as the processing method for downlink commands varies depending on the firmware version. Below, we will introduce the latest downlink command format. 1086 + 861 861 (% data-sider-select-id="bb6e9353-0c3f-473c-938d-4b416c9a03e6" %) 862 -=== UDP: === 1088 +=== **UDP Protocol:** === 863 863 864 -(% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %) 865 -Its downlink command is the same as the AT command, but brackets are required. 866 -Example: 1090 +Only supports valid **HEX-format downlink commands** corresponding to AT command. 867 867 868 -{AT+TDC=300} 1092 +Take the AT+TDC command of S31-NB as an example, that is, only the valid HEX format downstream command corresponding to the AT+TDC command can be used: 1093 +Downward format: (% style="color:blue" %)**01000384**(%%) ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds. 869 869 1095 +[[image:1750035991532-434.png||height="237" width="495"]] 870 870 1097 + 871 871 (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %) 872 -=== MQTT: === 1099 +=== **MQTT Protocol:** === 873 873 874 - Json:1101 +==== **1. HEX-format** ==== 875 875 876 -The Json format in MQTT mode needs to be configured with all commands. 877 -If you have configurations that need to be changed, please change them in the template below. 878 -Template: 1103 +Supports **HEX-format** downlink commands (corresponding to AT commands). 879 879 1105 +//Example~:// For the S31-NB's uplink interval modification (AT+TDC=900): 1106 + 1107 +Downlink command: (% style="color:blue" %)**01000384**(%%) ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds. 1108 + 1109 +[[image:1750035004731-376.png||height="276" width="557"]] 1110 + 1111 + 1112 +==== **2. JSON-format ** ==== 1113 + 1114 +===== **2. 1 JSON format template.** ===== 1115 + 1116 +All -NB nodes support downlink configuration modification using (% style="color:blue" %)**JSON format templates.** 1117 + 1118 +We can use templates to configure multiple commands AT once. Users only need to modify the parameters of the required AT commands in the correct template for each device. 1119 +Template. 1120 + 1121 +Take the template of D2x-NB as an example: 1122 + 880 880 { 881 881 "AT+SERVADDR":"119.91.62.30,1882", 882 882 "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs", ... ... @@ -900,24 +900,182 @@ 900 900 "AT+TEMPALARM3":"0" 901 901 } 902 902 903 - Hex:1146 +Explanations of two special commands in the template: AT+TR (set the detection interval: 0 ~~ 255 minutes) and AT+NOUD (set the number of groups) correspond to parameters in AT+CLOCKLOG. 904 904 905 - MQTT's hex format. Sincemany commands need to support strings, only a few commands are supported.1148 +[[image:1751538862245-924.png]] 906 906 907 -The supported commands are consistent with LoRaWAN's hex commands. 908 -Please refer to the following link to obtain the hex format: 909 909 910 - [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]1151 +**Instructions for Using the Template:** 911 911 1153 +1. Modify the parameters for each AT command in the template as needed. 1154 +1. Send the entire template in one downlink command. 912 912 913 - ==(%data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 Howto obtain device logs?(%%) ==1156 +(% style="color:red" %)**Note:** 914 914 915 -* **AT Command: AT** **+GETLOG** 1158 +* The template may vary depending on the device model. 1159 +* **Currently, each specific template is being updated and tested**. If you need a template for your specific device, please contact **Dragino Technical Support** at [[support@dragino.com>>url:https://mailto:support@dragino.com/]] to request the latest downlink template. 916 916 917 -This command can be used to query upstream logs of data packets. 918 918 919 -[[image:image-20240701114700-1.png]] 920 920 1163 +===== **2.2 Support sending json format commands separately** ===== 921 921 1165 +Some models of nodes support sending json format commands separately:(% style="color:blue" %)**RS485-NB, LDS25-NB, CS01-NB, SDI-12-NB, SW3L-NB, WL03A-NB, PS-NB, LTC2-NB.** 922 922 1167 +//Example~:// For the PS-NB's uplink interval modification (AT+TDC=900): 1168 + 1169 +Downlink command: (% style="color:blue" %)**{AT+TDC=900}**(%%)** **~/~/ The correct format is (% style="color:blue" %)**{AT Command}**(%%). No extra characters other than valid AT commands can be added within {}. 1170 + 1171 +(% style="color:red" %)**Note:** 1172 + 1173 +(% style="color:red" %)**1. Only when the correct and valid download command is used and the format is correct can the device be configured through the download command. Invalid download content cannot be processed by the device and will be automatically restarted.** 1174 + 1175 +(% style="color:red" %)**2. Devices designed with downlink commands can utilize different downlink formats (e.g., JSON or HEX) for configuration. However, regardless of the format, the functionality is strictly limited to the downlink command specifications described in the user manual's AT command explanation.** 1176 + 1177 +(% style="color:red" %)**For example, the HEX-format downlink command corresponding to AT+TDC can only be used to configure TDC and cannot be used for queries. There is no HEX-format downlink command equivalent to AT+TDC=? , so querying TDC via downlink is not supported.** 1178 + 1179 + 1180 +== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to get the debug log for further analyze?(%%) == 1181 + 1182 + 1183 +If user is not able to solve the connection issue, user can use below method and get the device log and send to Dragino (Support@dragino.cc) for further analyze. 1184 + 1185 + 1186 +(% class="lead" %) 1187 +Step1: Use Mobile Phone to connect device 1188 + 1189 +See this link: **[[how to connect via Mobile Phone:>>https://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/#H3.1UseDraginoDeviceTooltoconfigureorupgradefirmware]]** 1190 + 1191 + 1192 +(% class="lead" %) 1193 +Step2: Get Log by different commands. 1194 + 1195 +Use below three method to generate logs. 1196 + 1197 +* **AT+CFG ~-~-> Command to show the current configuration** 1198 +* **AT** **+GETLOG ~-~-> Command to get the previous upstream log** 1199 +* **press the toggle button for 1 ~~2 seconds ~-~-> Trigger a uplink** 1200 + 1201 +Above are the output example for about three action: 1202 + 1203 +[[image:image-20250121235119-1.png||height="493" width="455"]] 1204 + 1205 +[[image:image-20240207002129-2.png]] 1206 + 1207 + 1208 +(% class="lead" %) 1209 +Step3: Export Log 1210 + 1211 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/BLE%20Bluetooth%20Remote%20Configure/WebHome/image-20241230155425-16.png?width=330&height=85&rev=1.1||alt="image-20241230155425-16.png" height="85" width="330"]] 1212 + 1213 +select the log you want to export, then click the share icon on the far right to enter the document that comes with your phone and choose to export it. 1214 + 1215 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/BLE%20Bluetooth%20Remote%20Configure/WebHome/image-20241230155528-17.png?width=327&height=324&rev=1.1||alt="image-20241230155528-17.png" height="324" width="327"]] 1216 + 1217 + 1218 +== 6.7 How to find the AT Command Password if lost? == 1219 + 1220 + 1221 +=== Why can't the password access AT command after upgrade(-NB)? === 1222 + 1223 + 1224 +Because the new version of -NB firmware has updated the factory reset function, users can choose to restore all parameters to factory Settings, or keep the password to restore the rest of the parameters to factory Settings. 1225 + 1226 +This update changes the password address of the firmware, so the password will be invalid after the customer upgrades from the old version of firmware (without FDR1 function) to the new version of firmware (with FDR1 function). 1227 + 1228 +Two different restore factory Settings configurations. 1229 + 1230 +(% style="color:blue" %)**AT command:** 1231 + 1232 +* (% style="color:#037691; font-weight:bold" %)**AT+FDR**(%%)** **~/~/ Reset Parameters to Factory Default. 1233 +* (% style="color:#037691; font-weight:bold" %)**AT+FDR1**(%%)** **~/~/ Reset parameters to factory default values except for passwords.(new) 1234 + 1235 +=== Version Confirmation === 1236 + 1237 + 1238 +We are now dividing the **old firmware**(without FDR1 function) with the **new firmware**(with FDR1 function) by whether it contains FDR1 functionality. Please refer to the table: 1239 + 1240 +(% border="1" style="background-color:#f2f2f2; width:912px" %) 1241 +|(% style="background-color:#4f81bd; color:white; width:306px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:311px" %)((( 1242 +**Firmware version (without FDR1 function)** 1243 +)))|(% style="background-color:#4f81bd; color:white; width:289px" %)((( 1244 +**Firmware version (with FDR1 function)** 1245 +))) 1246 +|(% style="width:306px" %)((( 1247 +CPL03-NB, S31-NB, SN50V3-NB, TS01-NB, D20-NB, DS03A-NB, DDS04-NB, DDS45-NB, DDS20-NB, DDS75-NB, LDS12-NB, LDS40-NB, LMS01-NB, MDS120-NB, MDS200-NB, SE01-NB, SPH01-NB; 1248 +)))|(% style="width:311px" %)Before V1.2.1|(% style="width:289px" %)After V1.2.1 (including V1.2.1) 1249 +|(% style="width:306px" %)((( 1250 +WL03A-NB, SDI-12-NB; 1251 +)))|(% style="width:311px" %)Before V1.0.2|(% style="width:289px" %)((( 1252 +After V1.0.8 (including V1.0.2) 1253 +))) 1254 +|(% style="width:306px" %)((( 1255 +SW3L-NB, PS-NB; 1256 +)))|(% style="width:311px" %)Before V1.0.5|(% style="width:289px" %)((( 1257 +After V1.0.5 (including V1.0.5) 1258 +))) 1259 +|(% style="width:306px" %)RS485-NB|(% style="width:311px" %)Before V1.0.8|(% style="width:289px" %)After V1.0.8 (including V1.0.8) 1260 + 1261 +=== UART connection and firmware update methods === 1262 + 1263 + 1264 +Users can query passwords only using the UART interface via the STM32CubeProgrammer. 1265 + 1266 +See **[[UART Connection>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]**. 1267 + 1268 +update firmware through UART TTL interface :** [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**. 1269 + 1270 + 1271 +=== query the password via STM32CubeProgrammer === 1272 + 1273 + 1274 +Users can use the password address to query the password through STM32CubeProgrammer. 1275 + 1276 +* The password address for old firmware(without FDR1 function) : **0x08019000** 1277 +* The password address for new firmware(with FDR1 function) : **0x08025D00** 1278 + 1279 +(% style="color:red" %)**Notice: The password can only be queried after the firmware is run once.** 1280 + 1281 + 1282 +**Procedure for querying the password(old firmware):** 1283 + 1284 +* After the firmware upgrade is complete, switch back to the **FLASH** and reset the node to **run the firmware once**. 1285 +* Then place the switch at the **ISP** and connect to the STM32CubeProgrammer (same as when burning the firmware). 1286 +* Click "Device memory", enter **0x08019000** in "Address", and click "Read" 1287 +* Find the 0x08019000 address field and then read the current password as shown in the screenshot below. 1288 + 1289 +[[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827171901-3.png?width=912&height=528&rev=1.1||alt="image-20240827171901-3.png"]] 1290 + 1291 + 1292 +**Procedure for querying the password(new firmware):** 1293 + 1294 +Refer to [[the old and new firmware division>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#HVersionConfirmation]] above, and run the firmware first after updating the firmware. 1295 + 1296 +* After the firmware upgrade is complete, switch back to the **FLASH** and reset the node to **run the new firmware once**. 1297 +* Then place the switch at the **ISP** and connect to the STM32CubeProgrammer (same as when burning the firmware). 1298 +* Click "Device memory", enter **0x08025D00** in "Address", and click "Read" 1299 +* Find the 0x08025D00 address field and then read the current password as shown in the screenshot below. 1300 + 1301 +[[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827180414-1.png?width=910&height=527&rev=1.1||alt="image-20240827180414-1.png"]] 1302 + 1303 + 1304 +=== Special case === 1305 + 1306 + 1307 +If the user has never changed the password manually, the user cannot find the valid password through the above two password addresses. In this case, the valid password is still the original password on the node box label (**AT+PIN**). 1308 + 1309 +Invalid query screenshot example: 1310 + 1311 +[[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827181447-4.png?width=889&height=519&rev=1.1||alt="image-20240827181447-4.png"]] 1312 + 1313 +[[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827181431-3.png?width=892&height=515&rev=1.1||alt="image-20240827181431-3.png"]] 1314 + 1315 + 1316 + 1317 +== 6.8 == 1318 + 1319 + 1320 + 1321 + 1322 + 1323 + 923 923
- 1750035004731-376.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.1 KB - Content
- 1750035991532-434.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.4 KB - Content
- 1751538862245-924.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +114.7 KB - Content
- 1753258256594-216.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +153.1 KB - Content
- 1753258480811-335.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +110.5 KB - Content
- 1753258821265-310.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +189.0 KB - Content
- image-20241126175509-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +241.0 KB - Content
- image-20241126180135-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +192.8 KB - Content
- image-20241126180223-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +213.1 KB - Content
- image-20241126181024-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +238.8 KB - Content
- image-20241126181837-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +106.7 KB - Content
- image-20241126182007-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +136.3 KB - Content
- image-20241126182135-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +91.3 KB - Content
- image-20241126183032-8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +111.4 KB - Content
- image-20241126183803-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.1 KB - Content
- image-20241126184136-10.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +15.7 KB - Content
- image-20241126184211-11.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +22.3 KB - Content
- image-20241126184303-12.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +81.7 KB - Content
- image-20241126184523-13.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +88.7 KB - Content
- image-20241126184906-14.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +108.0 KB - Content
- image-20241126190131-15.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +267.9 KB - Content
- image-20241126190251-16.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +94.2 KB - Content
- image-20241126190737-17.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +253.7 KB - Content
- image-20241126191118-18.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +61.4 KB - Content
- image-20241126192009-19.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +113.6 KB - Content
- image-20241126192122-20.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +105.2 KB - Content
- image-20241126192130-21.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +105.2 KB - Content
- image-20241126192246-22.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.7 KB - Content
- image-20241126192315-23.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +99.0 KB - Content
- image-20241126192415-24.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +88.2 KB - Content
- image-20241126193252-25.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.2 KB - Content
- image-20241126193458-26.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +144.3 KB - Content
- image-20241126193609-27.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +167.5 KB - Content
- image-20241126194018-28.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +63.5 KB - Content
- image-20241126194123-29.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +126.7 KB - Content
- image-20250121235119-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +145.4 KB - Content