Skip to content

Project BlueGate is an Online Web-Bluetooth Terminal app that allows you to connect and communicate with other Bluetooth devices via Web-Bluetooth or BLE (Low Energy Bluetooth).

License

Notifications You must be signed in to change notification settings

an36/Project_BlueGate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project BlueGate is an online Web-Bluetooth Terminal that allows users to connect and communicate with other devices via BLE (Low Energy Bluetooth)

Visit Project BlueGate by clicking on the image above or the header title

Features & Specification

  • Allows Bluetooth connection to up to 5 devices per browser's page/tab.
  • Allows READs and WRITEs only from/to devices that have READ, WRITE, & NOTIFY properties enabled.
  • Allows users to add custom (or standard) UUID Bluetooth Services to be able to READ & WRITE from/to specific devices with specific Bluetooth Services.
  • Stores the added Bluetooth Service & UUIDs, under browsers local storage, to be loaded once the user revisits the page; to save time and effort.
  • Allows users to use the Terminal to either send ASCII values to all connected devices at once (by using the 'All' Terminal) or to send ASCII values to individual devices. (If the connected device allows READ, WRITE, & NOTIFY then you shall see a new terminal tab for that device where you can send values to it individually).
  • Allows users to clear individual terminals and to change the background & log colors of all terminals.
  • Allows users to use customizable Shortcut Buttons where the user can cutomize the label & value of a Shortcut Button and use to send that value to the desired device(s).

Help & How To:

I. How to Connect & Disconnect

  1. Make sure that both of your Bluetooth and the desired device's Bluetooth is ON.
  2. Add the desired device's UUID in 'Bluetooth Services' input field (located at top-left corner).
  3. Click the 'Connect' button to Scan and Connect the desired device. After a successful connection, you'll see the name of the device on the left column.
  4. To diconnect a device, simply click the Clear icon next to that device name.

NOTE: Project BlueGate Terminal will allow you to connect to up to 5 devices per browser tab/page.

II. How to use the Terminal

  • If the connected device allows READs, WRITEs, & NOTIFYs, then you shall see a new Terminal tab (next to 'All' tab) where you can communicate with that device.
  • You can simply send a value (formated as ASCII), to 'All' device or individual ones, by typing it into the terminal's input field and clicking 'Send' or pressing 'Enter' key.
  • You can also clear a terminal by clicking Clear and/or change the Terminals colors by clicking Clear.

NOTE: The 'All' Terminal will print the values read from all connected devices. The 'All' Terminal also sends ASCII values to all connected devices, when the user sends a value using the 'All' Terminal. To send values to individual devices, simply open that device's terminal by clicking its tab and send values from there.

III. How to use Shortcut Buttons

The Shortcuts can be used to send a specific value by clicking a Shortcut Button instead of typing that value over and over into the Terminal.

  1. You can assign a value to Shortcuts by clicking Clear.
  2. Clicking Clear will display the settings where you can specify the name (label) and value of each Shortcut.
  3. After that, you can either press the 'Enter' key or click Clear to confirm the desired settings.
  4. Finally, you can send the specified value of a Shortcut by clicking that Shortcut's Button.
  5. You can also clear and restore the default Shortcuts' settings by clicking Clear.

NOTE: A Shortcut, when clicked, will send its specified value to the open terminal's device. I.e., if the 'All' terminal is open, then a Shortcut, when clicked, will send its value to all connected devices. In simpler terms, Shortcuts send their value to the specified (or opened) terminal.

IV. General Notes

  1. The UUIDs added by the user, in 'Bluetooth Services', will get stored locally. Meaning, the added UUIDs will get loaded once the user revisits the page; to save time and effort.
  2. If an added UUID is causing an error, then that UUID can be removed from the 'Bluetooth Services' by selecting (or typing) that UUID and clicking 'Remove' or pressing the 'Enter' key.
  3. The 'Add' button changes to 'Remove' when an added UUID is selected or typed into 'Bluetooth Services'.

About

Project BlueGate is an Online Web-Bluetooth Terminal app that allows you to connect and communicate with other Bluetooth devices via Web-Bluetooth or BLE (Low Energy Bluetooth).

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published