Functional profile "BIU - 2 ILT"

Transcription

1 Cécile PAULME 24 novembre 1999 AEG Functional profile "BIU - 2 ILT"

2 1. Overview This functional profile implements a motor interface for 2 ILT motors. This node works as an open loop actuator object. ILT motor 1 ILT motor 2 Node Object #0 [ID 0] Actuator Object 3 Group Control [ID 1] Actuator Object 3 Wind [ID 2] Actuator Object 3 Sun [ID 3] File transfert Local control 1 Local control 2 Figure 1-1 Functional Profile 2/39

3 2. Node Object #0 Node Object #0 [ID 0] nv1 nvirequest SNVT_obj_request Network variables nv2 nvostatus SNVT_obj_status nv3 nvisblndrequest SNVT_char_ascii nv4 nvosblndstatus1 SNVT_SnblndState nv5 nvosblndstatus2 SNVT_SnblndState nv6 nvisblndinforeq SNVT_char_ascii nv7 nvosblndinfo SNVT_str_int nv8 nviinstalldel SNVT_lev_disc nv9 nvitestmode SNVT_sy_test_mode nv10 nviscncfgpshbttn SNVT_scene_cfg Configuration Properties nc1 nciconfigsource nc2 ncistsmaxsendt nc3 ncisblndmaxsendt nc4 ncidsloccontr nc5 ncidslocintpstn nc6 ncisnwdmaxrcvt SNVT_config_src SNVT_elapsed_tm SNVT_time_sec SNVT_lev_disc SNVT_lev_disc SNVT_time_sec Figure 2-1 Object Details 3/39

4 Table 2-1 SNVT I/O Details NV # Name In/Out SNVT Type Class Description 1 nvirequest In SNVT_obj_request nv Object request 2 nvostatus Out SNTV_obj_status nv Object status 3 nvisblndrequest In SNVT_char_ascii nv Motor status Request 4 nvosblndstatus1 Out SNVT_SnblndState nv Motor 1 status report 5 nvosblndstatus2 Out SNVT_SnblndState nv Motor 2 status report 6 nvisblndinforeq In SNVT_char_ascii nv Motor information request 7 nvosblndinfo Out SNVT_ str_int nv Motor information 8 nviinstalldel In SNVT_lev_disc nv Relative to intuitive installation ( LED turned on or off ) 9 nvitestmode In SNVT_sy_test_mode nv Operating mode 10 nviscncfgpshbtt n In SNVT_scene_cfg nv Intermediate push buttons configuration setting Table 2-2 Configuration Details NC # Name SNVT type Description 1 nciconfigsource SNVT_config_src Network configuration source 2 ncistsmaxsendt SNVT_elapsed_tm Send time, Maximum for the node status 3 ncisblndmaxsendt SNVT_time_sec Send time, Maximum for the sunblind status 4 ncidsloccontr SNVT_lev_disc Local control locking 5 ncidslocintpstn SNVT_lev_disc Intermediate position settings locking 6 ncisnwdmaxrcvt SNVT_time_sec Receive time, Maximum to receive sun and wind values 4/39

5 Network Variables Object request network input SNVT_obj_request nvirequest; This input network variable provides the mechanism to request a particular node for a particular object within a node. The meaning of the function codes for SNVT_obj_request are described in the SNVT Master List and Programmer's Guide ( ). The valid range is any value within the defined limits of SNVT_obj_request. The only mandatory request functions are RQ_NORMAL, RQ_UPDATE_STATUS and RQ_REPORT_MASK. Unsupported request functions must return invalid_request in the object status. It is not required to support object disable, self-test or alarm reporting. If object disable is not supported, the disabled bit in the status mask must be zero for that object. See below for a description of the status mask. If self-test is not supported, the fail_self_test and self_test_in_progress bits in the status mask must be zero for that object. If alarm reporting is not supported, the in_alarm bit in the status mask must be zero for that object. Supporting requests to object id 0 is optional. A request RQ_DISABLE to object id 0 means that all objects in the node should be disabled. If any of the objects in the node supports the disable function, then those objects should be disabled, and invalid_request should not be reported. However, if none of the objects in the node supports the disable function, then invalid_request should be reported. A request RQ_NORMAL to object id 0 means that all objects in the node should be enabled. This is always a valid request. A request RQ_UPDATE_STATUS to object id 0 updates the status of the node object only. The status bits of object id 0 (with the exception of invalid_request and invalid_id) are defined to be the inclusive OR of the status bits of all the other objects in the node, with the possible addition of error and other conditions attributed to the node as a whole, rather than to any individual object. For example, if comm_failure is supported for the node object, then it should be set whenever any of the objects in the node reports communications failure, as well as when there is a communications failure at the node level. A request RQ_REPORT_MASK to object id 0 causes the object to respond with a mask of supported status bits in the SNVT_obj_status output network variable. A one bit in the mask means that the node may set the corresponding bit in the object status when the condition defined for that bit occurs. A zero means that the bit may never be set by the node. 5/39

