VoffCon

| Readme | Device setup | YouTube channel |

VoffCon is a system for controlling devices and appliances from anywere. It is made up by two components. A node server and A device server. The main benefits of this system is your ability to create your own Controls and Cards, which other users logged in to your system can use to control devices you deside to put on your Cards.

Intoduction

The node server

Is a server created with node.js. This server creates webpages which can be viewed in a web browser like Google Chrome, Microsoft Edge and Internet Explorer. If you portforward the server out to the internet you will be able to accsess your devices from anywhere. It uses the Passport authentication middleware to keep your devices from being controlled by everyone. The server provides connections to many devices and uses passport to make sure that the user is authenticated before he is able to give commands to the server running on the devices.

The basics for the node server

Overview

This application is a server intended to run on a computer where it can access the esp8266 and esp32 devices which run running a special server program which was developed for this server in mind.

requirements:

You will need to install the following if you haven't already.

• MongoDb To store users Cards, Controls and device information. (Install tutorials or installing with package manager )
• Node.js To run the Node server
• Arduino IDE To program the devices. ( Video tutorial for windows )
• Device Core libraries for the device servers running on the two devices listed below. (Install instructions)
  • ESP32 Development Module will need the ESP32 Arduino Core ( Video tutorial )
  • NodeMCU 1.0 (ESP-12E Module) will need the ESP8266 core for Arduino ( Video tutorial )

Getting up and running

Run the mongodb server

Windows

Install MongoDb

If MongoDb is not installed you will need to install it. See this instructions how to do that here.

Use windows file explorer to:

• Create the folders "C:\data" and "C:\data\db".
• Then Run the mongo server by Double-clicking on the file "C:\Program Files\MongoDB\Server\3.4\bin\mongod.exe“ .

Or just use the windows command shell, by typing the following commands.

"C:\Program Files\MongoDB\mongod.exe"

Linux

Rasbian

Please see this video tutorial on how install VoffCon on Raspbian

how to run mongodb on run on linux

mongod

Installing VoffCon on Ubuntu 16.04 (Linux) when all prerequisites are missing

Assuming that you do not have Mongodb, nodejs or npm installed. This would be the process you would follow.

Reload local package database

sudo apt-get update

Install the MongoDB packages.

echo "deb http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list
sudo apt-get install -y mongodb-org
# Create dir to store data and run mongodb
sudo mkdir /data
sudo mkdir /data/db
sudo mongod

Install nodejs

sudo apt-get install -y nodejs
sudo apt install npm

Install packages which the VoffCon app server uses and running the server

npm install
node voffcon

And the go to a modern web browser and visit the url http://localhost:6100 to see VoffCon running.

Devices

Device	Description
	NodeMcu Developement Module with ESP8266 is a pretty powerful device compared with the Arduino. it has a on board WiFi, allowing you to control it with a web-brower or a phone. It is a small and cheap device which allows you to control real world devices and appliances via a WiFi connection. A device server needs to be uploaded to this device so the Node server and the Device can comunicate.
	Esp32 Is the next version of the Esp8266 module. This dual-processor development board has also WiFi on board. Additionally it has Bluetooth and is more powerful than the Esp8266. It is also a small and cheap device which allows you to control real world devices and appliances via a WiFi connection. A device server needs to be uploaded to this device so the Node server and the Device can comunicate.

Setting up the device server

Click here to get instructions on how to setup the device server.

More about the system

Users

There are three kinds of users (actors). "administrator", "power user/card creator" and a "normal user".

Administrator

Has the power to change/modify or delete all Cards, and devices. He can also give a user access to a Card, or a device, just like a card creator. This user is the only one who can upgrade, downgrade or delete users. He can f.example change a normal user to "administrator" or a "power user". He can also change a power user back to a normal user. He has total control of everything.

Power user

Is a person who is able to change or create Cards or devices. He needs to know how to upload programs to the devices. He needs to know what a subnet is and basic information about networking. He needs to have access to the routers so he can setup IP addresses for the devices. He is the one who will be adding the available devices for everybody. This person will also be creating Cards. A power user will become a card creator when he has created a Card or has been given access to change a Card.

Card creator

A card creator is a power user which has created a Card. He has the power to grant others access to his Card. He can grant a normal user access to his Card and that will allow the normal user to use his Card. The normal user will also be able to press or view controls on his Card. A Card creator can also grant another power user to have a Card creator privileges for his Card.

User (normal user)

He knows how to use a browser and he also has recived information from the power user on how the Cards work. He knows what the Cards and Do's and Dont's about a device he is able to control using the Cards. All knowledge about the Cards should be supplied by the power user.

Card

A Card is a web-page which the normal user works with. On this Card there are buttons and/or controls which allow the user to change or view the state of the different devices. One Card can include controls for many devices. This Card is created by a power user. The creator of the Card will also be the one who will give other users access to a Card. By default only the user which created the Card will have access to the Card he created. The user card creator can select any user and grant him an access to his Card. The card creator is the only one who can modify it(with the exeption of the administrator). He can grant other power user access to his Card giving them card-creator privileges. No other power user can access his Card without the card-creator’s permission.

Control

A Control is a control class which can be used when creating a Card. These Controls can be thought of as a library. For example, the DiodeCtrl is one of the basic controls. DiodeCtrl is a class which shows an image of a diode. A card creator can use this Control to display a pins values as a diode. SliderCtrl is another basic Control for the the card creator. It provides the user with a easy control of a pins value by allowing him to drag a button on a slider around, to change a pins value. The same user access rules apply to a Control as where described in the Card section above.

Access to devices

If a user wants to access a device then the system will grant him access if the user is a power user. The system will only give a normal user access to a device through a Card that controls the device.

Later additions to the system / nice to have

• Create a visual/drag'n drop editor, allowing power users create Cards more easier.
• Create a visual/drag'n drop editor, allowing power users create controls more easier.
• Show running Cards without the VoffCon menu.

If you are not running VoffCon on Rasbian (32-bit system)

I recommend updating "mongoose" to version "^5.7.6". The version "^4.6.1" is currently selected because it will work on Rasbian. If you will not be running VoffCon on Rasbian, I recommend updating mongoose because of vulnerabilities in mongoose. You can change this in the file package.json

1. Open the root directory of voffcon
2. Open the file "package.json" in a text editor
3. Change this line "mongoose": "^4.6.1", to "mongoose": "^5.7.6",.
4. Save and exit text editor
5. call this command npm i
6. run VoffCon again by calling node voffcon.js

Licence

    VoffCon is a system for controlling devices and appliances from anywhere.
    It consists of two programs.  A “node server” and a “device server”.
    Copyright (C) 2016  Gudjon Holm Sigurdsson

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, version 3 of the License.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

Click here for a copy of the licence.

You can contact the author by sending email to gudjonholm@gmail.com or by regular post to the address Haseyla 27, 260 Reykjanesbar, Iceland..