FABRIKAUTOMATION

MANUAL
ICE1-8DI8DO-G60L-C1-V1D
Fieldbus Modules with
Logical-Control

R
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

4.6 Integrated Programmable Logic Unit

The multiprotocol module ICE1-8DI8DO-G60L-C1-V1D has an integrated programmable logic
unit, called the "control application." This module can execute user programs that have been
created with a small external tool called LDMicro. These user programs are created in a ladder
logic and are called "control programs." This means that the user can add additional control
logic, which is stored directly in the module and is independent of a higher-level control. This
ranges from simple Boolean operations of the inputs and outputs through to autonomous
programs. To a PLC, the module appears as a normal slave module with 8 bit output data and
16 bit input data.

Note!
Inputs or outputs that are used by the control application can no longer be directly controlled by
the PLC. However, the inputs or outputs can communicate with the PLC since the
corresponding cyclic bits are read and written by the control program.

Parameter
The multiprotocol module ICE1-8DI8DO-G60L-C1-V1D has an additional PLC parameter,
which is used to control the start behavior of the logic unit.
Control start parameter
Disabled The control application is disabled
Locked The control application is disabled and cannot be started via the web
interface.
Run The control application starts in the RUN status and executes a valid
loaded program.

Figure 4.31 Control start parameter in the TIA Portal

Control Programming
Control/LDMicro framework conditions
Max. rungs 99
Max. bits 99
Max. integers 99
Min. microcontroller cycle time 10 ms
2017-05

56
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

LDMicro
Open source ladder logic programming tool:
Download LDMicro at: https://www.pepperl-fuchs.de or http://cq.cx/ladder.pl#dl

Figure 4.32 LDMicro user interface

With LDMicro, the user can create programs in a ladder-diagram style in line with EN 61131-3.
In a ladder-diagram style, all elements of the program are assigned to horizontal lines (rungs).
The paths are always executed from left to right without an established rung order. This concept
has its origin in hard-wired relay circuits.
LDMicro offers a wide variety of applications:
■ Bit operations such as contacts, coils, set/reset
■ Edge detection
■ Timer and on and off delays
■ Count-up, count-down, ring counter
■ 16 bit arithmetic operations with prefix.
Control programs that have been created with LDMicro can:
■ Use all inputs and outputs on the module
■ Respond to diagnostic events (short circuit, low voltage, etc.)
■ Communicate with a connected PLC
■ Release information about the network
2017-05

57
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Program files for LDMicro are named with .ld. These files can be loaded, edited and saved via
the LDMicro application. To compile a program for the control application, first select the
correct destination type under "Settings" -> "Microcontroller" -> Interpretable Byte Code. It
is also possible to set the cycle time (Settings -> MCU parameters). A cycle time of 10 ms or
more is recommended. Then select the menu "Compile" -> "Compile as..." and select a
location and a name for where the compiled program should be saved. The result is a .int file.
This file can now be uploaded to the control application via the web interface.
LDMicro recognizes the following types of data:

Bit 0 or 1
Int 16 bit integer (-32768 to +32767)
T Timer
C Counter

Conventions for Naming

LDMicro
There are three types of bits with a compulsory naming convention

Type Convention Example

Input bit Must begin with "X" X1A, X5P
Output bit Must begin with "Y" Y2B, Y3P
Internal relay Must begin with "R" R1, RRun, RStart

Microcontroller

Type Convention Example

Physical I/O input data X followed by port number and X1A, X5B
channel
Physical I/O output data Y followed by port number and Y2B, Y7A
channel
Cyclic data for PLC Y followed by "P" and bit YP5, YP15
number
Cyclic data from the PLC X followed by "P" and bit XP0, XP6
number
Special bits "X" or "Y" followed by _ X_DIA, Y_STOP
(underscore) and a name
Integer values for I/Os IN or OUT followed by byte IN1, IN2, OUT1, OUT2
number
Integer values for specific _ (underscore) followed by a _SCS, _CE1
information name

Available Data
This data is available in the LDMicro program itself. Simply name a bit or integer variable in
LDMicro according to the following list.
2017-05

58
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Fundamental input/output data

Symbol Direction Type Description
XnA Input Bit Digital inputs channel
A. n = port.
Value range: 1 ... 8
XnB Input Bit Digital input channel
B. n = port.
Value range: 1 ... 8
YnA Output Bit Digital output channel
A. n = port.
Value range: 1 ... 8
YnB Output Bit Digital output channel
B. n = port.
Value range: 1 ... 8
XPn Input Bit Cyclic input data from
the PLC (consumption
data)
n = 0 ... 7
YPn Output Bit Cyclic output data for
the PLC (data
generation)
n = 0 ... 15
OUT1 Output Int 1st output byte
OUT2 Output Int 2nd output byte
IN1 Input Int 1st input byte
IN2 Input Int 2nd input byte