6 Object status network output SNVT_obj_status nvostatus; This output network variable reports the status for any object of the node. The valid range is any value within the defined limits of SNVT_ obj_status. The meaning of the fields of SNVT_obj_status are detailed in the SNVT MasterList and Programmer's Guide ( ). object_id invalid_id invalid_request disabled out_of_service mechanical_fault feedback_failure fail_self_test self_test_in_progress locked_out manual_control in_alarm in_override reserved1 reserved2 Used Used Used Used Unused Unused Unused Unused Unused Unused Used Unused Unused Unused Unused When Transmitted Data are transmitted whenever a value is received on the Object Request input and when the Object Status Max Send Timer expires. When the Object Status Max Send Timer expires the status of each object (including the node object) is returned sequentially in round-robin fashion, one object status per expiration of the timer. 6/39

7 Update Rate The default update rate for this network variable is 0 times per second. Default Service Type The default service type is acknowledged. Motor status request network input SNVT_char_ascii nvisnbldrequest; This input network variable provides the mechanism to request the motor 1 or 2 status depending of the index value. SNVT_char_ascii Description 1 Request motor 1 status 2 Request motor 2 status Motors status reports network output SNVT_SnblndState nvosblndstatus1; SNVT_SnblndState nvosblndstatus2; These output network variables report the status of the motors. The SNVT_SnblndState is defined by the following structure : typedef struct { SNVT_setting SnblndSource SnblndCause } snvt_snblndstate CurrentPosition Source Cause Current position gives the information of the current position. The source field indicates the source of the current control of the motor. 7/39

8 The cause field indicates what is the cause of the difference between the current position and the position asked. The valid range is any value within the defined limits of SNVT_SnblndState. Table 2-3 Current Position Command Position * Angle ** Interpretation OFF ( = 0 ) XX XX unused ON ( = 1 ) XX XX unused DOWN ( = 2 ) invalid invalid going down UP ( = 3 ) invalid invalid going up STOP ( = 4 ) invalid invalid stopped to unknown position STATE (= 5 ) 100% 0% 0<x%<100 invalid invalid invalid up position down position specified position NULL ( = 255 ) XX XX unused * invalid data FF ** invalid data 7FFF Table 2-4 Source Enum Name Description 0 Sce_Local_control a software local control input is the source Used 1 Sce_Group_control a network control is the source Used 2 Sce_Wind a wind sensor is the source Unused 3 Sce_Sun a sun sensor is the source Used 4 Sce_Rain a rain sensor is the source Unused 5 Sce_Frost a frost sensor is the source Unused 6 Sce_Scheduler_0 a scheduler is the source (timer) Unused 7 Sce_Scheduler_1 a scheduler is the source (timer) Unused 8 Sce_Temp_Outdoor an exterior temperature sensor is the source Unused 9 Sce_Temp_Indoor an interior temperature sensor is the source Unused 10 Sce_Humid_Outdoor an exterior relative humidity sensor is the source Unused 11 Sce_ Humid _Indoor an interior relative humidity sensor is the source Unused 12 Sce _Light an interior light sensor is the source Unused 13 Sce_Scene_Panel a scene control is the source Unused 255 Sce_Nul unknown Used 8/39

