105 lines
5.9 KiB
Markdown
105 lines
5.9 KiB
Markdown
## Overview
|
|
|
|
A follow up to the dPWR Perl based Power Controller, I started to convert it into a Java version using Jetty and Java Servlets, named it jDPWR, with the purpose to allow it's use on more platforms than the Perl based dPWR. During the conversion I got sidetracked with VHDL pushing this project out to a future date. I will eventually finish it off but it is a good starting place for anyone wanting to develop a java based controller.
|
|
|
|
## jDPWR Installation
|
|
|
|
Assuming a Unix based OS:
|
|
1. Clone the repository.
|
|
2. Install Maven.
|
|
3. Build the jar:<br>
|
|
cd \<project root directory>/jDPWR<br>
|
|
mvn clean package<br>
|
|
4. Manually edit the JSON config file \<project root directory>/jDPWR.cfg<br>
|
|
Change http::serverHost to a valid IP for your machine.<br>
|
|
Change http::serverPort to a value suitable for your machine, ie: 8080<br>
|
|
5. Run the application<br>
|
|
cd target<br>
|
|
java -jar jDPWR-\<version>.jar<br>
|
|
6. Open a web browser and enter http://\<your IP>:\<your Port>
|
|
|
|
## jDPWR Web Interface
|
|
|
|
As per the dPWR Perl version, the jDPWR application has a comprehensive web interface. It is designed around the Charisma framework ((C) Muhammad Usman) converted to be served with the Eclipse Jetty JSP Server and additional jDPWR specific jsp pages. The following images show the base screens of the web interface which currently exist.
|
|
|
|
|
|
The home screen - blank - but easy enough to add status or other required data/instructions.
|
|
|
|
|
|
The primary output control screen. Each port which is configured for output and enabled is display along with a description and an on/off switch. Simple enough to change a controlled device state.
|
|
|
|
|
|
Options for this screen, setting auto refresh to see updates made by other users etc.
|
|
|
|
|
|
The primary input status screen. Each port which is configured for input and enabled is displayed along with its current value in the form of an on/off switch.
|
|
|
|
|
|
Options for this screen, setting auto refresh to see updates as the ports values change.
|
|
|
|
|
|
A combined input and output screen, you can collapse, close or reorder each block.
|
|
|
|
|
|
Configure a device to be used in the system. Each device has its own driver file, ie: DriverATMega328P.java and DriverTCA6416A.java, it should be relatively straight forward to write a driver for another device.
|
|
|
|
|
|
Clicking on a created device allows you to change the parameters and enable/disable.
|
|
|
|
|
|
New device creation pops up a window for configuration data input.
|
|
|
|
|
|
Configure a port to be used within an enabled device.
|
|
|
|
|
|
Clicking on a port allows you to change the parameters and enable/disable it.
|
|
|
|
|
|
New port creation pops up a window to configure a new port on an enabled device.
|
|
|
|
|
|
Remaining menu items which need jsp pages complete.
|
|
|
|
<br>
|
|
|
|
|
|
#### To Do
|
|
|
|
Complete Web pages (straight forward conversion of dPWR logic):
|
|
|
|
| To Do | Item |
|
|
| ----- | ------------------------------------------ |
|
|
| 1 | Write I/O Setup -> Timers |
|
|
| 2 | Write I/O Setup -> Ping |
|
|
| 3 | Write Status -> I/O Parameters |
|
|
| 4 | Write Status -> Active I/O Ports |
|
|
| 5 | Write Status -> All I/O Ports |
|
|
| 6 | Write Status -> Device Log |
|
|
| 7 | Write Status -> Web Server Log |
|
|
| 8 | Write Settings -> DDNS |
|
|
| 9 | Write Settings -> E-Mail |
|
|
| 10 | Write Settings -> Users |
|
|
| 11 | Write Settings -> Time |
|
|
| 12 | Write Settings -> Parameters |
|
|
| 13 | Write login page. |
|
|
|
|
## Credits
|
|
|
|
Credits to Muhammed Usman for his Charisma Admin web Template.<br>
|
|
Where I have used or based any component on a 3rd parties design I have included the original authors copyright notice within the headers or given due credit. All 3rd party software, to my knowledge and research, is open source and freely useable, if there is found to be any component with licensing restrictions, it will be removed from this repository and a suitable link/config provided.
|
|
|
|
|
|
## Licenses
|
|
|
|
This design, hardware and software, is licensed under the GNU Public Licence v3.
|
|
|
|
### The Gnu Public License v3
|
|
The source and binary files in this project marked as GPL v3 are 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, either version 3 of the License, or (at your option) any later version.
|
|
|
|
The source files are 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/.
|
|
|
|
|