# Programminformationen

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/

## IPS_FunctionExists

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-functionexists/

`bool IPS_FunctionExists(string $Funktionsname)`

_Benötigt Symcon >= 2.6_

prüft, ob eine bestimmte Funktion existiert

**Parameter**

- `$Funktionsname` (string): Name, der zu prüfenden Funktion

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Name, der zu prüfenden Funktion

**Beispiel**

```php
if (IPS_FunctionExists("GetValue"))
    echo "Die Funktion GetValue existiert!";
```

## IPS_GetFunction

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getfunction/

`array IPS_GetFunction(string $Funktionsname)`

_Benötigt Symcon >= 2.6_

liefert umfassende Informationen über eine Funktion

**Parameter**

- `$Funktionsname` (string): Name, der zu prüfenden Funktion

**Rückgabewert** (array): Ein Array mit folgenden __key => value__ Paaren

| Index            | Typ    | Beschreibung                           |
| ---------------- | ------ | -------------------------------------- |
| __FunctionName__ | string | Funktionsname                          |
| __Parameters__   | array  | siehe Tabelle "Parameterinformationen" |
| __Result__       | array  | siehe Tabelle "Rückgabeinformationen"  |

_Tabelle: Parameterinformationen_

| Index       | Typ     | Beschreibung                                                                                           |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------ |
| Description | string  | Name des Rückgabewert                                                                                  |
| Enumeration | array   | Namentliche Darstellung der möglichen Integerwerte                                                     |
| Type_       | integer | Variablentyp des Parameters/Rückgabewerts: 0=Boolean, 1=Integer, 2=Float, 3=String, 4=Variant, 5=Array |

_Tabelle: Rückgabeinformationen_

| Index       | Typ     | Beschreibung                                                                                           |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------ |
| Description | string  | Name des Rückgabewert                                                                                  |
| Enumeration | array   | Namentliche Darstellung der möglichen Integerwerte                                                     |
| Type_       | integer | Variablentyp des Parameters/Rückgabewerts: 0=Boolean, 1=Integer, 2=Float, 3=String, 4=Variant, 5=Array |

Name, der zu prüfenden Funktion

**Beispiel**

```php
// Information der Funktion IPS_GetFunction und IPS_CreateMedia abfragen
var_dump(IPS_GetFunction("IPS_GetFunction"));
var_dump(IPS_GetFunction("IPS_CreateMedia"));

// Ausgabe "IPS_GetFunction"
/*
array(3) {
    ["FunctionName"]=>
    string(15) "IPS_GetFunction"
    ["Result"]=>
    array(3) {
        ["Type_"]=>
        int(5)
        ["Description"]=>
        string(6) "Result"
        ["Enumeration"]=>
        array(0) {
        }
    }
    ["Parameters"]=>
    array(1) {
    [0]=>
        array(3) {
        ["Type_"]=>
        int(3)
        ["Description"]=>
        string(12) "FunctionName"
        ["Enumeration"]=>
        array(0) {
        }
    }
}
*/

// Ausgabe "IPS_CreateMedia"
/*
array(3) {
    ["FunctionName"]=>
    string(15) "IPS_CreateMedia"
    ["Result"]=>
    array(3) {
        ["Type_"]=>
        int(1)
        ["Description"]=>
        string(6) "Result"
        ["Enumeration"]=>
        array(0) {
        }
    }
    ["Parameters"]=>
    array(1) {
        [0]=>
        array(3) {
            ["Type_"]=>
            int(1)
            ["Description"]=>
            string(9) "MediaType"
            ["Enumeration"]=>
            array(6) {
                [0]=>
                string(6) "mtForm"
                [1]=>
                string(7) "mtImage"
                [2]=>
                string(7) "mtSound"
                [3]=>
                string(8) "mtStream"
                [4]=>
                string(7) "mtChart"
                [5]=>
                string(10) "mtDocument"
            }
        }
    }
}
*/
```

## IPS_GetFunctionList

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getfunctionlist/

`array IPS_GetFunctionList(int $InstanzID)`

_Benötigt Symcon >= 2.6_

liefert eine Liste mit allen Verfügbaren Funktionsnamen

**Parameter**

- `$InstanzID` (int): InstanzID, für zu suchende Funktion. 0, um alle zu suchen.

**Rückgabewert** (array): Ein Array von Strings aller Funktionsnamen

