RaspberryPI Web Remote

Introduction

This project implements a simple remote control web application that allows users to monitor and modify the states of the RaspberryPI's GPIO pins.

Key Features

Pi-Hosted Web Application. No need to install an app on each device.
Define pins as input/output and name them for easy access.
Script GPIO pin actions.
UI is updated asynchronously by socket.io
Runs on any device with a modern web browser.
Great starting point for home automation or remote management projects.
Support for sending ASCII serial commands to external devices such as Arduino.

Android Screenshots

###Home

GPIO Settings

Serial Settings

Hardware Architecture

Raspberry Pi (written and tested on Model B) running Raspbian.
A client device with a web browser.
Something to control via GPIO :)

Software Stack

Raspbian
PM2/NodeJS
socket.io
Express
Angular
UI-Bootstrap

Setup Environment

This guide starts from scratch. Please begin where appropriate for you!

Download Raspbian Jessie Lite from https://www.raspberrypi.org/downloads/raspbian/ install using the standard procedure.
Power up your RaspberryPI and complete the initial configuration.
```
$sudo raspi-config
```

Run apt-get to update the system.

$ sudo apt-get update
$ sudo apt-get ugrade

Download the latest (or preferred) version of node-js from https://nodejs.org/dist/

For RaspberryPI A/B use linux-armv6l
For RaspberryPI 2 use linux-armv7l

Unpack node by running

$ tar xvf node-vX.X.X-linux-armvXl.tar.gz

Add the extracted node-vX.X.X-linux-armvXl/bin directory to your PATH environment variable by modifying /etc/profile and adding the following line to the end.
```
export PATH=${PATH}:/path/to/node-vX.X.X-linux-armvXl/bin
```
Save /etc/profile and quit your editor.
Add this directory to your sudo's path by modifying the path variable through visudo
```
$ sudo visudo
```
Add :/path/to/node-vX.X.X-linux-armvXl/bin to the secure path, save and exit.
Reboot to reload your environment
Test node and npm with
```
$ npm --version
$ node --version
```
Install git to clone repositories
```
$ sudo apt-get install git
```

Install PM2 globally and instruct it to run at boot.

$ sudo npm install -g pm2
$ sudo pm2 startup debian

Clone this repository to your device.

$ git clone https://github.com/BashEdThomps/IoT-RaspberryPI.git

Navigate to the repository
```
$ cd IoT-RaspberryPI
```
Install the application.
```
$ ./install
```
This will install all node dependencies and configure PM2 to start the application at boot.
Restart your RaspberryPI. PM2 will automatically start the application.
Use a browser to navigate to your RaspberryPI on the port specified in your configuration.
```
http://my-pi
```
Control your device :)

Updating the Application

The application can be updated by clicking the 'update' button on the 'System' page, or run the update command from the repository's root directory to update the application.

./update

Using Serial Functionality

The application also allows the user to send ASCII commands to a device connected via a USB/Serial interface, such as an Arduino.

To configure serial click the settings cog at the bottom of the home screen.
Check the "Enable Serial" check-box in the "Serial" section.
Choose your serial device and baud rate from the list available.
Add serial commands to the application.
Save your settings by clicking the green 'save' button. An alert will indicate success/failure.
Execute commands from the home page.

Example Arduino Sketch

To control a device via serial, the remote sends commands in the form of ASCII characters to the device. An Arduino can be controlled by listening for commands on each iteration of the main loop and switching the executing method as appropriate. An example sketch of this implementation is shown below.

/*
  Basic State Machine
  Ash Thompson
  ashthompson06@gmail.com
*/

/* Constants */

// Serial Speed
const int SERIAL_BAUD = 9600;

// Commands
const int RAINBOW = 49; // 1 in ASCII
const int FLASH = 50;   // 2 in ASCII

// LED Pin
const int LED_PIN = 3;

// Delay Times
const int RAINBOW_DELAY = 200;
const int DEFAULT_DELAY = 10;
const int FLASH_DELAY = 1000;

/* Variables */
int itr = 0;
int state = 0;

/* Arduino Setup */
void setup()
{
 initPins();
 Serial.begin(SERIAL_BAUD);
}

/* Main Loop */
void loop()
{
  if (Serial.available())
  {
    state = Serial.read();
  }

  switch (state)
  {
    case RAINBOW:
      doRainbow();
    break;
    case FLASH:
      doFlash();
    break;
    default:
      doDefault();
      break;
  };

  itr++;
}

/* Initialise IO pins */
void initPins()
{
 pinMode(LED_PIN, INPUT);
}

/* Rainbow Comand */
void doRainbow()
{
 digitalWrite(LED_PIN, (itr % 2 == 0 ? HIGH : LOW));
 delay(RAINBOW_DELAY);
 return;
}

/* Flash Command */
void doFlash()
{
  digitalWrite(LED_PIN, (itr % 2 == 0 ? HIGH : LOW));
  delay(FLASH_DELAY);
  return;
}

/* Default Command */
void doDefault()
{
  digitalWrite(LED_PIN,LOW);
  delay(DEFAULT_DELAY);
  return;
}

Bonus Section

RaspberryPI GPIO Pinouts

Courtesy of http://raspi.tv/wp-content/uploads/2014/07/Raspberry-Pi-GPIO-pinouts.png

octronic-uk / rpi-web-remote