/ble-demo-app

Discover & Control Bluetooth Low Energy Devices

Primary LanguageJavaScriptBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

BLE Demo App

Discover & Control Bluetooth Low Energy Devices

Preamble

What is this thing?

This is a Cordova project which builds a mobile application (tested on iOS 9, Android soon™) that allows the user to discover and write to nearby Bluetooth low energy devices en masse. This project could serve as a starting point for individuals seeking to quickly begin developing an application to communicate with Bluetooth low energy devices.

Why is this a thing?

Here at Jewelbots, we're developing BLE wearable devices; ones which we often find ourselves in need of a simple way to control. This application is particularly useful when demonstrating specific features of our devices in a setting where typical operation is not feasible (on stage, at trade shows, etc.). We've made it OSS because that's the right thing to do.

How can I help?

If you find this project useful and run across any issues, please feel encouraged to open an issue, or better yet — submit a pull request (if you can)! Feature requests that would enable this application to appeal to a broader audience are also welcome. We would also love to hear from you if you build something awesome!

Requirements

Operating System

Although you may develop and emulate the application in any browser, OS X is required to actually build the application for iOS. No such requirements exist for Android builds.

System Tools

This project assumes that you will be building the application for both iOS and Android. Thus, you will need to install the build toolchains for both of these mobile environments.

OS X

The preferred way to install required system tools on OS X is to make use of homebrew. We will assume you have already installed homebrew:

  • brew install ant — Install Apache Ant, a build tool for Java applications (Android).

If you don't already have Node.js installed, and don't have immediate plans to use it for any other projects, you may also install this via homebrew:

  • brew install homebrew/versions/node4-lts — Install Node.js, a JavaScript runtime environment (used for building front-end assets).

Installation

  1. Download the pre_setup.sh file to wherever you keep your projects. (For instance, I keep mine in ~/src).
  2. Open a command prompt, and type: source ./pre_setup.sh
  3. Once it's finished, cd into the directory it created: ble-blaster.
  4. To build, run grunt build.
  5. To run in a web browser: grunt serve

Troubleshooting

No troubleshooting information yet. Please submit a PR if you've solved an issue that you encounter with this project.