VIPA CP 1413plus User manual

Subject to change to cater for technical progress
Manual
CP 1413plus
Order No.: VIPA SSN HB83E
Rev. 00/07

jkjlj

CP1413plus manual
Subject to change to cater for technical progress
The information contained in this manual is subject to change without notice. VIPA GmbH does not
accept any liabilities, express or implied, with this document. Any hardware and software described
in this manual is supplied on the basis of a general licence. Software usage and disclosure to third
parties is only permitted where this is subject to the contractual conditions. Anyone who prepares
copies of the software or the manual on magnetic tape, diskette or any other medium for purposes
other than for personal use will be prosecuted, unless prior written permission is obtained from
VIPA GmbH.
The software described in this manual is protected by international Copyright laws. Any information
that might have become available after this manual was printed are supplied in a file on the
accompanying disk. If this information is available insert the VIPA driver diskette #1 into drive A
and enter the following command for MS-DOS:
A>TYPE README.TXT
If you should be using Windows®, you can use "NOTEPAD" to view the file.
© Copyright 2000 VIPA, Gesellschaft für Visualisierung und Prozeßautomatisierung mbH,
Ohmstraße 4, D-91074 Herzogenaurach
Tel.: [phone]
Fax.: [phone]
EMail: [email protected]
http://www.vipa.de
Hotline: [phone]
All rights reserved
VIPA®is a registered trade mark of VIPA company for visualisation and process automation Ltd..
Windows®is a registered trade mark of Microsoft Corp.
Windows®NT is a registered trade mark of Microsoft Corp.
Windows®95 is a registered trade mark of Microsoft Corp.
MS-DOS®is a registered trade mark of Microsoft Corp.
SIMATIC®is a registered trade mark of Siemens AG.
NetWare®is a registered trade mark of Novell Corp.
IBM-LAN-Server®and OS/2®are registered trade marks of IBM
3Com®is a registered trade mark of 3Com Corp.
EtherLink®III is a registered trade mark of 3Com Corp.
Any other trade marks referred to in the text are the trade marks of the respective owner and we acknowledge their registration.

CP1413plus manual
Subject to change to cater for technical progress
About this manual
This manual describes the installation of the hardware and the software for a Industrial Ethernet
(H1) network.
The manual also contains a comprehensive description of the configuration and the programming of
a Industrial Ethernet network using VIPA H1 components.
Overview
Chapter 1: Introduction
This chapter contains a short description of two adapters that you may use for the
respective type of LAN. The chapter is concluded by a description of the operation
and properties of these two adapters.
Chapter 2: Planning a Network
Here you will find a summary of available cabling methods for networks together
with the respective hardware and guidelines as well as a list of possible
combinations. The chapter also presents an introduction to network planning and
the preparation and installation of the respective hardware.
Chapter 3: VIPA Network module CP1413plus
This chapter contains a technical description of the VIPA ethernet adapter
CP1413plus for personal computers. It also contains instructions for the
configuration and installation of the VIPA ethernet adapter for personal computers
with ISA- and PCI-bus interfaces and for the required software.
Chapter 4: Programming
This chapter contains a complete reference for the VIPA H1 interfacing software.
This includes specifications of the H1 layer 4 and the PLC layer 7 programming
interface.
Chapter 5: Files constants and structures
This chapter contains a description of the parameter file. It also contains up-to-
date listings for the header files H1Def.h, S5Access.h, DrvFCall.h and
WMKTypes.h.
Chapter 6: Examples
These examples demonstrate how you may receive and transmit with or without a
parameter file.
Chapter 7: H1-driver V3.xx for Windows NT
This chapter contains a complete description of the application of the CP1413plus
PC-adapter for Windows NT.

