Wiki source code of BLE Bluetooth Remote Configure

Version 199.1 by Yi Wang on 2025/02/13 17:28

version	line-number	content
98.1	1	Table of Contents:
8.2	2
98.1	3	{{toc/}}
37.1	4
98.1	5
	6
	7
190.1	8	= 1. Overview =
8.2	9
	10
85.2	11	There are some new models of Dragino sensors support BLE[[type the link label>>attach:DeviceTool_1.1.apk]] remote configure. User can use mobile phone to configure the sensor via BLE.
1.1	12
	13
190.1	14	= 2. Support Models =
1.1	15
8.2	16
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
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" %)(((
38.1	27	All models with -LB, -LS , -NB, -NS, -CB, -CS suffix
190.1	28	)))\|(% style="width:439px" %)(((
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
8.2	32
2.1	33	* Press button to active device.
8.2	34
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.
33.1	38	)))\|(% style="width:211px" %)
3.1	39
190.1	40	= 3. How to connect =
8.1	41
190.1	42	== 3.1 Use Dragino Device Tool to configure or upgrade firmware ==
8.2	43
190.1	44	=== 3.1.1 How to download ===
8.2	45
132.1	46	==== 3.1.1.1 Download from Google Play Store ====
8.2	47
132.1	48
123.1	49	Open the Google Play Store, search for "Devices.tool", download and install.
8.1	50
190.1	51	[[image:image-20241230134826-1.png\|\|_mstalt="429767" height="292" width="514"]]
8.1	52
190.1	53	(% class="box errormessage" %)
188.1	54	(((
	55	Note: APPLE version is not ready yet.
	56	)))
8.1	57
132.1	58
188.1	59	==== 3.1.1.2 Download from Dropbox ====
161.1	60
132.1	61
152.1	62	Click on the URL below to enter Dropbox to download the app:
	63
