Documentation
Command Reference
The Command Reference includes commands that are provided by IP-Symcon and are used for the management of itself.
This is a list of IP-Symcon specific commands.
For a list of module-specific commands, refer to the Module Reference.
Process Control
Operations from this group can influence the process of scripts.
| IPS_Execute | Starts an external program |
| IPS_ExecuteEx | Starts an external program in the user context |
| IPS_RunAction | executes a single action |
| IPS_RunActionWait | executes a single action and waits for the result |
| IPS_RunScript | starts another IP-Symcon script |
| IPS_RunScriptEx | starts another IP-Symcon script and passes variables |
| IPS_RunScriptText | starts text as IP-Symcon script |
| IPS_RunScriptTextEx | starts a text as IP-Symcon script and passes variablesstartet einen Text als IP-Symcon Skript und übergibt Variablen |
| IPS_RunScriptTextWait | starts a text as IP-Symcon script and waits for its execution |
| IPS_RunScriptTextWaitEx | starts a text as IP-Symcon script, passes variables, and waits for the execution of the script |
| IPS_RunScriptWait | starts another IP-Symcon script and waits for the result |
| IPS_RunScriptWaitEx | starts another IP-Symcon script, passes variables, and waits for the result |
| IPS_SemaphoreEnter | allows the synchronization with other simultaneously run scripts |
| IPS_SemaphoreLeave | allows the synchronization with other simultaneously run scripts |
| IPS_Sleep | delays a script for a specified duration |
Management of Events
Operations can influence the process of events.
| IPS_CreateEvent | create a new event |
| IPS_DeleteEvent | deletes an event |
| IPS_EventExists | checks if an event exists |
| IPS_GetEvent | returns extensive information about an event |
| IPS_GetEventIDByName | determines the ID of an event by its name |
| IPS_GetEventList | returns a list of all existing events |
| IPS_GetEventListByType | returns a list of all events of a given type |
| IPS_IsConditionPassing | checks if a condition is fulfilled |
| IPS_SetEventAction | set the executed action |
| IPS_SetEventActive | activates/deactivates an event |
| IPS_SetEventCondition | modifies the conditions of an event |
| IPS_SetEventConditionDateRule | modifies the rule of a condition of an event for date comparisons |
| IPS_SetEventConditionDayOfTheWeekRule | modifies the rule of a condition of an event for weekday comparisons |
| IPS_SetEventConditionTimeRule | modifies the rule of a condition of an event for time comparisons |
| IPS_SetEventConditionVariableDynamicRule | modify a static condition rule of an event for variable comparison |
| IPS_SetEventConditionVariableRule | modify a condition rule of an event for variable comparison |
| IPS_SetEventConditionVariableStaticRule | modify a static condition rule of an event for variable comparison |
| IPS_SetEventCyclic | configures a cyclic event |
| IPS_SetEventCyclicDateBounds | set the start and end date of a cyclic event (deprecated) |
| IPS_SetEventCyclicDateFrom | sets the start date |
| IPS_SetEventCyclicDateTo | sets the end date |
| IPS_SetEventCyclicTimeBounds | set the start and end time for a cyclic event (deprecated) |
| IPS_SetEventCyclicTimeFrom | set the start time |
| IPS_SetEventCyclicTimeTo | sets the end time |
| IPS_SetEventLimit | limits the amount of event calls |
| IPS_SetEventScheduleAction | modifies the action table of a schedule event and set the action to "Execute PHP Code" |
| IPS_SetEventScheduleActionEx | modifies the action table of a schedule event |
| IPS_SetEventScheduleGroup | modifies the grouping of days for a schedule event |
| IPS_SetEventScheduleGroupPoint | modify a switch point of the group of a schedule event |
| IPS_SetEventScript | set the action to "Execute PHP Code" and define the code to be executed |
| IPS_SetEventTrigger | define the trigger for a trigger event |
| IPS_SetEventTriggerSubSequentExecution | define if a trigger event should multiple times fir exceed/drop |
| IPS_SetEventTriggerValue | set the value the trigger variable is compared to |
Management of Instances
Commands in this group are used to manage instances.
| Debug | |||||||||||||||||
| |||||||||||||||||
| IPS_CreateInstance | creates an instance | ||||||||||||||||
| IPS_DeleteInstance | deletes an instance | ||||||||||||||||
| IPS_GetInstance | returns extensive information about a specific instance | ||||||||||||||||
| IPS_GetInstanceIDByName | returns the ID of an instance by its name | ||||||||||||||||
| IPS_GetInstanceList | returns a list of all existing instances | ||||||||||||||||
| IPS_GetInstanceListByModuleID | returns all instances with a specific module ID | ||||||||||||||||
| IPS_GetInstanceListByModuleType | returns a list of all instances with a specific type | ||||||||||||||||
| IPS_InstanceExists | checks if a specific instance exists | ||||||||||||||||
| Configuration | |||||||||||||||||
| |||||||||||||||||
| References | |||||||||||||||||
| |||||||||||||||||
| Status Variables | |||||||||||||||||
| Connection | |||||||||||||||||
| |||||||||||||||||
Management of Categories
Commands in this group are used to manage categories.
| IPS_CategoryExists | checks if a category exists |
| IPS_CreateCategory | creates a new category |
| IPS_DeleteCategory | deletes an existing category |
| IPS_GetCategoryIDByName | searches and returns the ID of an existing category by its name |
| IPS_GetCategoryList | returns a list of all existing categories |
Management of Links
Commands from this category are used to manage links.
| IPS_CreateLink | creates a new link |
| IPS_DeleteLink | deletes an existing link |
| IPS_GetLink | retuns extensive information about a link |
| IPS_GetLinkIDByName | returns the ID of a link by its name |
| IPS_GetLinkList | returns a list of all existing links |
| IPS_LinkExists | checks if a link exists already |
| IPS_SetLinkTargetID | set the target for a link |
Management of Media
Functions from this group are used to manage media
| IPS_CreateMedia | creates a new media object in the media pool |
| IPS_DeleteMedia | removes a media object from the media pool |
| IPS_GetMedia | returns extensive information about a specific media object |
| IPS_GetMediaContent | returns the content of a media object |
| IPS_GetMediaID | returns the ID of a media object |
| IPS_GetMediaIDByFile | return the ID of a media object by its file |
| IPS_GetMediaIDByName | returns the ID of a media object by its name |
| IPS_GetMediaList | returns a list of all media objects in the media pool |
| IPS_GetMediaListByType | returns a list of all media objects of a specific type |
| IPS_MediaExists | checks if a specific media object is contained within the media pool already |
| IPS_SendMediaEvent | send a notification that a media object was changed |
| IPS_SetMediaCached | activates that a media object is only modified in the internal memory |
| IPS_SetMediaContent | set the content of a media object |
| IPS_SetMediaFile | bind a media file to a media object |
Management of Modules
Commands from this group are used to manage modules and libraries
| IPS_GetCompatibleModules | returns all modules that are compatible to a specific module |
| IPS_GetLibrary | returns extensive information about a library |
| IPS_GetLibraryList | returns a list of all libraries |
| IPS_GetLibraryModules | returns a list of modules in a library |
| IPS_GetModule | returns extensive information about a module |
| IPS_GetModuleList | returns a list of all modules |
| IPS_GetModuleListByType | returns a list of all modules of a given type |
| IPS_IsModuleCompatible | checks if two modules are compatible to each other |
| IPS_LibrarayExists | Checks if the given library exists |
| IPS_ModuleExists | checks if the given module exists |
Management of Objects
Functions from this group are used to manipulate objects
| IPS_GetChildrenIDs | returns a list of all children objects |
| IPS_GetLocation | returns the complete path to an object |
| IPS_GetName | returns the name of the object |
| IPS_GetObject | returns extensive information about an object |
| IPS_GetObjectIDByIdent | returns the ID of an object by its ident |
| IPS_GetObjectIDByName | returns the ID of an object by its name |
| IPS_GetObjectList | returns a list of all existing objects |
| IPS_GetParent | returns the ID of the parent of the object |
| IPS_HasChildren | checks if an object has child objects |
| IPS_IsChild | checks if an object is a child of a parent object |
| IPS_ObjectExists | checks if a specific object exists |
| IPS_SetDisabled | set an object as disabled for the visualizations |
| IPS_SetHidden | set the visibility for an object |
| IPS_SetIcon | set the icon of an object |
| IPS_SetIdent | set the ident of an object |
| IPS_SetInfo | set extended information of an object |
| IPS_SetName | set the name of an object |
| IPS_SetParent | set the parent of an object |
| IPS_SetPosition | set the position of an object |
Program Information
Functions from this group provide information about IP Symcon itself
| IPS_FunctionExists | checks if a specific function exists |
| IPS_GetFunction | returns extensive information about a function |
| IPS_GetFunctionList | returns a list of all available functions |
| IPS_GetFunctionListByModuleID | returns a list of all available functions of a module |
| IPS_GetKernelArchitecture | supplies the architecture that IP-Symcon was created for |
| IPS_GetKernelDate | returns the kernel creation date |
| IPS_GetKernelDir | returns the path to the IP Symcon program folder |
| IPS_GetKernelDirEx | returns the path to the IP Symcon installation folder |
| IPS_GetKernelDir | returns the total/free/available/disk space where IP-Symcon has its data |
| IPS_GetKernelPlatform | supplies the operating system which IP-Symcon is running on |
| IPS_GetKernelRevision | supplies a unique revision identifier |
| IPS_GetKernelRunlevel | returns the run level of the kernel |
| IPS_GetKernelStartTime | returns the point of time when IP Symcon was started |
| IPS_GetKernelVersion | returns the version number of the used kernel |
| IPS_GetLogDir | returns the path to the IP Symcon log folder |
| IPS_GetSystemLanguage | returns the system language of the operating system on which IP-Symcon is running |
| IPS_GetUpdateChannel | returns the currently configured update channel |
| IPS_LogMessage | Writes a user defined message into the log file |
Management of Scripts
Functions from this group are used to manage scripts
| IPS_CreateScript | creates a script |
| IPS_DeleteScript | deletes a script |
| IPS_GetScript | return extensive information about a script |
| IPS_GetScriptContent | returns the content of a script |
| IPS_GetScriptEventList | returns all events that are assigned to a script |
| IPS_GetScriptFile | returns the file name of a script |
| IPS_GetScriptIDByFile | returns the ID of a script by its file |
| IPS_GetScriptIDByName | returns the ID of a script by its name |
| IPS_GetScriptList | returns a list of all scripts |
| IPS_GetScriptTimer | returns the start value of the script timer |
| IPS_ScriptExists | checks if a script exists |
| IPS_SetScriptContent | set the content of a script |
| IPS_SetScriptFile | sets the file name for a script |
| IPS_SetScriptTimer | set the start value of a script timer |
Management of Variables
Functions from this group are used to manipulate variables
| IPS_CreateVariable | creates a new variable | ||||||||||||||||||||||
| IPS_DeleteVariable | deletes a variable | ||||||||||||||||||||||
| IPS_GetVariable | retuns extensive information about a variable | ||||||||||||||||||||||
| IPS_GetVariableEventList | returns a list of all events that are associated to a variable | ||||||||||||||||||||||
| IPS_GetVariableIDByName | returns the ID of a variable by its name | ||||||||||||||||||||||
| IPS_GetVariableList | returns a list of all existing variables | ||||||||||||||||||||||
| IPS_SetVariableCustomAction | set a user defined action script for a variable | ||||||||||||||||||||||
| IPS_SetVariableCustomProfile | sets a user defined profile for a variable | ||||||||||||||||||||||
| IPS_VariableExists | checks if a variable exists | ||||||||||||||||||||||
| Variable Profiles | |||||||||||||||||||||||
| |||||||||||||||||||||||
Accessing Variables
Commands in this group are used to read or write the values of variables.
| GetValue | returns the value of an IP-Symcon variable, independent of its type |
| GetValueBoolean | returns the value of an IP-Symcon variable of the type Boolean |
| GetValueFloat | returns the value of an IP-Symcon variable of the type Float |
| GetValueFormatted | returns the value of an IP-Symcon variable and formats it according to its profile |
| GetValueFormattedEx | returns a value formatted based on the profile of a variable |
| GetValueInteger | returns the value of an IP-Symcon variable of the type Integer |
| GetValueString | returns the value of an IP-Symcon variable of the type String |
| HasAction | checks whether an action is defined |
| RequestAction | execute the variable action of an IP-Symcon variable |
| RequestActionEx | execute the action of an IP-Symcon variable with individual sender |
| SetValue | set the value of an IP-Symcon variable independent of its type |
| SetValueBoolean | set the value of an IP-Symcon Variable with the type Boolean |
| SetValueFloat | set the value of an IP-Symcon variable with the type Float |
| SetValueInteger | set the value of an IP-Symcon variable with the type Boolean |
| SetValueString | set the value of an IP-Symcon variable with the type String |