CP1413plus manual Contents
Rev. 00/07 i
Contents
1 INTRODUCTION...........................................................................................................1-1
1.1 Safety and handling precautions for the user....................................................1-1
1.1.1 Handling electrostatically sensitive modules ....................................................1-1
1.1.2 Shipping electrostatically sensitive modules.....................................................1-2
1.1.3 Tests and modifications to electrostatically sensitive modules.........................1-2
1.2 General...................................................................................................................1-3
1.3 Operation...............................................................................................................1-4
1.4 Construction..........................................................................................................1-4
1.5 Communication functions....................................................................................1-5
1.6 Access functions...................................................................................................1-5
1.7 Special features.....................................................................................................1-5
2 NETWORK PLANNING.................................................................................................2-1
2.1 Ethernet network-terminology.............................................................................2-1
2.2 Thin-ethernet-cable networks..............................................................................2-3
2.2.1 Thin-ethernet-cable network-layout..................................................................2-5
2.2.2 Regulations and specifications.........................................................................2-6
2.2.3 Technical data thin-ethernet.............................................................................2-7
2.3 Thick-ethernet-cable networks ............................................................................2-8
2.3.1 Thick-ethernet-cable network-layout...............................................................2-10
2.3.2 Regulations and specifications.......................................................................2-11
2.3.3 Technical data thick-ethernet .........................................................................2-13
2.4 Combining thin/thick ethernet cable in networks ............................................2-14
2.4.1 Combination of thin/thick ethernet cable hardware ........................................2-14
2.4.2 Thin/thick ethernet cable combination network-layout....................................2-15
2.5 Twisted Pair.........................................................................................................2-16
2.5.1 Twisted pair-cable network-layout..................................................................2-16
2.6 Planning a network-layout..................................................................................2-18
2.7 Standards and specifications ............................................................................2-19
3 VIPA CP1413PLUS NETWORK ADAPTER .................................................................3-1
3.1 Z'nyx PCI-bus adapter...........................................................................................3-2
3.1.1 Properties.........................................................................................................3-2
3.1.2 Shipment..........................................................................................................3-2
3.1.3 Hardware installation........................................................................................3-4
3.1.4 Software installation .........................................................................................3-7
3.2 3COM ISA-bus adapter .......................................................................................3-30
3.2.1 Properties.......................................................................................................3-30
3.2.2 Shipment........................................................................................................3-30
3.2.3 Hardware installation......................................................................................3-32
3.2.4 Software installation .......................................................................................3-39
3.3 Entry into protocol file [H1PROT_NIF] ..............................................................3-62

