JavaScript Library
Javascript Library for BleuIO . Supports v2.7.1 Firmware
Requirments
- Chrome 78 or later and you need to enable the #enable-experimental-web-platform-features flag in chrome://flags
- BleuIO
To enable the flag Open chrome://flags/#enable-experimental-web-platform-features in Google Chrome browser.
Installation
Install the library by running
npm i bleuio
In the js file, import
import * as my_dongle from 'bleuio'
You are set to go.
Basic Usage
call my_dongle.at_connect() to connect to the dongle. Note : you have to wait for the dongle to load.
console.log(my_dongle.ati()) will return a promise with device information. my_dongle.at_central() will set te device into central mode.
###Example index.html
<button id="connect">Connect</button>
<button id="deviceinfo">Device Info</button>
<button id="central">Central Mode</button>
<button id="peripheral">Peripheral Mode</button>
.....
<script type="module" src="./index.js"></script>
index.js
import * as my_dongle from 'bleuio'
document.getElementById('connect').addEventListener('click', function(){
my_dongle.at_connect()
})
document.getElementById('deviceinfo').addEventListener('click', function(){
//my_dongle.ati().then((data)=>console.log(data))
console.log(my_dongle.ati())
})
....
To run the script you need a web application bundler. You can use parceljs. https://parceljs.org/getting_started.html Follow this video for better understanding https://youtu.be/MZfeV61gjeY
Available functions
| Nmae | Details |
|---|---|
| at_connect() | Connects to dongle |
| at_disconnect() | Disconnects the dongle. |
| ata() | Shows/hides ASCII values from notification/indication/read responses.ata(0)hides the ASCII values, ata(1) shows the ASCII values |
| atasps() | Toggle between ascii and hex responses received from SPS. atasps(0) shows hex values, atasps(1) shows ASCII. ASCII is on by default. |
| ati() | Device information query. Returns firmware version, hardware type and unique organization identifier. ex: my_dongle.ati() |
| atds() | Turns auto discovery of services when connecting on/off. atds(0) off, atds(1) on. On by default. This command can be used in both central and peripheral role. |
| ate() | Turn echo on/off. 0/1 (On per default). ex my_dongle.ate(0) |
| at_autoexec() | Sets or displays up to 10 commands that will be run upon the BleuIO starting up.example at_autoexec('AT+ADVSTART') . Parameter if left empty it will show a list of auto execution query set previously. |
| at_central() | Sets the device Bluetooth role to central role. ex: my_dongle.at_central() |
| at_clrautoexec() | Clear any commands in the auto execute (AUTOEXEC) list. |
| at_customservice() | Sets or queries Custom Service. Max 5 Characteristics can be added. Pass value in this format at_customservice('0=UUID=ee6ec068-7447-4045-9fd0-593f3ba3c2ee'). Follow BleuIO documentaion for AT+CUSTOMSERVICE. Several values cannot be changed while connected/connecting or advertising. |
| at_customservicestart() | Starts the Custom Service based on the settings set by AT+CUSTOMSERVICE= Command.Cannot be started while connected/connecting or advertising. |
| at_customservicestop() | Stops the Custom Service. Cannot be changed while connected/connecting or advertising. |
| at_customservicereset() | Stops the Custom Service and resets the Custom Service settings set by the AT+CUSTOMSERVICE= command to it's default values. Cannot be changed while connected/connecting or advertising. |
| at_peripheral() | Sets the device Bluetooth role to peripheral. ex: my_dongle.at_peripheral() |
| at_advstart() | Starts advertising. ex: my_dongle.at_advstart() |
| at_advstop() | Stops advertising. Returns ERROR if not already advertising. ex: my_dongle.at_advstop() |
| at_advdata() | Sets or queries the advertising data. Data must be provided as hex string. |
| at_advdatai() | Sets advertising data in a way that let's it be used as an iBeacon.ex: my_dongle.at_advdatai('ebbaaf47-0e4f-4c65-8b08-dd07c98c41ca0000000000') |
| at_advresp() | Sets or queries scan response data. Data must be provided as hex string. Changes to take effect after restart of advertising. ex: my_dongle.at_advresp('04:09:43:41:54') |
| at_cancelconnect() | While in Central Mode, cancels any ongoing connection attempts. ex: my_dongle.at_cancelconnect() |
| at_clearindi() | Disables indication for selected characteristic. Example at_clearindi('0001') |
| at_connparam() | Sets or displays preferred connection parameters. When run while connected will update connection parameters on the current target connection. Provide connection parameters for example at_connparam('intv_min=intv_max=slave_latency=supervision_timeout'). Follow BleuIO documentation about AT+CONNPARAM |
| at_clearnoti() | Disables notification for selected characteristic. ex: my_dongle.at_clearnoti('0001') |
| at_devicename() | Get or sets the device name used for GAP service. Cannot be set while connected or advertising.if left empty it will query what device name is is set |
| at_dis() | Shows the Device Information Service information to be used. Example at_dis() |
| at_enterpasskey() | Enter the 6-digit passkey to continue the pairing and bodning request. ex: my_dongle.at_enterpasskey('123456') |
| at_findscandata() | Scans for all advertising/response data which contains the search params with number of responses. ex. at_findscandata('FF5',10) |
| at_frssi() | Sets RSSI filter for scan results, afterwards scans will only show results with the chosen max value or below. Acceptable parameter range: -1 to -99 |
| at_gapaddrtype() | Sets or queries what address type the dongle will use. Changing address type cannot be done while advertising or while connected to other devices. example at_gapaddrtype(1) or at_gapaddrtype(2) or at_gapaddrtype(3) or at_gapaddrtype(4) or at_gapaddrtype(5) 1 Public Static Address, 2 Private Static Address, 3 Private Random Resolvable Address, 4 Private Random Non-resolvable Address, 5 Private Random Resolvable address using Bluetooth LE Privacy v1.2 |
| at_gapscan() | Starts a Bluetooth device scan with timer set in seconds. Only accepted when device is in central role and not connected. ex: my_dongle.at_gapscan(5) |
| at_gapconnect() | Initiates a connection with a specific slave device. Upon succesfully connecting atempts to display device name, advertising and response data and the services of the peripheral. The local device must be in central role. ex: my_dongle.at_gapconnect('[1]F3:D1:ED:AD:8A:10') |
| at_gapdisconnect() | Disconnects from a peer Bluetooth device. This command can be used in both central and peripheral role. |
| at_gapdisconnectall() | Disconnects from all connected peer Bluetooth devices. This command can be used in both central and peripheral role. |
| at_gapiocap() | Sets or queries what input and output capabilities the device has. pass number between 0 to 4. 0 - Display only, 1 - Display + yes & no, 2 - Keyboard only, 3- No input no output, 4 - Keyboard + display |
| at_gappair() | Starts a pairing or bonding procedure. Depending on whether the device is master or slave on the connection, it will send a pairing or a security request respectively. Only usable when connected to a device. |
| at_gapunpair() | Unpair paired devices. This will also remove the device bond data from BLE storage. Usable both when device is connected and when not. Leave blank to unpair all paired devices or selected paired device (device_mac_address). Public= [0] or private= [1] address type prefix required before mac address. ex: [x]xx:xx:xx:xx:xx:xx |
| at_gattcread() | Read attribute of remote GATT server. Can only be used in Central role and when connected to a peripheral. ex at_gattcread('001B') |
| at_gattcwrite() | Write attribute to remote GATT server in ASCII. Can only be used in Central role and when connected to a peripheral. ex at_gattcwrite('001B','HELLO') |
| at_gattcwriteb() | Write attribute to remote GATT server in Hex. Can only be used in Central role and when connected to a peripheral.ex at_gattcwriteb('001B','0101') |
| at_gattcwritewr() | Write (without response) attribute to remote GATT server in ASCII. Can only be used in Central role and when connected to a peripheral. |
| at_gattcwritewrb() | Write (without response) attribute to remote GATT server in Hex. Can only be used in Central role and when connected to a peripheral. |
| at_getservices() | Rediscovers a peripheral's services and characteristics. |
| at_getservicesonly() | Discovers a peripherals services. |
| at_getservicesdetails() | Discovers all characteristics and descriptors of a selected service. Must run at_getservicesonly() command first to get the service handle. Example at_getservicesdetails('0001') |
| at_indi() | Shows list of set indication handles. Example at_indi() |
| at_mtu() | Sets the max allowed MTU size. Cannot be changed while connected/connecting or advertising. Minimum allowed value: 67, Maximum allowed value: 512 |
| at_numcompa() | Used for accepting a numeric comparison authentication request or enabling/disabling auto-accepting numeric comparisons. 0 or 1. 0 for disabled 1 for enable. Enabled by default. |
| at_noti() | Shows list of set notification handles. Example at_noti() |
| at_spssend() | Send a message or data via the SPS profile. Without parameters it opens a stream for continiously sending data. ex: my_dongle.at_spssend('Hello') |
| at_scantarget() | Scan a target device. Displaying it's advertising data as it updates. You need to add target device information and number of response . ex : my_dongle.at_scantarget('[1]FE:D4:2E:CD:72:78',15) |
| at_seclvl() | Sets or queries what minimum security level will be used when connected to other devices.leave blank for quering security level or set security level from 1 to 3. 1- No authentication and no encryption, 2-Unauthenticated pairing with encryption, 3 -Authenticated pairing with encryption, 4- Authenticated LE Secure Connections pairing with encryption. |
| at_setdis() | Sets the Device Information Service information. example at_setdis(MAN_NAME,MOD_NUM,HW_REV,FW_REV,SW_REV) |
| at_setindi() | Enable indication for selected characteristic. Example at_setindi('0001') |
| at_setnoti() | Enable notification for selected characteristic. |
| at_setpasskey() | Setting or quering set passkey for passkey authentication. leave blank for quering passkey or set six digit passkey. |
| at_suotastart() | Enables the SUOTA Service and start the SUOTA Advertising. Cannot be started while connected/connecting or advertising. |
| at_suotastop() | Disables the SUOTA Service and stops the SUOTA Advertising. Cannot be used while connected/connecting. |
| atr() | Trigger platform reset |
| at_gapstatus() | Reports the Bluetooth role |
| help() | prints AT command list of the dongle |
| stop() | Stops current process |