Program Helper class.
Class instance accessor: Program More...

Inheritance diagram for ProgramHelper:

Public Member Functions
void	Setup (Action functionBlock)
	Execute a setup function when the program is enabled. It is meant to be used in the "Startup Code" to execute only once the instructions contained in the passed function. It is mainly used for setting program configuration fields, parameters and features. More...

void	Run (bool willRun)
	Run the program as soon as the "Startup Code" exits. This command is meant to be used in the "Startup Code". More...

ProgramHelper	UseWidget (string widget)
	Set the widget that will be used for displaying this program data in the UI Control page. More...

ProgramHelper	AddOption (string field, string defaultValue, string description, string type)
	Adds a configuration option for the program. The option field will be displayed in the program options dialog using the UI widget specified by the "type" field. More...

ModuleParameter	Option (string field)
	Gets the value of a program option field. More...

ProgramHelper	AddFeature (string forDomains, string forModuleTypes, string parameterName, string description, string type)
	Adds a "feature" field to modules matching the specified domain/type. Feature fields are used by automation programs to create own handled module parameters. This command should only appear inside a Program.Setup delegate. More...

ProgramFeature	Feature (string parameterName)
	Return the feature field associated to the specified module parameter. More...

ProgramHelper	AddVirtualModule (string domain, string address, string type, string widget)
	Adds a new virtual module to the system. More...

ProgramHelper	RemoveVirtualModule (string domain, string address)
	Remove a virtual module from the system. More...

ProgramHelper	AddVirtualModules (string domain, string type, string widget, int startAddress, int endAddress)
	Adds a new set of virtual modules to the system. More...

ProgramHelper	Notify (string message)
	Display UI notification message using the name of the program as default title for the notification. More...

ProgramHelper	Notify (string message, params object[] paramList)
	Display UI notification message using the name of the program as default title for the notification. More...

ProgramHelper	Notify (string title, string message)
	Display UI notification message from current program. More...

ProgramHelper	Notify (string title, string message, params object[] paramList)
	Display UI notification message from current program. More...

ProgramHelper	RaiseEvent (string parameter, string value, string description)
	Raise a parameter event and set the parameter with the specified value. More...

ProgramHelper	RaiseEvent (ModuleHelper module, string parameter, string value, string description)
	Raise a module parameter event and set the parameter with the specified value. More...

void	GoBackground ()
	This command is usually put at the end of the "Program Code". It is the equivalent of an infinite noop loop. More...

ModuleParameter	Parameter (string parameterName)
	Gets or sets a program parameter. More...

StoreHelper	Store (string storeName)
	Gets or creates a persistent data Store for this program. More...

bool	UpdateModuleDatabase ()
	Force update module database with current data. More...

Public Member Functions inherited from ProgramHelperBase
ProgramHelperBase	Say (string sentence, string locale=null, bool goAsync=false)
	Playbacks a synthesized voice message from speaker. More...

ProgramHelperBase	Play (string waveUrl)
	Playbacks a wave file. More...

MigInterfaceCommand	ParseApiCall (string apiCall)
	Parses the given (api call) string as a `MigInterfaceCommand` object. More...

object	ApiCall (string apiCommand)
	Invoke an API command and get the result. More...

object	ApiCall (string apiCommand, object data)
	Invoke an API command and get the result. More...

Thread	RunAsyncTask (Utility.AsyncFunction functionBlock)
	Executes a function asynchronously. More...

void	Run (string programId)
	Executes the specified Automation Program. More...

void	Run (string programId, string options)
	Executes the specified Automation Program. More...

ProgramHelperBase	WaitFor (string programId)
	Wait until the given program is not running. More...

ProgramHelper	WithAddress (int programAddress)
	Returns a reference to the ProgramHelper of a program. More...

ProgramHelper	WithName (string programName)
	Returns a reference to the ProgramHelper of a program. More...

Properties
bool	IsRunning `[get]`
	Gets a value indicating whether the program is running. More...

bool	IsEnabled `[get]`
	Gets a value indicating whether the program is enabled. More...

Module	Module `[get]`
	Get a reference to the Module associated to the program. More...

