Technical Documentation. EI_Import. Version : 2.0 Issued :

Transcription

1 Technical Documentation EI_Import Version : 2.0 Issued :

2 1. Introduction Electrical installation import EI_Import generates an ETS5 project from a cable list, as used by the electrician when laying the cables. It can be easily created as a CVS file using Excel or a text editor. Alternatively, Visu files can also be imported from EiPlan or EiPlan-outside. In the first phase, the required device types are determined. A device assistant helps with the selection and parameterization of the KNX devices. In addition, pre-set devices from the "Device Kit" or EiPlan can be used. In the second phase, the ETS project is created automatically. A configurable group address scheme controls this process. The generated project contains all required group addresses, the building structure and the KNX devices. It can be further processed with ETS5 or EIplan Page 1

3 2. Structure of the list The list corresponds to the Excel CVS format of a table. The first line contains the headings of the columns. These are specified by EI_Import according to the set language and must not be changed. As a separator between the columns, the semicolon (;) is used. It starts with a list of headings and a sample line in the ad. This can be saved and then edited with Excel. Alternatively, you can use a text editor such as Notepad or edit the list in EI_Import. Each line of the list describes a circuit. The required group addresses are automatically generated later by EI-Import. A list does not have to be sorted. Columns and lines can be in any order. EI_Import then sorts the list by device address and channel. 2.1 The columns of the list No No is an automatically generated line number in the display (not in the file). Device device describes the KNX device (actuator or sensor) by an abbreviation. This consists of Page 2

4 letters for the device type and a number for the number of channels. DA4 is a dimming actuator with 4 channels (Dimming actuator 4-fold). The following device types are defined:. Table 1 Kind Designation DA Dimming actuator SA Switching actuator EA Energy actuator (current measurement) MA Motor / blind actuator HA Heating actuator TS Touch sensor (light switch) RT Room temperature controller (with free rockers) FK Window contact - mostly digital input UP BM Motion detector PM Presence detector RM Smoke detector AI Analog input AO Analog output BI Binary Input - Digital Input BO Binary output - Digital output WS Weather station LM Logic module SV KNX power supply DI Display SY System device In addition, all EiPlan device designations can also be used with rocker code and manufacturer identification. For example TS2DT_MDT (further information see EiPlan manual). Address Here is the device address in KNX notation, z. B In the Excel file can also be only one number, which then the cable is assigned. A line with address 0 is treated as an unswitched circuit, only a group address in the middle group 5 is generated. This is irrelevant for the KNX system and only serves to document the entire electrical installation. Channel This is the channel number to which this circuit is connected. Area 1. number of channels. For the push button sensor, this is the number of the button or rocker. Area The area consists of 3 parts that correspond to the ETS building structure:. Haus_Wohnung_Etage The parts are separated by underscores z. B. H1_W1_EG The area is practically the plan name of the floor plan. Room Here is the room name z. B. Living room or a room number with name z. B. E005 (living room) see KNX project guidelines. Circuit Page 3

5 Is the name of the consumer, eg. B. Ceiling lamp or socket 3x TV. From room and circuit the group address name is formed, eg. B. Wohnzimmer_Deckenlampe. Distribution The name of the distributor, in which the actuator is installed, is freely selectable z. B. UV. An underscore "_" appends the name of the room in which the distributor is located. The room designation can be made up of area and room. Example: "UV_H1_W1_EG_Technikraum" or even simplified "UV_Technikraum" if it is in the same area. Management Here, a number or name can be freely selected (but without an underscore) z. B or L1025 (NYM2,5x5). (for documentation only - not required in ETS) # H3 fuse. Here is the number of the fuse as a pure number or with an F at the beginning z. B. F7 It is recommended to consecutively number fuses in the distributor. The first number is the FI-switch, then the fuses on this FI-switch follow Page 4

6 3. Operation of EI_Import You can create the list outside the ETS with Excel or directly in the EI_Import table. If you make entries in the EI import table or make changes there, do not forget to save!. 3.1 Reading Use the Import key to read in a list. Beware the EI_Import table will be overwritten!. 3.2 Identify pattern components Reading in starts the first phase of the project generation. The list is searched for device types. For each device type, a new button is created in the Pattern Devices area. 3.3 Set pattern components When you press the key of a sample device, the device selection is first taken from the ETS catalog Page 5