9 Table 2-5 Cause Enum Name Description 0 Cse_Well_Executed Used 1 Cse_In_Progress In progress Used 2 Cse_No_Limit_Switch The limit switches are not set Unused 3 Cse_Obstacle_Downward Obstacle occurring during downward movement Used 4 Cse_Obstacle_Upward Obstacle occurring during upward movement Used 5 Cse_Thermal_Detection Thermal detection Unused 6 Cse_Power_Failure Mains failure Unused 255 Cse_Nul Used When Transmitted Data is transmitted sequentially in round-robin fashion with nvosblndstatus2 when Sunblind Status Max Send Timer expires or when a value is received on the motor Request input. Update Rate The default update rate for this network variable is 0 times per second. Default Service Type The default service type is acknowledged. Motor Information Request network input SNVT_char_ascii nvisblndinforeq; This input network variable provides the mechanism to request information on the motor 1 or 2 depending of the index value. SNVT_char_ascii Description 1 Request information on motor 1 2 Request information on motor 2 9/39

10 Motor information Report network output SNVT_ str_int nvosblndinfo; This output network variable reports information on the motors. String with the length of 14 caracters i.e. M1:15/ Motor 1 : torque / speed week - year of production. When Transmitted Data are transmitted whenever a value is received on the Motor Information Request input. LED installation network input SNVT_lev_disc nviinstalldel; This input network variable commands the desired state of the LED to be on or off. SNVT_lev_disc ST_ON ST_OFF Description LED turned on LED turned off Operating mode 10/39 network input SNVT_sy_test_mode nvitestmode;

11 This input network variable enables to select the test or normal functionning mode.this SVNT is specific to SOMFY, its structure is defined as hereunder by the use of two defined SNVTs : typedef struct { SNVT_lev_disc SNVT_elapsed_tm } somfy_test_mode; Demo; Time; Demo specifies the functioning mode. In the test mode, shortened time delays are used for the wind and sun functions. Time specifies the repetition frequency to stay in the test mode. SNVT_lev_disc ST_ON ST_OFF Test mode Normal Description SNVT_elapsed_time Demonstration Normal Min Max Disable days 0 0 x hours 0 1 x minutes 0 59 x seconds 0 59 x milliseconds 0 0 x The minimum step is 1s. All others differents values than the ones specified are considered as 0s. Scene configuration network input SNVT_scene_cfg nviscncfgpshbttn; 11/39

12 This input network variable provides the mechanism to set the values of the 3 intermediate push buttons of the 2 local switches. function : SAVE ( to memorize a new scene ) CLEAR ( to remove a scene ) REPORT ( to report about the scene ) scene_number : 0 to 7 setting : 0 % to 100% (255 invalid data) rotation : 0 fade_time : 0 delay_time : 0 priority : 0 Default value Local control 1 stop Local control 1 push button 75 Local control 1 push button 50 Local control 1 push button 25 Local control 2 stop Local control 2 push button 75 Local control 2 push button 50 Local control 2 push button 25 scene_number setting rotation fade_time delay_time priority 0 unused % % % unused % % % Configuration Properties 12/39

13 Network config network input config SNVT_config_src nciconfigsource; This configuration network variable makes it possible that the node supports either the self-installation mode or to be installed externally. When a node is self-installed this variable is set to CFG_LOCAL. This variable has to be set to CFG_EXTERNAL to be installed by an external source. SNVT_config_src Value Description CFG_LOCAL 00 Local configuration CFG_EXTERNAL 01 External configuration CFG_NULL FF Invalid CFG_LOCAL. Status Max send time network input config SNVT_elapsed_tm ncimaxstssendt ; This configuration network variable is used to control the maximum period of time that expires before the object automatically transmits the curtent value of the nvostatus output variable. 13/39

14 Valid Disabled Min Max days hours minutes seconds miliseconds The minimum step is 1s. All others values are considered as 0s. The default value is 0. Sunblind status Max send time network input config SCPT_maxSendTime ncisblndmaxsendt; This configuration network variable is used to control the maximum period of time that expires before the object automatically transmits the current value of the nvosblndstatus1 and nvosblndstatus2 output variables. Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 14/39

15 The default value is 0. Local controls locking network input config SNVT_lev_disc ncidsloccontrol ; This configuration network variable is used to enable or disable local controls. SNVT_lev_disc Description ST_ON ST_OFF disable enable ST_OFF Intermediate position settings locking network input config SNVT_lev_disc ncidslocintpstn ; This configuration network variable is used to enable or disable the settings of the intermediate positions by the local switches. SNVT_lev_disc Description ST_ON ST_OFF disable enable 15/39