Properties inherited from ProgramHelperBase
NLog.Logger	Log `[get]`
	Gets the logger object. More...

Detailed Description

Program Helper class.
Class instance accessor: Program

Member Function Documentation

◆ Setup()

void Setup ( Action functionBlock )

Execute a setup function when the program is enabled. It is meant to be used in the "Startup Code" to execute only once the instructions contained in the passed function. It is mainly used for setting program configuration fields, parameters and features.

Parameters

functionBlock Function name or inline delegate.

Example:

Program.Setup(()=>
{
    Program.AddOption(
        "MaxLevel",
        "40",
        "Keep level below the following value",
        "slider:10:80");
    Program.AddFeature(
        "Dimmer",
        "EnergyManagement.EnergySavingMode",
        "Energy Saving Mode enabled light",
        "checkbox");
}, 0);

◆ Run()

void Run ( bool willRun )

Run the program as soon as the "Startup Code" exits. This command is meant to be used in the "Startup Code".

Parameters

willRun If set to true will run.

◆ UseWidget()

ProgramHelper UseWidget ( string widget )

Set the widget that will be used for displaying this program data in the UI Control page.

Returns: ProgramHelper.

Parameters

widget The widget path.

◆ AddOption()

ProgramHelper AddOption	(	string	field,
		string	defaultValue,
		string	description,
		string	type
	)

Adds a configuration option for the program. The option field will be displayed in the program options dialog using the UI widget specified by the "type" field.

Returns: ProgramHelper

Parameters

field	Name of this input field
defaultValue	Default value for this input field
description	Description for this input field
type	The type of this option (eg. "text", "password", "cron.text", ...). Each type can have different initialization options that are specified as ":" separated items. See html/ui/widgets folder for a list of possible types/options.

◆ Option()

ModuleParameter Option ( string field )

Gets the value of a program option field.

Returns: The option field.

Parameters

field Name of the option field to get.

Example:

// ....
var delay = Program.Option("OffDelay").DecimalValue;
Pause( delay );
Modules.WithFeature("Timer.TurnOffDelay").Off();

◆ AddFeature()

ProgramHelper AddFeature	(	string	forDomains,
		string	forModuleTypes,
		string	parameterName,
		string	description,
		string	type
	)

Adds a "feature" field to modules matching the specified domain/type. Feature fields are used by automation programs to create own handled module parameters. This command should only appear inside a Program.Setup delegate.

Returns: ProgramHelper.

Parameters

forDomains	Expression based on module domain names, used to select what modules will be showing this feature field. This can be either a valid Regular Expression enclosed by '/' and '/' delimiters or a simple comma (or '\|') separated list of domain names (prepend '!' to a name to exclude it).
forModuleTypes	Expression based on module types and parameters names, used to select what modules will be showing this feature field. This must be in the format `<types_expr>[:<parameters_expr>]`. <types_expr> and <parameters_expr> can be either a valid Regular Expression enclosed by '/' and '/' delimiters or a simple comma (or '\|') separated list of names (prepend '!' to a name to exclude it).
parameterName	Name of the module parameter bound to this feature field.
description	Description for this input field.
type	The type of this feature field (eg. "text", "password", "cron.text", ...). Each type can have different initialization options that are specified as ":" separated items. See html/ui/widgets folder for a list of possible types/options.

◆ Feature()

ProgramFeature Feature ( string parameterName )

Return the feature field associated to the specified module parameter.

Parameters

parameterName Parameter name.

◆ AddVirtualModule()

ProgramHelper AddVirtualModule	(	string	domain,
		string	address,
		string	type,
		string	widget
	)

Adds a new virtual module to the system.

Returns: ProgramHelper.

Parameters

domain	Domain.
address	Address.
type	Type (Generic, Program, Switch, Light, Dimmer, Sensor, Temperature, Siren, Fan, Thermostat, Shutter, DoorWindow, MediaTransmitter, MediaReceiver).
widget	Empty string or the path of the widget to be associated to the virtual module.

◆ RemoveVirtualModule()

ProgramHelper RemoveVirtualModule	(	string	domain,
		string	address
	)

Remove a virtual module from the system.

Returns: ProgramHelper.

