From e7ea634528cdc95e7eb4a3d333a4d03f44e58e4f Mon Sep 17 00:00:00 2001 From: "klaus.schauer" <> Date: Tue, 13 Jul 2021 16:34:48 +0000 Subject: [PATCH] 10_EnOcean: commandref: link structure changed git-svn-id: https://svn.fhem.de/fhem/trunk@24743 2b470e98-0d58-463d-a4d8-8e2adae1ed80 --- fhem/FHEM/10_EnOcean.pm | 974 ++++++++++++++++++++-------------------- 1 file changed, 494 insertions(+), 480 deletions(-) diff --git a/fhem/FHEM/10_EnOcean.pm b/fhem/FHEM/10_EnOcean.pm index 43b09c89c..b08ef56a5 100755 --- a/fhem/FHEM/10_EnOcean.pm +++ b/fhem/FHEM/10_EnOcean.pm @@ -18298,15 +18298,17 @@ sub EnOcean_Delete($$) { =item summary_DE EnOcean Gateway und Aktor =begin html - +

EnOcean

Energy Management


The automatic control can be turned off by any other command. If the dimmaktor reports its stats, the control is also deactivated any manual input, for example on a wall switch.
- The straight-line characteristic is determined via the attribute openLoopCtrlScale. + The straight-line characteristic is determined via the attribute openLoopCtrlScale. Below and above the characteristic thresholds, the dimming values remain constant at the value of dimHigh or dimLow. - The name of the brightness sensor must be specified in the brightnessRefDev attribute.
+ The name of the brightness sensor must be specified in the brightnessRefDev attribute.
Currently, the constant light control is available for the gateway/dimming profile. More profiles will follow.