189.1	64	[[Download link>>url:https://www.dropbox.com/scl/fo/gyscmfn1s03oz3n8rif8w/AJW7JoMQsQ56dtlls2SNf9c?rlkey=3q2cxwriyzh26vuairx01yebc&st=be5jv92w&dl=0]]
152.1	65
161.1	66
190.1	67	=== 3.1.2 How to use BLE to configure Sensors ===
8.1	68
103.1	69
190.1	70	See Video Instruction: [[Use BLE to configure Sensors>>https://youtube.com/shorts/Ajq2NvUslnw?feature=share]]
105.1	71
	72
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).
8.1	74
190.1	75	[[image:image-20241230135129-4.png\|\|_mstalt="429988" height="134" width="502"]]
55.2	76
190.1	77	[[image:image-20241230152054-8.png\|\|_mstalt="430092" height="241" width="504"]]
55.2	78
	79
123.1	80	After the connection is successful, enter the interface and click (% style="color:blue" %)"DIALOGBOX".
55.2	81
	82
190.1	83	[[image:image-20241230151129-6.png\|\|_mstalt="430092" height="413" width="507"]]
55.2	84
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.
8.1	86
190.1	87	[[image:image-20241230152403-9.png\|\|_mstalt="429741" height="232" width="506"]]
30.1	88
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.
8.1	90
190.1	91	[[image:image-20241230151602-7.png\|\|_mstalt="429000" height="568" width="348"]]
55.2	92
91.1	93
103.1	94	(% style="color:red" %)Note:
55.2	95
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.
55.2	97
190.1	98	[[image:image-20241230153041-10.png\|\|_mstalt="449423" height="599" width="353"]]
55.2	99
85.2	100
190.1	101	=== 3.1.3 How to use Mobile Phone to upgrade firmware ===
55.2	102
190.1	103	==== 3.1.3.1 NB / CB series ( Use BLE to upgrade firmware) ====
55.2	104
103.1	105
190.1	106	See Video Instruction: [[Use BLE to Upgrade Firmware>>https://www.youtube.com/watch?v=fErXzc6m0gU]]
105.1	107
	108	(% id="cke_bm_120427S" style="display:none" %)
55.2	109
105.1	110	Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)"Upgrade Device"(%%).
	111
190.1	112	[[image:image-20241230153300-11.png\|\|_mstalt="449098" height="83" width="326"]]
55.2	113
	114
103.1	115	Select the device type and click "NB".
91.1	116
190.1	117	[[image:image-20250110114321-2.png\|\|_mstalt="425568" height="189" width="317"]](% title="Click and drag to resize" %)
55.2	118
85.2	119	(% id="cke_bm_120427E" style="display:none" %) (%%)
55.2	120
192.1	121	Enter the IMEI (DEV EUI) of the upgraded device, enter the password (PIN), click "SELECT UPGRADE FILE" to find the file you want to upgrade(% style="color:red" %)(The firmware upgrade file format only supports .bin files)(%%), and then click "START". While waiting for the upgrade, let the device reset once. If it keeps stopping on the download screen, you can try pressing the reset button of your device.If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.
85.2	122
103.1	123	(% style="color:red" %)Note: The password check function will only take effect if the DRAGINO NB bootloader is v1.3. If the version is earlier than 1.3, whether the password is entered correctly does not affect the NB upgrade.
85.2	124
190.1	125	[[image:image-20241230154001-13.png\|\|_mstalt="449553" height="381" width="327"]]
85.2	126
130.1	127	(% style="color:red" %)⑤ (%%)While waiting for the upgrade, let the device reset once. If it keeps stopping on the download screen, you can try pressing the reset button of your device.
85.2	128
192.1	129	If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.
130.1	130
192.1	131
152.1	132	In addition, the firmware upgrade supports importing the IMEI upgrade file, manually selecting the IMIE required in the file, and the password (PIN) will be entered automatically.
85.2	133
190.1	134	[[image:image-20241230154747-14.png\|\|_mstalt="455442" height="695" width="324"]]
85.2	135
	136
152.1	137	When the upgrade is complete, it will prompt:"update successfully".
55.2	138
190.1	139	[[image:image-20241230172614-19.png\|\|_mstalt="455000" height="428" width="322"]]
55.2	140
	141
190.1	142	==== 3.1.3.2 LB series ====
85.2	143
190.1	144	* Hardware: [[LA66 USB>>url:https://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LA66%20USB%20LoRaWAN%20Adapter%20User%20Manual/\|\|_mstmutation="1"]]
	145	* Before using LA66 as -LB product to burn firmware, you need to burn the OTA_ firmware for LA66.
	146	* The firmware burning method refers to the LA66 upgrade below.[[Click to redirect.>>https://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/#H3.1.3.3LA66upgrade]]
103.1	147
85.2	148	The LA66 USB connects to the phone via the USB-Type c adapter.
	149
190.1	150	[[image:image-20241207113056-9.png\|\|_mstalt="431366" height="240" width="555"]]
85.2	151
	152
123.1	153	After the connection is successful, the phone will pop up a prompt box, check it and click to confirm.
85.2	154
161.1	155	(% style="color:red" %)Note:
123.1	156
	157	Some mobile phone models need to manually enable the OTG function to properly identify external devices.
	158
190.1	159	[[image:image-20250110114614-3.png\|\|_mstalt="427557" height="654" width="317"]]
85.2	160
90.1	161
190.1	162	(% class="wikigeneratedid" id="H-1" %)
145.1	163	Then, the Device Tool will automatically open.
90.1	164
190.1	165	(% class="wikigeneratedid" %)
145.1	166	Open the Devices Tool and click on (% _mstmutation="1" style="color:blue" %)"Upgrade Device"(%%).
	167
190.1	168	(% class="wikigeneratedid" %)
145.1	169	Select the device type and click "LB".
	170
190.1	171	(% class="wikigeneratedid" %)
145.1	172	Follow the steps in order:
	173
190.1	174	(% class="wikigeneratedid" %)
198.1	175	① Enter the DUIEI,t
86.1	176
190.1	177	(% class="wikigeneratedid" %)
102.1	178	② Enter the PIN (the PIN is the last 8 bytes of APPSKEY),
86.1	179
190.1	180	(% class="wikigeneratedid" %)
198.1	181	③ Select the LoRa frequency to match the original frequency of the node,
90.1	182
190.1	183	(% class="wikigeneratedid" %)
136.1	184	④ Choose the upgrade file,(% style="color:red" %)(The firmware upgrade file format only supports .bin files)
90.1	185
190.1	186	(% class="wikigeneratedid" %)
192.1	187	⑤ After pressing the device's reset button, click start. (If the upgrade does not start for a long time, you can press the device reset button again.If the user does not wish to open the casing, they can press and hold the KEY until the device flashes a green light; this action is equivalent to pressing the reset button.)
90.1	188
197.1	189	[[image:image-20250213142919-1.png\|\|height="428" width="329"]]
90.1	190
	191
190.1	192	(% class="wikigeneratedid" id="H-2" %)
152.1	193	When the upgrade is complete, it will prompt:"update successfully".
90.1	194
190.1	195	[[image:image-20241230163315-18.png\|\|_mstalt="454038" height="443" width="328"]]
90.1	196
145.1	197
190.1	198	==== 3.1.3.3 LA66 upgrade ====
145.1	199
152.1	200	The LA66 USB connects to the phone via the USB-Type C adapter.
145.1	201
190.1	202	[[image:image-20241207113056-9.png\|\|_mstalt="431366" height="240" width="555"]]
145.1	203
	204
152.1	205	After the connection is successful, the phone will pop up a prompt box, check it, and click to confirm.
145.1	206
161.1	207	(% style="color:red" %)Note:
145.1	208
	209	Some mobile phone models need to manually enable the OTG function to properly identify external devices.
	210
190.1	211	[[image:image-20250110114614-3.png\|\|_mstalt="427557" height="654" width="317"]]
145.1	212
	213
190.1	214	(% class="wikigeneratedid" id="H-1" %)
145.1	215	Then, the Device Tool will automatically open.
	216
190.1	217	(% class="wikigeneratedid" %)
145.1	218	Follow the steps in order:
	219
190.1	220	(% class="wikigeneratedid" %)
	221	① Click "SELECT UPGRADE FILE" to choose the firmware to upgrade.
145.1	222
190.1	223	(% class="wikigeneratedid" %)
191.1	224	In order to ensure that the LA66 USB works properly, make sure that there is a corresponding bootloader before updating the firmware. If you don't have a bootloader, you need to use the "Tremo Programmer" software to download it.
190.1	225
	226	(% class="wikigeneratedid" %)
145.1	227	② Click "START".
	228
190.1	229	(% class="wikigeneratedid" %)
160.1	230	③ Press the reset key on the LA66 device.
145.1	231
190.1	232	(% class="wikigeneratedid" %)
184.1	233	For LA66 USB LoRaWAN Adapter v1.2, the design of the reset button has been eliminated on the hardware.
145.1	234
160.1	235
190.1	236	(% class="wikigeneratedid" %)
	237	[[image:image-20250110134640-5.png\|\|_mstalt="428480" height="294" width="319"]]/
145.1	238
190.1	239	[[image:image-20250110135354-8.png\|\|_mstalt="430612" height="253" width="319"]]
145.1	240
152.1	241	When the upgrade is complete, it will prompt:"update successfully".
145.1	242
190.1	243	[[image:image-20250110134822-6.png\|\|_mstalt="429494" height="446" width="323"]]
145.1	244
	245
190.1	246	=== 3.1.4 How to export logs ===
55.2	247
103.1	248
55.2	249	Open the Devices Tool and click the icon in the upper right corner.
	250
190.1	251	[[image:image-20241230155425-16.png\|\|_mstalt="454233" height="85" width="330"]]
55.2	252
	253
	254	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.
	255
190.1	256	[[image:image-20241230155528-17.png\|\|_mstalt="455936" height="324" width="327"]]
55.2	257
	258
190.1	259	== 3.2 How to use PC to connect? ==
11.1	260
25.2	261
19.1	262	Firstly, a USB to Bluetooth host is required
	263
190.1	264	[[image:image-20230601152915-3.png\|\|_mstalt="430144"]]
19.1	265
	266
190.1	267	[[image:image-20230601152950-4.png\|\|_mstalt="430118"]]
25.2	268
19.1	269	Insert the Bluetooth host into the computer
	270
190.1	271	[[image:image-20230518151327-5.png\|\|_mstalt="431535"]]
19.1	272
25.2	273
19.1	274	Open the serial port assistant on the computer
	275
190.1	276	[[image:image-20230518145316-3.png\|\|_mstalt="431054" height="560" width="730"]]
19.1	277
	278	Then connect according to the operating instructions of the purchased Bluetooth host
	279
	280	(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)
	281
	282	The Bluetooth name to be connected is the DEVEUI of the node
	283
190.1	284	[[image:image-20230518151444-6.png\|\|_mstalt="431847"]]
21.1	285
	286
190.1	287	= 4. Access Password and Command =
21.1	288
	289
25.2	290	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.
	291
21.1	292	For AT Commands list please refer user manual for each sensor.
	293
190.1	294	[[image:image-20240204111711-2.png\|\|_mstalt="426413"]]
36.1	295
	296
190.1	297	= 5. Use MAC Bluetooth to connect to nodes =
36.1	298
37.1	299
36.1	300	1.Download BLE terminal or BLE Device Info
	301
	302	2. Turn on MAC Bluetooth
	303
	304	3.Open the Bluetooth tool, check the Bluetooth list, and find the device name
	305
190.1	306	[[image:image-20240802162132-1.png\|\|_mstalt="427778" height="557" width="907"]]
36.1	307
127.1	308
36.1	309	4.Click Connect, find the read/write window, and you can complete the communication with the device.
	310
190.1	311	[[image:image-20240802162318-2.png\|\|_mstalt="430144" height="558" width="892"]]

Wiki source code of BLE Bluetooth Remote Configure

Applications

Navigation