Parameters

domain	Domain.
address	Address.

◆ AddVirtualModules()

ProgramHelper AddVirtualModules	(	string	domain,
		string	type,
		string	widget,
		int	startAddress,
		int	endAddress
	)

Adds a new set of virtual modules to the system.

Returns: ProgramHelper.

Parameters

domain	Domain.
type	Type.
widget	Empty string or the path of the widget to be associated to the virtual module.
startAddress	Start address (numeric).
endAddress	End address (numeric).

◆ Notify() [1/4]

ProgramHelper Notify ( string message )

Display UI notification message using the name of the program as default title for the notification.

Parameters

message Message.

Example:

Program.Notify("Hello world!");

◆ Notify() [2/4]

ProgramHelper Notify	(	string	message,
		params object[]	paramList
	)

Display UI notification message using the name of the program as default title for the notification.

Parameters

message	Formatted message.
paramList	Format parameter list.

Example:

Program.Notify("Hello world!");

◆ Notify() [3/4]

ProgramHelper Notify	(	string	title,
		string	message
	)

Display UI notification message from current program.

Parameters

title	Title.
message	Message.

Example:

Program.Notify("Test Program", "Hello world!");

◆ Notify() [4/4]

ProgramHelper Notify	(	string	title,
		string	message,
		params object[]	paramList
	)

Display UI notification message from current program.

Parameters

title	Title.
message	Formatted message.
paramList	Format parameter list.

◆ RaiseEvent() [1/2]

ProgramHelper RaiseEvent	(	string	parameter,
		string	value,
		string	description
	)

Raise a parameter event and set the parameter with the specified value.

Returns: ProgramHelper.

Parameters

parameter	Parameter name.
value	The new parameter value to set.
description	Event description.

◆ RaiseEvent() [2/2]

ProgramHelper RaiseEvent	(	ModuleHelper	module,
		string	parameter,
		string	value,
		string	description
	)

Raise a module parameter event and set the parameter with the specified value.

Returns: ProgramHelper.

Parameters

module	The module source of this event.
parameter	Parameter name.
value	The new parameter value to set.
description	Event description.

◆ GoBackground()

void GoBackground ( )

This command is usually put at the end of the "Program Code". It is the equivalent of an infinite noop loop.

◆ Parameter()

ModuleParameter Parameter ( string parameterName )

Gets or sets a program parameter.

Parameters

parameterName Parameter name.

Example:

// sets an example program parameter
Program.Parameter("MyProgram.ExampleParameter").Value = "Just testing...";
 
// read "Sensor.Temperature" parameter of the program named "DHT-11"
if (Program.WithName("DHT-11").Parameter("Sensor.Temperature").DecimalValue < 20
    && Modules.WithName("Heater").IsOff)
{
    Modules.WithName("Heater").On();
}

◆ Store()

StoreHelper Store ( string storeName )

Gets or creates a persistent data Store for this program.

Parameters

storeName Store name.

◆ UpdateModuleDatabase()

bool UpdateModuleDatabase ( )

Force update module database with current data.

Property Documentation

◆ IsRunning

bool IsRunning

get

Gets a value indicating whether the program is running.

true if this program is running; otherwise, false.

◆ IsEnabled

bool IsEnabled

get

Gets a value indicating whether the program is enabled.

true if this program is enabled; otherwise, false.

◆ Module

Module Module

get

Get a reference to the Module associated to the program.

Module object associated to the program.

The documentation for this class was generated from the following file:

ProgramHelper.cs

Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ Setup()

◆ Run()

◆ UseWidget()

◆ AddOption()

◆ Option()

◆ AddFeature()

◆ Feature()

◆ AddVirtualModule()

◆ RemoveVirtualModule()

◆ AddVirtualModules()

◆ Notify() [1/4]

◆ Notify() [2/4]

◆ Notify() [3/4]

◆ Notify() [4/4]

◆ RaiseEvent() [1/2]

◆ RaiseEvent() [2/2]

◆ GoBackground()

◆ Parameter()

◆ Store()

◆ UpdateModuleDatabase()

Property Documentation

◆ IsRunning

◆ IsEnabled

◆ Module