Automation Level Migration Engineering Manual
Automation Level Migration Engineering Manual
DesigoTM
Automation level migration
Engineering manual
CM110776en_05
14.09.2011 For internal use only Building Technologies
Siemens Switzerland Ltd
Infrastructure & Cities Sector
Building Technologies Division
Gubelstrasse 22
6301 Zug
Schweiz
Tel. +41 41-724 24 24 © 2009-2011 Siemens Switzerland Ltd
www.siemens.com/sbt Subject to change
The table below lists the third-party trademarks used in this document and their
legal owners. The use of trademarks is subject to international and domestic
provisions of the law.
All product names listed in the table are registered (®) or not registered (™)
trademarks of the owner listed in the table. We forgo the labeling (e.g. using the
symbols ® and ™) of trademarks for the purposes of legibility based on the
reference in this section.
1.3.2 Copyright
This document may be duplicated and distributed only with the express permission
of Siemens, and may be passed on only to authorized persons or companies with
the required technical knowledge.
Before using our products, it is important that you read the documents supplied
with or ordered at the same time as the products (equipment, applications, tools
etc.) carefully and in full.
We assume that persons using our products and documents are authorized and
properly trained and have the requisite technical knowledge to use our products as
intended.
Siemens assumes no liability to the extent allowed under the law for any losses
resulting from a failure to comply with the aforementioned points or for the improper
compliance of the same.
These subjects are described in the separate migration manuals. There is also no
detailed discussion of special solutions such as room automation or third-party
integration.
The workflow presented here is based on over 10 years' experience of the
migration business.
The workflow for the migration business is highly complex and its effects are not
always immediately identifiable. For this reason, each step must be prepared and
checked with extreme care. The workflow always applies to an entire project. It
often requires extensive resources to correct migration errors. The next sections
describe the procedure step by step, with references to sources of additional
information.
The workflow is divided into 6 steps. Each one should be regarded as an
independent step and should be processed as such. Tasks are defined within each
step, which must be carried out by suitable staff in order to achieve the optimum
results. The more closely Sales, Engineering and the customer work together, the
more successful this will be.
This collaborative approach extends throughout the project processing period. In
the ideal situation, all parties bring their own knowledge and experience to the
support and development of the project.
The diagram shows the idea handling of a migration project using the ALN
migration tool.
The first step is labeled Driver migration, because this is often the initial impetus
for a migration project. Opportunities of this kind must be picked up by the regional
sales organizations and handled accordingly.
The impulse may come from the customer, the engineer or the sales force.
Features:
– Customer enquiries with technical specifications.
– Extensions or building conversion plans.
– Support enquiries.
– Information from technical staff.
– Orders for repairs or spare parts.
– Sales activities, special promotions, customer visits etc.
– Contracting.
– Expositions.
The second step is the maintenance of information about the installed base (IB) of
the systems at regional level. The checklist to acquire project data can be used as
a sample IB structure. IB is the heart of the migration business. It is impossible to
actively drive a business without access to all the relevant data.
This information also helps with the evaluation of market opportunities, the
implementation of special promotions, estimates of potential and the control of
sales.
In conjunction with step 1, the control of sales activities clearly involves potential
for the optimization of processes, as well as migration potential. In the IB, all
information from the sales and technical staff can be maintained and used as
required.
Step 3 is the most important step, because it is here that the foundation stone is
laid for the success or failure of the project.
The main purpose of the project record is:
1. Acquisition of all information, both technical and commercial.
2. Record of the requirements.
3. Record of the ACTUAL status.
4. Procurement of data backups.
The project record phase is an advance investment in the business of the future. At
the same time, it is extremely useful to have more than one iron in the fire,
because customers also take a relatively long time to make up their minds.
This project record applies to the complete project. The work involved only needs
to be done once, and it can be referred to later for further planning if necessary. For
maintenance customers, this record should be mandatory, and be written up during
the first maintenance session. The data recorded for this purpose is saved with the
IB.
The project record must cover the acquisition of all information and the clarification
of any questions. The effect of obtaining information retrospectively is always
negative. Checklists should always be used for analysis, firstly to avoid errors, and
secondly because they refer to important points which are otherwise very easy to
overlook. The lists ask about all points which might be important for migration. The
list can also be used for meeting minutes. The time spent on recording the data
always pays off. Ideally, this data can be recorded when visiting a customer, or
during a maintenance or service call. A digital camera is useful when recording the
plant. In this way, it is not usually necessary, for example, for the control panel
manufacturer to come to site again to prepare an offer.
Note This information is absolutely essential for use of the AL Migration tool.
The AL Migration tool (321-Workbench) also defines the bill of quantities for the
required hardware, thereby providing a fundamental basis for calculation.
The strategy should always be based on a "top down" approach. This assumes
that first the management level followed by the automation level are to be
modernized. This approach is essential to avoid impairing compatibility. It is equally
important always to evaluate and assess the system as a whole. The information
from the first four steps and the AL Migration tool can now be used to create the
migration strategy in collaboration with sales and engineering. In normal
circumstances, an increasing number of options will be available. These must be
matched with the customer's requirements and the technical options.
The standard solutions are described in the migration manuals. For the finer
details, refer to the relevant system documentation and data sheets.
In conjunction with the information from the site record, it is now possible to suggest
very detailed solutions without the risk of neglecting important aspects. In more
complex projects, the engineering and sales personnel should work in close
cooperation.
Step 5 consists of the alignment of the migration strategy with the customer. It is
absolutely essential to explain the effects and the extent of migration. For large and
very large projects, and for sensitive customers, it may be advisable to visit a
reference site. A visit of this kind should be accompanied by a system specialist
who can answer outstanding questions or clarify open points. Another option is to
provide a demo plant for the operator of a site so that the customer can get to
know the new technologies. In order to benefit from the new IT solutions, it is
especially important to include those responsible for customer's IT infrastructure if
solutions are to be used which affect the customer network or which could affect
data security regulations. This is always the case if wireless networks (WLAN) or
external access to the network (Web or remote access) are required.
When the detailed questions have been clarified the definitive solutions and options
can be defined. These should be checked again in technical and commercial terms
by specialists in these areas before the tender is submitted.
Further optimization can also be achieved by analyzing the workflow, reviewing the
chronological sequence and manufacturing components in advance. It has been
found that enabling the customers to use their own staff in the migration progress
can provide additional motivation for the award of a migration contract.
Another important point for coordination of the project is the chronological process.
Time scales should be agreed for all the relevant steps. In particular periods when
plant is switched off, or the time frame for building conversions are defined in this
way, and delays can thus be avoided. This can be supplemented by an agreement
on setting-up times, and a clarification of access rights and the handling of
materials on the company's premises.
In the last of the six steps the project is implemented. Here, it is especially
important to keep rechecking the agreements and requirements. The
implementation of the project also requires very thorough planning, as deadlines
must be adhered to, or specific jobs can only be carried out with the cooperation of
other companies. The building conversion work should always be prepared for as
well as possible, to avoid difficulties resulting from unexpected events.
Preassembly of components, provisioning all building materials on site, loading
programs into the controller, checking documentation, and performance of all work
that can be carried out in advance, all contribute to additional reliability and
reduced costs. This also applies, of course, to the implementation of plants by use
of the AL Migration Tool.
Checklists in Excel format are available for all systems, for recording the plants.
There is thus a project list, a control panel list and a system list for Visonik, Unigyr,
Integral and Desigo respectively.
How are the checklists The lists are divided into different sections and can be partially completed before
used? the visit to the customer. This is also a way of checking the validity of the master
data.
Staff can ask about individual points and record the answers in the form of an
interview. To save time, there are numerous questions which can be answered with
a "Yes" or "No". However, all questions must be answered, even if it appears that
everything is clear.
The member of staff handling the next stage who was not present at the meeting
will otherwise be unable to work on the project without further questions. Follow-up
questions are often time-consuming and can produce errors.
For work on the project, it is very important that all documents, such as wiring
diagrams, control diagrams, photos, data backups etc. are enclosed with the
checklists.
A complete list of the companies involved in the building works must also be
available. It must also be clarified whether the contractor is in a position to
undertake the qualification process and able to provide the necessary resources.
More information on migration to Desigo is available on the intranet at:
https://intra.industry.siemens.com/bt/global/en/business/building_comfort/systems/
migration/mig_des/Pages/mig_des_intro.aspx
https://workspace.sbt.siemens.com/content/00001002/lcm/Pages/Migration_Comm
unity.aspx
1 Export engineering data from the existing UVI systems (server or controller).
The data export largely depends on the existing UVI tool mechanisms.
Data that cannot be reused directly in Desigo is needed to create reports, and
is used for information when documenting the existing plant.
The ETS output (HVAC and VIS files) can also be imported as of Desigo
V2.37 for Visonik.
7. Conversion and transformation into a common data format (Controller Data
Format (CDF)).
8. Manual selection and configuration of a Proven Solution in XWORKS plus, or
program structure created directly in CFC. Selection is based on knowledge of the
plant, supported by legacy controller code (e.g. Visonik COLBAS), project
documentation, and the generated re-engineering reports.
9. Manual mapping of UVI data points to PX data points. This process, where PX
objects are linked to UVI data, is the main and most important workflow. Hardware-
related parameters and I/O addresses are transferred in the mapping process.
10. Generation of engineering data in the CFC. The engineering data contains the
structure of the PX program, enhanced with transformed data from the UVI system.
11. Post-engineering & integration of imported data takes place directly in CFC using
associated editors (Parameter Editor and I/O Address Editor). This stage also
includes not only integration of controllers into the existing system and
management level, e.g. for communication, global system functions, alarm
management, trend objects, time scheduling, but also integration into ADP/CC.
All data points generated on the process units must also be generated on
Visonik DCS. This is true in particular for fictitious data points such as CVP,
RGB, VIP etc.. Use PRO, GPR to check this for the process unit. If data points
are missing from the Visonik system, they can be generated automatically with
$xx’PS.OP=SAPA.
The data must be complete. As the upload comes directly from the DCS, it is
strongly recommended that you check for data consistency between the DCS
Hint In rare cases, data points have IDC=0. The tool, however, requires a correct IDC.
1. Search for data points with IDC=0. Create a project report, e.g. with
Pro,CSS,$*,IDC=0,, .
2. Assign the correct IDCs manually to the data points found.
Begin by setting the project settings and creating a new project. Access to the
Visonik Container is also defined in this process.
Important When defining a new migration project, set up valid communications with the
Visonik Container, otherwise no new migration project is created.
Note TRDLG data is uploaded via the Visonik-DAP,DIR dialog box. This dialog box
supplies data only if the DCS system time is valid. It is therefore vital to define the
system time via the DA dialog box.
Note: If the Visonik Container was "rescued" from the site and the migration upload
is carried out in the office, the system time, by default, is NOT defined.
Hints – ALconf: Visonik projects on which Desigo Insight is not yet in use do not
necessarily operate with alarms. Remember to set parameter ALconf before an
upload via PKX, otherwise this has to be done manually in the CFC.
– Check Data points defined as fictive and, if possible, switch to "real",
especially in the case of points from EKL-X stations. Otherwise the scope for
configuration is severely limited in the tool.
Procedure in Visonik data is acquired in two stages via 321-Workbench task DCS Upload:
321-Workbench
1. Step Global Visonik data (i.e. Visonik data valid for all process units) is uploaded from
the Visonik Container (TextDcs.txt). This data consists mainly of text catalogs with
"I" and "U" text. 321-Workbench also interrogates each process unit for its type
(IDC) and version.
1. Select the "not yet uploaded" check box.
2. Click the green arrow.
After uploading, a list is displayed of all process units containing project data.
Use the Map Alarming tab to define the mapping of the Visonik MSGP and AlConf
to the PX alarm classes. You can also specify whether or not data points set to
OSV must be capable of generating alarms.
Note The DCS tabs are only displayed if the DCS is selected in the tree structure.
For almost all data point types, Visonik has two separate delay times for incoming
and cleared faults (alarms). With most function blocks in PX, there is only one
delay time:TiMonDvn. However, data points BI and BO have the following three
delay times: TiMonDvn, TiMonOn und TiMonOff. This tab allows you to define how
these delays are handled system-wide.
The settings for Map Alarming and Map DEL01/10 can be saved in a file for use
with other migration projects.
In the second stage of the wizard, you can specify a file to save the rules.
Migrating EKL-X process units requires using new PTM modules. The following
migration steps are required:
Set for automatic conversion of the EKX-IDC to a (temporary) 321 IDC.
Verify or modify the PTM modules proposed by 321-Workbench.
Add any missing PTM module settings (e.g. for INV, switching, sensor types
etc.)
To migrate to TX-I/O modules, you can specify which TX-I/O module
corresponds to what PTM module and what addresses are to be assigned to the
various relays.
See also: Process map, BPS V12/14, Engineering documentation, CM2Z8303E
Specify TX-I/O module migration rules.
Note: Migrating EKL-X to TX-I/O modules is indirect by migrating to PTM
modules.
Tab: Visonik EKX Migration of EKL-X controllers. Use this tab to define special cases for the
migration of EKX to P-bus modules throughout the project.
Note IDCs migrated in this way can still be modified later.
EKL-X module types SB1_D, SBR1-D and SBR1_DE have bistable outputs. The
corresponding P-bus modules are available in monostable or bistable versions.
Normally, old modules of this kind are replaced with type 2Q250 modules. As an
option, the bistable version can be pre-set here.
Since the DCS does not have all the required information in the process image,
any missing settings have to be added manually.
– In the case of signaling modules with indicators, the DIP switches on the back
cannot be read, and as a result, there is no information on the inversion status.
Similarly, it is not known whether a module does or does not have a memory
function (both IDC=16).
– With pulse switching modules and 3-point control outputs the RAN cannot be
read.
– In the case of measured values, the switch position cannot be read. The signal
transmitter is also unidentifiable.
Tab: P-bus or TX-I/O The P-bus tab or TX-I/O-bus shows appropriate replacements for the EKX
bus hardware.
The P-bus tab allows for defining if the old ML modules should be replaced by
8D20E, 4D20 or 4D20/4D20R.
The TX-I/O bus tab allows for defining how PTM modules are to be migrated to TX-
I/O modules.
Hint Use the wiring diagram for additional help.
4.6.2.1 ML modules
With ML modules the inversion can be selected separately for every data point.
Depending on whether you select 8D20E, 4D20 or 4D20/4D20R, either INV is set,
or a 4D20R module is inserted.
Select 4D20/4D20R if the LED on the signaling module is to indicate the actual
status.
Any other combination is allowed, provided it complies with the Visonik
requirements. However, it is not permissible to mix IDC16 (volt-free) and
IDC17(non-floating).
In the example below, the first three inputs are inverted. As a result, a 4D20R is
added. The last data point, which now no longer fits this combination, is linked to a
new 4D20 module. Ultimately of course, the arrangement is optimized to avoid the
unnecessary use of hardware.
4.6.2.2 MW modules
With MW modules, the switch setting of the old module must be given for each
data point. The next stage is to select the connected sensor in each case. 321-
Workbench selects the relevant module.
4.6.2.3 ZW modules
With STU modules, you are required to define which module type is to be used.
This mainly depends on whether or not the customer wants a manual operating
level. The required combination is selected via the PTM combination.
The EKL-X three-point modules have 6 outputs per module. The BPS supports a
maximum of 4 outputs per module. In such cases the software generates a new
module at the end for the remaining 2 data points.
In the case of the SB modules, a distinction is made between SBs with and without
feedback. In the case of switch commands without feedback, you can select
whether to use modules with or without manual operation.
There are more options for commands with feedback: Firstly, types 2QD and 4QD
are available as additional options, and secondly you can determine whether an
external local/remote contact is required. The following rules apply:
– 2QD/4QD: The feedback mechanism is an integral part of the module. If an
additional signaling module is specified, the signaling inputs are used for
external local/remote contacts.
The report view shows the result after generation: The feedback from four
switching commands is switched to a 4D20 module.
Process units can be merged in the migration process. Any combination of EKL-X,
PRV1 and BPS can be merged.
In the process of merging, the individual P-bus rails are connected in series and
the data points are assigned new addresses. The number of load units is checked
in this process, to ensure that it does not exceed the maximum.
Hints – As a general rule, the addressing is retained by the first process unit specified in
the merging process.
– The first process unit you select should be the one with the most modules.
When merging several controllers to one Desigo PXC automation station (PXC-
64/128, PXC-50/100/200), check the load units as well as the max. allowed data
points. See the related data sheets for system limits.
Keep PTMs, wiring, and This setting ensures that the P-bus addresses and PTM modules are not changed
addresses (green) during migration. The P-bus rail is adopted without modification.
Note When process units are merged, their P-bus rails are connected in series, i.e.
physically interconnected. This makes it necessary to modify the P-bus addresses
of the second process unit. In such cases, the program automatically switches P-
bus compression for the second process unit to the next compression mode ("Keep
modules, keep wiring").
Keep PTMs and wiring, This setting avoids the need to use other PTM modules for migration, or changing
compress addresses the wiring.
(yellow)
The P-bus rail is adopted without modification. P-bus addresses do change,
however.
This setting compresses the P-bus addresses. After migration, PX also makes use
of P-bus addresses which Visonik could not use (optimize gaps).
Application PRV1 and BPS migration, when the P-bus address range is not large enough.
Keep PTMs, change This setting avoids the need to use other PTM modules for the migration. P-bus
wiring (orange) addresses and wiring do change, however.
This setting moves data points to so far unused I/O spaces. After migration, it may
be that some modules are no longer required.
Example Only three data points are connected to the 4D20 module. Elsewhere on the P-bus
is a 4D20 module to which only one data point is connected. This setting
configures the single data point on the 4D20 module. The wiring must be changed.
The 4D20 module is now empty and can be removed.
Use: Reduce number of empty spaces.
Important: The valid result of this P-bus compression is visible only in the report
(i.e. not under the P-bus tab).
Migrate to TX I/O, This setting replaces PTM modules or EKL-X modules with TX-I/O modules. At the
change wiring (red) same time, the P-bus addresses are converted to TX-I/O island bus addresses.
And a rewiring list is created in the engineering report for PTM TX-I/O. (See
Section 3.10).
If you select this option, you can specify if you want to use the Visonik BPS with
BIM (and IOMD) or a Desigo PXC-50/100/200-D automation station.
Note: When an EKL-X process unit is migrated to Desigo PXC-50/100/200-D, the
rewiring list is run via PTM modules, i.e. there is no direct rewiring list from EKL-X
TX-I/O.
Retain PTM/TX-I/O This setting retains the PTM/TX-I/O modules as is including wiring and addressing.
modules In existing TX-I/O modules (e.g. PRV with BIM), the BIM is removed and the TX-I/O
wiring and addressing module connected directly to PXC-50/100/200.
(green)
If PTM modules are retained, they can be connected directly to a PXC-50/100/200
via the PXX-PBUS extension module.
Addressing can be taken over. (Example: P=1.1).
These modules form a predefined combination from standard ICD to P-bus. 321-
Workbench cannot identify these modules and thus displays the hardware from the
interface module. Interface modules must be acquired manually as they are not
detected automatically.
Select the following options if Visonik BPS is retained and new data points or
existing PTM modules are replaced with TX-I/O modules.
An IOMD file with the I/O configuration is created in this process. The P-bus
interface module BIM must be configured as per the IOMD file. The BIM
automatically converts the P-bus addresses to island bus addresses (for TX-I/O
modules).
See Section 3.12.4 "Generate IOMD file" for more information on IOMD files
creation.
The P-bus addresses and the PTM modules are converted to TX-I/O modules
during migration from Visonik PRV/BPS to Desigo PXC-50/100/200 with TX-I/O
modules (direct on island bus). A CDF file with the new TX-I/O module
assignments is created in the process.
In addition, a rewiring list is created for PTM TX-I/O modules.
Adhere to the following procedure:
What From To
Rail Rt: Selected rail (as per Step 1a).
Module Bp: Original PTM module Mt: Selected TX-I/O module (as per Step 1b).
Address Ap: P-bus address At: Island bus address
Channel Cp: Point address Ct: TX-I/O channel
Clamp CLp: PTM terminal Clt: TX-I/O terminal selected accordingly
Use the PXX-PBUS extension module to migrate PRV/BPS process units while
retaining PTM modules to PXC-50/100/200.
Details of the process, in the form of INFO, WARNING and ERROR messages, are
displayed in the log window or saved in the log file. WARNING and ERROR
messages are also written to the report file.
Notes – Generating is also carried out at other times to check feasibility of settings
(e.g. PS merge) or to check proposed migration in relation to PTM modules.
In this case, the log window or report provides important information, indicating
faulty configuration of Visonik, for example, or adjustments required on the PX
side.
– Generation is only carried out for the process units selected in the tree. If
nothing is selected, the function is inactive.
The log window displays the steps during generation along with information,
warnings and error messages.
Note the following information in the log window:
– CANCEL: No properly functioning CDF file.
– ERROR: Migration not completed.
– WARNING: Indicates that a migration solution was generated that still requires
certain actions (e.g. replacement of hardware, manual adjustment of data points
etc.).
If Generate Report File (above the tree view) is selected, the report is created
automatically during generation.
A separate report is created for each selected process unit (unless they are
merged).
The reports are written to the folder ..\ProjectName\_AL_Mig_Report or to the
relevant PS folder (in accordance with the option selected via Tools > Options,
Generator tab).
After a report is generated, it can be displayed directly via the preview option
(Report Preview tab – this tab is not displayed unless a report is available).
Note The report can be created in various file formats (xml, html, doc) depending on the
option selected under Tools > Options; Generator tab).
Hint Select only the required data format (one format only).
If Generate CDF File (above the tree view) is selected, the report is created
automatically during generation.
A separate CDF file is created for each selected process unit (unless they are
merged).
The CDF files are written to the directory ..\ProjectName\_AL_Mig_Cdf or to the
relevant PS directories (in accordance with the option selected under Tools >
Options; Generator tab).
The IOMD file is created automatically upon generation, when the option Generate
IOMD File (above the tree directory) is selected.
An IOMD file is created for each selected process unit (unless they are merged).
The IOMD files are written to the folder ..\Projectname\_AL_Mig_Iomd or to the
corresponding PS folders (corresponding to the selection option Tools > Options ;
Generator tab).
The report is an important tool for reviewing and documenting migration of data
points. The report provides information on the following points:
Hardware/software data from the UVI system.
Settings in 321-Workbench during the migration process.
Migration of data points.
Intended PTM or TX-I/O modules.
Module migration mode.
Manual adjustments required.
The report is useful when dealing with the following special cases:
Visonik EKL-X PX does not support 3-point modules with feedback. An alternative solution must
migration be considered, e.g. changing the actuator.
PTM modules, general PX does not support 2N100K modules. A replacement solution must be
considered, e.g. sensor replacement or use of corresponding TX-I/O modules.
Unigyr tool version V7R54 must be installed on the computer. However, you do
not need a Unigyr license to use the migration tool. (Unigyr data is read-only
data.)
Supported controller versions
– Migration from V3.30 - V7.02
– Not supported < FBB V3.30
Unigyr controllers supported
– PRU1.xx
– PRU2.xx
– PRS10.xx / PRV10.xx
– RWM.xx
– RWP.xx
The Unigyr project data file structure must already exist.
Uni_data
Project A Unigyr project folder A
Segment 1
PRU (.PLN)
PRU (.PLN)
Segment 2
PRU (.PLN)
PRU (.PLN)
Project B Unigyr project folder B
Segment 1
...
A Unigyr project prior to FBB Version 3.30 must be updated to Unigyr FBB Version
7.02 by use of the Unigyr tools HLK Back Translator followed by HVAC Compiler.
1. Drag the PLN file onto the HVAC Back Translator icon.
Drag the HVAC file (extension HLK) onto the HLK Compiler and select FBB
Version 7.02.
Unigyr data can be accessed from the local PC, from a data storage medium such
as a memory stick or CD etc., or over a network.
Prerequisites – 321-Workbench requires that the project data be set up in accordance with
Unigyr data structure rules. (See Section 4.1).
– The Unigyr project is the starting point for 321-Workbench. The controllers in the
segments below the project can be selected in the 321-Workbench dialog box,
either as a whole or individually.
Note If the data is accessed over the network, the network drive must be mapped to a
drive letter. Open a connection via the Windows Explorer menu Tools > Map
network drives. Here, observe IT guidelines for drive allocation.
In addition, the names of Unigyr projects and segments must meet Rule 8.3 and
may not contain any blanks in the path.
Desigo PX does not support all hardware components from the Unigyr
environment. For migration purposes, the following components must be replaced
by an equivalent solution.
Unigyr hardware Possible solution in Desigo PX
PHM1.36-TL PXM 20
PXM10
Local alarm or report printer on the Printer connected to Desigo Insight
automation station
Fax transmission via automation station Fax transmission via Desigo Insight
QAA 23.71 room operator unit QAX 3x.xx
QAW50 room operator unit QAX 3x.xx
QD switching modules are not addressed in the same way in Unigyr as in PX.
However, the migration tools automatically take account of IO addressing.
Note – The plant recommendations are based only on the existence of individual blocks
which can indicate the appropriate PX application.
To migrate Unigyr, a PX programmer must know the specified functionality. The
plant recommendation is not guaranteed to be correct.
– At present, only solutions from the Desigo Libset are proposed.
– Country-specific library extensions are not taken into account.
The migration option must newly be selected in Desigo V4.1. The CDF file and
reports created contain all P-bus assignment information. This information can be
transferred to Desigo as is and processed further in XWORKS plus Point
Configurator.
3 The report generated contains the rewiring list required by the panel builder.
The rewiring list for Visonik is described in Section 3.10.2.1.
Use the PXX-PBUS extension module to migrate Unigyr PRU process units while
retaining PTM modules to PXC-50/100/200. The following setting must be set when
generating the CDF file.
Function (Tools > Start CDF generation) calculates the migration data and
creates the required CDF/report files (if selected).
Details of the process, in the form of INFO, WARNING and ERROR messages, are
displayed in the log window or saved in the log file. WARNING and ERROR
messages are also written to the report file.
Generation is only carried out for the segments or controllers selected in the tree
structure. If nothing is selected, the function is inactive. The same applies in
principle to the creation of CDF and report files.
Note As the CDF/Report Generator relies on the existing mechanisms of the Unigyr
Design tool, the Unigyr Design tool (or the corresponding segment) must not be
open during generation.
The log window displays the steps during generation along with information,
warnings and error messages.
Note the following information in the log window:
– CANCEL: No properly functioning CDF file.
– ERROR: Migration not completed.
– WARNING: Indicates that a migration solution was generated that still requires
certain actions (e.g. replacement of hardware, manual adjustment of data points
etc.).
The contents of the last log window are saved in file
..\Projectname\_AL_Mig_Log\Generator.rtf
If Generate Report File (above the tree view) is selected, the report is created
automatically during generation.
A separate report is created for each process unit selected.
The reports are written to the folder ..\ProjectName\_AL_Mig_Report or to the
relevant PS folder (in accordance with the option selected via Tools > Options,
Generator tab).
After a report is generated, it can be displayed directly via the preview option
(Report Preview tab – this tab is not displayed unless a report is available).
Note: The report can be created in various file formats (xml, html, Office 2003 XML)
depending on the option selected under Tools > Options; Generator tab). Hint:
Select only the required data format (one format only).
If Generate CDF File (above the tree view) is selected, the report is created
automatically during generation.
A separate CDF file is created for each process unit selected.
The CDF files are written to the directory ..\ProjectName\_AL_Mig_Cdf or to the
relevant PS directories (in accordance with the option selected under Tools >
Options; Generator tab).
The report is an important tool for reviewing and documenting migration of data
points. The report provides information on the following points:
Hardware/software data from the Unigyr system.
Project setting.
I/O overview, module types, existing PTM modules.
Automation station information.
Data acquisition
Station interfaces.
Common alarms.
Popcard operation.
Scheduler program/Calendar.
Setpoints.
Desigo plant recommendation.
The report also contains a rewiring list for PTM to TX-I/O modules in the event of
migration to a TX-I/O module.
Note Existing graphics information from Integral Plan is not evaluated (e.g. for
conversion into Desigo PX graphics).
Integral is a heterogeneous system created and extended over many years. The
RS module serves as the basis for automation level control of the system. The
automation level is integrated via interfaces (e.g. NICO-N) in the system controller
(NCRS); the RS modules can be connected directly to the management station
using NITEL.
Important! For correct migration to Desigo PX, the data from the customer site must be
updated with the engineering data.
The project data of an Integral project must first be updated before exporting
Integral project data using 321-Workbench.
Integral data sources The Export.sas file is the common interface for all "project" cases. Depending on
the engineering and type of project, additional files can be used as sources of
information.
Controller/System Controller/Structur File Description
e
AS1000 1 controller Export.sas Engineering data exported with the
(RS module) Register.SR2 SAPIM400 (RS Backup)
Sapim(n).asc engineering tool Integral Plan or
Sapim(n).asc INDAGEN.
AS1000 --- Engineering data directly read with
the RS-Reader.
TS1500 (NITEL) Maximum *.abb; *.inf; AS1000 data plus engineering data
15 RS modules *.asc for management functions
(acquired from the plant).
MS2000 (NCRS) Maximum 4 trunks *.dbs AS1000 data plus engineering data
with max. 15 for management functions
RS modules each (retrieved from the plant with
Restore).
Data from the Integral system can be accessed locally, from a data storage
medium or via the network.
Note In AS1000, data can be exported direct via RS-Reader. This is done while creating
the migration project.
Prerequisites The data must be available in accordance with the data directory (or online via
RS-Reader).
The data must be available in readable form.
Data is updated.
This checklist helps for Current data backup and program printouts for the RS modules (Integral Plan
data recording Project or RS Reader).
For migration to PX RS bus: What Integral RS information points must be
provided to the BACnet environment.
Assess communications interface at AS: Modem, local printer, network, etc.
Assess hardware.
Room operator units, operator unit NBRN, PXM-10/20, door integration.
Panel, space requirements and mounting options for Desigo PX automation
stations and P-bus interface.
Parallel operation with NCRS or Nitel.
Wiring, supply.
Note The following data cannot be read from the RS modules and documented:
Current setpoints from schedulers.
Current runtime totalizers.
Existing object data Object data that already exists in the RS module and has been evaluated is not
displayed as a copy in the NCRS or NITEL project.
RS Service or Online RS Access allows you to read the current time schedule
entries and print them in a text file.
1. Define a text file as Printer (in Windows)
2. Print or load the time program entries
8
Example RS Access - Rothwells [Rothwell], NCRS00, Trunk 1, RS01, Clocks
Report created Tuesday, May 31, 2006 13:08:52
Week schedulers
Weekdays, Time: State, Channels
1: Mon Tue Wed Thu Fri Sat Sun, 00:01: On, 1 - - - - - - -
2: Mon Tue Wed Thu Fri Sat Sun, 00:02: Off, 1 - - - - - - -
3: Mon Tue Wed Thu --- --- ---, 13:00: Off, - - - - - - - 8
4: Mon Tue Wed --- --- --- ---, 14:25: Off, - - - - - - - 8
321 tab 1. Select the report output format (e.g. Internet HTML format, Office).
Integral tab 2. Select the PX RS-bus export rules for output points and tabs (see also
CM2Y9762).
Generate EXPORT.sas file from SAPIM<n>.ASC file, if no Export.sas is
found:
Use an NARC interface converted to connect the RS bus to a PC COM port: The
RS232 interface (on the PC) is converted to RS485 (on the RS bus).
The PC (COM port) is connected via null modem cable to the interface (3). The flat
ribbon cable (6) is connected to the RS bus.
Use the RS-Reader to read all RS modules on a trunk.
Per default, 321-Workbench automatically assigns the offset, i.e. at the first PXC-
NRUD, Offset =1 (addresses 1-6), at the second PXC-NRUD, Offset =7 (addresses
Data point mix for PXC- Device / Type Data point mix
NRUD PXC-NRUD UI DI UO/DO
Adapter for 48 physical data points. 16 8 16/8
Benefits No panel rewiring from adapter to terminal module carrier; extension and
upgrade of panel with PXC..-U und P-bus interface module BIM or PXC-
100/200-D.
Mapping in BIM via module type TXV1-8NK.
TX-I/O modules are used for plant extensions.
Designed for:
PXC64-U with 200 DP
PXC128-U
At 150 DP ca. 1 sec., at 250 DP ca. 2 sec., and at 350 DP ca. 3 sec. cycle
time
BIM must be configured accordingly if the PXC NRUD adapter is used together
with a PXC-64/128-U (+ BIM). To do this, load an IOMD configuration file in the
BIM.
The IOMD file can be generated by opening the BIM tool if the I/O addresses are
checked in the I/O Address Editor and there are not conflicts.
1. Start the BIM tool via CFC menu Chart BIM Tool.
2. The BIM tool starts and the generated IOMD configuration is loaded in the
tool.
3. The I/O configuration can be adapted in the BIM tool before loading it in BIM
via Tools Write to BIM.
See the BIM tool online help file for detailed information.
Benefits Same housing, same design, same interfaces for periphery, i.e.
compatible plus; thus, the existing periphery can be assumed as
is.
No panel rewiring for 1 to 1 exchange.
Effort required for RS bus, possibly NRD24 data points on PXC-
NRUF.
64 physical inputs / outputs.
Data point mix for PXC- Device / Type Data point mix
NRUF PXC-NRUF UI DI UO DO
Automation station for 64 physical 16 24 8 16
data points
M = RSNr (RegType.RegNr[DataFormat])
Register type
Desigo data
Description
Read/Write
Register
I/O type
number
Desigo
format
Tabs
UI Universal 4 1..16 R AI FLOAT
input
M = 5 (50.12[FLOAT]) DI Digital input 5 1..8 R BI BOOL
UZ Universal, 50 1..99 R AI FLOAT
calculated
6.4.3.4 Licensing
The log window displays the steps during generation along with information,
warnings and error messages.
Note the following information in the log window:
– CANCEL: No properly functioning CDF file.
– ERROR: Migration not completed.
– WARNING: Indicates that a migration solution was generated that still requires
certain actions (e.g. replacement of hardware, manual adjustment of data points
etc.).
If Generate CDF File (above the tree view) is selected, the report is created
automatically during generation. A separate CDF file is created for each process
unit selected.
The CDF files are written to the directory ..\ProjectName\_AL_Mig_Cdf or to the
relevant PS directories (in accordance with the option selected under Tools >
Options; Generator tab).
Reports are important tools to check, document data point migration and select a
suitable Desigo solution.
After a report is generated, it can be displayed in the Preview.
The report contains many important project and detailed information, but does
not replace required Integral knowledge to evaluate the program.
The report provides information on: P-bus report and Integral tab and function
block information:
7.1 Visonik
The Visonik P-bus or TX-I/O report contains a rewiring list (EKL-X PTM and
PTM TX-I/O) for the panel builder.
The existing SDLC ring cabling can, parallel with SDLC operation, be used for
BACnet communications, provided performance requirements are not very high.
This is implemented via VDSL modems. For more information, contact Field
Support.
7.2 Unigyr
7.3 Integral
PXC-NRUF Note that serial interface RS232 to connect the telephone modem was moved
slightly (cable length).
PXC-NRUD Make sure that there is sufficient space in the panel for one (or several) PXC-
64/128-U and the corresponding number of TXB1.PBUS.
Use the normal XWORKS plus workflow to create the PX application. The following
sections refer only to special aspects which should be noted when migrating UVI
controllers to a PX automation station.
The following documents contain information on selecting the right solution or
creating the application:
– 321-Workbench Report (e.g. for Unigyr: Desigo plant recommendation).
– Existing plant diagram.
– Other plant documentation.
You can also select a solution in CFC or copy and adapt an existing plant from
another project.
1. Select the desired hierarchy in the Charts tab in the CFC.
2. Go to the Libraries tab and select the corresponding proven solution.
3. Drag and drop the solution in the CFC.
In XWP Point Configurator, a number of CDF files from different UVI controllers can
be loaded (e.g. in cases where several were merged to one PX automation
station).
Note To avoid address conflicts, you must set up 321-Workbench accordingly (e.g.: via
TX-I/O address offset)!
When several controllers were loaded in the XWP Point Configurator, they can be
removed individually by selecting the automation station and Unload CDF (right in
the legacy view).
You can take over (description) texts and unit texts. The following options are
available:
Unigyr Visonik Integral
Description text Name TXI, TXI2, TXI3, Description or
Text normalization, object name
Text replacement (ä,ö,ü)
Selection: (No action, take over text, append text).
Unit text Take over selectable unit texts (default setting is off).
User designation UD Select if User Designation (UD) is
taken over (default is Off).
Important – In PX, the data point description is limited to 32 characters. If this limit is
violated, the text is limited to 32 characters and a warning is output.
– XWP Point Configurator allows you to edit the texts in the Desigo object table.
Notes – From now on, this setting applies to all future mappings.
– The text taken over is displayed in the left pane when you take over legacy texts
during mapping. The text is not reset when you resolve the mapping.
– However, you can edit the text any time in the Desigo object table.
The procedure to map data points differs individually and dependent on the project
(e.g. technical hierarchy structure or data point type).
We generally recommend the following two steps to map data points:
1. Map all possible legacy data points to the selected solution.
2. Check all unmapped legacy data points and newly engineer the associated
data points in either XWP Point Configurator or CFC.
3. Map all remaining data points to the newly created PX data points.
4. Address all remaining PX data points.
Hint: Previously mapped data points can be hidden.
Hint: Check if the text mapping rules are set correctly prior to mapping.
1. Select the legacy (UVI) data point in the legacy data view. You can set
additional filters to further limit the selection.
XWP Point Configurator allows you to map feedback to a PX data point (AO, BO,
MO) on outputs.
If, for example, you are mapping a Visonik SBR1 DP to a PX-BO, the feedback
address is mapped automatically also. You can manually map another Visonik ML
to the corresponding PX-BO, if you want to first map a different feedback. However,
you must always first map the output.
The mapping must be technically feasible, i.e. the corresponding modules (PTM,
TX-I/O) must support it.
XWP Point Configurator allows you to map several data points to a PX multistate
data point (MI, MO).
For example, two Visonik ML data points can be mapped to one PX MI data point
while at the same time allowing for defining the signal sequence via a popup dialog
box.
Selection of signal
sequence for multistate
mapping
The same is true when mapping several data points to an MO (including feedback).
With MO, the output signals must be mapped before feedback. Thus for example, a
Visonik SB1 to a PX-MO (with 2 Visonik ML to the MO as feedback).
Multistate mapping
with feedback
The above example shows multistate mapping of Visonik SBR2 and SBR to Desigo
MO. In this case, the feedback of the SBR is mapped also. In the selected data
point, two Visonik ML data points (1.1 and 1.2) were mapped individually as
feedback.
Caution! Take note if you are mapping to PTM or TX-I/O modules during multistate
mapping.
Restriction when mapping to TX-I/O modules: Mapping several legacy
BI/BOs to one Desigo MI or MO requires that all data points be located on the
same module, and that the channels are in sequence without gaps.
This restriction does not apply to PTM modules where an MO can be located on
any modules/channels.
When they are migrated to Desigo, trend objects already contain a BACnet
reference to the data point to be logged.
1. Map first the trended UVI data points (e.g. outside temperature or counter
values) to the corresponding PX data points. (Red in the picture).
2. Trendlog objects cannot be created in Point Configurator. Create thus the
required Trendlog objects in the CFC.
3. Map the UVI trend objects (Visonik trend object, Unigyr registration object) to
the PX trend log object (TRNDLOG).
(Blue in the picture).
The data point information (e.g. technical address (TD), BACnet reference) is
adopted automatically in this process.
4. Create a mapping file (e.g. ADP trend mapping file) to check the trendlogs.
Only the trend block's object parameters are taken over if values not from a
mapped I/O data point were recorded with the trend block.
In this case, you must manually revise the BACnet references to the objects in
the CFC.
XWP Point Configurator allows you to create PX data points from legacy (UVI) data
points.
1. In the legacy data view, select several data points (multiple selection) and
drag and drop them in the PX Tree view for mapping (in the desired
hierarchy).
2. The Define Names dialog box opens after you drag and drop the data
points in the hierarchy. You can now select a short name and the desired
start index. When mapping several data points, the index based on the start
index is incremented by 1.
Sound and meaningful naming is really important, as the data point name
should match that of a later Insight genie.
The created data points are displayed as mapped data points. The
associated, transformable parameters are taken over.
We recommend to check CFC data for completeness and make sure there are not
errors prior to generating the CFC data. You can do this in Point Configurator or the
generated Excel checklist.
Variant 1: 1. Visual check to see if all PX data points are mapped to a legacy data point.
2. Select "Hide mapped objects" to no longer display PX data points.
Variant 2: 1. Create a mapping table (to check) via "Generate Mapping File".
2. A CSV file is created under the corresponding AS. You can filter column
"Mapping" for all assigned data points (MAPPED), PX data points not mapped
(Desigo) as well as legacy data points (e.g. Visonik) not yet mapped.
Create CFC data The mapped data points are created in the CFC via a file followed by navigation to
the CFC Editor.
11 Select File Generate CFC data and Exit or click the button to create the
CFC data.
12
The tables below list all the parameters of the legacy systems (UVI) transferred when mapping objects to the PX blocks.
A value can only be adopted from a Unigyr program if the value was entered
directly at the relevant pin of the Unigyr block. If the value is supplied to the pin via
a connection, it cannot be adopted.
If values greater than the permitted Desigo value range from a Unigyr program are
to be taken over, an error message is displayed (value greater than value range);
e.g. current counter status of counter value in Unigyr = 80000, but the counter
value is limited to 50000 (PrVal.Max) in Desigo.
Procedure Set PrVal.Max of the relevant Desigo object manually to a sufficiently high value.
Caution Parameters PrVal.Max and HiLm are interdependent. If PrVal.Max is set to infinity,
HiLm in Desigo Insight can only be set with the slider with great difficulty. For this
reason, set a realistic value for PrVal.Max.
When mapping objects, the units are transferred together with the PX parameters
(selected in the Options dialog box). As a rule, unit texts are not taken over, as the
units in the Desigo solutions already contain the right unit texts.
If units are still taken over from a legacy system, they can be taken over as is, or
via unit mapping file translated in a standard Desigo unit.
In this case, the mapping can be defined directly in the mapping file. Units that are
not yet supported by the Desigo system must be converted appropriately.
Add to the unit 1 Öffnen Sie die Unit Mapping-Datei mit Notepad:
mapping file C:\Program Files\Siemens\Desigo\XWP500\Bin\DMEUnitMap.xml
2 Add the missing unit to section <UserDefinedUnits>.
The relevant PXUnitId is located in
<PxDefinedUnits> further below.
The mapped data generated by XWP Point Configurator is now loaded into the
CFC. In the event of address conflicts, use the CFC I/O Address Editor to check
them.
Note New: You can connect PTM modules directly to the PXC-50/100/200 usign the
PXX-PBUS extension module. Note that data point addressing must defer to the
subsystem (island bus, P-bus). Thus, address P=1.1 and T=1.1 is possible.
Check the following settings in the I/O Address Editor of the CFC.
I/O Address Editor: Check module type, data points and units.
I/O address conflicts.
Further settings to check:
o Controller setting.
o Scheduler programs / calendar entries.
o Storage for trendlog objects, i.e. notification threshold and buffer size,
interval.
o Modem setting.
o Heating curves / HRA / OSSC.
o Delay times/Timer/alarm response and properties.
o Plant control and operating modes in ENSEL_MS, CMD_CTL,
PWR_CTL.
Remember to check the following for PXC-NRUD via BIM (bus interface module)
and adapt as needed (via the CFC, I/O Address Editor):
– Definition of data points and module types: In PXC-NRUD, the module type must
be set for all I/Os to value TXV1.8NK.
– Multistate inputs and outputs require manual adjustment.
– Manually set feedback addresses.
– Manually revise units (unit texts) as needed.
Manually revise as needed in the I/O Address Editor analogous to PXC-NRUD (see
section 10.1.1.1 )
The specific settings were set previously via the options in 321-Workbench.
Note We recommend to activate all options for RS bus. This at most generates more
DMAP objects than needed in XWORKS plus. They can be removed in the CFC.
Furthermore, the settings assumed automatically can be revised retroactively in the
I/O Address Editor as needed analogous to PXC-NRUD (see section 10.1.1.1)
XWP Point Configurator automatically saves its data in AlMig, located within the
AS project data. As a result, data generated in XWP Point Configurator, are saved
automatically to the BOS server.
1. Go to AlMig data:
2. Select the AS in XWP Project Manager.
3. Right-click and select Go to storage location“.
4. Subfolder AlMig contains the associated data.
Important! The data from the legacy system (UVI) and the migration project folder of 321-
Workbench (CDF, report) is not saved in this folder. If e.g. the 321-Workbench
project or the corresponding legacy files are (e.g. Unigyr PLN file) are to be saved
also, we recommend copying it to the Al-Mig subfolder or administer the legacy
data as Misc folder in the XWP project.
After migration in Toolbox.net, the ADP reports contain a link to a new created
logical data series and not to the old base or derived data series as before. The
executed report containing the link to the logical displays both data from the old
and the new data series.
In the migration tool Toolbox.net only base data series are displayed as possible
source series. No derived series is displayed for migration. But how about derived
data series? Migration automatically creates a new derived data series for an
existing one to get the same structure as before. The old and new derived data
series are joined together by a new logical data series. This logical data series is
referenced in calculated data series and reports.
Trend mapping file The information on trended UVI data points (old data) and the mapped PX data
points (new data) can be created in a trend mapping file (.CSV) in XWORKS plus
Point Configurator. This contains a summary of all the available migration data and
is suitable for setting up the ADP migration.
4 Click Start. The report is created and saved in project folder \diggdata.
5 Open the Report.txt file with a text editor.
6 Select Edit > Find.
7 For Visonik enter "DCS" as the search criterion.
For Unigyr enter "Unigyr" as the search criterion.
For Integral enter "NCRS" as the search criterion.
8 Click OK.
The data to be migrated is checked during import into CFC. The following list
provides an overview of the various error messages and their possible cause.
Error Text
number
2200 Error in [%Object%]. Description: Could not find parameter
[%Parameter%].
Cause Mapping of objects with different numbers of parameters.
e.g. BI to BVAL
Action Check that the right objects were mapped.
2225 Error in [%Object%]. Description: Pin variable of parameter
[%Object%] not found.
Cause Mapping of objects with different numbers of parameters.
e.g. BI to BVAL
Action Check that the right objects were mapped.
2235 Error in [%Object%]. Description: Invalid attribute [%Object%] in
parameter [%Object%]. %s
Cause Parameter is outside the valid range.
Action Adapt PrVal.Min or PrVal.Max.
2240 Error in [%Object%]. Description: Could not write attribute
[%Attribute%] in parameter [%Parameter%].
Cause Parameter is wired in the CFC and cannot therefore be
written e.g. calculated or pre-processed setpoint in PX.
Action Check that the parameter value is relevant for the PX
application, If necessary this parameter value must be
entered in a different place in the application.
2255 Could not write shortname for [%Object%]. Description:
Cause Invalid character in "Short name" e.g. Pu_St1. The only
valid characters are a…Z and 1…9.
Action The short name for the block is not written and must be
edited manually in the CFC.
2256 Error in [% Object%] Description: Duplicate TD name. The second
Object and its children will be ignored
Cause The same object name occurs twice at the same
hierarchical level. CFC is case-sensitive: VentZuSt,
VentZuST.
Action One of the two object names must be corrected.
2260 Could not write description for [%Object%]. Description:
Cause The text description is longer than the 32 characters
permitted in PX.
Action Check and modify text in the Mapping view of XWP
Point Configurator.