7 The next click displays the selection of settings. First, set the parameters. For this we started the ETS Parameter Dialog Page 6

8 Be sure to release all channels of the device. In the next step, select the object mapping. On the left you can see the communication objects as specified by the manufacturer. You must now sort the object numbers to the right in the device structure. This is done by marking left and then right in the device double click. With this setting, you translate the language- and manufacturer-dependent name of the objects into a unique code that is entered in the description column of the objects when you end the object dialog. This code later enables the automatic assignment of the group addresses Page 7

9 4. Create the ETS project When all sample devices are set, we can generate the ETS project. 4.1 System groups This key generates group addresses for central groups, as required in common projects. Among other things, there are groups for the weather station, further measured values, setpoints and fault messages. 4.2 Create structure This key searches the list and filters out parts of the building. In the ETS, the building structure with house, apartment, floor and room is created from this. 4.3 Generation of group addresses and actuators This key does the main work of project creation. First, the project is cleaned. KNX devices that are not part of the sample devices will be deleted. Groups that do not belong to the system groups, as well. The deletion process ensures that even after repeated attempts to make corrections in the list, a clean project is created. Now all actuators and group addresses are created and connected. Actuators are created by copying the sample devices and take over all the settings from them. For each actuator type, a function set of required groups is defined in the EI_Import setup. This not only generates the circuit group (switching function) but also all other functions such as feedback, dimming and brightness values. The generated groups are connected directly to the corresponding communication objects in the actuator. 4.4 Pushbutton and temperature controller Do not create your own group addresses, but are connected to the groups of actuators. They must therefore be placed behind the actuators in the list. This is easy to achieve by assigning you higher addresses. Recommendation:. Actuators start at 1 button and temperature controllers start at 100. Pattern creates the EI_Import itself from 200 on. Automatic sorting creates a sensible division Page 8

10 4.5 Control of the results Take a look at the automatically generated project in the views of the ETS. If you wish, you can now make changes to the list and re-create the project. 4.6 Working in the ETS Only change directly in the ETS if you are satisfied with the work of EI_Import. He has now completed his work to create the project. Spoke the last issue of the list. It could be the basis for your next project. Save the sample devices with the button "Save sample devices". The stored sample devices can be used later in further projects. Close EI_Import. If you use EI_Import for an existing project, it will be overwritten Page 9

11 5. Import of Visu files With EiPlan and EiPlan-outside Visu-files can be generated. These can be imported with EI_Import into an ETS5, even if there is no EiPlan installed in the ETS. Press the button and then select the visu. XML file from the project directory. For example C: / ETSprojekte / MusterHaus / Visu. xml. 5.1 Import with KNX devices The import runs automatically if all devices are present in the ETS database. If a device or manufacturer in the ETS database is missing, there is an error message. If the manufacturer is missing, close the project and check in the ETS settings under Catalog whether the manufacturer is released. If you have released the manufacturer, reopen the project. Then download the device from the cloud in the ETS catalog. When this is done, there is no black cloud in front of the entry in the ETS catalog. Now try importing the Visu file again. 5.2 Import with virtual devices With EiPlan-outside you can create projects with virtual devices. These devices only describe the function but are not yet connected to any KNX manufacturer. The first device is a complete KNX device from the manufacturer MDT. The second device is a virtual KNX device. The manufacturer still has to be selected. Click on this button to select a manufacturer device from the ETS catalog. After that, the device will appear as. Click the button again to open the ETS parameter dialog. Set the parameters and then close the ETS parameter window. After that, the device will appear as Page 10

12 Click the button again to start the object mapping. When that's done, the device should show a green tick. Follow these steps for all devices that do not have a green tick yet. Then save the sample devices. Save sample devices When saving the devices, a manufacturer code is appended to the type name. The sample devices are stored in the device directory. You can now use EiPlan-outside to replace the virtual devices with real KNX devices. Then import the project again Page 11

