Skip to content

pcsquirrel/mycontroller

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 

Repository files navigation

MyController.org - The Open Source Controller for mysensors.org

About

MyController.org is a controller for the MySensors project. Considered system resources in mind. Even we can run it on Raspberry PI (256 MB) very first model.

System Requirement

MyController.org server is very lightweight, It required very less resource, believe me ;)

  • Disk : ~30 MB

  • Memory(RAM) : 40 MB

  • Java : 1.8 or later

    NOTE: Tested up to 3 nodes and 10 sensors with the above configuration.
Supported Platforms (tested)

MyController.org is java based application server. We can run it in any platform which supports Java.

  • Linux

  • Windows

  • Raspberry PI (Oracle Java recommend)

Available Features

Features available in 0.0.2-alpha1 version,

  • Supports only Serial Gateway

  • Auto discover and update nodes(upon nodes restart or receive any data)

  • Timer - Help you schedule time based operations. You can control till the seconds. Types,

    • Normal (daily, weekly, monthly)

    • Cron

    • Before/After Sun Rises and Sun Sets

  • Alarm - based on information received from sensor

    • Notifications: Send Payload to another sensor, Sens SMS, Send Email

  • Graphical reports (Last one hour, 24 hours, 30 days, years)

  • Forward payload from one sensor to another sensor

  • Logs report

  • Send Payload to sensor

  • Reboot, Erase EEPROM, Update Firmware for any nodes which is running with MYSBootloader

  • Maintain firmware for all the nodes

  • Display battery level of node

  • Unique Identification number for each sensor

  • MyController.org server health status

Installation

Configuration

Extract downloaded bundle where exactly do you want to run. Configuration files located in mycontroller/conf

File: mycontroller.properties

Serial Port Configuration

mcc.serialport.driver.type=auto
mcc.serialport.name=/dev/ttyUSB0
mcc.serialport.baud.rate=115200
  • mcc.serialport.driver.type: Available driver types: pi4j, jssc, jserialcomm, auto. It is recommended to keep in auto. For now jssc driver is not stable with MyController.org

  • mcc.serialport.name : will vary based on platform and number of ports. Find it on your computer and update

  • mcc.serialport.baud.rate : by default Serial Gateway uses 115200. If you changed on your setup you have to update your custom value here.

Database Configuration

mcc.h2db.location=../conf/mycontroller

You can change default location and file name. File will be stored with the file extension .h2.db. Do not add file extenstion.

Web server configuration

enable.https=true
http.port=8443
ssl.keystore.file=../conf/keystore.jks
ssl.keystore.password=password
ssl.keystore.type=JKS
  • enable.https : Enable/disable https. Only one protocol supported at a time.

  • http.port : Port number you want to access MyController.org server

  • ssl.keystore.file, ssl.keystore.password, ssl.keystore.type : If https is enabled these fields are mandatory.

Default username/password: admin/admin

Important
Change default ssl.keystore.file and ssl.keystore.password and https protocol is recommended

Logger configuration

Configuration File Name: logback.xml

Default log file location: logs/mycontroller.log

Start/Stop Server

Executable scripts are located in mycontroller/bin/

  • Linux

    • Start : ./start.sh

    • Stop : ./stop.sh

  • Windows

    • Start : Double click on start.bat

    • Stop : Ctrl+C

  • Other Platforms

java -Xms8m -Xmx40m -Dlogback.configurationFile=../conf/logback.xml -Dmc.conf.file=../conf/mycontroller.properties -jar ../lib/mycontroller-standalone-0.0.1-single.jar

About

The Open Source Controller for mysensors.org

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 46.9%
  • JavaScript 23.8%
  • CSS 17.9%
  • HTML 11.0%
  • Other 0.4%