Home

PNDT User Manual

1. Happy Clients in Realtime Communication and Control Select module You can specify which module to plug into slot This step is optional gt 64 byte I 0x30 48 slot 1 lt 64 byte O 0x31 49 gt 64 byte IO 0x32 50 gt aModule 0x2a 42 slot 2 Figure 78 Create Slot Wizard Module selection Selecting Module that is already used will result in warning message appearing If the user will de cide to proceed with that selection previous Slot assignment will be overridden 4 7 8 Create a new Subslot Subslots are fully contained in their parent Slots Therefore one has to use Slot definition to create and remove them User is assisted through Subslot creation with New Subslot Wizard The wizard has up to two pag es First one for specifying basic properties and second one for Submodule assignment The sec ond page is only displayed if Subslot s parent has Module assigned First page is shown on Figure 79 User has to specify number for Subslot Please remember that number has to be unique within Slot to be accepted Version 1 0 0 68 77 per Happy Clients in Realtime Communication and Control Subslot properties Set properties of subslot Number 0x0042 an example rr e Figure 79 New Subslot Wizard The optional second page is shown on Figure 80 If Subslot s parent has Module assigned user can plug Submodule into new Subslot This step can be skipped Version
2. 3 3 3 Outline Outline view 1s by default positioned on the right side of application window This application part presents hierarchy of data opened in currently focused editor By selecting tree nodes on the Outline part user can cause relevant page to be revealed in the editor P Outline E ae General oo x Device Description beg Device Identity K Device Function Z Software Model 2 Modules El 64byte I 0x30 48 gt 64 byte I 0x1 El lt gt 64 byte O 0x31 49 o gt 64 byte O 0x1 64bvte IO 0x32 50 Figure 6 Outline View with example contents Outline context menu available through right mouse button allows to perform actions on selected tree node Actions are not available for every node Table 6 Outline context menu options Cuts selected object deletes it from current location and puts it into clip ut Copy Copies selected object to clipboard Paste Adds object from clipboard to children of selected object Delete eletes selected object If Outline view 19 hidden it can be restored using main menu item Show Outline View 3 3 4 Tasks Tasks view is by default positioned on the bottom of application window This application part contains table with all tasks associated with currently opened projects Version 1 0 0 20 77 Happy Clients in Realtime Communication and Control project_C dsntool roman Supply device in E tion project_C dsntool Device
3. as Figure 49 Submodule description input Additional text information about Submodule 4 7 2 4 Data Direction Data Direction Output x Y Figure 50 Submodule date direction input Specifies a kind of interface the Submodule represents It can be input output both or none Should be consistent with input and output data type settings 4 7 2 5 Input Data Type Input Data Type None v Figure 51 Submodule input data type Specifies type of input data Possible options are e None for when data direction is neither an Input nor Input Output e Unsigned 8 unsigned 8 bit integer number values from 0 to 255 takes one byte e Unsigned 16 unsigned 16 bit integer number values from 0 to 65535 takes two bytes e Unsigned 32 unsigned 32 bit integer number values from 0 to 4294967295 takes four bytes e Signed 8 signed 8 bit integer number values from 128 to 127 takes one byte e Signed 16 signed 16 bit integer number values from 32768 to 32767 takes two bytes e Signed 32 signed 32 bit integer number values from 2147483648 to 2147483647 takes four bytes e Octet String string of characters each of them taking one byte Data type setting determines input unit Input data length determines how many input units there are 4 7 2 6 Input Data Length Input Data Type None v Figure 52 Submodule input data length amp Version 1 0 0 53 77 per Fo Specifies length of input data in bytes T
4. e Project specific These problems are associated with concrete project That includes errors in saving project file or generating code problems with project configuration missing val ues etc Global These are problems that concern application itself That includes errors in accessing licence file or auto update repository errors caused by corrupted application files etc Problem severity e 7 Errors Most severe Reported when due to a problem requested operation could not be completed In case of project problems error means that project is incorrectly configured and should not be used to generate code e 7 Warnings Moderately severe Reported when requested operation was able to continue but with complications Warning reports should be reviewed carefully to check if they do not indicate some larger problem e 7 Infos Least severe Reported for situations that are not likely to be of concern 3 7 3 Problem properties Problem reports can be viewed using Problems View If hidden it can be revealed using menu item Show Problems View Figure 24 presents contents of Problems View the table is filled with ex ample problems of different severity and scope Version 1 0 0 35 77 Happy Clients in Realtime Communication and Control Setting value not found Default value RPC_SWREV_PROTOTYPE was used inste hy dsntool Limited Setting RPC_DEVA Unable to get setting value java lang String cannot be cast to java l
5. 0 0 30 77 per Happy Clients in Realtime Communication and Control n a project_A dsntool E D project_B dsntool 9 pnio_conf h C device c ft GSDML 2ml E D project_C dsntool B pnio_conf h C device c 4 gt GSDML xml Figure 19 Three projects visible in Packet Explorer On Figure 19 you can see example contents of Package Explorer View three project entries Each project entry is labeled with project name which is equivalent to its file name The same project name will be displayed on associated editor label Icon entry is characteristic to project type A yellow folder is a generic icon used in following circumstances e Project is not loaded yet e Project type is not supported by the tool e Project failed to load problem with file access or file corrupted If application is launched with many projects from previous session not all of them will be loaded from disk at the same time to save resources If project fails to load second and third case user can try to diagnose the situation by checking reported problems You can open editor for project by double clicking its entry in Package Explorer view You can remove project entry from view by right clicking it and selecting Close Project from con text menu The same effect can be achieved using main menu Closing the project doesn t delete its project file so the project may be opened for editing later The application will warn about any
6. 1 0 0 69 77 per Happy Clients in Realtime Communication and Control Select Submodule Select Submodule to be set as Subslot submodule 64 byte I 0x1 Figure 80 New Subslot Wizard Submodule selection The wizard will warn if selected Submodule is already used by other Subslot Because only one Submodule can be plugged into Subslot at the same time the previous assignment would have to be removed 4 7 9 Parameters Parameters are software model objects that can be used to parameterize Submodules and Record Data objects List of all Parameters currently present in software model is available under Parame ters editor block The following section gives an overview about settings for parameters Name Name pm_test_U32 amp Figure 81 Paramter name input Version 1 0 0 70 77 per Happy Clients in Realtime Communication and Control Human readable name of the Parameter Maximum number of characters is 100 Index Index 0x0021 Y Figure 82 Parameter index input Address of data represented by Parameter Value is a 16 bit unsigned number Description Description Figure 83 Parameter description input Optional user text Can be used to add comments about Parameter Data Type Data Type Unsigned 32 K Figure 84 Parameter data type input Specifies data type of the Parameter Possible options are e None no data e Unsigned 8 unsigned 8 bit integer number values from 0 to 255 takes
7. D Projects Eclipse4 3 examples device c Figure 33 The user has to confirm file overwrite After project creation wizard finishes successfully project file will be created and filled with empty project configuration Other files pnio_conf h device c GSDML will be created later The new project will be opened in new editor tab that should appear on top of application window 4 2 6 Validation PROFINET projects are subject to correctness checks as every other port DesignTool project e After project is opened e Before project is saved e At user request You can request project validation using Package Explorer Right click on project entry in Package Explorer View and select Validate menu option Validation may take a few seconds After it finish es dialog with results should appear If no problems are found the message will simply say OK Otherwise quick overview of detected problems will be displayed in dialog similar to presented on Figure 34 Version 1 0 0 42 77 per Happy Clients in Realtime Communication and Control CIT x FEE KKK EERE EEE EEE EEE EE EEE EERE EEE TEER E EEE EEE EEE EEE E KKK EEE EEE EEE KEK KKK KEK KKK KKK EEE EET TEETER TEETER TEETER TEETER ERT Tre FEE EEE EEE EEE EERE EEE EEE E EEE EE EEE EEE EEE EEE EERE EEE EEE LL EERE EEE EEE EE EEEEEEE EE EEE EEEEEE aT EE EE ESE E EES aa Figure 34 Dialog with results of explicitly request project validation See Common Problems chapter for list
8. Data Length 64 r Figure 54 Submodule output data length Specifies length of output data in bytes The value is a 16 bit unsigned integer Should be consistent with data type That means it has to be divisible by byte size of the unit Depending on data type valid values are e None 0 e Unsigned 8 1 2 3 4 65535 e Signed 8 1 2 3 4 65535 e Octet String 1 2 3 4 65535 e Unsigned 16 2 4 6 8 65534 Version 1 0 0 54 77 per Happy Clients in Realtime Communication and Control e Signed 16 2 4 6 e Unsigned 32 4 8 e Signed 32 4 8 1 8 65534 12 16 65532 2 16 65532 4 7 2 9 Subslot Selection Subsfot selection No subslot selected Browse Create Figure 55 Submodule Subslot input Just as Module can be plugged in the software model to Slot Submodule can be plugged into Sub slot This selection is optional if no subslot is selected the form will say No Subslot selected The user can select Subslot for Submodule from existing ones by using the Browse button Figure 55 the left one This can be only done when parent Module is plugged into Slot Otherwise in formation dialog will pop up see Figure 56 To remedy this situation plug Module into some Slot No positions available x You need to plug parent Module to Slot first Figure 56 Message dialog when selection Subslot fails When parent module
9. Warning that specified file already exists After location of project file is specified proceed to next page by clicking Next button 4 2 4 Specify location for generated code Second wizard page asks user to specify location of three files that will be generated based on pro ject configuration e Stack configuration file pnio conf h e Software model configuration file device c e GSDML device description file Version 1 0 0 40 77 per or SUD Happy Clients in Realtime Communication and Control SO 909 The page is presented on Figure 30 File name of GSDML file is not immediately known as it de pends on configuration options As initial setup wizard will suggest to locate these files in the same directory as project file Code generation options Specify paths for generated code files PN configuration D Projects Edipse4 3 examples myProjectipnio_conf Browse PN device D Projects Eclipse4 3 examples myProject device c Browse GSDML location D Projects Eclipse4 3 examples myProject Browse Figure 30 Second page of New Project wizard You may change location where each of these files is to be saved by using Browse button Be care ful to not overwrite some previously created files Wizard will warn user if pnio_conf h or device c files already exist in location specified see Figure 31 lolx Code generation options One or more of selected files already exist PN
10. Wizard has only one page shown on Figure 86 Page is used to specify Pa rameter properties User has to at least provide valid name of new Parameter EE o Parameter properties Set properties of parameter Name pm_example_u16_12 Index 0x000e An example Description Data Type Unsigned 16 Data Lenath 12 crci Figure 86 Create new Parameter Wizard Version 1 0 0 72 77 per C Happy Clients in Realtime Communication and Control Parameter objects that are no longer used in any Submodules or Record Data objects can be deleted from software model This can be done either through editor or Outline On editor page for Parameters user can select unwanted Parameter nodes and click key In Outline Parameters can be removed using context menu see Figure 87 San Outline 23 General amp Device Description Software Model gt Modules l gt 64byte I 0x30 48 gt 64 byte I 0x1 lt gt 64 byte O 0x31 49 H lt gt 64 byte IO 0x32 50 Slots El gt Slot 0x1 gt Subslot 0x1 i H Slot 0x2 Parameters A gt Paramet gt Paramet gt Paramet gt Parame Driver Settings Figure 87 Deleting Parameter using Outline View 4 7 11 Settings reference A detailed reference of all available settings for port PROFINET IO stack can be found in the online help of the Design Tool Please open the help system via menu Help gt He
11. are supported e Windows XP e Windows 7 e Windows 8 Additionally a Java Runtime Environment JRE 7 is required Depending on the version the DesignTool 32bit or 64bit that shall be used the according JRE 32bit or 64bit has to be installed Please note that even if a web browser on the target system is capable of running Java applets this does not mean that a JRE is installed in the system To check whether a JRE is installed open a command interface window type java version and press enter If the command could be executed a JRE is installed Please check the version information whether it reports a JRE 7 Version 1 0 0 9 77 per Happy Clients in Realtime Communication and Control 1 5 Installation To install the DesignTool extract the provided archive to a directory of your choice Please ensure that tool has write access to this directory It is recommended to use a directory within the home directory of your user There 1s no further installation required You can start the design tool by executing dsntool on Linux or dsntool exe on Windows When running the DesignTool now it will start in demo mode Depending on the tool type some limitations apply To get the full functionality you have to install the license files which can be purchased from port Please contact service port de for further information To install the license copy the two file license dat and license sig received from port to the direc
12. configuration D Projects Edipse4 3 examples pnio_conf h Browse PN device D Projects Edipse4 3 examples device c Browse GSDML location D Projects Edipse4 3 examples Browse Figure 31 Warning that a target file already exists 4 2 5 Finish project creation After all locations are set click Finish button to create the project You may also get back to previ ous page using Back button If you do not want to continue with new project creation click Cancel Version 1 0 0 41 77 per 4o Happy Clients in Realtime Communication and Control It may be possible that one of selected locations will be inaccessible for the tool For example user running application may not have write rights to selected directory In this case wizard will not fin ish but display error message Figure 32 In this case user has to change specified path and try again Unable to create project x Unable to write to file L j D Projects Eclipse4 3 examples project_A dsntool E Figure 32 Error message when projects files could not be created During wizard finish user will be once again warned about every overwrite risk that was detected and asked for confirmation Figure 33 In case of any doubts click Cancel to postpone project creation Otherwise click OK to continue CI x File already exists Overwrite EE D Projects Edipse4 3 examples project_A dsntool D Projects Edipse4 3 examples pnio_conf h
13. entry is labeled with parame ter name and index Parameter objects can be shared so there is no need to create multiple instances of the same param eter To add already existing parameter to Submodule parameters use Choose Predefined button Clicking the button will open simple selection dialog with list of Parameters available for selection Please note that parameters that are already assigned to the Submodule are not available for selec tion To add predefined parameters to the Submodule select their entries in the dialog and click OK You can select multiple rows by holding key while selecting User can also add new parameter to Submodule Clicking on Create button will launch Create Pa rameter Wizard After wizard finishes the newly defined Parameter will be added to the list It will then also be available to add for other Submodules To remove object from list of Submodule Parameters use Remove button First using mouse and key highlight all entries on the Parameters list that you wish to remove Then click the but ton Notice that this only removes Submodule to Parameter reference Parameter will still remain in project and other Submodules which use it will remain unaffected However if you really want to remove Parameter object all together check Parameters chapter 4 7 3 Create anew Module User can have much more Modules in his her Software Model than the three ones predefined in new project template One can add new
14. linking it to Record Data object 4 7 1 Modules Module represents process interface Initial project template for PROFINET comes with three ex ample modules already defined They can be changed or removed depending on user preference The following section describes the different module properties users can set Version 1 0 0 49 77 per Happy Clients in Realtime Communication and Control Name Name 64 byte I Figure 40 Module name input field Human readable name of the module Maximum 100 characters Should be concise yet descriptive Uniqueness is not enforced but should be avoided as potential source of confusion Name of module is shown as its label in tree view It will be put into software model code as well as device description code Identification number Ident Number 0x00000030 Figure 41 Module number input field Identification number of the module Unsigned 32 bit integer Each module in device must have unique number Numbers below 3 are reserved Module number together with the name are dis played as Module s label usually in both hexadecimal and decimal in parenthesis format e g Module nineteen 0x13 19 When changing number value one can use his her preferred format decimal octal with prefix or hexadecimal with Ox prefix New value won t be accepted when previously mentioned con straints are not met the red error sign will appear next to input field Description
15. of common issues that may be reported during validation and how they may be resolved PROFINET projects share editing tools with other port DesignTool project types To learn about basic editor elements such as toolbar or input forms see help pages for common functionality port DesignTool User Guide 4 3 Editor Extensions 4 3 1 Top Page After project is loaded editor will display graphical top page for it User can always return to this editor page by using Go Hometool int Top page for PROFINET project is presented onFigure 35 Each burgundy red block is a click able link to editor page with configuration elements You can also hover mouse cursor over the figure to display longer description of block contents as tool tip Blocks are organized into three groups General General Settings of PNIO stack configuration Device Description Settings related to creation of device description file Software Model Structure of objects of which application s software model is made plus configuration of the driver Version 1 0 0 43 77 Happy Clients in Realtime Communication and Control General Figure 35 Top Page for PROFINET project 4 3 2 Modules Slots Page Modularity of PNIO stack is represented in software model Process interfaces are separated into Modules and Submodules while addresses are represented as Slots Sub slots Number and proper ties of these objects are to be specified by the user with each new proje
16. prefix New value won t be accepted when previously mentioned con straints are not met the red error sign will appear next to input field Description Description z Figure 64 Slot description input Optional user text Can be used to put comments about Slot Module Selection Module selection Module aModule 42 Browse Create Figure 65 Slot Module input Specifies which Module if any is plugged into this Slot If no Module is selected the form will say No Module selected The user can select Module for Slot from existing ones by using the Browse button Figure 65 the left one Clicking the button will open simple list dialog with possible selection options To plug Module into Slot select its entry on the dialog s list and click OK To unplug Module select No Module option Only one Module can be plugged into Slot so only one selection is possible To avoid being redundant current selection is not available to choose from As already mentioned no two Modules can be put into the same Slot simultaneously Therefore assigning Module to Slot X will result in unplugging Module that was plugged to Slot X previous ly The tool detects and warns user if this is about to happen see Figure 66 Version 1 0 0 61 77 per Happy Clients in Realtime Communication and Control Already in use x Module already used by slot 1 Do you wish to continue Figure 66 Module already in
17. project is created The path can be seen on top of code preview j j Browse tab User can change this location using Browse button Browse in code preview tab toolbar If auto save check box is selected the code file will be rewritten each time project changes are saved to disk User can also save file manually using Save toolbar button Contents of device c file depend on what Modules Slots and Parameters are defined You can get more information about software model in Software Model chapter GSDML Device description which is needed for IO controller to properly initialize connection with PNIO device is saved in GSDML format GSDML is a XML document which contains PROFINET de vice description GSD Code can be displayed for inspection using appropriate editor tab Directory where GSDML file should be saved is specified when project is created The path can be seen on top of code preview tab User can change this location using Browse button Browse in code preview tab toolbar The file name is created based on GSDML specification v 2 3 and is made of following segments e GSDML e GSDML version e Manufacturer Name e Device Name e Date File name segments are configurable Tip It is easy to get confused when changing of GSDML settings cause multiple copies of GSDML files to be created Therefore it is good practice to keep all files associated with one project in separate folder Be careful to no
18. task list Tasks application part is used to view all tasks for currently loaded projects It can be revealed using Show Tasks View menu item Tasks 3 all Set your PI assigned Vendor ID do not use port s number project_A dsntool Device Identity Specify description for every module project_A dsntool Modules Configure GSDML attributes name of manufacturer and de project_A dsntool GSDML Figure 22 Example contents of Tasks View On Figure 22 example contents of Tasks View are presented The entries are grouped by project they apply to Each task entry can be viewed using separate dialog which may be more convenient way especially if task description is long To display task details right click on task entry and select Details from menu Task Details x Project name broject_A dsntool Path D Projects Eclipse4 3 examples project_A dsntool Description Configure GSDML attributes name of manufacturer and device Location stackSettings branchName DeviceDescription containers branchName GSDML Figure 23 Task Details dialog for example task Version 1 0 0 33 77 per Happy Clients in Realtime Communication and Control Example task opened in Task Details dialog can be seen on Figure 23 Contents include Project name Name of project associated with this task e Path Location of project file name in the file system e Description Description of task this field should give inf
19. to read from file problem Error Error while project save Example Error while project save C Documents user project_1 dsntool Access denied Solution This error appears when project file cannot be written You should check if user running application has write access to the file and whether there is free space available on device Error Unable to write to file Example Unable to write to file C Documents user file c Access denied Solution This error appears when one of project related files cannot be written You should check if user running application has write access to the file and whether there is free space available on device Error Unable to get setting value Solution This error usually appears during code generation This indicates that the project file was corrupted or is opened with wrong e g obsolete version of the tool Most likely the direct reason is setting value written in incorrect format It should be possible to remedy this by changing value of the setting that was identified as source of problem Warning Setting value not found Default value XXX used instead Solution This warning may appear during code generation It indicates that value of configuration setting was not specified in project The warning will cease to appear when user will set the value and save project The warning may be an indication that user haven t finished all project tasks Warning Loaded project has version higher th
20. un saved changes It is recommended to close projects that are no longer in active use to save program resources and remove entries associated with project from Tasks and Problems Views i x Name broject_A dsntool Path D Wrojects Edipse4 3 examples project_A dsntool Type PROFINET PROFINET crci Figure 20 Project Properties dialog Version 1 0 0 31 77 per C Happy Clients in Realtime Communication and Control Figure 20 shows an example Project Properties dialog You can open this dialog by right clicking on selected project entry in Package Explorer and selecting Properties from menu The dialog dis plays e Project name equivalent to file name e Location of project file in file system e Type of project 3 5 3 Validation Project validation is a process of checking correctness of project data Validation is supposed to detect problems with project structure that can happen when project file becomes corrupt as well as smaller issues e g when two setting values contradict each other Project validation is performed in following circumstances e On project opening right after project file is loaded from the disk e On project save right before changes are saved to disk e On user request Validation may be requested by right clicking project entry in Package Explorer and selecting Vali date from the menu At the start validation process clears from memory all previously detected probl
21. use warning The same effect of plugging Module into Slot can also be achieved by using Create Connection tool on model blocks The Create button the right one on Figure 65 is a shortcut that allows to define new Module and plug it to the Slot at the same time 4 7 6 Subslots Subslot is a child object for Slot Each Slot must have at least one Subslot defined One can browse Slot s children using tree view inside editor Slot nodes Subslots of Slot 0x2 E Sot x Seot Ox 1 Ej Slot 0x2 Number Subslot Oot Suibslat x3 Figure 67 Fragment of editor page for Slots Subslot 19 a child object for Slot From Slot s editor page user is able to create new Subslots and remove existing ones Subslots Add Subslot Remove subslot Figure 68 Subslots management input Use Add Subslot button the left one on Figure 68 to create new Subslot and add it as child of cur rent Slot Clicking on button will launch Create Subslot Wizard Use Remove Submodules button the right one on Figure 68 to remove Slot s Subslots Clicking on button will open simple selection dialog with list You can select more Subslots than one by having key pressed while clicking on the entries Remember Every Slot must have at least one Subslot The tool will not allow to remove all Subslots of a Slot Version 1 0 0 62 77 per Happy Clients in Realtime Communication and Control The f
22. 0000 00 0 0 0000000000000 0000000000000000 000000000 000 0 0000000000000000 000 0 Figure 76 Create new Record Wizard Record Value After Record is defined it can be modified by using Edit button next to its label see Figure 74 Clicking on the button will re launch wizard for selected Record Record can be removed from the model by using Remove button next to its label see Figure 74 4 7 7 Create a new Slot User can have much more Slots in his her Software Model than the two ones predefined in new project template One can add new Slot to the model by selecting Slots editor block and using Cre ate Object tool Hh New object is defined using Wizard dialog The wizard can have up to two pages first one to speci fy Slot properties and optional second one to select Module Version 1 0 0 66 77 per Happy Clients in Realtime Communication and Control SS 18 5 Slot properties Set properties of slot Number 42 An example Figure 77 Create Slow Wizard First page of the wizard is presented on Figure 77 Completing this page is needed to create the Slot User has to at least provide valid Slot number to continue Remember that Slot number must be unique After number is specified the user is free to finish the wizard by clicking the Finish button Option ally he can proceed to the next page where Module can be assigned to Slot The page is presented on Figure 78 Version 1 0 0 67 77 per
23. 9 New Submodule Wizard Subslot selection sss 60 0 TUNG T a erases dese 2277029212 E CEE 0A EEE 60 Tea e cena E T 61 Slot Modne TiO 2225200024209020 A vec noneioeeseeseescannseteateaveesenedusest EA Grae aeeies 61 Module already in use Warning aera aaa ST 960644 STT TOTES VRAS TET 62 Fragmen of editor page 10f SIOS seisi aa iaa aT RRR To Ranna 62 eE eK Ta E eT 62 SUBSOL DH DET TMPU T 63 Subslot description 1NPUT TTT 63 SOROR UUNO DUC T 63 Message dialog when selecting Submodule ails sss sese 64 Warning when submodule is alread in use sss sese eee 64 7 77 Figure 74 Figure 75 Figure 76 Figure 77 Figure 78 Figure 79 Figure 80 Figure 81 Figure 82 Figure 83 Figure 84 Figure 85 Figure 86 Figure 87 Version 1 0 0 per Happy Clients in Realtime Communication and Control SUDSIOLTECOLCIS TE 64 CRG Ale NEW Record WV CA D 65 Create new Record Wizard Record Value sese sese 66 Create SIOW Wizard acces esencesnsie cect vavnsecnaieccecsravaaneaateceucaiesuseensesieecs eo 00 00 POCE C0009400 003008 67 Create Slot Wizard Module selection ic sinss ir E E 68 New Subslot Wizard eeren e 2035060065220602 EEEE EE 69 New Subslot Wizard Submodule selection sese sese 70 Paramter namne HID oa EET ENE EESE 70 Parameter N46 o gt 10 e A EA eee ee eee 71 Parameter description e TTT 71 Parameter data type DPU sacceksssnessscarsnovansstavesunvencednerpecesrarmucsanesuesrsasvencelanapesedasadnasdoneassaaes 71 Paramater
24. Communication and Control ii x _ You need to plug Module to parent Slot first Figure 72 Message dialog when selecting Submodule fails When parent Slot has Module plugged Browse will open simple list dialog with possible selection options These are Submodules of parent Slot s Module To plug Submodule into Subslot select its entry on the dialog s list and click OK To unplug Submodule select No Submodule option As Submodule can be plugged only in one Subslot at the same time only one option can be selected To avoid being redundant current selection is not available to choose from As already mentioned no two Submodules can be put into the same Subslot simultaneously There fore assigning Submodule to Subslot X will result in unplugging Submodule that was plugged to Subslot X previously The tool detects and warns user if this is about to happen see Figure 73 Areadyinuse x x Submodule already used by subslot 3 J Do you wish to continue Figure 73 Warning when submodule is alread in use The Create button the right one on Figure 71 is a shortcut that allows to define new Submodule and assign it to the Subslot Records Add new record Record pm_test_U32 0x0021 Edit Remove Record pm_test_U16 0x0001 Edit Remove Record pm_test_U08 0x0016 Edit Remove Figure 74 Subslot records input Subslot can be a parent for number of Record Data Objects The Record definition is made of two e
25. Control 3 Basic concepts This chapter describes the usage of the DesignTool platform which applies to all available protocol versions 3 1 Introduction Using port DesignTool is working with projects Your DesignTool product can support one or more project types depending on number of features installed If in doubt you can check what project types are supported by opening About dialog from Help menu Project configuration is stored in project file on local file system User is asked to specify location of this file during project creation For changes not to be lost project needs to be saved to file after modifications are made port DesignTool application window 15 separated into parts with movable borders and changeable layout The placement of application parts is called perspective Changing perspective can be helpful to adapt tool to screen size and user preferences Each opened project can be displayed in its own editor tab located by default in center of application window By interacting with editor user can browse through project and modify its configuration Typically configuration settings are laid out in form and use one of few basic input widgets If problems are detected by port Design Tool application it will attempt to collect information about them and present it in user friendly format User is then able to diagnose the problem and resolve it using this documentation as reference Problems may arise if applicati
26. Description Figure 42 Module description input field Additional text information about Module It will be put into GSDML file Slot selection Slot selection Slot 1 Figure 43 Module Slot selection field Specifies into which slot module is plugged This selection is optional if no Slot is selected the form will say No Slot selected Version 1 0 0 50 77 per fot Happy Clients in Realtime Communication and Control The user can select Slot for Module from existing ones by using the Browse button Figure 43 the left one Clicking the button will open simple list dialog with possible selection options To plug Module into Slot select its entry on the dialog s list and click OK To unplug Module select No Slot option As Module can be plugged only in one Slot at the same time only one option can be select ed To avoid being redundant current selection is not available to choose from As already mentioned no two Modules can be put into the same Slot simultaneously Therefore assigning Module to Slot X will result in unplugging Module that was plugged to Slot X previous ly The tool detects and warns user if this is about to happen see Figure 44 Already in use rg X _ Slot already used by module 48 Do you wish to continue Figure 44 Warning if slot is already in use The same effect of plugging Module into already existing Slot can also be achieved by using Cre ate Connection tool
27. Identity Set your PI assigned Vendor ID do not use por project_C dsntool Device Identity Specify description for every module project_C dsntool Modules Configure GSDML attributes name of manufact project_C dsntool GSDML Configure device MAC addres project_B dsntool Network Figure 7 Tasks View with example contents Task View application part filled with example task entries can be seen on Figure 7 Numbers on top of table refer to numbers of items shown and in the parenthesis number of all items including hidden ones Finished tasks are either hidden by default or grayed out The table has three columns e Description Describes actions necessary to complete task if too long to read use context menu to display task details Project Name of project Location Name of root element inside project that needs to be modified for task to be com pleted Context menu available through right mouse button has following items Table 7 Task View context menu options Reveals location associated with selected task in the editor Equivalent to dou ble clicking on task Set Set As Completed Set As Completed Temporarily sets selected task as completed sets Temporarily sets selected task as completed task as completed Show Hide Com Shows or hides completed tasks pleted Refresh gt Checks all tasks and updates their status si i is s sS Y all tasks and Checks all tasks and updates their status si i is s s
28. Internet http www port de Version 1 0 0 YT per Happy Clients in Realtime Communication and Control Table of Contents l Introduction 1 1 Applicability of the Documentation sss sese eee eee eee La Poa Or a E a R E N EE EA NEA L3 Producer K E ee E E E LA System REGuiTements ainn bo asa O A E EE EE E EE 2 Introduction to PROFINERT ssss sees 2A 511 Ses 15T ON enni eE OEE AE EAEE A 22 TIO CO iW E e E E R S ZD TRIODO ia E AEE AT 24 _ The 15 C015 7 eE EE 004 GB RV 23 R TOD TTT 2 6 The IO Record Data sss E Ia N 9 Te Data ODES socer r 2 8 Slots and Modules sss sss sss sees 3 ST Te ca e lt 0 T 34 DOUCO TTT S 1 E E E EE EO E E 35 24 ENAN a E E E em den 32 2 TheFile MENU caccacocanccencssearstanscpavaareueaacescnesonneseassunsativasemtaereecegvoneest 523 _ The El ME eer EE E A EEA 324 The VINO Meee N T S 5235 PER 0 20 e 1 7 35 37 An eana T a ene eee ee 3 3 1 _ Application Perspective a i wetosesavacionwssnctons avsviendbanetesssansusacrenctens enemas 352 Package EXplo r tr En a ee 3523 IN acca occas cence E EEE T EE ap PROP RNA ERNE E p lt Jao PODI erna eee ee eee one reer 5 7 lt NACI e a E E E A E N A FP ONG a E E E cusneeee 3 4 1 Configuration widgets sss sese Version 1 0 0 per Happy Clients in Realtime Communication and Control E Tour CV RU esse ne pene se ne ws dss eos nsec casas sana was dese eee cone eines aes 29 54 3 _ Assistance O pti6 is oen N A A N 29 3 4 4 Confi
29. Model Obligatory step of PNIO stack configuration is definition of software model The software model is supposed to reflect modular and hierarchical structure of hardware it was derived from Modules and Slots The model isolates process interfaces from addressing The former are represented by Modules and the latter by Slots Each of these object types is further separated into one or more child objects Modules contain Submodules Slots contain Subslots On Figure 39 the concept was illustrated with a simple example Version 1 0 0 48 77 per Happy Clients in Realtime Communication and Control DAP Submodule Module 3 Submodule Submodule Figure 39 Example device modules and slots port PNIO device stack comes with predefined Modules number 1 2 and Slot O for Device Ac cess Point DAP These objects are not available for editing User is free to add and remove objects in software model with the limitation that minimal user specified software model has one Module and Slot Also each Module and Slot must contain at least one child Submodule Sub slot Software model can define connection between Sub Module and Sub Slot in other words plug Module into Slot Parameters and Record Data Each Submodule object can be parameterized by referencing one or more Parameter objects Pa rameters are addressed using 16 bit unsigned index number Submodule parameter can be made accessible for IO Controller by
30. Module to the model by selecting Modules editor block and using Create Object tool i New object is defined using Wizard dialog The wizard can have up to two pages first one to speci fy Module properties and optional second one to select Slot Version 1 0 0 56 77 per Happy Clients in Realtime Communication and Control A si LX Module properties Set properties of module Name TheNewOne Ident Number 42 This Module is the answer Figure 59 Create Module Wizard First page of the wizard is presented on Figure 59 Completing this page is needed to create the Module The properties name ident number and description are equivalent to these described in chapter 4 7 1 You have to at least provide valid name and address for the wizard to continue Re member that Module number must be unique After name and identification number are specified the user is free to finish the wizard by clicking the Finish button Optionally he can proceed to the next page where Module can be assigned to existing Slot The page is presented on Figure 60 Version 1 0 0 57 77 per Happy Clients in Realtime Communication and Control EN 1915 Select Slot You can select in which slot to plug module This step is optional gt Slot 0x2 Figure 60 Create Module Wizard Slot selection Selecting Slot that is already used will result in warning message appearing on top of wizard page If the user will de
31. Realtime Communication and Control Table 9 Checkbox example Enable the reception of LLDP frames Table 10 Numeric setting example Hardware Revision 0 lt Numeric value lt 65535 Numeric settings are represented by spinner input You can change value either clicking on the little up or down arrow buttons or by keyboard Numeric inputs can be constrained to specific range in which value is valid Valid range is visible through tool tip message which pops up when mouse cursor is hovering over the control Table 11 Hexadecimal setting example Device ID Q 0 lt Numeric value lt 65535 Sometimes the hexadecimal representation of integer number is more user friendly than decimal one For these cases text field input is used User can put new value e g 19 in format he prefers best e decimal 79 e hexadecimal with Ox prefix 0x13 Table 12 Text input example Settings which expect character string input are represented by text fields These inputs are often constrained and only accept values that fit special pattern Table 13 Drop down list example Software Revision Prefix Prototype Release Revision Prototype Field Test Test Device Description Settings with discrete set of possible values use drop down list which allows user to Version 1 0 0 28 77 per fot Happy Clients in Realtime Communication and Control select new value from list of possible ones 3 4 2 Inp
32. S Y their status Displays dialog with details of selected task If Tasks view is hidden it can be restored using main menu item Show Tasks View 3 3 5 Problems Problems view is by default positioned on the bottom of application window This application part contains table with most recent problems identified during application life cycle Version 1 0 0 21 77 per Happy Clients in Realtime Communication and Control JA Problems 3 Warning Error Figure 8 Problem View with example contents Problems View can be seen on Figure 8 The problems table has three columns Description Information about problem color of icon depends on severity red error yel low warning blue information Project Name of project if problem can be linked to single project Location Location inside project where problem was identified Context menu available through right mouse button has following items Table 8 Problems table context menu options Shows separate dialog with details of the selected problem 3 3 6 Editor Editor is the most important application part of port DesignTool and the only one that can have multiple instances in one application window one for each project The purpose of editor is to present user with convenient tools to modify project Tracking changes Editor keeps track on project data modifications When changes are made through editor that are not yet saved to projec
33. Submodules per Module set ting value e There are more Subslots in Slot than Number of device Subslots per Slot setting value These problems can be fixed by either removing excess objects or by correcting corresponding setting value Error Unable to save new project Solution The error is reported during new project creation when save of initial project contents to file fails This renders created project unable for future use User should check if disk has enough free space and whether application has write permission for the file in question Error IO error while saving GSDML file Solution The error is reported when attempt to save GSDM L file to disk fails User should check if disk has enough free space and whether application has write permission for the file in question Error Problem while saving GSDML stylesheet Solution The error is reported when attempt to copy stylesheet file to the same location as GSDML file fails User should check if disk has enough free space and whether application has write permission for the file in question Error Code generation failed Example Code generation failed Record has no parameter Solution Error is reported when due to incorrect project configuration generation of code was una ble to finish Error report should contain a link to object that caused the problem and which needs to be fixed Version 1 0 0 77 77
34. an structure supported by tool Example Loaded project has version higher 1 2 than structure supported by tool 1 0 Solution This warning appears when project file is opened with obsolete version of the tool It is recommended to update tool before modifying project or to create backup of project file 7 Appendix C PROFINET Task Reference UNFINISHED TASKS NEED REVIEW Task Configure device MAC address Location Network Details In case of some devices user must specify device s MAC address explicitly Change the address to something other than 00 00 00 00 00 00 to silence the task Task Supply device information Location Device Identity Version 1 0 0 75 77 per Happy Clients in Realtime Communication and Control Details GSDML file should contain short textual device description Task will be open if Device Information setting is empty Task Set your PlI assigned Vendor ID Location Device Identity Details As a part of device description Vendor ID is specified This 16 bit integer number is as signed by PROFINET International For new projects Vendor ID setting 1s initialized with port sown number Ox28c You need to change this value for the task to be completed Task Specify description for every module Location Modules Details For device description each defined device module can contain short information text This task checks presence of these texts the lack of whose may suggest that t
35. ang Integer hy dsntool Limited Setting RPC_DEVA 2 Setting value not found Default value 1 was used instead hy dsntool Int Setting RPC_DEVANN Unable to get setting value null hy dsntool Int Setting RPC_DEVANN An exception occurred while delegating evaluation of the ValueIsOptionsIndex co hy dsntool Limited Setting RPC_DEVA An exception occurred while delegating evaluation of the IntValueBetweenLimits hy dsntool Int Setting RPC_DEVANN Running as demo version 1 O error occured while loading license file File does not exist D Devtools eciipse Object has more children than specified in setting stackSettings branchName pn dsntool Slots Figure 24 Problems View with examples To better examine selected problem entry user can open separate dialog with problem details This can be done by clicking on problem entry in Problems View with right mouse button and selecting Details menu item Problem Details dialog opened for example problem entry can be seen on Figu re 25 Problem Details x _ Warning Details Affected project hy dsntool Path D Projects Eclipse4 3 examples hy dsntool Description Setting value not found Default value RPC_SWREV_PROTOTYPE was used instead Location lines number 0 driverSettings branchName Driver 20Settings containers branchName RPC settings name RPC_DEVANNO_SWREV_PREFIX Figure 25 Pr
36. appy Clients in Realtime Commu List of tables Table 1 File MENU OP UOMS eessen naene n EEE EEN S OEE E EE i 16 Fable 2 GME m ni O TTT 17 Table 3 Windovw mentr OO ONS org thes casas case 00000 adeaatnaass e 17 Table 4 Help Ee 18 Table 5 Project node context menu options s 19 Table 6 Outline context menu opt16NS a ssaccnecasoiceceneniesoasvavesensseavicnindesmindeesecieuudxaviasdineveatchisdosnndekusecnseuivenss 20 Table 7 Task View context ment OplONS TTT 21 Table 8 Problems table context menu OPTIONS esse eee eee eee 22 Table 9 Checkbox example sarcstessepetadaceaadhceestatatecadettecanaesseasestieassiataiacadetatecsneastenueatsaeesieasdaauaataseconee 28 Table 10 N mero setting example cece cece cece caat d daa d a Na sA ele E Atm d Cama 28 Table 11 Hexadecimal setting example 0 20520880u090004220 200000000 2008000040200220 0020 4400200 2000304020080044 28 Table MRL a Ie d 06109 ee ne ee eee 28 Table 13 Dropdown 115 TTT T 28 List of figures Figure T PROFINET a Tees 9409020000020000 E S004 9 0 0A E A9 S004 00000909 HDR 13 Figure 2 Main menu with key seleCtOrS cccccccccccccccccccccccicccecoccccccccccccccccccccccoconanaseeeaes 16 Figure 3 Application part label 2 2ccicers isasevisorsesiaitccsamreciscs2ci0 000604 NEEE EEES R A EREE aSa i 18 Fic re 4 Empty Packas EXPO T enea E ES 19 Figure 5 Package Explorer with opened projects esse 19 Figure 6 Outline View with example Contents 20 Figure 7 Task
37. arts This chapter describes the different elements of the DesignTool main window 3 3 1 Application Perspective Application window of port DesignTool is divided into several application parts e Package Explorer view e Outline view e Tasks view e Problems view e Editor Layout of these parts in application window is called perspective Perspective can be changed at runtime for better ergonomics For example selected part can be maximized to fill the window contents This can be achieved by clicking the button next to part la bel see Figure 3 3 Action can be undone by clicking the same button again o 2 3 O oe Outline 3 Figure 3 Application part label Other options for modifying perspective include hiding Figure 3 2 or closing Figure 3 1 selected parts One can also swap positions of parts by drag and dropping the part label or change size of part by dragging part border All changes to perspective are persisted when application is closed To restore default layout use menu item Reset Perspective 3 3 2 Package Explorer Package Explorer shows opened projects and their contents When application is opened with no Version 1 0 0 18 77 per Happy Clients in Realtime Communication and Control projects the part looks similar to Figure 4 New and Open are shortcuts for creating new projects and opening existing ones Package Explorer 5 Workspace is empty New project Ope
38. ation about each of the items is collected in the table below Table 1 File menu options horteut Opens Wizard for creating new projects If application supports more than one project type it first queries user which wizard to use Provided wizard finishes with creation of new project new editor instance will be opened and brought to top Opens select file dialog and then attempts to load project from selected file If operation is successful new editor instance will be opened and brought to top Opens select file dialog to obtain new location for project file edited in currently active editor Can be used to create copy of project file Saves changes done in all opened editors Equivalent to executing Save on every editor Version 1 0 0 16 77 per Happy Clients in Realtime Communication and Control 3 2 3 The Edit Menu Edit menu contains actions for editing project data Short information about each of the items 19 collected in the table below Table 2 Edit menu options Undo last modification of project data in currently active editor ctrl Redo _ Performs again action that was most recently undone tial Hy Cuts text selection from editor or object selection from Outline and puts it into clipboard Co Copies text selection from editor or object selection from Outline and puts it P Tinto clipboard Paste Pastes outline selection into active editor widget or Outline object Cta 3 2 4 The Wind
39. bject Deletes Module or Slot and removes it from diagram To use first click the tool then object you want to remove a Create connection Plugs Module into a Slot To use first click the tool button then the two objects you want to connect If you want to connect objects that already have connections first use Remove connection tool Remove connection Un plugs a Module from Slot To use first click the tool button then one of connected objects Version 1 0 0 45 77 per Happy Clients in Realtime Communication and Control mg Align Modules When clicked redraws diagram to align each connected Module to its Slot d Align Slots When clicked redraws diagram to align each connected Slot to its Module amp Help Tool Displays help for the figure To use first click tool button then one of blocks 4 3 3 Code Preview Editor for PROFINET projects has three additional tabs beside main Design Tab All of these are used for preview of generated code Design pnio_conf h device c lt gt GSDML Figure 37 Tabs for PROFINET editor pnio_ conf h Preview of C header file for PNIO stack configuration device c Preview of C file where software model is defined for use in PNIO stack gt GSDML Preview of GSDML file displayed using HTML style Each time code preview tab is opened its contents are refreshed to match current project configura tion If project contains errors or inaccuracies prev
40. cide to proceed with that selection previous Slot assignment will be overridden 4 7 4 Create anew Submodule Submodules are fully contained in their parent Modules Therefore one has to use Module defini tion to create and remove them User is assisted through Submodule creation with New Submodule Wizard The wizard has up to two pages The first one allows the specification of basic properties and the second one allows the Subslot assignment The second page is only displayed if Submodule s parent Module is plugged into Slot First page is shown on Figure 61 The attributes to specify are the same as described in the chapters 4 7 2 1 4 7 2 8 Minimal input required to proceed is to provide valid name and identification num ber for the new Submodule Wizard automatically suggests the name to be the same as parent Mod ule s but user can change it for more descriptive one Please remember that identification number has to be unique within Module to be accepted Version 1 0 0 58 77 per Happy Clients in Realtime Communication and Control ee 1805 Submodule properties Set properties of submodule Name customIO Ident Number 0x00000004 Input unsigned32 4 Output signed3 Description Data Direction Input Output v Input Data Type Unsigned 32 w Input Data Length 16 K lt Output Data Type signed 8 Ka Output Data Length 1 r Figure 61 New Submodule Wizard The optional second page is shown on Figur
41. ct being initialized with few example Modules and Slots as starting point Editor page for managing Modules and Slots is available from top page under blocks Modules Slots The page itself is presented on Figure 36 Be aware that number and names of blocks depend on your current project configuration Version 1 0 0 44 77 per Happy Clients in Realtime Communication and Control SARA JEE wa n n 22 m SD 22 S m SD AD S 22 AD SD SA QO m SD SD SD S MD O SN SD m SD m SD m m m SD m D m m m m m m aa d Figure 36 Modules Slots editor page Editor page displays diagram of currently specified Modules and Slots Modules being on the left and Slots on the right or vice versa depending what block has led to the page Two gray connected with each other blocks at top of the page represent Device Access Point Modules number 1 2 and Slot number 0 These objects cannot be changed and their identifica tion numbers are reserved not available for user objects Using the page user can navigate to configuration of specific module slot Just click appropriate block add remove objects and create connections between them There is an additional vertical toolbar located on the right side of diagram that contains tools for this purpose B Add Object Creates a new Module or Slot To use first click the tool button then click on empty area inside desired group of figures Modules to create Module Slots to create Slot E Remove O
42. data length Input 1 a sa4 424224247 Haa 2292040222 71 Create Mew Parameter Wizatd TTT 72 Deleting Parameter using Outline View sese esse eee eee 73 8 77 per Happy Clients in Realtime Communication and Control 1 Introduction 1 1 Applicability of the Documentation The documentation of the PROFINET DesignTool by port consists of a User Manual and an Online Help System integrated in the DesignTool Both parts describe the usage of the Unified DesignTool platform and the PROFINET DesignTool in particular 1 2 Product Overview For comfortable and easy configuration and object dictionary management port provides its Unified DesignTool Platform which enables the user to develop communication solutions using port stacks rapidly The individual functionality for each stack is realized by plug ins for each protocol So the user has only to learn how to work with one tool The PROFINET DesignTool contains the Unified DesignTool Platform as well as the plug in for port s PROFINET IO stack 1 3 Product Delivery The PROFINET DesignTool can be downloaded from port s website at http www port de It comes as a zip or tar archive depending on the target architecture which can be extracted using the operating system specific tools 1 4 System Requirements The PROFINET DesignTool is available for Linux and Windows operating systems For both systems versions for 32bit and 64bit architecture are provided The following windows versions
43. doncu scouedodccpacnvtbrreri 44 Moduls Slot 201101 page TTT 45 Tabs for PROFINET 0Mf0T 2322432206 0344600603555224 334360 eee ee eee es 46 Block decorations depening on tasks ccseseeeseseeseessssessssssesssseeeseeseseseseesessesseesseeeeeas 48 Example device pe 0610 ce 146 E le 49 Module name input feld essri insiren inneir EEE EEEE EN EEEE ESE 50 Module number input eld aassssssezanatas craon vataat nara eNe SENPENE n SKENEN EEEREN dide 50 Module description mput Tiei vu4425000446v 0096060040 aeeie NEn NEEN TENES EEES 50 Module Slot selection 0 9 een ee ne areena ee E ene een oe 50 Warninoe il ITR a E 51 Fragment of editor for Module 51 Module s submodule management eld sss sese 52 SOUT ITO CNG Hame TM TTT 52 S bmodule EET T TT 52 Submodule description input zssaszgc asta inaro Ee satana aaa 2 rra oiai haraa osion rinii 53 Submodule date direction 1Nput 0 00 00 0606900320220064 0600 0050000004000060 AAA A0 DS AURR aa UCR 0804 53 Submodule input data type Reem Neer annem ree me ee mee er ame ae mee er eee 53 Submodule inpur data T 53 Submodule output data type oan eee en oe oe ee 54 Submodule output data length sss sees 54 SUubmodule e Le TT 55 Message dialog when selection Subslot Ials sese 55 Dialog warnung that subslot is already iN US 55 SUDMOCUIE parameters PUT eessen a E N E 56 eat OOS VV T 57 Create Module Wizard eT eT o Te 58 New SOLO CU Wizard 252904 E E cones 0A Bn A0 GAR BASC ARD m alu 5
44. e 62 If Submodule s parent is plugged into Slot user can plug new Submodule into Subslot by selecting an entry on the list This step can be skipped Version 1 0 0 59 77 per Happy Clients in Realtime Communication and Control Select Subsiot Select Subslot to be set as Submodule subslot gt Subslot 0x1 submodule anotherOne gt Subslot 0x3 Finish Cancel Figure 62 New Submodule Wizard Subslot selection The wizard will warn if selected Subslot is already used by other Submodule Because only one Submodule can be plugged into Subslot at the same time the previous assignment would have to be removed 4 7 5 Slots Slots are used to represent addresses within the device In the initial PROFINET project there are two example Slots defined They can be modified or removed by the user The following section describes the different properties a user can set for slots Number Number 0x0001 Y Figure 63 Slot number input Version 1 0 0 60 77 SUD Happy Clients in Realtime Communication and Control ISO 9001 Identification number of the Slot Must be unique Value is a 16 bit unsigned integer Value is reserved as Device Access Point DAP Slot s number is displayed as its label usually in both hexadecimal and decimal in parenthesis format e g Slot Ox10 16 When changing number value one can use his her preferred format decimal octal with O prefix or hexadecimal with Ox
45. ems for project about to be validated This allows to eliminate from the view problems that were resolved since previous validation run After validation completes you can review all detected problems using Problems View It can be revealed using Show Problems View menu item Automatic validation before project save will interrupt the process if problems are detected User will be asked to make decision whether to continue saving invalid project data see Figure 21 It is recommended to cancel save check out reported problems fix them if possible and try again Users should be aware that attempting to use such corrupted project to generate code may result in incor rect result x Problems were detected in the project Continue ma me Figure 21 Tool asks for confirmation if problems were detected during project saves For information about problem handling and most common problems and solutions see dedicated chapter Please also refer to user guide appropriate to project type Version 1 0 0 32 77 per Happy Clients in Realtime Communication and Control 3 6 Tasks 3 6 1 Introduction port DesignTool user assistance system comes with task list functionality Task list is a list of ac tions that need to be performed to properly configure project The tool is able to check the project data against the task list and identify which tasks are completed and which remain open Each pro ject type comes with separate
46. err aR 48 4 7 The PROFINET Software Node anczan anaa ERROR Na RR rs 48 E MOE TTT 49 26 50 O lO e E E EEEE E E A E ere 51 Version 1 0 0 4 77 per Happy Clients in Realtime Communication and Control 4 7247 oe en ee A E ee eee 352 4722 Tlentification Ta eT 2902200090504043 nen ee ARAOR u 52 47223 De PO nean E A AEE EE een ee ee 53 4724 Pa DIE Te e A E EEA E AE E E E 53 47223 MMO AIA Type HT 53 4 7 286 _ T pat Data Ee es a 020200025 AA Na debeat RAAN ADE 53 tech 9 51 A K s T 54 4 7 2 8 Output Data Length sss sese 54 AI _ SUDSIOC SCICON Ee te A NS 55 47 2 10 ale AV AMIN EA EEE E AEA E E E E 56 DTS CEE a EWN MOQUE eorna R oh EE EEE EE 56 AGA Creare anew SUDMOM UNS c5stcecsdanestett deniscattaassssecaecadaweseettigndceatoatsesncancadaneseutiiendeeness 58 c S SE gt 0 a ee E E eee eee ee 290070 60 ETO 0 c TTT 62 4 O _ Create a Dew SIG TTT 66 478 _ Eta A WO e r ee A E E EET GE CAA RE EEN 010 68 v e BROD 2 152 13 Te e TTT 70 47 10 Create Delete Parameters ss sasiesete vocwsepoaaorcteswdeuayeasiadehensceseyinasvnuchessdesapoasaqvede naeecpoesvaaedse 72 BMA Ss ET s TETE YT 73 5 Appendix A Abbreviations 0 0 0 0 ccccccccccccccccccccnsesesessssseseeeeecececeeeeeeeeeeaaaaaaessssseceeeeeeeeeeeeeeeeeeaaas 74 6 Appendix B Common vets T 74 7 Appendix C PROFINET Task Reference sss sese 75 8 Appendix D Common PROFINET problems esse sese eee ee 76 Version 1 0 0 5 77 per nication and Control H
47. escribed in the next section If problematic object or setting is identified use help tool built into editor to open help page about it You may also check if user guide document for your project type has Common Prob lems section After modifications were made to resolve issues you can re run project validation and whatever action that had caused problem messages to appear in the first place e g code generation If prob lem reports won t appear again the issue was fixed 3 7 5 Common problems For a list of common problems and their solutions please see chapter 6 Version 1 0 0 37 77 per Happy Clients in Realtime Communication and Control 4 PROFINET Design Tool This chapter explains the usage of the PROFINET specific features of the DesignTool 4 1 Introduction To start using port PNIO stack with own application one has to e Define Software Model e Create Application Code e Create Device Description GSD GSDML file To assist its customers with getting started quickly port provides DesignTool utility application port DesignTool for PROFINET comes with easy to use forms and wizards which make it easier to configure PNIO stack to user needs Functionality provided by the tool include e Generation of stack configuration file e Generation of software model definition file e Generation of device description GSDML file e User assistance for each configuration setting e Detection of common configu
48. example You can create a lot more slots and subslots inside your device Figure 1 PROFINET device model Please notice Slot 0 is pre defined as Device Access Point DAP It represents the device s bus interface and should not be changed Subslots Submodules and IO Data It is analogue to the slot and module issue only one addressing level deeper Within the submodule definition it has to be declared as Input from the controller s point of view the IO device is provider Output from the controller s point of view the IO device 1s consumer or none Please notice For a proper configuration a slot must have at least one subslot defined Parameters Parameters belong to a certain submodule They are addressed on the submodule by an index To have them written or read by the controller they have to be linked in the software model to their corresponding Record Data Objects Version 1 0 0 13 77 per Happy Clients in Realtime Communication and Control General Device Information There is an amount of general information such as the MAC address the IP address or the name of the device or the device ID and vendor ID For a successful ident request at least the mac address and the name of the device have to be set by the user Other device parameters like the IP address can be set by a hardware configuration tool once the device is working Version 1 0 0 14 77 per Happy Clients in Realtime Communication and
49. guring your pDrOIGCTL ey 29 6 3 PO lt ene ren ee ne en ae 2090200224914125 a ere 29 33 41 OI CCl LN TTT 30 332 Project PLO ee a TT 30 ce NO eee ee Stee eer Pens eee neers eer eet Sener eens eee nee eer ree Senne er eee Seen Serre oer 32 BGG e 0219209 P 2001222019092007 210 2909920029 E E E A EE 2201 EEEO 2210007200 33 36 44 O O e 0220000540405546 201002206 se sectostasisdalonpuciseastenedeadcuesetecuesssseecteusaconadeate 33 302 VV OMI With Tas T 34 S _ Problem x ata 34 6 24 In E lt a L 9V0 A ee A 9040 A E 09 0 T E 209102 2909 0 EPEE treet ae OE tet 35 r PLobleni ty TTT 35 E Problem properti s enn AN SN 35 3 7 4 Resolving problems T 3 7 3 23 R a T ee e T 37 d PROLINE EDE itr TOO icy tesa acct tees 1552004495224466 A E A 38 PM tat css lt r 6 E S atest anise E 1110022106 20010006 200051105 00006 21000 E00A0 30 38 42 PROFINET POC TTT 38 Beek PLO ECC TYPE TTT 38 4 2 2 _Creatine New PROFINET Project ievcseesssiswcsssaxctavessiansnesscsuwesseiiwchosavetavestianenesedeueeseeuauns 39 4 2 3 Specify project file Location av cscrcssesvivciincrcrcnracndrocecnd rennen aini aT aniria 0A riar Rnb RE ine 39 4 2 4 Specify location for generated Code sss 40 AZS Wii SI pro cE dT 41 Ao VO a E EE E E E EIEE EEE AE E E A 42 43 NOR eG T 43 Aol TOPPA Oer EE EEE E E E 43 43 2 Moale o Pae eee EE E E E AAA 44 4 23 3 OTE T a ne AE RAA E E AE 46 v CEA A Oa E E E E A AAA ARE 46 o 13 E E E EE E E E E eee 48 46 Common PROFINET problems enn mer ne
50. he Module is not con figured yet Task Configure GSDML attributes name of manufacturer and device Location GSDML Details According to the GSDML specification name of device description file has to be made of certain elements These elements are configurable via GSDML configuration block User should change these settings so they represent his use case 8 Appendix D Common PROFINET problems Error An exception occurred while delegating evaluation of the XXX constraint on YYY Examples An exception occurred while delegating evaluation of the ValueIsOptionsIndex con straint An exception occurred while delegating evaluation of the IntValueBetweenLimits constraint Solution The error will be reported if setting value is in incorrect form This most likely means that the project was loaded from corrupted file In case of two given examples it should be possible to fix problem by changing values of problematic settings Warning XXX constraint is not satisfied for YY Y Examples IntSetting IntValueBetweenLimits constraint is not satisfied for LimitedSetting ValueIsOptionsIndex constraint is not satisfied for Solution The error will be reported if configuration setting or object violates project constraints Since application is designed to keep user from breaking these constraints during normal project editing presence of this report may mean that the project file was corrupted Still it should be p
51. he value is a 16 bit unsigned integer Should be consistent with data type That means it has to be divisible by byte size of the unit Depending on data type valid values are e None 0 e Unsigned 8 1 2 3 4 65535 e Signed 8 1 2 3 4 65535 e Octet String 1 2 3 4 65535 e Unsigned 16 2 4 6 8 65534 e Signed 16 2 4 6 8 65534 e Unsigned 32 4 8 12 16 65532 e Signed 32 4 8 12 16 65532 4 7 2 7 Output Data Type Output Data Type Octet String v Figure 53 Submodule output data type Specifies type of output data Possible options are e None for when data direction is neither an Output nor Input Output e Unsigned 8 unsigned 8 bit integer number values from 0 to 255 takes one byte e Unsigned 16 unsigned 16 bit integer number values from 0 to 65535 takes two bytes e Unsigned 32 unsigned 32 bit integer number values from 0 to 4294967295 takes four bytes e Signed 8 signed 8 bit integer number values from 128 to 127 takes one byte e Signed 16 signed 16 bit integer number values from 32768 to 32767 takes two bytes e Signed 32 signed 32 bit integer number values from 2147483648 to 2147483647 takes four bytes e Octet String string of characters each of them taking one byte Data type setting determines output unit Output data length determines how many output units there are 4 7 2 8 Output Data Length Output
52. iewed code may be incorrect or code will fail to generate altogether In any case project validation should provide clues about nature of the prob lem 4 4 Code Generation The PROFINET DesignTool generates several files to be used within the port PROFINET IO Stack This chapter gives a short overview over the meaning of the different generated files and how to view them pnio_conf h pnio_conf h file is a C header file which contains macro definitions needed for PNIO stack configu ration Code can be displayed for inspection using appropriate editor tab Location where pnio_conf h file should be saved is specified when project is created The path can be seen on top of code preview tab User can change this location using Browse button Browse in code preview tab toolbar If auto save check box is selected the code file will be rewritten each time project changes are saved to disk User can also save file manually using Save toolbar button Version 1 0 0 46 77 per Happy Clients in Realtime Communication and Control Contents of pnio_conf h file depend on configuration of project settings Project settings their meaning and significance are described in Settings Reference chapter device c device c file is a C code file which contains structure definitions of application software model Code can be displayed for inspection using appropriate editor tab Location where device c file should be saved is specified when
53. igure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 Figure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Figure 56 Figure 57 Figure 58 Figure 59 Figure 60 Figure 61 Figure 62 Figure 63 Figure 64 Figure 65 Figure 66 Figure 67 Figure 68 Figure 69 Figure 70 Figure 71 Figure 72 Figure 73 Version 1 0 0 per Happy Clients in Realtime Communication and Control Contents of Select Wizard dialog with PROFINET entry ceeeeeeesessssesssssssssseeeens 39 First page OF New Project Wizard 4 2502245600302064000025004 3402 6548004030 b 040050008 0040ed sesso Na 40 Warning that specified file already exists cccccccccccseeeeeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeeeeeeeeeees 40 Second page of New Project WIZard cccccccccccccciciccccccccccccccccccccicicccccceeeeeaas 41 Warning that target file already CXIStS aace HHT ar Ko SNOT Caderas t 41 Error message when projects files could not be created 42 The user has to confirm file OVerWrite cccccccccccccccccccccccccccccccccccccccicicccccenenns 42 Dialog with results of explicitly request project Validation ccccccccceceeeeeeeeseeeeeeeeees 43 Top Page for PROFINET project z mwass rsosisiciocsircosdokccvecirtcostcici
54. is change will be overridden the next time task is checked by the application If task description is not sufficient in explaining what should be done refer to user guide for given project type Double click on the task entry and use editor s help tool to open help page most rele vant to topic at hand 3 7 Problem Handling There are different types of problems one can encounter when working with project Tool may fail to access project file due to Input Output error project file may be corrupted and unable to be read or project configuration may be self contradicting in a way that can be detected using project vali dation In any case the effort was made to have tool detect most of these errors and to keep problem re ports for user to explore Version 1 0 0 34 77 per Happy Clients in Realtime Communication and Control 3 7 1 Log file All error handling information is written to log file right after problem is encountered This file is not generally thought to be of assistance for normal users due to technical nature of its contents It may be helpful though to prepare copy of this file when reporting a bug to port GmbH user sup port Log file is a normal text file located under path INSTALLATION_DIR workspace metadata log where INSTALLATION_DIR is an address of directory port DesignTool was installed into 3 7 2 Problem types Problems can be classified depending on their scope and severity Problem scope
55. is plugged Browse button will open simple list dialog with possible selection options These are Subslots of Slot parent Module is plugged into To plug Submodule into Sub slot select its entry on the dialog s list and click OK To unplug Submodule select No Subslot op tion As Submodule can be plugged only in one Subslot at the same time only one option can be selected To avoid being redundant current selection is not available to choose from As already mentioned no two Submodules can be put into the same Subslot simultaneously There fore assigning Submodule to Subslot X will result in unplugging Submodule that was plugged to Subslot X previously The tool detects and warns user if this is about to happen see Figure 57 CT x 4 Subslot already used by submodule 1 NEY Do you wish to continue Figure 57 Dialog warnung that subslot is already in use The Create button the right one on Figure 55 is a shortcut that allows to define a new Subslot and assign it to the Submodule at the same time Version 1 0 0 55 77 per Happy Clients in Realtime Communication and Control 4 7 2 10 Parameters Parameters pm_test_U16 index 1 Choose Predefined Create pm_test U08 index 45040 Remove Wd Figure 58 Submodule parameters input User can supply Submodule definition with number of Parameters Parameters that are currently added to Submodule are visible as entries in the list Figure 58 Each
56. lements Parameter and value Version 1 0 0 64 77 per dot Happy Clients in Realtime Communication and Control On Subslot editor page there is an Add New Record button top of Figure 74 Below each Subslot Record is listed if any are defined Record entry is labeled with Parameter name and index To create new Record click Add New Record button It will open two page wizard First page shown on Figure 75 is for selecting Parameter User can choose from any previously defined Pa rameters CHEE lolx Select parameter Select previously created parameter from the list below pm_test U16 pm_test_U08 Selection Index O0x002c Data type PN_DATATYPE_U8 Data length 146 cc Figure 75 Create new Record Wizard On the second page visible on Figure 76 user can specify value of data Record Value is dependent on data type and data length of the Parameter Numeric values are automatically initialized to zero and have to be specified as sequence separated by whitespaces The Wizard will check if input con forms to data length and data type and display error messages if not Version 1 0 0 65 77 per Happy Clients in Realtime Communication and Control NN lolx Record Value Specify value of record Data Type PN_DATATYPE_US Data Length 146 Write value as decimal numbers separated by whitespaces 000000000000000000000000000000000000000000 gt 0000000000000 0000000000000000 00000
57. lp contents Then select port PROFINET Tool User Guide gt Settings Reference Version 1 0 0 73 77 per Happy Clients in Realtime Communication and Control 5 Appendix A Abbreviations IDE Integrated Development Environment PNIO PROFINET I O 6 Appendix B Common Problems Global scope Warning Setting not found in source default value will be used instead Solution This warning appears during project file loading if setting that 1s expected for given pro ject type could not be found in project file This can be a normal effect of application update that will not appear again after project 19 saved Error Error occurred during licence decryption Solution This error means that application could not read licence file contents and in result will run in limited Demo mode If you own full licence for port DesignTool product check location of your licence file If problem persists contact port user support Error I O error occurred while loading licence file Solution This error means that application could not read licence file contents and in result will run in limited Demo mode If you own full licence for port DesignTool product check location of your licence file If problem persists contact port user support Error Update failed Example Update failed invalid location of repository Solution Error occurs when requested auto update operation fails Check your Internet connection If proble
58. m persists you may try to update product manually by downloading new version from port home page Info Running as demo version Solution This report informs that application runs in limited instead of full version If you don t own licence for full version of port Design Tool you may ignore this info and continue with prod uct evaluation or consider purchasing full licence If you already own full licence check if licence file is installed correctly If problem persists contact port user support Project scope Error Unable to read from file Examples Unable to read from file home user project_B dsntool The system cannot find the file specified Unable to read from file C Documents user project_A dsntool Content is not allowed in the prolog Unable to read from file C Documents user proj_1 dsntool Project type is not supported Solution This error appears when project file cannot be read You should check if file exist in loca Version 1 0 0 74 77 per Happy Clients in Realtime Communication and Control tion specified and if user running application has read access to the file It is also possible that file 19 corrupted or the tool doesn t support this project type In the case of the latter you may need to download new feature to your application Error Unable to load data from project Solution This error appears when editor is initialized for project that cannot be read Check in structions for Unable
59. n project Figure 4 Empty Package Explorer When one or more projects are opened Package Explorer displays them as tree nodes see Figure 5 The icon is specific to project type with the exception that yellow folder icon Ll represents project not yet loaded Depending on project type some projects can have contents sub nodes E rr Package Explorer 23 oE project_A dsntoo E project B dsntool pnio_conf h mt device c et GSDML xml project_C dsntool na a pnio_conf h C device c 4 gt GSDML xml Figure 5 Package Explorer with opened projects Double click on node will cause project or project content to be opened in the editor Right click on project node opens context menu There are following menu items available Table 5 Project node context menu options New Creates new project using wizard Equivalent to main menu s New item 9 Close Closes selected project Will attempt to close editor and then remove project node Project from Package Explorer tree Close Others Validate Performs project validation Closes all projects except selected one Displays dialog with basic information about project name location of project file in Properties a a file system and type of the project If Package Explorer is hidden it can be restored using main menu item Show Package Explorer Version 1 0 0 19 77 per Happy Clients in Realtime Communication and Control View
60. nd Control 2 5 The IO Data From the controller s point of view received data is always input data and sent data is always output data The IO Data CR is used to send and receive process data cyclically The user can choose different real time classes that provide diverse options e g isochronous real time communication IO data frames are submitted without handshake due to performance In case a network member aborts sending IO data to the controller the application produces an error To find out if the submitted data is valid the process data is followed by a status information inside the submitted frame IO data are followed by an IO provider status IOPS or an IO consumer status IOCS The user has to setup this communication relationship inside the GSD file Inside the device configuration the adequate IO data objects have to be created that are intended as a kind of link between the process data itself and its corresponding address api slot subslot 2 6 The IO Record Data These data objects are sent acyclically and with handshake Record data objects are used for parameterization of the device or reading parameters from the device Parameters are usually written by the controller during startup and submitted as record data objects Inside the device a parameter is addressed by api slot subslot and additionally by an index The user has to setup this communication relationship also inside the GSD file 2 7 The Alarm Data Object
61. not take over no guarantee and no assume del credere liability that the program the hardware board and the documentation are error free respective are suitable to serve the special purpose In particular performance characteristics and technical data given in this document may not be constituted to be guaranteed product features in any legal sense For consequential damages which are emerged on the strength of use the program and the hardware boards therefore every legal responsibility or liability is excluded port has the right to modify the products described or their documentation at any time without prior warning as long as these changes are made for reasons of reliability or technical improvement All rights of this documentation lie with port The transfer of rights to third parties or duplication of this document in any form whole or in part is subject to written approval by port Copies of this document may however be made exclusively for the use of the user and his engineers The user is thereby responsible that third parties do not obtain access to these copies The soft and hardware designations used are mostly registered and are subject to copyright We are thankful for hints of possible errors and may ask around for information We will go all the way to verify such hints fastest Copyright 2014 port GmbH Regensburger Stra e 7b D 06132 Halle Tel 49 345 777 55 0 Fax 49 345 777 55 20 E Mail service port de
62. oblem Details dialog Contents of Problem Details dialog from the top e Severity Symbol depends on your operating system and label in dialog header indicate problem severity Error Warning or Information Affected Project Only for project specific problems name of project in which problem Version 1 0 0 36 77 per Happy Clients in Realtime Communication and Control was detected Path Only for project specific problems file system location of project in which problem was detected e Description Description of the problem Location Only for project specific problems object inside of project for which problem was detected 3 7 4 Resolving problems When problems are indicated or suspected in project user is working on there is a chance they can be quickly resolved using assistance from Problems View and Help documentation To browse problem reports open Problems View It may be helpful to re run project validation This will cause all currently inactive problems asso ciated with project to be removed from view and problems reported during validation will appear on top of the list Open details dialog for reported problems to read description in full If report contains specific ob ject where problem is located Location field is not empty you can try to open it in editor To do this double click on problem entry in Problems View If solution is not immediately apparent check if similar problem is d
63. ollowing section describes the different properties a user can set for subslots Number Number 0x0001 Y Figure 69 Subslot number input Identification number of Subslot Must be unique within Slot Value is a 16 bit unsigned integer Subslot s number is displayed as its label usually in both hexadecimal and decimal in parenthesis format e g Subslot 0x11 17 When changing number value one can use his her preferred format decimal octal with O prefix or hexadecimal with Ox prefix New value won t be accepted when previously mentioned con straints are not met the red error sign will appear next to input field Description Description Y Figure 70 Subslot description input Optional user text Can be used to write comments about Subslot Submodule Selection Submodule selection No submodule selected Browse Create Figure 71 Subslot Submodule input Just as Module can be plugged in the software model to Slot Submodule can be plugged into Sub slot This selection is optional 1f no Submodule is selected the form will say No Submodule se lected User can select Submodule for Subslot from existing ones by using the Browse button Figure 71 the left one This can be only done when parent Slot has Module assigned Otherwise information dialog will pop up see Figure 72 To remedy this situation plug some Module into parent Slot Version 1 0 0 63 77 per Happy Clients in Realtime
64. ommonly used widgets and other editing tips For specific information about settings and objects available in your project please refer to user guide appropriate for your project type Form page with tree You can also encounter editor pages that have tree widget nested inside They are used for objects that have complicated hierarchy and are otherwise not different from ordinary form pages Version 1 0 0 25 77 per Happy Clients in Realtime Communication and Control S El Ei El E Module 64 byte 0x30 48 Fr d gt Sa byte 3 0x30 43 gt CAbyte L Ox L C 4 64 byte O Cx31 49 Mine 54 byse ia eh 4 G4 byte 30 MINSON cent numee oxox LZ Descripton Shot selection Mo dot selected Brema Create Cartwonrclanho s Ade S lette Remove mbnodue Figure 14 Editor page with tree an example Use the tree to access objects hierarchically linked to currently displayed click on the node to fill editor form with appropriate configuration entries Code Preview Tab Apart from Design Tab editor instance can have one or more code preview tabs You can select one of them by clicking tab label at the bottom of editor area see Figure 14 Code preview tab allows for quick preview of artifacts generated by port Design Tool from currently edited project They also control location of generated code in file system Version 1 0 0 26 77 Happy Clients in Realtime Communication and Control ww FN S Brow
65. on is unable to access its resources or when project file is corrupted Problem handling system also covers project type specific checks correctness of project configuration setting contradictions etc 3 2 Menus 3 2 1 The Main Menu This chapter describes main menu items of port DesignTool application Main menu is positioned on top of DesignTool s main window It is accessible using mouse or keyboard When left key is pressed menu control becomes focused and underscores appear on menu labels see Figure 2 Underscores show which keyboard key to press to select menu item For ex ample to execute menu action New one can press Alt E In Version 1 0 0 15 77 per Happy Clients in Realtime Communication and Control File Edit Window Help New Open Close Ctrl w Close All Exit Figure 2 Main menu with key selectors Some commands available as menu items are also executable using direct keyboard shortcuts For example user can undo last modification done in currently focused editor by pressing CtrI l z If menu command has key shortcut it will be displayed next to its menu label Not all menu items are available all the time Depending on application state active application parts selected objects etc some items may be grayed out and not available for selection in given moment 3 2 2 The File Menu File menu contains main application actions and basic project management Short inform
66. on model blocks The Create button the right one on Figure 4 is a shortcut that allows the definition of a new Slot and assigns it to the Module at the same time 4 7 2 Submodules Submodule is a child object for Module Each Module must have at least one Submodule defined One can browse Module s children using tree view inside editor dr 64 byte I Dy 3061 Module aModule 0x2a 42 aaeoa 64 byte 10 0x32 50 Module nodes aModule asa po submodule Oxi Ident Number Submodules of E _ amotherOne 0x2 Module0x2a p a Figure 45 Fragment of editor for Module Ut Tp 15 Mamei When any Module is opened in editor user is presented with tree representation of Module struc ture on the right side of editor tab see Figure 45 Submodule page can be opened simply by click ing associated tree node Version 1 0 0 51 77 per Happy Clients in Realtime Communication and Control Submodules 7 Add Submodule Remove submodule d F igure 46 Module s submodule management field Submodule is a child object for Module From Module s editor page user is able to create new Submodules and remove existing ones Use Add Submodule button the left one on Figure 46 to create new Submodule and add it as child of current Module Clicking on button will launch Create Submodule Wizard Use Remove Submodules button the right one on Figure 46 to remove Module s Submodules Clicking on bu
67. one byte e Unsigned 16 unsigned 16 bit integer number values from 0 to 65535 takes two bytes e Unsigned 32 unsigned 32 bit integer number values from 0 to 4294967295 takes four bytes e Signed 8 signed 8 bit integer number values from 128 to 127 takes one byte e Signed 16 signed 16 bit integer number values from 32768 to 32767 takes two bytes e Signed 32 signed 32 bit integer number values from 2147483648 to 2147483647 takes four bytes e Octet String string of characters each of them taking one byte Data type setting determines data unit Data length determines how many units there are in the data Data Length Data Length 4 Ke Q Figure 85 Paramater data length input Version 1 0 0 71 77 per dN Specifies length of data in bytes The value is a 16 bit unsigned integer Should be consistent with data type That means it has to be divisible by byte size of the unit Depending on data type valid values are e None 0 e Unsigned 8 1 2 3 4 65535 e Signed 8 1 2 3 4 65535 e Octet String 1 2 3 4 65535 e Unsigned 16 2 4 6 8 65534 e Signed 16 2 4 6 8 65534 e Unsigned 32 4 8 12 16 65532 e Signed 32 4 8 12 16 65532 4 7 10 Create Delete Parameters New parameters can be created and associated with Submodules using Submodule editor page Parameter creation is done with assistance of wizard Create New Parameter
68. ormation about how to complete task Location Location of object associated with the task inside project this object will be opened when task entry is double clicked e Completed If the box is checked task is completed this can be temporarily changed by the user Application checks whether tasks are completed automatically when project is first time loaded and after each save Checking of tasks can also be triggered manually by right clicking in Tasks View area and selecting Refresh from menu this checks every displayed task 3 6 2 Working with Tasks Reading and completing tasks is a helpful way to properly configure all required aspects of the pro ject To begin open Tasks part and scroll to tasks that point to project you are working on It is usu ally appropriate to start completing tasks in order they are presented in Tasks View First read task description if description doesn t fit in table view open details dialog as described above Double click task entry to open editor page associated with task When modifications are made you can re check tasks using context menu item Refresh or just save project If you want to go back to some finished task you can use context menu item Show Hide Completed to reveal all tasks in the table completed ones will be grayed out To help with sorting out the tasks you can also temporarily change task state to be completed open by using context menu op tions Set Completed or Details Th
69. os sible to fix most of problems of this type by simply editing reported configuration element Mean ing of some constraint violations is described below e LimitedSetting ValueIsOptionsIndex Setting value is incorrect Can be fixed by changing setting value e IntSetting IntValueBetweenLimits Numeric value is not in valid range Can be fixed by changing setting value Version 1 0 0 76 77 per Happy Clients in Realtime Communication and Control e Module Slot Submodule Subslot AddressInRange Identification number of software model object is not in valid range Can be fixed by changing the number in question e Module Submodule Parameter NameLength name of object is longer than 100 charac ters Can be fixed by changing the name e Submodule DataLengthInRange DataLenghtOutRange data length attribute of Sub module object is invalid Can be fixed by changing the value of problematic field e Parameter IndexInRange index attribute is not a 16 bit integer Can be fixed by changing the value of index Error Object has more children than specified in setting XXX Solution The error is reported if Software Model definition is inconsistent with Resource Man agement settings The possible cases are e There is more Modules defined than Number of device Modules setting value e There is more Slots defined than Number of device Slots setting value e There is more Submodules in Module than Number of device
70. ow Menu Window menu contains actions for changing application perspective and to reveal preferences dialog Short information about each of the items is collected in the table below Table 3 Window menu options Restores application perspective to default state this means restoring default positions of application parts and opening closed parts Show __ 1 Sub menu for showing selected application part l 1 Opens Outline part if closed or hidden and brings it to top perspective Package Opens Package Explorer part if closed or hidden and brings it to Explorer View itop fF Problems View Opens Problems part if closed or hidden and brings it to top Tasks View ___ Opens Tasks part if closed or hidden and brings it to top Preferences si Opens dialog for changing application preferences 3 2 5 The Help Menu Help menu contains actions related to user assistance and product information Short information about each of the items is collected in the table below Version 1 0 0 17 77 per Happy Clients in Realtime Communication and Control Table 4 Help menu options Help Contents Opens help dialog and displays user guide document Opens dialog for displaying text of product licenses Checks if updates are available for port DesignTool application In case they are it can download and install them Requires Internet connection Update installation requires restart of application 3 3 Application P
71. per port Design Tool File Edit Window Help Happy Clients in Realtime Communica tion and Control pert PROFINET DesignTool User Ma nual Package Explorer 23 oO 4 pnio dsntool a pnio_conf h C main c lt gt GSDML xml pnio dsntool 2 Resource Management Miscellaneous LLDP Handling v v Device Identity Modules v Record Data Handling F E Text b pnio_conf h main c t gt GSDML sea Outline 52 a p General d Resource Management o RPC b Logging Record Data Handling LLDP Handling d Miscellaneous a f Device Description d Device Identity Device Function GSDML 4 Software Model gt Modules gt Slots gt g Driver Settings Tasks 53 A Problems Tasks 3 all 5 Description Specify description for every module Configure GSDML attributes name of manufacturer and device Set your Pl assigned Vendor ID do not use port s number 0x28c Project pnio dsntool pnio dsntool pnio dsntool Location Device Identity Modules GSDML onio dsntool C Users mt PORTGMBH Documents nio dsntool per Happy Clients in Realtime Communication and Control Disclaimer All rights reserved The programs boards and documentations supplied by port GmbH are created with due diligence checked carefully and tested on several applications Nevertheless port GmbH can
72. r links to other editor pages As a visual hint little decoration icons can be rendered on top of these blocks Below are their meanings they are listed in decreasing priority Version 1 0 0 24 77 per Happy Clients in Realtime Communication and Control s Problems detected for objects inside this block e There are unfinished tasks associated with objects inside this block e Neither problems nor unfinished tasks found for this element Form page Using editor s design tab one can display several configuration pages for project They can be ac cessed by clicking a block on Top page selecting Outline node or double clicking on Task Re member that you can always go back to previously visited location using Go Back tool Most of these pages use forms similar to these on WWW pages See Figure 13 for reference each configuration setting 19 displayed with short name on the left and interactive widget on the right S S bR B Resource Management Number of application processes O Number of appikation relations 2 a M Number of communication relations 10 4 M Number of OCR in a connect request 10 P Number of device slots 3 t Number af dewee subdots per dot 5 H LZ Number of dewce modules 10 m Y Number of device submodules per moduls foil t Number of DCP device parameters 16 ay x Figure 13 Editor form page an example Please see the next chapter for detailed description of c
73. ration errors e Step by step configuration guide in form of task list 4 2 PROFINET Projects port PNIO stack configuration together with software model is defined as a single DesignTool project Using this project the tool can generate appropriate code files Working with PROFINET projects 19 analogous to working with other port DesignTool projects If some aspects are not clear please check help pages for common functionality port DesignTool User Guide 4 2 1 Project Type User will be able to create and edit PROFINET projects if he has support for this protocol installed into port DesignTool application One can check if that is the case by opening About Dialog from Help main menu and checking if section Supported project types contains line PROFINET In Package Explorer View PROFINET projects are shown with green PN icon ED Project node contains up to three project contents as shown on Figure 26 Meaning of these sub nodes will be explained in Code Generation chapter Version 1 0 0 38 77 per Happy Clients in Realtime Communication and Control E EU project_B dsntool i A pnio_conf h C device c feet GSDML xml Figure 26 Example PROFINET project entry in Package Explorer view 4 2 2 Creating New PROFINET project The creation of new PROFINET project is straightforward From File main menu select New op tion In case the DesignTool product supports more project types the user will be asked to choose
74. roject type and reveal page most relevant to the setting in question 3 4 4 Configuring your project port Design Tool is designed for working with different project types using the same set of conven ient tools and user assistance system The general instructions about editing tools were presented above For more specific instructions about meaning and significance of settings refer to user guide appropriate for your project type 3 5 Projects Version 1 0 0 29 77 per Happy Clients in Realtime Communication and Control 3 5 1 Project Type port DesignTool has a modular architecture that allows using the same set of tools for editing dif ferent project types You can check what project types are supported by given DesignTool applica tion by opening About dialog see Figure 18 About port Dez T ecl Figure 18 About dialog with supported project types Support for project type comes with Wizard for creating new projects When new project is to be created user will be asked to choose wizard for the desired project type The question will be skipped if there is only one wizard available 3 5 2 Project properties You can see list of opened projects using Package Explorer If hidden restore Package Explorer using menu item Show Package Explorer The content of Package Explorer View includes all projects created and loaded from disk during application runtime which have not been explicitly closed Version 1
75. s These data objects are sent acyclically and with handshake They are sent with high priority on occurring events There are two main types of alarms e Process Alarms e Diagnosis Alarms Process alarms are used when a special event in the process occurs This might be exceeding of a critical value for example In this case the device itself is still running without errors Diagnosis alarms in contrast are caused by events or errors corresponding to the IO device This might be malfunction of attached periphery or pulling and plugging of modules if the device hardware is modular Both kinds of alarms can be sent at different priority levels 2 8 Slots and Modules If your device hardware is modular meaning you are able to plug and unplug several modules you will easily understand the software model If it is not you have to know that the software model is derived from modular hardware A module is the interface to your process and it usually has some characteristics and parameters you want to change This can be done when it is addressable by the controller A module becomes addressable by the controller when you plug it into a slot since a slot represents an address See Figure 1 for a visual representation Plugging a module means linking the structures of modules and slots Version 1 0 0 12 77 per Happy Clients in Realtime Communication and Control within the software model using pointers Figure 1 should only be considered as
76. s View with example COontenS eee eee eee eee 21 Figure 8 Problem View with example contents siss cissssccwncancnnsccnedansesacevenstvadsinedensnnsetacdaosessdaneneuaaseiwes 22 Figure 9 Asterisk on editor label signifies unsaved changes sss 22 Figure 10 Basic elements Ol Ss h eT 23 Powe SP Gi tO OVO a e EA E A E E E E 23 Figure 12 Top view page for project e s L 24 Figure 13 Editor forni page an example scr ses ore sevexsvecsieaesneesrantnanbeteeessveadvedsbeacsauesrestnenderseecavadecun 25 Figure 14 Editor page with tree an example cccccccccccccccccicccccccccccccccccccccccccicccccocaceeeeeees 26 Figure 15 Elements Of code preview aD 0090900002 0e4T0e 27 Figure 16 Error mark displayed next to incorrectly modified Intput sss sese 29 Figure 17 Mouse over text contains more descriptive information about the project entry 29 Figure 18 About dialog with supported project types esse 30 Figure 19 Thre projects visible in Packet Explorers eee 31 Figure 20 Projecet Properties TT T 31 Figure 21 Tool asks for confirmation if problems were detected during project saves 32 Figure 22 Example contents of Tasks Le 33 Figure 23 Task Details dialog for example aSK sese 33 Figure 24 NS s le RTA aT L 30 T 235 Problem TR IO E 36 Figure 26 Example PROFINET project entry in Package Explorer View aeo 39 Version 1 0 0 Figure 27 Figure 28 Figure 29 F
77. se ji Change location i i i D Projects Edpse4 Siexamples preo_confh Save viewed Save when code to file project file is saved Preview Area LE LZ Figure 15 Elements of code preview tab You can see elements of code preview tab on Figure 15 Descriptions follow below Preview area Most of space in the tab is taken for text field where generated code is dis played e Save button Saves contents of preview area to file e auto save check box If checked code will be regenerated and saved to file each time parent project is saved If unchecked user has to do it manually by clicking Save button Save Location Text field in the middle of toolbar displays currently specified location where code should be saved e Browse button Allows to change location where code should be saved Please note Saving the generated files might be limited in demo mode 3 4 Editing Tools This chapter explains in detail types of configuration widgets used for different project settings For basic information about editor please see Editor chapter first 3 4 1 Configuration widgets When browsing through port DesignTool project structure using editor you will encounter different sets of configuration options represented by input fields text fields lists check boxes etc Each of these widgets was designed to be intuitive in use and to ensure proper format of input Version 1 0 0 27 11 per Happy Clients in
78. t file asterisk appears next to editor label Figure 9 N project_A dsntool 72 en project_B dsntool T Figure 9 Asterisk on editor label signifies unsaved changes Because editor remembers subsequent changes done to data there is possibility to undo and re do them Editor elements The way project is presented in the editor differs depending on project type and should be described Version 1 0 0 22177 per oo SUD SO 9001 Happy Clients in Realtime Communication and Control in the User Guide for appropriate feature Nevertheless basic elements of editor are shared These elements can be seen on Figure 10 project _A dsntool 22 u CE Design Tab Area Design Tab Code Preview Tabs E Design hn pnio_conf h C device c lt gt some lt Figure 10 Basic elements of Editor Editor has multi tabbed design Design Tab is the main tab present in every editor This tab is used to browse and modify the data Other than that depending on project type editors can have additional tabs for example for viewing generated code Design Tab On top of Design Tab there is a small toolbar mostly for navigation purposes The rest of tab is taken by editor page the representation of some aspect of the edited project Toolbar is presented in Figure 11 Figure 11 Edit toolbar The following elements can be found on the toolbar Version 1 0 0 23 77 per Happy Clients in Realtime Comm
79. t incidentally overwrite a GSDML file you have created with other project For device description to be displayed in user friendly format XSL style sheet file will be copied into the same directory as GSDML file This is usually done first time the file is opened in the pre Version 1 0 0 47 77 per C SUD Happy Clients in Realtime Communication and Control SO 9001 view tab It may be worth noting that with style sheet in place one can also open GSDML file us ing other WWW browser Contents of GSDML file depend on Software Model and Device Description Settings 4 5 Tasks port Design Tool makes use of task lists as a method of assisting users through project creation Each task is constructed from a set of conditions that are checked automatically each time project is saved User can browse unfinished tasks using Tasks View application part As a means of visual feedback editor blocks are decorated when there are unfinished tasks detected for their contents see Figure 38 Figure 38 Block decorations depending on tasks For a list of possible open PROFINET specific task please see chapter 7 4 6 Common PROFINET problems During Project Validation problems can be detected in user project These are collected by Prob lems View application part for the user to browse In chapter 8 the list of common problem reports concerning PROFINET projects their meanings and solutions can be found 4 7 The PROFINET Software
80. tory where you extracted the DesignTool archive Then restart the tool It will now provide the full functionality Version 1 0 0 10 77 per Happy Clients in Realtime Communication and Control 2 Introduction to PROFINET 2 1 Introduction PROFINET is an open industrial Ethernet standard Its design is utmost modular making it possible to create functionality which is defined by the user PROFINET IO PNIO is real time capable so it can be used in almost all fields of automation technology In a PNIO network you can find three types of devices that interact in a master slave relationship e IO Controller master e IO Device slave s JO Supervisor used for setup and diagnosis During startup of automation equipment assuming a complete configuration an application relationship AR is created between a controller and a device It is a kind of channel where both can communicate with each other Within an AR three types of communication relationships are usable and have to be defined by the user IO Data CR e Record Data CR e Alarms CR 2 2 The IO Controller The controller has master status in the network It receives and transmits IO Data from the devices and controls the whole process The user has to inform the controller about the devices that are in the network by installing a device specific GSD file in the controller Based on the information that are provided to the controller within this file the controller automaticall
81. tton will open simple selection dialog with the list of Module Submodules You can select more Submodules than one by having key pressed while clicking on the entries Remember Every Module must have at least one Submodule The tool will not allow to remove all Submodules of the Module The following section gives an overview about the submodule properties the user can set 4 7 2 1 Name Name 64 byte O Figure 47 Submodule name input Human readable name of Submodule Limited to 100 characters Should be concise yet descriptive Uniqueness 19 not enforced but should be avoided as potential source of confusion Name will be put both to software model file and to device description file 4 7 2 2 Identification Number Ident Number 0x00000001 Figure 48 Submodule number input Identifier of the Submodule Must be unique within Module Unsigned 32 bit integer number Sub module number together with the name are displayed as Submodule s label usually in both hexa decimal and decimal in parenthesis format e g Submodule twelve Oxc 12 When changing number value one can use his her preferred format decimal octal with prefix or hexadecimal with Ox prefix New value won t be accepted when previously mentioned con straints are not met the red error sign will appear next to input field Version 1 0 0 52 77 per Happy Clients in Realtime Communication and Control 4 7 2 3 Description Description
82. unication and Control Go Back Opens previously visited editor page Go Forward Opens editor page visited before using Go Back tool Go Home Opens top page for given project Save Saves changes to project file equivalent to main menu s Save item e Help Opens Help Dialog if possible uses dialog to reveal help page most appropriate to current editor page Editor works in tandem with Outline view Outline is used to show the hierarchy of project objects and quickly navigate through them clicking tree node in Outline results in opening editor page for this object in editor s Design Tab There are three basic types of editor pages Starting page for projects also known as Top page uses graphical representation of most important elements of project Sets of configuration elements are represented as form pages similar to HTML forms Hierarchical objects are represented by pag es with additional tree for easy navigation through their children Top page Top page for project uses block diagram to present user with key elements of project configuration This is initial page displayed after project is created opened You can quickly return to this page by using Go Home button on editor toolbar Exact looks of the page depends on your project structure defined by project type but it is similar to that shown on Figure 12 S R E E E Figure 12 Top view page for project an example Blocks in burgundy red are hype
83. ut checking Before new value is accepted it must pass quick validation test For example most numeric settings only accept values which belong to certain range The test is performed immediately after user mod ifies input In case of failure user gets visual feedback see Figure 16 Invalid value Device ID 1 x Figure 16 Error mark displayed next to incorrectly modified intput Appearance of error mark next to modified input means that new value is incorrect and not accept ed 3 4 3 Assistance Options Effort was made to make editing port DesignTool projects as intuitive and self explanatory as pos sible Nevertheless it 19 still possible that users will not immediately recognize meaning of some setting and how to change its value For this purpose user assistance system was connected to each configuration entry In case the name of the setting is not descriptive enough hover the mouse cursor over the help icon next to input in question to get a longer description in form of tool tip message Figure 17 00 45 56 78 9a bc Device MAC address only applies if no other way of reading the MAC address is available For example on Linux the MAC address is read directly from the ethernet device Device MAC Address Figure 17 Mouse over text contains more descriptive information about the project entry If this short information is still not sufficient click on the help icon This will open user guide for your p
84. what kind of project to create Select entry PROFINET Project PROFINET see Figure 27 and click OK Select project type New Generic Project Genenc ad Profinet Project PROFINET Figure 27 Contents of Select Wizard dialog with PROFINET entry 4 2 3 Specify project file location On the first page of wizard user is asked to specify location of project file Wizard window looks similar to that presented on Figure 28 To proceed click Browse button to display your OS specific select file dialog Project file name has extension dsntool Tip You can organize project files on disk however you want but consider creating a new folder for each new project This way it will be easier to know which code file belongs to which project Version 1 0 0 39 77 per Happy Clients in Realtime Communication and Control ET A _iolx Select location Click browse and select valid location for project file to be created ee Browse coc Figure 28 First page of New Project wizard It is possible to select already existing project file User must be careful though as it will result in losing all information saved to this file and replacing it with clean new project This will happen as soon as Wizard finishes Wizard warns about overwriting existing files with message shown on Figure 29 EN lolx Select location NN File already exists D Projects Eclipse4 3 examples project_A dsntool Figure 29
85. y creates the AR for every device that is modeled by the user 2 3 The IO Device The device has slave status in the network It receives and transmits IO Data from the controller and provides process information It is common for device hardware to be to be very modular which is reflected in the device software model and addressing concept Within the device model there is a differentiation between addressing and functionality A module or submodule is hardware with a special functionality and parameters while a slot or subslot only represents an address The module and submodule becomes accessible by the controller when it is linked to a slot and subslot inside the device software definition even if the device hardware is not modular Sometimes it is necessary to submit data in a special structure If so different user profiles can be applied which are identified by the Application Process Identifier APT API 0 is manufacturer specific According to this concept a value is addressed inside the device by its API number slot number subslot number and in some cases its index 2 4 The Supervisor The Supervisor is used to for setting up the controller e g setting IP addresses and installing GSD files as well as for diagnosis purposes It is usually not permanently included in the network If necessary the supervisor is able to act as controller just as well Version 1 0 0 11 77 per Happy Clients in Realtime Communication a

PNDT User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents