Home

homeLYnk User Guide - Schneider Electric

Contents

1. those objects visible via BACNet and remote services XML JSON Page 30 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 2 3 Reset clean up Delete selected items from the homeLYnk If you select Objects they will be deleted from the visualization part as well NOTE Backup all important data before proceeding with Reset clean up 3 2 4 Factory reset Delete all configurations and reset to the factory default settings System settings will stay unchanged To perform total factory reset double long press on the RESET button located on the back side of the homeLYnk device 10 seconds press release and press again for 10 seconds IP address after HW factory reset with HW button is always 192 168 0 10 When factory reset is performed by SW button in the Factory reset main menu IP address will stay unchanged and visualization graphic will be kept as well For default IP address with preserved project press HW reset button for 10s NOTE Total reset with hardware button is meant especially for situations where homeLYnk is not accessible due to wrong settings Page 31 AR1740 EdC February 2015 Reset clean up Objects Object logs Include high priority logs Alerts Logs Error logs Script storage Save Cancel Factory reset Warning factory reset wil delete everything make sure you have backed up before doing alt 50 Device will reboo
2. Object visualization parameters i Object Meeting room 0 1 15 Send after each color pick 0 Number of presets to show O Save Cancel e Set RGB color in Configurator Visualization identical to Configurator Objects Set value a ern a Set object value i EN Object name Meeting room RGB Group address 0 1 15 Data type 232 600 RGB color Color Page 153 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 e Set color as a User in PC Tablet Visualization 11 12 2 Script for controlling RGB LED color This script is splitting 1 x 3byte RGB object in to 3 x 1byte value objects Create event based script which will run from the 3 byte RGB object Fill configurable parameters with group addresses or groups names RGB and 1 byte objects must have correct data type redGroup 1 1 5 modify ether group address or name of group greenGroup LED Green Value modify ether group address or name of group blueGroup 1 1 7 modify ether group address or name of group value event getvalue Blue bit band value OxFF Green bit rshift bit band value OxFFOO 8 Red bit rshift bit band value OxFFOOOO 16 grp write redGroup Red dt uint8 grp write greenGroup Green dt uint8 grp write blueGroup Blue dt uint8 This script splits one 3 byte RGB object into three 1 byte value objects what control the single reg green
3. 71112 Light meeting room 01 001 switch Units suffix Match mode Log e All tags Any tag High priority log Apply filter Cancel Export Poll interval seconds Object comments Page 53 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February 2015 3 5 Object Logs Object s historical telegrams are available in Object logs tab After logging is enabled for object all the historical and future data will be logged in homeLYnk Schneider Neighbours Select neighbour Language English Start page Utilities Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Help Object log filter Log time Object address Type Source address Object name Decoded value Data type Object data number catdi 04 02 2015 08 51 16 1 7199 write 15 15 250 OS time 8 51 16 Wednesday 10 3 byte time day 683310 E 04 02 2015 08 51 06 1 7 99 write 15 15 250 OS time 8 51 05 Wednesday 10 3 byte time day 683305 04 02 2015 08 51 01 1 7 99 write 15 15 250 OS time 0 00 00 10 3 byte time day 000000 End date 04 02 2015 08 51 01 1 71100 write 15 15 255 CPU temperature 80 48 C 09 001 Temperature 17DC E ve 04 02 2015 08 50 55 1 7 99 write 15 15 250 OS time 8 50 55 Wednesday 10 3 byte time day 683237 Name or group address 04 02 2015 08 50 55 0 0 2 write 1 1 4 Humidity 20 RH 05 001 scale 33 04 02 2015 08 50 47 0 0 3 write 1 1 4
4. Function invert Write inverted value Comment Set target object value to inverse of source object value Color f90 Input Source object object Target object object function invert a b local value grp getvalue a grp write b not value dt bool end Once block function is added it is available as a block in Block editor in section Custom functions Event Event for 1 1 11 SEN SES Close Objects 7 Write inverted value Storage Source object Script control Edd temp Miscellaneous Logic Loops Math Text Lists Variables Custom functions Page 124 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 9 5 Special Function Blocks There is number of special function blocks which are placed in the Custom functions section These function blocks are very easy to use even without any programming experience More detailed description of function blocks listed below can be found in application note document ANO24_Block functions for spaceLYnk and homeLYnk controller pdf 9 5 1 General e Process kill PID e Scene e Write with delay 9 5 2 Convertors e Date time to string 9 5 3 Logical e AND e OR 9 5 4 Statistical e AVG e MIN e MAX Page 125 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 10 LUA Programming Language LUA is a powerful fast lightwei
5. 27 3 Advanced A 28 3 1 Contisurators Man PEE erae E A 28 3 2 IEE AE E ET 30 3 2 1 ADOC GC E O acota eee ee 30 3 2 2 FTA OC INGUIN S decreta 30 3 2 3 Ree o De ARA cosas cs ce aetna O ane sea aasee sa anmeeieeosneeeoonens 31 3 2 4 FO COPY GOS ada aa 31 3 2 5 Date and UNS E 32 3 2 6 o E 32 Page 3 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 2 7 CIRO ecto eects sees O A 32 3 2 8 RESTO a dais 33 3 2 9 General CONTEO ios 33 AO A e edd Le BEE 34 333 SUSTO andara rc 35 3 3 1 A SEC EE 35 3 3 2 Vem a NEWS So 37 3 3 3 A E OO OE ee ee AE 44 3 3 4 ARE E O A A 45 3 4 o A AP antler uote Lhe 48 3 4 1 Opec prome eebe 49 3 4 2 EVENE de GE 49 3 4 3 Seco eta as 50 3 4 4 Object Visualization E TEE 50 3 4 5 CUSTOM POX GW A WC era a on coreswesaune E a oan 52 3 4 6 OBECECON TOBA sahara E 52 3 4 7 ODIECE due riada 53 3 4 8 Mass AAA a O II A 53 3 5 lee We ober eames caidos 54 3 6 o eebe eege Ee 55 3 6 1 Add NEW SCM SCUIEN EE 55 3 6 2 Seneca ula 56 3 6 3 po 0 la ele AR A E A N AAS 56 3 7 TENA rer 57 3 7 1 Ada New Trend LO aii ica 59 3 8 WIS ge dE EE 60 3 8 1 RS EE 60 3 8 2 SOCOM NCW E 60 3 8 3 Pl E RP Mn RO 61 3 8 4 EA a o A een aa een es es ene 62 3 8 5 WV TOOL EE 63 3 8 6 Visualization Structure Example ssssssesssresesrresssreresrresssreresereessrereserressrereserreserersseerese 64 3 8 7 Pl 64 3 8 8 Vie TEE 65 Page 4 2015 Schneider Electric All rights reserved homeLYnk
6. Current value of object 0 1 1 is read and saved into variable named variable 2 Logical function AND is performed with variables variable 1 and variable 2 The logical result is saved into KNX object 0 1 2 38 variable 1 Mc SORIA OS O 1 0 38 variable 2 INCUCAI al O 1 1 A Set value Ad 0 1 12 hc and gt 9 3 2 IF object value exceed maximum alert is created Current value of object 0 0 2 is read Current value of object 0 0 2 is compared with static value 70 If value of object 0 0 2 is greater than 70 alert message is created Get curtent value of A 0 0 2 Alert text 22 Humidity limit of 7Opercent has been exceeded Page 122 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 9 4 Custom Function Blocks In Scripting menu there is Block functions button Here you can create custom block functions which can be later used as ready block in Block editor Helpers W Ee e Block functions Show code shortcuts aE Conditionals 1 Function Invertor dd 365 Loops and iterators 2 Write inverted value Group addresses hd 3 Comment a EG Math g bjects by S e 4 Set target object value to ge BEE ha 4 E gt Objects KNX bus 5 inverse of source object value Jap 4 gt Storage 6 Color 7998 45 Script control 7 Input P ob Storage k 8 Source object object Jerte d 43 ES Alerts and logs 9 Target object object
7. math asin x Returns the arc sine of x in radians Page 140 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 math atan x Returns the arc tangent of x in radians math atan2 y x Returns the arc tangent of y x in radians but uses the signs of both parameters to find the quadrant of the result It also handles correctly the case of x being zero math ceil x Returns the smallest integer larger than or equal to x math cos x Returns the cosine of x assumed to be in radians math cosh x Returns the hyperbolic cosine of x math deg x Returns the angle x given in radians in degrees math exp x Returns the value e math floor x Returns the largest integer smaller than or equal to x math fmod x y Returns the remainder of the division of x by y that rounds the quotient towards zero math frexp x Returns m and e such that x m2 e is an integer and the absolute value of m is in the range 0 5 1 or zero when x is zero math huge The value HUGE_VAL a value larger than or equal to any other numerical value math Idexp m e Returns m2 e should be an integer math log x Returns the natural logarithm of x math log10 x Returns the base 10 logarithm of x math max x Returns the maximum value among its arguments math min x Returns the minimum value among its arguments math
8. Default value is 1 it allows communication between different sub networks Page 40 2015 Schneider Electric All rights reserved homeLYnk User Guide Maximum telegrams in queue Count of maximum telegrams in the queue NOTE If KNX TP is not connected to the device Routing mode should be used in order to ensure the group addresses are updated correctly Device will reboot after applying the changes Page 41 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk User Guide IP gt TP filter Filter accepts or drops received telegrams from the defined KNX devices physical addresses All outgoing telegrams are not filtered Apply filter to tunneling This filter was created to provide enhanced functionality in comparison to a standard KNX router Defined filter can be applied even to tunneling mode now by default it passes all telegrams This option relates to both directions IP gt TP filter amp TP gt IP filter SRC policy No filter Accept selected individual addresses Drop selected individual addresses Policy to apply to the list of source addresses Ind address list Lists individual or group addresses One address per line Use e g 1 1 or 1 1 to filter all the addresses in the given line DST group policy Destination group filter accepts or drops received telegrams belonging to one group as 1 2 3 or subgroup as 1 2 All outgoing tel
9. User Guide 3 8 9 ele Ea aiii 3 8 10 Visualization Object Order 3 9 VISUALIZATION i 3 9 1 Kg geg Di e 3 9 2 Visualization Map 3 9 3 W Ee e 3 9 4 CCE ti eds 3 9 5 A A 3 9 6 CAMP dui 3 9 7 rad 3 9 8 Tella 3 9 9 Mit cota 39 10 GAME a dad SO O e LO VIS PMI rines 3 11 A A E e ae SPUNE da 3 12 1 Event based ooooocncnncncnccnnnnnnnnnnnnnnss 3122 RESIdEN eene ed 3123 Schedule EE 3 12 4 User lbrartes ie 3 12 5 Common functions ccccoooocccnnnnnn 3 12 6 Start Up Script sormianne nannaa SADT TOOS a tte 3 12 8 General scripting description As E o AA 313 AOS ad SN e Seto TEMO MOG andan SVG WHOM a 4 Modbus RTU and Modbus TC 4 1 Characteristics acsanyacsadecacsdicsevestevesncubedanness 4 3 Modbus Device Profiles 4 3 1 New profile definition Page 5 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 4 WOGDUS RTU INte ICE EEN 97 4 4 1 Characteristics of Modbus RTU Interface 97 4 4 2 RS 485 Bus Topology Characteristics sancs E AE 97 4 4 3 Modbus RTU Configuration Commande 100 4 5 MOdbus te le TEE 103 4 5 1 Characteristics of Modbus TCP Interface ccccccssssseeecccceeeeeesseeccceceesaueeeeeeeeseesaaas 103 4 5 2 Modbus TCP Configuration commande sesssesereressrserereressrrersreressrrersrerossreeesreressreresses 103 4 6 Modbus Function Codes and Cor
10. homeLYnk has been tested at the BACnet Testing Labs BTL and found to comply with all the necessary interoperability requirements More details and results from BTL testing can be found here http www bacnetinternational net catalog index php m 20 amp p 1201 6 5 1 List all BACnet Interoperability Building Blocks BIBBs Supported ReadProperty B DS RP B ReadPropertyMultiple B DS RPM B Data Sharing WriteProperty B DS WP B COV B DS COV B Dynamic Device Binding B DM DDB B Dynamic Object Binding B DM DOB B DeviceCommunicationsControl B DM DCC B Device and Network Management TimeSynchronization B DM TS B UTCTimeSynchronization B DM UTC B ReinitializeDevice B DM RD B 6 5 2 BACnet Object Types Supported e Device e Analog Value e Binary Value 6 5 3 Data Link Layer Options e Media BACnet IP e Option Register as a Foreign Device Page 114 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 6 6 Building Operation Workstation Schneider Electric StruxureWare is a BACnet certified Building Management System Building Operation WorkStation is a software used to configure and commission Enterprise Server and the Automation Server which can retrieve and send data to homeLYnk There is a dedicated document which describes the interoperability between homeLYnk and Building Operation Workstation over BACnet If you look for more details about this topic please refer to appl
11. 1 1 3 true bit to 1 grp write 1 1 4 255 byte to 255 else grp write 1 1 3 false bit to O grp write 1 1 4 0 byte to O end 11 10 Save Scene 1 RGB value value_1 grp getvalue 1 1 1 RED value_2 grp getvalue 1 1 2 GREEN value_3 grp getvalue 1 1 3 BLUE storage set Scene1_Red value_1 storage set Scene1_Green value_ 2 storage set Scene1_ Blue value_3 Page 151 2015 Schneider Electric All rights reserved homeLYnk User Guide 11 11 Call Scene 1 RGB value value_1 storage get Scene1_Red value_2 storage get Scene1_Green value_3 storage get Scene1_Blue if not value_1 then if storage value does not exist do nothing else grp write 1 1 1 value_1 RED end if not value_2 then if storage value does not exist do nothing else grp write 1 1 2 value_2 GREEN end if not value_3 then if storage value does not exist do nothing else grp write 1 1 3 value_3 BLUE end 11 12 RGB object AR1740 EdC February 2015 e Create object and define Object parameters in Configurator Objects double click on the 11 12 1 How to operate the RGB object object Edit object Object name Meeting room RGB Group address Data type 232 600 RGB color 7 Current value 16765337 Tags Units suffix Log High priority log Export Poll interval seconds lt gt Object comments Save Cancel Page 152 2015 Schneider Electric
12. Choose File No file chosen Import ESF file to Bn fi It will be necessary to set correct data type for some imported objects Configurator gt Utilities gt Import ESF file Existing objects will not be overwritten Objects with the same name are considered duplicates and might not get imported Cancel In order to complete ETS4 or ETSS project generate ESF file from ETS project through Extras DExport OPC Import ESF file to Configurator gt Utilities gt Import ESF file General configuration Or connect homeLYnk to the KNX bus and it will SA Seen detect objects automatically in the Objects tab once RA Sp they are activated KNX telegram is sent Automatic address range start 1 1 1 This option can be Enabled Disabled in Discover new objects Yes bus sniffer enabled lt Configurator gt Utilities gt General Configuration gt Object log size 1000 Discover new objects Default log policy Log only selected objects Alert log size 5000 lt gt lt Log size 5000 lt gt lt gt lt gt Error log size 5000 Enable Block editor Code editor tab size 4 A Ww NOTE Obj ects can be added manually as well e If log size is changed to a smaller value excess logs will be deleted on next auto clean up every 10 minutes e Log policy only affects new objects current per object log settings are kept unchanged Warning excessive object logging degrades performance Cancel Page 23 2015 Schne
13. Control type Types of the visual elements Direct Slider Circular slider Custom value select Minimum value Define minimum value for visualization only Maximum value Define maximum value for visualization only Step If defined value changes depending on the defined step Page 50 Set object value x Set object value Object name Switch Bedroom 1 bed Object name Group address 1 0 0 Group address Data type 01 001 switch Data type New value New value 45 false false true Object visualization parameters Object Contral type Middle 1 0 1 3 Toggle E e Middle 4 Lei micare 1 Visualization parameters Object Dimming Leaving room 1 0 18 Step size 25 K Object visualization parameters Object co2 0 0 1 Pe Decimal places 2 Control type Slider Minimum value 300 Maximum value Step Vertical slider Visible only PC Tablet Invert vertical slider AR1740 EdC February 2015 Value Leaving room 1 0 19 05 001 scale 2015 Schneider Electric All rights reserved homeLYnk User Guide Vertical slider Vertical position of slider e g for Blinds control Invert vertical slider Inverts direction of vertical slider Slider color Defines slider filling color Background color Defines background of circular slider Round line cap Rounding edges of circular slider Hide title Hide Object cu
14. Custom name Custom name for the object Read only Make the gauge read only Additional classes Create additional class which can be used in custom CSS file in order to modify particular group of graphical objects After defining the gauge parameters press Add to plan button and newly created object will appear on the map The object can be moved to the desired location Press Save and reload plan button so that the gauge starts functioning Page 77 AR1740 EdC February 2015 Plan editor abel Image Frame Camera Graph Data object 0 0 3 Temperature Y SS An NW Gauge size 150 Custom name Temperature Read only R Additional classes Element position Elament size 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 11 Frame Frame allows displaying internal or external webpage in visualization Schedulers and Trends can be integrated into the frame Source Select Scheduler Trend log or external URL Url Source URL of external webpage Frame Size Width Height of the frame Custom name Specify the title of the frame Hide in Smartphone When ticked not available in the Smartphone visualization After defining the frame parameters press Add to plan button and newly created object will appear on the map The frame can be moved to the desired location Frame can be freely resized via holding the edge of the Frame and move Press Save and reload plan butto
15. Device ID Password Server enabled Enable Disable BACnet server l ah Object priority Device ID BACnet device ID which must be unique Bort on BACnet network BBMD IP Password BACnet password BBMD port Objects priority Define to which priority array BBMD lease time seconds homeLYnk will write to By default homeLYnk does not write to priority array only to Relinquish Default Property Port BACnet port default 47808 BBMD IP BACnet router IP BBMD port BACnet router port BBMD lease time seconds registration resend interval 6 4 2 BACnet objects List of BACnet objects with its parameters is available oe Device name spaceLYnk_158 Download CSV Device ID 158 Object priority 16 Configurator gt Utilities gt System gt Network gt ida BACnet objects Type Instance Device name Current value under 2 AV CO2 0 0 1 409 92 Device name is combined from Hostname and Device 2 AV Temperature 0 0 3 23 34 ID 2 AV Maximal CO2 0 0 5 0 2 AV Maximal humidity 0 0 7 0 BACnet objects can be downloaded to CSV file via 5 BV Window 1 0 1 0 Download CSV button a A 5 BV Window 3 0 1 2 NOTE Download CSV button is hidden if browser 2 AV A does not support this feature NOTE Maximum number of BACnet objects is 150 Page 113 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 6 5 BACnet Standardized Device Profile
16. 53 gt Heating 2 ON OFF 0 3 Click on the Smartphone visualization icon Di PATA mn Application s link can be saved Provide a shortcut in the iPod for BEE ae easy access e bz window 1 x 9 window 2 x m 2 9 5 Launching vis on PC Tablet or Any Other Touch Device with Large Screen In order to do so please follow the next steps 1 Ensure the PC Tablet device is able to access homeLYnk and enter the IP in the browser default 192 168 0 10 2 Click on PC Tablet visualization 3 Select the desired Plan 4 4 Sidebar can be minimized by pressing on icon to make the map more visible SE spaceLYnk office O M a n Offi ce 03 02 2015 14 34 19 Tuesday Overview Meeting Room Facility Management Garage Trend Graphs Schedulers Help Office energy efficiency Lucia Page 27 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 Advanced Guide 3 1 Configurator s Main Page Configurator s main page top bar homeLYnk Schneider Neighbours Select neighbour Y Language English Start page Neighbours Switch to next homeLYnk in the same network This selection appears only if any other homeLYnks or homeLYnks are discovered Language Switch language of the operational interface to English Czech Danish Dutch French German Italian Portuguese Russian Spanish or Turkish Start page Link to the main visualization page Confi
17. 7 o hour number 0 23 o minute number 0 59 o second number 0 59 e 3 byte date dt date table with the following items o day number 1 31 o month number 1 12 o year number 1990 2089 e 4 byte unsigned integer dt uint32 number e 4 byte signed integer dt int32 number e 4 byte floating point dt float32 number e 4 byte access control dt access number currently not fully supported Page 128 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 e 14 byte ASCII string dt string string null characters O are discarded during decoding 10 6 Data Storage Functions storage object provides persistent key value data storage for user scripts Only the following LUA data types are supported e boolean e number e string e table storage set key value Sets new value for the given key Old value is overwritten Returns Boolean as the result and an optional error string storage get key default Gets value for the given key or returns default value ni if not specified if key is not found in the data storage NOTE All user scripts share the same data storage Make sure that the same keys are not used to store different types of data Example e The following examples show the basic syntax of storage set Result will return boolean true since the passed parameters are correct result storage set my_stored_value_1 1
18. AR1740 EdC February 2015 Layout Parent Layouts Name Overview layout Plan size 1024 768 5 Primary background image Secondary background image Background color FFFFFF X iv Smartphone background color Xiv Repeat background image Fixed primary background Cancel 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 8 5 Widget Widget is a small web page which can be attached to a button and pop up when activated To add the widgets press button next to the D Add new widget widgets folder or button Each widget can be duplicated together with all the components by pressing the duplicate icon next to the widget GI NOTE Content of this widget should be defined under the Visualization tab Widget size always has to be smaller than the plan on which it is placed on Empty widget no objects will be not visible in visualization Page 63 AR1740 EdC February 2015 GAS heating Widget A Parent Widgets Name Office 1 Plan size 360 5 140 V LE gt Widget position Primary background image x ow Background color Xx vr Smartphone background color X Repeat background image rj Fixed primary background E Save Cancel 2015 Schneider Electric All rights reserved AR1740 EdC February 2015 homeLYnk User Guide 3 8 6 Visualization Structure Example 3 8 7 Plan L homeLYnk Google Chrome LO ja 10 154 20 25 cgi bin scada vis inde
19. AR9485 802 11b g n WiFi Adapter 224 0 23 12 224 0 23 12 Catalogs Settings Current Interface lt no interface selected gt Configured Interfaces A 4 Discovered Interfaces dh 15 15 255 homeLYnk 10 154 20 26 3671 10 154 20 26 3671 00 1B C5 00 1E 6E EY Intel R 82579V Gigabit Network Connection 224 0 23 12 224 0 23 12 A0 D3 C1 9C 2B 3B EY Qualcomm Atheros AR9485 802 11b g n WiFi Adapter 224 0 23 1 224 0 23 12 A4 DB 30 53 39 DF IP Tunneling Name homeLYnk_manual 1 Server 19 168 0 10 10 154 20 26 3671 00 1B C5 00 1E 6E Port 224 0 23 12 A0 D3 C1 9C 2B 3B 3671 A4 DB 30 53 39 DF Network Address Translation Connect using NAT mode Be careful if using NAT mode A to connect to unsecured interfaces over the internet It s safer to establish a VPN connection and use local IP addresses instead 2015 Schneider Electric All rights reserved homeLYnk User Guide 2 8 KNX and IP Router Settings KNX specific configuration is located in Configurator gt Utilities gt System gt Network gt KNX connection General Tab Mode KNX connection mode TP UART built in by default Physical connection via twisted pair El Bnet TP Tunneling Point to point connection over a communication channel is established between the ElBnet IP server and client El Bnet IP Tunneling NAT mode Tunnelling mode with Network address translation El Bnet IP Routing Exchange of KNX
20. AutoScale follow A PAI UI A WU WAY PUN All V NM d IN ON 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Network utilities Network utilities Ping Traceroute Ping IP Hostname The Computer network tool id used to test whether a particular host is reachable across an IP network Trace route The computer network diagnostic tool is used for displaying the route path and measuring transit delays of packets across an Internet Protocol IP network System log System log Log entries May 29 13 02 48 spaceLYnk daemon info avahi daemon 8 18 Service Web Server on spaceLYnk etc avahi services http service May 29 13 02 47 spaceLYnk daemon info avahi daemon 8 18 Server startup complete Host name is spaceLYnk local Local service Lo g e n trie AY May 29 13 02 46 spaceLYnk daemon info avahi daemon 8 18 Registering HINFO record with values ARMV5TEJL LINUX May 29 13 02 46 spaceLYnk daemon info avahi daemon 8 18 Registering new address record for 192 168 0 10 on eth0 IPv4 May 29 13 02 46 spaceLYnk daemon info avahi daemon 8 18 Network interface enumeration completed Log files are automatically CT eated and May 29 13 02 46 spaceLYnk daemon info avahi daemon 8 18 New relevant interface eth0 IPv4 for mDNS maintained by homeLYnk of all the activities May 29 13 02 46 spaceLYnk daemon info avahi daemon 818 Joining mDNS multica
21. EIB telegrams between different EIBnet IP servers An ElBnetIP server forwards only those telegrams that correspond to the filter criteria Routing uses multicast telegrams ACK all group telegrams If selected then homeLYnk acknowledges every group telegram KNX address KNX physical address of the device KNX IP features Use this device with KNX IP features For example KN Xnet IP network configuration Multicast IP Multicast IP address Multicast TTL Multicast TTL Time To Live Maximum telegrams in queue Count of maximum telegrams in the queue NOTE If KNX TP is not connected to the device Routing mode should be used to update the group addresses correctly Apply changes When changes are done the icon appears in the top right corner This should be applied for changes to take effect homeLYnk will automatically reboot after these changes are applied Page 22 KNX connection General IP TP filter TP IP filter Mode TP UART ACK all group telegrams KNX address 1 1 0 KNX IP features i Multicast IP 224 025 12 Multicast TTL 1 Maximum telegrams in queue 2015 Schneider Electric AR1740 EdC February 2015 All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 9 Create Visualization for iPad PC 2 9 1 Import Objects In order to complete ETS3 project generate ESF file from ETS through Import ESF file File gt Extract data DExport to OPC server ESF file
22. Hourly data Daily data Log size Created Brightness office 1 0 5 0 Brightness 1 Absolute value 0 1 hour 5 years 30 days 344 KB 2014 02 06 14 48 e Brightness office 2 0 5 1 Brightness 2 Absolute value 0 1 hour 30 days 30 days 7 KB 2014 02 06 14 48 e Temperature 0 0 3 Temperature Absolute value 2 1 hour 1 year 5 years 84 KB 2014 02 07 10 52 e Humidity 0 0 2 Humidity Absolute value 0 1 hour 30 days 30 days 7 KB 2014 02 07 10 53 e CO2 level 0 0 1 CO2 Absolute value 0 1 hour 30 days 30 days 7 KB 2014 02 07 10 53 e Add new trend kal Month Year Selecting period of trend s Show Show previous enable disable function of previous values for selected time period Day Month Year for data comparation Current for selection of current date Previous for selection of previous date Brightness office 2 21 Jan 2015 29 Jan 2015 Brightness office 1 em lt January 2015 gt DW 21 Jan 2015 EM 29 Jan 2015 Mo Tu We Th Fr Sa Su 29 30 31 1 2 3 4 A Ee EN SE 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 PER 30 31 1 Temperature Humidity CO2 level 2 3 4 3 6 T 8 408 Day Month Year Show Single trend Multiple trends 01 00 03 00 19 00 21 00 23 00 Page 57 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Multiple trends Selection between displaying single and multiple trends in dark theme Wall socket switching Brightess level We
23. Image source Local Remote Select image source Select image Select image previously added to Vis graphics gt Images Backgrounds Image url Source URL of the image Width Width of the image Height Height of the image External link External link URL when pressing the image example http www schneider electric com Additional classes For custom CSS styles Once the image parameters are defined press Add to plan button and newly created object will appear on the map The object can be moved to the desired location Image can be freely resized via holding the edge of the image and move Press Save and reload plan to apply changes Page 76 AR1740 EdC February 2015 Plan editor Text label Image Frame Gauge Text Main Office Font size Text styles Custom font Font color Additional classes Cancel Element position Element size 310 save and reload plan Plan editor Text label Frame Gauge Camera Image source Local Select image SElogonew png Image size 150 50 External link http fwww schneider electr Additional classes Element position Element size save and reload plan Schneider 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 10 Gauge Gauge allows dynamic way of visualization and changing the object value in the gauge Data object KNX group address Gauge size Size of the gauge
24. TCP 4 1 Characteristics The Modbus open standard allows you to receive a more in depth analysis of consumption in all areas of your building You can connect up to 31 Modbus slave devices of the following types of meters based on Modbus remote terminal unit RTU within one Modbus line e Schneider Electric energy meters e Schneider Electric power meters e Schneider Electric Smart Interface Modules SIM10M module e Schneider Electric Smartlink e Non Schneider Electric Modbus TCP RTU devices offering you greater flexibility With the information which the homeLYnk provides you can visualize energy or media consumption This can also be used to reduce consumption through the use of control strategies within the KNX IP network Modbus RTU is supported over RS485 interface Modbus TCP is supported over Ethernet port Modbus communication settings is done using Modbus table in homeLYnk Configurator Modbus registers can be easily mapped using predefined Modbus profiles Modbus Master can be controlled directly from scripts usually resident script is used to read Modbus values after some specific time interval and write them into KNX object or visualization Once script is added you can add the code in the Script Editor There are lots of predefined code blocks in the Helpers NOTE Do not use Modbus settings using profiles together with Modbus controlled from scripts Interference of those two settings can cause communication errors
25. Temperature 22 8 C 09 001 Temperature oc74 Tags 04 02 2015 08 50 45 1 7 99 write 15 15 250 OS time 8 50 45 Wednesday 10 3 byte time day 68322D 04 02 2015 08 50 35 1 7 99 write 15 15 250 OS time 8 50 35 Wednesday 10 3 byte time day 683223 04 02 2015 08 50 31 0 0 1 write 1 1 4 co2 440 ppm 09 2 byte floating point 2D5F 04 02 2015 08 50 25 1 7 99 write 15 15 250 OS time 8 50 25 Wednesday 10 3 byte time day 683219 04 02 2015 08 50 15 1 7 99 write 15 15 250 OS time 8 50 15 Wednesday 10 3 byte time day 68320F Source address 04 02 2015 08 50 05 1 7 99 write 15 15 250 OS time 8 50 05 Wednesday 10 3 byte time day 683205 04 02 2015 08 50 01 1 7 99 write 15 15 250 OS time 0 00 00 10 3 byte time day 000000 04 02 2015 08 50 01 1 7 1100 write 15 15 255 CPU temperature 80 2 C 09 001 Temperature 17D5 by Apply filter Cancel D Clear lt gt Export all logs Page 1 of 21 Py Displaying logs 1 50 of 1014 Filtering is available when there is a need to find specific period information e Start date Start date and time for log filtering e End date Start date and time for log filtering e Name or group address Specific name or group address of the object e Tags Group objects with the same tags filtered e Value Specific object value e Source address Specific source address All logs can be cleared by pressing the Clear button For important objects activate the parameter High Priority log together with Log par
26. User Guide February 2015 2 1 Start Page Start page is providing a dashboard like view pointing to the key areas of homeLYnk The following options are located on the start page TT PC Tablet Visualization This icon navigates to the rich visualization with maps containing individual objects It is ideal for PCs iPads and Android tablets preferably 10 or bigger display size e Smartphone Visualization This icon navigates to the simple list visualization designed for iPhone iPod iPad Android smart phones Android tablets 7 or smaller display size All objects which are added in homeLYnk Configurator by default are visible in this Smartphone visualization if there is no Hide in Smartphone option enabled CE to manage scheduler tasks for example to specify thermostat values depending on the day Scheduler This icon navigates to a user friendly interface for the end user of the week time and holidays Trends This icon navigates to a user friendly display of Trend logs with the ability to compare data between two different dates It can display trends for up to 10 years Configurator This icon navigates to programming settings and configuration interface Access is restricted to administrators NOTE Configurator is not supported in mobile devices it can be used only in desktop browsers Page 13 2015 Schneider Electric All rights reserved AR1740 EdC homeLYnk February 2015 User G
27. Using Common Functions Add following code to common functions Rounds a number to the given number of decimal places function round num idp local mult 10 idp or 0 return math floor num mult 0 5 mult end Create script in script editor Round function with global function value_1 grp getvalue 1 1 1 round value_1 2 using function round from common functions grp write 1 1 1 Value_2 AR1740 EdC February 2015 Page 158 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 27 Write Data and Time to KNX Group Addresses get current data as table now os date t system week day starts from sunday convert it to knx format wday now wday 1 and 7 or now wday 1 time table time day wday hour now hour minute now min second now sec date table date day now day month now month year now year write to bus grp write 1 1 2 time dt time grp write 1 1 1 date dt date 11 28 Write Data to Groups with Tags Create few 1 bit group addresses and add tag Light to them Create one more group different one from the others to trigger script 1 1 1 Lihgt1 Tag Light 1 1 2 Lihgt2 Tag Light 1 1 3 Lihgt3 Tag Light 1 1 4 Lihgt4 Tag Light 1 1 5 Lihgt5 Tag Light 1 1 6 Lihgt6 Tag Light 1 1 10 Scen
28. We strongly recommend you to use rather Modbus device profiles than configuration by scripting Application Example Requirements e Measure and visualize how much energy is used for lighting an office building e Measure the gas and water consumption of the building e Monitor the quality of the network to ensure the operational safety of the IT equipment Solution e Install an iEM3150 meter to measure the energy consumed by the lights e Install an iEM3255 meter to determine the power mains quality e Install a SIM10M module to measure gas and water consumption using pulse meters e Connect the devices to each other via Modbus Page 93 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 3 Modbus Device Profiles There are plenty of ready to use device profiles which are used for mapping the Modbus addresses registers to KNX group objects in homeLYnk If there is a need to read write some Modbus register you only set the mapping rules which allows you to access Modbus register by read write of KNX group objects List of ready to use Modbus profiles in homeLYnk Compact_NSX See no Lee es o Masterpact_ VI NW Gi Ir ene a Masterpact_ NT_NW ener In reas es oo Masterpact_NT_NW PM PM1200 no pmpmi7a0 men ue Lmms e maen Lu pmemsio Jm mme Lu Lnmmen fno mae Lu Las mo mae Lu Lnmmen Jm mme Ju proc Jm men no Jam Jm mme Lu Lossen JL ouer ves smamimerce mo jiemewaiss e
29. actually discovered by a bus sniffer 111111 14 4 byte floating point 0 E T 03 02 2015 14 57 10 fe ES th 3 Page 48 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 4 1 Object parameters Object name Name for the object To change the settings for existing or new objects click on the specific list entry address or name Group address Group address of this object DDS Temperature Data type KNX data type for the object This has to be set once the homeLYnk sniffs the new object for actual work Edit object Object name Temperature Current value Actual value of the object Group address Tags Assigns this object to some tag which can ae EE be later used in the writing scripts for example Current value 22 08 C All_lights_first_floor Please refer to the Script Tags Temp library for use cases Units suffix E Log r Unit suffix Add unit suffix to value of object Soh picky loa Units which cannot be created from keyboard can Ea h Wr be created in external editor and pasted into the Poll interval seconds browser Object comments ETS import Log Enable logging for this object Logs appear in the Object logs tab High priority log This option shifts high priority logs up on the screen listing tab Logs If defined limit of logs is exceeded low priority logs at the end of listing are deleted first This function secures
30. duplicates and might not be imported List fi It will be necessary to set correct data type for some imported objects of imported and discarded object is displayed after Existing objects will not be overwritten Objects with the same name are each import considered duplicates and might not get imported Cancel See chapter 1 8 1 for ETS3 ETS4 and ETS3 import details Import result Imported 0 2 2 0 2 3 0 2 5 0 2 6 0 2 7 0 2 8 0 2 4 Discarded 0 0 1 0 0 2 0 0 3 0 2 0 0 2 1 O 1 0 0 1 1 0 1 2 0 1 3 0 1 4 0 1 5 0 1 7 0 1 8 0 1 9 0 1 10 0 1 12 0 1 13 0 1 11 0 1 14 0 1 6 0 3 0 0 3 1 0 3 2 0 3 3 0 3 4 0 3 5 0 3 7 0 3 8 0 3 9 0 3 10 0 3 11 0 3 6 0 5 0 0 5 1 0 5 2 0 5 5 0 5 3 0 5 6 O 5 7 0 5 8 0 5 4 0 4 0 0 4 1 0 4 2 0 4 3 0 4 4 0 4 5 0 4 6 0 6 0 0 6 1 0 6 2 0 6 3 0 6 4 0 6 5 0 6 6 0 6 7 0 6 8 0 6 9 0 6 10 0 6 11 0 7 0 0 7 1 0 7 2 0 7 3 0 7 4 0 7 75 0 7 6 0 7 77 0 7 8 0 7 9 0 7 10 0 7 11 3 2 2 Import Neighbours If there is more than one homeLYnk on the same IP Import neighbours network Import neighbours button will appear under o Utilities It allows importing the exported objects from Penner ete delete en another homeLYnk System will ask for Remote Remote password password of the second device from which data will be exported Export option must be activated for Objects to be Cancel shared between the homeLYnks Enabling will make
31. ee me IS Primary background image Select the background Smartphone background color LP previously added to Vis Graphics gt Repeat background image Images Backgrounds Fixed primary background Secondary background image Select the secondary Save Cancel background previously added to Vis Graphics gt Images Backgrounds for parallax projection Background color Choose the background color of the plan for PC Tablet Visualization Smartphone background color Choose the background color of the plan for Smartphone Visualization Repeat background image To show the image once or repeat it and fill the whole plan Fixed primary background Primary plan is static in parallax projection NOTE Each plan can be duplicated together with all components on a plan by pressing duplicate icon next to the plan td Page 25 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 9 3 Add Objects to Newly Created Visualization Map Go to Configurator gt Visualization Once the Level and plans structure are defined in Vis structure tab it can be visualized in the Visualization tab Controlled and monitored objects can be added and managed in this section Both sidebars can be minimized by pressing the left or the right arrow icon which will make the map appear more visible especially on smaller displays homeLYnk Schneider Neighbours Select neighbour v Language English
32. entered Tags are listed in the drop down Group address Allows to enter only digits from 0 9 and as a separator When icon appears on the right side of the text box wrong address form is used Correct form of the group address is for example 1 1 1 Tag Script can run on tags If group addresses have tag attached to and script is using tag then any telegram which is sent to the group with this tag will execute the script Active Specifies whether the script is active green circle or disabled red circle Execute on group read Specifies whether the script is executed on KNX group read telegram Category A new or existing name of the category the script will be included This will not affect on script action helps only by grouping the scripts and watching by categories in Tools Print script listings page Description Description of the script Page 83 AR1740 EdC February 2015 homeLYnk Schneider Neighbours Select neighbour Utilities Objects Objectlogs Schedulers Script name o CO2 min max Climate values reset Scenes control Humidity min max Temperature min max Help object for resident script SONOS volume adddagaas ww ww wi ww SAA ZLRIEBIIESR Temperature alert Add new script Event based script Script name Climate values reset Group address tag 0 0 10 Active i Execute on group read Category Description Cancel NOTE If the script is run
33. homeLYnk KNX individual address and mask can be set by pressing Local settings ETS Apes Merten GmbH amp Co KG Labels vn homeLYnk 10 154 20 26 D e e e f Individual address 15 15 255 Select Use project connection if available Onine Catalog IP address 10 154 20 26 MAC address 00 18 C5 00 1E 6E check box to make it a default project n ee ee Shortcuts Configured connections connection Discovered connections E Intel R 82579V Gigabit Network Connection 2 224 0 23 12 Select U se direct K NX IT P con nectio n if E9 Qualcomm Atheros AR9485 802 11b g n WiFi Adapter 2 224 0 23 12 S oh spacelYnk 10 154 20 42 MAC 00 00 54 FF 8C 8A available option for direct communication in IP network New Delete Edit Press New to add homeLYnk manually Enter any Name for the device E New connection Set IP address Port and NAT mode if Properties needed Name homeL nk Type KNXnet IP Press OK to save changes Communication parameters To test the communication with ETS press IP address 192 168 0 10 Test Port 3671 NAT mode Press Apply changes for changes to take effect Page 20 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February 2015 2 7 homeLYnk for KNX EIB Network Configuration Management with ETS In order to use homeLYnk with KNXnet IP functionality and to program with the other KNX bus devices the device
34. indication from master slave mode only mb getreceivetimeout mb setreceivetimeout timeout Page 102 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 5 Modbus TCP Interface 4 5 1 Characteristics of Modbus TCP Interface e Supported over Ethernet interface 10Mb 100Mb e Can act as Modbus TCP IP Client or Modbus TCP IP Server e DHCP support e Max opened TCP connections 100 e Supported Function Codes 01 02 03 04 05 06 07 0F 10 Grounding Isolation e Metal cover of the RJ45 socket is connected to device ground 4 5 2 Modbus TCP configuration commands Create Modbus TCP object require luamodbus mb luamodbus tcp Open Modbus TCP connection IP 192 168 1 2 port 1234 mb open 192 168 1 2 1234 mb connect All the rest of commands needed to configure the Modbus TCP connection are the same as for Modbus RTU Page 103 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February 2015 4 6 Modbus Function Codes and Corresponding Master Functions All the possible Modbus function codes which can be used in homeLYnk are listed below There is a Lua function in homeLYnk for each function code All the functions described bellow can be used both for Modbus TCP and Modbus RTU FCHO1 Read Coils Name Command Arguments Returned values Exception codes Name Command Arguments Returned values Exception
35. landscape fullscreen XGA 1024 x 743 iPad landscape browser XGA 1024 x 672 iPad portrait fullacreen XGA 768 x 1004 iPad portrait browser XGA TOG x 928 Tablet landscape WSVGA 1024 x 600 Tablet portrait WSVGA 600 x 1024 Laptop Tablet landscape WXGA 1280 600 Laptop Tablet portrait WXGA 300 x 1280 Laptop Tablet landscape HD 1360 x 768 Laptop Tablet portrait HD 768 x 1350 Big screen Full HD 1920 x 1080 To order the object in the Smartphone visualization press al Reorder Smartphone objects button Next to the icon Reorder Smartphone objects there are two H for a quick e Preview in PC Tablet e Preview in Smartphone icons Page 68 Change Smartphone object order drag to change x Object 66 6 SONOS control Object 66 4 SONOS track Object 66 4 SONOS track Object 66 6 SONOS control Object 66 6 SONOS control Object 66 6 SONOS control Object 1 1 0 Main ON OFF Object 2 0 10 Height manual mode 3 Object 0 1 15 Meeting room RGB Object 0 1 15 Meeting room RGB S Save Cancel 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 9 2 Visualization Map Each newly added object will be placed on the top left corner of the plan with vertical and horizontal spacing predefined in object menu ME Delete 10 10 Duplicate Selected object can be resized by pulling strip on the bottom or right side deleted o
36. modf x Returns two numbers the integral part of x and the fractional part of x Page 141 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 math pi The value of pi math pow x y Returns x You can also use the expression x y to compute this value math rad x Returns the angle x given in degrees in radians math random m n This function is an interface to the simple pseudo random generator function rand provided by ANSI C No guarantees can be given for its statistical properties When called without arguments returns a uniform pseudo random real number in the range 0 1 When called with an integer number m math random returns a uniform pseudo random integer in the range 1 m When called with two integer numbers m and n math random returns a uniform pseudo random integer in the range m n math randomseed x Sets x as the seed for the pseudo random generator equal seeds produce equal sequences of numbers math sin x Returns the sine of x assumed to be in radians math sinh x Returns the hyperbolic sine of x math sqrt x Returns the square root of x You can also use the expression x40 5 to compute this value math tan x Returns the tangent of x assumed to be in radians math tanh x Returns the hyperbolic tangent of x 10 17 Table manipulation This library provides generic functions for table manipulatio
37. of SE office Shopping kiosk Available only for SE authorized persons Schneider recommends saving your project to an external drive after each project modification Upgrade firmware Complete System Upgrade Configurator gt Utilities gt System gt System gt EE e en Upgrade firmware _ Choos chose T It will take about 5 minutes for upgrade to complete All config files will be kept unchanged Do not unplug your device while updgrade is in progress 5 Canal Page 18 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 5 homeLYnk for KNX EIB Network Configuration Management with ETS3 In order to use homeLYnk with KNXnet IP functionality and to program with the other KNX bus devices the device should be added into the ETS Connection Manager Extras gt Options gt Communication gt Configure interfaces ETS Connection Manager Configured Connections Properties Enter any Name for the connection Name rel nk Serial PENE COM1 Serial PEIG COMA VE Choose Type and select KNXnet IP from USB TT KNenet IP the drop down C Standard connection Communication parameters KNXnet IP device PY indicates programming mode active spaceLYink 192 168 0 5 Ww Press OK MAC addr 00 00 54 FF 88 15 Mame apacel Ymk Press Rescan and then select homeLYnk from the drop down IP address 192 168 0 5 Port 3671 In the Options gt Communi
38. only on read request use the following script example if event type groupread then script here end 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 12 2 Resident Script name The name of the script Sleep interval seconds Interval after which the script will be executed Active Specifies whether the script is active green circle or disabled red circle Category A new or existing name of the category the script will be included This will not affect on script action helps only by grouping the scripts and watching by categories in Tools O Print script listings page Description Description of the script 3 12 3 Scheduled Script name The name of the script Minute Minute Hour Hour Day of the month Day of the month Month of the year Month of the year Day of the week Day of the week Active Specifies whether the script is active green circle or disabled red circle Category A new or existing name of the category the script will be included This will not affect on script action helps only by grouping the scripts and watching by categories in Tools Print script listings page Description Description of the script Page 84 Resident script Script name Sleep interval seconds Active Category Description Scheduled script Script name Minute Hour Day of the month Month of the year
39. s Receives a string and returns its length The empty string has length O Embedded zeros are counted so al000bc1000 has length 5 string lower s Receives a string and returns a copy of this string with all uppercase letters changed to lowercase All other characters are left unchanged The definition of what an uppercase letter depends on the current locale string match s pattern init Looks for the first match of pattern in the string s If it finds one then the match returns the captures from the pattern otherwise it returns nil If the pattern specifies no captures then the whole match is returned A third optional numerical argument init specifies where to start the search its default value is 1 and can be negative string rep s n Returns a string that is the concatenation of n copies of the string s string reverse s Returns a string that is the string s reversed string sub s i jl Returns the substring of s that starts at i and continues until j i and j can be negative If j is absent then it is assumed to be equal to 1 which is the same as the string length In particular the call string sub s 1 j returns a prefix of s with length j and string sub s i returns a suffix of s with length i Page 134 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 string upper s Receives a string and returns a copy of this string with all lo
40. should be added into the ETS Connection Manager ETS programming through homeLYnk is available only when KNX IP features are enabled Function Bus monitor is not included in homeLynk Bus gt Connections gt Interfaces If your homeL Y nk is in the same network with computer running ETSS it is possible to discover the homeLYnk interface automatically If your homeLYnk is discovered choose the interface by double click on item in Discovered Interfaces list If your interface is not discovered follow steps below 1 Click green icon next to the Configured Interfaces Select IP Tunneling Click New Connection 0 0 0 0 3671 which is created in Configured Interfaces In the setting tab on right hand side set Name of your connection Server IP address of homeLYnk and Port Select the interface which you have configured in previous step To test the communication with ETS press Test in lower right corner If test is OK select the interface as active by double click on item in list of Configured Interfaces Current Interface is set Page 21 V e Overview Connections Interfaces Options Monitor Group Monitor Bus Monitor Diagnostics Unload Device Device Info Current Interface lt no interface selected gt Configured Interfaces 4 Discovered Interfaces el 15 15 255 homeLYnk 10 154 20 26 3671 EY Intel R 82579V Gigabit Network Connection 224 0 23 12 E Qualcomm Atheros
41. that high importance logs stay visible for a longer period of time Export Makes object visible by remote XML requests Poll interval seconds Performs automatic object read after the selected time interval Object comments Object s further description Can be also used for filtering 3 4 2 Event Script By pressing button in the Object list the Script editor will open and the event based script can be created Script will run each time the telegram is sent to the selected group If the script is attached to a group icon changes to green Y Page 49 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 4 3 Set object value In the object list by pressing on the E button the state of the object can be changed The appearance of the New value window depends on what the visualization parameters are set for specific objects 3 4 4 Object Visualization Parameters o By pressing on the button the corresponding object specific visualization parameters for this type can be set 1 bit Control Type Types of the visual control element e Toggle e Checkbox 4 bit 3 bit controlled Step size Step size example for blinds control 2 bit 1 bit controlled 1 byte unsigned integer scale 1 byte signed integer 2 byte unsigned integer 2 byte signed integer 2 byte floating point temperature 4 byte unsigned integer 4 byte signed integer 4 byte floating point
42. the custom cascade style sheets spaceLYnk Schneider Neighbours Select neighbour v Language English v Start page Utilities Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphics Saripting User access Modbus Alerts Logs Error log Help KEE Icons Images Backgrounds Fonts Edit custom CSS B u blinds_20_1 svg blinds_20_2 svg blinds_20_3 svg blinds_20_4 svg blinds_3 svg blinds_30_1 svg blinds_30_2 svg blinds_30_3 svg blinds _ 30_4 svg blinds 40_1 svg blinds_40_2 svg blinds_4 blinds_40_3 svg blinds_40_4 swg blinds_50_1 swg blinds_50_2 svg blinds_50_3 swg blinds_50_4 svg blinds_60_4 svg blinds_70_1 swg blinds_70_2 svg E 2 Ie 4 blinds _70_3 svg blinds_ 704 Su blinds_80_1 sug blinds_80_2 sug blinds_80_3 svg blinds_80_4 5ug blinds_90_1 sug blinds_90_2 sug blinds_90_3 svg blinds_90_4 svg blinds_down_ blinds_down_ E B E E BB B B B RE blinds_down_ blinds_down_ blinds_pause_ blinds_pause_ blinds_pause_ blinds_pause_ blinds_positio blinds_positio blinds_positio blinds_positio blinds_up_1 svg blinds_up_2 svg ye it P ala gt 5 5 Y Y bl inds u 3 svg bl inds_up_4 svg bri ghtness_se l bri ghtness_se A bri ghtness_se bri ghtness_se a bul b ia bul b_100_1 swg bul b_100 2 svg bulb_ 100 3 sv
43. ut 7 Kbps AutoScale follow AR1740 EdC February 2015 RX Bytes Errors 69 MB ojo ik 2015 Schneider Electric All rights reserved homeLYnk User Guide Routes Routing table is a data table that lists the routes to a particular network destination It contains information about the topology immediately around it System routing table is located in Network gt Routes divided in two parts Dynamic and Static menu The window is routes e Dynamic List of self learned network destinations and automatic selection of the best route Interface Interface name indicates the locally available interface that is responsible for reaching the gateway Destination Destination subnet IP address describes together with Network mask the Network ID Gateway Gateway IP address points to the gateway through which the network can be reached Network mask Network mask Flags Helps in troubleshooting your network problem see the attached coding table e Static Manual entering of routes into the homeLYnk routing table they do not change automatically Interface Interface name Destination Destination IP address Gateway Gateway IP address Network mask Network mask Flags Helps in troubleshooting your network problem see the attached coding table Page 38 Routes Interface etho etho etho Destination default 10 154 20 0 22 4 0 0 0 Flag Na
44. 015 hh 3 Data 0 0 4 Minimal CO2 09 2 byte fl 348 8 ppm EI 240 2015 fF E gh tot specified 0 0 5 Maximal CO2 09 2 byte fl 442 88 ppm EI Si 2012015 BS gh Tags 0 0 6 Minimal humidity 09 2 byte fl 18 RH E 26 01 2015 Ze P 3 0 0 7 Maximal humidity 09 2 byte fl 29 RH Y Y 22 01 2015 EH HE gh Match mode 0 0 8 Minimal temperature 09 001 Tem 22 7 C Y 26 01 2015 Te TN 3 0 0 9 Maximal temperat 09 001 Tem 24 22 C Mm P 23012015 E E gh e e All tags Any tag e Een 0 0 10 Climate values reset EI 09 2bytefl 1 d 20 01 2015 BS gh Q Apply filter Cancel GF Add new object Auto update enabled D Clear 5 Mass edit Page 1 ed gt gt Dal IP gt TP policy None TP gt IP policy None Di Version 20150217 CPU IO 0 29 0 29 0 37 Memory 11 KNX TP OK Sync project data Binary objects will appear as binary values numeric values will appear as analogue values Other data types are not supported Page 112 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 6 4 BACnet Configuration BACnet configuration consists of setting BACnet server parameters in homeLYnk The BMS Building Management System discovers the exposed data 6 4 1 Configuration gt rF homeLYnk acts as a BACnet server which has to be BACnet settings configured under Configurator gt Utilities gt System gt Network gt BACnet settings Server enabled
45. 02 2015 10 58 15 event Event for 1 1 4 modbus error Connection timed out 05 02 2015 10 58 12 event Event for 1 1 8 modbus error Connection timed out 05 02 2015 10 58 05 event Event for 1 1 4 modbus error Connection timed out fig Clear lt lt Page 1 of1 gt gt 1 Displaying errors 1 3 of 3 Error messages from scripts are displayed in Error log tab 3 16 Help homeLYnk Schneider Neighbours Select neighbour Y Language English v Startpage Utilities Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Error log O Help Help topics EE pee Scripting basics Basics and script types The main purpose of scripting is to provide custom logic functions for various KNX objects There are three types of scripts possible he Event based executed when event occurs on a specific group address Data type functions i E Common functions storage alerts e Resident used for polling data from local object database Scheduled scripting date time format e Scheduled executed on a specified date or time CS Extended function library Lua programming language is used to implement user scripts Most of the Lua language aspects are covered in the first edition of Programming in Lua which is freely available online About Notes Data format in most cases data is stored and transferred using hex encoded strings 2 bytes
46. 15 Cyclic Repeater delay 60 seconds 11 16 Stepper Counter Positive Input 11 17 Stepper Counter Negative Input 11 18 RESET Steppery COM a 11 19 On Delay button set to update only mternall 11 20 PV CAC it ondaa 11 21 ONDAS dol 11 22 Stare Case Timer with variable time object essssseeseerrereerrrrrrerren 11 23 Value Memory Iwritetostoragel 11 24 Value Memory get from storagel 11 25 Multiplexer Ln E aa aii Page 8 Script Examples Binary Filter Binary Gate with Bit Gate Gate with Byte Gate And Port 2 in 1 Out Input and Output Facilities Mathematical functions Table manipulation Operating System Facilities Extended Function bra vcd di Port 2 in 1 Out 2015 Schneider Electric AR1740 EdC February 2015 All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 26 Round Function Using Common Functions sssssssessseesseessrerssressrerssrrosrersrerssreesrerseerssres 158 11 27 Write Data and Time to KNX Group Addresses 159 11 28 Write Data to Groups With Nats sie 159 12 Application Note Documents usina dai ic 161 12 1 1 Actual List of Released Application Notes 161 1212 Application Notes Availabilty sssini didas 161 Page 9 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 1 Product Security 1 1 Connectivity IP connection USB RS232 RS485 WIFI through IP connection and wireless router 1 2 Secur
47. 2 21 e This example will return false as the result because we are trying to store a function which is not possible testfn function t returnt t end result storage set my_stored_ value 2 testfn this will result in an error e The following examples show the basic syntax of storage get Assuming that key value was not found first call will return nil while the second call will return number 0 which was specified as a default value result storage get my_stored_value_3 returns nil if value is not found result storage get my_stored_value_3 0 returns O if value is not found e When storing tables make sure to check the returned result type Assume we have created a storage item with key test_object_data objectdata Page 129 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 objectdata temperature 23 1 objectdata scene default result storage set test object data objectdata store objectdata variable as test_object_data e Now we are retrieving data from storage Data type is checked for correctness objectdata storage get test_object_data if type objectdata table then if objectdata temperature gt 24 then do something if temperature level is too high end end 10 7 Alert Functions Alert message var1 var2 var3 Stores alert message and current system time in the main database All alerts are accessible in the Alerts mo
48. 2015 Levels Plans Layouts Widgets P a n S Name Visible Description Duplicate Move up Move down Add Import Export To add Plans press on Gi and select Add plan AA 7 e mm FJ Main Office PC Tablet Smar y i Vv 8 F4 Meeting R PC Tablet i A Vi 8 FJ Facility Ma PC Tablet Rei A y 8 FJ Garage PC Tablet Smar i IO Vv t 3 FJ Trend Gra PC Tablet i A Vi 8 Parent Parent directory e r gt Name Name of the plan Plan size Size of the plan User defined or predefined from list Layout Layout for the plan All Objects from the Layout will be duplicated on the plan including the background color and the plan image if they are not Plan defined separately oo Parent SE homeLynk office PC Tablet visualization Show Show make default saa eae Name Meeting Room Hide Visibility for this particular plan in PC Tablet i NORS A al visualization Plan size 1024 Le 1768 Lei fl Layout Overview layout we Smartphone visualization Show Show make PC Tablet visualization Show default Hide Visibility for this particular plan in Bo ek SE Smartphone visualization Hide vw Smartphone devices visualization Pin code Pin code Set the code which is needed to enter this Primary background image SE_spacelynk_frame jpg Xx ow particular plan of visualization If it is not defined no Secondary background image SSES code is asked by entering the visualization plan oe
49. 4 0 41 0 42 Memory 11 KNX TP ERROR Sync project data NOTE KNX interface has to be changed back to TP UART once KNX bus is connected under System DNetwork gt KNX connection gt Mode KNX interface change must be confirmed by rebooting homeLYnk manually or pressing the button Apply changes Sync project data This button is useful after some bigger change in the project When pressed project will be immediately synchronized to the microSD card Automatic synchronization is performed every 30 minutes only and all unsaved changes may be lost Page 29 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 2 Utilities Below is the Utilities tab screenshot Objects Objet logs Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Eror log oh Import ESF file Import neighbours Reset clean up Factory reset Date and time Install updates Backup 2 Py IO 9 Gi D ty Da Restore General configuration Vis configuration System L NS oS SG 3 2 1 Import ESF file Imports the ETS object file It is essential to set correct Import ESF file data types for imported objects Existing objects will ESF file Choose File No file chosen not be overwritten Objects with the same name are considered
50. 5 6 7 8 Stop bits Number of stop bits 1 2 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Duplex H Half duplex F Full duplex not supported in RS 485 The Baud rate is set depending on the distance between Modbus RTU devices For instance with a Baud rate of 9600 bit sec the maximum communication distance between 1 15 Modbus RTU device is 1 200 metres With the Baud rate of 19200 bit sec the maximum communication distance is 900 metres as shown in the table Baudrate setting Maximum communication distance for 1 to 15 Modbus RTU devices Typical with Belden 31054 cables 9600 bit sec 1200 m Parity refers to the technique of checking if transmission has been successful when transmitting between the devices It lets you know if some data has been lost during transmission Setting of Parity The Modbus supports only 11 bit frames Parity refers to the number of 1s in a given binary number Odd parity means there are an odd number of 1s and even parity means that there is an even number of 1s Parity bits are used as a means of error detection as digital data is transmitted and received Both the Gateway and Meter must always be set to the same as one another odd even or none The default parity mode of Modbus is even parity e Parity None choose between one and two stop bits e Parity Even one stop bit is set e Pari
51. All rights reserved homeLYnk AR1740 EdC User Guide February 2015 e Set RGB color in Configurator Objects Set value Grou Object name IP T Ev Data type Current value Log Ex Tags Updated at Setv Vi C 0 1 15 Meeting room RGB A O 9 amp zem aa 230120 E E gh e 0 1 14 Central OFF E E fe 01 1bt 0 26 01 20 fe ZS h 0 1 13 All PIR EMC labs EI EI Bomi 0 F 23 01 20 fe ZS hh 0 1 12 Alloffice Set object value x E 29 08 20 E E gh 0 1 11 Garage 2 F 22 01 20 R 25 0 1 10 Garage 1 EE gege ee F 22 01 20 25 R 0 1 93 Meetingroom2 Group address 0 1 15 P 260120 E YE d 8 DIS Meetingroom1 Data type 232 600 RGB color D 230120 BR SW DT Corridor 2 CS F 22 01 20 ZS hkh 01 6 Corridor 1 CT 22 01 20 ZS h 0 1 15 Middle 3 E 22 01 20 fe ZS h QR 0 1 14 Middle 2 E 22 01 20 ZS h B 0 1 3 Middle 1 F 02 02 20 fe ZS hkh DI Window 3 EI 02 02 20 fe ZS h Q onn Window 2 __ _ ba 20 01 20 fe ZS A 0 1 0 Window 1 H Y 20 01 20 fe ZS h e Set Object visualization parameters in Configurator Objects Vis Params If the option Send after each color pick is ticked a new updated object with selected color will be automatically sent to bus after releasing the left mouse button PC or release finger touch screen in the Visualization screen see PC Tablet Visualization
52. Ctrl F Replace Shift Ctrl R Replace al Ctrl Space Autocomplete OK Scheduled 05 time and date Show code shortcuts 1 obtaining actual data 2 local now os date t 3 a S local time 6 day now wday 1 and 7 or now wday 1 monday to 7 hour now hour 8 minute now min a second now sec 10 11 12 erp update 4 4 1 time dt time 13 14 15 erp update 1 7 98 now dt date 16 grp update 1 7 99 82d 482d format now hour now min 18 e getmetatable getall getone getrow getlist BIR grp getvalue grp alias grp tag grp find grp read grp write grp response grp update 2015 Schneider Electric All rights reserved homeLYnk User Guide Alerts and logs Alert Log variables Formatted alert Time functions Delay script execution Miscellaneous Sunrise sunset etc Serial Communication through internal homeLYnk I O ports Modbus Create RTU TCP connection Write register Read register etc Group addresses Existing group addresses on the KNX bus Objects by name Chose object by name Tags Choose object by tag Data types Choose object by data type Scripts List of already made scripts consist 4 sub groups Event based List of event based scripts Resident List of resident scripts Scheduled List of scheduled scripts User libraries List of common functions a Star up init scripts Page 89 AR1740
53. Day of the week Active Category Description AR1740 EdC February 2015 10 w Time OS time in short format Cancel OS time and date a fb Every month of the year Every day of the week C With short time format Cancel 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 12 4 User libraries User libraries usually contain user defined functions which are later called from other scripts Secure the Code There is an option Keep source available for user libraries Once disabled the code is compiled in the binary form and cannot be seen for further editing If this option is enabled the source code is seen in the editor Auto load library option will load selected script when homeLYnk starts Include the Library in the Scripts To use functions defined in user library they should be included in the beginning of the script for example user library with the name test should be included as below require user test User Libraries can be backed up and restored added from archive 3 12 5 Common functions Common functions contain library of globally used functions They can be called from any script any time without special inclusions with User libraries Functions like sunrise sunset Email is included by default in Common functions 3 12 6 Start up script Init script is used for initialization on specific system or bus values on system start Init seri
54. Device name Current value lt 3 T Ss CO2 0 0 1 412 8 d Humidity 0 0 2 17 gt S Temperature 0 0 3 gt lt Maximal CO2 0 0 5 gt Ss Maximal humidity 0 0 7 NOTE Maximum amount of Bacnet objects is limited to 150 in homeLYnk Window 1 0 1 0 Z Window 2 0 1 1 ZS Window 3 0 1 2 Central OFF 0 1 14 See chapter 5 for more details SZ Office 1 PIR 0 2 0 s Office 2 PIR 0 2 1 gt lt Total current 0 6 99 gt lt Consumption relay 1 Mi 0 7 0 lt Consumption relay 2 W1 0 7 1 Consumption relay 3 W2 0 7 2 gt lt Price 0 7 100 lt percents office 2 0 7 112 N N N N N N N un un un un un un N N N N N gt S T lt ae ee al eck DS b lt Temperature heating 1 0 0 ARP table ARP table Interface IP address MAC address S S a ethO 10 154 16 243 20 54 2d 00 da d0 Address Resolution Protocol table 1s listed in Network gt ARP table eth 10 154 16 248 00 0e b6 a0 68 a2 ethO 10 154 20 1 00 07 7d 37 08 2e It is used for resolution of network layer addresses into link layer addresses 1t converts IP address to a physical address Page 39 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 KNX connection KNX connection e PN General IP gt TP filter TP gt IP filter KNX spe
55. EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February 2015 3 13 Alerts In the Alerts tab a list of alert messages defined with alert function in scripts are located The messages are stored in the main database homeLYnk Schneider Gelectric Neighbours Select neighbour v Language English v Start page Utilities Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access Modbus Alert time Script name Message 24 02 2015 10 15 41 system System start 23 02 2015 14 02 42 system System start 20 02 2015 22 14 57 system KNX TP Connected 19 02 2015 12 22 14 system System start 17 02 2015 09 58 17 system System start 17 02 2015 09 53 00 system System start 16 02 2015 12 54 01 system System start 16 02 2015 10 01 54 Event for 1 1 9 Alert temperature is too high 26 C 16 02 2015 09 58 17 Event for 1 1 9 Alert temperature is too high 26 C be i iy Clear Page ei gt D Displaying alerts 1 50 of 1333 alert message var1 var2 var3 Stores alert message and current system time in the main database Example temperature 25 3 if temperature gt 24 then resulting message Temperature levels are too high 25 3 alert Temperature level is too high 1f temperature end Page 90 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 14 Logs AR1740 EdC Febru
56. GOLGI Susa 122 9 3 2 IF object value exceed maximum alert iS created ooccccnccncnnccnnnncnnnonannnonccnnnananonaso 122 9 4 Custom FUN CURIOSA dis 123 9 5 special lut geleet sc ass 125 9 5 1 GENEI EE 125 9 5 2 CONVE tcs leidos oir 125 9 5 3 Beil 125 9 5 4 USC tetas 125 10 LUA Programming LOUIS ui a iaa 126 TOt As O cose 126 10 2 lt GFOUP COMMUNICATION FUNCIONA Sisa ic 127 103 Returned oa ec TUMCEIONS dSid LE Rio 127 HOA Datatype FUNCIONS dee 128 OTD Data IDE aaa 128 10 6 Data Storage ae d e Side 129 10 7 Alert FUNCION Sad aa 130 POLS LOS n eg EE 131 109 Ve Pancita nds pidio idad 131 10 10 SUPINE te tege SA da 131 10 11 IMPUE and QULDUL GE lee ge E 138 10 12 SCPL Control FURCUO ME 138 10 13 CONVEFSIONS 222 eth a na eee 138 10 14 PBI CS e 139 Page 7 2015 Schneider Electric All rights reserved homeLYnk User Guide 10 15 10 16 10 17 10 18 10 19 11 11 1 11 2 11 3 11 4 Or 11 5 TLG SOR POR Soll ZOUT aia dais NS AiG P Ort Si ZU oleada 11 8 Telegram Transformer 0 1 bit to 0 255 bwvtel TL9 Compare valle cis 11 10 Save Scene RGB Val UC tanos 11 11 Call Scene RGB Valles lod 11 12 RGB ODOC Cote Ratna EER Otte A E aa oe a ence 11 12 1 How to operate the RGB object ssssesseseseeesssreresrrrsssreresrreresreress 11 12 2 Script for controlling RGB LED color 11 12 3 Script for reading status from the RGB LED oocccccnnccnncnnccnnnnnnos 11 13 FU SUC EE 11 14 Randon Be UE 11
57. Gate Create three group addresses under Object tab where 1 1 1 input any type but the same as output 1 1 2 gate byte object 1 1 3 output the same as input Create event based script and attach it to group 1 1 1 Script will run each time group 1 1 1 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 input value_2 grp getvalue 1 1 2 gate if value_2 0 then do nothing elseif value 2 lt 00rvalue 2 gt 0 then grp write 1 1 3 value_1 output end 11 4 Or Port 2 in 1 Out Create three 1 bit group addresses under Object tab where 1 1 1 value 1 1 1 2 value 2 1 1 3 output Add tag OR1 to value1 and value2 group addresses Create event based script and attach it to Tag OR1 Script will run each time group 1 1 1 or group 1 1 2 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 if value_1 true or value_2 true then grp write 1 1 3 true else grp write 1 1 3 false end Page 148 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 5 And Port 2 in 1 Out Create three 1 bit group addresses under Object tab where 1 1 1 value 1 1 1 2 value 2 1 1 3 output Add tag AND1 to value1 and value2 group addresses Create event based script and attach it to Tag AND1 Script will run each time group 1 1 1 or group 1 1 2
58. NA al 0 0 11 If the block is indicated with the blue label on the top left corner you can define the structure of the block e g if do else Get event value Get event value set value Ed els Kl Get event value if GI value gt to Get event valu Get event value Click right mouse button and select Delete Block or drag the block to the basket if you want to delete it Get event value You can always look at the LUA code by clicking on Show Hide Lua code button This will allow you to learn the scripting language Page 121 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Event Event for 1 1 1 Mal ave a fle Load from file 1 if event getvalue lt event getvalue then 2 value event getvalue 3 elseif event getvalue lt event getvalue then 4 value event getvalue 5 end 6 NOTE Script created in function blocks can be transferred into Lua script but it cannot be transferred back into block function script In order to transfer block function script into Lua script save and close your script and open it in script editor using this icon VG 9 3 Usage Examples This subchapter shows how to use function blocks correctly Examples with description help to better understand the concept of block programming 9 3 1 AND of two KNX objects Current value of object 0 1 0 is read and saved into variable named variable 1
59. NX settings are not backed up Filter table is backed up Page 32 AR1740 EdC February 2015 Date and time Current Mon Feb 2 10 15 19 2015 Time 10 lt 15 lt 119 Get from system Date 02 02 2015 E ure Cancel Install updates Update package file Choose File No file chosen Al Make sure that update package can be installed for the version you are using Device will reboot after successful update Restore x 2 Downloads Today backup 2015 02 10 08 4 tar gz Feb 10 2015 http 10 154 20 25 cgi bin scada qeneral utilities backup cg Show in folder Remove from list 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 2 8 Restore Restores configuration from backup 3 2 9 General Configuration Interface language Interface language English Czech Danish Dutch French German Italian Portuguese Russian Spanish and Turkish List items per page Count of lines per page for example Objects Object logs Alerts etc Maximum value is 50 Automatic address range start Newly added group objects will start addressing from defined range Discover new objects KNX object sniffer is enabled If YES is selected all new objects automatically appear in the Objects list Object log size Count of object logs Maximum value is 10000 Default log policy Log status for all objects or only for checked objects can be selected Alert log size Count of alerts l
60. S VALUE Read from bus e SMS command format R ALIAS e On read request script will reply with SMS message containing current value of selected object ALIAS can be e Group address e g 1 1 1 e Name e g Obj1 If name contains homes then it must be escaped using double quotes e g Room Temperature NOTE Object data type and name must be set in Configurator gt Objects tab Otherwise script will not be able to read and write to object NOTE Only ASCII symbols are accepted in the message NOTE For more details about sending SMS please refer to application note document ANO11_Email SMS and FTP in homeLYnk_v1 0 pdf Page 119 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 9 Block Programming 9 1 Introduction homeLYnk programming can be done either using Lua scripts or block programming For those who are programming beginners it is recommended to start with block programming It is based on Lua scripting but visualized in more friendly way 9 2 Block programming interface In order to create blocks enable this functionality in Utilities gt General configuration gt Enable Block Editor Once the script is added you can see puzzle icon d to access Block editor homeLYnk Schneider Neighbours Select neighbour Y Language English Start page Utilities Objects Objectlogs Schedulers Trendlogs Wis structure Visualization Vis graphics User access Modbu
61. Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Error log Help Name Login Visualization access Schedulers access Trends access Normal user normal Full Full Full 3 Facility manager facility Full Full Full e Visitor visitor None None None 3 GF Add new user gt User access settings NOTE Amount of users is limited to 8 in homeLYnk Page 80 2015 Schneider Electric All rights reserved homeLYnk User Guide Adding new user Add new user Click on icon to add new user User name Name of account Login Length 2 to 20 characters accepted characters mo ant a z A Z 0 9 Password Length 6 to 20 characters Any character accepted Visualization Schedulers Trend access None Partial Full When Partial access selected particular Visualization plans Schedulers Trend logs can be selected User access settings Of User access setti Click on Y icon to manage user access settings Disable password access When active password protection 1s disabled Visualization pin code When active password is disabled access can be protected by common Pin code Length 3 to 8 characters numbers only Page 81 AR1740 EdC February 2015 User x General Name Normal user Login Password seececee Repeat password zeessen Visualization access Full Schedulers access None Trends access None User General Visualizat
62. Scripts Ke aE Time functions 19 ES Miscellaneous a n e b Sp SS J E2 Serial 12 local value grp getva ue a ae is erp write b not value dt bool Basic Functions ne 14 end 15 String Manipulation Table Manipulation Mathematical Functions Each function must have a special comment Remember that special keywords Function Comment Input optionally Color must be used in the function comment in order to create the block function The keywords are highlighted in the description below Function block comment 1 First line must have Function keyword followed by the function name Second line contains short function description which is shown as block title 3 If third line contains Comment keyword all following lines until Input will be added to block comment tooltip 4 Optionally block color may be specified in hexadecimal format f00 or ff9900 or numeric format as hue value between 0 and 359 5 Keyword Input specifies that all the following lines will list the description of inputs 6 Following lines contain input list Each block can have any number of inputs Inputs are a function parameter 7 If input definition has object storage or tag in its name then the input is replaced with object storage or tag selection input Ze Each output variable is assigned to the corresponding function return value Page 123 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Example
63. Start page Structure 365 SE homeL Ynk office Overview Main Office Meeting Room 25 02 2015 m Vase 12 25 46 Wednfl o ME E gt pect ka Kei Facility Management Garage Trend Graphs Z Schedulers Help 3 Layouts Overview layout Y ES Widgets Office 1 Status W1 Status corridor 1 TOP STORIES Amnesty calls on permanent memb Security Council t their veto Nidget No widoet Status corridor 2 Musk control Climate overview Heating c Bind left Status W2 Unlock current plan for editing is configuration 2 D A gt Existing objects can be added to the map by clicking on Unlock current plan for editing After defining the object parameters press Add to plan and a newly created object appears This object can be moved to the desired location but whilst in editing mode the object will not work When all the necessary objects are added press Save and reload plan so that the objects can be visualized Page 26 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 9 4 Launching Visualization on Smartphone Device iPod in this case In order to do so please follow the next steps 1 Make sure the iPod is connected wirelessly to the homeLYnk through separate access point wireless router OE din we gt Camera 7 2 Enter homeLYnk IP default 192 168 0 10 in iPod web browser Sg Bi gt Height Manual mode 1
64. adcoils start count 01 start address of first coil to read count number of coils to read mb readdiscreteinputs start count 02 start address of first discrete input to read count number of discrete inputs to read mb readregisters start count 03 start address of first holding register to read count number of holding registers to read mb readinputregisters start count 04 start address of input register to read count number of input registers to read returns all values on success and nil error description on error mb writebits start v1 v2 v3 05 writes values to coils from start address mb writeregisters start v1 v2 v3 06 writes values to registers coils from the start address single write will be used when only one value is supplied multiple write otherwise returns all of values written on success and nil error description on error mb reportslaveid reads slave internal data returns values on success returns nil error description on error Page 108 2015 Schneider Electric All rights reserved homeLYnk User Guide 4 8 Modbus slave functions 4 8 1 Receive data from master mb receive receives data from master with 1 minute timeout returns data as a binary string on success returns nil error description on error 4 8 2 Set modbus mapping of slave device mb setmapping coils inputs holding regs input regs creates memory mapping for t
65. alues coil discreteinput Strinf Y register inputregister Y Writable Set to true to enable writing to register if type is either coil Boolean or discreteinput Value_delta New value is sent when the difference between Number previously sent value and current value is larger than delta Defaults to O send after each read Value_multiplier Multiply resulting value by the specified number value Number value_base value value_multiplier Value_bitmask Bit mask to apply shifting is done automatically based on Number least significant 1 found in the mask Page 95 2015 Schneider Electric All rights reserved Datatype Modbus value data type If set conversion will be done String automatically Possible values boolean uint16 int16 float16 uint32 int32 float32 uint64 int64 quad10k s10k es es es No No No No No homeLYnk AR1740 EdC User Guide February 2015 Value_nan Array of 16 bit integers If specified and read operation returns the same array no further processing of value is done Value_conv Apply one of built in conversion functions Internal Value_custom Name of a built in enumeration or a list of key gt value Strinfg mapping resulting value will be O if key is not found Internal Not visible to user when set to true should be used for scale Boolean registers Read_count Number of register to read at once for devices that only Number support reading of a specific block of registers Rea
66. ameter This function will list the selected objects on the top of the Object logs list NOTE Logging memory is set up in the Utilities gt Configurations Page 54 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 6 Schedulers Schedulers allow the end user to control KNX group address values based on the date or day of the week homeLYnk Schneider Neighbours Select neighbour v Language English v Start page Utilities Objects Objectlogs Schedulers Trendlogs A ER a A ET rele Vis graphics Scipting User access Modbus Alerts Logs Error log Help Schedulers Holidays 11 A Name Object Start date End date Events Active Duplic ate Electric heating 1 0 2 Heating control 01 January 31 December fe gt y e D Add scheduler 3 6 1 Add new scheduler Scheduler Object The object group address which will be Object 1 0 2 Heating control controlled by the scheduler Active Y Name Electric heating Active Defines whether a scheduler is active or Start date 01 2 January not End date 31 December Name Name of the scheduler Starts date Start date of the scheduler End date End date of the scheduler Page 55 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 6 2 Scheduler Events Event can be added both in the administrator interface and by the end user in the special User mode schedulers interface Acti
67. and are interpreted as indexing backwards from the end of the string Thus the last character is at position 1 and so on The string library provides all its functions inside the table string It also sets a metatable for strings where the _ index field points to the string table Therefore you can use the string functions in object oriented style For instance string byte s i can be written as s byte i The string library assumes one byte character encodings string trim str Trims the leading and trailing spaces off a given string Page 131 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 string split str sep Splits string by given separator string Returns LUA table string byte s i jll Returns the internal numerical codes of the characters s i s i 1 s j The default value for i is 1 the default value for j is i NOTE that numerical codes are not necessarily portable across platforms string char Receives zero or more integers Returns a string with length equal to the number of arguments in which each character has the internal numerical code equal to its corresponding argument NOTE Numerical codes are not necessarily portable across platforms string find s pattern init plain Looks for the first match of pattern in the string s If it finds a match then find returns the indices of s where this occurrence starts and ends otherwis
68. ands for the whole match The sequence stands for a single If rep is a table then the table is queried for every match using the first capture as the key if the pattern specifies no captures then the whole match is used as the key If rep is a function then this function is called every time a match occurs with all captured substrings passed as arguments therefore if the pattern specifies no captures then the whole match is passed as a sole argument If the value returned by the table query or by the function call is a string or a number then it is used as the replacement string otherwise if it is false or nil then there is no replacement that is the original match is kept in the string Example x string gsub hello world w 1 1 gt x hello hello world world x string gsub hello world w 0 0 1 Page 133 2015 Schneider Electric All rights reserved AR1740 EdC homeLYnk February 2015 User Guide gt x hello hello world x string gsub hello world from LUA w s w 2 1 gt x world hello LUA from x string gsub home HOME user SUSER S w os getenv gt x home home roberto user roberto x string gsub 4 5 Sreturn 4 55 S S function s return loadstring s end gt X 4 5 9 local t name LUA version 5 1 x string gsub Sname Sversion tar gz S wt t gt x LUA 5 1 tar gz string len
69. ar program e Active Make script active green or deactivate it red e Edit Edit script name description category and other parameters e Delete Delete the script When pressing this icon the confirmation is asked to accept the delete Page 87 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 12 9 Script Editor When a script is added y icon appears in the Editor column that allows opening a script in the scripting editor and re working it with built in code snippets Code snippets save time and make the coding convenient After clicking on the appropriate snippet it automatically adds code to the editor field Keyboard shortcuts are implemented for help with script writing Logs and error window are also available Ctrl F Find syntax in a code text will be highlighted in yellow Ctrl G After finding a text via Ctrl F we can use Ctrl G to select the next syntax in a script Shift Ctrl G Select previous syntax Shift Ctrl F Replace syntax in a script by another one You will be allowed to choose one by one if you want to change it Shift Ctrl R Replace all syntaxes in a script by another one at once Ctrl Space Helps to auto detect code and write for you Press Ctrl Space and write first letter of a command then select the correct one from the list There are six main groups of Script editor Helpers Predefined code snippets like
70. ary 2015 Logs can be used for scripting code debugging The log messages appear defined by log function Utilities Schedulers Vis structure Visualization Log time 09 02 2015 15 49 41 09 02 2015 15 49 40 09 02 2015 15 48 40 09 02 2015 15 48 40 09 02 2015 15 47 40 09 02 2015 15 47 40 09 02 2015 15 46 40 09 02 2015 15 46 40 09 02 2015 15 45 40 09 02 2015 15 45 40 09 02 2015 15 44 40 09 02 2015 15 44 40 09 02 2015 15 43 40 09 02 2015 15 43 40 09 02 2015 15 29 02 09 02 2015 15 29 02 09 02 2015 15 28 02 09 02 2015 15 28 02 09 02 2015 15 27 02 09 02 2015 15 27 02 09 02 2015 15 26 02 09 02 2015 15 26 02 j Clear Show logs window Object logs Script name Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPU Temperature CPL log var1 var2 var3 Page Trend logs Message arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg arg ara 1 of 100 N 1 string t2 arg 2 1 string t1 arg 1 string t2 arg 1 string t1 arg 1 string t2 arg 1 string t1 a
71. ating type then the precision needs to be selected Example 1 1111 precision is 4 I minute data Average value of 1 minute for specific time interval data will be shown on the trend Example if 1 hour trend step will be 1 hour with average 60 readings data Hourly data Time of storage of hourly data Max 5 years Daily data Time of storage of daily data Max 10 years NOTE Trend logs are stored in internal SD card memory NOTE Please note that if the log type is set to Counter it cannot have permanently decreasing tendency For this option use Counter with negative delta Trends visualization is not supported in the Smartphone visualization Page 59 Trend log Object Name Log type AR1740 EdC February 2015 0 0 3 Temperature Temperature Floating point precision 1 minute data Hourly data Daily data Cancel 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 8 Vis Structure Vis Structure is used for creating all building levels and visualizations plans Additionally it can create Layouts and Widgets for the plans visualization Starting new project only Layout and Widget folders are visible Adding new level allows the end user to define specific Plan of the flat Layouts and Widgets are additional tools which are not mandatory for basic visualizations they can be defined and implemented in other Plans homel Yn
72. b weather station actual tem Web today highest temperature Web today lowest temperature Selection of visible trends is done in Trends list Multiple trends 3 Feb 2015 Wall socket switching i Ge z ee February 2015 Web weather station ac lemeprature Tu We Th Fr Sa Bied beta Web today highest temperature Web weather station actual tem Web today lowest temperature Web today highest temperature Web today lowest temperature Month Year Single trend Multiple trends 8 0 01 00 Graph Data Data can be also displayed in numeric format and exported in CSV format for further use CO2 level 16 Feb 2015 Download CSV lt February 2015 gt Mo Tu We Th Fr Sa Su 16 Feb 2015 1 00 00 351 ppm gt 3 4 5 67 8 01 00 354 ppm 9 10 11 12 13 14 15 02 00 354 ppm DI 18 19 20 21 22 03 00 995 ppm 23 24 25 26 27 28 04 00 367 ppm 05 00 371 ppm 06 00 376 ppm Month Year 07 00 401 ppm 08 00 417 ppm Previous ach 09 00 419 ppm 10 00 424 ppm Multiple trends 11 00 410 ppm i 12 00 424 ppm 13 00 406 ppm 14 00 408 ppm am mm ER Graph Page 58 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 7 1 Add New Trend Log Object Choose from the list of objects the one to make the trends for Name Name of the trend Log type Type of the log Counter Used to count the data Absolute value Saves the actual readings Floating point precision If the object is flo
73. be used to return the result of read request Use event based script instead object update value datatype Similar to object write but does not send new value to the bus Useful for objects that are used in visualization only 10 4 Data type Functions knxdatatype Object provides data encoding and decoding between LUA and KNX data formats knxdatatype decode value datatype Converts hex encoded data to LUA variable based on given data type Data type is specified either as KNX primary data type integer between 1 and 16 or a secondary data type integer between 1000 and 16000 Return values e success decoded data as LUA variable type depends on data type value length in bytes e error nil error string 10 5 Data Types The following data types can be used for encoding and decoding of KNX data Data representation on LUA level and predefined constants in bold is given below e bool 1 bit boolean dt boolean e 2 bit 1 bit controlled dt bit2 number e 4 bit 3 bit controlled dt bit4 number e 1 byte ASCII character dt char string e 1 byte unsigned integer dt uint8 number e 1 byte signed integer dt int8 number e 2 byte unsigned integer dt uint16 number e 2 byte signed integer dt int16 number e 2 byte floating point dt float16 number e 3 byte unsigned integer 232 600 RGB color e 3 byte time day dt time table with the following items o day number 0
74. ble This table must have fields year month and day and may have fields hour min sec and det for a description of these fields see the os date function The returned value is a number whose meaning depends on your system In POSIX Windows and some other systems this number counts the number of seconds since some given start time the epoch In other systems the meaning is not specified and the number returned by time can be used only as an argument to date and difftime os tmpname Returns a string with a file name that can be used for a temporary file The file must be explicitly opened before its use and explicitly removed when no longer needed On some systems POSIX this function also creates a file with that name to avoid security risks Someone else might create the file with wrong permissions in the time between getting the name and creating the file You still have to open the file to use it and to remove it even if you do not use it When possible you may prefer to use o tmpfile which automatically removes the file when the program ends 10 19 Extended Function Library toboolean value Converts the given value to boolean using the following rules nil boolean false O empty string OU string are treated as false everything else as true string split str sep Splits the given string into chunks by the given separator Returns LUA table Page 144 2015 Schneider Electric All rights reserved hom
75. blue colors 11 12 3 Script for reading status from the RGB LED This script is converting 3 x 1byte status objects in to 1 x 3byte RGB object Create event based script which will run from a unique TAG this tag must be attached to red green blue 1 byte status objects Page 154 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Fill configurable parameters with group addresses or groups names It is recommended to use 1 byte status object for the inputs RGB object must have correct data type redGroup 1 1 1 modify ether group address or name of group greenGroup LED1 Green Status modify ether group address or name of group blueGroup 1 1 3 modify ether group address or name of group rgbGroup RGB Value modify ether group address or name of group red grp find redGroup green grp find greenGroup blue grp find blueGroup redHex red datahex greenHex green datahex blueHex blue datahex RGB Imcore hextoint redHex greenHex blueHex grp write rgbGroup RGB 11 13 Hysteresis do not change object 1 1 2 when value of object 1 1 1 is between 100 and 200 value_1 grp getvalue 1 1 1 byte value if value_1 lt 100 then grp write 1 1 2 false bit to O elseif value_1 gt 200 then grp write 1 1 2 true bit to O end 11 14 Random byte value steps 255 possible steps change this value to lower value to make bi
76. cation window select the newly created interface as Options Communication Interface from the drop down us Select Communication Intertace Configure Interfaces To test the communication with ETS press Z Test OF Settings Prompt when connecting Problem Analysis Make sure that the bus status is Online press TE button in ETS Page 19 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 6 homeLYnk for KNX EIB Network Configuration Management with ETS4 In order to use homeLYnk with KNXnet IP functionality and to program with the other KNX bus devices the device should be added into the ETS Connection Manager ETS programming through homeLYnk is available only when KNX IP features are enabled Function Bus monitor is not included in homeLYnk Settings gt Communication Newly added homeLYnk will be discovered z s automatically if it is connected in the same network as Set the PC running ETS4 software Presentation Language 1 Overview Projects Catalogs Database Settings D Fei Communication Y Enable automatic scan on serial ports Choose Select to move it to the Configured Database F Use project connection if available Y Use direct KNX IP connection if available connections Software Updates Troubleshooting Currently selected Import Export Merten GmbH amp Co KG
77. ce Type _http tcp Service Name OWFS 1 wire Web Domain Name local Interface atho IPv4 Address ubuntu 2 local 192 168 0 99 51588 TXT Data empty Page 16 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 ex Android Jd ZeroConf Browser ZeroConf Pops The freely available app called ZeroConf Browser can be downloaded in Google Play 5 _DEVICE INFO gt A om File Transport Protocol FTP gt te HTTP Server Web Server on amatilinea _http _tcp lOCa amatilinea tocal 80 path NetworkSpace2 http _tcp loca NetworkSpace2 local 8 e WI kb t path iOS Mac OS Web Server on spaceLYnk spacelYnk local 80 The freely available app called Discovery bonjour 192 168 0 5 browser can be downloaded from the App Store TXTRecord path ai For iPad install the iPhone iPod version of the utility Page 17 2015 Schneider Electric All rights reserved AR1740 EdC February 2015 homeLYnk User Guide 2 4 Firmware Upgrade NOTE Before each upgrade please backup the visualization scripts and object in Configurator gt Utilities gt Backup During the upgrade the device will not respond as it will be rebooting After each upgrade it is strongly recommended to clean the browser cache Use the web browser to perform the homeLYnk software upgrade Firmware is available in the form of images and can be downloaded from the support page
78. ching is captured with number 2 and the part matching s has number 3 As a special case the empty capture captures the current string position a number For instance if we apply the pattern Jaa on the string flaaap there will be two captures 3 and 5 A pattern cannot contain embedded zeros Use z instead Page 137 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 10 11 Input and Output Functions io exists path Checks if given path file or directory exists Return boolean io readfile file Reads whole file at once Return file contents as a string on success or nil on error io writefile file data Writes given data to a file Data can be either a value convertible to string or a table of such values When data is a table then each table item is terminated by a new line character Return boolean as write result when file can be open for writing or nil when file cannot be accessed 10 12 Script Control Function script enable scriptname Enable the script with the name scriptname script disable scriptname Disable the script with the name scriptname status script status scriptname Returns true false if script is found nil otherwise 10 13 Conversions Compatibility layer mcore is an alias of cnv cnv strtohex str Converts given binary string to a hex encoded string cnv hextostr hex keepnulls Converts given hex
79. cific configuration is located in Configurator gt Utilities gt Network gt Network Mode ElBnet IP Routing 7 gt KNX connection window KNX address 15 15 250 KNX IP features il General Multicast IP 224 0 23 9 Mode KNX connection mode homeL Ynk has il i TP UART interface by default built in Maximum telegrams in queue e TP UART Twisted pair connection via black red plug Transfer rate 9 6 kB s ElBnet IP Tunneling IP connection minimal 1000x faster than TP UART homeLYnk as a server Unicast acknowledged data exchange additional individual address per tunneling connection ElBnet IP Tunneling NAT mode Network Address Translation mode Allows multiple devices to connect to public network using the same public IPv4 address It modifies the IP address information in the IPv4 headers while in i transit across a traffic routing device EIBnet IP Routing Multicast unacknowledged data transfer homeLYnk as a Line or Backbone Coupler ACK all group telegrams If homeLYnk communicates directly with another KNX device it must acknowledge received telegrams Unselect if homeLYnk operates as a sniffer of group addresses only KNX address KNX physical address of the device KNX IP features Use this device with KNX IP features for example KN Xnet IP network configuration If not active then all IP communication from KNX is blocked Multicast IP Multicast IP address Multicast TTL
80. codes Example Read single coil coil mb readcoils address address address of the coils 1 ON 0 OFF 01 or 02 or 03 or 04 Read Multiple coil coil mb readcoils start count start address of first coil to read count number of coils to read max 2000 1 ON 0 OFF 01 or 02 or 03 or 04 coil1 coil2 coil3 mb readcoils 1000 3 Value read from coil address 1000 is returned into variable coil1 Value read from coil address 1001 is returned into variable coil2 Value read from coil address 1002 is returned into variable coil3 FCHO2 Read Discrete Inputs Name Command Arguments Returned values Exception codes Name Command Arguments Returned values Exception codes Example Page 104 Read discrete input value mb readdiscreteinputs address address address of the input 1 ON 0 OFF 01 or 02 or 03 or 04 Read discrete inputs value mb readdiscreteinputs start count address address of first input to read count number of inputs to read max 2000 1 ON O OFF 01 or 02 or 03 or 04 bool1 bool2 mb readdiscreteinputs 10 2 Value read from discrete input address 11 is returned into variable bool1 Value read from discrete input address 12 is returned into variable bool2 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 FCHO3 Read Holding Registers Name Read registers Command value mb readreg
81. conditioning control lighting control access control fire detection systems and their associated equipment BACnet protocol provides exchange information for building automation devices regardless of the particular building service they perform 6 2 homeLYnk Configuration Interconnection of homeLYnk and other BACnet device is done over Ethernet physical layer homeLYnk can act as a BACnet server only It means that homeLYnk serves data which can be read by BACnet client device and BACnet client device can write data to the server As home LYnk is KNX based device the connection to BACnet network comes from KNX group objects which are exported to BACnet 6 3 Object export All the KNX objects in homeLYnk object list Configurator gt Objects has the parameter Export By selecting this Export checkbox the specific KNX object will be visible in BACnet as BACnet object homeLYnk Schneider Neighbours Select neighbour v Language English v Start page Utilities Schedulers Trend loos Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Error log Help Object filter Group a Object name Eve Data type Current value Log Export Tags Updated at A NT A 0 0 1 co2 z 09 2 byte fl 409 92 ppm E EI 26 01 2015 S KS Name or group address y d d pp E 3 0 0 2 Humidity Y 05 001 scale 27 RH E E 26 01 2015 RE HE ww e 0 0 3 Temperature y fe 09 001 Tem 23 34 C Fa Fj 26 01 2
82. d plan button so that the objects start functioning With delay for obtaining relevant data Object from which the data are obtained must be set as logged in Object s properties Page 75 AR1740 EdC February 2015 Plan editor abel Image Frame Gauge Camera Data object 0 0 3 Temperature Custom name Temperature graph Icon empty svg Window size 320 240 Number of points 10 Auto open window Hide background Additional classes Element position Element size CO2 graph 2015 02 06 09 45 40 CO2 graph 400 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 8 Text label Text labels can be added and moved across the visualization map Text Label text Font size Label font size Text style Style of the text bold italic underscored Custom font Font name Font color Label font color Additional classes For custom CSS styles Once the label parameters are defined press Add new object button and newly created label will appear on the map The object can be moved to the desired location Press on Save and reload floor plan button so the label starts functioning Last two rows in the color palette refer to the predefined Schneider Electric corporate colors 3 9 9 Image Image section allows adding images from Local storage or from the internet into the visualization map External image is useful for example to grab dynamic weathercast images
83. d_swap Swap register order during conversion endianness Boolean Read_offset Position of first register of data from the block of Number N registers O based Once you create your json file which contains all the information of your profile you can upload it Address_scale Address of register containing value scale value value Number 10 scale No No No No No O easily into your homeLYnk by Configurator gt Modbus gt Profiles gt Add profile Page 96 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 4 Modbus RTU Interface 4 4 1 Characteristics of Modbus RTU Interface e Supported over RS 485 physical interface e Can act as Modbus RTU Master or Modbus RTU Slave e Supported Function Codes 01 02 03 04 05 06 07 0F 10 e Maximum 32 devices on bus e RS 485 interface is not isolated 4 4 2 RS 485 Bus Topology Characteristics Main RS 485 Characteristics e Mode of operation differential e Voltage at any bus terminal 7 V to 12 V e Receiver Input Sensitivity 200 mV e Sink Source current 60 mA e Built in asymmetrical protection against transient voltages resulting from electrostatic discharge ESD electrical fast transients EFT and lighting e Not isolated RS 485 interface Connection Type point to point connections point to multipoint connections Type of Trunk Cable shielded cable with 1 twisted pair and at least a third c
84. dule This function behaves exactly as LUA string format Example temperature 25 3 if temperature gt 24 then resulting message Temperature levels are too high 25 3 alert Temperature level is too high 1f temperature end The page at 10 154 12 78 says Temperature level is too high 26 0 Page 130 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 10 8 Log Functions Log vari var2 var3 Converts variables to human readable form and stores them in the main database All items are accessible in the Logs module Example log function accepts LUA nil boolean number and table up to 5 nested levels type variables a key1 valuel key2 2 b test c 123 45 logs all passed variables log a b c 10 9 Time Functions os sleep delay Delay the next command execution for the delay seconds os microtime Returns two values current timestamp in seconds and timestamp fraction in nanoseconds os udifftime sec usec Returns time difference as floating point value between now and timestamp components passed to this function seconds nanoseconds 10 10 String Functions This library provides generic functions for string manipulation such as finding and extracting substrings and pattern matching When indexing a string in LUA the first character is at position 1 not at O as in C Indices are allowed to be negative
85. e it returns nil A third optional numerical argument init specifies where to start the search the default value is 1 and can be negative A value of true as a fourth optional argument plain turns off the pattern matching facilities so the function does a plain find substring operation with no characters in the pattern being considered magic NOTE If plain is given then init must be given as well If the pattern has captures then in a successful match the captured values are also returned after the two indices string format formatstring Returns a formatted version of its variable number of arguments following the description given in its first argument which must be a string The format string follows the same rules as the printf family of standard C functions The only differences are that the options modifiers L n p and h are not supported and that there is an extra option q The q option formats a string in a form suitable to be safely read back by the LUA interpreter the string is written between double quotes and all double quotes newlines embedded zeros and backslashes in the string are correctly escaped when written For instance the call string format q a string with quotes and n new line will produce the string a string with quotes and new line The options c d E e f g G i o u X and x all expect a number as argument whereas q and s expect a string This function do
86. e Modbus bus i e all nodes are in receive mode and there is no active driver available the state of the line is unknown In these cases the line is subjected to external noise or interference In order to prevent the receivers from adopting improper states the line needs to be biased i e the constant state of the line must be maintained by an external pair of resistors connected to the RS 485 balanced pair RC Termination To prevent unintended effects like reflections from occurring in your Modbus SL application make sure to terminate the transmission lines properly Use RC termination to minimize the loop current and the line reflections Furthermore RC termination increases the noise margin Choose two serial capacitors of 1 nF 10 V minimum and two resistors of 120 Q 0 25 W as line termination Integrate these components at both ends of your Modbus SL communication line R Termination Only If the client insist on the R 150 Ohm termination only not RC he must connect external polarization resistors himself 450 650 Ohm at the master s tap See the scheme in picture below Modbus interface isolation Modbus interface of homeLYnk is not isolated We strongly recommend to use optocoupler separation of Modbus line and homeLYnk RS485 interface It will increase robustness of the Modbus network and reduce noise in the bus traffic Termination polarization and separation using Schneider Electric devices Schneider Electric de
87. e active group no tag attached Create event based script and attach it to group 1 1 10 Script will run each time group 1 1 10 receive telegram Add the following code to the Script editor AllLights grp tag Light AllLights write true All lights will be switched on each time group 1 1 10 receive telegram Page 159 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 NOTE Do not start the script from the same tag or group addresses containing the same tag This will create an infinite loop which will generate traffic on a bus and high load on processor If infinite loop is created stop the script and reboot homeLYnk Page 160 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 12 Application Note Documents Detailed description of selected topics with focus on easy implementation can be found in application notes documents The list of application notes documents is continuously updated 12 1 1 Actual List of Released Application Notes e ANOO1_homeLYnk integration using BACnet_v1 4 e ANOO3 Modbus power meters and homeLYnk_v1 3 e ANOO6 Advance techniques in visualization homeLYnk v1 2 e ANOO7_How to replace micro SD card in homeLYnk e ANO10_RS232 control with homeLYnk e ANO11 Email SMS and FTP in homeLYnk e ANO12 homeLYnk and SONOS e ANO13 Fetch weather forecast to homeLYnk e ANO15_ homeLYnk visualization shortcut on the des
88. e the firmware Every upgrade must be manually performed Please backup before an upgrade See chapter 3 2 7 for backup procedure 1 6 Factory Reset See chapter 3 2 4 for description how to reset the device 1 7 Limitations Schneider Electric is not liable for damages caused by unqualified manipulation with the homeLYnk settings as well as not responsible for any security failure e g by unauthorized access Page 11 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 Quick Start Guide Follow the steps listed to help you get started with homeLYnk 1 Mount the device on DIN rail 2 Connect the bus cables KNX ModBus and or RS232 and or flash drive 3 Connect 24V power supply to the device Positive conductor to the red clamp negative conductor to the blue clamp 4 Recommended accessory Power supply REG 24V DC 0 4A article No MTN693003 5 Connect Ethernet cable from the PC 6 Default IP address of the homeLYnk device is 192 168 0 10 Change the IP address of the computer to the same range e g 192 168 0 9 mask 255 255 255 0 7 Run Google Chrome or Mozilla Firefox for OS Windows Safari for OS X and go to 192 168 0 10 NOTE Internet Explorer is not supported 1 65 A PC Tablet Smartphone Scheduler Trends Configurator Visualization Visualization Schneider LP Electric Page 12 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC
89. eLYnk AR1740 EdC User Guide February 2015 knxlib decodeia indaddressa indaddressb Converts the binary encoded individual address to LUA string This function accepts either one or two arguments interpreted as two single bytes knxlib decodega groupaddressa groupaddressb Converts the binary encoded group address to LUA string This function accepts either one or two arguments interpreted as two single bytes knxlib encodega groupaddress separate Converts the LUA string to binary encoded group address Returns group address a single LUA number when second argument is nil or false and two separate bytes otherwise ipairs t Returns three values an iterator function the table t and O so that the construction will iterate over the pairs 1 t 1 2 t 2 up to the first integer key absent from the table for i v in ipairs t do body end next table index Allows a program to traverse all fields of a table The first argument is a table and the second argument is an index in this table Next returns the next index of the table and its associated value When called with nil as its second argument next returns an initial index and its associated value When called with the last index or with nil in an empty table next returns nil If the second argument is absent then it is interpreted as ni In particular you can use next t to check whether a table is empty The order in which the indices are enumerated is not specif
90. easonable date and time representation that depends on the host system and on the current locale that is os date is equivalent to os date c os difftime t2 t1 Returns the number of seconds from time t1 to time t2 In POSIX Windows and some other systems this value is exactly t2 t1 Page 143 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 os execute command This function is equivalent to the C function system It passes command to be executed by an operating system shell It returns a status code which is system dependent If the command is absent then it returns nonzero if a shell is available and zero otherwise os exit code Calls the C function exit with an optional code to terminate the host program The default value for code is the success code os getenv varname Returns the value of the process environment variable varname or nil if the variable is not defined os remove filename Deletes the file or directory with the given name Directories must be empty to be removed If this function fails it returns nil plus a string describing the error os rename oldname newname Renames file or directory named oldname to newname If this function fails it returns nil plus a string describing the error os time table Returns the current time when called without arguments or a time representing the date and time specified by the given ta
91. ebruary 2015 3 9 Visualization This tab is split into three sections 1 Structure Navigation tree for levels plans widgets which were created under the visualization structure tab 2 Visualization map Actual visualization field where you can add all visualization components 3 Plan Editor All parameters of the component are set up here homeLYnk Schneide Neighbours Select neighbour Y Language English v Start page ectric Utilitie Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphic Scripting User access Alerts Logs Error log Help lt ij TE l Building Main 25 02 2015 y a ZE SE homeLYnk office i Overview 12 54 53 Wedn Main Office Meeting Room Facility Management Garage Trend Graphs Schedulers Main object NES v Status object Use main object Custom name TOP STORIES he Hide in Smartphone i Help 3165 Layouts Hide background y t Overview layout y Send fixed value 35 Widgets Amnesty calls on EE i Office 1 permanent memb No bus write Status W1 Security Council t Pin code Status corridor 1 their veto OE Status corridor 2 Widget No widget v Music control Display mode Icon and value y Climate overview Smartphone icon v Heating Blind left Additional classes c wW SARN Font size 12 s Status W3 Status M1 Text styles B U REN Custom font v t Status M3 Switch Font col
92. ed Username remote Password Leave password blank to keep it unchanged 0 cancel 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Upgrade firmware Upgrade firmware Firmware File Choose File Mo file chosen It will take about 5 minutes For upgrade to complete Your complete upgrade of the system both OS as well system wil reboot twice All config Files will be kept as homeL Ynk part a Do not unplug your router while updgrade is in progress System gt Upgrade firmware is used to perform NOTE After each upgrade it is strongly recommended to clean the browser cache During firmware upgrade the device will not respond because homeLYnk will reboot several times Reboot By executing System gt Reboot command homeLYnk will restart Shutdown By executing System gt Shutdown command homeLYnk will shut down NOTE It is strongly advised to shutdown the system before the unit is powered off so that the database can be saved securely The system is shutdown when LED no stops blinking The only way to switch homeLYnk ON again is to disconnect and re connect power supply It can t be switched ON remotely Page 36 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 3 2 System gt Network Interfaces Ethernet interface is listed in the first tab Traffic flowchart can be opened by using iila graph button on the right
93. egrams are not filtered DST group filter No filter Accept selected individual addresses Drop selected individual addresses Policy to apply to the list of destination group addresses Group address list List of group addresses One address per line Use e g 1 1 to filter all the addresses in the given line NOTE KNX IP features should be enabled for filters to work This applies to incoming telegrams only Page 42 AR1740 EdC February 2015 KNX connection x General IP gt TP filter TF gt IP filter Apply filter to tunneling SRC policy No filter T Ind address list One address range per line Use e g 1 1 to filter all addresses in the given line DST group policy No filter e Group address list One address range per line Use e g 1 1 to filter all addresses in the given line Note KNX IP features are required for filter to work Filtering lists are updated at once changing policies requires restart 2015 Schneider Electric All rights reserved homeLYnk User Guide TP gt IP filter Filter accepts or drops received telegrams from the defined KNX devices physical addresses All the outgoing telegrams are not filtered Apply filter to virtual objects Virtual object serves for internal data exchange inside homeLYnk e g from Modbus to Visu If command gr update is used in Lua then the group address 1s not written to TP but is written to IP only If this option i
94. encoded string to a binary string NULL characters are ignored by default but can be included by setting second parameter to true cnv tonumber value Converts the given value to number using the following rules numbers and valid numeric strings are treated as is boolean true is 1 boolean false is O everything else is nil cnv hextoint hexvalue bytes Converts the given hex string to and integer of a given length in bytes cnv inttohex intvalue bytes Converts the given integer to a hex string of given bytes cnv strtohex str Converts the given binary string to a hex encoded string Page 138 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 cnv hextostr hexstr Converts the given hex encoded string to a binary string 10 14 Bit Operators bit bnot value Binary not bit band x1 x2 Binary and between any number of variables bit bor x1 x2 Binary and between any number of variables bit bxor x1 x2 Binary and between any number of variables bit Ishift value shift Left binary shift bit rshift value shift Right binary shift 10 15 Input and Output Facilities The I O library provides two different styles for file manipulation The first one uses implicit file descriptors that is there are operations to set a default input file and a default output file and all input output operations are over these default files The second style us
95. ent of table t table sort table comp Sorts table elements in a given order in place from table 1 to table n where n is the length of the table If comp is given then it must be a function that receives two table elements and returns true when the first is less than the second so that not comp a i 1 a i will be true after the sort If comp is not given then the standard LUA operator lt is used instead The sort algorithm is not stable that is elements considered equal by the given order may have their relative positions changed by the sort 10 18 Operating System Facilities os date format time Returns a string or a table containing date and time formatted according to the given string format If the time argument is present this is the time to be formatted see the os time function for a description of this value Otherwise date formats the current time If format starts with then the date is formatted in Coordinated Universal Time After this optional character if format is the string t then date returns a table with the following fields year four digits month 1 12 day 1 31 hour 0 23 min 0 59 sec 0 61 wday weekday Sunday is 1 yday day of the year and isdst daylight saving flag a boolean If format is not t then date returns the date as a string formatted according to the same rules as the C function strftime When called without arguments date returns a r
96. es explicit file descriptors When using implicit file descriptors all operations are supplied by table o When using explicit file descriptors the operation o open returns a file descriptor and then all the operations are supplied as methods of the file descriptor The table o also provides three predefined file descriptors with their usual meanings from C io stdin io stdout and o stderr The I O library never closes these files Unless otherwise stated all I O functions return nil on failure plus an error message as a second result and a system dependent error code as a third result and some value different from nil on SUCCESS io close file Equivalent to file close Without a file closes the default output file io flush Equivalent to file flush over the default output file io input file When called with a file name it opens the named file in text mode and sets its handle as the default input file When called with a file handle it simply sets this file handle as the default Page 139 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 input file When called without parameters it returns the current default input file In case of errors this function raises the error instead of returning an error code io lines filename Opens the given file name in read mode and returns an iterator function that each time it is called returns a new line from
97. es not accept string values containing embedded zeros except as arguments to the q option Page 132 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 string gmatch s pattern Returns an iterator function that each time it is called returns the next captures from pattern over string s If the pattern specifies no captures then the whole match is produced in each call As an example the following loop s hello world from LUA for w in string gmatch s a do print w end will iterate over all the words from string s printing one per line The next example collects all pairs key value from the given string into a table t s from world to LUA for k vin string gmatch s w w do t k v end For this function a A at the start of a pattern does not work as an anchor as this would prevent the iteration string gsub s pattern repl n Returns a copy of s in which all or the first n if given occurrences of the pattern have been replaced by a replacement string specified by repl which can be a string a table or a function gsub also returns as its second value the total number of matches that occurred If repl is a string then its value is used for replacement The character works as an escape character any sequence in repl of the form n with n between 1 and 9 stands for the value of the n th captured substring see below The sequence 0 st
98. for changes to take effect homeLYnk will automatically reboot after these changes are applied Page 15 Protocol IP address Network mask Gateway IP DNS server 1 DNS server 2 MTU AR1740 EdC February 2015 Interface etho Static IP 10 154 20 25 10 154 20 1 10 154 20 1 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 3 Discover homeLYnk IP Address Windows PC Option 1 S _http _tcp D Web Server on homeLYnk E Web Server on spaceLYnk Use the utility Service Browser which can be Host name spaceL nk local downloaded here gt Network interface Intel R 82579V Gigabit Network Connectio path http marknelson us attachments 201 1 bonjour windows ServiceBrowserExe zip Apple bonjour is required it is part of iTunes http support apple com kb DL999 Option 2 If host is not changed and only one homeLYnk is on the network type in browser http homeLYnk local Firefox http homel Ynk local Chrome Websites e TVIPSS1WI_7C9BES NOTE Installed Bonjour service needed Web Server on spacel ok Browser Configuratron Options Diagnostic Information Avani Discovery Linux PC Y atho IPv4 v local Y _owhttpd tcp q P OWFS 1 wire Web The utility called Avahi can be downloaded here ee www avahi org A Web Vv _owserver _tcp OWFS 1 wire Server Y Workstation ubuntu84 00 13 f7 28 35 86 Servi
99. g bul b_100_4 svg bul b_10 1 5w e G Add i icons Ie Delete selected Press Add new icon button to add a new entry The system accepts any icon size Jpeg Gif PNG and SVG formats are supported Name can contain letters numbers underscore and minus sign ZIP archive containing multiple graphics can be uploaded each item cannot exceed 2MB and whole archive size cannot exceed 16MB Add new graphics x Name optional File Name can contain letters numbers underscore and minus sign ZIP archive containing multiple graphics can be uploaded each item cannot exceed 2MB whole archive size cannot exceed 16MB Save Cancel Name optional The name of the icon It will appear in the list when adding new object It can contain letters numbers underscore and minus sign File Icon file location CSS style can be changed via uploading new file CSS define all control buttons Smartphone visualization Scheduler and Trend For more information on how to modify the CSS file please contact your local front office for additional document NOTE Clear cache of the browser after uploading new CSS file Page 79 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 11 User access User access menu allows creating and managing user s accounts homeLYnk Schneider Neighbours Select neighbour w Language English w Start page Utilities Objects Object logs
100. gger steps random math random 0 steps 1 255 steps 1 outcome math floor random value_1 grp getvalue 1 1 1 grp write 1 1 1 outcome Write random byte value to object Page 155 2015 Schneider Electric All rights reserved homeLYnk User Guide 11 15 Cyclic Repeater delay 60 seconds value_1 grp getvalue 1 1 1 if value_1 true then repeat value_1 grp getvalue 1 1 1 if value_1 true then grp write 1 1 2 true wait for 60 seconds os sleep 60 end until value_1 false end 11 16 Stepper Counter Positive input value_1 grp getvalue 1 1 1 Positive input if value_1 true then Stepper Value storage get Value Stepper_1 if not Stepper_Value then Stepper_Value 0 end if Stepper_Value 255 then else Stepper Value Stepper Value 1 end storage set Value Stepper_1 Stepper Value grp write 1 1 4 Stepper_Value end 11 17 Stepper Counter Negative input value 1 grp getvalue 1 1 2 Negative input if value_1 true then Stepper Value storage get Value Stepper_1 if not Stepper_Value then Stepper_Value 0 end if Stepper_Value O then else Stepper_Value Stepper_Value 1 end storage set Value_Stepper_1 Stepper_Value grp write 1 1 4 Stepper_Value end Page 156 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk User Guide 11 18 Reset Stepper Counter value_1 g
101. ght embeddable scripting language LUA combines simple procedural syntax with powerful data description constructs based on associative arrays and extensible semantics LUA is dynamically typed runs by interpreting byte code for a register based virtual machine and has automatic memory management with incremental garbage collection making it ideal for configuration scripting and rapid prototyping Programming in LUA as scripting language for homeLYnk is primary based on the writing functions Functions in LUA are first class values with proper lexical scoping What does it mean for functions to be first class values lt means that in LUA a function is a value with the same rights as conventional values like numbers and strings Functions can be stored in variables both global and local and in tables They can be passed as arguments and can be returned by other functions What does it mean for functions to have lexical scoping lt means that the functions can access variables of its enclosing functions 10 1 Object Functions The grp provides simplified access to objects stored in the database and group address request helpers Most functions use alias parameter object group address or unique object name e g 1 1 1 or My object erp getvalue alias Returns value for the given alias or LUA nil when object cannot be found erp find alias Returns single object for the given alias Object value will be decoded auto
102. gurator s main page bottom bar Version 1 3 CPU TO 0 59 0 44 0 25 Memory 11 KNX TP OK Syne project data Version 1 3 This is the actual firmware version of the homeLYnk CPU IO 0 59 0 44 0 2 5 Memory 11 Load average numbers 0 59 0 44 0 25 represent averages over progressively longer periods of time one five and fifteen minute average The lower number the better Bridge traffic analogy to processes Load of 0 50 z Load of 1 00 z Load of 1 70 NOTE Inspect your running tasks if the load exceeds the level 0 70 Page 28 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Used memory Buf fered Cached Memory minimum occupied memory in Total system memory See System Status System status Memory usage Beware of Linux terminology Linux calls cached and buffered memory used even if it could be understood as free for new applications KNX IP Each time the Configurator is opened the homeLYnk checks if the KNX bus is connected If not connected then an error message appears stating that Scripting visualization and other features will not work Do you want to switch to KNX IP instead KNX connection error pa ch KNXFTP is not connected Scripting visualization and other features will not work A Do you want to switch to KNX IP instead Yes Mo Selected connection and its status are visible in the right bottom corner CPU 1O 0 3
103. he registers with size specified for each type 4 8 3 Handle slave mb handleslave waits for an incoming indication from master and sends a reply when necessary 4 8 4 Get functions mb getcoils start count mb getdiscreteinputs start count mb getinputregisters start count mb getregisters start count gets one or many register coil input values from mapping from the start address returns all values on success returns nil error description on error exception code if applicable 4 8 5 Set functions mb setcoils start v1 v2 v3 H mb setdiscreteinputs start v1 v2 v3 mb setinputregisters start v1 v2 v3 mb setregisters start v1 v2 v3 sets values to register coil mapping from the start address returns true on success returns nil error description on error exception code if applicable 4 8 6 Callback functions mb setwritecoilcb fn mb setwriteregistercb fn sets a callback function for coil register write event AR1740 EdC February 2015 Page 109 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 callback should accept two parameters coil register address and value boolean or number for multiple writes callback is executed for each coil register separately use nil to remove a callback Note For more details about Modbus slave settings refer to application note document AN_016_homeLYnk_as_a_Modbus slave Page 110 2015 Schne
104. hneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 type v Returns the type of its only argument coded as a string The possible results of this function are nil a string not the value nil number string boolean table function thread and userdata Page 146 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 Script Examples 11 1 Binary Filter Create two 1 bit group addresses under Object tab where 1 1 1 input 1 1 2 output Create event based script and attach it to group 1 1 1 Script will run each time group 1 1 1 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 if value_1 true then do nothing elseif value_1 false then grp write 1 1 2 false end 11 2 Binary Gate with Bit Gate Create three 1 bit group addresses under Object tab where 1 1 1 input 1 1 2 gate 1 1 3 output Create event based script and attach it to group 1 1 1 Script will run each time group 1 1 1 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 input value_2 grp getvalue 1 1 2 gate if value_2 true then do nothing elseif value_2 false then grp write 1 1 3 value_1 output end Page 147 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 3 Gate with Byte
105. homeLYnk AR1740 EdC User Guide February 2015 homeLYnk User Guide e H OO o Y S H ei SC F IZ al ee ER DC 24V pa y d mg 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 See Updated for firmware 1 2 0 8 4 2014 Updated for firmware 1 2 1 15 5 2014 a Updated for firmware 1 3 0 1 3 2015 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Contents T ao a A 10 1 1 A A EE 10 1 2 Security FCa GU CS Ee 10 LS ODO Nao usa 10 1 4 Med A E E Pe e o e 10 1 5 Pate Mana E E 11 1 6 PON SO india 11 1 7 A o E 11 Z O E GUI EE 12 2 1 a o yq no O o A 13 2 2 PS TAU ee ug ee EE 14 2 3 Discover homeLYnk IP Address AAA 16 2 4 Sigk UC Urrea 18 2 5 homeLYnk for KNX EIB Network Configuration Management with ETS 19 2 6 homeLYnk for KNX EIB Network Configuration Management with ETS 20 27 homeLYnk for KNX EIB Network Configuration Management with ETab 21 2 8 KNX and IP ROUtEr Secundaria tucanes 22 2 9 Create Visualization for iPad PC c oooccccnonocccnonncncnnnnarinnonacinnonncncncnnarannonarccnonnnranonnarinnonanes 23 2 9 1 APO gie EE 23 2 9 2 Create Building Floor Structure and Add Objects to the Map 24 2 9 3 Add Objects to Newly Created Visualization Map 26 2 9 4 Launching Visualization on Smartphone Device iPod in this case 27 2 9 5 Launching vis on PC Tablet or Any Other Touch Device with Large Screen
106. ias Data type is taken from the database if not specified as third parameter Returns LUA boolean as the result grp response alias value datatype Similar to grp write Sends group response request to the given alias grp read alias Sends group read requests to the given alias NOTE This function returns immediately and cannot be used to return the result of read request Use event based script instead erp update alias value datatype Similar to grp write but does not send any value to KNX TP bus It only sends telegrams to KNX IP when KNX IP features are turned on Useful for objects that are used in visualization only 10 3 Returned object functions Objects received by using grp find alias or grp tag tags mode have the following functions attached to them Always check that the returned object was found otherwise calling these functions will result in an error See the example below object write value datatype Sends group write requests to object s group address Data type is taken from the database if not specified as second parameter Returns LUA boolean as the result object response value datatype Similar to object write Sends group response request to object s group address object read Sends group read requests to object s group address Page 127 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 NOTE This function returns immediately and cannot
107. ication note ANO01_homeLYnk integration using BACnet_v1 4 pdf E Building Operation WorkStation og on as E E GMEA Other user SESA207626 Username admin Password eeeee Domain Default Server localhost Remember me on this computer Log on Click here to learn more about Building Operation Copyright 2013 Schneider Electric Buildings AB All rights reserved This product includes functionality that is covered by patents and patents pending truxureWa re Please contact Schneider Electric for details Page 115 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 7 RS 232 Serial Line 7 1 Characteristics The RS 232 serial interface communication standard has been in use for many years It is one of the most widely used connections for serial data transmitting because it is simple and reliable The RS232 serial interface standard still retains its popularity and remains in widespread use It is still found on some computers and on many interfaces often being used for applications ranging from data acquisition to supply a serial data communications facility in general computer environments The long term and widespread use of the RS232 standard has meant that products are both cheap and freely available and in these days of new higher speed standards the reliable robust RS232 standard still has much to offer The interface is intended to operate over dista
108. ide in Smartphone Do not show this plan link in Smartphone Visualization Hide background Hide the icon background Display mode icon value how to display the plan link Icon Icon which will be shown in the visualization If only text is selected text parameters are selected Active state icon If icon is selected then the active plan icon 1s available Additional classes Create additional class which can be used in custom CSS file in order to modify particular group of graphical objects Font size Size of font Text style Text style bold italic underscore Custom font Font name Font color Font color Element size and position see Plan editor gt Object tab NOTE It is recommended to use the Layout for menu and plan link creation Time can be saved while adding it to different plans and later when making changes By adding it to different plans it would save time and be beneficial when changes are required Page 73 AR1740 EdC February 2015 Plan editor Object Text label Image Frame Gault 3 Link to Custom name Hide in Smartphone Hide background e Display mode Icon E Icon menu_home_4 svg we Active state icon menu_home_l svg Iw Additional classes Cancel Element position Element size 5 nia save and reload plan Cancel 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 6 Camera homeLYnk supports thi
109. ider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 2 9 2 Create Building Floor Structure and Add Objects to the Map Go to Configurator gt Vis structure Vis Structure allows creating all building levels and Levels visualizations plans Additionally it can create Sta BE a Add new level Layouts and Widgets for visualization plans To add new Level press button Main level usually is the project name additional levels can be added later Starting new project only Layouts and Widgets folders are visible Adding new level allows defining es eener mere cece ES a eT a specific Plan of flat Layouts and Widgets are See o FJ Overview PC Tablet Sma additional tools which are not mandatory for basic A FJ Meeting R PC Tablet visualization they can be defined and implemented in 2 FO F3 Garage PC Tablet Smar Trend Gra PC Tablet many other Plans E FJ Schedulers PC Tablet FJ Help PC Tablet d E Y E Y El E El Sla lslslassb d R 999999999 Second level If additional levels are needed press on E next to the main level Select an action Add second level Add plan Import Select Add second level and provide name and sort order Each level can be duplicated with sublevels and plans by pressing the duplicate icon D next to the level Page 24 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February
110. ider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 5 Port Forwarding 5 1 Introduction Port forwarding is used to get remote access to IP device on local network like homeLYnk Settings have to be done in the network router Manual of the particular router explains how to set port forwarding In case of issues contact of the technical support of the router provider may be needed 5 2 HTTP and HTTPS homeLYnk uses two possible ways of connection 5 2 1 HTTP Default one is through HTTP and port 80 HTTP is not encrypted and is not a secured way of connection This connection is safe to use on local network but not recommended to use for remote connection If this is selected then in the router port 80 has to be forwarded with the IP of the homeLYnk To connect to homeLYnk using port forwarding with HTTP connection following has to be entered in the web browser address bar HTTP 1P Port Where IP is an IP of the internet connection of the house This information can be found inside the router or the contact the internet provider support 5 2 2 HTTPS HTTPS is a secured and an encrypted connection and is strongly recommended to be used as a remote connection Using the secure connection port 443 has to be forwarded in the router To remotely connect through the secured HTTPS connection following has to be entered in the web browser address bar HTTPS 1P Port Where IP is an IP of the inte
111. ied even for numeric indices To traverse a table in numeric order use a numerical for or the ipairs function The behavior of next is undefined if during the traversal you assign any value to a non existent field in the table You may however modify the existing fields In particular you may clear existing fields pairs t Returns the three values the next function the table t and nil so that the construction will iterate over all key value pairs of table t for k v in pairs t do body end tonumber e base Tries to convert its argument to a number If the argument is already a number or a string convertible to a number then tonumber returns this number otherwise it returns nil An optional argument specifies the base to interpret the numeral The base may be any integer between 2 and 36 inclusive In bases above 10 the letter A in either upper or lower case represents 10 B represents 11 and so forth with Z representing 35 In base 10 the default the number can have a decimal part as well as an optional exponent part In other bases only unsigned integers are accepted tostring e Receives an argument of any type and converts it to a string in a reasonable format For complete control of how numbers are converted use string format If the metatable of e has a __tostring field then tostring calls the corresponding value with e as argument and uses the result of the call as its result Page 145 2015 Sc
112. if then statement Helpers consist of eleven main sub groups Conditionals If Else If If Then etc Loops and iterators Array Repeat Until etc Math Random value Ceiling Absolute value Round etc Objects KNX bus Get object value Group read Group write Update interval etc Storage Get data from storage Save data to storage Script control Get other script status enable or disable other scripts Page 88 AR1740 EdC Helpers WE Scheduled OS time and date Show code shortcuts 2 1 3 5 Conditionals 1 obtaining actual data a 3 5 Loops and iterators 2 local now os date t Group addresses v 864 Math F 0 Objects by name Ke 3 5 Objects KNX bus 5 local time Tags y ES Storage 6 day now wday 1 and 7 or now wday 1 monday to 8 5 Script control 7 hour now hour Storage v 8 minute now min A 1 8 S Alerts and logs 9 second now sec Scripts v 8 5 Time functions 10 B 65 Miscellaneous 11 HES Serial 12 grp update 4 4 1 time dt time Select topic 13 i B E Modbus SS 1 Basic Functions 15 grp update 1 7 98 now dt date String Manipulation 16 grp update 1 7 99 e2d 02d format now hour now min 17 Table Manipulation Mathematic al Functions Input and Output Facilities Oneratina System and Nate Time functions gt Search Logs Error log Enabled Save Save and close Close CHE Find Ctrl G Find next Shift Ctrl G Find previous Shift
113. ilter to work Filtering lists are updated at once changing policies requires restart Cane 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 3 3 System gt Services NTP client NTP client clock synchronization Network Time Protocol clock synchronization server 1 Servers 1 4 H 0 europe pool ntp org server 2 l europe pool ntp org Define the server from which date and time is obtained server 3 2 europe pool ntp org NOTE Reboot needed server 4 3 europe pool ntp org FTP server FTP server FTP server of homeLYnk can be accessed by enabling Service gt FTP Server Server status Disabled Port Server status Secure tunnel mode Username Port Port of the service Password External IF Username Login name ftp Passive mode min port Password Password length 4 20 symbol Passive mode max port Default password is ftp Leave password to blank to keep it unchanged External IP and passive mode Passive mode min port Minimum port for ports must be set when you want to access FTP behing NAT Make sure both FTP port and passive mode port range are forwarded on your router passive mode Passive mode max port Maximum port for passive mode System monitoring System monitoring Definition of system auto check and auto reboot check once in 2 minutes set daemon 120 reboot system when memory or cpu usage is too high check
114. ion Schedulers Trend logs 3 SE homeLyYnk office gi Overview Main Office Meeting Room Y Facility Management Garage Trend Graphs Sc hedulers Y Help Cancel User access settings x Disable password access Visualization pin code 1734 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 12 Scripting Scripting menu allows adding and managing various scripts depending on the type of the script Lua programming language is used to implement user scripts Most of the Lua language aspects are covered in the first edition of Programming in Lua which is freely available at http lua org pil Programming mem in Lua Last update Wed Jan 13 120733 UTC 2040 Page 82 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 12 1 Event based NOTE Data format in most cases data is stored and transferred between homeLYnk parts using hex encoded strings 2 bytes per 1 byte of data These are scripts that are executed when a group event occurs on the bus Usually used when real time response 1s required When pressing the arrow on the lower side of the Event based Resident or Scheduled buttons two options appear List view Sort scripts in list view Add new script Add new script to the list The following fields should be filled when adding a new script Script name The name of the script Group address tag Group addresses must be
115. isters address count Arguments address address of first register to read count number of registers to read max 125 Returned values 2byte values Exception codes 01 or 02 or 03 or 04 Example int1 int2 mb readregisters 1100 3 Value read from register address 1100 is returned into variable int1 Value read from register address 1101 is returned into variable int2 Value read from register address 1102 is returned into variable int3 FCHO4 Read Input Registers Name Read input registers Command value mb readinputregisters address count Arguments address address of first input register to read count number of input registers to read max 125 Returned values 2byte values Exception codes 01 or 02 or 03 or 04 Example value1 value2 value3 value4 mb readinputregisters 1015 4 Value read from input register address 1015 is returned into variable valuel Value read from input register address 1016 is returned into variable value2 Value read from input register address 1017 is returned into variable value3 Value read from input register address 1018 is returned into variable value4 FCHO5 Write Single Coil Name Write single bit Command value mb writebits 1000 value starting address value true or false 0 FCHO6 Write Single Register Name Write single register Command value mb writeregisters 1000 123 address value FCHOF Write Multiple Coils Name Write m
116. ity Features Secure protocol HTTPS IP Port Network security must be set up at the appropriate level homeLYnk should be part of a secure network with limited access In case of connection to the Internet network is strictly recommended to use VPN or HTTPS channel Security method is determined by the ability of other network elements firewall protection against virus and malware threats tis strongly recommended to change password regularly e g every 90 days The new password should be different and not similar to the previous one 1 3 Operation It is strictly recommended to store the files containing your backups in a safe place without access of unauthorized persons Entering the password should not be too simple it should contain small large letter numeric character at least 8 characters Incase you find a cyber security incidents or vulnerabilities please contact us through this page http www2 schneider electric com sites corporate en support cybersecurity contact form page 1 4 Maintenance Incase of problems or questions regarding operation of homeLYnk please contact your supplier or contact the Schneider Electric helpdesk in your country Please be aware of higher security risk in case of remote access to your local network Page 10 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 1 5 Patch Management See chapter 3 3 1 for steps how to upgrad
117. k Schneider select neighbour Y Language Engish 3 o 8 D 1 Leve j S tructu Vis WCS Scripting User access Modbus Alerts Logs Error log Help D gt oJ To add new Level press CH Add new level button Main level usually is the project name Additional levels can be added later El E El E El E E E Es gt gt gt ececececeececes 9999999998 SSRLLRSSBsSs e Import To import Level press button Geen Imported level can be added or replace the Linked objects D Clear Keep original plan File Choose File Trend_Graphs_ 04_10 58 tar Save Cancel Nesg ws Select neighbour X Language Engish 3 e 8 e 2 Se CO n d eve s i ization Vis graphics Scripting User access Modbus Alerts Logs Error log Help 5 acces lt lt al AS Second level is used in buildings with multiple floors gt gt gt gt gt 1 999999999 If you need additional levels press button next to the main level Select Add second level and give 1t a name and sort order Select an action Add second level Each level can be duplicated or imported EIS together with sublevels and plans by pressing the duplicate icon next to the level Import Page 60 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 8 3 Plan Plan can show either one room in a flat with cumulated functions or one function as lighting or heating of the whole flat o add Plans press bu
118. ktop e ANO17_ Addressable limits of the homeLYnk controller_v1 1 e ANO20 Philips Hue lamp controlled from homeLYnk e ANO24 Block functions for spaceLYnk and homeLYnk controller 12 1 2 Application Notes Availability All application note documents can be downloaded from Schneider Electric website It is possible to use search field on the top of Schneider Electric webpage in order to find the requested document Page 161 2015 Schneider Electric All rights reserved
119. leared It is necessary to be aware while logging large amount of data in time Excessive object logging degrades homeLYnk performance 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 2 10 Vis configuration PC Tablet sidebar Show docked Show as overlay Hide Enable sidebar with list of plans in visualization docked with auto hide option hidden PC Tablet view Align plans to top left no size limits Center plans limit size Center plans enable auto sizing Center horizontally auto size width NOTE Auto sizing works only in web browsers with Web Kit engine Chrome Safari and Firefox PC Tablet page transition No transition Flip X Flip Y Shrink Expand Slide Up Slide Down Slide Left Slide Right Slide Up Big Slide Down Big Slide Left Big Slide Right Big Selection of transition effect for page changing in visualization PC Tablet auto size upscaling Enable automatic re scaling for multiple screen resolutions PC Tablet background color Common background color for visualization PC Tablet background image Common background image for visualization Custom font Common font for visualization Use dark theme controls to match dark palettes visualizations Inversion of colors fonts and Dim inactive visualization after minutes Feature to save energy of battery powered devices Dim inactive visualization after minutes Feature to save energy
120. lel checking the logged data Page 86 AR1740 EdC February 2015 3 Export helpers Import helpers Restore helpers Backup scripts Restore scripts Print script listings The kh 9 show logs window Restore scripting backup Restore mode Remove existings scripts and import from backup Append keeping existings scripts Backup file Browse 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 12 8 General scripting description homeLYnk Schneider Neighbours Select neighbour y Language English Start page Utilities Objects Object logs Schedulers Trend loos Vis structure Visualization Vis graphics User access Modbus Alerts Logs Error log Help fr a ko 0 d v Event based Resident Scheduled User libraries Common functions Start up init script Block functions Tools Script name Group address tag Description Category Editor Active Duplic ate CO2 min max Dn y gt Sai e Climate values reset 0 0 10 Climate y gt i e Scenes control 0 0 17 y D i 3 Humidity min max 0 0 2 y D y 3 Temperature min max 0 0 3 y gt Se Help object for resident script 5 5 5 V D Se SONOS volume 6 6 5 y gt 175 e Temperature alert 7 1 11 Ve gt Se e Add new script There are five actions you can do with each script e Duplicate Duplicate the script with its source code e Editor Enter scripting editor to write specific code for the particul
121. livers devices for RS 485 termination polarization and separation Refer to following product numbers e TWD XCA ISO e TWD XCA T3J TWD XCA ISO and TWD XCA T3J devices can be used in order to ensure recommended RS 485 connection scheme see the picture below For more detailed information about TWD XCA ISO and TWD XCA T3J please refer to product documentation on Schneider Electric website Page 98 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Elements of the application No 4 Polarizationresistors o esti Maximum cable length without termination When cable is not terminated you must adjust the transmission rate to cable length Bit Time us 104 17 52 08 Max Cable Length Without 859 430 Termination m Page 99 2015 Schneider Electric All rights reserved homeLYnk User Guide 4 4 3 Modbus RTU Configuration Commands Create Modbus RTU object require luamodbus mb luamodbus rtu Open Modbus RTU connection 19200 baud rate even parity 8 data bits 1 stop bit half duplex mb open dev RS485 19200 E 8 1 H mb connect Page 100 Terminal name dev RS485 Supported Baud rates 300 bit s 600 bit s 1200 bit s 2400 bit s 4800 bit s 9600 bit s 19200 bit s 38400 bit s 57600 bit s 115200 bit s 230400 bit s Parity N None E Even O Odd Data bits and stop bits Data bits Number of data bits
122. llegal Data Address The data address received in the query is not an allowable address for the server or slave More specifically the combination of reference number and transfer length is invalid For a controller with 100 registers a request of offset 96 and a length of 5 will generate exception 02 Illegal Data Value The value contained in the query data field is not an allowable value for the server or slave This indicates a fault in the structure of the remainder of a complex request such as that the implied length is incorrect It specifically does NOT mean that a data item submitted for storage in a register has a value outside the expectation of the application program since the MODBUS protocol is unaware of the significance of any particular value of any particular register Device perform the requested action See Note 1 Acknowledge Specialized in conjunction with programming commands The server or slave has accepted the request and is processing it but long duration of time will be required to do so This response is returned to prevent a timeout error from occurring in the client or master The client or master can next issue a poll program complete message to determine if processing is completed Busy Rejected Specialized use in conjunction with programming commands EES The server of slave is engaged in processing a long duration program command The client or master should retransmit the message later
123. matically only if the data type has been specified in the Objects module Returns LUA nil when object cannot be found otherwise it returns LUA table with the following items e address object group address e updatetime latest update time in UNIX timestamp format Use LUA os date to convert to readable date formats When object data type has been specified in the Objects module the following fields are available e name unique object name e datatype object data type as specified by user e decoded set to true when decoded value is available e value decoded object value Page 126 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 erp tag tags mode Returns LUA table containing objects with the given tag Tags parameter can be either LUA table or a string Mode parameter can be either all return objects that have all of the given tags or any default returns objects that have any of the given tags You can use Returned object functions on the returned table grp alias alias Converts group address to object name or name to address Returns LUA ni when object cannot be found 10 2 Group Communication Functions These functions should only be used if it is required to access objects by group address directly it is recommended to use single or multiple object functions erp write alias value datatype Sends group write requests to the given al
124. me O o gJ LA N E RTF_PROTO1 RTF_PROTO2 RTF_PROTO3 RTF_BLACKHOLE RTF_BROADCAST RTF_CLONING RTF_PRCLONING RTF_DYNAMIC RTF_GATEWAY RTF_HOST RTF_LLINFO RTF_MODIFIED RTF_REJECT RTF_STATIC RTF_UP RTF_WASCLONED RTF_XRESOLVE AR1740 EdC February 2015 Gateway Network mask Flags 10 154 20 1 0 0 0 0 UG 255 255 255 0 U z 224 0 0 0 U Meaning Protocol specific routing flag 1 Protocol specific routing flag 2 Protocol specific routing flag 3 Just discard pkts during updates The route represents a broadcast address Generate new routes on use Protocol specified generate new routes on use Created dynamically by redirect Destination requires forwarding by intermediary Host entry net otherwise Valid protocol to link address translation Modified dynamically by redirect Host or net unreachable Manually added Route usable Route was generated as a result of cloning External daemon translates proto to link address 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 BACnet settings BACnet settings Server enabled Device ID 127001 Password mybacpwd Object priority Port 47808 O Object values are stored in Relinquish Default Set priority to non zero value to store values in Priority Array as well a Cena BACnet objects x BACnet objects Device name spaceLYnk_57 Download CSV Device ID 57 Object priority 16 Port 47808 Instance e
125. more repetitions of characters in the class Unlike these repetition items will always match the shortest possible sequence e a single character class followed by which matches O or 1 occurrence of a character in the class e n for n between 1 and 9 such item matches a substring equal to the n th captured string see below e bxy where x and y are two distinct characters such item matches strings that start with x end with y and where the x and y are balanced Henceforth if one reads the string from left to right counting 1 for an x and 1 for a y the ending y is the first y where the count reaches 0 For instance the item b matches expressions with balanced parentheses Pattern A pattern is a sequence of pattern items A at the beginning of a pattern anchors the match at the beginning of the subject string A S at the end of a pattern anchors the match at the end of the subject string At other positions and S have no special meaning and represent themselves Captures A pattern can contain sub patterns enclosed in parentheses they describe captures When a match succeeds the substrings of the subject string that match captures are stored captured for future use Captures are numbered according to their left parentheses For instance in the pattern a w s the part of the string matching a w s is stored as the first capture and therefore has number 1 the character mat
126. moved to any location of the a D S Max value 90 sl Icon blinds_80_4 svg SS plan Min value 90 Max value 99 Icon blinds_90_4 svg Y 3 Min value 100 S Max value 100 Icon blinds_100_4 svg 3 i a CO Add icon NOTE In the editing mode the object does not work When all the necessary objects are added press Save and reload floor plan button so that the objects start functioning Each added object can be edited while clicking on Apply it in the Editing mode Press button after each change Each object can be duplicated via pressing EE button on the left side cancel button will set the object parameters to default settings Page 71 2015 Schneider Electric All rights reserved homeLYnk User Guide Element position Can be added manually or by drag and drop of object for X and Y axis position on the plan Element size Can be added manually or by dragging vertical horizontal strip o f the object Object size can be reset to default size by pressing reset icon Aspect ratio of object can be locked by pressing O lock icon Page 72 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 5 Link In order to make the visualization more convenient there are plan links integrated Special icons on the map can be added which would act as a link to other plans Link to Select plan link Custom name Name for the link H
127. n It provides all its functions inside the table Most functions in the table library assume that the table represents an array or a list For these functions when we talk about the length of a table we mean the result of the length operator table concat table sep i OI Given an array where all elements are strings or numbers returns table i sep table i 1 sep table j The default value for sep is the empty string the default for i is 1 and the default for j is the length of the table If is greater than j it returns the empty string Page 142 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 table insert table pos value Inserts element value at position pos in table shifting up other elements to open space if necessary The default value for pos is n 1 where n is the length of the table so that a call table insert t x inserts x at the end of table t table maxn table Returns the largest positive numerical index of the given table or zero if the table has no positive numerical indices To do its job this function does a linear traversal of the whole table table remove table pos Removes from table the element at position pos shifting down other elements to close the space if necessary Returns the value of the removed element The default value for pos is n where n is the length of the table so that a call table remove t removes the last elem
128. n so the frame starts functioning NOTE e Some web pages have java script which prevent from using frame if this is implemented the webpage will open in full screen rather in the frame e Itis recommended to stretch the frame to maximum width if Scheduler or Trend is used Recommended minimum width is 1024 e Frame is only visible under PC Tablet Visualization e Do not allow Scheduler or Trend to be viewed from Smartphone visualization Settings are available in Vis structure under dedicated plan N UR TOP STORI Plan editor Image Source Url Frame size Custom name Url Frame Gauge Camera AR1740 EdC February 2015 htto m euranews com en 204 Hide in Smartphone Additional classes Element position Element size 755 AR 264 save and reload plan E curonews S E s Tw S Wall Street today LI ee targets Germany 65th Berlinale kicks off Greece Peaceful anti austerity rally ir Athens attracts thous Next stop Moscow Merk and Hollande ti present peace plan for Ukrain in Russia Ah 640 Apply 34 640 4 lt gt Fan hal Cancel 3 Cancel homeLYnk AR1740 EdC User Guide February 2015 3 10 Vis graphics This tab is split into three sections Icons where all object icons are located Images Backgrounds for all the locally stored pictures and Edit custom CSS to create or edit
129. nces of up to 15 meter it is based on one Master one Slave rule Application Example e Connection to simple devices or other bus sub systems e Audio video IR system integration 7 2 Configuration Commands Open connection require serial port serial open dev RS232 baudrate 9600 Write to port port write test data Blocking read script will block until 10 characters are read data port read 10 Timeout read script will wait for 10 characters for 20 seconds data port read 10 20 Close serial port port close Page 116 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 NOTE RS 485 serial line is controlled in the same way using the same Configuration Commands as mentioned above The only diffetend is in the serial open command port serial open dev RS485 baudrate 9600 NOTE For more details about RS 232 communication please refer to application note ANO010_RS232 control with homeLYnk_v1 0 pdf Page 117 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 8 USB 2 0 8 1 Characteristics e USB 2 0 provides a bandwidth of 480 Mbit s corresponding to an effective image data rate of 40 MB s e Integrated voltage supply 5 VDC for devices in the 4 pole cable Devices complying with the USB specification may consume a total of 500 mA from the bus Devices with a power of up to 2 5 W can the
130. of battery powered devices Dimming level Brightness level of dimmed screen Show alerts in PC Tablet After triggering new alerts it will appear in PC Tablet visualization Page 34 Vis configuration PC Tablet sidebar PC Tablet view PC Tablet page transition PC Tablet auto size upscaling PC Tablet background color PC Tablet background image Custom font Use dark theme Enable swipe gesture Dim inactive visualization after Dimming level Show alerts in PC Tablet The page at 10 154 20 25 says Alert temperature is too high 26 C AR1740 EdC February 2015 Show docked Center plans enable auto sizing Mo transition C SE_spacelynk_4 jpa Verdana 6 Minutes dn wr 80 w OK Cancel 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 3 System 3 3 1 System gt System Allows managing router functionality on KNX EIB homeLYnk as well as access control management and firmware upgrade KNX connection See chapter 3 3 2 for details Admin access Password settings for administrator account Username is admin by default The login and password configuration for User access is located in main menu Remote services For enabling disabling remote access of homeLYnk for service purposes Page 35 AR1740 EdC February 2015 3 Remote services Admin access Login Password Repeat password i Remote services Service status Enabl
131. ogged Maximum value is 5000 Log size Count of logs Maximum value is 5000 Error log size Count of errors logged Maximum value is 5000 Enable block editor Enabling disabling function block editor in Scripting Code editor tab size Pressing TAB in scripting editor results in insertion of defined count of spaces Page 33 AR1740 EdC February 2015 Restore Backup file Choose File No file chosen Warning maximum backup size is 16MB Current database scripts and visualization will be deleted Device will reboot to complete system restare Cancel General configuration Interface language English List items per page 50 Automatic address range start 1 1 1 Discover new objects No bus sniffer disabled Object log size 1000 Default log policy Log only selected objects Alert log size 5000 Log size 5000 4h 4 4 4 4 A Error lag size 5000 Enable Block editor Code editor tab size d OO If log size is changed to a smaller value excess logs will be deleted on next auto clean up every 10 minutes Log policy only affects new objects current per object log settings are kept unchanged Warning excessive object logging degrades performance NOTE homeLYnk reboot is required when changing List items per page or Language parameter Clear the browser cache homeLYnk keeps the log objects above the limit for 15 minutes after the time elapse all records above the limit will be c
132. onductor Maximum Length of Bus 1 000 m 3 280 ft at 19 200 bit s with the Telemecanique TSX CSA cable Maximum Number of 32 1 UL devices i e 31 slaves Devices without repeater Maximum Length of Tap e 20 m 65 ft for one tap link Links e a total of 40 m 131 ft for all tap links available on the bus Common Ground Wires In order to keep the voltage between drivers and receivers within the allowed range 7 V to 12 V an additional third wire in 2 wire systems is required This wire will be used as common circuit and must therefore be directly connected to protective ground preferably at one point only for the entire bus As grounding point for the entire bus you should choose the master device or its tap CAUTION No terminal for cable shield For longer cable in harsh environment we recommend you to place additional shield clamp close to the controller in order to drain EMC disturbances CAUTION Earthed connectors from USB RS232 LAN and Modbus are interconnected Earth leakage currents may harm the operation of the controller Maximum Number of Devices without Repeater An RS 485 network can principally have a maximum load of 32 devices Page 97 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 If you want to connect more than 32 devices to a standard RS 485 driver then integrate a repeater in your network Biasing the Network When there is no data activity on th
133. or Repeat background image Fixed primary background 2015 Schneider Electric All rights reserved SE homeLYnk office Meeting Room 1024 5 768 LGE Overview layout Show Hide SE_spacelynk_frame jpg FFFFFF Xv XK vw Save AR1740 EdC February 2015 9 El E E El El E E E E D g ddd E lt ccececceis Cancel 9999999998 homeLYnk User Guide visualization Repeat background image Either to show the image once or repeat it and fill the whole plan Fixed primary background Static primary picture in Parallax projection Each Plan can be duplicated together with all the components on a plan by pressing the duplicate icon next to the plan GI NOTE Content of the created Plan should be defined under the Visualization tab Empty plan no objects will be not visible in visualization 3 8 4 Layout Layout is advanced background for plans Any object from the editor can be placed on the layout which later can be attached to one or many plans All objects from the layout will be visible on the plan but all the objects on the plan will be above the objects from the layout To add Layout press button next to a Layout Add new layout folder or button Each Layout can be duplicated together with all the components by pressing the duplicate icon next to the Layout DI NOTE Content of this layout should be defined under the Visualization tab Page 62
134. or X vw Scenes 5 Show value Blind right e background Office A RE E fl dr M Show control Inline in PC Table LECS t INSAN ation Add to plan Cance Element position Element size 3 ic i j e E 4 Unlock current plan for editing Vis configuration D H E Ea i d Both side bars can be minimized by pressing icon making the plan more visible especially on small displays Page 67 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 1 Structure AR1740 EdC February 2015 To navigate between the plans layouts and widgets using the navigation tree in the structured view In the editing mode the following additional parameters are available e Size of plans layouts or widgets e Source picture background color Plan x Parent SE homeLYnk office Name Meeting Room Plan size 1024 5 768 B Layout Overview layout v PC Tablet visualization Show v Smartphone visualization Hide v Pin code Primary background image SE_spacelynk_frame jpg xX lv Secondary background image Xiv Background color FFFFFF XxX Smartphone background color X v Repeat background image Fixed primary background Save Cancel NOTE Size of the plan should be positioned correctly against the background Widget size has to be always smaller than the plan on which it is placed Always use the component position to align the objects Predefined size of the plan iPad
135. per 1 byte of data Event based scripting Event based scripting can be used to implement custom logic for group address events User defined function is executed when a group write event occurs for given group address Event information is stored in global event variable Variable contents e dst string decoded destination group address e g 1 1 4 e src string decoded source individual address e g 1 1 2 e type string type of event either groupwrite groupresponse or groupread e datahex string data as a hex encoded string which can be converted using data type functions event getvalue function can be used to get the event value if the event is bound to a known object Note event variable is available only in Event based functions not in Resident and Scheduled Resident scripts Resident scripts are executed infinite amount of times Scripts are put into inactive state after each call and are resumed after delay timer expires Note even though resident scripts are executed in parallel they should not have infinite loops or it will not be possible to reload scripts after editing Scheduled scripts Scheduled scripts are executed when the system time matches the specified script start time Scheduled script is run only once after each timer call Page 92 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 Modbus RTU and Modbus
136. pt 1s run each time after the system has restarted power up reboot in the SW or via hardware RESET push button Page 85 AR1740 EdC February 2015 User library Script name YahooWeatherForecast Keep source w Auto load library s i Required if library provides block functions Description Add new library gt Export libraries 4 Restore add libraries Helpers MA ES Conditionals fx 365 Loops and iterators 365 Math E gt Objects KNX bus 4 ES Storage 365 Script control ES Alerts and logs gt Time functions 365 Miscellaneous HES Serial aE Modbus Start up init script O 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 12 7 Tools Export helpers Export scripting helpers save with the right mouse click Import helpers Import scripting helpers Restore helpers Restore default scripting helpers Backup user scripts Backup all scripts in gz file NOTE Script backup does not backup user libraries those have to be backed up separately Restore scripts Restore script from archive gz file with two possibilities e Remove existing scripts and import from backup e Append keeping existing s scripts Print script listings Shows all scripts with codes in list format sorted by Categories Show logs window All log data are listed here it is a duplicated window Configuration Logs It allows debugging a script and in paral
137. r duplicated duplicated object will be displayed with predefined spacing 3 9 3 Plan editor Plan editor is located on the right side of the visualization map Editing mode can be accessed by pressing Unlock current plan for editing Plan editor gt gt Text label Image Frame Gauge Source url Window size 640 se 480 Pa Wr Custom name Icon camera svg E Auto open window Hide background w Additional classes Add to plan Cancel Element position lt gt lt gt 3 Eb Element size Unlock current plan for editing Page 69 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 4 Object Every control or monitoring objects are configured under this tab Different data types have different parameters Object visualization parameters can be changed g via pressing icon It refers to Vis parameter in the Objects tab Main object List of existing group addresses on KNX EIB bus the configuration in the Objects tab In order to speed ones available for up the selection it is recommended to start writing group address Status object List of the status objects on KNX EIB bus Control object can also be used as status Custom name Name for the object Custom name is important for Smartphone Visualization if the name is left blank the group address name is used instead Read only The object is read only no write control permis
138. rd party IP web camera integration into its visualization NOTE Only cameras which support HTTP MJPEG streaming in web browser can be visualised Source url Source address of the video stream Window size Width and height for displaying the graph Custom name Name for the object Auto open window Automatically open video window when plan is open Additional classes Create additional class which can be used in custom CSS file in order to modify particular group of graphical objects Hide background Hide icon background Sort order Order cameras for touch visualization NOTE If IP camera requires user name and password enter the url accordingly http USER PASSWORD IP Feel free to change icon or its label for your camera homeLYnk is only a redirecting stream from camera to the browser If the stream does not work it is a web browser issue not the homeLYnk If it is a cameras issue please check if the video stream is available in the browser If the camera is available from external the IP of the camera need to be port forwarded trough the router While adding the external camera IP with the correct port has to be used IP port If the local IP is used then the camera will not be available externally Contact Technical support of the camera manufacturer if the direct video stream is hidden by the manufacturer Page 74 Plan editor ge Text label Source url Window si
139. receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 if value_1 true and value_2 true then grp write 1 1 3 true else grp write 1 1 3 false end 11 6 Or Port 5 in 2 Out Create group addresses under Object tab where 1 1 1 value 1 1bit 1 1 2 value 2 1bit 1 1 3 value 3 1bit 1 1 4 value 4 1bit 1 1 5 value 5 1bit 1 1 6 bit_output 1bit 1 1 7 byte_output 1byte Add tag OR2 to group addresses value1 value2 value3 value4 and value 5 Create event based script and attach it to Tag OR2 Script will run each time groups 1 1 1 1 1 2 1 1 3 1 1 4 1 1 5 receive telegram Add the following code to the Script editor Page 149 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 value_3 grp getvalue 1 1 3 value_4 grp getvalue 1 1 4 value_5 grp getvalue 1 1 5 if value_1 true or value_2 true or value_3 true or value_4 true or value_5 true then grp write 1 1 6 true bit to 1 grp write 1 1 7 255 byte to 255 else grp write 1 1 6 false bit to O grp write 1 1 7 0 byte to O end 11 7 And Port 5 in 2 Out Create group addresses under Object tab where 1 1 1 value 1 1bit 1 1 2 value 2 1bit 1 1 3 value 3 1bit 1 1 4 value 4 1bit 1 1 5 value 5 1bi
140. refore be supplied via the bus e USB cable must only be 4 5 m long at the maximum e Data transmission is possible in both directions Application Example USB interface can be used for extending memory capacity via attaching USB flash drive 8 2 Configuration Commands io readfile file Read whole file at once Returns file contents as a string on success or nil on error io writefile file data Writes given data to a file Data can be either a value convertible to string or a table of such values When data is a table then each table item is terminated by a new line character Return Boolean as write result when file can be open for writing or nil when file cannot be accessed NOTE USB flash drive supports FAT FAT32 and NTFS file system Maximum size of Flash drive is 32GB 8 3 Send and receive SMS messages via attaching USB GSM adapter e Use Huawei E173 modem e The modem has to be plugged into USB port of homeLYnk and it starts operating immediately e Specific functions should be added into user script library with PIN code setting and telephone number white list which will be able to receive and send SMS messages Page 118 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 8 3 1 Command syntax In order to change object value using sms or read value of object by SMS request you have to send sms in the format described below Write to bus e SMS command format W ALIA
141. responding Master FunctionS ssssssseessssresereeresrreseseee 104 4 7 Modb sMaster tee el 108 4 8 Modbus slave TUMCTIONS iS 109 4 8 1 RECEIVE Cala ront master A evenness 109 4 8 2 Set modbus mapping of slave device vivia 109 4 8 3 Handle MAMA A isos 109 4 8 4 COLITA CUNAS da ati 109 4 8 5 O 109 4 8 6 Callback Incucai 109 SB ROM FOrWardINe ji decos 111 5 1 Jet e tel Led e Noia 111 5 2 Pean EERE S OOOO E UE E E tenet nanans at oetdualascens teen crnecesnucne 111 5 2 1 BERN EE 111 5 2 2 KN 111 SE EE 112 6 1 Caracter 112 6 2 gelaut RE Tele DEEN 112 6 3 ODICCE OX DOM EE 112 6 4 BACNEet CONMPULATION tl iicioa 113 6 4 1 Bai lege 113 6 4 2 YAN Glas 65 21 6 Soe Ren enema A ee ree 113 6 5 BACnet Standardized Device broftle 114 6 5 1 List all BACnet Interoperability Building Blocks BIBBs Supported eee 114 6 5 2 BACnet Object Types SUD DONTE unir ide 114 6 5 3 Data lnk Layer E e Age stas cla rada 114 6 6 Building Operation W OrkstatiOn suit 115 7 EE RE ita 116 Page 6 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 7 1 EIERE ee 116 7 2 COMME UPATION Command Sissa e 116 8 USB 220 EE 118 8 1 Re Lee 118 8 2 COMMEUPALION eu e 118 8 3 Send and receive SMS messages via attaching USB GSM adapter cccsssccceesseceeeeeeees 118 8 3 1 COMMAND 119 9 Block et En UE 120 9 1 INTO ducto iaa 120 9 2 Block programming Interface EE 120 9 3 Ba al 122 9 3 1 AND OFtWO KNX
142. rg 1 string t2 arg 1 string t1 arg 1 string t2 arg 1 string t1 arg 1 string t2 arg 1 string t1 arg 1 string 2 arg 1 string t1 arg 1 string 2 arg 2 1 string t1 arg 2 1 string 2 arg 2 1 string t1 arg 2 1 string t2 arg 2 1 string t1 arg 2 1 string 2 arg 2 1 strina t1 ara 2 gt gt Pa N N MM MM MM MM MM MM number 1080 8 number 381 4 number 1080 7 number 379 4 number 1080 number 377 1 number 1080 3 number 377 1 number 1079 5 number 375 6 number 1080 5 number 377 6 number 1076 9 number 364 9 number 1077 6 number 366 2 number 1081 2 number 385 3 number 1082 2 number 383 8 number 1082 6 number 384 3 Vis graphics Scripting User access Modbus Alerts S Displaying logs 1 50 of 5000 Converts variables to human readable form and stores them Example log function accepts Lua nil boolean number and table up to 5 nested levels type variables a key1 value1 key2 2 b test c 123 45 logs all passed variables log a b c Page 91 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 15 Error Log Utilities Objects Object logs Schedulers Trend logs Vis structure Visualization Vis graphics User access Modbus Alerts Logs Error time Script name Error description 05
143. rnet connection of the house This information can be found inside the router or the contact the internet provider support NOTE Apple devices with OS7 0 and above using the remote connection must forward port 1 for correct status feedback in visualization For port 80 it would be feedback port 81 If using a custom port A you need to forward port A to homeLYnk s port 80 and port A 1 to homeLYnk s port 81 For example if user wants remote access to visualization and uses port 1234 to access his HL he must forward port 1234 to homeLYnk s port 80 port 1235 to homeLYnk s port 81 NOTE If you want to use different port number than default ports 80 and 443 you can set the additional ports in Configurator gt Utilities gt System gt Services gt HTTP server Page 111 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 6 BACnet 6 1 Characteristics BACnet is a communication protocol for Building Automation and Control Networks lt is an ASHRAE American Society of Heating Refrigerating and Air Conditioning Engineers ANSI American National Standards Institute and ISO International Organization for Standardization protocol homeLYnk has been certified by BACnet Testing Laboratories BTL as BACnet Application Specific Controller B ASC BACnet is designed to allow communication of building automation and control systems for application such as heating ventilation air
144. rp getvalue 1 1 3 if value_1 true then storage set Value_Stepper_1 0 grp write 1 1 4 0 end 11 19 On Delay button set to update only internal value_1 grp getvalue 1 1 1 if value_1 true then os sleep 3 Delay time grp write 1 1 1 true end 11 20 Average value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 Average value_1 value 2 Average Average 2 value_3 grp getvalue 1 1 3 grp write 1 1 3 Average 11 21 Off Delay value_1 grp getvalue 1 1 1 if value_1 true then os sleep 3 Delay time grp write 1 1 1 false end 11 22 Stare Case Timer with variable time object value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 Variable value if value_1 true then os sleep value_2 grp write 1 1 1 false end AR1740 EdC February 2015 Page 157 2015 Schneider Electric All rights reserved homeLYnk User Guide 11 23 Value Memory write to storage value_1 grp getvalue 1 1 1 storage set Storage Value Memory_1 value_1 11 24 Value Memory get from storage Value Memory_1 storage get Storage Value Memory_1 if not Value_Memory_1 then do nothing else grp write 1 1 1 Value_Memory_1 end 11 25 Multiplexer 1 in 3 out NOTE Object type needs to be the same value_1 grp getvalue 1 1 1 grp write 1 1 2 Value_1 grp write 1 1 3 Value_1 grp write 1 1 4 Value_1 11 26 Round Function
145. ry 2015 Smartphone Icon Default icon for Smartphone if differ from PC tablet one On icon On state icon for binary type objects Off icon Off state icon for binary type objects Additional classes Create additional class which can be used in custom CSS file in order to modify particular group of graphical objects Font size For value display text style can be defined Text styles Bold Italic Underscore option Custom font selection from installed fonts Font size Size of selected font Show control If enabled any control button graphics will change from a symbol to a switch M visible only in PC Tablet Visualization For value type objects additional button appears while specifying parameters Additional icons Additional icons Different icons for different object values can be e ie il qe Pre SIS defined in the window Min value 10 Max value 20 S Icon blinds_10_4 svg 3 Min value 20 Max value 30 Icon blinds_20_4 svg x 3 Min value 30 Max value 40 Icon blinds_30_4 svg v For value disp lay text style can be defined Min value 40 ss Max value 50 s Icon blinds_40_4 svg v o Min value 50 Max value 60 S Icon blinds_50_4 svg v After defining the object parameters press Add to Min value D Bas vaue D con BEE 6 plan button and a newly created object appears Min value 70 2 Max value 80 A Icon blinds_70_4 5vg ES The object can be
146. s Alerts Logs Event bas ed Resident Scheduled User libraries Common functions Start up init script Block functions Oo e SG o Script name Group address tag A Description Category Editor Actwe Dupl CO2 min max 0 01 3 gt q g Climate values reset 0 0 10 Up a R Scenes control OMT y E Es Se 8 Humidity min max Don Ya S q 8 Temperature min max ODS H De gt Sa 3 new script 10 10 10 Ud E Help object for resident script 5 5 5 Ho gt q g SONOS volume Ge Warp q g Blocks are sorted by categories on the left side Each block is puzzle based and can be put only in appropriate location other block Event new script SE VE Close Objects 18 value r HMC SURE Storage Script control Miscellaneous Logic Loops Math Text Lists Variables WI Custom functions Page 120 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Hole in the right side of the block denotes input of the block Left side segment of the block denotes output of the block See example below e Block set var1 to has input on the right side where it reads value to be written into variable var e Block Get current value of object 0 0 1 has output on the left side where the current value of object 0 0 1 is returned e When the blocks are given together variable var1 is set to current value of object 0 0 1 set NE
147. s l You can find Modbus devices connected to homeLYnk over Modbus RTU using scan function This function is placed here Configurator gt Modbus gt RTU scan NOTE Devices which are marked as RTU scan No cannot be discovered using automatic scan function Page 94 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 4 3 1 New profile definition If your Modbus device profile is not present in the list of ready to use profiles in homeLYnk Configurator you can define your own profile Modbus device profiles are distributed in json files You can use common text editor e g Notepad in order to create and edit your profile While saving the file set extention to json The following example shows the structure of new device profile manufacturer Schneider Electric description Example device mapping name Output 1 bus _datatype bool type coil address O writable 1 nm name Input 1 bus_datatype float16 type inputregister address O value multiplier 0 001 units V Each line of mapping table of the json file contains mapping information of one Modbus register coil input or output All the possible mapping settings are listed in the table below Y Bus_datatype KNX object data type key from dt table e g float32 String Yes Number Type Modbus register type possible v
148. s ticked the listed groups are filtered not written from IP and thus virtual SRC policy No filter Accept selected individual addresses Drop selected individual addresses Policy to apply to the list of source addresses Ind address list List of individual or group addresses One address per line Use for example 1 1 or 1 1 to filter all addresses in the given line DST group policy Destination group filter accepts or drops the received telegrams belonging to one group as 1 2 3 or subgroup as 1 2 All outgoing telegrams are not filtered DST group filter No filter Accept selected individual addresses Drop selected individual addresses Policy to apply to the list of the destination group addresses Group address list List of group addresses One address per line Use e g 1 1 to filter all addresses in the given line NOTE KNX IP features should be enabled for filters to work This applies to the incoming telegrams only Page 43 AR1740 EdC February 2015 KNX connection x General IP gt TP filter TP gt IP filter Apply filter to virtual objects SRC policy No filter Ind address list One address range per line Use e g 1 1 to filter all addresses in the given line DST group policy No filter Group address list One address range per line Use e g 1 1 to filter all addresses in the given line Note KNX IP features are required for f
149. set All other characters in set represent themselves For example w_ or _ w represents all alphanumeric characters plus the underscore 0 7 represents the octal digits and 0 7 1 represents the octal digits plus the lowercase letters plus the character e The interaction between ranges and classes are not defined Therefore patterns like a z or a have no meaning e Aset represents the complement of set where set is interpreted as above For all classes represented by single letters a c etc the corresponding uppercase letter represents the complement of the class For instance S represents all non space characters Page 136 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 The definitions of letter space and other character groups depend on the current locale In particular the class a z may not be equivalent to l Pattern Item A pattern item can be e a single character class which matches any single character in the class e a single character class followed by which matches O or more repetitions of characters in the class These repetition items will always match the longest possible sequence e a single character class followed by which matches 1 or more repetitions of characters in the class These repetition items will always match the longest possible sequence e a single character class followed by which also matches O or
150. side By clicking on the interface the configuration window appears Protocol Specific protocol used for addressing e None No protocol is used e Static IP Static IP address By default 192 168 0 10 e DHCP Use DHCP protocol to get IP configuration Current IP The IP address got from DHCP server This field appears only if the IP address is given otherwise it is hidden IP address By default 192 168 0 10 Network mask Network mask By default is 255 255 255 0 24 Gateway IP Gateway IP address DNS server I Primary DNS server IP address DNS server 2 Secondary DNS server IP address Mtu Maximum transmission unit the largest size of the packet which could be passed in the communication protocol Default 1500 Ethernet interface data put through graph On the main window of the Ethernet tab if you click on the ulila button a new window 1s opened It draws a real time graph of the traffic flow passing the interface both In and Out There is a possibility to switch the units of measurement bite s or Byte s and graph Auto Scale follow or Up Page 37 Interfaces Name Mac address Mtu TX Bytes etho 00 00 54 PF 538 F3 1500 20 MB Interface eth Protocol Static IP IP address 10 154 20 25 Network mask 255 255 255 0 Gateway IP 10 154 20 1 DNS server 1 10 154 20 1 DNS server A MTU Network usage for interface ethO In 15 Kbps Switch to bytes s
151. sion Hide in Smartphone Do not show this object in the Smartphone Visualization Hide background Hide icon background Send fixed value Allows sending specific value to the bus each time the object is pressed No bus write Value will not be written in to KNX bus Useful for triggering scripts with bus load limitation Pin code Via adding a pin you can protect the object Each time the value is changed the pin code will be requested to enter Widget Widget can be attached to a button which needs to be created before Widget cannot be tested in the editor mode but only in PC Tablet Visualization Display mode icon and value icon value How to display the object Page 70 Plan editor Main object Status object Custom name Read only Hide in Smartphone Hide background Send fixed value No bus write Pin code Widget Display mode Default icon Smartphone icon Additional classes Show control Additional icons 3 Element position Element size save and reload plan Text label AR1740 EdC February 2015 d Image Frame Gaull 3 2 2 2 Electrical Inst se Ww Lise main object In PC Tablet Smartphone No widget a Icon ei standard _button S1_defz d yr Inline in PC Tablet Apply Cancel 300 339 AA lt gt gt 50 50 sia Cancel 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide Februa
152. st group on interface eth0 IPv4 with address May 29 13 02 46 spaceLYnk daemon info avahi daemon 8 18 Loading service file etc avahi services http service perfor I ed May 29 13 02 46 spaceLYnk daemon warn avahi daemon 8 18 WARNING No NSS support for mDNS detected consider installing nss oe Page 46 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Running processes d o init kthreadd ksoftirad 0 kworker 0 0 kworker 0 0H kworker u 0 kworker u 0H rcu_preempt rcu_bh rcu_sched watchdog 0 khelper kdevtmpfs kworker u 1 bdi default kintegrityd WD OO Y DO LN A D N Fa GGGGGGGGGGGGGG GG Page 47 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 4 Objects List of KNX network objects appear in the Objects menu The object is listed accordingly 1 Captured by sniffing the bus for telegrams from unknown group addresses if enabled in Utilities 2 Added manually 3 Importing ESF file in Utilities Objects are sorted with the following parameters Group address Object name IP gt TP filter TP gt IP filter Event script Data type Current value Log Export Tags Updated at Set value Vis parameters and Custom values homeLYnk Schneider Neighbours Select neighbour y Language English Y Start page UAT Objects Modos Object filter Group address Object name Even
153. stom name in visualization Hide min max step buttons Hide buttons in visualization for touch screen enabled devices Line thickness Thickness of circular slider control line 1 50 Size Size of circular slider 150 500 pixels Page 51 AR1740 EdC February 2015 Object visualization parameters Object Setpoint heating 1 0 1 Pa WI Decimal places Contral type Circular slider Minimum value 0 Maximum value 30 Step 1 Slider color x Background color FEEEEEE Round line cap w Hide title Hide min max step buttons D Line thickness Fan WI a DW Size In Show control mode Cancel e Living 22 Living 22 Setpoint heating 22 C Pe 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 4 5 Custom Text Value In the object list by pressing the Le button custom text can be added to the object values Custom text values can be set only to Boolean or integer values Default text Text displayed if value is not defined Object value Add custom value select Object value and define Display text Sample of displayed value from above settings in visualization 3 4 6 Object Control Bar Add new object Manually add new objects to the list Auto update enabled Specifies either the object list is updated automatically or not Clear Clear the list of filtered group addresses Mass edit For mass edi
154. system SHOST if cpu usage user gt 90 for 15 cycles then exec sbinfreboot if memory usage gt 90 for 5 cycles then exec sbin reboot knx backend check process eibd with pidfile var run eibd start program etc init d eibd restart stop program etc init d eibd stop if 5 restarts within 5 cycles then timeout knx monitor check process groupmonitor with pidfile var run gs groupmonitor pid start program etc init d genohm scada restart stop program etc init d genohm scada stop if 5 restarts within 5 cycles then timeout Page 44 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 3 4 System gt Status System status System information 1s shown is the following tabs General Information about hardware provided by kernel Memory usage Current memory used by the system Partitions List of partitions available in the system Serial ports List of serial ports available in the system Network status Page 45 AR1740 EdC February 2015 System status General Memory usage Partitions Serial ports Parameter Value CPU model ARM926EJ 5 rev 5 v51 CPU BogoMips 226 09 Linux kernel version 3 10 30 System uptime 5d 22h 27m Load averages 0 09 0 19 0 30 Network status Name Mac address IP address e Mtu TX Bytes eth0 00 00 54 FF 88 F3 10 154 20 26 1500 53 MB Network usage for interface ethO In 30 Kbps Switch to bytes s Out 9 Kbps
155. t 1 1 6 bit_output 1bit 1 1 7 byte_output 1byte Add tag AND2 to group addresses value1 value2 value3 value4 and value 5 Create event based script and attach it to Tag AND2 Script will run each time groups 1 1 1 1 1 2 1 1 3 1 1 4 1 1 5 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 value_3 grp getvalue 1 1 3 value_4 grp getvalue 1 1 4 value_5 grp getvalue 1 1 5 if value_1 true and value_2 true and value_3 true and value_4 true and value_5 true then grp write 1 1 6 true bit to 1 grp write 1 1 7 255 byte to 255 else grp write 1 1 6 false bit to O grp write 1 1 7 0 byte to O end Page 150 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 11 8 Telegram Transformer 0 1 bit to 0 255 byte Create two group addresses under Object tab where 1 1 1 input 1 bit 1 1 2 output 1 byte Create event based script and attach it to group 1 1 1 Script will run each time group 1 1 1 receive telegram Add the following code to the Script editor value_1 grp getvalue 1 1 1 if value_1 true then bit value in grp write 1 1 2 255 byte value out else grp write 1 1 2 0 byte value out end 11 9 Compare Value value_1 grp getvalue 1 1 1 value_2 grp getvalue 1 1 2 if value_1 value_2 then grp write
156. t after reset is complete Are you sure you want to proceed Yes No 2015 Schneider Electric All rights reserved A homeLYnk User Guide 3 2 5 Date and time Network time protocol NTP is implemented Along with the internet connection homeLYnk will automatically update time from servers defined in Utilities System Services NTP client 0 europe pool ntp org l europe pool ntp org 2 europe pool ntp org 3 europe pool ntp org NOTE It is important to select the correct time zone If there is no internet connection click on Get from the system to adopt time from the PC NOTE Without power homeLYnk will maintain time and date settings only for a limited period of time app 5 minutes 3 2 6 Install updates For partial updates or adding of pre fabricated solutions Install homeLYnk update file Imup homeLYnk will reboot after the successful update 3 2 7 Backup Backup all the objects trends logs scripts icons images backgrounds visualization and KNX filter table to the backup dd mm yyyy hh mm tar gz file actual homeL Ynk time and date is used when the backup is generated Created backup file is placed into the browser Downloads folder File can be renamed to match project structure NOTE Maximum backup size is 16MB Check the size of the backup once you create it If it is bigger than 16MB you won t be able to restore it System configuration network settings passwords or K
157. t of filter selected objects Next Previous page Move to the next or previous page Refresh Refresh the object list TP gt IP policy Selected filtering policy Page 52 AR1740 EdC February 2015 Custom values Default text Object value 2 Display text 50 d WI Object value Display text Full Add custom value Parking spaces Full CF Add new object O Auto update enabled D Clear Mass edit Page 1 of 5 gt A bal IP gt TP policy None TP gt IP policy None 2015 Schneider Electric All rights reserved homeLYnk User Guide AR1740 EdC February 2015 3 4 7 Object filter Object filter On the left side of the object list you can filter To perform the Object filter enter the Name or group address tag or specify the Data type of the object and press Apply filter button Name or group address switch Data type 01 1 bit boolean Tags match all Light Apply fitter Lan cel 3 4 8 Mass edit Object logs Schedulers Trend logs Vis structure Visualization Vis graphics Scripting User access 8 A A 7 Object filter Group address Object name IP gt TP fi TP gt IPfi Eventsc Datatype Objects filtered in Object filter can be mass edited AA mn Phase 1 E 01 001 switch by gt 11115 Phase 2 01 001 switch ICH Data type 11116 Phase 3 01 001 switch Data type 11 7 Current protection 01 001 switch Tags 01 001 switch Tags
158. t script Data type Current value Log Export Tags Updated at Set value Vis param Custom va Name or group address 0 0 1 co2 ke 09 2 byte floating point 414 72 ppm y J 24 02 2015 09 14 33 fe sh Si 0 0 2 Humidity a 05 001 scale 30 RH Y Y 24 02 2015 09 13 56 fe ES th 3 0 0 3 Temperature ke 09 001 Temperature 24 3 C VW W Temp 24 02 2015 09 13 49 fe mh Data me 0 0 4 Minimal CO2 09 2 byte floating point 329 92 ppm 7 F 15 02 2015 16 41 36 fe gt d 8 Not specified hb 0 0 5 Maximal CO2 09 2 byte floating point 522 88 ppm d d 05 02 2015 09 37 27 fe Ze th 3 Tags 0 0 6 Minimal humidity 09 2 byte floating point 12 RH Y 05 02 2015 06 39 35 fe E TH br 0 0 7 Maximal humidity 09 2 byte floating point 40 RH 7 Y 26 01 2015 10 05 25 fe mh e Match mode 0 0 8 Minimal temperature 09 001 Temperature 21 72 C d 09 02 2015 05 05 55 fe ES mh e SS H 0 0 9 Maximal temperature 09 001 Temperature 28 98 C Y 09 02 2015 08 05 31 fe ge a e ome ddi 0 0 10 Climate values reset 9 09 2 byte floating point 1 Y 20 01 2015 15 25 57 B SS d 8 Apply fer Cancel 0 0 11 Climate time 10 3 byte time day 15 25 58 Tuesday Y E 20 01 2015 15 25 58 fe mh e 0 0 12 Climate date 11 3 byte date 20 01 2015 d v 20 01 2015 15 25 58 fe th Objects are further distinguished by color of their background for quick overview e Green Object value actually updated Don co2 E E y 09 2 byte floating point 409 92 ppm Y Y 03 02 2015 14 47 57 fe Ze th e Yellow Object
159. the file Therefore the construction will iterate over all lines of the file When the iterator function detects the end of file it returns nil to finish the loop and automatically closes the file for line in io lines filename do body end The call o lines with no file name is equivalent to jo input lines that is it iterates over the lines of the default input file In this case it does not close the file when the loop ends io open filename mode This function opens a file in the mode specified in the string mode It returns a new file handle or in case of errors nil plus an error message The mode string can be any of the following e r read mode the default e w write mode a append mode r update mode all previous data is preserved w update mode all previous data is erased e a append update mode previous data is preserved writing is only allowed at the end of file The mode string can also have a b at the end which is needed in some systems to open the file in binary mode This string is exactly what is used in the standard C function fopen io output file Similar to o input but operates over the default output file 10 16 Mathematical functions This library is an interface to the standard C math library It provides all its functions inside the table math math abs x Returns the absolute value of x math acos x Returns the arc cosine of x in radians
160. tton next to a level under which the plan is to be added and select Add plan Name Name for the plan Plan size Size of the plan For pre defined sizes pop up menu Layout Layout for this specific plan All objects from Layout will be duplicated on this particular plan including the background color and the plan image If they are not defined separately for this specific plan Layout should be created before adding the Plan PC Tablet visualization Show Show and make default Hide Visibility for this particular plan in the PC Tablet visualization Smartphone visualization Show Show and make default Hide Visibility for this particular plan in the Smartphone visualization Pin code Possibility to protect each plan with Pin code Primary background image Choose the primary background of the plan Secondary background image Choose the secondary background of the plan for parallax look of the visualization Select background previously added to Vis graphics gt Images Backgrounds Background color Choose the background color of the plan Smartphone background color Choose the background color of the plan for Smartphone Page 61 Le Nam ES SE hom m Plan Parent Name Plan size Layout PC Tablet visualization Smartphone visualization Pin code Primary background image Secondary background image Background color Smartphone background col
161. ty Odd one stop bit is set Delay Between Frames Some devices require considerable time after the end of response until they are ready to receive the following request from the master Henceforth it applies to Schneider Electric SEPAM power devices and legacy slave devices As they are slow in dealing with the original request they may miss the following request The time between the requests should be greater than 3 5 characters according to the Modbus specification However these legacy devices need more time Please use delay command appropriately Wait for 1 5 seconds os sleep 1 5 Communication itself takes care of minimal 3 5 character delay Set slave address set slave address to 123 mb setslave 123 1 247 Page 101 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Read registers read from address 1000 and write it to value value mb readregisters 1000 Close modbus connection mb close Example init modbus on first script execution if not mb then require luamodbus mb luamodbus rtu mb open dev RS485 38400 E 8 1 H mb connect end mb setslave 30 mb flush Timeout interval between two consecutive bytes of the same message mb getbytetimeout mb setbytetimeout timeout Timeout interval used to wait for a response mb getresponsetimeout mb setresponsetimeout timeout Timeout interval used to for an incoming
162. uide 2 2 Default Configuration Authentication Required The server http 10 154 20 70 80 requires a username and password The server says homeLYnk UserName admin Password Log In Cancel Security warning x A You are using default password please change it in Utilities System Admin access NOTE It is strongly recommended to change the default password Reminder appears on every start of the homeLYnk Configurator with default password IP address on LAN 192 168 0 10 Page 14 2015 Schneider Electric All rights reserved homeLYnk User Guide Change IP Settings In Configurator gt Utilities gt System gt Network gt Interfaces window click on the specific interface to change the IP settings Protocol Specific protocol used for addressing e Static IP Static IP address default 192 168 0 10 e DHCP DHCP protocol used to fetch IP configuration IP address IP address received from the DHCP server This field appears only if the IP address is given or else it is hidden Network mask Network mask default 255 255 255 0 24 Gateway IP Gateway IP address DNS server I Primary DNS server IP address DNS server 2 Secondary DNS server IP address Mtu Maximum Transmission Unit the largest size of the packet which is passed in the communication protocol By default 150 When changes are made the appears in the top right corner This should be applied
163. ultiple bits Command value mb writebits 1000 true false true address bit value1 bit value2 max 1968 bits Page 105 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 FC 10 Write Multiple Registers Name Write multiple registers Command value mb writeregisters 1000 123 321 222 address value1 value2 max 123 registers Exception codes mb readcoils start count mb readdiscreteinputs start count mb readregisters start count mb readinputregisters start count These commands read one or more registers coils from the start address and return all values in case of success In case of error three variables are sent back e Nil e Exception code description e Exception code Page 106 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 The following information is taken from the Modicon Web site http modbus org and the Modbus application protocol manual MODBUS Exception Codes 01 Illegal Function The Function Code received in the query is not an allowable action for the server or slave This may be because the function code is only applicable to newer devices and was not implemented in the unit selected It could also indicate that the server or slave is in the wrong state to process a request of this type for example because it is not configured and is being asked to return register values I
164. ve Defines the event to be active or not Value Value to send to the group address when the event will be triggered Start time Start time for the event Days of the week Days of the week when the event will be triggered Hol Holidays which are defined in the Holidays tab 3 6 3 Scheduler Holidays Once the event will be marked to run on Hol Holiday entries will be activated NOTE Scheduler visualization is not supported in the Smartphone visualization Page 56 AR1740 EdC February 2015 Events for scheduler Electric heating Start time Days of the week 00 00 00 00 07 00 10 00 18 00 Mo Tu We Th Fr Sa Su Hol Mo Tu We Th Fr Hol Mo Tu We Th Fr Add event Event Active Value Start time Days of the week Cancel Holiday Name Date 02 February Duration days OO Leave year blank for recurring holidays Cancel 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 3 7 Trend logs Trend logs or so called data logging allows the end user to store the selected data and compare the different time periods from the past homeLYnk Schneider Neighbours Select neighbour Y Language English v Start page Utilities Objects Object logs Schedulers Vis structure Visualization Vis graphics Scripting User access Modbus Alerts Logs Error log Help Name Object Log type Floating point pr 1 minute data
165. wercase letters changed to uppercase All other characters are left unchanged The definition of what a lowercase letter is depends on the current locale Page 135 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Patterns Character Class A character class is used to represent a set of characters The following combinations are allowed in describing a character class e x where x is not one of the magic characters S represents the character x itself e a dot represents all characters e a represents all letters e c represents all control characters e d represents all digits e l represents all lowercase letters e p represents all punctuation characters e s represents all space characters e u represents all uppercase letters e w represents all alphanumeric characters e x represents all hexadecimal digits e z represents the character with representation 0 e x where x is any non alphanumeric character represents the character x This is the standard way to escape the magic characters Any punctuation character even the non magic can be preceded by a when used to represent itself in a pattern e set represents the class which is the union of all characters in set A range of characters can be specified by separating the end characters of the range with a All classes x described above can also be used as components in
166. when the server or slave is free Failure In Associated An Unrecoverable error occurred while the server or slave was attempting to 07 Program Poll 13 and 14 only Memory Parity Error Specialized use in conjunction with function codes 20 and 21 and reference type 6 to indicate that the extended file area failed to pass a consistency check NAK Negative The program function just requested cannot be performed Acknowledgement Issue poll to obtain detailed device dependent error information Valid for The server or slave attempted to read record file but detected a parity error in the memory The client or master can retry the request but service may be required on the server or slave device Page 107 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide February 2015 Gateway Path Specialized use in conjunction with gateways Unavailable DEE Indicates that the gateway was unable to allocate an internal communication path from the input port to the out port for processing the request Gateway Target Specialized use in conjunction with gateways Device Failed to respond Indicates that no response was obtained from the target device Usually means that the device is not present on the network 4 7 Modbus Master Functions Functions listed below can be used for Modbus RTU master or Modbus TCP client mb setslave slaveid sets slave id to read write data from to mb re
167. x cgi 39 R laws Meeting Room 05 02 2015 14 38 05 Thursday m Z itttigrrg L i II ll HHIH f f II Ui TTT T HII HH H i Alli f H ul HU aj Si al Schneider Electric i 2015 Schneider Electric All rights reserved Page 64 e AAA aa e Gg UNE homeLYnk User Guide 3 8 8 Layout Page 65 AR1740 EdC February 2015 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 8 10 Visualization Object Order AR1740 EdC February 2015 Each object on visualization has its priority which is described from the highest to the lowest order GE A A A A N e e e RP RP RP RP RP k LA O D ON DWN RA WN FP O Object on plan Plan link as text on plan Plan link as icon on plan Camera on plan Graph on plan Gauge on plan Text label on plan Image on plan Frame on plan Object on layout Plan link as text on layout Plan link as icon on layout Camera on layout Graph on layout Gauge on layout Text label on layout Image on layout Frame on layout Background of plan Background of layout NOTE Order of objects with the same priority is not defined and it can differ in the editor and PC Tablet visualization Page 66 2015 Schneider Electric All rights reserved homeLYnk AR1740 EdC User Guide F
168. ze Custom name Icon Auto open window Hide background Additional classes Element position Element size Image AR1740 EdC February 2015 Frame Gauge http fwww vision environne 640 A 480 camera_1 swg hal ra Apply Canc el is Sil el sp ise Ziele save and reload plan Cancel 2015 Schneider Electric All rights reserved homeLYnk User Guide 3 9 7 Graph Real time graphs can be integrated into visualization system to monitor the current and the old value of the scale type objects Make sure logging is enabled for the object in the Object tab where values are planned to be shown in the graph Data object Group address of the object Object must have Log option activated for Graph to be active in Visualization Custom name Name of the object Icon Icon to launch the graph Window size Width and height for displaying the graph Number of points Number of data points to show in the graph Auto open window Graph window is automatically opened Hide background Hide icon background Additional classes Create additional class which can be used in custom CSS file in order to modify particular group of graphical objects Once the graph parameters are defined press Add to plan button and newly created object will appear The object can be moved to the desired location NOTE In the editing mode the graph will not work Press Save and reloa

Download Pdf Manuals

Related Search

Related Contents

Hanging Signs/Banners Order Form  Manual DGP96 1.1x  IBM 37L1415 User's Manual  EN User manual - Amazon Web Services  User Manual - US Cellular    Topcom BUTLER E450 User's Manual  NTIC et droit du travail - Ordre des experts      

Copyright © All rights reserved. Failed to retrieve file