PROFINET Driver - Manual - PROFINET Driver

Portfolio: PROFINET Development Kits
Product: PROFINET Driver
Software version: v3.2.0
Edition: 10/2024
Language: en-US (original)

Home
PROFINET Driver Documentation
Intro
Intro
Supported Features
What's New
Support of Debian 12
Hardware Configuration in TIA Portal
Update of Yocto based Flex OS image for CP1625 board
PROFINET General Station Description (GSD) Support V2.45
Support of system-wide SNMP agent based on Net-SNMP
Assign PN Driver to a specific core at runtime
Standardization of PN Driver Debian (deb) packages
Introduction to CMake
Supported Variants
Supported Features from Previous PN Driver Versions
PROFINET Security Class 1 features
Support of Windows 11 and Visual Studio 2022
PN Driver Linux Native in the Docker environment
Handling of default gateway and IP address changes from operating system
Support of I-device (intelligent device)
Support of prioritized startup by Linux Native controller
Support of 64-bit for Linux Native controller and device
Assign PN Driver to a specific core
Availability of PROFINET Application Relation (AR) during high netload
Support of Debian 11
Hardware Configuration in TIA Portal V18
Easy installation with the Debian (deb) packages
Yocto based Flex OS image for CP1625 board
PROFINET General Station Description (GSD) Support V2.43
Removing PN Driver "Linux" and "Stand-alone" variants
Support of Npcap library for PN Driver Windows variant
Support of Linux Native and CP1625 Host on SIMATIC Industrial OS V3.2
Enable/Disable SNMP
Support of PROFINET device
Support of Linux IP Stack
Support of Standard Linux Ethernet Driver
PROFINET Performance Upgrade
Calculation Tool for Isochronous (ISO) Mode
Support of Windows 10 and Visual Studio 2017
Firmware Download over SSH
Enable/Disable SNMP
Support of Project Integrated I-device
Improved Name Assignment
Specifying the Router for a PROFINET Device
Improved Network Statistics
Improved Application Relation Abort Reasons
Combined Object Container
Isochronous Real-time Communication (IRT)
Isochronous Mode for Process Data
Configuration Control (Option Handling)
Configuration Control of IO Devices
Configuration Control of IO Systems (Option Handling in the Network)
Optional IO Devices
Flexible Topology
Multiple Use IO Systems
Shared Device
Diagnostics Service
RT Advanced Startup
IEEE-compliant LLDP (Link Layer Discovery Protocol)
Plug-in PROFINET Interface Submodules for Linux and Windows Variants
Support of Prioritized Startup for the Linux Variant
Manuals in the PN Driver Software Package
Installing and Starting of PN Driver
Programming
Configuration
Without an Engineering System
With PNConfigLib
Porting
PN Driver Migration Guide
GSDML Getting Started - Creating a Device Description (GSD) file for PROFINET Devices
Registration
Licensing
Legal Information
Notes, Known Issues and Warnings
Notes
Known Issues & Warnings
Isochronous Mode Performance Sensitivity to System Load
Running Test Application in Real-Time Priority
ModuleDiffBlock Message during the Start-up
Restoring the Default Gateway Settings for the Linux Native Variant
Restart PN Driver after receiving "Reset to Factory"
Unstable Application Relation (AR) with increased trace level
Wrong or missing system constant tags (Hardware Identifiers) in TIA Portal
Invalid SendClock values for I-device
Invalid MaxDataLength value in exported GSD file of I-device
Unsupported PROFIenergy menu
Prioritized Startup configuration is missing in record
Empty values in exported GSD file with "Enable Customization" option
StationNameAlias Record is missing if PN Driver is configured as I-device
Contact
Any Questions regarding PN Driver?
Technical contact worldwide
Technical contact for the U.S.
Technical contact for China
Cybersecurity Information
Notes on Protecting Administrator Accounts
Open Source Software and Disclaimer for Third-Party Software Updates
Open Source Software
Disclaimer for Third-Party Software Updates
Quick Start
Introduction
Overview
Purpose of this documentation
Conventions
Target group of the documentation
What is PN Driver?
What are the requirements?
Advantages of TIA Portal
Advantages of PNConfigLib
New functions of PN Driver V3.2
Application examples
Technical specifications
Overview of the supplied documentation
Overview of the supplied PNConfigLib documentation
Additional support
Technical contact information for Germany/worldwide
Technical contact information for the U.S.
Technical contact information for China
Cybersecurity information
PROFINET Security Guidelines
Open Source Software
Disclaimer for third-party software updates
Notes on protecting administrator accounts
Runtime variants
Quick start for Windows
Installing Npcap SDK
Installing Npcap
Installing Visual Studio 2022
Disabling network protocols that are not utilized
Disabling the PNIO adapter of the PG/PC interface
Start application example
Quick start for Linux Native
Installing Debian
Enabling admin rights for the user
Installing the real-time Linux kernel
Installing other required packages
Additional Configuration for the Linux Native variant
Adapting LED Blink functionality to your hardware
PN Driver in the Docker environment
Building the PN Driver application
Installing and starting Eclipse IDE
Building with makefile
Installing and starting VS Code
Building with CMake
Starting the controller application example
Starting the device application example
Configuration XML file for PROFINET device
How to start the device application example
Quick start for CP1625 Host
Preparing Flex OS environment
Installing required packages
Adapting the pnd-main.bb file
Building the Linux image
Rebuilding the Linux image
Using the PN Device Driver
Compiling the PN Device Driver
Disabling I/O Memory Management Unit (IOMMU)
Loading the PN Device Driver
Unloading the PN Device Driver
Loading the PN Device Driver automatically
Determining errors during loading of the PN Device Driver
Building the PN Driver application
Building the PN Driver application with makefile
Installing and starting VS Code
Building the PN Driver application with CMake
Running the PN Driver application
Engineering
Hardware configuration of PROFINET controller in TIA Portal
Installing the TIA Portal software packages
Installing the Hardware Support Package for PN Driver
Preparing a PN Driver hardware project and generating an XML configuration file
Hardware configuration of PROFINET controller in PNConfigLib
Generating an XML configuration file
Hardware configuration of PROFINET device with the GSDML file
Example GSDML file for Linux Native PROFINET device
IP communication
How to use PROFINET interface for socket connections
Supported methods for IP address and default gateway assignment
Loading the TUN/TAP virtual Ethernet device driver
Rebuilding the kernel with the TUN/TAP support
Limitations
Transport protocols
Local port range
Changing the local port range for Linux Native and CP1625 Host variants
Disabling DHCP IP assignment for Linux Native variant and CP1625 Host Native
Preventing loss of connection due to deletion of Default Gateway
Bandwidth limitation
SNMP
Firewall
Support of a single IP address per network interface
Network planning
Application examples
Test application for PROFINET controller
Startup options
Menu Items
Multiple use IO systems
Menu Items
PNIO diagnostics
Menu Items
Configuration control of IO systems
Optional devices
Flexible topology
Menu Items
Option handling
Menu Items
Receiving alarms
Menu Items
Isochronous mode
Menu Items
Isochronous calculation
Interpretation of ISO calculation output
Menu Items
Enabling debug mode when needed
Adapting calculation source code into an existing application
Import relevant source files and include them in your Makefile
Insert your application program in the proper callback function
Call functions necessary to manage calculation lifecycle
I-device (intelligent device)
Startup options
Menu Items
IO routing with I-device
Reading inputs of PROFINET devices from the lower-level IO system
Reading outputs of PROFINET devices from the lower-level IO system
Writing outputs of PROFINET devices from the lower-level IO system
Test application for PROFINET device
Startup options
Menu items
IO Data Read/Write
Send Alarm
Diagnostic Add/Remove
References
Opening archived TIA projects in TIA Portal
Installation with Debian package
Installing deb packages with installer script
Installing deb packages manually
Updating the kernel object file
Uninstalling deb packages
Upgrading deb packages
Creating deb packages
How to Port
Introduction
Scope
Cybersecurity Information
Open Source Software
Disclaimer for third-party software updates
Notes on protecting administrator accounts
Additional support
Technical contact information for Germany/worldwide
Technical contact information for the U.S.
Technical contact information for China
System Overview
Overview of Embedded PROFINET System (EPS)
Overview of sample PN Driver implementations
POSIX API/Macro IF (OS abstraction)
POSIX functions
Porting instructions
EPS PLF (hardware abstraction)
EPS PLF overview
Platform preprocessor defines
EPS PLF interface functions
EPS_PLF_EXCHANGE_LONG
EPS_PLF_VIRTUAL_TO_PHYSICAL_ADDRESS
EPS_PLF_MAP_MEMORY
EPS_PLF_UNMAP_MEMORY
EPS_PLF_PCI_TRANSLATE_PCI_TO_LOCAL_ADDR
EPS_PLF_INSTALL_EXC_HANDLER
EPS_PLF_UNINSTALL_EXC_HANDLER
EPS APP (application abstraction)
EPS APP overview
EPS APP Interface - System functionality
Function EPS_APP_INIT
Function EPS_APP_UNDO_INIT
Function EPS_APP_ALLOC_FILE
Function EPS_APP_FREE_FILE
Function EPS_APP_GET_DRIVER_PATH
EPS APP Interface - Driver Adaption
Function EPS_APP_INSTALL_DRV_OPEN
Function EPS_APP_UNINSTALL_DRV_CLOSE
EPS APP Interface - System exception
Function EPS_APP_KILL_EPS
Function EPS_APP_HALT
Function EPS_APP_FATAL_HOOK
Function EPS_APP_SAVE_DUMP_FILE
EPS APP Interface - LED control
LED handling functions for EDDS
Function EPS_APP_LL_LED_BACKUP_MODE
Function EPS_APP_LL_LED_RESTORE_MODE
Function EPS_APP_LL_LED_SET_MODE
LED handling functions for EDDI
Function EPS_APP_LL_LED_BLINK_BEGIN
Function EPS_APP_LL_LED_BLINK_SET_MODE
Function EPS_APP_LL_LED_BLINK_END
EPS APP Interface - MAC address
Function EPS_APP_GET_MAC_ADDR
EPS driver concept (Ethernet adapters abstraction)
EPS driver concept overview
PN Device Driver
PN Device Driver overview
eps_pndev_if_register_device
eps_pndev_if_register
EPS_PNDEV_OPEN_FCT
EPS_PNDEV_CLOSE_FCT
EPS_PNDEV_UNINSTALL_FCT
EPS_PNDEV_ENABLE_ISR_FCT
EPS_PNDEV_DISABLE_ISR_FCT
EPS_PNDEV_ENABLE_HW_IR
EPS_PNDEV_DISABLE_HW_IR
EPS_PNDEV_READ_HW_IR
EPS_PNDEV_SET_GPIO
EPS_PNDEV_CLEAR_GPIO
EPS_PNDEV_TIMER_CTRL_START
EPS_PNDEV_TIMER_CTRL_STOP
EPS_PNDEV_READ_TRACE_DATA
EPS_PNDEV_WRITE_TRACE_DATA
EPS_PNDEV_WRITE_SYNC_TIME
EPS_PNDEV_SAVE_DUMP
Integration of an EDDS lower layer implementation into PN Device Driver
EDDI component
PN Device Driver interrupt/event mechanism
Interrupt/event mechanism overview
How EPS enables the event mechanism
Porting instructions
System data
Trace
Core dump
PSI settings (configuration of the PROFINET stack)
How to port PN Driver to CP1625
CP1625 Host variant
Engineering Interface
Preface
Purpose of the manual
Target group for the manual
Structure of the manual
Guide
Conventions
Additional support
Technical contact information for Germany/worldwide
Technical contact information for the U.S.
Technical contact information for China
Cybersecurity information
Open Source Software
Disclaimer for third-party software updates
Notes on protecting administrator accounts
Introduction
Object model of the user interface
Identification
Module and ModuleProxy
Logical base address
XML structure
XML elements
Structure of the XML file
Relationship between IOcontroller and distributedIOsystem
IOcontroller
distributedIOsystem
PROFINET IO data records
Vendor-specific data records
GSDML file information
PNIO classes, attributes and links
Classes
Object attributes
Links
Used data types
PNIO data blocks
PNIO data blocks header
Data blocks for IOInterface
Data blocks for network parameters
Data blocks for IODevice
Data blocks for distributedIOSystem
Data blocks for IOController
Description of PNIO data blocks
Data blocks for network parameters and IOInterface
IPV4_SUITE
IP_ADDRESS_VALIDATION_LOCAL
NAME_OF_STATION
NAMEOFSTATION_VALIDATION
STATION_NAME_ALIAS (network parameter)
SEND_CLOCK (IOInterface)
IP_ADDRESS_VALIDATION_REMOTE (network parameter)
PD_MASTER_TAILOR_DATA
PN_IDENTIFICATION
IOC_ISOCHRONOUS_MODE_DATA
Data blocks for IODevice
AR_COMMUNICATION_DATA
EXPECTED_SUBMODULE_DATA
IOCR_DATA
LOCAL_SCF_ADAPTION
ALARMCR_DATA
PNIOD_PROPERTIES
PNIOD_SUBMODULE_DEFINITION
AR_RECORD_DATA
SUBMODULE_PROPERTIES
Data blocks for distributedIOSystem
CONTROLLER_PROPERTIES
Data blocks for IOController
EXPECTED_CONFIG (IOController)
Submodule Ident Number values for the Interface
Submodule Ident Number values for the Port
SNMP_CONTROL
Licensing
Licensing
AddOn Software License Conditions in the European Union
Add-on to the General Conditions for Software Products for Infrastructure & Industry Business (German Law) for Customers with a Seat or Registered Office in the European Union
Ergänzungen zu den Allgemeinen Bedingungen für Software Produkte für das Infrastructure & Industry Geschäft (Deutsches Recht) für Kunden mit Sitz in der Europäischen Union
AddOn Software License Conditions outside the European Union
Add-on to the “International Terms & Conditions for Products” and the “Software Licensing Conditions” for Customers with a Seat or Registered Office outside the European Union
Ergänzungen zu den „Internationalen Bedingungen für Produkte“ und den „Software-Lizenzbedingungen“ für Kunden mit Sitz außerhalb der Europäischen Union
Appendix
Appendix

Back to home page