Skip to content

Commit e703718

Browse files
committed
Update README.adoc
1 parent 315415c commit e703718

File tree

1 file changed

+109
-0
lines changed

1 file changed

+109
-0
lines changed

README.adoc

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,111 @@
11
= Mycontroller.org - The Open Source Controller for mysensors.org
22
:source-language: java, angularjs
3+
4+
== About
5+
6+
*MyController.org* is a controller for the http://www.mysensors.org/[MySensors] project.
7+
8+
== System Requirement
9+
10+
As MyController.org is very lightweight, Required only
11+
12+
* Disk : ~30 MB
13+
* Memory(RAM) : 40 MB
14+
* Java : 1.8 or later
15+
16+
NOTE: Tested upto 3 nodes and 10 sensors with the above configuration.
17+
18+
===== Supported platformes (tested)
19+
MyController.or is java based application server. We can run it in any platform which supports Java.
20+
21+
- Linux
22+
- Windows
23+
- Raspberry PI
24+
25+
== Available Features
26+
27+
Features available in https://github.com/mycontroller-org/mycontroller/releases/tag/0.0.1[0.0.1] version,
28+
29+
- Supports only http://www.mysensors.org/build/serial_gateway[Serial Gateway]
30+
- Auto discover and update nodes(upon nodes restart or receive any data)
31+
- Timer - Help you schedule time based operations. You can control till the seconds. Types,
32+
* Normal (daily, weekly, monthly)
33+
* Cron
34+
* Before/After Sun Rises and Sun Sets
35+
- Alarm - based on information received from sensor
36+
* Notifications: Send Payload to another sensor, Sens https://www.plivo.com/[SMS], Send Email
37+
- Graphical reports (Last one hour, 24 hours, 30 days, years)
38+
- Forward payload from one sensor to another sensor
39+
- Logs report
40+
- Send Payload to sensor
41+
- Reboot, Erase EEPROM, Update Firmware for any nodes which is running with https://github.com/mysensors/Arduino/tree/master/MYSBootloader[MYSBootloader]
42+
- Maintain firmware for all the nodes
43+
- Display battery level of node
44+
- Unique Identification number for each sensor
45+
- MyController.org server health status
46+
47+
== Installation
48+
49+
====== Download(executable bundle),
50+
51+
* https://github.com/mycontroller-org/mycontroller/releases/download/0.0.1/mycontroller-standalone-0.0.1-bundle.zip[mycontroller-standalone-0.0.1-bundle.zip]
52+
* https://github.com/mycontroller-org/mycontroller/releases/download/0.0.1/mycontroller-standalone-0.0.1-bundle.tar.gz[mycontroller-standalone-0.0.1-bundle.tar.gz]
53+
54+
====== Configuration
55+
56+
Extract downloaded bundle where exactly do you want to run. Configuration files located in `mycontroller/conf`
57+
58+
File: `mycontroller.properties`
59+
60+
*Serial Port Configuration*
61+
```
62+
mcc.serialport.driver.type=auto
63+
mcc.serialport.name=/dev/ttyUSB0
64+
mcc.serialport.baud.rate=115200
65+
```
66+
- `mcc.serialport.driver.type`: Available driver type: `pi4j, jssc, jserialcomm, auto`. It is recommended to keep in `auto`.
67+
- `mcc.serialport.name` : will vary based on platform and number of ports. Find it in your computer and update
68+
- `mcc.serialport.baud.rate` : by default http://www.mysensors.org/build/serial_gateway[Serial Gateway] uses `115200`. If you changed on your setup you have to update your custom value
69+
70+
*Database Configuration*
71+
```
72+
mcc.h2db.location=../conf/mycontroller
73+
```
74+
You can change default location.
75+
76+
*Web server configuration*
77+
```
78+
enable.https=true
79+
http.port=8443
80+
ssl.keystore.file=../conf/keystore.jks
81+
ssl.keystore.password=password
82+
ssl.keystore.type=JKS
83+
```
84+
- `enable.https` : Enable/disable https. Only one protocol supported.
85+
- `http.port` : Port number you want to access MyController.org server
86+
- `ssl.keystore.file, ssl.keystore.password, ssl.keystore.type` : If https is enabled these fields are mandatory.
87+
88+
IMPORTANT: Change default `ssl.keystore.file` and `ssl.keystore.password`
89+
90+
*Logger configuration*
91+
92+
Configuration File Name: `logback.xml`
93+
94+
Default log file location: `logs/mycontroller.log`
95+
96+
====== Start/Stop Server
97+
Executable scripts are located in `mycontroller/bin/`
98+
99+
* Linux
100+
- Start : `./start.sh`
101+
- Stop : `./stop.sh`
102+
103+
* Windows
104+
- Start : Double click on `start.bat`
105+
- Stop : `Ctrl+C`
106+
107+
* Other Platforms
108+
109+
```
110+
java -Xms8m -Xmx40m -Dlogback.configurationFile=../conf/logback.xml -Dmc.conf.file=../conf/mycontroller.properties -jar ../lib/mycontroller-standalone-0.0.1-single.jar
111+
```

0 commit comments

Comments
 (0)