16 ST_OFF Sensor values max receive time network input config SNVT_time_sec ncisnwdmaxrcvt ; This configuration network variable is used to control the maximum period of time that expires before the object automatically does not take into account the value of the brightness and wind if an updated value is not received. Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 180s. 16/39

17 3. Group control object Actuator Object #3 Group Control nv1 nviswitch0 SNVT_setting Network variables nv2 nviswitch1 SNVT_setting nv3 nviswitch2 SNVT_setting nv4 nviswitch3 SNVT_setting nv5 nviswitch4 SNVT_setting Configuration Properties nc1 nciswprio0 nc3 nciswprio1 nc5 nciswprio2 nc7 nciswprio3 nc9 nciswprio4 nc10 nciswcontout0 nc11 nciswcontout1 nc12 nciswcontout2 nc13 nciswcontout3 nc14 nciswcontout4 nc15 nciswapptdly0 nc16 nciswapptdly1 nc17 nciswapptdly2 nc18 nciswapptdly3 nc19 nciswapptdly4 nc20 nciswrlsatmtc nc21 nciswmaxrcvt0 nc22 nciswmaxrcvt1 nc23 nciswmaxrcvt2 nc24 nciswmaxrcvt3 nc25 nciswmaxrcvt4 SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_char_ascii SNVT_time_sec SNVT_time_sec SNVT_time_sec SNVT_time_sec SNVT_time_sec SNVT_state SNVT_time_sec SNVT_time_sec SNVT_time_sec SNVT_time_sec SNVT_time_sec Figure 3-1 Object Details 17/39

18 Table 3-1 SNVT I/O Details NV # Name In/Out SNVT Type Class Description 1 nviswitch0 In SNVT_setting nv Network setting input 0 2 nviswitch1 In SNVT_setting nv i Network setting input 1 3 nviswitch2 In SNVT_setting nv Network setting input 2 4 nviswitch3 In SNVT_setting nv Network setting input 3 5 nviswitch4 In SNVT_setting nv Network setting input 4 Table 3-2 Configuration Details NC # Name SNVT type Description 1 nciswprio0 SNVT_char_ascii Priority level of nviswitch0 3 nciswprio1 SNVT_char_ascii Priority level of nviswitch1 5 nciswprio2 SNVT_char_ascii Priority level of nviswitch2 7 nciswprio3 SNVT_char_ascii Priority level of nviswitch3 9 nciswprio4 SNVT_char_ascii Priority level of nviswitch4 10 nciswcontout0 SNVT_char_ascii Motors controlled by nviswitch0 11 nciswcontout1 SNVT_char_ascii Motors controlled by nviswitch1 12 nciswcontout2 SNVT_char_ascii Motors controlled by nviswitch2 13 nciswcontout3 SNVT_char_ascii Motors controlled by nviswitch3 14 nciswcontout4 SNVT_char_ascii Motors controlled by nviswitch4 15 nciswapptdly0 SNVT_time_sec nviswitch0 appearing time delay 16 nciswapptdly1 SNVT_time_sec nviswitch1 appearing time delay 17 nciswapptdly2 SNVT_time_sec nviswitch2 appearing time delay 18 nciswapptdly3 SNVT_time_sec nviswitch3 appearing time delay 19 nciswapptdly4 SNVT_time_sec nviswitch4 appearing time delay 20 nciswrlsatmtc SNVT_state Re-initialisation of sensor inputs with no priority 21 nciswmaxrcvt0 SNVT_time_sec nviswitch0 maximum receive time 22 nciswmaxrcvt1 SNVT_time_sec nviswitch1 maximum receive time 23 nciswmaxrcvt2 SNVT_time_sec nviswitch2 maximum receive time 24 nciswmaxrcvt3 SNVT_time_sec nviswitch3 maximum receive time 25 nciswmaxrcvt4 SNVT_time_sec nviswitch4 maximum receive time 18/39

19 Network Variables Network setting inputs network inputs SNVT_setting nviswitch0 ; SNVT_setting nviswitch1 ; SNVT_setting nviswitch2 ; SNVT_setting nviswitch3 ; SNVT_setting nviswitch4 ; These input network variables contain a position setting to be carried on. The SNVT_setting is defined by the following structure : type enum function OFF, ON, DOWN, UP, STOP, STATE, NULL = 255 type unsigned short setting (position) type unsigned long rotation (angle) The valid range is any value within the defined limits of SNVT_setting. 19/39

