Skip to Content

Wiki source code of BLE Bluetooth Remote Configure

Last modified by Karry Zhuang on 2025/07/04 18:25
Show last authors
1 **Table of Contents:**
2
3 {{toc/}}
4
5
6
7
8 = 1. Overview =
9
10
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.
12
13
14 = 2. Support Models =
15
16
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
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" %)(((
27 All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
28 )))|(% style="width:439px" %)(((
29 Device is battery power type and BLE will be only activate on below case:
30
31 * Press button to send an uplink
32
33 * Press button to active device.
34
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.
38 )))|(% style="width:211px" %)
39
40 = 3. How to configure via BLE =
41
42 == 3.1 Configure via Mobile APP ==
43
44 === 3.1.1 Download APP ===
45
46
47 ==== **Download from Google Play Store** ====
48
49 Open the Google Play Store, search for "Devices.tool", download and install.
50
51 [[image:image-20241230134826-1.png||_mstalt="429767" height="292" width="514"]]
52
53 (% class="box errormessage" %)
54 (((
55 Note: APPLE version is not ready yet.
56 )))
57
58
59 ==== **Download from Dropbox** ====
60
61
62 Click on the URL below to enter Dropbox to download the app:
63
64 [[Download link>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]] 
65
66
67 === 3.1.2 How to use BLE to configure Sensors ===
68
69
70 See Video Instruction: **[[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]**
71
72
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).
74
75 [[image:image-20241230135129-4.png||_mstalt="429988" height="134" width="502"]]
76
77 [[image:image-20241230152054-8.png||_mstalt="430092" height="241" width="504"]]
78
79
80 After the connection is successful, enter the interface and click (% style="color:blue" %)**"DIALOGBOX".**
81
82
83 [[image:image-20241230151129-6.png||_mstalt="430092" height="413" width="507"]]
84
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.
86
87 [[image:image-20241230152403-9.png||_mstalt="429741" height="232" width="506"]]
88
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.
90
91 [[image:image-20241230151602-7.png||_mstalt="429000" height="568" width="348"]]
92
93
94 (% style="color:red" %)**Note:**
95
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.**
97
98 [[image:image-20241230153041-10.png||_mstalt="449423" height="599" width="353"]]
99
100
101 === 3.1.3 Batch Configure ===
102
103 If you have many devices, you can use this batch modification function to uniformly modify the setting parameters of all devices.
104
105 The specific steps are as follows
106
107 Click the upper right corner and select Multi-device Config Json
108
109 [[image:1751623776387-758.png||height="415" width="290"]]
110
111 ~1. Choose your json configuration file.
112
113 2. Search for your Bluetooth device.
114
115 3. Click on the Bluetooth signal with the corresponding name to connect.
116
117 [[image:1751623802789-156.png||height="551" width="253"]]
118
119 The first step is to check your configuration instructions and device passwords.
120
121 Click the "Process" button to configure, wait for the configuration to complete.
122
123 If the instructions or passwords are incorrect, a prompt will be given and manual modification will be required.
124
125 [[image:1751624084823-405.png||height="522" width="268"]]
126
127 After clicking process, this pop-up is displayed, indicating that the configuration has been modified successfully.
128
129 [[image:1751624271257-846.png||height="637" width="414"]]
130
131 The content of the JSON file is as follows. You can modify it according to your desired settings. The above is just an example.
132
133 ~1. Default command: Configuration command that all devices will use (lower priority).
134 2. Special command for a single device:
135 Single device configuration command is matched based on the ID value.
136 Higher priority. Commands that conflict with the default command will override the default command.
137 The "pwd" field indicates the device password. It is not a required field. If you fill in "pwd", the user does not need to enter the password manually.
138
139 [[image:1751624398456-705.png||height="554" width="426"]]
140
141 === 3.1.4 Export configure logs ===
142
143
144 Open the Devices Tool and click the icon in the upper right corner.
145
146 [[image:image-20241230155425-16.png||_mstalt="454233" height="85" width="330"]]
147
148
149 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.
150
151 [[image:image-20241230155528-17.png||_mstalt="455936" height="324" width="327"]]
152
153
154 == 3.2 Configure via PC & USB to BLE adapter ==
155
156
157 Firstly, a USB to Bluetooth host is required
158
159 [[image:image-20230601152915-3.png||_mstalt="430144"]]
160
161
162 [[image:image-20230601152950-4.png||_mstalt="430118"]]
163
164 Insert the Bluetooth host into the computer
165
166 [[image:image-20230518151327-5.png||_mstalt="431535"]]
167
168
169 Open the serial port assistant on the computer
170
171 [[image:image-20230518145316-3.png||_mstalt="431054" height="560" width="730"]]
172
173 Then connect according to the operating instructions of the purchased Bluetooth host
174
175 (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)
176
177 The Bluetooth name to be connected is the DEVEUI of the node
178
179 [[image:image-20230518151444-6.png||_mstalt="431847"]]
180
181
182 = 4. Access Password and Command =
183
184
185 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.
186
187 For AT Commands list please refer user manual for each sensor.
188
189 [[image:image-20240204111711-2.png||_mstalt="426413"]]
190
191
192 = 5. Use MAC Bluetooth to connect to nodes =
193
194
195 1.Download BLE terminal or BLE Device Info
196
197 2. Turn on MAC Bluetooth
198
199 3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
200
201 [[image:image-20240802162132-1.png||_mstalt="427778" height="557" width="907"]]
202
203
204 4.Click Connect, find the read/write window, and you can complete the communication with the device.
205
206 [[image:image-20240802162318-2.png||_mstalt="430144" height="558" width="892"]]