Diagnostic information
Symbol Direction Type Description
X_DIA Input Bit Diagnosis master bit
X_SCS Input Bit Sensor diagnosis bit
X_SCA Input Bit Actuator diagnosis bit
X_LVS Input Bit Sensor supply voltage
error
X_LVA Input Bit Actuator drive supply
voltage error
X_COMM Input Bit Cyclic connection to
PLC established
_SCS Input Int Sensor short-circuit
information per port
_CE1 Input Int Channel error LSB
_CE2 Input Int Channel error MSB

Control
Symbol Direction Type Description
Y_STOP Output Bit Causes the control
application to stop
Y_DIS Output Bit Causes the control
application to lock
itself
2017-05

59
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Special
Symbol Direction Type Description
_MSG Output Int Show message with
the corresponding
number on web GUI
X_Bn Input Bit Virtual button on web
GUI pressed
n = button number 1 ...
10
_Pn Output Int Data for publication
n = 0 ... 1

Physical and Logical Input and Output Data

The symbols XnA and XnB allow the control program to read the corresponding physical input
directly. A contact named with this symbol would be interpreted as closed if the corresponding
input pin were to be short-circuited with + 24 V DC (e.g., pin 1). The symbols XnA and XnB allow
you to directly control a physical digital output. A coil named with this symbol would activate the
corresponding output pin, which is set to + 24 V DC.

Inputs and outputs that are used in a control program are separated from the corresponding
cyclic data to and from the PLC. However, this cyclic data can still be read and manipulated by
the control program to communicate or exchange information with the PLC. Inputs and outputs
that are NOT used can still be directly controlled by a PLC.
The module provides the PLC with 16 bit cyclic input data (production data), which is shown in
the control program with the symbol YPn , whereby n is the cyclic bit number in the range from
0 to 15. A coil with this name would control the corresponding cyclic bit in the data of the
module. Only cyclic bits that are separated from physical inputs and outputs because they are
used in a control program can be manipulated in this way.
The 8 bit cyclic output data from the PLC (consuming data) can also be read with a control
program with the XPnsymbol. n is the cyclic bit number in the range from 0 to 7. This allows the
control application to respond to events that are triggered by the PLC.

Cyclic Input Data and the Corresponding Bit Names in LDMicro

The module provides a byte of input data. Normally you have direct control of the eight physical
module outputs. However, if the control application is a physical output, the consumption data
is still read by the control program to respond to PLC events.

Byte 0 Bit 0 Bit 1 Bit 2 Bit 3 Bit 4 Bit 5 Bit 6 Bit 7

Corresponding Port 5 Port 5 Port 6 Port 6 Port 7 Port 7 Port 8 Port 8
physical output Channel Channel Channel Channel Channel Channel Channel Channel
A B A B A B A B
LDMicro: Y5A Y5B Y6A Y6B Y7A Y7B Y8A Y8B
Bit for the control of
physical outputs
LDMicro: XP0 XP1 XP2 XP3 XP4 XP5 XP6 XP7
Bit for reading cyclic
data from the PLC (if
the output is
controlled by the
control program)
2017-05

60
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Cyclic Output Data and the Corresponding Bit Names in LDMicro

The module provides two bytes of output data. Normally this represents the state of the 16
physical inputs of the module. The control application can manipulate the output data to send
information to the PLC.

Byte 0 Bit 0 Bit 1 Bit 2 Bit 3 Bit 4 Bit 5 Bit 6 Bit 7

Corresponding Port 1 Port 1 Port 2 Port 2 Port 3 Port 3 Port 4 Port 4
physical input Channel Channel Channel Channel Channel Channel Channel Channel
A B A B A B A B
LDMicro: Y1A Y1B Y2A Y2B Y3A Y3B Y4A Y4B
Bit for controlling
physical inputs
LDMicro: YP0 YP1 YP2 YP3 YP4 YP5 YP6 YP7
Bit for writing cyclic
data from the PLC

Byte 0 Bit 0 Bit 1 Bit 2 Bit 3 Bit 4 Bit 5 Bit 6 Bit 7

Corresponding Port 5 Port 5 Port 6 Port 6 Port 7 Port 7 Port 8 Port 8
physical input Channel Channel Channel Channel Channel Channel Channel Channel
A B A B A B A B
LDMicro: Y5A Y5B Y6A Y6B Y7A Y7B Y8A Y8B
Bit for controlling
physical inputs
LDMicro: YP8 YP9 YP10 YP11 YP12 YP13 YP14 YP15
Bit for writing cyclic
data from the PLC