20 Command Position * Angle ** Interpretation OFF ( = 0 ) XX XX unused ON ( = 1 ) XX XX unused DOWN ( = 2 ) invalid invalid going down UP ( = 3 ) invalid invalid going up STOP ( = 4 ) invalid invalid stopped to unknown position STATE (= 5 ) 100% 0% 0<x%<100 invalid invalid invalid up position down position specified position NULL ( = 255 ) XX XX unused * invalid data FF ** invalid data 7FFF Configuration Properties Priority levels network input config SNVT_char_ascii nciswprio0 ; SNVT_char_ascii nciswprio1 ; SNVT_char_ascii nciswprio2 ; SNVT_char_ascii nciswprio3 ; SNVT_char_ascii nciswprio4 ; These configuration network variables enable to set a priority level to each network setting input. 20/39

21 0 to 255. Value Priority level 255 No Priority 200 Low Priority 150 Medium Priority 100 High Priority s nciswprio0 low nciswprio1 nciswprio2 nciswprio3 nciswprio4 no no no high Motor assignments to network setting inputs network input config SNVT_char_ascii nciswcontout0 ; SNVT_char_ascii nciswcontout1 ; SNVT_char_ascii nciswcontout2 ; SNVT_char_ascii nciswcontout3 ; SNVT_char_ascii nciswcontout4 ; These configuration network variables define which motor has to take into account the network input settings. 21/39

22 Value Motors bit 7 bit 6 bit 5 bit 4 bit 3 bit 2 bit 1 bit X X X X s nciswcontout0 03 ( motor 1 and motor 2 ) nciswcontout1 03 ( motor 1 and motor 2 ) nciswcontout2 03 ( motor 1 and motor 2 ) nciswcontout3 03 ( motor 1 and motor 2 ) nciswcontout4 03 ( motor 1 and motor 2 ) Appearing time delays network input config SNVT_time_sec nciswapptdly0 ; SNVT_time_sec nciswapptdly1 ; SNVT_time_sec nciswapptdly2 ; SNVT_time_sec nciswapptdly3 ; SNVT_time_sec nciswapptdly4 ; These configuration network variables set an switch appearing time delay that the actuator interface has to take into account between receiving a new value on a network setting input and the corresponding action. 22/39

23 Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. s nciswapptdly0 0 nciswapptdly1 0 nciswapptdly2 0 nciswapptdly3 0 nciswapptdly4 0 No prio re-do network input config SNVT_state nciswrlsatmtc ; This configuration network variable enables to define if the node has to take into account sensor actions with no priority when all other settings have disappeared. 23/39

24 bit 0 0 nviswitch0 No-prio Redo Not activated 1 Activated bit 1 0 nviswitch1 No-prio Redo Not activated 1 Activated bit 2 0 nviswitch2 No-prio Redo Not activated 1 Activated bit 3 0 nviswitch3 No-prio Redo Not activated 1 Activated bit 4 0 nviswitch4 No-prio Redo Not activated 1 Activated Max receive times network input config SNVT_time_sec nciswmaxrcvt0 ; SNVT_time_sec nciswmaxrcvt1 ; SNVT_time_sec nciswmaxrcvt2 ; SNVT_time_sec nciswmaxrcvt3 ; SNVT_time_sec nciswmaxrcvt4 ; These configuration network variables are used to control the maximum period of time that expires before the object automatically doesn t take into account the value of the corresponding nviswitch if a new value is not received. Valid Min Max seconds /39

25 The minimum step is 1s. All others values are considered as invalid. s nciswmaxrcvt0 180 nciswmaxrcvt1 180 nciswmaxrcvt2 180 nciswmaxrcvt3 180 nciswmaxrcvt /39

26 4. Wind Object Actuator Object #3 Wind nv1 nviwind SNVT_speed Network variables Configuration Properties nc1 nciwdthresh nc2 nciwdprio nc3 nciwdapptdly nc4 nciwddistdly nc5 nciwdappact nc6 nciwddisact nc7 nciwdapppriodly nc8 nciwddispriodly SNVT_speed SNVT_char_ascii SNVT_time_sec SNVT_time_sec SNVT_setting SNVT_setting SNVT_lev_disc SNVT_lev_disc Figure 4-1 Object details Table 4-1 SNVT I/O Details NV # Name In/Out SNVT Type Class Description 1 nviwind In SNVT_speed vi Wind speed 26/39

