Wiki source code of BLE Bluetooth Remote Configure

Version 218.3 by Karry Zhuang on 2025/07/04 18:19

Hide last authors
Yi Wang 98.1 1 **Table of Contents:**
Xiaoling 8.2 2
Yi Wang 98.1 3 {{toc/}}
Xiaoling 37.1 4
Yi Wang 98.1 5
6
7
Yi Wang 190.1 8 = 1. Overview =
Xiaoling 8.2 9
10
Xiaoling 211.1 11 There are some new models of Dragino sensors support BLE type the link label remote configure. User can use mobile phone to configure the sensor via BLE.
Edwin Chen 1.1 12
13
Yi Wang 190.1 14 = 2. Support Models =
Edwin Chen 1.1 15
Xiaoling 8.2 16
Edwin Chen 1.1 17 Here list the models that support BLE and the method to activate BLE function.
18
19 {{velocity}}
20 $xwiki.ssfx.use("js/xwiki/table/table.css")
21 $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
22 {{/velocity}}
23
Yi Wang 190.1 24 (% border="1" cellspacing="5" class="doOddEven filterable grid sortable" id="tableid" style="background-color:#f2f2f2; width:955px" %)
25 (% class="sortHeader" %)|=(% style="width: 303px; background-color: rgb(217, 226, 243);" %)Models|=(% style="width: 439px; background-color: rgb(217, 226, 243);" %)BLE Activate Method|=(% style="width: 211px; background-color: rgb(217, 226, 243);" %)Comments
26 |(% style="width:303px" %)(((
Mengting Qiu 38.1 27 All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
Yi Wang 190.1 28 )))|(% style="width:439px" %)(((
Edwin Chen 2.1 29 Device is battery power type and BLE will be only activate on below case:
30
31 * Press button to send an uplink
Xiaoling 8.2 32
Edwin Chen 2.1 33 * Press button to active device.
Xiaoling 8.2 34
Edwin Chen 2.1 35 * Device Power on or reset.
36
37 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
Xiaoling 33.1 38 )))|(% style="width:211px" %)
Edwin Chen 3.1 39
Edwin Chen 211.5 40 = 3. How to configure via BLE =
Edwin Chen 8.1 41
Edwin Chen 211.5 42 == 3.1 Configure via Mobile APP ==
Xiaoling 8.2 43
Edwin Chen 211.5 44 === 3.1.1 Download APP ===
Xiaoling 8.2 45
Edwin Chen 211.4 46
Edwin Chen 211.3 47 ==== **Download from Google Play Store** ====
Xiaoling 8.2 48
Yi Wang 123.1 49 Open the Google Play Store, search for "Devices.tool", download and install.
Edwin Chen 8.1 50
Yi Wang 190.1 51 [[image:image-20241230134826-1.png||_mstalt="429767" height="292" width="514"]]
Edwin Chen 8.1 52
Yi Wang 190.1 53 (% class="box errormessage" %)
Edwin Chen 188.1 54 (((
55 Note: APPLE version is not ready yet.
56 )))
Edwin Chen 8.1 57
Yi Wang 132.1 58
Edwin Chen 211.2 59 ==== **Download from Dropbox** ====
Xiaoling 161.1 60
Yi Wang 132.1 61
Yi Wang 152.1 62 Click on the URL below to enter Dropbox to download the app:
63
Yi Wang 189.1 64 [[Download link>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]] 
Yi Wang 152.1 65
Xiaoling 161.1 66
Yi Wang 190.1 67 === 3.1.2 How to use BLE to configure Sensors ===
Edwin Chen 8.1 68
Xiaoling 103.1 69
Yi Wang 190.1 70 See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
Edwin Chen 105.1 71
72
Yi Wang 123.1 73 Install in mobile and run. Press the reset button of the device to be tested, and then click (% style="color:blue" %)**"SCAN BLUETOOTH DEVICES".**(%%) Find the correct device and connect(the correct device name should be the same as the DEV EUI of the device).
Edwin Chen 8.1 74
Yi Wang 190.1 75 [[image:image-20241230135129-4.png||_mstalt="429988" height="134" width="502"]]
Yi Wang 55.2 76
Yi Wang 190.1 77 [[image:image-20241230152054-8.png||_mstalt="430092" height="241" width="504"]]
Yi Wang 55.2 78
79
Yi Wang 123.1 80 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
Yi Wang 55.2 81
82
Yi Wang 190.1 83 [[image:image-20241230151129-6.png||_mstalt="430092" height="413" width="507"]]
Yi Wang 55.2 84
Edwin Chen 30.1 85 Each device has unique password named **AT PIN**. Input the password and you will be able to get access to the UART of the device.
Edwin Chen 8.1 86
Yi Wang 190.1 87 [[image:image-20241230152403-9.png||_mstalt="429741" height="232" width="506"]]
Edwin Chen 30.1 88
Yi Wang 55.2 89 Enter AT PIN + line break in the dialog box, click (% style="color:blue" %)**"Send"**(%%), and return the data display (% style="color:blue" %)**"Password Correct"**(%%) to start configuring the AT command.
Edwin Chen 8.1 90
Yi Wang 190.1 91 [[image:image-20241230151602-7.png||_mstalt="429000" height="568" width="348"]]
Yi Wang 55.2 92
Yi Wang 91.1 93
Xiaoling 103.1 94 (% style="color:red" %)**Note:**
Yi Wang 55.2 95
Yi Wang 190.1 96 **Devices.Tool is now compatible with sending commands without line breaks, and supports the simultaneous configuration of multiple AT commands. A record is also automatically saved after an instruction is sent, and clicking on a command in the history will display it directly in the input box.**
Yi Wang 55.2 97
Yi Wang 190.1 98 [[image:image-20241230153041-10.png||_mstalt="449423" height="599" width="353"]]
Yi Wang 55.2 99
Yi Wang 85.2 100
Edwin Chen 213.1 101 === 3.1.3 Batch Configure ===
Yi Wang 55.2 102
Karry Zhuang 214.3 103 If you have many devices, you can use this batch modification function to uniformly modify the setting parameters of all devices.
Yi Wang 55.2 104
Karry Zhuang 214.3 105 The specific steps are as follows
Karry Zhuang 213.2 106
Karry Zhuang 214.4 107 Click the upper right corner and select Multi-device Config Json
Karry Zhuang 214.3 108
Karry Zhuang 216.2 109 [[image:1751623776387-758.png||height="415" width="290"]]
Karry Zhuang 214.4 110
Karry Zhuang 216.3 111 ~1. Choose your json configuration file.
Karry Zhuang 214.3 112
Karry Zhuang 216.3 113 2. Search for your Bluetooth device.
Karry Zhuang 214.4 114
Karry Zhuang 216.3 115 3. Click on the Bluetooth signal with the corresponding name to connect.
Karry Zhuang 214.4 116
Karry Zhuang 216.4 117 [[image:1751623802789-156.png||height="551" width="253"]]
Karry Zhuang 214.4 118
Karry Zhuang 216.5 119 The first step is to check your configuration instructions and device passwords.
Karry Zhuang 214.4 120
Karry Zhuang 216.5 121 Click the "Process" button to configure, wait for the configuration to complete.
Karry Zhuang 214.4 122
Karry Zhuang 216.5 123 If the instructions or passwords are incorrect, a prompt will be given and manual modification will be required.
Karry Zhuang 214.4 124
Karry Zhuang 218.2 125 [[image:1751624084823-405.png||height="522" width="268"]]
Karry Zhuang 214.4 126
Karry Zhuang 218.3 127 After clicking process, this pop-up is displayed, indicating that the configuration has been modified successfully.
Karry Zhuang 216.2 128
Karry Zhuang 218.3 129 [[image:1751624271257-846.png||height="637" width="414"]]
Karry Zhuang 216.4 130
131
132
Edwin Chen 213.1 133 === 3.1.4 Export configure logs ===
134
135
Yi Wang 55.2 136 Open the Devices Tool and click the icon in the upper right corner.
137
Yi Wang 190.1 138 [[image:image-20241230155425-16.png||_mstalt="454233" height="85" width="330"]]
Yi Wang 55.2 139
140
141 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.
142
Yi Wang 190.1 143 [[image:image-20241230155528-17.png||_mstalt="455936" height="324" width="327"]]
Yi Wang 55.2 144
145
Edwin Chen 211.7 146 == 3.2 Configure via PC & USB to BLE adapter ==
Edwin Chen 11.1 147
Xiaoling 25.2 148
Herong Lu 19.1 149 Firstly, a USB to Bluetooth host is required
150
Yi Wang 190.1 151 [[image:image-20230601152915-3.png||_mstalt="430144"]]
Herong Lu 19.1 152
153
Yi Wang 190.1 154 [[image:image-20230601152950-4.png||_mstalt="430118"]]
Xiaoling 25.2 155
Herong Lu 19.1 156 Insert the Bluetooth host into the computer
157
Yi Wang 190.1 158 [[image:image-20230518151327-5.png||_mstalt="431535"]]
Herong Lu 19.1 159
Xiaoling 25.2 160
Herong Lu 19.1 161 Open the serial port assistant on the computer
162
Yi Wang 190.1 163 [[image:image-20230518145316-3.png||_mstalt="431054" height="560" width="730"]]
Herong Lu 19.1 164
165 Then connect according to the operating instructions of the purchased Bluetooth host
166
167 (be careful! The AT command in this description may be different from the AT command of the Bluetooth host you purchased. Please follow the instructions for the Bluetooth host you purchased)
168
169 The Bluetooth name to be connected is the DEVEUI of the node
170
Yi Wang 190.1 171 [[image:image-20230518151444-6.png||_mstalt="431847"]]
Edwin Chen 21.1 172
173
Yi Wang 190.1 174 = 4. Access Password and Command =
Edwin Chen 21.1 175
176
Xiaoling 25.2 177 Each device is shipped with a label as below include (% style="color:blue" %)**6 chars AT PIN**(%%). this is the PIN to access the console of sensor.
178
Edwin Chen 21.1 179 For AT Commands list please refer user manual for each sensor.
180
Yi Wang 190.1 181 [[image:image-20240204111711-2.png||_mstalt="426413"]]
Bei Jinggeng 36.1 182
183
Yi Wang 190.1 184 = 5. Use MAC Bluetooth to connect to nodes =
Bei Jinggeng 36.1 185
Xiaoling 37.1 186
Bei Jinggeng 36.1 187 1.Download BLE terminal or BLE Device Info
188
189 2. Turn on MAC Bluetooth
190
191 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
192
Yi Wang 190.1 193 [[image:image-20240802162132-1.png||_mstalt="427778" height="557" width="907"]]
Bei Jinggeng 36.1 194
Xiaoling 127.1 195
Bei Jinggeng 36.1 196 4.Click Connect, find the read/write window, and you can complete the communication with the device.
197
Yi Wang 190.1 198 [[image:image-20240802162318-2.png||_mstalt="430144" height="558" width="892"]]