InstanzID, für zu suchende Funktion. 0, um alle zu suchen.

**Beispiel**

```php
$alleFunktionen = IPS_GetFunctionList(0);
print_r(IPS_GetFunction($alleFunktionen[48]));  // nur Funktion 48 ausgeben (IPS_CreateScript)

/* liefert:
Array
(
    [FunctionName] => IPS_CreateScript
    [Parameters] => Array
    (
        [0] => Array
        (
            [Description] => ScriptType
            [Type_] => 1
        )

    )
    [Result] => Array
    (
        [Description] => Result
        [Type_] => 1
    )
)
*/

//Exportiert alle IP-Symcon Funktionen mit einer Parameterliste
$instanceid = 0; //0 = Alle Funktionen, sonst Filter auf InstanzID
$fs = IPS_GetFunctionList($instanceid);
asort($fs);
$typestr = Array("boolean", "integer", "float", "string", "variant", "array");
foreach($fs as $f) {
    $f = IPS_GetFunction($f);
    echo sprintf("[%7s]", $typestr[$f['Result']['Type_']]) . " - ".$f['FunctionName']."(";
    $a = Array();
    foreach($f['Parameters'] as $p) {
        if(isset($p['Enumeration']) && sizeof($p['Enumeration']) > 0) {
            $b=Array();
            foreach($p['Enumeration'] as $k => $v) {
                $b[] = $k."=".$v;
            }
            $type = "integer/enum[".implode(", ", $b)."]";
        } else {
            $type = $typestr[$p['Type_']];
        }
        $a[]=$type." $".$p['Description'];
    }
    echo implode(", ", $a).");\n";
}
```

## IPS_GetFunctionListByModuleID

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getfunctionlistbymoduleid/

`array IPS_GetFunctionListByModuleID(string $ModuleID)`

liefert eine Liste mit allen verfügbaren Funktionen eines Moduls

**Parameter**

- `$ModuleID` (string): GUID des Moduls

**Rückgabewert** (array): Ein Array von Strings aller Funktionen

GUID des Moduls

**Beispiel**

```php
// Alle Funktionen von "DPT 200.x - Binary Value & Status" von KNX
print_r(IPS_GetFunctionListByModuleID("{04ED3286-C982-436F-A01E-8A03C2E976A8}"));

/* liefert:
Array
(
    [0] => IPS_RequestAction
    [1] => IPS_StopSearch
    [2] => IPS_StartSearch
    [3] => IPS_IsSearching
    [4] => KNX_WriteDPT200
    [5] => IPS_GetConfigurationForm
    [6] => IPS_SupportsSearching
    [7] => KNX_RequestStatus
    [8] => IPS_GetConfiguration
    [9] => IPS_GetProperty
    [10] => IPS_SetProperty
    [11] => IPS_SetConfiguration
    [12] => IPS_GetConfigurationForParent
    [13] => IPS_HasChanges
    [14] => IPS_ResetChanges
    [15] => IPS_ApplyChanges
    [16] => IPS_GetReferenceList
    [17] => IPS_Translate
    [18] => KNX_RenameVariables
)
*/
```

## IPS_GetKernelArchitecture

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelarchitecture/

`string IPS_GetKernelArchitecture()`

_Benötigt Symcon >= 6.0_

liefert die Architektur für die IP-Symcon erstellt wurde

**Rückgabewert** (string): Die Architektur für die IP-Symcon erstellt wurde

Die Funktion liefert einen String mit der Architektur für die IP-Symcon erstellt wurde

**Beispiel**

```php
echo IPS_GetKernelArchitecture();
// Beispielausgabe:
/*
// MacOS, Windows 32Bit
i386

// Linux, Windows 64Bit
amd64

// Linux, Raspberry Pi
armhf

// Linux, Raspberry Pi
arm64
*/
```

## IPS_GetKernelDate

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkerneldate/

`int IPS_GetKernelDate()`

_Benötigt Symcon >= 4.4_

liefert das Datum der Erstellung des Kernels

**Rückgabewert** (int): Das Erstelldatum in UnixTimeStamp

Die Funktion liefert einen Integerwert, welcher als UnixTimeStamp das Erstelldatum des Kernels ausgibt.

**Beispiel**

```php
echo IPS_GetKernelDate();
// Beispielausgabe
// 1511046903
```

## IPS_GetKernelDir

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkerneldir/

`string IPS_GetKernelDir()`

