Uk
Uk
Uk
AddOn Instructions
DTE102_Configuration
INACTIVE
INPUT
OUTPUT
RWH_RW
DTE102
connected to Allen Bradley CompactLogix L32E revision 19.11
via the integrated Ethernet/IP interface of the CPU
1
Table of contents
2
1. Preliminary note
These instructions
help to establish the communication between an RFID DTE102 evaluation unit and an Allen Bradley
CompactLogix controller via the integrated Ethernet interface of the CompactLogix CPU
describe the use of the AddOn functions DTE102_Configuration, DTE102_ReadWrite, DTE102_Input and
DTE102_Output in the RSLogix 5000 program.
2. General
The AddOn instructions permit easy configuration of each of the 4 channels of DTE102 in the RSLogix5000 program
via the PLC software, i.e. to configure the channels as RWH_RW, input, output or as inactive.
The following functions, depending on the channel setting, are supported by the respective AddOn instructions
(AOI):
INACTIVE:
Read the diagnostic data of the channel in the evaluation unit
INPUT:
Read the digital signals on the C/Qi input
Read the digital signals on the I/Q input
Monitor the load at the L+ connection of the port
Read the diagnostic data of the channel of the evaluation unit
OUTPUT:
Control the digital signal on the C/Qo output
Read the digital signals on the I/Q input
Activate the increased current supply of the C/Qo port (only available for channels 3 and 4)
Monitor the load at the L+ connection of the port
Read the diagnostic data of the channel of the evaluation unit
RWH_RW:
Detect the presence of a tag
Read the UID of a tag
Read the USER memory from a tag
Describe the area of the USER memory of a tag
Switch the antenna off and on
Read the diagnostic data of the channel of the evaluation unit
3
3. Installation
Figure 1
As a standard the DTE102 evaluation unit is configured with the IP address 192.168.0.79 and the subnet mask
255.255.255.0.
By entering the IP address in the internet explorer you get to the web interface surface to configure the
network settings.
The change in the network settings must be confirmed by pressing the [submit] button.
4
4. Configure the connection to the DTE102 evaluation unit in the RSLogix 5000 software
This part of the description refers to the RSLogix software version V19.01.00 (CPR 9 SR 3).
Figure 2
5
Figure 3
A double click on Communications opens the selection window for the communication module (Figure 4)
Figure 4
Select Generic Ethernet Module from the list and confirm with [OK]
6
Figure 5
Figure 6
7
Figure 7
8
5. Import the AddOn functions to a project
Figure 8
Figure 9
Select the XXXX.L5X file from the respective path and click on Import
9
Figure 10
10
Figure 11
After successful import the instructions are displayed in the AddOn Instructions folder.
11
5.1 Integrate the AddOn instructions in the PLC program
Here it is described how the AddOn instructions are implemented in the user PLC program.
After the import of the AddOn instructions (functions) they can be integrated into the PLC program as a ladder element.
Figure 12
By pressing the Ins keyboard button, the selection window of the ladder elements opens
In the AddOn tab you can find the instructions imported before
Select DTE102_Configuration and confirm with [OK]
12
Figure 13
The instruction is integrated in the path (Rung) and can now be configured.
13
6. Send the configuration data to the DTE102 evaluation unit
The DTE102_Configuration instruction needs the current status of the Ethernet/IP communication to the DTE102
evaluation unit for the process. This requires the GSV command (Get System Value) from the existing library.
The GSV command monitors the status of the configured module and passes the status on to a defined variable as DINT
value. The first bit of the DINT variable is used as health bit.
If the PLC program is transferred from the programming unit to the PLC, the connection to DTE102 has to be
interrupted for a short time to assign the current configuration data. To do so, an SSV (Set System Value) from the
existing library is used.
Figure 14
By pressing the Ins keyboard button the selection window for the ladder elements opens
Select the GSV/SSV command and confirm with [OK].
14
If the GSV and SSV commands are implemented in the PLC program, they have to be linked logically as illustrated in
Figure 15. The requested variables and timers, with the exception of s:fs (first scan), must be newly created.
Figure 15
GSV command:
Class name = Module
Instance Name = DTE102
Attribute Name = EntryStatus
Dest = DTE102_Status (previously defined variable)
SSV command:
Class name = Module
Instance Name = DTE102
Attribute Name = Mode
Source = ssv_Value (previously defined variable)
15
Description:
After every new start of the PLC the Restart bit is low. This state sends the value 4 to the ssv-Value variable and starts a
switch-on delay timer T_Restart.
The value of the ssv-Value variable is transferred to the SSV function. This function in turn deactivates the
communication to the DTE102 evaluation unit.
When the T_Restart time has elapsed, the Restart variable is set. With the set Restart variable the value 0 is loaded into
the ssv_Value variable. With this value the SSV function re-establishes the connection to the DTE102 evaluation unit
and the DTE102_Configuration AddOn instruction is executed. It now sends the configuration data to the DTE102
evaluation unit.
Figure 16
7.1 General
During every new start and a resulting new connection, this instruction transmits the IO port configuration data
defined by the user to the DTE102 evaluation unit.
This depends on the controller version. Since the controllers with a revision no. < 20 cannot process any EDS files, it
is necessary to transmit the configuration data to the DTE102 evaluation unit via PLC program.
Each I/O port can be configured as input (parameter: 1), as output (parameter: 2), as ReadWrite (parameter: 3) or
as inactive (parameter: 0).
16
Figure 17
Input parameters:
Name Type Description
iarybConfigData SINT[40] Configuration address of the DTE102 evaluation unit (DTE102:C.Data)
iiFunctionCh1 -4 INT Function definition:
0 = INACTIVE IO port is deactivated
1 = INPUT reads the binary I/Q input and C/Qi of the IO port
2 = OUTPUT switches the binary "C/Qi" output of the IO port /reads
the binary I/Q input of the IP port
3 = RWH_RWread the UID or the user data / write data to the user
data zone of the tag
Output parameters:
Name Type Description
oxConfigNoError BOOL high if an invalid function number is entered.
Table 2
7.2 Handling
The parameters of the IO ports have to be set before the transmission of the PLC software to the controller.
If the parameters are changed during the program sequence, malfunctions of the DTE102 evaluation unit may result.
If an invalid parameter number has been entered for iParaCH1 iParaCh4, the "oxConfigNoError output is set to high.
The iiTDBLCh1-4 parameter is selected on the basis of the tags used.
The iiDataHoldTimeCh1-4 parameter defines, how long the data read from the tag is stored in the DTE102 transmission
buffer.
17
7.2.1 Valid parameter numbers for iiFunctionCh1-4:
0 = IO port inactive
1 = IO port input
2 = IO port output
3 = IO port ReadWrite
Figure 18
Example: E80370:
Figure 19
18
8. Description of INACTIVE AOI
Figure 20
8.1 General
This function block can be used for a channel of the DTE102 evaluation unit configured as INACTIVE. It provides the
function:
Read the diagnostic data of the channel in the evaluation unit
In every PLC cycle, the function block extracts the data of the channel from the input data of the evaluation unit. If a
diagnosis event occurs on the channel, the diagnostic data is read automatically and it is displayed on the output
parameters. Reading the diagnostic data is asynchronous, i.e. it stretches across several PLC cycles.
Input parameters:
Name Type Description
ixConnOK BOOL Ethernet/IP connection to the evaluation unit has been established
Output parameters:
Name Type Description
oardwDiagData ARRAY[0..3] OF DWORD Array with diagnostic data (error codes see device manual DTE102)
Table 4
19
8.3 Handling
The input data of the evaluation unit is provided to the function block at the iarbDTE102 input parameter. The
oarbDTE102 output parameter refers to the output data that is transferred to the evaluation unit.
The iiChannelNo input parameter determines which channel of the evaluation unit is to be processed.
The ixConnOK input parameter signals to the function block that the Ethernet/IP connection to the evaluation unit has
been established. Preferably, this input parameter is to be linked to the respective connection bit from the status byte
of the GSV command (chapter 6).
As long as the ixConnOK input parameter = FALSE, the diagnostic data displayed at the output parameters is initialised
with 0. If the signal at the ixConnOK input parameter = TRUE, the function block starts to work.
If the evaluation unit signals an error on the configured channel, the function block automatically adds the control
signals for reading the diagnostic data to the output data to the evaluation unit. The contained diagnostic data is
displayed in the oardwDiagData output parameter. The diagnostic data displayed so far is completely deleted. The
oiDiagLength output parameter indicates how many diagnostic data sets are currently displayed.
The error codes in the diagnostic data are described in the device manual of the evaluation unit.
A rising edge on the ixAckDiag input parameter deletes the displayed diagnostic data.
Figure 21
9.1 General
This function block can be used for a channel of the DTE102 evaluation unit configured as INPUT. It provides the
following functions:
Read the digital signals on the C/Qi input
Read the digital signals on the I/Q input
Monitor the load at the L+ connection of the port
Read the diagnostic data of the channel of the evaluation unit
In every PLC cycle, the function block extracts the data of the channel from the input data of the evaluation unit and
provides the data of the digital inputs of the channel at its output parameters.
If a diagnosis event occurs on the channel, the diagnostic data is read automatically and it is displayed on the output
parameters. Reading the diagnostic data is asynchronous and stretches across several PLC cycles. The cyclic functions
of the function block are not affected.
If this function block is used for a channel that is not configured as INPUT, this will lead to malfunctions of the function
block.
20
9.2 Parameter description
Input parameters:
Name Type Description
ixConnOK BOOL Ethernet/IP connection to the evaluation unit has been established
Output parameters:
Name Type Description
9.3 Handling
The input data of the evaluation unit is provided to the function block at the iarbDTE102 input parameter. The
oarbDTE102 output parameter refers to the output data that is transferred to the evaluation unit.
The iiChannelNo input parameter determines which channel of the evaluation unit is to be processed.
The ixConnOK input parameter signals to the function block that the Ethernet/IP connection to the evaluation unit has
been established. Preferably, this input parameter is to be linked to the respective connection bit from the status byte
of the GSV command (chapter 6).
As long as the ixConnOK input parameter = FALSE, all output parameters are initialised with 0. If the signal at the
ixConnOK input parameter = TRUE, the function block starts to work.
A channel of the evaluation unit configured as INPUT provides 2 digital inputs. The status of these inputs is displayed at
the oxCQi and oxIO output parameters. An overload of the voltage supply from these inputs is signalled at the
oxOverload output parameter.
If the evaluation unit signals an error on the configured channel, the function block automatically adds the control
signals for reading the diagnostic data to the output data to the evaluation unit. The contained diagnostic data is
displayed in the oardwDiagData output parameter. The diagnostic data displayed so far is completely deleted. The
oiDiagLength output parameter indicates how many diagnostic data sets are currently displayed.
The error codes in the diagnostic data are described in the device manual of the evaluation unit.
A rising edge on the ixAckDiag input parameter deletes the displayed diagnostic data.
21
10. Description of OUTPUT AOI
Figure 22
10.1 General
This function block can be used for a channel of the DTE102 evaluation unit configured as OUTPUT. It provides the
following functions:
Control the digital signal on the C/Qo output
Read the digital signal on the I/Q input
Activate the increased current supply of the C/Qo port (only available for channels 3 and 4)
Monitor the load at the L+ connection of the port
Read the diagnostic data of the channel of the evaluation unit
In every cycle, the function block extracts the data of the channel from the input data of the evaluation unit and
provides the data of the digital input of the channel at its output parameters. The signals for the digital output of the
channel are added cyclically to the output data to the evaluation unit.
If a diagnosis event occurs on the channel, the diagnostic data is read automatically and it is displayed on the output
parameters. Reading the diagnostic data is asynchronous and stretches across several PLC cycles. The cyclic functions of
the function block are not affected.
If this function block is used for a channel that is not configured as OUTPUT, this will lead to malfunctions of the
function block.
22
10.2 Parameter description
Input parameters:
Name Type Description
ixConnOK BOOL Ethernet/IP connection to the evaluation unit has been established
ixHighCurrent BOOL Activate the increased voltage supply of the C/Qo port
Output parameters:
Name Type Description
10.3 Handling
The input data of the evaluation unit is provided to the function block at the iarbDTE102 input parameter. The
oarbDTE102 output parameter refers to the output data that is transferred to the evaluation unit.
The iiChannelNo input parameter determines which channel of the evaluation unit is to be processed.
The ixConnOK input parameter signals to the function block that the Ethernet/IP connection to the evaluation unit has
been established. Preferably, this input parameter is to be linked to the respective connection bit status byte of the GSV
command (chapter 6).
As long as the ixConnOK input parameter = FALSE, all output parameters are initialised with 0. If the signal at the
ixConnOK input parameter = TRUE, the function block starts to work.
A channel of the evaluation unit configured as OUTPUT provides 1 digital output and 1 digital input. The status of the
input is displayed at the oxIO output parameter. The signal at the ixCQo input parameter is entered in the output data
to the evaluation unit and controls the digital output of the channel. The signal at the ixHighCurrent input parameter is
only considered for channels 3 and 4 and transferred to the evaluation unit. An overload of the voltage supply from the
input or the output is signalled at the oxOverload output parameter.
If the evaluation unit signals an error on the configured channel, the function block automatically adds the control
signals for reading the diagnostic data to the output data to the evaluation unit. The contained diagnostic data is
displayed in the oardwDiagData output parameter. The diagnostic data displayed so far is completely deleted. The
oiDiagLength output parameter indicates how many diagnostic data sets are currently displayed.
The error codes in the diagnostic data are described in the device manual of the evaluation unit.
23
A rising edge on the ixAckDiag input parameter deletes the displayed diagnostic data.
Figure 23
11.1 General
This function block can be used for a channel of the DTE102 evaluation unit configured as RWH_RW. The data can be
read from a tag or saved on a tag by means of a connected RFID antenna.
If this function block is used, the Data Hold Time parameter must be set to 0 at DTE102_Configuration
Instruction (chapter 7) for parameter setting of the channel.
24
If this function block is used for a channel that is not configured as RWH_RW, this will lead to malfunctions of the
function block.
The function block extracts the data of the channel from the input data of the evaluation unit and evaluates it. Control
signals for reading or writing a tag are added to the output data to the evaluation unit. If a diagnosis event occurs on
the channel, the diagnostic data is read automatically and it is displayed on the output parameters.
The communication has to follow a defined process. Figure 24 illustrates this on the basis of a flow chart.
Figure 24
To make command processing more user-friendly, the DTE102_RWH_RW function block was developed. This function
block processes the above-mentioned command protocol automatically.
ixConnOK BOOL Ethernet/IP connection to the evaluation unit has been established
iiRdWrStartAddr INT Start address in the USER memory of the tag for reading/writing
25
Output parameters:
26
11.3 Build-up of the communication
The input data of the evaluation unit is provided to the function block at the iarbDTE102 input parameter; the
oarbDTE102 output parameter refers to the output data that is transferred to the evaluation unit.
The iiChannelNo input parameter determines which channel of the evaluation unit is to be processed.
The ixConnOK input parameter signals to the function block that the Ethernet/IP connection to the evaluation unit has
been established. Preferably, this input parameter is to be linked to the respective connection bit status byte of the GSV
command (chapter 6).
As long as the ixConnOK input parameter = FALSE, the
oxBusy = TRUE and owStatus = 0x1000 output
parameters are output. All other output parameters
are initialised with 0.
ixConnOK
Set the ixConnOK input parameter = TRUE:
The communication with the configured channel
of the evaluation unit is activated. The signals for ixAntOff
the data exchange are synchronised.
The ixAntOff input parameter = FALSE activates
the antenna
oxBusy
If the data exchange was synchronised and the
antenna activated, the oxBusy = FALSE output
parameter is output. The function block is now ready oxDone
for the data exchange with a tag.
oxError
Figure 25
The DTE102_RWH_RW function block is a function block working in an asynchronous way, i.e. processing stretches
across several function block calls.
The processing state of the function block is displayed on the owStatus output parameter.
As long as the connected antenna detects a tag, the oxTagPresent output parameter is set.
If the function block displays FALSE at the oxBusy output parameter, it is ready for a new command.
Define via the ixUserMem input parameter, if the USER memory or the UID of the tag should be accessed.
Indicate the USER memory area in the iiRdWrStartAddr and iiRdWrLength input parameters.
A rising edge on the ixRead or ixWrite input parameter starts reading of or writing to the tag.
The displayed diagnostic data is deleted and the receive buffer defined at the oarbRcvBuf output parameter is
initialised.
During processing the oxBusy output parameter is TRUE. The progress of command processing is displayed in the
owStatus output parameter.
With completion of the command, the oxBusy = FALSE output parameter is output. The result of processing is indicated
in the oxDone and oxError output parameters. It is kept as long as the triggering ixRead or ixWrite input parameter is
27
TRUE, min. however for one PLC cycle.
The result is displayed as follows:
No error occurred during processing:
oxDone = TRUE
oxError = FALSE
owStatus = 0x0000
oiRcvdLength = indicates the number of the data read
The data read is stored in the receive buffer defined by the oarbRcvBuf output parameter.
Error occurred during processing
oxDone = FALSE
oxError = TRUE
owStatus indicates an error code. The possible error codes are listed in Table 12.
As an example, the signal characteristics are shown in Figure 26.
ixConnOK
ixRead
oxBusy
oxDone
oxError
0X7***
0X7***
0X7***
0X7***
0x7000
0x0000
0x7000
0x0000
0x7000
0x7000
0x7000
0x8***
owStatus 0x8***
Figure 26
If the evaluation unit signals an error on the configured channel, the function block automatically adds the control
signals for reading the diagnostic data to the output data to the evaluation unit. The contained diagnostic data is
displayed in the oardwDiagData output parameter. The diagnostic data displayed so far is completely deleted. The
oiDiagLength output parameter indicates how many diagnostic data sets are currently displayed.
28
11.4.1 Read the UID of the tag
29
11.4.4 Displays at the owStatus output parameter
Status displays
owStatus Description
30
Error codes
owStatus Description
0x8000 Evaluation unit indicates an error; evaluate the diagnostic data in the oardwDiagData output parameter.
For the error codes see the device manual.
0x8301 Start of a command while the function block is busy (oxBusy = TRUE)
0x8302 Start of a command with antenna switched off (ixAntOff = TRUE)
0x8303 Simultaneous start of the read and write command
0x8304 Start of a command without tag in the antenna field
0x8305 iiRdRwLength input parameter <= 0 or greater than the defined receive buffer (oarbRcvBuf)
0x8306 iiRdRwLength input parameter <= 0 or greater than the defined send buffer (iarbSendBuf)
0x8307 Write UID is not supported by the system
0x8401 (oarbRcvBuf) receive buffer too small for cyclically read UID
Table 12
31