.BuildingControlLib.BuildingControl.VDI3813.ActuatorFunctions.Examples.TesterSunshadeActuator .BuildingControlLib.BuildingControl.VDI3813.ActuatorFunctions.Examples.TesterSunshadeActuatorSimulation to check the behaviour of the function model of "Sunshade actuator" from VDI 3813 [1, section 6.2.3, p. 20 - 21].
"Sunshade actuators position shading devices based on input information received from, e. g., weather protection, application (e. g. anti-glare) and operator functions. Each protective element is represented as a Sunshade actuator function (RA-FL section 3, column 2; informative function block Figure 13). The sunshade must be controllable by percent for the position (open position = 0 %; closed position = 100 %) and additionally, in the case of adjustable slats, by degrees of slat tilt (e. g. slat angles between –80° and 40°), i. e. the actuator function must be capable of moving the sunshade to any mechanically reachable position. The maximum and minimum slat angles and the total runtime of the sunshade must be adjustable. The current shade position and slat tilt are available as output information for display functions. It must be ensured that the response time of the actuator following receipt of input information for positioning is less than 200 ms so as to avoid any delay perceivable to the operator. For a definite position to be assumed in case of voltage recovery, parameterisation of this position value is required. The function is allocated to the room shell (fixed rooms) or the segment shell (flexible room layout)." [1, section 6.2.3, p. 20 - 21]
In the standard it is mentioned for the sunshade signal that it should contain two values when the sunshade contains slats, whereas the sunshade position should be a per cent value and the slat position should be a angle [1, section 4, p. 4 - 6]. Because these two values could not be bundled in an array, in this implementation every sunshade connector has two variables with different data types inside.
The simulation contains a signal source to imitate a new value command for the sunshade actuator. The signal is passed to a converter for changing the signal type from Modelica standard type to VDI 3813 semantic type (S_SET). From there the signal goes to the actuator function, which generates a motor control signal (M) and a signal for further processing or display of the information (S_STA). The S_STA output should be similar to the S_SET input, beside of the different data types. If S_SET is greater than zero, M should become TRUE.