liefert den Pfad zum IP-Symcon Programmverzeichnis

**Rückgabewert** (string): Der vollständige Pfad zum IP-Symcon Programmverzeichnis

Die Funktion liefert einen String mit dem vollständigen Pfad zum IP-Symcon Programmverzeichnis (Settings, Skripte, Medien...). Je nach Betriebssystem enthält der Pfad ein abschließendes Slash (“/”) oder Backslash (“\”).

**Beispiel**

```php
echo IPS_GetKernelDir();
// Beispielausgabe:
/*
// Windows
// ab Version 5.3
C:\ProgramData\Symcon\
// bis Version 5.2
C:\Programme\IP-Symcon\

// Linux, RaspberryPi
/var/lib/symcon/

// MacOS
/Library/Application Support/Symcon/
*/
```

## IPS_GetKernelDirEx

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkerneldirex/

`string IPS_GetKernelDirEx()`

_Benötigt Symcon >= 4.0_

liefert den Pfad zum IP-Symcon Installationsverzeichnis

**Rückgabewert** (string): Der vollständige Pfad zum IP-Symcon Installationsverzeichnis

Die Funktion liefert einen String mit dem vollständigen Pfad zu den IP-Symcon Installationsverzeichnis. Je nach Betriebssystem enthält der Pfad ein abschließendes Slash (“/”) oder Backslash (“\”).

**Beispiel**

```php
echo IPS_GetKernelDirEx();

// Beispielausgabe:
/*
// Windows
C:\Programme\IP-Symcon\

// Linux, RaspberryPi
/usr/share/symcon/

// MacOS
/Applications/Symcon.app/Contents/Service/
*/
```

## IPS_GetKernelDirSpace

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkerneldirspace/

`array IPS_GetKernelDirSpace()`

_Benötigt Symcon >= 6.2_

Liefert freien/verfügbaren/gesamt Speicherplatz auf dem Laufwerk, auf dem alle Daten von IP-Symcon gespeichert werden

**Rückgabewert** (array): Liefert gesamten/freien/verfügbaren Speicherplatz

Die Funktion liefert ein Array mit den Keys Total/Free/Available. Diese geben den gesamten/freien/verfügbaren Speicherplatz von dem Laufwerk an, auf dem alle Daten von IP-Symcon gespeichert werden.

**Beispiel**

```php
print_r(IPS_GetKernelDirSpace());
// Beispielausgabe:
/*
Array
(
    [Total] => 511582613504
    [Free] => 96859312128
    [Available] => 96859312128
)
*/
```

## IPS_GetKernelPlatform

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelplatform/

`string IPS_GetKernelPlatform()`

_Benötigt Symcon >= 4.4_

liefert das Betriebssystem auf dem IP-Symcon läuft

**Rückgabewert** (string): Das Betriebssystem auf dem IP-Symcon läuft

Die Funktion liefert einen String mit dem Betriebssystem auf dem der IP-Symcon Server läuft

**Beispiel**

```php
echo IPS_GetKernelPlatform();
// Beispielausgabe:
/*
// SymBox
SymBox

// Windows
Windows

// Linux
Ubuntu
Ubuntu (Docker)

// RaspberryPi
Raspberry Pi
Raspberry Pi (Docker)

// MacOS
Mac
*/
```

## IPS_GetKernelRevision

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelrevision/

`string IPS_GetKernelRevision()`

_Benötigt Symcon >= 4.4_

liefert eine eindeutige Revisionskennung

**Rückgabewert** (string): Eindeutige Revisionskennung

Die Funktion liefert einen String mit einer eindeutigen Revisionskennung.

**Beispiel**

```php
echo IPS_GetKernelRevision();
// Beispielausgabe:
// 8edcb65b27506d687dd6a4d1cee470f86e2d89e1
```

## IPS_GetKernelRunlevel

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelrunlevel/

`int IPS_GetKernelRunlevel()`

_Benötigt Symcon >= 4.0_

liefert den Runlevel des Kernels

**Rückgabewert** (int): Runlevel des Kernels.

Die Funktion liefert den Runlevel des Systems zurück.