27 Table 4-2 Configuration Details NC # Name SNVT type Description 1 nciwdthresh SNVT_wind Wind threshold 2 nciwdprio SNVT_char_ascii Wind priority level 3 nciwdapptdly SNVT_time_sec Wind appearing time delay 4 nciwddistdly SNVT_time_sec Wind disappearing time delay 5 nciwdappact SNVT_setting Wind appearing action 6 nciwddisact SNVT_setting Wind disappearing action 7 nciwdapppriodly SNVT_lev_disc Duration of appearing action 8 nciwddispriodly SNVT_lev_disc Duration of disappearing action Network Variables Wind speed network input SNVT_speed nviwind; This input network variable indicates the wind speed. When the speed becomes higher or lower than the threshold, it commands the desired position of the actuator to be the one as defined in the application (nciwdappact and nciwddisact ). The valid range is any value within the defined limits of SNVT_speed : 0 to m/s by steps of 0.1 m/s. 27/39

28 Configuration Properties Wind speed threshold network input config SNVT_speed nciwdthresh; This configuration network variable enables the setting of a threshold for the wind function. The valid range is any value within the defined limits of SNVT_speed. 6,9 m/s ( 25 km/h ). Wind priority level network input config SNVT_char_ascii nciwdprio ; This configuration network variable enables to set a priority level for the wind function. 0 to 255 Value Priority level 255 No Priority 200 Low Priority 150 Medium Priority 100 High Priority 28/39

29 High priority ( 100 ). Wind appearing time delay network input config SNVT_time_sec nciwdapptdly; This configuration network variable sets a wind appearing time delay that the sunblind interface has to take into account when the wind speed becomes higher than the threshold. Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 1s Wind disappearing time delay network input config SNVT_time_sec nciwddistdly; This configuration network variable sets a wind disappearing time delay that the sunblind interface has to take into account when the wind speed becomes lower than the threshold. 29/39

30 Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 720s Wind appearing action network input config SNVT_setting nciwdappact; This configuration network variable defines the action to be carried on at the end of the appearing time delay. The SNVT_setting is defined by the following structure : type enum function OFF, ON, DOWN, UP, STOP, STATE, NULL = 255 type unsigned short setting (position) type unsigned long rotation (angle) The valid range is any value defined in the SVNT_setting. 30/39

31 Function Position * Angle ** Description Interpretation OFF ( = 0 ) XX XX OFF active unused ON ( = 1 ) XX XX ON active unused DOWN ( = 2 ) invalid or 0% invalid or 0 Down active going down to the down limit position invalid or 0% >0 to 180 Relative Down relative downward orientation UP ( = 3 ) invalid or 0% invalid or 0 Up active going up to the up limit position invalid or 0% >0 to 180 Relative Up relative upward orientation STOP ( = 4 ) XX XX Stop active stop action STATE (= 5 ) 0% invalid or 0 Position active going down to the down limit position 100% invalid Position active going up to the up limit position 0% >0 to 180 Position & Angle active going down to the down limit position then upward orientation NULL ( = 255 ) XX XX Release release of the previous command * invalid data FF ** invalid data 7FFF UP, invalid, invalid Wind disappearing action network input config SNVT_setting nciwddisact; This configuration network variable defines the action to be carried on at the end of the disappearing time delay. The valid range is any value defined in the SVNT_setting ( ref to Wind appearing action ). Default value NULL, invalid, invalid ( no action ). 31/39

32 Duration of appearing action network input config SNVT_lev_disc nciwdapppriodly; This configuration network variable sets the control linked to wind appearing as maintained or released ( permanent or one shot ). SNVT_lev_disc ST_ON ST_OFF Maintained Released Description Maintained. Duration of disappearing action network input config SNVT_lev_disc nciwddispriodly; This configuration network variable sets the control linked to wind disappearing as maintained or released ( permanent or one shot ). SNVT_lev_disc ST_ON ST_OFF Maintained Released Description Released. 32/39

