mmm-screenlogic/README.md

MMM-ScreenLogic

A MagicMirror² module used to get real-time values of crypto currencies. Tested with MagicMirror² v2.2.2 server, Chrome 65 on Windows 10 and Midori 0.4.3 on a Raspberry Pi Zero W with Raspbian Jessie. Tested with a Pentair ScreenLogic system running version 5.2 Build 736.0 Rel.

Installation

1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/parnic/MMM-ScreenLogic.git.
2. cd MMM-ScreenLogic
3. Execute npm install to install the node dependencies.
4. Add the module inside config.js placing it where you prefer.

Config

Option	Type	Description	Default
serverAddress	String	The IPv4 address of a ScreenLogic unit to connect to. If not set, the system will search for a unit to connect to. If set, serverPort must also be set.
serverPort	Integer	The port of a ScreenLogic unit to connect to (usually 80). If not set, the system will search for a unit to connect to. If set, serverAddress must also be set.
showPoolTemp	Boolean	Whether you'd like to show pool temperature or not.	true
showSpaTemp	Boolean	Whether you'd like to show spa temperature or not.	true
showPH	Boolean	Whether you'd like to show pH level or not.	true
showOrp	Boolean	Whether you'd like to show ORP level or not.	true
showSaltLevel	Boolean	Whether you'd like to show salt level (in PPM) or not.	true
showSaturation	Boolean	Whether you'd like to show saturation/balance or not.	true
colored	Boolean	Whether you'd like colored output or not.	true
coldTemp	Integer	Show the temperature colored blue if it's at or below this level for pool/spa (requires option colored). This is in whatever scale your system is set to (Fahrenheit/Celsius).	84
hotTemp	Integer	Show the temperature colored red if it's at or above this level for pool/spa (requires option colored). This is in whatever scale your system is set to (Fahrenheit/Celsius).	90
columns	Integer	How many columns to use to display the data before starting a new row.	3
contentClass	String	The CSS class used to display content values (beneath the header).	"light"

Here is an example of an entry in config.js

{
	module: 'MMM-ScreenLogic',
	header: 'Pool info',
	position: 'top_left',
	config: {
		showSpaTemp: false,
		columns: 2,
		contentClass: 'thin'
	}
},

Screenshot

With color

Notes

Pull requests are very welcome! If you'd like to see any additional functionality, don't hesitate to let me know.

This module only works with ScreenLogic controllers on the local network via either a UDP broadcast on 255.255.255.255 or a direct connection if you've specified an address and port in the configuration.

The data is updated every 30 minutes.

Libraries

This uses a Node.JS library I created for interfacing with ScreenLogic controllers over the network: node-screenlogic, so feel free to check that out for more information.