Jewelbots/ble-demo-app

Name: ble-demo-app

Owner: Jewelbots

Description: Discover & Control Bluetooth Low Energy Devices

Created: 2016-01-12 02:23:17.0

Updated: 2017-03-29 14:20:55.0

Pushed: 2016-01-20 17:04:53.0

Homepage: null

Size: 2356

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

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:

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:

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.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.