@@ -18567,17 +18569,17 @@ sub EnOcean_Delete($$) { power-up the remote device
get <name> remoteID

- All commands are described in the remote management chapters of the set- - and get-commands.

+ All commands are described in the remote management chapters of the set- + and get-commands.

The Remote Management Function is configured using the following attributes:

- The content of events is described in the chapter Remote Management Events

. + The content of events is described in the chapter Remote Management Events

. The following extended functions are supported: - The Signal Telegram function commands are activated by the attribute signal. - All commands are described in the signal telegram chapter of the get-commands. - The content of events is described in the chapter Signal Telegram Events. + The Signal Telegram function commands are activated by the attribute signal. + All commands are described in the signal telegram chapter of the get-commands. + The content of events is described in the chapter Signal Telegram Events.

@@ -18695,7 +18697,7 @@ sub EnOcean_Delete($$) {

- + Define - + Internals - + Set
The actual temperature will be taken from the temperature reported by - a temperature reference device temperatureRefDev - primarily or from the attribute actualTemp if it is set.
- If the attribute setCmdTrigger is set to "refDev", a setpoint + a temperature reference device temperatureRefDev + primarily or from the attribute actualTemp if it is set.
+ If the attribute setCmdTrigger is set to "refDev", a setpoint command is sent when the reference device is updated.
The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled setting + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled setting setpointScaled.
- The profile behaves like a master or slave, see devMode.
+ The profile behaves like a master or slave, see devMode.
The attr subType must be roomSensorControl.05 and attr manufID must be 019. The attribute must be set manually.

@@ -19136,18 +19138,18 @@ sub EnOcean_Delete($$) { Set the desired temperature
The actual temperature will be taken from the temperature reported by - a temperature reference device temperatureRefDev - primarily or from the attribute actualTemp if it is set.
- If the attribute setCmdTrigger is set to "refDev", a setpointTemp + a temperature reference device temperatureRefDev + primarily or from the attribute actualTemp if it is set.
+ If the attribute setCmdTrigger is set to "refDev", a setpointTemp command is sent when the reference device is updated.
This profil can be used with a further Room Sensor and Control Unit Eltako FTR55* to control a heating/cooling relay FHK12, FHK14 or FHK61. If Fhem and FTR55* is teached in, the temperature control of the FTR55* can be either blocked or to a setpoint deviation of +/- 3 K be limited. For this use the optional parameter [block] = lock|unlock, unlock is default.
- The profile behaves like a master or slave, see devMode.
+ The profile behaves like a master or slave, see devMode.
A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "off" and an interval of 1320 sec.
The attr subType must be roomSensorControl.05 and attr manufID must be 00D. The attributes must be set manually. @@ -19170,18 +19172,18 @@ sub EnOcean_Delete($$) { Set switch
The actual temperature will be taken from the temperature reported by - a temperature reference device temperatureRefDev - primarily or from the attribute actualTemp if it is set.
+ a temperature reference device temperatureRefDev + primarily or from the attribute actualTemp if it is set.
The actual humidity will be taken from the humidity reported by - a humidity reference device humidityRefDev - primarily or from the attribute humidity if it is set.
- If the attribute setCmdTrigger is set to "refDev", a setpoint + a humidity reference device humidityRefDev + primarily or from the attribute humidity if it is set.
+ If the attribute setCmdTrigger is set to "refDev", a setpoint command is sent when the reference device is updated.
The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled setting + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled setting setpointScaled.
- The profile behaves like a master or slave, see devMode.
+ The profile behaves like a master or slave, see devMode.
The attr subType must be roomSensorControl.01. The attribute must be set manually.

@@ -19202,11 +19204,11 @@ sub EnOcean_Delete($$) { Set switch
The actual temperature will be taken from the temperature reported by - a temperature reference device temperatureRefDev - primarily or from the attribute actualTemp if it is set.
- If the attribute setCmdTrigger is set to "refDev", a setpoint + a temperature reference device temperatureRefDev + primarily or from the attribute actualTemp if it is set.
+ If the attribute setCmdTrigger is set to "refDev", a setpoint command is sent when the reference device is updated.
- The profile behaves like a master or slave, see devMode.
+ The profile behaves like a master or slave, see devMode.
The attr subType must be roomSensorControl.01 and attr manufID must be 00D. The attribute must be set manually.

@@ -19233,7 +19235,7 @@ sub EnOcean_Delete($$) {
The periodic interval is configured using the attribute:
The attr subType must be environmentApp and devMode is set to master. This is done with the help of the inofficial EEPs ZZ-13-03 or ZZ-13-04. Type define EnOcean ZZ-13-04 getNextID manually. @@ -19248,13 +19250,13 @@ sub EnOcean_Delete($$) { where value is
  • setpoint setpoint/%
    Set the actuator to the specifed setpoint (0...100). The setpoint can also be set by the - setpointRefDev device if it is set.
    • + setpointRefDev device if it is set.
  • setpointTemp t/°C
    Set the actuator to the specifed temperature setpoint. The temperature setpoint can also be set by the - setpointTempRefDev device if it is set.
    + setpointTempRefDev device if it is set.
    The FHEM PID controller calculates the actuator setpoint based on the temperature setpoint. The controller's - operation can be set via the PID parameters pidFactor_P, - pidFactor_I and pidFactor_D.
    + operation can be set via the PID parameters pidFactor_P, + pidFactor_I and pidFactor_D.
    If the attribute pidCtrl is set to off, the PI controller of the actuator is used (selfCtrl mode). Please read the instruction manual of the device, whether the device has an internal PI controller.
  • runInit
    @@ -19268,34 +19270,34 @@ sub EnOcean_Delete($$) {
    The Heating Radiator Actuating Drive is configured using the following attributes:
    The actual temperature will be reported by the Heating Radiator Actuating Drive or by the - temperatureRefDev if it is set. The internal temperature sensor + temperatureRefDev if it is set. The internal temperature sensor of the Micropelt iTRV MVA-002 is not suitable as an actual temperature value for the PID controller. An external room thermostat is required.
    The attr event-on-change-reading .* shut not by set. The PID controller expects periodic events. If these are missing, a communication alarm is signaled.
    The attr subType must be hvac.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Teach-In / Teach-Out.
    + see Teach-In / Teach-Out.
    The command is not sent until the device wakes up and sends a message, usually every 10 minutes.
    • @@ -19309,13 +19311,13 @@ sub EnOcean_Delete($$) { where value is
  • setpoint setpoint/%
    Set the actuator to the specifed setpoint (0...100). The setpoint can also be set by the - setpointRefDev device if it is set.
    • + setpointRefDev device if it is set.
  • setpointTemp t/°C
    Set the actuator to the specifed temperature setpoint. The temperature setpoint can also be set by the - setpointTempRefDev device if it is set.
    + setpointTempRefDev device if it is set.
    The FHEM PID controller calculates the actuator setpoint based on the temperature setpoint. The controller's - operation can be set via the PID parameters pidFactor_P, - pidFactor_I and pidFactor_D.
    • + operation can be set via the PID parameters pidFactor_P, + pidFactor_I and pidFactor_D.
  • runInit
    Maintenance Mode: Run init sequence
  • valveOpens
    @@ -19327,38 +19329,38 @@ sub EnOcean_Delete($$) {
    The Heating Radiator Actuating Drive is configured using the following attributes:
    The actual temperature will be reported by the Heating Radiator Actuating Drive or by the - temperatureRefDev if it is set.
    + temperatureRefDev if it is set.
    The attr event-on-change-reading .* shut not by set. The PID controller expects periodic events. If these are missing, a communication alarm is signaled.
    The attr subType must be hvac.04. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Teach-In / Teach-Out.
    + see Teach-In / Teach-Out.
    The OEM version of the Holter SmartDrive MX has an internal PID controller. This function is activated by attr model Holter_OEM and attr pidCtrl off.
    The command is not sent until the device wakes up and sends a message, usually @@ -19376,13 +19378,13 @@ sub EnOcean_Delete($$) { Maintenance Mode: Run init sequence
  • setpoint setpoint/%
    Set the actuator to the specifed setpoint (0...100). The setpoint can also be set by the - setpointRefDev device if it is set.
    • + setpointRefDev device if it is set.
  • setpointTemp t/°C
    Set the actuator to the specifed temperature setpoint. The temperature setpoint can also be set by the - setpointTempRefDev device if it is set.
    + setpointTempRefDev device if it is set.
    The FHEM PID controller calculates the actuator setpoint based on the temperature setpoint. The controller's - operation can be set via the PID parameters pidFactor_P, - pidFactor_I and pidFactor_D.
    • + operation can be set via the PID parameters pidFactor_P, + pidFactor_I and pidFactor_D.
  • standby
    enter standby mode
    After the standby command, the valve remains closed permanently and can no longer be controlled by Fhem. @@ -19390,37 +19392,37 @@ sub EnOcean_Delete($$) {
    The Heating Radiator Actuating Drive is configured using the following attributes:
    The actual temperature will be reported by the Heating Radiator Actuating Drive or by the - temperatureRefDev if it is set.
    + temperatureRefDev if it is set.
    The attr event-on-change-reading .* shut not by set. The PID controller expects periodic events. If these are missing, a communication alarm is signaled.
    The attr subType must be hvac.06. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Teach-In / Teach-Out.
    + see Teach-In / Teach-Out.
    The actuator has an internal PID controller. This function is activated by attr pidCtrl off.
    The command is not sent until the device wakes up and sends a message, usually @@ -19453,7 +19455,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be hvac.10. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Teach-In / Teach-Out. + see Teach-In / Teach-Out.


    • @@ -19474,11 +19476,11 @@ sub EnOcean_Delete($$) {
    The attr subType must be hvac.11. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Teach-In / Teach-Out. + see Teach-In / Teach-Out.

    -
  • Energy management, demand response (EEP A5-37-01)
    +
  • Energy management, demand response (EEP A5-37-01)
    demand response master commands

    The generic profile device is configured using the following attributes:
    The attr subType must be genericProfile. This is done if the device was created by autocreate. If the profile in slave mode is operated, especially the channel @@ -20233,8 +20235,8 @@ sub EnOcean_Delete($$) {
    The Radio Link Test device is configured using the following attributes:
    The attr subType must be readioLinkTest. This is done if the device was created by autocreate or manually by define <name> EnOcean A5-3F-00
    . @@ -20243,11 +20245,11 @@ sub EnOcean_Delete($$) { - + Get
    Channel Range: 1 ... 4|all, default is all
    - The devive can only fully controlled if the attributes alarmAction, - angleTime, reposition and shutTime + The devive can only fully controlled if the attributes alarmAction, + angleTime, reposition and shutTime are set correctly.
    - With the attribute defaultChannel the default channel can be specified.
    + With the attribute defaultChannel the default channel can be specified.
    The attr subType must be blindsCtrl.00 or blindsCrtl.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.


    • @@ -20387,8 +20389,8 @@ sub EnOcean_Delete($$) {
    The multisensor window handle is configured using the following attributes:
    The attr subType must be multisensor.01. This is done if the device was created by autocreate. @@ -20412,7 +20414,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be roomCtrlPanel.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -20427,7 +20429,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be fanCtrl.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -20444,7 +20446,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be heatingActuator.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -20461,7 +20463,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be heatRecovery.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -20475,136 +20477,136 @@ sub EnOcean_Delete($$) {
    The attr subType must be valveCtrl.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. The profile - behaves like a master or slave, see devMode. + see Bidirectional Teach-In / Teach-Out. The profile + behaves like a master or slave, see devMode.


    - + Attributes
    - + Generated events
    The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "off" and an interval of 1320 sec.
    The attr subType must be roomSensorControl.05 and attr manufID must be 00D for Eltako Devices. This is done if the device was @@ -21861,8 +21875,8 @@ sub EnOcean_Delete($$) {
  • state: T: t/°C H: rH/% SP: 0 ... 255 SW: 0|1

    • The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    The attr subType must be roomSensorControl.01 and attr @@ -21882,8 +21896,8 @@ sub EnOcean_Delete($$) {
  • state: T: t/°C SP: 0 ... 63 P: absent|present

    • The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    The attr subType must be roomSensorControl.02. This is done if the device was @@ -22000,8 +22014,8 @@ sub EnOcean_Delete($$) {
  • state: T: t/°C F: 0|1|2|3|auto SP: 0 ... 255 P: absent|present|disabled

    • The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    The attr subType must be roomSensorControl.1F. This is done if the device was @@ -22023,8 +22037,8 @@ sub EnOcean_Delete($$) {
  • state: t/°C H: rH/% SP: 0 ... 255 B: ok|low

    • The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    The attr subType must be roomSensorControl.20. This is done if the device was created by autocreate. @@ -22044,8 +22058,8 @@ sub EnOcean_Delete($$) {
  • state: t/°C H: rH/% SP: 0 ... 255 F: auto|off|1|2|3 O: occupied|unoccupied

    • The scaling of the setpoint adjustment is device- and vendor-specific. Set the - attributes scaleMax, scaleMin and - scaleDecimals for the additional scaled reading + attributes scaleMax, scaleMin and + scaleDecimals for the additional scaled reading setpointScaled. Use attribut userReadings to adjust the scaling alternatively.
    The attr subType must be roomSensorControl.22. @@ -22093,7 +22107,7 @@ sub EnOcean_Delete($$) {

    -
  • Blind Status (EEP A5-11-03)
    +
  • Blind Status (EEP A5-11-03)
    [untested, experimental status]

    The attr subType must be environmentApp. This is done if the device was created by autocreate. The global attributes latitude and longitude are set automatically if the attribute - updateGlobalAttr is set.
    + updateGlobalAttr is set.


    • @@ -22382,7 +22396,7 @@ sub EnOcean_Delete($$) { The attr subType must be multiFuncSensor. This is done if the device was created by autocreate. A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "on" and an interval of 132 sec.

    @@ -22402,7 +22416,7 @@ sub EnOcean_Delete($$) { The attr subType must be doorContact. This is done if the device was created by autocreate.
    A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "on" and an interval of 132 sec.

    @@ -22421,7 +22435,7 @@ sub EnOcean_Delete($$) { The attr subType must be windowContact. This is done if the device was created by autocreate.
    A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "on" and an interval of 132 sec.

    @@ -22909,7 +22923,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be actuator.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -22937,7 +22951,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be blindsCtrl.00 or blindsCtrl.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -22977,7 +22991,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be multisensor.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -23003,11 +23017,11 @@ sub EnOcean_Delete($$) {
    The multisensor is configured using the following attributes:
    A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "on" and an interval of 990 sec.
    After the teach-in, the sensor must be calibrated immediately. The procedure is described in the user manual. If calibration was successful, the reading calibrationStep displays none and statusCalibration ok.
    @@ -23043,7 +23057,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be roomCtrlPanel.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -23068,7 +23082,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be roomCtrlPanel.01. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired by Smart Ack, - see SmartAck Learning. + see SmartAck Learning.

    @@ -23117,7 +23131,7 @@ sub EnOcean_Delete($$) { The attr subType must be multiFuncSensor.40. This is done if the device was created by autocreate. A monitoring period can be set for signOfLife telegrams of the sensor, see - signOfLife and signOfLifeInterval. + signOfLife and signOfLifeInterval. Default is "on" and an interval of 216 sec.


    @@ -23155,7 +23169,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be fanCtrl.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -23194,7 +23208,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be heatingActuator.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -23262,7 +23276,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be heatRecovery.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.

    @@ -23277,7 +23291,7 @@ sub EnOcean_Delete($$) {
    The attr subType must be valveCtrl.00. This is done if the device was created by autocreate. To control the device, it must be bidirectional paired, - see Bidirectional Teach-In / Teach-Out. + see Bidirectional Teach-In / Teach-Out.