Contents CP1413plus manual
ii Rev. 00/07
4 PROGRAMMING.......................................................................................................... 4-1
4.1 General information on programming................................................................ 4-1
4.1.1 Summary, operation - procedure..................................................................... 4-3
4.1.2 Description of the H1-parameters.................................................................... 4-6
4.1.3 Error messages from .Fehler........................................................................... 4-8
4.1.4 Determining the ethernet address.................................................................. 4-10
4.2 H1 Layer 4 program interface............................................................................ 4-11
4.2.1 General information on the H1 program interface.......................................... 4-11
4.2.2 General H1 Layer 4 functions........................................................................ 4-13
4.2.3 Specific H1 Layer 4 functions ........................................................................ 4-29
4.3 PLC Layer 7 program interface .........................................................................4-41
4.3.1 General information on the PLC program interface....................................... 4-41
4.3.2 General Layer 7 functions.............................................................................. 4-42
4.3.3 File functions Layer 7.....................................................................................4-47
4.3.4 Specific Layer 7 functions..............................................................................4-61
5 FILES, CONSTANTS AND STRUCTURES.................................................................. 5-1
5.1 Parameter file description ................................................................................... 5-1
5.2 Constants and structures.................................................................................... 5-4
5.2.1 H1 protocol driver definitions............................................................................. 5-4
5.2.2 Layer 7 interface definition...............................................................................5-7
5.2.3 Definition of calling codes for drivers............................................................. 5-10
5.2.4 Definition of call types....................................................................................5-12
6 EXAMPLES .................................................................................................................. 6-1
6.1 Simple H1 transmission example........................................................................6-1
6.2 PLC reception example using a parameter file.................................................. 6-3
6.2.1 Source listing ................................................................................................... 6-3
6.2.2 Source diagrams.............................................................................................. 6-5
6.2.3 The respective PLC program...........................................................................6-8
6.2.4 The respective CP143plus parameter settings................................................6-9
6.2.5 The respective parameter file Net.net............................................................6-10
7 H1 DRIVER V3.XX FOR WINDOWS NT ...................................................................... 7-1
7.1 General.................................................................................................................. 7-1
7.2 Uninstalling older Windows NT drivers.............................................................. 7-1
7.3 Installation of the VIPA CP1413plus network adapter....................................... 7-1
7.4 Installation of the H1 driver V3.xx for Windows NT 3.51................................... 7-2
7.4.1 Installation of SSN-BG88 (Z'nyx adapter) for PCI bus..................................... 7-2
7.4.2 Installation of SSN-BG85C (3COM adapter) for ISA-Bus................................ 7-3
7.5 Installation of the H1 driver V3.xx for Windows NT 4.0..................................... 7-4
7.5.1 Installation of SSN-BG88 (Z'NYX adapter) for PCI-Bus...................................7-4
7.5.2 Installation of SSN-BG85C (3COM adapter) for ISA-Bus................................ 7-5
7.5.3 Extensions to the configuration options........................................................... 7-6

CP1413plus manual Contents
Rev. 00/07 iii
7.6 Programming.........................................................................................................7-7
7.6.1 General notes on programming........................................................................7-7
7.6.2 H1 Layer 4 programming interface.................................................................7-21
7.6.3 PLC Layer 7 software interface......................................................................7-55
7.6.4 PLC Net file functions.....................................................................................7-85
7.6.5 Files, constants and structures.......................................................................7-97
Appendix...................................................................................................A-1
A Technical data......................................................................................................... A-1
B Abbreviations..........................................................................................................B-1
C List of figures..........................................................................................................C-1
D Index ........................................................................................................................D-1

Contents CP1413plus manual
iv Rev. 00/07

1 Introduction
1.1 Safety and handling precautions for the user 1-1
1.1.1 Handling electrostatically sensitive modules 1-1
1.1.2 Shipping electrostatically sensitive modules 1-2
1.1.3 Tests and modifications to electrostatically sensitive modules 1-2
1.2 General 1-3
1.3 Operation 1-4
1.4 Construction 1-4
1.5 Communication functions 1-5
1.6 Access functions 1-5
1.7 Special features 1-5

CP1413plus manual Introduction
Rev. 00/07 1-1
1 Introduction
1.1 Safety and handling precautions for the user
1.1.1 Handling electrostatically sensitive modules
VIPA-modules contain MOS LSI components. These components are highly susceptible to voltage
transients which may occur when an electrostatic discharge takes place.
The following sign is affixed to these modules:
This symbol is attached to the module, the frame or the packing box and it indicates the sensitive
nature of the module.
Electrostatically sensitive modules may be destroyed by energies or voltages which are far lower
than human perception. It is possible that an electrostatic discharge occurs if a person who has built
up an electrostatic charge handles electrostatically sensitive modules. The resulting voltages may
damage the components on the module and thus damage or destroy the module. These faults are
often not recognized immediately. Faults may only occur after prolonged operation.
Modules that were damaged by an electrostatic discharge may exhibit erratic or faulty operating
characteristics when the ambient temperature changes, with mechanical shock or when electrical
changes occur.
The only sure protection against the destruction of electrostatically sensitive modules is provided by
consistent use of protective measures and by the responsible application of the respective rules and
regulations.

Safety and handling precautions for the user CP1413plus manual
1-2 Rev. 00/07
1.1.2 Shipping electrostatically sensitive modules
You should always use the original packing when a module must be shipped. In addition you may
also pack the module in a conductive enclosure. Conductive enclosures consist of antistatic foils or
boxes made of metallized plastic.
Some modules carry a battery. When shipping such a module, please ensure
that the conductive enclosure is not in contact with or shorting the battery
terminals.
1.1.3 Tests and modifications to electrostatically sensitive modules
When tests are performed on electrostatically sensitive modules please note the following:
• discharge “floating”instruments before use.
• ground any instrument that you want to use.
Use a properly grounded soldering iron when you are installing modifications on electrostatically
sensitive modules.
Ensure proper grounding for the worker and his tools before any attempt is
made to operate on electrostatically sensitive modules.

CP1413plus manual Introduction
Rev. 00/07 1-3
1.2 General
The VIPA CP1413plus module is a network interface for your PC which is compatible with a
number of protocols. You may use the module to provide a network interface for Industrial Ethernet
(H1) links between your offices and the shop floor. The module supports the most common
operating systems, e.g. MS-DOS, WINDOWS3.11, WINDOWS95, WINDOWSNT and
OS/2.
Depending on the type of PC bus you may choose between two types of VIPA network modules:
Fig. 1-1:CP1413plus for the PCI-Bus
PCI-Bus board
Z'nyx-board:(Order No.:VIPA SSN-BG88)
Locator
Board description: chapter 3.1
Hardware installation: chapter 3.1.3
Software installation: chapter 3.1.4
This board is plug and play compatible, i.e.
it is integrated into your system without
any user intervention.
Fig. 1-2:CP1413plus for the ISA-Bus
ISA-Bus-board
3COM-board:(Order No.:VIPA SSN-
BG85C)
Locator
Board description: Chapter 3.2
Hardware installation: Chapter 3.2.3
Software installation: Chapter 3.2.4
This board requires configuration by means
of software. The respective software is
located on the diskette 1/1
(see chapter 3.2.3.2).

Operation CP1413plus manual
1-4 Rev. 00/07
1.3 Operation
You must install the CP1413plus board directly into your PC. The board has 3 interfaces:
1. An interface for the Industrial Ethernet (H1) LAN cable via a transceiver
2. An interface for Industrial Ethernet (H1) using thin-ethernet cable
3. An interface for Industrial Ethernet (H1) via an RJ-45-socket for twisted pair cables
The required operating mode is selected automatically.
The CP1413plus communication processor communicates via the Industrial Ethernet and other
IEEE 802.3 compatible cellular networks. NDIS drivers control the exchange of data between the
CP1413plus and the PC. This provides a simple path for expanding the system when other networks
and protocols are required. It is also possible to operate multiple networking protocols in parallel..
You are provided with a simple menu-controlled configuration program to configure connection
parameters and other system related settings, like transport connections and links to the PLC. The
entered parameters are saved into a configuration file.
The module can control up to 256 connections. It is also possible to operate the module with priority
0/1 (datagram, multicast and broadcast), 2/3 and 4.
1.4 Construction
The modules are provided with:
• a standard AT or PCI interface
• an AUI interface (IEEE 802.3) for connecting to a LAN via a transceiver
• a BNC connector for thin ethernet (Cheapernet)
• an RJ-45 connector for interfacing to twisted pair cable
• a power supply for the transceiver
Interface connectors:
• a 15-pole D-type socket for connecting to a cellular network
• a BNC connector for interfacing to thin ethernet
• an RJ-45 connector for interfacing to twisted pair cable

CP1413plus manual Introduction
Rev. 00/07 1-5
1.5 Communication functions
In addition to the general test applications which are intended for common functional tests the
module is also provided with a programming interface which is independent of the operating
system:
• MS-DOS: C-interface as a library (C-source code)
• Windows®3.11, Windows®NT and Windows®95:
language-independent DLL (Dynamic Link Library)
• OS/2®: language-independent DLL (Dynamic Link Library)
1.6 Access functions
The supplied software contains a programming interface for application programs which allows for
unrestricted access to the PLC (DB:DW, module transfer, memory access, conditions and many
more). Like the communication interface this application-level support is functionally independent
of the operating system:
• MS-DOS: C-interface as a library (C-source code)
• Windows®3.11, Windows®NT and Windows®95:
language-independent DLL (Dynamic Link Library)
• OS/2®: language-independent DLL (Dynamic Link Library)
1.7 Special features
• Special featuresThe CP1413plus board may be installed as a standard interface into any
compatible PC which has provisions for an ISA- or a PCI slot.
• In addition to H1, the NDIS interface of the board may be used for other IEEE 802.3
compatible protocols.
• The CP1413plus communication processor supplies power to the transceiver.
• The generation of drivers and application programs is easily accomplished by means of the
operating-system independent libraries supplied with the module.
• Simple menu-driven configuration program.
• The module is delivered complete with all drivers and libraries.

Special features CP1413plus manual
1-6 Rev. 00/07

2 Network planning
2.1 Ethernet network-terminology 2-1
2.2 Thin-ethernet-cable networks 2-3
2.2.1 Thin-ethernet-cable network-layout 2-5
2.2.2 Regulations and specifications 2-6
2.2.3 Technical data thin-ethernet 2-7
2.3 Thick-ethernet-cable networks 2-8
2.3.1 Thick-ethernet-cable network-layout 2-10
2.3.2 Regulations and specifications 2-11
2.3.3 Technical data thick-ethernet 2-13
2.4 Combining thin/thick ethernet cable in networks 2-14
2.4.1 Combination of thin/thick ethernet cable hardware 2-14
2.4.2 Thin/thick ethernet cable combination network-layout 2-15
2.5 Twisted Pair 2-16
2.5.1 Twisted pair-cable network-layout 2-16
2.6 Planning a network-layout 2-18
2.7 Standards and specifications 2-19

CP1413plus manual Network planning
Rev. 00/07 2-1
2 Network planning
2.1 Ethernet network-terminology
An ethernet network provides a communication link between different stations on the network. The
stations on the network may consist of personal computers, industrial computers, automation
equipment etc. Stations are connected to the network and located a certain minimum distance from
each other. The stations on the network and the LAN cable form a network segment. (See Fig. 2-1).
The cable of the network segment usually consists of a number of network cables of varying length
that are linked by means of connectors.
The length of the network segment and the number of stations that may be connected to it is limited.
It is possible to extend a network segment by linking multiple segments via repeaters.
A repeater increases the physical topology of a network. The repeater requires two transceivers to
link two different segments to each other. In this case the repeater is transparent to the network and
combines the two segments into a single logical channel.
In this situation the repeaters task is to regenerate and to amplify the signals in both directions. It
must also be able to recognize, process and to communicate inter-segment collisions. Repeaters do
not posses a unique address and are therefore not accessible as they are invisible to the stations
connected to the network.
The overall network cable consists of the sum of all segment cables.
Fig. 2-1:Parts of an ethernet network

Ethernet network-terminology CP1413plus manual
2-2 Rev. 00/07
Three types of ethernet cable exist:
• Thin-ethernet-cable (also called thin ethernet cable or Cheapernet-cable).
• Thick-ethernet-cable (also called thick ethernet cable or standard ethernet-cable or yellow-cable).
• Twisted pair-cable (telephone cable)
Thin ethernet-cable is far more economical than thick ethernet-cable. This applies to the cost of the
cable, the cost of installation and any additional hardware. It does, however, suffer from a higher
level of susceptibility for EMC interference. Connections to the thin ethernet-cable are provided by
BNC T-pieces.
Thick ethernet-cable consists of a thick yellow cable which is much like a pipe. The cable has
markings at a distance of 2,5 m which indicate the positions where a connection to the cable may be
attached.
These two types of network cable can be employed to produce in three different versions of ethernet
network:
1. a network using only thin ethernet cable
2. a network consisting only of thick ethernet cable and
3. a combination of these two
Under certain conditions you may also use twisted telephone twin-cable instead of the coaxial cable
(twisted pair).
Twisted pair cable consists of four insulated copper wires of 1 mm diameter that have been twisted
together in pairs.
In contrast to the coaxial ethernet networks which provide a type of bus-topology, the twisted pair
network is a point-to-point network. The resulting network has a star-topology. Every station is
coupled individually with a central hub to form the ethernet network.