13 6. Create a sample device With the button. you can create a KNX sample device independently of a project. Such sample devices can be used in EiPlan and EiPlan-outside to create projects. Since the sample devices correspond to a KNX manufacturer device and are already parameterized (default), project creation is considerably simplified. First, select the device type by clicking an icon. If you move the mouse pointer over the symbols, the description appears in the ToolTip. Then the number of channels and rocker assignment is determined. When done, a pattern button will appear, allowing you to perform the above 3 steps. from the ETS catalog Set parameter Assign objects Page 12

14 then save the device Page 13

15 7. Attachment This chapter contains general information about the concept of project generation. EI_Import essentially corresponds to the KNX project guidelines. Some points have been added to allow compatibility with EIplan and EIdoc. 7.1 Structure The ETS supports a hierarchical building structure. The top 3 levels of this structure are the house apartment and the floor. In EI_Import, these are grouped into a plan or area name. The words are separated by underscores. As a rule, this unit is also assigned a floor plan drawing. for example, H1_W1_EG would be the house 1 on the ground floor. Within a plan (area) are the rooms and distribution cabinets. rooms are marked with names (from the architect's drawing) or with numbers and names. This name must be unique in a plan area. 7.2 Group addressing scheme The ETS supports a 3-part number for group addresses. It consists of a main group, a middle group and a current address number. The parts are written with / separated. z. B. : 1/5/22. EI_Import uses the proven scheme B of EiPlan. If necessary, an alternative schema can be created with Eiplan. Main group There are 32 main groups, labeled 0 through 31. One main group is used for central functions (usually 0 settable in setup). The other main groups are assigned to the plan areas (mostly floors). Central group There are 8 middle groups with the numbers 0 to 7. We have provided the following breakdown:. 0 central functions in the planning area and sensors 1 lighting dimmable 2 lights switchable 3 heating air conditioning ventilation 4 blinds and shading 5 unswitched circuits 6 switched circuits with energy measurement 7 free for special functions From this definition, certain actuator types are derived:. 1 DA dimming actuators 2 SA switching actuators 3 HA heating actuators 4 MA blind actuators 6 EA energy actuators (switching actuators with current measurement) For actuators 0, 5 and 7 no actuators are assigned automatically Page 14

16 For each of these types of actuators, a set of group addresses is defined in the schema. The sets of actuators contain different numbers of group addresses. We recommend to use the basic settings. Current address In this area, a set of group addresses is generated for each circuit. With a dimming actuator, these are 5 group addresses per circuit. Then the next circuit follows. 7.3 Component marking We use a simple system to mark KNX devices independently of language and manufacturer. Device types A device name consists of 2 letters identifying the device type, followed by a number indicating the number of channels. Table 2 Kind Designation DA Dimming actuator SA Switching actuator EA Energy actuator (current measurement) MA Motor / blind actuator HA Heating actuator TS Touch sensor (light switch) RT Room temperature controller (with free rockers) FK Window contact - mostly digital input UP BM Motion detector PM Presence detector RM Smoke detector AI Analog input AO Analog output BI Binary Input - Digital Input BO Binary Output - Digital Output WS Weather station LM Logic module SV KNX power supply DI Display SY System device DA4 is a 4-way dimming actuator. Channels Each actuator has several channels for different circuits. Each button has several buttons or rockers. A room temperature controller can also have free rockers or buttons that can be used like a TS. For push-button sensors and room temperature controllers, the rockers are described with a rocker code:. Table 3 Code Meaning S Rocker with on / off switching function D Rocker with dimmer function M Rocker with blind motor function Page 15

17 T L Split rocker with 2 push-button on / off functions Split seesaw with 2 light scenes Manufacturer ID To the device short designation a manufacturer identification with "_" is added. The manufacturer ID has a maximum of 6 characters or corresponds to the KNX manufacturer code. for example, TS2DL_MDT or TS2DL_M Objects Each communication object in a KNX device belongs to a specific function, eg. B. Switching, dimming or confirming. Also for the description of these functions there is no standard. We therefore identify functions with a language- and manufacturer-independent code. We enter in the object description for the channel number a C followed by the number. The numbers of the channels start at 1. The number 0 is intended for general functions and the temperature controller. The code consists of an F followed by a number. The specified numbers can be printed out via the EI_Import setup. The function number is also entered in the object description. This happens in the object dialog during the setting of the sample devices. C1F1: is, for example, the switching function of channel 1. When automatically connecting group addresses with the actuator, EI-Import can use this code Page 16