HTTP Status Information and Public Data

Integer variables that are identified with _Pnare considered as published. n is a number from 0
to 31. The variables can be read by an HTTP request as part of the control status information,
which is provided in the JSON format.

HTTP request: http://[IP address]/r/state.dcu

The request contains the following information:

Object Data type Name Description

Root Boolean supported True, provided the module has a control
functionality
Root String state Text display of the current state of the control
program
Root Boolean autostart True, provided the control auto start is enabled
via the web interface
Root Integer color Color of the text status string
Root Boolean runAllowed True, provided the control program can be set
in run mode
Root Boolean reloadAllowe True, provided a new control program can be
d uploaded
Root Boolean disableAllow True, provided the control application can be
ed disabled
Root Boolean warnRunStop True, provided a status change to RUN or
STOP influences the I/O control
2017-05

61
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Object Data type Name Description

Root Boolean warnDisable True, provided a status change to DISABLED
influences the I/O control
Root Object program Contains information on the current control
PROGRAM program
Root Object gui Information on the virtual GUI
GUI
PROGRAM Boolean valid True, provided a valid control program is
loaded
PROGRAM Integer maxlines Maximum number of lines that are allowed in a
control program
PROGRAM Integer bitcount Number of used bits of the current control
program
PROGRAM Integer intcount Number of used integer numbers of the
current control program
PROGRAM Integer cycle Cycle time in ms of the current control
program
PROGRAM String array channels Text display of the I/O channels used by the
control program
PROGRAM Array Publish Published integer values
PUBLISH
PUBLISH Integer PNr Number of the public integer (0 ... 31]
PUBLISH Integer PVal Value of the public integer

Control Web Interface

Figure 4.33 Control web interface without loaded program

The control web interface enables the user to upload programs to the control application and
control the control status.
2017-05

62
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Figure 4.34 Control web interface with loaded program

User Name and Password

To change the control status or upload programs, you can use the "WRITE" or "ADMIN" user
names.
The default password for the "ADMIN" user is "private".

Control Status
The following control statuses are displayed:

Status Description
NO PROGRAM There is no program loaded or the uploaded file is not a valid program.
LOCKED The control application is locked by the master configuration (PLC).
DISABLED The control application is disabled. There is no program running and the
control application has no control over the inputs and outputs.
STOP The control application controls the inputs and outputs that are used in the
loaded program, but the program is stopped.
All other inputs and outputs can still be controlled by the master.
RUN The control application controls the inputs and outputs that are used in the
loaded program and the program is executed.
All other inputs and outputs can still be controlled by the master.
2017-05

63
 ICE1-8DI8DO-G60L-*V1D, ICE1-16DI-G60L-V1D
Commissioning

Uploading a Program to the Control Application

Programs that are created and compiled with LDMicro can be uploaded directly into the control
application. Select the program file (.int) and press the "Upload" button. The "Upload" program
is NOT permitted if the control application is in RUN mode. WRITE or ADMIN user rights are
required to upload a control program.

Program Information
The box on the right-hand side displays certain information about the currently loaded program.
The I/O table shows all the physical inputs and outputs that are used by the PLC program. Only
these I/Os are controlled by the control program. All other I/Os can be controlled by a fieldbus
master (if available). The public table shows all public variables that are used in the program
and the corresponding values. The public variables can be obtained by sending a JSON
request to the IP address of the modules:
http://[IP address]/r/state.dcu

Auto Start
If the auto start check box is enabled, the control application starts automatically in RUN mode
if the module is switched on and if a valid program is loaded.

2017-05

64
FACTORY AUTOMATION –
SENSING YOUR NEEDS

Worldwide Headquarters
Pepperl+Fuchs GmbH
68307 Mannheim · Germany
Tel. +49 621 776-0
E-mail: info@de.pepperl-fuchs.com

USA Headquarters
Pepperl+Fuchs Inc.
Twinsburg, Ohio 44087 · USA
Tel. +1 330 4253555
E-mail: sales@us.pepperl-fuchs.com

Asia Pacific Headquarters

Pepperl+Fuchs Pte Ltd.
Company Registration No. 199003130E
Singapore 139942
Tel. +65 67799091
E-mail: sales@sg.pepperl-fuchs.com

www.pepperl-fuchs.com
Subject to modifications
Copyright PEPPERL+FUCHS • Printed in Germany / DOCT-5469A
05/2017