Skip to Content
Last modified by Karry Zhuang on 2025/07/03 11:59
From version 177.1
edited by Karry Zhuang
on 2024/05/16 17:26
Change comment: There is no comment for this version
To version 148.1
edited by Karry Zhuang
on 2024/05/06 17:39
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -3,10 +3,15 @@
3 3  
4 4  
5 5  
6 +**Table of Contents:**
6 6  
8 +{{toc/}}
7 7  
8 8  
9 9  
12 +
13 +
14 +
10 10  = 1. Overview =
11 11  
12 12  AIS is a video photo recognition sensor, the sensor can be used in electricity meters, gas meters, water meters, pressure gauges and other types of meters. Accurately identify the number of the current dial or upload the picture of the current dial for comparison, which can replace people to go to the door to read the meter, and is more accurate and energy-saving than the meter. The first thing to do is to fix the AIS sensor, the end direction needs to be aligned with the object that needs to be identified, you can check whether the object all appears in the lens range through the upper computer, and then calibrate, Chapter 2 will explain the calibration method of different tables. 
... ... @@ -13,10 +13,7 @@
13 13  
14 14  = 2. Calibrate Digits Readings =
15 15  
16 -According to the requirements to upgrade the firmware to correct the reading, respectively:[[Digital wheel dial firmware>>url:https://www.dropbox.com/scl/fi/nxa0nw0k2qhbpcxzfsz03/Digital-table-wheel-firmware.rar?rlkey=u9wqmilfwu899fhc9i2jfcwou&st=ftsl46f5&dl=0]]，[[Pointer dial firmware>>url:https://www.dropbox.com/scl/fi/y03feisk7ztq1ey6pmhqb/Pointer-dial-firmware.rar?rlkey=knlx67m1g26xukrthcum1kk23&st=5m196s89&dl=0]].
17 17  
18 -Firmware upgrade Reference:[[Update Firmware for the AI Sensors>>http://wiki.dragino.com/xwiki/bin/view/Main/Update%20Firmware%20for%20AI%20Sensor/]].
19 -
20 20  == 2.1 Calibrate a Water Meter ==
21 21  
22 22  === 2.1.1 Introduce ===
... ... @@ -56,9 +56,9 @@
56 56  
57 57  === 2.1.3 Calibration ===
58 58  
59 -Open the software  [[HMX_FT4222H_GUI.exe>>https://www.dropbox.com/scl/fi/yktibns4o33oh0lqitqjl/HIMAX_AMR_PC_Tool.7z?rlkey=94d637ntx152idhw8vij39icv&st=4lsq8xf9&dl=0]]. Please ensure that the firmware upgrade software ota.exe is closed before opening HMX_FT4222H_GUI.exe.
61 +Launch [[HMX_FT4222H_GUI.exe>>https://www.dropbox.com/scl/fi/yktibns4o33oh0lqitqjl/HIMAX_AMR_PC_Tool.7z?rlkey=94d637ntx152idhw8vij39icv&st=4lsq8xf9&dl=0]]. Please ensure that the firmware upgrade software ota.exe is closed before opening HMX_FT4222H_GUI.exe.
60 60  
61 -For example, Select the corresponding serial port number, here 14.
63 +Choose the largest number of serial port, for example, here shows 13 and 14, then choose 14.
62 62  
63 63  (% class="box warningmessage" %)
64 64  (((
... ... @@ -138,13 +138,13 @@
138 138  
139 139  === 2.2.3 Calibration ===
140 140  
141 -Open the software  [[HMX_FT4222H_GUI.exe>>https://www.dropbox.com/scl/fi/yktibns4o33oh0lqitqjl/HIMAX_AMR_PC_Tool.7z?rlkey=94d637ntx152idhw8vij39icv&st=4lsq8xf9&dl=0]]. Please ensure that the firmware upgrade software ota.exe is closed before opening HMX_FT4222H_GUI.exe.
143 +Perform a power reset on the EVB board, making sure to close the ota.exe program before opening HMX_FT4222H_GUI.exe.
142 142  
143 -For example, Select the corresponding serial port number, here 14.
145 +Choose the largest number of serial port, for example, here shows 13 and 14, then choose 14.
144 144  
145 145  (% class="box warningmessage" %)
146 146  (((
147 -(% class="mark" %)Note: before you start the software (%%)HMX_FT4222H_GUI.exe(% class="mark" %). you must pre-install the [[visualcppredist_aio_x6_x64_v42.exe>>https://www.dropbox.com/scl/fi/mzqx6ld5a4zkcecntqjjg/VisualCppRedist_AIO_x86_x64_v42.rar?rlkey=9fuzodmed1fg9ulquh22h0dtr&st=ph6ozi4d&dl=0]] configuration environment. Otherwise, an error pop-up window occurs when running software.
149 +(% class="mark" %)Note: before you start the software (%%)HMX_FT4222H_GUI.exe(% class="mark" %). you must pre-install the visualcppredist_aio_x6_x64_v42.exe configuration environment. Otherwise, an error pop-up window occurs when running software.
148 148  )))
149 149  
150 150  (% aria-label="1713519971789-213.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1713519971789-213.png||data-widget="image"]](% title="Click and drag to resize" %)​
... ... @@ -217,13 +217,13 @@
217 217  
218 218  === 2.3.3 Calibration ===
219 219  
220 -Open the software  [[HMX_FT4222H_GUI.exe>>https://www.dropbox.com/scl/fi/yktibns4o33oh0lqitqjl/HIMAX_AMR_PC_Tool.7z?rlkey=94d637ntx152idhw8vij39icv&st=4lsq8xf9&dl=0]]. Please ensure that the firmware upgrade software ota.exe is closed before opening HMX_FT4222H_GUI.exe.
222 +Perform a power reset on the EVB board, making sure to close the ota.exe program before opening HMX_FT4222H_GUI.exe.
221 221  
222 -For example, Select the corresponding serial port number, here 14.
224 +Choose the largest number of serial port, for example, here shows 13 and 14, then choose 14.
223 223  
224 224  (% class="box warningmessage" %)
225 225  (((
226 -(% class="mark" %)Note: before you start the software (%%)HMX_FT4222H_GUI.exe(% class="mark" %). you must pre-install the [[visualcppredist_aio_x6_x64_v42.exe>>https://www.dropbox.com/scl/fi/mzqx6ld5a4zkcecntqjjg/VisualCppRedist_AIO_x86_x64_v42.rar?rlkey=9fuzodmed1fg9ulquh22h0dtr&st=ph6ozi4d&dl=0]] configuration environment. Otherwise, an error pop-up window occurs when running software.
228 +(% class="mark" %)Note: before you start the software (%%)HMX_FT4222H_GUI.exe(% class="mark" %). you must pre-install the visualcppredist_aio_x6_x64_v42.exe configuration environment. Otherwise, an error pop-up window occurs when running software.
227 227  )))
228 228  
229 229  (% aria-label="1713519971789-213.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1713519971789-213.png||data-widget="image"]](% title="Click and drag to resize" %)​
... ... @@ -300,109 +300,170 @@
300 300  
301 301  8 numbers：
302 302  
303 -(% aria-label="image-20240420094632-15.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20240420094632-15.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]]
305 +(% aria-label="image-20240420094632-15.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20240420094632-15.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
304 304  
305 -(% title="Click and drag to resize" %)​
306 306  
307 -== 2.5 Pressure Pointer Meter Calibration ==
308 += (% title="Click and drag to resize" %)3. Get Sensor Data.(%%) =
308 308  
309 -=== 2.5.1 Introduce ===
310 +== (% title="Click and drag to resize" %)3.1 Get Digital Reading After Calibration(%%) ==
310 310  
311 -The pressure pointer meter of the example is 1.6MPa range
312 +This section shows an example for how to join the [[TheThingsNetwork>>url:https://www.thethingsnetwork.org/]] LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are of similar procedure.
312 312  
313 -=== 2.5.2 Fix Sensor to a Power Meter​ ===
314 314  
315 -You can utilize a couple of pea clips or other suitable fixtures to securely fasten the AIS sensor and ensure precise alignment of the camera with the pressure pointer meter.
315 +Assume the DLOS8 is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the AIS Sensor device in TTN V3 portal. 
316 316  
317 -[[image:image-20240516163229-1.jpeg||height="595" width="446"]]
317 +**Step 1**:  Create a device in TTN V3 with the OTAA keys from AIS Sensor.
318 318  
319 -=== 2.5.3 Calibration ===
319 +Each AIS Sensor is shipped with a sticker with the default DEV EUI as below:
320 320  
321 -Open the software  [[HMX_FT4222H_GUI.exe>>https://www.dropbox.com/scl/fi/yktibns4o33oh0lqitqjl/HIMAX_AMR_PC_Tool.7z?rlkey=94d637ntx152idhw8vij39icv&st=4lsq8xf9&dl=0]]. Please ensure that the firmware upgrade software ota.exe is closed before opening HMX_FT4222H_GUI.exe.
321 +[[image:image-20240430155056-2.png||height="207" width="450"]]
322 322  
323 -For example, Select the corresponding serial port number, here 14.
323 +Enter these keys in the LoRaWAN Server portal. Below is TTN V3 screen shot:
324 324  
325 -(% class="box warningmessage" %)
326 -(((
327 -(% class="mark" %)Note: before you start the software (%%)HMX_FT4222H_GUI.exe(% class="mark" %). you must pre-install the [[visualcppredist_aio_x6_x64_v42.exe>>https://www.dropbox.com/scl/fi/mzqx6ld5a4zkcecntqjjg/VisualCppRedist_AIO_x86_x64_v42.rar?rlkey=9fuzodmed1fg9ulquh22h0dtr&st=ph6ozi4d&dl=0]] configuration environment. Otherwise, an error pop-up window occurs when running software.
328 -)))
325 +Add APP EUI in the application.
329 329  
330 -[[image:image-20240516163338-2.png||height="455" width="733"]]
327 +choose to create the device manually.
331 331  
329 +Add APP KEY and DEV EUI
332 332  
333 -Next, select a Baud rate of 921600 and click on "start". Then, click on "show full image" to display the camera screen.
331 +[[image:image-20240430155117-3.png||height="544" width="563"]]
334 334  
335 -[[image:image-20240516163423-3.png]]
333 +[[image:image-20240430154736-1.png||height="414" width="658"]]
336 336  
337 337  
338 -Click "enable Raw" and save the BMP image in the "Save" folder. This step is necessary to obtain the coordinate points of the watch face.
336 +**Default mode OTAA**
339 339  
340 -[[image:image-20240516163501-4.png||height="482" width="694"]]
338 +[[image:image-20240430155302-4.png||height="630" width="453"]]
341 341  
342 -[[image:image-20240516163528-5.png||height="336" width="696"]]
340 +**Step 2**:  Use ACT button to activate LHT52 and it will auto join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and user can see in the panel.
343 343  
342 +=== 3.1.1 Uplink Payload (Fport~=5) ===
344 344  
345 -The computer's drawing tool can be used to open the latest bmp image and get the coordinates of the pressure pointer meter, as shown below.
344 +The uplink payload includes totally 14 bytes. Uplink packets use FPORT=5 and (% style="color:#4472c4" %)**every 20 minutes**(%%) send one uplink by default.
346 346  
347 -The coordinates of the pressure pointer table are located as shown below.
346 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:370px" %)
347 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**Size(bytes)(% style="display:none" %) (%%)**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)2|=(% style="width: 80px;background-color:#4F81BD;color:white" %)4|=(% style="width: 80px;background-color:#4F81BD;color:white" %)4|=(% style="width: 60px;background-color:#4F81BD;color:white" %)4
348 +|(% style="width:99px" %)Value|(% style="width:62px" %)BAT|sysTimeCurrent|Integer|Decimal
348 348  
349 -1 is the start point, 2 is the center point, and 3 is the end point.
350 +[[image:1714374026505-898.png||height="200" width="736"]]
350 350  
351 -The (x,y) coordinate on the image is located at the bottom left corner.
352 +Payload Example（FPort=5）：(% style="background-color:yellow" %)**0D 32 66 29 AF E0 00 00 00 02 00 05 E3 B0**
352 352  
353 -[[image:image-20240516163622-6.png||height="648" width="666"]]
354 +=== 3.1.2 BAT- Battery information ===
354 354  
356 +These two bytes of BAT include the battery state and the actual voltage.
355 355  
356 -Click on the ROI settingbutton in himax_amr_pc_tool. it will have three optionsThe long dial" option is a long dial dial.The "short dial" option is a short pointer and a number of wheel dial.The digit wheeler option is the digital wheel dial.Now the calibration is the pressure pointer table, which is long dialon."
358 +**Ex**：0x0B32 = 3378mV
357 357  
358 -[[image:image-20240516163910-7.png]]
360 +=== 3.1.3 sysTimeCurrent ===
359 359  
362 +These four bytes contain the year, month, day, hour, minute, and second of the time.
360 360  
361 -Fill in the values of the coordinates you just got, and it's best to get one and write one
364 +AI Sensor use Unix TimeStamp format based on
362 362  
363 -1 Coordinates of the starting point of the scale
366 +[[image:1714374373681-339.png||height="81" width="527"]]
364 364  
365 -2 Coordinates of the center point of the dial
368 +Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
366 366  
367 -3 Coordinates of the end of the scale
370 +Below is the converter example
368 368  
369 -4 Starting scale value
372 +**Ex**：6629AFE0=2024-04-25 01:20:32
370 370  
371 -5 End point scale value *100
374 +[[image:1714374389825-148.png||height="313" width="428"]][[image:1714374398047-940.png||height="214" width="508"]]
372 372  
373 -After filling in the data, click "send ROI" to save the Settings and click "Cancel" to exit.
376 +So, we can use AT+TIMESTAMP=1714012723 or downlink 6629C233 to set the current time 2024 – April ~-~- 25 Thursday 02:38:41
374 374  
375 -[[image:image-20240516164128-13.png||height="410" width="889"]]
378 +=== 3.1.4 Integer ===
376 376  
380 +These four bytes display the integers in the digital wheel face
377 377  
378 -After the calibration process is completed, The AIS cannot move thereafter to avoid misreading.
382 +[[image:1714374445395-196.png]]
379 379  
380 -it can be observed that the obtained reading aligns consistently with the numerical value displayed on the digital wheel dial.
384 +Read table integer：0x00000002=2
381 381  
382 -[[image:image-20240516164153-14.png]]
386 +=== 3.1.5 Decimal ===
383 383  
388 +These four bytes display decimals on the digital wheel.
384 384  
390 +[[image:1714374493101-914.png]]
385 385  
386 -= (% title="Click and drag to resize" %)3. Get Sensor Data.(%%) =
392 +Read table decimals：0x005E3B0/1000000= 0.385968
387 387  
388 388  
389 -== (% title="Click and drag to resize" %)3.1 Get Image and show in PC(%%) ==
395 +== (% title="Click and drag to resize" %)3.2 Get Image and show in PC(%%) ==
390 390  
391 -To get the AIS current image on the PC, you can  connect AIS to your PC with TTL to send commands through the serial port to obtain relevant data packets.
397 +To get the AIS current image on the PC, you can issue commands through TTN or connect AIS to your PC with TTL to send commands through the serial port to obtain relevant data packets.
392 392  
393 -=== (% id="cke_bm_3839S" style="display:none" %) (%%)3.1.1 The image date are obtained by serial port ===
399 +=== 3.2.1 The image date are obtained by TTN ===
394 394  
395 -Select the corresponding baud rate and serial port number through the serial port tool, select HEX display and HEX send, and continuously receive data from the AIS Sensor
401 +Make sure that node ACK is on: AT+PNACKMD=1 or 34 01
396 396  
397 -[[image:image-20240514161623-2.png||height="541" width="1439"]]
403 +Then send the graph instruction 0B 01.
398 398  
399 -In the serial port to send data C0 5A 00 00 00 00 04, and then send C0 5A 00 00 00 00 09, AIS Sensor will send a real-time image of the data packet, and then stop sending. Start with FFD8 and put it in TXT file
405 +The next time the AIS Sensor device runs at the set time, it will start collecting image data.
400 400  
401 -[[image:image-20240514161658-3.png||height="544" width="1441"]]
407 +[[image:1714465192126-772.png||height="478" width="678"]]
402 402  
409 +The uplink payload includes totally 208 bytes. Uplink packets use FPORT=3
403 403  
404 -=== 3.1.2 Combined image ===
411 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:370px" %)
412 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**Size(bytes)(% style="display:none" %) (%%)**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)4|=(% style="width: 80px;background-color:#4F81BD;color:white" %)2|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 60px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)200
413 +|(% style="width:99px" %)Value|(% style="width:62px" %)sysTimeCurrent|BAT|total_packages|subcontracting_count|Image_date
405 405  
415 +[[image:1714465532892-179.png||height="250" width="586"]]
416 +
417 +Example of the first payload（FPort=3）：663095C00BBE1000FFD8FFE000104A46494600010101004800480000FFDB0043001B12141714111B1716171E1C1B2028422B28252528513A3D3042605565645F555D5B6A7899816A7190735B5D85B586909EA3ABADAB6780BCC9BAA6C799A8ABA4FFDB0043011C1E1E2823284E2B2B4EA46E5D6EA4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4FFC0000B0800F0014001012200FFC4001F00000105010101010101000000000000000001020304050607
418 +
419 +==== ====
420 +
421 +==== 3.2.1.1sysTimeCurrent ====
422 +
423 +These four bytes contain the year, month, day, hour, minute, and second of the time.
424 +
425 +AI Sensor use Unix TimeStamp format based on.
426 +
427 +[[image:1714465658414-905.png||height="85" width="553"]]
428 +
429 +Users can get this time from the link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
430 +
431 +Below is the converter example
432 +
433 +EX: 663095C0=2024-04-30 06:54:57.
434 +
435 +[[image:image-20240430162820-5.png||height="218" width="532"]]
436 +
437 +==== 3.2.1.2 BAT- Battery information ====
438 +
439 +These two bytes of BAT include the battery state and the actual voltage.
440 +
441 +[[image:image-20240430163600-8.png||height="50" width="1141"]]
442 +
443 +**Ex**：0X0BBE= 3006 mv
444 +
445 +==== 3.2.1.3 total_packages ====
446 +
447 +This byte represents the total number of packets for the image fetched this time.
448 +
449 +[[image:image-20240430163626-9.png||height="47" width="1116"]]
450 +
451 +==== 3.2.1.4 subcontracting_count ====
452 +
453 +This byte represents the data number of the image packet retrieved
454 +
455 +[[image:image-20240430163738-10.png||height="44" width="1117"]]
456 +
457 +
458 +==== 3.2.1.5 Image_date ====
459 +
460 +Apart from the eight bytes mentioned above, the next 200 bytes are all image data.
461 +
462 +Example the first packet：663095C00BBE1000FFD8FFE000104A46494600010101004800480000FFDB0043001B12141714111B1716171E1C1B2028422B28252528513A3D3042605565645F555D5B6A7899816A7190735B5D85B586909EA3ABADAB6780BCC9BAA6C799A8ABA4FFDB0043011C1E1E2823284E2B2B4EA46E5D6EA4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4FFC0000B0800F0014001012200FFC4001F00000105010101010101000000000000000001020304050607
463 +
464 +Image_date=FFD8FFE000104A46494600010101004800480000FFDB0043001B12141714111B1716171E1C1B2028422B28252528513A3D3042605565645F555D5B6A7899816A7190735B5D85B586909EA3ABADAB6780BCC9BAA6C799A8ABA4FFDB0043011C1E1E2823284E2B2B4EA46E5D6EA4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4FFC0000B0800F0014001012200FFC4001F00000105010101010101000000000000000001020304050607
465 +
466 +
467 +==== 3.2.1.6 Combined image ====
468 +
406 406  Once all the data has been uploaded to the TTN platform, the subsequent step involves concatenating each packet in sequential order and saving it into a new TXT file. It is important to note that the first 8 bytes of each packet should be removed before concatenation.
407 407  
408 408  When you combine all the packets, you need to convert the data inside to binary. Here the conversion is demonstrated using the [[WinHex>>http://www.x-ways.net/winhex/index-m.html]] software.
... ... @@ -431,7 +431,167 @@
431 431  
432 432  [[image:1714467134950-189.png]]
433 433  
497 +=== 3.2.2 The image date are obtained by serial port ===
498 +
499 +Select the corresponding baud rate and serial port number through the serial port tool, select HEX display and HEX send, and continuously receive data from the AIS Sensor
500 +
501 +[[image:1714985699187-406.png||height="277" width="536"]]
502 +
503 +In the serial port to send data C0 5A 00 00 00 00 04, and then send C0 5A 00 00 00 00 09, AIS Sensor will send a real-time image of the data packet, and then stop sending. Start with FFD8 and put it in TXT file
504 +
505 +[[image:1714985711524-251.png||height="140" width="526"]]
506 +
507 +Then follow the instructions in 3.2.1.6 to get the image from AIS Sensor.
508 +
509 +
510 += 4. Configure AIS Sensor using AT commands =
511 +
512 +== 4.1 Configure Methods ==
513 +
514 +
515 + configure method:
516 +
517 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
518 +* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
519 +* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
520 +
521 +== 4.2 General Commands ==
522 +
523 +
524 +These commands are to configure:
525 +
526 +* General system settings like: uplink interval.
527 +* LoRaWAN protocol & radio related command.
528 +
529 +They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
530 +
531 +[[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/]]
532 +
533 +== 4.3 Commands special design for AIS Sensor ==
534 +
535 +=== 4.3.1 Change Uplink Interval ===
536 +
537 +
538 +Feature: Change LoRaWAN End Node Transmit Interval.
539 +
540 +
541 +(% style="color:blue" %)**AT Command: AT+TDC**
542 +
543 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:727.222px" %)
544 +|(% style="background-color:#4f81bd; color:white; width:165px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:227px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:329px" %)**Response**
545 +|(% style="width:165px" %)AT+TDC=?|(% style="width:227px" %)Show current transmit Interval|(% style="width:329px" %)30000(((
546 +OK
547 +
548 +the interval is 30000ms = 30s
549 +)))
550 +|(% style="width:165px" %)AT+TDC=60000|(% style="width:227px" %)Set Transmit Interval|(% style="width:329px" %)OK(((
551 +Set transmit interval to 60000ms = 60 seconds
552 +)))
553 +
554 +(((
555 +(% style="color:blue" %)**Downlink Command: 0x01**
556 +
557 +Format: Command Code (0x01) followed by 3 bytes time value.
558 +)))
559 +
560 +(((
561 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
562 +)))
563 +
564 +* **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
565 +
566 +* **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
567 +
568 +(% style="display:none" %) (%%)
569 +
570 +== 4.3.2 Request the server to send an ACK ==
571 +
572 +
573 +(% style="color:blue" %)**AT Command: AT+PNACKMD**
574 +
575 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:889px" %)
576 +|(% style="background-color:#4f81bd; color:white; width:160px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:627px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:100px" %)**Response**
577 +|(% style="width:160px" %)AT+PNACKMD=1|(% style="width:627px" %)If the node uploads the ACK as confirm, it will request the server to send an ACK. If the server ack is not received, the node will upload the packets that have not received the ACK the next time it receives the ACK|(% style="width:100px" %)1(((
578 +OK
579 +)))
580 +|(% style="width:160px" %)AT+PNACKMD=0|(% style="width:627px" %)off request the server to send an ACK|(% style="width:100px" %)(((
581 +0
582 +OK
583 +)))
584 +
585 +(% style="display:none" %) (%%) (% style="color:blue" %)**Downlink Command: 0x34**
586 +
587 +0X34 01  ~/~/Same As AT+PNACKMD=1
588 +
589 +0x34 00  ~/~/Same As AT+PNACKMD=0
590 +
591 +
592 +=== 4.3.3 Set Interrupt Mode ===
593 +
594 +
595 +Feature, Set Interrupt mode for GPIO_EXIT.
596 +
597 +(% style="color:blue" %)**AT Command: AT+INTMOD1,AT+INTMOD2,AT+INTMOD3**
598 +
599 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
600 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
601 +|(% style="width:154px" %)AT+INTMOD1=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
602 +0
603 +OK
604 +the mode is 0 =Disable Interrupt
605 +)))
606 +|(% style="width:154px" %)AT+INTMOD1=2|(% style="width:196px" %)(((
607 +Set Transmit Interval
608 +0. (Disable Interrupt),
609 +~1. (Trigger by rising and falling edge)
610 +2. (Trigger by falling edge)
611 +3. (Trigger by rising edge)
612 +)))|(% style="width:157px" %)OK
613 +|(% style="width:154px" %)AT+INTMOD2=3|(% style="width:196px" %)Set Transmit Interval
614 +0. (Disable Interrupt),
615 +~1. (Trigger by rising and falling edge)
616 +2. (Trigger by falling edge)
617 +3. (Trigger by rising edge)|(% style="width:157px" %)OK
618 +
619 +(% style="color:blue" %)**Downlink Command: 0x06**
620 +
621 +Format: Command Code (0x06) followed by 3 bytes.
622 +
623 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
624 +
625 +* Example 1: Downlink Payload: 06000000  **~-~-->**  AT+INTMOD1=0
626 +* Example 2: Downlink Payload: 06000003  **~-~-->**  AT+INTMOD1=3
627 +* Example 3: Downlink Payload: 06000102  **~-~-->**  AT+INTMOD2=2
628 +
434 434  === ===
435 435  
631 +=== 4.3.4 Clock logging (Since firmware version v1.2.1) ===
436 436  
437 -= =
633 +
634 +Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.
635 +
636 +We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.
637 +
638 +* (% style="color:blue" %)**AT Command:**(%%)** (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)**
639 +
640 +(% style="color:#037691" %)**a: **(%%)**0:** Disable Clock logging.  ** 1: **Enable Clock Logging
641 +
642 +(% style="color:#037691" %)**b: **(%%)Specify First sampling start second: range **(0 ~~ 3599, 65535)   ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
643 +
644 +(% style="color:#037691" %)**c: **(%%)Specify the sampling interval: range **(0 ~~ 255 minutes)**
645 +
646 +(% style="color:#037691" %)**d:**(%%)How many entries should be uplink on every TDC **(max 32)**
647 +
648 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]]
649 +
650 +**Example:**
651 +
652 +**AT+CLOCKLOG=1,65535,1,5**
653 +
654 +After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).
655 +
656 +(% class="wikigeneratedid" %)
657 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/TS01-NB_NB-IoT_Tilting_Sensor_User_Manual/WebHome/image-20240316163501-1.png?width=1064&height=517&rev=1.1||alt="image-20240316163501-1.png"]]
658 +
659 +(% class="wikigeneratedid" %)
660 +(% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.**
image-20240514161559-1.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -436.9 KB
Content
image-20240514161623-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -549.0 KB
Content
image-20240514161658-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -552.4 KB
Content
image-20240516163229-1.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -159.5 KB
Content
image-20240516163338-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.6 MB
Content
image-20240516163423-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.2 MB
Content
image-20240516163501-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -282.7 KB
Content
image-20240516163528-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -537.1 KB
Content
image-20240516163622-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -2.6 MB
Content
image-20240516163910-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.8 MB
Content
image-20240516163955-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
image-20240516164007-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
image-20240516164028-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -300.5 KB
Content
image-20240516164052-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
image-20240516164111-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
image-20240516164128-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -297.7 KB
Content
image-20240516164153-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.karry
Size
... ... @@ -1,1 +1,0 @@
1 -1.9 MB
Content