Last modified by Mengting Qiu on 2024/04/02 17:03
<
From version < 41.1 >
edited by Edwin Chen
on 2022/10/23 00:08
To version < 70.22 >
edited by Xiaoling
on 2022/11/18 11:25
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -CPN01- NB-IoT Outdoor Open/Close Dry Contact Sensor User Manual
1 +NDS03A - Outdoor NB-IoT Open/Close Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -1,34 +1,67 @@
1 1  (% style="text-align:center" %)
2 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652856952171-363.png?rev=1.1||alt="1652856952171-363.png" height="578" width="588"]]
2 +[[image:image-20221117105556-1.png]]
3 3  
4 +
5 +
6 +
7 +
8 +
9 +
10 +**Table of Contents：**
11 +
4 4  {{toc/}}
5 5  
6 -= **1. Introduction** =
7 7  
8 -== **1.1 ​**What is CPN01 **NB-IoT** Pulse/Contact Sensor ==
9 9  
10 -The Dragino CPN01 is an (% style="color:blue" %)**NB-IoT Dry Contact Sensor**(%%). It detects open/close status and uplinks the info to IoT server via NB-IoT network. User can see the (% style="color:blue" %)**dry contact status, open time, and open counts**(%%) in the IoT Server.
11 11  
12 -The CPN01 will send periodically data every day as well as for each dry contact action. It also counts the contact open times and calculates the last open duration. Users can also disable the uplink for each Open/Close event, instead, device can count each open event and uplink periodically.
13 13  
14 -CPN01 has** (% style="color:blue" %)Open-Alarm feature(%%)**, user can set this feature so CPN01 will send an alarm if the contact has been open exceeds a certain time.
18 += 1.  Introduction =
15 15  
16 -CPN01 is designed for outdoor use. It has a weatherproof enclosure and industrial-level battery to work in low to high temperatures.
20 +== 1.1 ​ What is NDS03A NB-IoT Open/Close Door Sensor ==
17 17  
18 -NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity, and spectrum efficiency, especially in deep coverage.
19 -\\CPN01 supports different uplink methods including (% style="color:blue" %)**TCP, MQTT, UDP, and CoAP**(%%) for different application requirements.
20 -\\CPN01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long-term use of up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
21 -\\To use CPN01, user needs to check if there is NB-IoT coverage in the field and with the Nb-IoT bands that CPN01 supports. If local operator support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from the operator and install into CPN01 to get NB-IoT network connection.
22 22  
23 -​
23 +(((
24 +The Dragino NDS03A is an (% style="color:blue" %)**Open/Close NB-IoT Door Sensor**(%%). It detects door (% style="color:blue" %)**open/close status**(%%) and (% style="color:blue" %)**uplinks**(%%) to IoT server via NB-IoT network. NDS03A can connect two door sensors. user can see the door status, open duration, open counts in the IoT Server.
25 +)))
24 24  
25 -== **​1.2 Features** ==
27 +(((
28 +The NDS03A will send periodically data (% style="color:blue" %)**every 4 hours** (%%)as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, NDS03A can count each open event and uplink periodically.
29 +)))
26 26  
31 +(((
32 +NDS03A has a (% style="color:blue" %)**Datalog feature**(%%), it will record the open/close event and the user can retrieve the history from NB-IoT.
33 +)))
34 +
35 +(((
36 +NDS03A has the(% style="color:blue" %)**open alarm feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.
37 +)))
38 +
39 +(((
40 +NDS03A is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures.
41 +)))
42 +
43 +(((
44 +NarrowBand-Internet of Things (NB-IoT) is a (% style="color:blue" %)**standards-based low power wide area (LPWA) technologyTCP, MQTT, UDP, and CoAP**(%%) for different application requirements.
45 +)))
46 +
47 +(((
48 +NDS03A is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long-term use of up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
49 +)))
50 +
51 +(((
52 +To use NDS03A, user needs to check if there is NB-IoT coverage in the field and with the Nb-IoT bands that NDS03A supports. If local operator support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from the operator and install into NDS03A to get NB-IoT network connection.
53 +)))
54 +
55 +
56 +
57 +== ​1.2  Features ==
58 +
59 +
27 27  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
28 28  * Open/Close detect
29 29  * Open/Close statistics
30 30  * Monitor Battery Level
31 -* Uplink on periodically and open/close event
64 +* connect two door sensors
32 32  * Datalog feature
33 33  * Uplink periodically
34 34  * Downlink to change configure
... ... @@ -39,14 +39,43 @@
39 39  * Micro SIM card slot for NB-IoT SIM
40 40  * 8500mAh Battery for long-term use
41 41  
42 -== **1.3  Specification** ==
43 43  
44 -**Common DC Characteristics:**
45 45  
77 +== 1.3  Storage & Operation ==
78 +
79 +
80 +Temperature -40°C to +85°C
81 +
82 +
83 +== 1.4  Mechanical ==
84 +
85 +
86 +[[image:image-20221117114937-4.png]]
87 +
88 +
89 +[[image:image-20221117114949-5.png]]
90 +
91 +
92 +[[image:image-20221117115010-6.png]]
93 +
94 +
95 +
96 +== 1.5 ​ Applications ==
97 +
98 +
99 +[[image:image-20221117114842-3.png]]
100 +
101 +
102 +
103 +== 1.6  Specification ==
104 +
105 +
106 +(% style="color:blue" %)**Common DC Characteristics:**
107 +
46 46  * Supply Voltage: 2.1v ~~ 3.6v
47 47  * Operating Temperature: -40 ~~ 85°C
48 48  
49 -**NB-IoT Spec:**
111 +(% style="color:blue" %)**NB-IoT Spec:**
50 50  
51 51  * - B1 @H-FDD: 2100MHz
52 52  * - B3 @H-FDD: 1800MHz
... ... @@ -55,90 +55,89 @@
55 55  * - B20 @H-FDD: 800MHz
56 56  * - B28 @H-FDD: 700MHz
57 57  
58 -== **1.4 Installation** ==
59 59  
60 -Connect CPN01 to an Open Close sensor like below. So it can detect the Open/Close event.
61 61  
62 -[[image:image-20221021110329-1.png]]
122 +== 1.7  Pin Definitions and Switch ==
63 63  
64 -[[image:image-20221022234602-2.png||height="288" width="922"]]
65 65  
125 +[[image:image-20221021110429-4.png]]
66 66  
67 -== **1.5 ​Applications** ==
68 68  
69 -* Open/Close Detection
70 -* Pulse meter application
71 -* Dry Contact Detection
128 +=== 1.7.1  Pin Definition ===
72 72  
73 -== **1.6 Mechanical** ==
74 74  
75 -​[[image:image-20221021110415-3.png]]
131 +The device is pre-configured to connect to a door sensor. The other pins are not used. If user wants to know more about other pins, please refer to the user manual of LSN50v2 at:  [[https:~~/~~/www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0>>https://www.dropbox.com/sh/djkxs7mr17y94mi/AABVlWbM9uzK9OA3mXyAT10Za?dl=0]]
76 76  
77 -== ** 1.7 Pin Definitions and Switch** ==
78 78  
79 -[[image:image-20221021110429-4.png]]
134 +=== 1.7.2  Jumper JP2(Power ON/OFF) ===
80 80  
81 -=== **1.7.1 Pin Definition** ===
82 82  
83 -CPN01 is pre-configured to connect to two external wires. The other pins are not used. If user wants to know more about other pins, please refer to the **[[LSN50v2 User Manual>>doc:Main.User Manual for LoRaWAN End Nodes.LSN50 & LSN50-V2 - LoRaWAN Sensor Node User Manual.WebHome]]**.
84 -
85 -
86 -=== **1.7.2 Jumper JP2(Power ON/OFF)** ===
87 -
88 88  Power on Device when putting this jumper.
89 89  
90 90  
91 -=== **1.7.3 BOOT MODE / SW1** ===
140 +=== 1.7.3  BOOT MODE / SW1 ===
92 92  
93 93  
94 -1) ISP: upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. The firmware won't run.
143 +1)  ISP:  upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. The firmware won't run.
95 95  
96 -2) Flash: working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging.
145 +2)  Flash:  working mode, the device starts to work for NB-IoT connection and sends out console output for further debugging.
97 97  
98 98  
99 -=== **1.7.4 Reset Button** ===
148 +=== 1.7.4  Reset Button ===
100 100  
101 101  
102 102  Press to reboot the device.
103 103  
104 104  
105 -=== **1.7.5 LED** ===
154 +=== 1.7.5  LED ===
106 106  
107 107  
108 108  The LED will blink when :
109 109  
110 -1. Boot the device in flash mode
111 -1. Send an uplink packet
159 +1.  Boot the device in flash mode
112 112  
113 -= **2.  Use CPN01 to communicate with IoT Server** =
161 +2.  Send an uplink packet
114 114  
115 -== **2.1  How it works** ==
116 116  
117 -The CPN01 is equipped with an NB-IoT module, the pre-loaded firmware in CPN01 will get **Open/Close Event or Count** from sensor and send the value to the NB-IoT network. The NB-IoT network will forward this value to IoT server via the protocol defined by CPN01.
164 +== 1.8  Magnet Distance ==
118 118  
119 -The diagram below shows the working flow in the default firmware of CPN01:
120 120  
167 +(% style="color:blue" %)**Wood Door:**(%%) 10 ~~ 30mm
168 +
169 +(% style="color:blue" %)**Iron Door:**(%%)**    **30 ~~ 45mm
170 +
171 +
172 += 2.  Use NDS03A to communicate with IoT Server =
173 +
174 +== 2.1  How it works ==
175 +
176 +
177 +In this user case, the NDS03A is installed on the door edge to detect the open/close event and send the status to the NB-IoT server. The NB-IoT network will forward this value to IoT server via the protocol defined by NDS03A.
178 +
179 +The diagram below shows the working flow in the default firmware of NDS03A:
180 +
121 121  [[image:image-20221021110615-5.png]]
122 122  
123 123  
124 -== **2.2 ​ Configure CPN01** ==
184 +== 2.2 ​ Configure NDS03A ==
125 125  
126 -=== **2.2.1 Test Requirement** ===
186 +=== 2.2.1 Test Requirement ===
127 127  
128 -To use CPN01 in your city, make sure to meet below requirements:
129 129  
189 +To use NDS03A in your city, make sure to meet below requirements:
190 +
130 130  * Your local operator has already distributed an NB-IoT Network.
131 -* The local NB-IoT network used the band that CPN01 supports.
192 +* The local NB-IoT network used the band that NDS03A supports.
132 132  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
133 133  
134 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The CPN01 will use CoAP(120.24.4.116:5683) or raw UDP(120.24.4.116:5601) or MQTT(120.24.4.116:1883)or TCP(120.24.4.116:5600)protocol to send data to the test server.
195 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NDS03A will use** (% style="color:red" %)CoAP(120.24.4.116:5683)(%%)** or raw (% style="color:red" %)**UDP(120.24.4.116:5601) **(%%)or (% style="color:red" %)**MQTT(120.24.4.116:1883) **(%%)or (% style="color:red" %)**TCP(120.24.4.116:5600)protocol**(%%) to send data to the test server.
135 135  
136 -[[image:image-20221023000439-3.png]]
197 +[[image:image-20221117142300-1.png]]
137 137  
138 - ​
139 139  
140 -=== **2.2.2 Insert SIM card** ===
200 +=== 2.2.2 Insert NB-IoT SIM card ===
141 141  
202 +
142 142  Insert the NB-IoT Card get from your provider.
143 143  
144 144  User needs to take out the NB-IoT module and insert the SIM card like below:
... ... @@ -146,94 +146,123 @@
146 146  [[image:image-20221021110745-6.png]] ​
147 147  
148 148  
149 -=== **2.2.3 Connect USB – TTL to CPN01 to configure it** ===
210 +=== 2.2.3 Connect USB – TTL to NDS03A and configure it ===
150 150  
151 -User need to configure CPN01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. CPN01 support AT Commands, user can use a USB to TTL adapter to connect to CPN01 and use AT Commands to configure it, as below.
152 152  
153 -**Connection:**
213 +User need to configure NDS03A via serial port to set the (% style="color:red" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NDS03A support AT Commands, user can use a USB to TTL adapter to connect to NDS03A and use AT Commands to configure it, as below.
154 154  
155 - USB TTL GND <~-~-~-~-> GND
215 +(% style="color:blue" %)**Connection:**
156 156  
157 - USB TTL TXD <~-~-~-~-> UART_RXD
217 +(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
158 158  
159 - USB TTL RXD <~-~-~-~-> UART_TXD
219 +(% style="background-color:yellow" %)** USB TTL TXD <~-~-~-~-> UART_RXD**
160 160  
221 +(% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD**
222 +
223 +
161 161  In the PC, use below serial tool settings:
162 162  
163 -* Baud:  **9600**
164 -* Data bits:** 8**
165 -* Stop bits: **1**
166 -* Parity:  **None**
167 -* Flow Control: **None**
226 +* Baud:  (% style="color:red" %)**9600**
168 168  
169 -Make sure the switch is in FLASH position, then power on CPN01 by connecting the (% style="color:orange" %)**Yellow Jumper**(%%).
228 +* Data bits:** (% style="color:red" %)8(%%)**
170 170  
230 +* Stop bits: (% style="color:red" %)**1**
231 +
232 +* Parity:  (% style="color:red" %)**None**
233 +
234 +* Flow Control: (% style="color:red" %)**None**
235 +
236 +Make sure the switch is in FLASH position, then power on NDS03A by connecting the (% style="color:orange" %)**Yellow Jumper**(%%).
237 +
171 171  ​[[image:image-20221021110817-7.png]]
172 172  
173 -CPN01 will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input.
240 +NDS03A will output system info once powered on as below, we can enter the **password: 12345678** to access AT Command input.
174 174  
175 175  
176 -**Note: the valid AT Commands can be found at:  **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
243 +(% style="color:red" %)**Note: the valid AT Commands can be found at:  **(%%)[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
177 177  
178 -=== **2.2.4 Use CoAP protocol to uplink data** ===
179 179  
180 -**Note: if you don't have CoAP server, you can refer this link to set up one: **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
181 181  
182 -**Use below commands:**
247 +=== 2.2.4 Use CoAP protocol to uplink data ===
183 183  
184 -* **AT+PRO=1**   ~/~/ Set to use CoAP protocol to uplink
185 -* **AT+SERVADDR=120.24.4.116,5683   ** ~/~/ to set CoAP server address and port
186 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path
187 187  
250 +(% style="color:red" %)**Note: if you don't have a CoAP server, you can refer this link to set up a CoAP server: **(%%)[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
251 +
252 +
253 +(% style="color:blue" %)**Use below commands in NDS03A:**
254 +
255 +* (% style="color:#037691" %)**AT+PRO=1**                (%%) ~/~/ Set to use CoAP protocol to uplink
256 +
257 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/ Set CoAP server address and port
258 +
259 +* (% style="color:#037691" %)**AT+URI=0,0,11,2,"mqtt" ** (%%) ~/~/  Set CoAP resource path
260 +
188 188  For parameter description, please refer to AT command set
189 189  
190 190  [[image:image-20221021110948-8.png]]
191 191  
192 -After configure the server address and **reset the device** (via AT+ATZ ), CPN01 will start to uplink sensor values to CoAP server.
193 193  
194 -[[image:image-20221021110956-9.png]] ​
266 +After configuring the server address and (% style="color:green" %)**reset NDS03A**(%%) (via AT+ATZ ), NDS03A will start to uplink sensor values to the CoAP server.
195 195  
196 -=== **2.2.5 Use UDP protocol to uplink data(Default protocol)** ===
268 +[[image:image-20221118103547-9.png||height="605" width="837"]] ​
197 197  
198 -This feature is supported since firmware version v1.0.1
199 199  
200 -* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
201 -* **AT+SERVADDR=120.24.4.116,5601   ** ~/~/ to set UDP server address and port
202 -* **AT+CFM=1       ** ~/~/If the server does not respond, this command is unnecessary
271 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
203 203  
273 +
274 +(% style="color:blue" %)**AT Commands:**
275 +
276 +* (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
277 +
278 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  Set UDP server address and port
279 +
280 +* (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
281 +
204 204  ​ [[image:image-20221021111025-10.png]]
205 205  
284 +
206 206  [[image:image-20221021111033-11.png||height="241" width="576"]]
207 207  
208 208  ​
209 209  
210 -=== **2.2.6 Use MQTT protocol to uplink data** ===
289 +=== 2.2.6 Use MQTT protocol to uplink data ===
211 211  
212 -This feature is supported since firmware version v110
213 213  
214 -* **AT+PRO=3   ** ~/~/Set to use MQTT protocol to uplink
215 -* **AT+SERVADDR=120.24.4.116,1883   ** ~/~/Set MQTT server address and port
216 -* **AT+CLIENT=CLIENT       ** ~/~/Set up the CLIENT of MQTT
217 -* **AT+UNAME=UNAME                               **~/~/Set the username of MQTT
218 -* **AT+PWD=PWD                                        **~/~/Set the password of MQTT
219 -* **AT+PUBTOPIC=NSE01_PUB                    **~/~/Set the sending topic of MQTT
220 -* **AT+SUBTOPIC=NSE01_SUB          ** ~/~/Set the subscription topic of MQTT
292 +(% style="color:blue" %)**AT Commands:**
221 221  
222 -​ [[image:image-20221021111058-12.png]]
294 +* (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
223 223  
224 -[[image:image-20221021111108-13.png]]
296 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
225 225  
298 +* (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
299 +
300 +* (% style="color:#037691" %)**AT+UNAME=UNAME                     **(%%)** **~/~/  Set the username of MQTT
301 +
302 +* (% style="color:#037691" %)**AT+PWD=PWD                         **(%%)** **~/~/  Set the password of MQTT
303 +
304 +* (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB              **(%%)** **~/~/  Set the sending topic of MQTT
305 +
306 +* (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
307 +
308 +​ [[image:image-20221118103445-7.png]]
309 +
310 +
311 +[[image:image-20221118103453-8.png||height="608" width="841"]]
312 +
226 226  ​
227 227  
228 -MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
315 +MQTT protocol has a much higher power consumption compare with UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
229 229  
230 -=== **2.2.7 Use TCP protocol to uplink data** ===
231 231  
232 -This feature is supported since firmware version v110
318 +=== 2.2.7 Use TCP protocol to uplink data ===
233 233  
234 -* **AT+PRO=4   ** ~/~/ Set to use TCP protocol to uplink
235 -* **AT+SERVADDR=120.24.4.116,5600   ** ~/~/ to set TCP server address and port
236 236  
321 +(% style="color:blue" %)**AT Commands:**
322 +
323 +* (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
324 +
325 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  Set TCP server address and port
326 +
237 237  ​ [[image:image-20221021111125-14.png]]
238 238  
239 239  [[image:image-20221021111131-15.png]]
... ... @@ -240,93 +240,125 @@
240 240  
241 241  ​
242 242  
243 -=== **2.2.8 Change Update Interval** ===
333 +=== 2.2.8 Change Update Interval ===
244 244  
245 -User can use below command to change the **uplink interval**.
246 246  
247 -* **AT+TDC=600      ** ~/~/ Set Update Interval to 600s
336 +User can use below command to change the (% style="color:blue" %)**uplink interval**.
248 248  
249 -**NOTE:**
338 +* (% style="color:#037691" %)**AT+TDC=14400      ** (%%) ~/~/ Set Update Interval to 14400s (4 hours)
250 250  
251 -**~1. By default, the device will send an uplink message every 1 hour.**
340 +(% style="color:red" %)**NOTE:**
252 252  
253 -== **2.3  Uplink Payload** ==
342 +1.  By default, the device will send an uplink message every 4 hour.
254 254  
255 -In this mode, uplink payload includes 87 bytes in total by default.
256 256  
257 -Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
345 +== 2.3  Uplink Payload ==
258 258  
259 -|**Size(bytes)**|**8**|**2**|**2**|**1**|**1**|**1**|**2**|**2**|4
260 -|**Value**|[[Device ID>>path:#H2.4.1A0A0DeviceID]]|[[Ver>>path:#H2.4.2A0VersionInfo]]|[[BAT>>path:#H2.4.3A0BatteryInfo]]|[[Signal Strength>>path:#H2.4.4A0SignalStrength]]|MOD|[[Interrupt>>path:#H2.4.8A0DigitalInterrupt]]|[[Soil P>>path:#H2.4.7A0SoilConductivity28EC29]]H|[[Soil Temperature>>path:#H2.4.6A0SoilTemperature]]|Time stamp
261 261  
262 -|2|2|4|8 group
263 -|[[Soil Temperature>>path:#H2.4.6A0SoilTemperature]]|[[Soil P>>path:#H2.4.7A0SoilConductivity28EC29]]H|Time stamp|...
348 +The uplink payload includes 26 bytes in total by default.
264 264  
265 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the CPN01 uplink data.
350 +Each time the device uploads a data package. The user can use the AT+NOUD command to upload the recorded data.Up to 32 sets of recorded data can be uploaded.
266 266  
267 -[[image:image-20221021111201-16.png||height="572" width="792"]]
352 +(% style="color:blue" %)**When AT+TTRCHANNEL=1:**
268 268  
354 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
355 +|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:50px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:65px" %)**1**|(% style="width:25px" %)**1**|(% style="width:50px" %)**1**|(% style="width:60px" %)**1**|(% style="width:90px" %)**3**|(% style="width:100px" %)**3**
356 +|=(% style="width: 93px;" %)**Value**|(% style="width:67px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:45px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:75px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:54px" %)MOD|(% style="width:62px" %)Door Status|(% style="width:60px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]]|(% style="width:94px" %)door open num(pb14) |(% style="width:93px" %)last open time(pb14)
357 +
358 +(% border="1.5" style="background-color:#ffffcc; color:green; width:450px" %)
359 +|(% style="width:50px" %)**4**|(% style="width:90px" %)**1**|(% style="width:90px" %)**3**|(% style="width:90px" %)**3**|(% style="width:60px" %)4|(% style="width:50px" %)(((
360 +**1-32 group**
361 +)))
362 +|(% style="width:98px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:115px" %)Door Status(pb14)|(% style="width:92px" %)door open num(pb14)|(% style="width:99px" %)last open time(pb14)|(% style="width:67px" %)Time stamp|(% style="width:74px" %)...
363 +
364 +
365 +(% style="color:blue" %)**When AT+TTRCHANNEL=2:**
366 +
367 +
368 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
369 +|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:45px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:65px" %)**1**|(% style="width:25px" %)**1**|(% style="width:60px" %)**1**|(% style="width:60px" %)**1**|(% style="width:87px" %)**3**|(% style="width:80px" %)**3**
370 +|=(% style="width: 96px;" %)**Value**|(% style="width:66px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:40px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:70px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:54px" %)MOD|(% style="width:55px" %)Door Status(pb14)|(% style="width:57px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]](pb14)|(% style="width:86px" %)door open num(pb14) |(% style="width:82px" %)last open time(pb14)
371 +
372 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
373 +|(% style="width:80px" %)**1**|(% style="width:80px" %)**1**|(% style="width:88px" %)**3**|(% style="width:81px" %)**3**|(% style="width:50px" %)**4**|(% style="width:75px" %)**1**|(% style="width:75px" %)**3**
374 +|(% style="width:59px" %)Door Status(pb15)|(% style="width:67px" %)[[Alarm Status>>||anchor="H2.7A0AlarmBaseonTimeout"]](pb15)|(% style="width:88px" %)door open num(pb15)|(% style="width:81px" %)last open time(pb15)|(% style="width:50px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:66px" %)Door Status(pb14)|(% style="width:92px" %)door open num(pb14)
375 +
376 +(% border="1" cellspacing="5" style="background-color:#ffffcc; color:green; width:510px" %)
377 +|(% style="width:100px" %)**3**|(% style="width:80px" %)**1**|(% style="width:90px" %)**3**|(% style="width:90px" %)**3**|(% style="width:70px" %)**4**|(% style="width:80px" %)(((
378 +**1-32 group**
379 +)))
380 +|(% style="width:102px" %)last open time(pb14)|(% style="width:93px" %)Door Status(pb15)|(% style="width:91px" %)door open num(pb15)|(% style="width:100px" %)last open time(pb15)|(% style="width:63px" %)[[Time stamp>>||anchor="H2.4.7A0Timestamp"]]|(% style="width:87px" %)......
381 +
382 +
383 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDS03A uplink data.
384 +
385 +[[image:image-20221117145932-2.png]]
386 +
387 +
269 269  The payload is ASCII string, representative same HEX:
270 270  
271 -**0x (% style="color:red" %)__0xf867787050213317__  (% style="color:blue" %)__0064__ (% style="color:green" %)_0c78__  __(% style="color:#00b0f0" %)17__  __(% style="color:#7030a0" %)01__  __(% style="color:#d60093" %)00__  __(% style="color:#a14d07" %)01 __ __(% style="color:#0020b0" %)__ __00__  __(% style="color:#420042" %)000009__  __(% style="color:#663300" %) 000002__  __(% style="color:#d60093" %)6315537bb__  __(% style="color:#663300" %)// 0100000b02000002663510fed__  __0100000e0200000263510f39 010000000000000063510e85 010000000000000063510d2e 010000000000000063510c7a 010000000000000063510bc6 010000000000000063510954 010000000000000063510882 //(%%)**
390 +**0x (% style="color:red" %)__f867787050213317__  (% style="color:blue" %)__0064__ (% style="color:green" %) __0ccf__(% style="color:#00b0f0" %) __19__(% style="color:#7030a0" %) __01__(% style="color:#0020b0" %) __00__ (% style="color:#420042" %)__00__(% style="color:#660066" %) (% style="color:#aaaa40" %)__000016__(% style="color:#663300" %) __000017__ (% style="color:#d60093" %)__637590df__(%%)**
272 272  
273 -where:
274 -*(% style="color:#037691" %) **Device ID:**(%%) 0x f867787050213317 = f867787050213317
392 +**where:**
275 275  
276 -*(% style="color:#037691" %) **Version:**(%%) 0x0064=100=1.0.0
394 +* (% style="color:#037691" %)**Device ID:**(%%) 0x f867787050213317 = f867787050213317
277 277  
278 -*(% style="color:#037691" %) **BAT:**(%%) 0x0c78 = 3192 mV = 3.192V
396 +* (% style="color:#037691" %)**Version:**(%%)  0x0064=100=1.0.0
279 279  
280 -*(% style="color:#037691" %) **Singal: **(%%)0x17 = 23
398 +* (% style="color:#037691" %)**BAT :**(%%)  0x0ccf = 3279 mV = 3.279V
281 281  
282 -*(% style="color:#037691" %) **Mod:**(%%) 0x01 = 1
400 +* (% style="color:#037691" %)**Singal: **(%%)0x19 = 25
283 283  
284 -*(% style="color:#037691" %) **Calculate Flag:**(%%) 0x00= 0
402 +* (% style="color:#037691" %)**Mod:**(%%)  0x01 = 1
285 285  
286 -*(% style="color:#037691" %) **Contact Status:**(%%) 0x00= 0
404 +* (% style="color:#037691" %)**Door Status:**(%%)  0x00=0
287 287  
288 -*(% style="color:#037691" %) **Alarm:**(%%)0x00 =0
406 +* (% style="color:#037691" %)**Alarm Status: **(%%)0x00 =0
289 289  
290 -*(% style="color:#037691" %) **Total pulse:0x09 =0**
408 +* (% style="color:#037691" %)**door open num: **(%%)0x000016 =22
291 291  
292 -*(% style="color:#037691" %) **The last open duration:**(%%)0x02 =2
410 +* (% style="color:#037691" %)**last open time:   **(%%)0x000017 =23
293 293  
294 -*(% style="color:#037691" %)**Time stamp :**(%%) 0x6315537b =1662342011
412 +* (% style="color:#037691" %)**Timestamp:**(%%) 0x637590df =1668649183 (Unix Time)
295 295  
296 -*(% style="color:#037691" %) **Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000b0200002663510fed
297 297  
298 -*(% style="color:#037691" %) **8 sets of recorded data: Contact Status, Total pulse, Calculate Flag, The last open duration ,Time stamp :**(%%) 0100000e0200002663510f39,.......
415 +== 2.4  Payload Explanation and Sensor Interface ==
299 299  
300 -== **2.4  Payload Explanation and Sensor Interface** ==
417 +=== 2.4.1  Device ID ===
301 301  
302 -=== **2.4.1  Device ID** ===
303 303  
304 -By default, the Device ID equal to the last 15 bits of IMEI.
420 +By default, the Device ID is equal to the last 15 bits of IMEI.
305 305  
306 -User can use **AT+DEUI** to set Device ID
422 +User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
307 307  
308 308  **Example:**
309 309  
310 310  AT+DEUI=868411056754138
311 311  
312 -The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
428 +The Device ID is stored in a non-erase area, Upgrade the firmware or run AT+FDR won't erase the Device ID.
313 313  
314 -=== **2.4.2  Version Info** ===
315 315  
316 -Specify the software version: 0x64=100, means firmware version 1.00.
431 +=== 2.4.2  Version Info ===
317 317  
318 -For example: 0x00 64 : this device is CPN01 with firmware version 1.0.0.
319 319  
320 -=== **2.4.3  Battery Info** ===
434 +Specify the software version: 0x64=100, which means firmware version 1.00.
321 321  
322 -Check the battery voltage for CPN01.
436 +For example 0x00 64 : This device is NDS03A 1 with firmware version 1.0.0.
323 323  
438 +
439 +=== 2.4.3  Battery Info ===
440 +
441 +
442 +Check the battery voltage for NDS03A.
443 +
324 324  Ex1: 0x0B45 = 2885mV
325 325  
326 326  Ex2: 0x0B49 = 2889mV
327 327  
328 -=== **2.4.4  Signal Strength** ===
329 329  
449 +=== 2.4.4  Signal Strength ===
450 +
451 +
330 330  NB-IoT Network signal Strength.
331 331  
332 332  **Ex1: 0x1d = 29**
... ... @@ -341,58 +341,46 @@
341 341  
342 342  **99**    Not known or not detectable
343 343  
344 -=== **2.4.5 Calculate Flag** ===
345 345  
346 -The calculate flag is a user define field, IoT server can use this filed to handle different meter with different pulse factor. For example, if there are 100 water meters, meter 1 ~~50 are 1 liter/pulse and meter 51 ~~ 100 has 1.5 liter/pulse.
467 +=== 2.4.5  Disalarm: (default: 0) ===
347 347  
348 -User can set calculate flag to 1 for meter 1~~50 and 2 for meter 51 ~~ 100, So IoT Server can use this field for calculation.
349 349  
350 -Default value: 0. 
470 +(% style="color:blue" %)**If Disalarm = 1**(%%), NDS03A will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
351 351  
352 -Range (6 bits): (b)000000 ~~ (b) 111111
472 +(% style="color:blue" %)**If Disalarm = 0**(%%), NDS03A will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
353 353  
354 -=== **2.4.6  Alarm** ===
474 + (% style="color:red" %)**Note:**(%%) When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast.
355 355  
356 -See [[Alarm Base on Timeout>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H3.5AlarmBaseonTimeout]]
357 357  
358 -=== **2.4.7 Contact Status** ===
477 +=== 2.4.6  Keep Status & Keep Time ===
359 359  
360 -0: Open
361 361  
362 -1: Close
480 +Shows the configure value of Alarm Base on Timeout Feature
363 363  
364 -=== **2.4.8 Total pulse** ===
365 365  
366 -Total pulse/counting base on dry [[contact trigger event>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.2SensorConfiguration2CFPORT3D4]]
483 +=== 2.4.7  Timestamp ===
367 367  
368 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
369 369  
370 -=== **2.4.9 The last open duration** ===
486 +Timestamp : 0x6315537b =1662342011
371 371  
372 -Dry Contact last open duration.
373 373  
374 -Unit: min.
489 +=== 2.4.8  Switch Dual Channel Mode ===
375 375  
376 -[[image:image-20221021111346-17.png||height="146" width="770"]]
377 377  
492 +NDS03A can connect two door sensors. Another door sensor can be connected to PB15 pin. Both channels support alarm function.
378 378  
379 -=== **2.4.10  Timestamp** ===
380 380  
381 -Time stamp : 0x6315537b =1662342011
495 +== 2.5  Downlink Payload ==
382 382  
383 -Convert Unix timestamp to time 2022-9-5 9:40:11.
384 384  
385 -**~ **
498 +By default, NDS03A prints the downlink payload to console port.
386 386  
387 -== **2.5  Downlink Payload** ==
388 -
389 -By default, CPN01 prints the downlink payload to console port.
390 -
391 391  [[image:image-20221021111414-18.png]] ​
392 392  
502 +
393 393  **Examples:**
394 394  
395 -* **Set TDC**
505 +* (% style="color:#037691" %)**Set TDC**
396 396  
397 397  If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
398 398  
... ... @@ -400,171 +400,222 @@
400 400  
401 401  Payload:    01 00 00 3C    TDC=60S
402 402  
403 -* **Reset**
513 +* (% style="color:#037691" %)**Reset**
404 404  
405 -If payload = 0x04FF, it will reset the NSE01
515 +If payload = 0x04FF, it will reset the NDS03A
406 406  
407 -* **INTMOD**
517 +* (% style="color:#037691" %)**INTMOD**
408 408  
409 409  Downlink Payload: 06000003, Set AT+INTMOD=3
410 410  
411 -== **2.6  ​LED Indicator** ==
412 412  
413 -The CPN01 has an internal LED which is to show the status of different state.
522 +== 2.6  ​LED Indicator ==
414 414  
415 -* When power on, CPN01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
416 -* Then the LED will be on for 1 second means device is boot normally.
417 -* After CPN01 join NB-IoT network. The LED will be ON for 3 seconds.
524 +
525 +The NDS03A has an internal LED which is to show the status of different states.
526 +
527 +* When the device starts normally, the LED will light up for 1 second.
528 +* After NDS03A join NB-IoT network. The LED will be ON for 3 seconds.
418 418  * For each uplink probe, LED will be on for 500ms.
419 419  
420 -== **2.7  Alarm Base on Timeout** ==
421 421  
422 -CPL01 can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
532 +== 2.7  Alarm Base on Timeout ==
423 423  
424 424  
425 -**~1. Keep Status: Status to be monitor**
535 +NDS03A can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
426 426  
537 +
538 +(% style="color:blue" %)**1. Keep Status: Status to be monitor**
539 +
427 427  Keep Status = 1: Monitor Close to Open event
428 428  
429 429  Keep Status = 0: Monitor Open to Close event
430 430  
431 431  
432 -**2. Keep Time: Timeout to send an Alarm**
545 +(% style="color:blue" %)**2. Keep Time: Timeout to send an Alarm**
433 433  
434 434  Range 0 ~~ 65535(0xFFFF) seconds.
435 435  
436 436  If keep time = 0, Disable Alarm Base on Timeout feature.
437 437  
438 -If keep time > 0, device will monitor the keep status event and send an alarm when status doesn’t change after timeout.
551 +If keep time > 0, device will monitor the keep status event and send an alarm when status doesn't change after timeout.
439 439  
440 440  
441 -**AT Command** to configure:
554 +(% style="color:blue" %)**AT Command to configure:**
442 442  
443 -**AT+TTRIG=1,30**  ~-~-> When the **Keep Status** change from connect to disconnect, and device remains in disconnect status for more than 30 seconds. CPL01 will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
556 +(% style="color:blue" %)**PB14 PIN:**
444 444  
445 -**AT+TTIG=0,0 ** ~-~-> Default Value, disable timeout Alarm.
558 +(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->**  When the **Keep Status** change from connected to disconnect, and device remains in disconnect status for more than 30 seconds. NDS03A will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/#H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
446 446  
447 -== **2.8 Set debug mode** ==
560 +(% style="color:#037691" %)**AT+TTRIG=0,0 ** (%%) **~-~->** Default Value, disable timeout Alarm.
448 448  
449 -Feature: Enable or Disable debug mode
450 450  
563 +(% style="color:blue" %)**PB15 PIN:**
451 451  
452 -**AT Command: AT+DEBUG**
565 +(% style="color:#037691" %)**AT+TTRIG2=1,30**
453 453  
567 +(% style="color:#037691" %)**AT+TTRIG2=0,0 **
568 +
569 +
570 +== 2.8  Set debug mode ==
571 +
572 +
573 +Feature: Enable or Disable debug mode
574 +
575 +(% style="color:blue" %)**AT Command: AT+DEBUG**
576 +
454 454  [[image:image-20221021111629-21.png]]
455 455  
456 -== **2.9 Clear Flash Record** ==
457 457  
580 +
581 +== 2.9  Clear Flash Record ==
582 +
583 +
458 458  Feature: Clear flash storage for data log feature.
459 459  
460 -**AT Command: AT+CLRDTA**
586 +(% style="color:blue" %)**AT Command: AT+CLRDTA**
461 461  
462 462  [[image:image-20221021111527-19.png]]
463 463  
464 -== ** 2.10 Set trigger mode** ==
465 465  
466 -➢ AT Command: **AT+TTRMOD**
591 +== 2.10  Count Mod ==
467 467  
468 -Feature: Set the trigger interrupt mode.
469 469  
470 -[[image:image-20221021111552-20.png]]
594 +(% style="color:blue" %)**AT Command: AT+COUNTMOD**
471 471  
472 -== **2.11 Set the calculate flag** ==
596 +[[image:image-20221118092935-1.png]]
473 473  
474 -Feature: Set the calculate flag
475 475  
476 -**AT Command: AT+CALCFLAG**
599 +== 2.11  Interrupt Pin Channel Mod ==
477 477  
478 -[[image:image-20221021111711-22.png]]
479 479  
480 -== **2.12 Set count number** ==
602 +(% style="color:blue" %)**AT Command: AT+TTRCHANNEL**
481 481  
482 -Feature: Manually set the count number
604 +[[image:image-20221118093144-2.png]]
483 483  
484 -**AT Command: AT+SETCNT**
485 485  
486 -[[image:image-20221021111748-24.png]]
607 +== 2.12 TTRIG1/2 timeout status alarm ==
487 487  
488 -== **2.13 Set the number of data to be uploaded and the recording time** ==
489 489  
490 -➢ AT Command:
610 +It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval.
491 491  
492 -AT+TR=900  ~/~/The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
612 +(% style="color:blue" %)**AT Command: AT+TTRALARM**
493 493  
614 +[[image:image-20221118093512-3.png]]
494 494  
495 -AT+NOUD=8  ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
496 496  
497 -== **2.14 Read or Clear cached data** ==
617 +== 2.13  Select counting mode ==
498 498  
499 -➢ AT Command:
500 500  
501 -AT+CDP    ~/~/ Read cached data
620 +(% style="color:blue" %)**AT Command: AT+TTRMODx=a,b**
502 502  
503 -[[image:image-20221021111810-25.png||height="364" width="797"]]
622 +When (% style="color:red" %)**a=0**(%%), the door is opened to count, and when (% style="color:red" %)**a=1**(%%),the closed door is counted.
504 504  
624 +When (% style="color:red" %)**b=0**(%%), it is the last door open duration, and when (% style="color:red" %)**b=1**(%%),the last door close duration.
505 505  
506 -AT+CDP=0    ~/~/ Clear cached data ​
626 +[[image:image-20221118093658-4.png]]
507 507  
508 -== **2.15  ​Firmware Change Log** ==
509 509  
510 -Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
629 +== 2.14  Set the number of data to be uploaded and the recording time ==
511 511  
512 -Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
513 513  
514 -== **2.16  ​Battery Analysis** ==
632 +(% style="color:blue" %)**AT Command:**
515 515  
516 -=== **2.16.1  ​Battery Type** ===
634 +(% style="color:#037691" %)**AT+TR=900**(%%)  ~/~/  The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
517 517  
518 -The CPN01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
636 +(% style="color:#037691" %)**AT+NOUD=8**(%%)** ** ~/~/  The device uploads 0 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
519 519  
520 -The battery is designed to last for several years depends on the actually use environment and update interval. 
521 521  
522 -The battery related documents as below:
639 +== 2.15  Read or Clear cached data ==
523 523  
641 +
642 +(% style="color:blue" %)**AT Command:**
643 +
644 +(% style="color:#037691" %)**AT+CDP**  (%%) ~/~/ Read cached data
645 +
646 +(% style="color:#037691" %)**AT+CDP=0**  (%%) ~/~/ Clear cached data ​
647 +
648 +[[image:image-20221118094227-5.png]]
649 +
650 +
651 +== 2.16  ​Firmware Change Log ==
652 +
653 +
654 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0>>https://www.dropbox.com/sh/hacq385w6qgnonr/AAC3D79GFGF1JdZUIzNegn2Ha?dl=0]]
655 +
656 +Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
657 +
658 +
659 +== 2.17  ​Battery Analysis ==
660 +
661 +=== 2.17.1  ​Battery Type ===
662 +
663 +
664 +The NDS03A battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
665 +
666 +The battery is designed to last for several years depends on the actual use environment and update interval. 
667 +
668 +The battery-related documents as below:
669 +
524 524  * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
671 +
525 525  * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
673 +
526 526  * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
527 527  
528 528  [[image:image-20221021111911-26.png]] ​
529 529  
530 -=== **2.16.2  Power consumption Analyze** ===
531 531  
679 +=== 2.17.2  Power consumption Analyze ===
680 +
681 +
532 532  Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
533 533  
534 534  Instruction to use as below:
535 535  
536 -**Step 1:  **Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
686 +(% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
537 537  
538 -**Step 2: ** Open it and choose
688 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose
539 539  
540 540  * Product Model
691 +
541 541  * Uplink Interval
693 +
542 542  * Working Mode
543 543  
544 544  And the Life expectation in difference case will be shown on the right.
545 545  
546 -[[image:image-20221021111923-27.png||height="253" width="783"]] ​
698 +[[image:1666596205057-567.png]] ​
547 547  
548 -=== **2.16.3  ​Battery Note** ===
549 549  
701 +=== 2.17.3  ​Battery Note ===
702 +
703 +
550 550  The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
551 551  
552 -=== **2.16.4  Replace the battery** ===
553 553  
554 -The default battery pack of CPN01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
707 +=== 2.17.4  Replace the battery ===
555 555  
556 -= **3. ​ Access NB-IoT Module** =
557 557  
710 +The default battery pack of NDS03A includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
711 +
712 +
713 += 3. ​ Access NB-IoT Module =
714 +
715 +
558 558  Users can directly access the AT command set of the NB-IoT module.
559 559  
560 560  The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
561 561  
562 -[[image:image-20221021112006-28.png]] ​
563 563  
564 -= **4.  Using the AT Commands** =
721 +[[image:image-20221118094449-6.png]] ​
565 565  
566 -== **4.1  Access AT Commands** ==
567 567  
724 += 4.  Using the AT Commands =
725 +
726 +== 4.1  Access AT Commands ==
727 +
728 +
568 568  See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
569 569  
570 570  AT+<CMD>?  : Help on <CMD>
... ... @@ -575,8 +575,9 @@
575 575  
576 576  AT+<CMD>=?  : Get the value
577 577  
578 -**General Commands**      
579 579  
740 +(% style="color:blue" %)**General Commands**      
741 +
580 580  AT  : Attention       
581 581  
582 582  AT?  : Short Help     
... ... @@ -599,35 +599,41 @@
599 599  
600 600  AT+SERVADDR  : Server Address
601 601  
602 -AT+TR      : Get or Set record time"
764 +AT+TR      :  Get or Set record time
603 603  
604 -
605 605  AT+NOUD      : Get or Set the number of data to be uploaded
606 606  
768 +AT+CDP     :  Read or Clear cached data
607 607  
608 -AT+CDP     : Read or Clear cached data
770 +AT+ DEBUG   : Enable or Disable debug mode
609 609  
772 +AT+ TTRIG1   : Get or Set PB14 PIN Alarm Base on Timeout
610 610  
611 -AT+ DEBUG   : Enable or Disable debug mode
774 +AT+ TTRIG2   : Get or Set PB15 PIN Alarm Base on Timeout
612 612  
613 -AT+ TTRIG   : Get or Set Alarm Base on Timeout
776 +AT+COUNTMOD  :  Get or Set the count mode
614 614  
615 -AT+ TTRMOD   : Get or Set the trigger interrupt mode(0:falling,1:rising)
778 +AT+TTRCHANNEL  : Get or Set the number of interrupt channels
616 616  
617 -AT+ CALCFLAG   : Get or Set the calculate flag
780 +AT+TTRALARM : Get or Set TTRIG1 of Alarm interval (unit: minute)
618 618  
619 -AT+ CLRC   : Clear current door open count
782 +AT+DISALARM  : Enable/Disable Alarm for door open/close or water leak event
620 620  
621 -**COAP Management**      
784 +AT+ CLRC   :  Clear current door open count
622 622  
786 +
787 +(% style="color:blue" %)**COAP Management**      
788 +
623 623  AT+URI            : Resource parameters
624 624  
625 -**UDP Management**
626 626  
792 +(% style="color:blue" %)**UDP Management**
793 +
627 627  AT+CFM          : Upload confirmation mode (only valid for UDP)
628 628  
629 -**MQTT Management**
630 630  
797 +(% style="color:blue" %)**MQTT Management**
798 +
631 631  AT+CLIENT               : Get or Set MQTT client
632 632  
633 633  AT+UNAME  : Get or Set MQTT Username
... ... @@ -638,86 +638,60 @@
638 638  
639 639  AT+SUBTOPIC  : Get or Set MQTT subscription topic
640 640  
641 -**Information**          
642 642  
810 +(% style="color:blue" %)**Information**          
811 +
643 643  AT+FDR  : Factory Data Reset
644 644  
645 645  AT+PWORD  : Serial Access Password
646 646  
647 -= **​5.  FAQ** =
648 648  
649 -== **5.1 ​ How to Upgrade Firmware** ==
817 += ​5.  FAQ =
650 650  
819 +== 5.1 ​ How to Upgrade Firmware ==
820 +
821 +
651 651  User can upgrade the firmware for 1) bug fix, 2) new feature release.
652 652  
653 653  Please see this link for how to upgrade:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
654 654  
655 -**Notice, **CPN01 **and **CPN01 **share the same mother board. They use the same connection and method to update.**
826 +(% style="color:red" %)**Notice: **(% style="color:blue" %)**NDS03A** (%%)**and (% style="color:blue" %)LDS03A(%%)**(% style="color:blue" %) (%%)**share the same mother board. They use the same connection and method to update.**
656 656  
657 -== **5.2  Can I calibrate CPN01 to different soil types?** ==
658 658  
659 -CPN01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]].
829 += 6.  Trouble Shooting =
660 660  
661 -= **6.  Trouble Shooting** =
831 +== 6.1  ​Connection problem when uploading firmware ==
662 662  
663 -== **6.1  ​Connection problem when uploading firmware** ==
664 664  
665 -**Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
834 +(% style="color:blue" %)**Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
666 666  
667 -== **6.2  AT Command input doesn't work** ==
668 668  
669 -In the case if user can see the console output but can't type input to the device. Please check if you already include the **ENTER** while sending out the command. Some serial tool doesn't send **ENTER** while press the send key, user need to add ENTER in their string.
837 +== 6.2  AT Command input doesn't work ==
670 670  
671 -= **7. ​ Order Info** =
672 672  
673 -Part Number**:** CPN01
840 +In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER** (%%)while press the send key, user need to add ENTER in their string.
674 674  
675 -= **8.  Packing Info** =
676 676  
677 -**Package Includes**:
843 += 7. ​ Order Info =
678 678  
679 -* CPN01 NB-IoT Soil Moisture & EC Sensor x 1
680 -* External antenna x 1
681 681  
682 -**Dimension and weight**:
846 +Part Number**:** NDS03A
683 683  
684 -* Size: 195 x 125 x 55 mm
685 -* Weight:   420g
686 686  
687 -= **9.  Support** =
849 += 8.  Packing Info =
688 688  
689 -* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
690 -* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
691 691  
692 -​
852 +(% style="color:blue" %)**Package Includes**:
693 693  
854 +* NDS03A Open/Close Door Sensor x 1
694 694  
695 695  
696 696  
858 += 9.  Support =
697 697  
698 698  
861 +* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
699 699  
863 +* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
700 700  
701 -
702 -
703 -
704 -
705 -
706 -
707 -
708 -
709 -
710 -
711 -
712 -
713 -
714 -
715 -
716 -
717 -
718 -
719 -
720 -
721 -
722 -
723 -
865 +​
1666596205057-567.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +179.8 KB
Content
image-20221117105556-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +133.3 KB
Content
image-20221117114459-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +14.9 KB
Content
image-20221117114842-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +964.1 KB
Content
image-20221117114937-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +79.1 KB
Content
image-20221117114949-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +33.4 KB
Content
image-20221117115010-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +40.4 KB
Content
image-20221117142300-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +147.8 KB
Content
image-20221117145932-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +51.9 KB
Content
image-20221117150312-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +8.7 KB
Content
image-20221118092935-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.1 KB
Content
image-20221118093144-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +11.7 KB
Content
image-20221118093512-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +9.5 KB
Content
image-20221118093658-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +12.7 KB
Content
image-20221118094227-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +29.2 KB
Content
image-20221118094449-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +76.5 KB
Content
image-20221118103445-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +20.4 KB
Content
image-20221118103453-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +46.2 KB
Content
image-20221118103547-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +43.5 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0