33 5. Sun Object Actuator Object #3 Sun nv1 nvisun SNVT_lux Network variables Configuration Properties nc1 ncisnthresh nc2 ncisnprio nc3 ncisnapptdly nc4 ncisndistdly nc5 ncisnappact nc6 ncisndisact nc7 ncisnapppriodly nc8 ncisndispriodly SNVT_lux SNVT_char_ascii SNVT_time_sec SNVT_time_sec SNVT_setting SNVT_setting SNVT_lev_disc SNVT_lev_disc Figure 5-1 Object Details Table 5-1 SNVT I/O Details NV # Name In/Out SNVT Type Class Description 1 nvisun In SNVT_lux nv Sun brightness 33/39

34 Table 5-2 Configuration Details NC # Name SCPT type Description 1 ncisnthresh SNVT_lux Sun threshold 2 ncisnprio SNVT_char_ascii Sun priority level 3 ncisnapptdly SNVT_time_sec Sun appearing time delay 4 ncisndistdly SNVT_time_sec Sun disappearing time delay 5 ncisnappact SNVT_setting Sun appearing action 6 ncisndisact SNVT_setting Sun disappearing action 7 ncisnapppriodly SNVT_lev_disc Duration of appearing action 8 ncisndispriodly SNVT_lev_disc Duration of disappearing action Network Variables Sun brightness network input SNVT_lux nvisun; This input network variable indicates the sun brightness. When the brightness becomes higher or lower than the threshold, it commands the desired position of the actuator to be the one as defined in the application (ncisnappact and ncisndisact ). The valid range is any value within the defined limits of SNVT_lux : 0 to lux by steps of 1 lux. 34/39

35 Configuration Properties Sun brightness threshold network input config SNVT_lux ncisnthresh; This configuration network variable enables the setting of a threshold for the sun function. The valid range is any value within the defined limits of SNVT_lux lux. Sun priority level network input config SNVT_char_ascii ncisnprio ; This configuration network variable enables to set a priority level for the sun function. 0 to 255 Value Priority level 255 No Priority 200 Low Priority 150 Medium Priority 100 High Priority 35/39

36 No priority ( 255 ). Sun appearing time delay network input config SNVT_time_sec ncisnapptdly; This configuration network variable sets a sun appearing time delay that the sunblind interface has to take into account when the sun brightness becomes higher than the threshold. Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 180s Sun disappearing time delay network input config SNVT_time_sec ncisndistdly; This configuration network variable sets a sun disappearing time delay that the sunblind interface has to take into account when the sun brightness becomes lower than the threshold. 36/39

37 Valid Min Max seconds The minimum step is 1s. All others values are considered as invalid. 900s. Sun appearing action network input config SNVT_setting ncisnappact; This configuration network variable defines the action to be carried on at the end of the appearing time delay. The SNVT_setting is defined by the following structure : type enum function OFF, ON, DOWN, UP, STOP, STATE, NULL = 255 type unsigned short setting (position) type unsigned long rotation (angle) The valid range is any value defined in the SVNT_setting. 37/39

38 Command Position * Angle ** Interpretation OFF ( = 0 ) XX XX unused ON ( = 1 ) XX XX unused DOWN ( = 2 ) invalid invalid going down UP ( = 3 ) invalid invalid going up STOP ( = 4 ) invalid invalid stopped to unknown position STATE (= 5 ) 100% 0% 0<x%<100 invalid invalid invalid up position down position specified position NULL ( = 255 ) XX XX unused * invalid data FF ** invalid data 7FFF DOWN, invalid, invalid Sun disappearing action network input config SNVT_setting ncisndisact; This configuration network variable defines the action to be carried on at the end of the disappearing time delay. The valid range is any value defined in the SVNT_setting ( ref to Sun appearing action ). Default value UP, invalid, invalid. 38/39

39 Duration of appearing action network input config SNVT_lev_disc ncisnapppriodly; This configuration network variable sets the control linked to sun appearing as maintained or released ( permanent or one shot ). SNVT_lev_disc ST_ON ST_OFF Maintained Released Description Maintained. Duration of disappearing action network input config SNVT_lev_disc ncisnapppriodly; This configuration network variable sets the control linked to sun disappearing as maintained or released ( permanent or one shot ). SNVT_lev_disc ST_ON ST_OFF Maintained Released Description Released. 39/39