| Runlevel    | Rückgabewert | Beschreibung                                                                 |
| ----------- | ------------ | ---------------------------------------------------------------------------- |
| KR_CREATE   | 10101        | Kernel wird erstellt                                                         |
| KR_INIT     | 10102        | Kernel wird initialisiert. z.B. werden Module geladen und Instanzen erstellt |
| KR_READY    | 10103        | Kernel ist bereit und läuft                                                  |
| KR_UNINIT   | 10104        | Kernel wird heruntergefahren und alles sauber beendet                        |
| KR_SHUTDOWN | 10105        | Kernel wurde vollständig beendet                                             |

**Beispiel**

```php
echo IPS_GetKernelRunlevel();  // liefert z.B. für KR_READY: 10103
```

## IPS_GetKernelStartTime

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelstarttime/

`int IPS_GetKernelStartTime()`

_Benötigt Symcon >= 4.0_

liefert den Zeitpunkt, an dem IP-Symcon gestartet wurde

**Rückgabewert** (int): Zeitpunkt, an dem IP-Symcon gestartet wurde

Die Funktion liefert Datum und Uhrzeit des Startzeitpunkts von IP-Symcon als Unix Timestamp.

**Beispiel**

```php
// liefert z.B. 1204675012
echo IPS_GetKernelStartTime();
// liefert z.B. "2008.03.04 23:56:52"
echo date("Y.m.d H:i:s", IPS_GetKernelStartTime());
```

## IPS_GetKernelVersion

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getkernelversion/

`string IPS_GetKernelVersion()`

liefert die Versionsnummer des verwendeten Kernels

**Rückgabewert** (string): Programmversion. Major/Minorversion durch Punkt (".") getrennt.

Die Funktion liefert einen String mit der Nummer der IP-Symcon Programmversion. Durch Abfrage der Programmversion kann entschieden werden, ob ein Skript unter der gemeldeten Version lauffähig ist.

**Beispiel**

```php
echo IPS_GetKernelVersion();  // liefert z.B.: "2.00"
```

## IPS_GetLogDir

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getlogdir/

`string IPS_GetLogDir()`

_Benötigt Symcon >= 4.0_

liefert den Pfad zum IP-Symcon Logverzeichnis

**Rückgabewert** (string): Der vollständige Pfad zum IP-Symcon Logverzeichnis

Die Funktion liefert einen String mit dem vollständigen Pfad zum IP-Symcon Logverzeichnis. Je nach Betriebssystem enthält der Pfad ein abschließendes Slash (“/”) oder Backslash (“\”).

**Beispiel**

```php
echo IPS_GetLogDir();
// Beispielausgabe:
/*
//Windows
"C:\Programme\IP-Symcon\logs\"

// Linux, RaspberryPi
"/var/log/symcon/"

// MacOS
"/Library/Logs/Symcon"
*/
```

## IPS_GetSystemLanguage

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getsystemlanguage/

`string IPS_GetSystemLanguage()`

_Benötigt Symcon >= 6.1_

liefert die Sytemsprache des Betriebssystems auf dem IP-Symcon läuft

**Rückgabewert** (string): Die Systemsprache des Betriebssystems auf dem IP-Symcon läuft

Die Funktion liefert einen String mit der Systemsprache des Betriebssystems auf dem der IP-Symcon Server läuft zurück.

**Beispiel**

```php
echo IPS_GetSystemLanguage();
// Beispielausgabe:
/*
// Deutsch
de_DE

// Englisch
en_US
*/
```

## IPS_GetUpdateChannel

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-getupdatechannel/

`string IPS_GetUpdateChannel()`

_Benötigt Symcon >= 6.1_

liefert den aktuellen konfigurierten Update-Kanal zurück

**Rückgabewert** (string): aktuell konfigurierter Update-Kanal

Die Funktion liefert einen String mit dem aktuell konfigurierten Update-Kanal zurück.

**Beispiel**

```php
echo IPS_GetUpdateChannel(); //liefert z.B.: stable, beta oder testing
```

## IPS_LogMessage

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/programminformationen/ips-logmessage/

`bool IPS_LogMessage(string $Sender, string $Meldung)`

schreibt eine benutzerdefinierte Meldung in die Log-Datei

**Parameter**

- `$Sender` (string): Der angezeigte Absender der Meldung
- `$Meldung` (string): Die anzuzeigende Meldung

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Die anzuzeigende Meldung

**Beispiel**

```php
$SkriptStart = microtime(true);
//hier viel berechnen...
$SkriptLaufzeit = microtime(true) - $SkriptStart;
IPS_LogMessage($_IPS['SELF'], "Laufzeit beträgt ". $SkriptLaufzeit. "sek");
```