PLab Mobile Framework

This is a tool app for the programming lab courses at NTNU.

It allows the students to connect to a Bluetooth or Bluetooth LE device with their cell phone.

Communication is serial text based. An interface is provided so that the students may communicate with the Bluetooth/ Bluetooth LE device through a Processing sketch located on an external web server. Interpretation of the sketch is done through Processing.js.

Help, Further Documentation

For further documentation than what is found in this README, API help and description of project architecture, see the project wiki.

Help with the app user interface can also be found in the project wiki.

Prerequisites

To build one must have Apache Cordova installed. This document assume you are familiar with using the Command Line Interface (CLI) of Cordova.

Dependent Plugins

Whitelist

Android require whitelist plugin to load sketches from the web cordova-plugin-whitelist

Network Information

Internet connectivity checks are dependent on plugin cordova-plugin-network-information.

Bluetooth LE Support

Depends on plugins cordova-plugin-device and cordova-plugin-bluetoothle, Check out project source.

A word of caution: The iOS version of this app has not been tested after updating to 3.x version of this plugin. So we recommend testing thoroughly if a build to iOS is performed.

Bluetooth Support (Android only)

Depends on plugin cordova-plugin-bluetooth-serial. As of version 2.0.0 of this app, use of this plugin will depend on cordova-plugin-device to filter out iOS devices.

Vibration

Vibration of device is dependent on plugin cordova-plugin-vibration

Acceleration

Acceleration detection is dependent on plugin cordova-plugin-device-motion

Installation of Plugins With Command-Line Interface

In console, type:

• cordoca plugin add cordova-plugin-whitelist
• cordova plugin add cordova-plugin-device
• cordova plugin add cordova-plugin-network-information
• cordova plugin add cordova-plugin-bluetoothle
• cordova plugin add cordova-plugin-bluetooth-serial
• cordova plugin add cordova-plugin-vibration
• cordova plugin add cordova-plugin-device-motion

Installation and Build

Adding Platforms

Add the platform you wish to build to (iOS or Android).

• cordova platform add android
• cordova platform add ios

Adding Plugins

See section Dependent Plugins

Build

Build to one or more platforms

• cordova build

Run on Android Device

• cordova run android

This project is powered by

• Apache Cordova
• Processing.js