EN WirelessHART Gateway 58
EN WirelessHART Gateway 58
EN WirelessHART Gateway 58
HART Parameters
Parameter Description
58
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Parameter Description
Loop Current The loop current is being held at a fixed value and is not responding to
Fixed process variations.
More status More status information is available via Command 48 (Read Additional Status
available Information).
Cold Start A power failure or device reset has occurred.
Configuration An operation was performed that changed the device's configuration.
Changed
Device The device detected a serious error or failure that compromises device
Malfunction operation.
59
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
5.5 Engineering
The Engineering section consists of the following sections:
■ Instrument List
You can freely define an instrument list of all network components before the devices
actually join the network. Hereby you can make sure that a device is associated with the
predefined I/O card number when the network is reformed or the WirelessHART gateway
is reset.
■ MODBUS Mapping
You can create the mapping table for the MODBUS input registers manually, semi-
automatically, or automatically.
Note that the instrument list must be available before you create the mapping table,
because the values for the mapping table are device-related.
■ Topology View
You can upload a background image and arrange the WirelessHART devices in the image
to set up the topology view.
Note that the instrument list must be available before you set up the topology view,
because the set of WirelessHART devices is derived from the instrument list.
PACTware®
WirelessHART Network CSV file project tree
WirelessHART DTM or
Gateway Web Interface
import
import automatic manual or
automatic user-defined addressing semi-automatic
addressing addressing from device addressing
Figure 5.18 Relationship between the configuration options in the DTM or web interface and the
data in the WirelessHART gateway
2015-07
60
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
1. The Instrument List you set up via the DTM or the web interface is not necessarily iden-
tical to the Operating Modes list of the WirelessHART gateway.
You can set up the Instrument List manually, import an existing list from a CSV file, import
the devices from the PACTware® project tree, or import the devices from the Operating
Modes list of the WirelessHART gateway. You can freely edit the Instrument List in the
DTM or web interface. Once the list of devices and their IO card and channel association
is complete, you can write this information back to the Operating Modes list of the Wire-
lessHART gateway.
The Operating Modes list contains all devices of the WirelessHART network and is con-
stantly updated.
If a new device joins the network, it is automatically inserted into the Operating Modes list.
If the long tag or address of the new device matches an entry from the list, for example, an
entry that you predefined using the Instrument List, the device is associated with the pre-
defined values. If not, it is automatically associated with the next free IO card number and
it will not appear in the Instrument List unless you import the device list from the Operat-
ing Modes list.
2. Before you create the MODBUS Mapping, you must select whether you want to create the
mapping manually, semi-automatically, or automatically:
• If you select automatic addressing, the mapping is created automatically for all
devices of the Operating Modes list. If new WirelessHART devices appear in the
WirelessHART network, they are automatically added to the Operating Modes list,
and the mapping will also be added automatically.
• If you select manual addressing, you can set up the MODBUS mapping manually
or semi-automatically for all devices of the Instrument List. Note that if a new
WirelessHART device joins the WirelessHART network, it is added to the Operating
Modes list only. Because you selected manual addressing, the automatic
addressing for the devices in the Operating Modes list is disabled and the device
does not automatically appear in the MODBUS Mapping of the WirelessHART
gateway. To set up the mapping for the new device, you must import the new device
into the Instrument List first. After the mapping is complete, you can write the
MODBUS Mapping from the DTM or web interface to the WirelessHART gateway.
3. In the DTM or web interface you can upload a background image and arrange the positions
for all devices of the Instrument List. After you set up the topology view, you can write the
information back to the WirelessHART gateway.
If a new WirelessHART device joins the WirelessHART network, it is inserted at a default
position by the WirelessHART gateway. To rearrange new devices in the DTM or web in-
terface, you can import the new device into the Instrument List or import the device list
from the WirelessHART gateway.
5.5.1 Instrument List
The instrument list is a copy of the Operating Modes list, which is currently active in the
WirelessHART gateway and represents the virtual I/O system of the WirelessHART gateway.
See chapter 2.1.3
Thus, unless the Instrument List is reloaded from the WirelessHART gateway, it may not
necessarily be identical to the Operating Modes list that is currently active in the
WirelessHART gateway.
By creating an instrument list before the devices actually join the network, you can make sure
that a device is associated with a predefined I/O card number when the network is reformed or
the WirelessHART gateway is reset. Note that the instrument list is used for editing the devices
and that the cached values of the devices are located under Measurement. See chapter 5.7
For a detailed overview of the relationship between the configuration options in the DTM or web
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
Note!
This list is stored in a non-volatile memory of the WirelessHART gateway. The card and
channel number assignment will remain the same after a restart of the WirelessHART gateway
2015-07
or software.
61
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Instrument List
Displayed
Information Description
Long Tag Long tag of the device
HART 5 devices and older devices do not support long tags. For those
devices, the WirelessHART adapter uses the content of the Message field,
which will be displayed here instead.
I/O-Card Virtual I/O card number to which the device is mapped to. See chapter 2.1.3
Channel Channel of the virtual I/O card the device is mapped to.
The value 0 identifies a WirelessHART device or a WirelessHART adapter,
while the value 1 identifies a wired device connected to a WirelessHART
adapter.
Device ID HART serial number that is assigned at manufacturing time and that differs for
each HART device of a given type. The Device ID is used to build the HART
long frame address.
Ext. Device Extended device type code of the device
Code Identifies the HART product family. Each product family is identified by a
unique code.
Table 5.14 Instrument List
Caution!
System failure
If you click Refresh right after the device was switched on or reset, the system may stop
responding.
If the device was switched on or reset, wait about 1 minute until the boot process is complete
2015-07
62
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Note!
When editing the instrument list, incomplete entries are highlighted in red. These errors must
be corrected before you can apply the instrument list.
Warnings are highlighted in yellow.
1. To read the Operating Modes list from the WirelessHART gateway using the web interface,
click Refresh. If using the DTM to configure the WirelessHART gateway, select the Wire-
lessHART gateway in the project tree and choose Device > Load from device. If using the
DTM to configure the WirelessHART gateway, you can also import the devices of the project
tree by clicking Import Project Tree (DTM).
2. To add a device, click into the last row of the instrument list and specify the device
parameters. Press Enter to confirm your entries.
You can also edit existing entries by clicking into the corresponding cells of the instrument
list.
3. To remove a device from the instrument list, click the X-sign at the end of the row. The
respective I/O card becomes vacant again.
4. To write the current instrument list to the WirelessHART gateway using the web interface,
click Apply. If using the DTM to configure the WirelessHART gateway, select the
WirelessHART gateway in the project tree and choose Device > Store to device.
Note that the consistency of the instrument list is not checked before it is applied.
To export the current instrument list to a CSV file, click Export (web interface) resp. Export
CSV (DTM).
To load the instrument list from a CSV file, click Import (web interface) resp. Import CSV
(DTM).
For more information on the structure of the CSV file, see chapter 12.
Tip
If a WirelessHART gateway is replaced with a new one, we recommend that you use the
export/import functionality to transfer the settings from the old WirelessHART gateway to the
new one. Otherwise, the new WirelessHART gateway rebuilds the WirelessHART network from
scratch by default, which means that the virtual HART I/O structure in the instrument list and
the MODBUS addresses of the devices will differ from the positions and addresses that have
been defined in the old WirelessHART gateway.
Furthermore, if using the DTM to configure the WirelessHART gateway, you can prepare the
instrument list and the MODBUS mapping tables offline and export the configuration into a
CSV file. Once the WirelessHART gateway is available on site, you can import the prepared
configuration via the CSV file.
2015-07
63
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
MODBUS Parameters
Parameter Description
Swap Option Enables you to select the Big Endian or Little Endian swap option. Note that
this setting affects both automatic and manual addressing of the MODBUS
registers.
In the following examples a word32 [ 0xABCD ] is stored into MODBUS
registers using different swap options.
Big Endian: no register swap
Registers: Big Endian
Source bytes: [ 0xABCD ]
Target bytes: reg_0: [ 0xAB ] reg_1: [ 0xCD ]
Little Endian: register swap
Registers: Little Endian
Source bytes: [ 0xABCD ]
Target bytes: reg_0: [ 0xCD ] reg_1: [ 0xAB ]
Addressing Enables you to select Auto or Manual addressing of the MODBUS registers.
Method Note that the Manual option also includes semi-automatic addressing.
■ If Auto addressing is enabled, the submenus Input Status and Input
Register are disabled and you cannot edit the MODBUS mapping
manually. The mapping is created automatically for all devices of the
Operating Modes list. If new WirelessHART devices appear in the
WirelessHART network, they are automatically added to the Operating
Modes list, and the mapping will also be added automatically. See
chapter 5.5.3.
■ If Manual addressing is enabled, you can use the submenus Input Status
and Input Register to set up the MODBUS mapping manually or semi-
automatically for all devices of the Instrument List. If a new
WirelessHART device joins the WirelessHART network, it is added to the
Operating Modes list only. The new device will not appear in the
Instrument List unless you import the device list from the Operating
Modes list. See chapter 5.5.4.
Read Enables you to define the read mode for the MODBUS master. You can select
Modbus between Input and Holding and Input Registers only. If you select Input
Registers and Holding, MODBUS masters that do not support the reading of input
Mode registers can read through the holding registers.
Table 5.15 MODBUS Parameters
For a detailed overview of the relationship between the configuration options in the DTM or web
2015-07
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
64
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Tip
If you replace a WirelessHART gateway with firmware version 2.4 or older, we recommend that
you select Auto from the Addressing Method drop-down list.
You can define the parameters for the MODBUS protocol under Parameter > Wired
Communication > Protocols > Modbus. For more information, see chapter 5.3.4.
2015-07
65
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
66
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
The same format is also used for the MODBUS 32-bit floating point values.
The MODBUS protocol does not explicitly specify any 32-bit data element. However, the usage
of 2 consecutive 16-bit registers is the de-facto standard way to map a single-precision IEEE-
754 floating-point value. Note that the MODBUS floating value will be transmitted in Big
Endian style. For example, the number 123456.00 as defined in the IEEE-754 standard
appears as follows:
This number will be transmitted from the WirelessHART gateway to the MODBUS master in the
following sequence: 47 F1 20 00 where 00 is the less significant byte, which is transmitted in
first place.
2015-07
67
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
5.5.4 Manual MODBUS Mapping for Input Status and Input Register
Note!
Manual or semi-automatic creation of the mapping table for the MODBUS input registers is
available only if the Addressing Method under Engineering > Modbus Mapping > Modbus
Settings is set to Manual. See chapter 5.5.2
The Instrument List must be available before you create the mapping table, because the
values for the mapping table are retrieved from the Instrument List.
For a detailed overview of the relationship between the configuration options in the DTM or web
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
The Input Status submenu enables you to map discrete variables on the MODBUS input
registers.
The Input Register submenu enables you to map HART variables and device-specific status
information on the MODBUS input registers.
In both submenus, you have the following options:
■ You can create the mapping table manually.
For more information, see the subsection Create MODBUS Mapping Manually.
■ You can create the mapping table semi-automatically, which means that the mapping
table is generated automatically according to your specifications.
For more information, see the subsection Create MODBUS Mapping Semi-Automatically.
Note!
The Instrument List must be available before you create the mapping table, because the
values for the mapping table are retrieved from the Instrument List.
For a detailed overview of the relationship between the configuration options in the DTM or web
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
2015-07
Figure 5.21 Engineering > Modbus Mapping > Input Status/Input Register: Manual Editing Table
68
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Table Parameters
Parameter Description
Register/End MODBUS registers into which the value is mapped.
register
Long Tag Long Tag of the device
HART 5 devices and older devices do not support long tags. For those
devices, the WirelessHART adapter uses the content of the Message field,
which will be displayed here instead.
Card Virtual I/O card number to which the device is mapped to.
For more information, see chapter 2.1.3.
Channel Channel of the virtual I/O card the device is mapped to. The value 0 identifies
a WirelessHART device or a WirelessHART adapter, while the value 1
identifies a wired device connected to a WirelessHART adapter.
For more information, see chapter 2.1.3.
Value Indicates the value that is read from the device and mapped to the MODBUS
registers.
The Input Status submenu enables you to map the following values:
■ Lower Significant Byte: If you select Lower Significant Byte, enter a
response byte as well.
■ Most Significant Byte: If you select Most Significant Byte, enter a
response byte as well.
The Input Register submenu enables you to map the following values:
■ Loop Current
■ Percent Range
■ PV: HART primary variable
■ SV: HART secondary variable
■ TV: HART tertiary variable
■ QV: HART quaternary variable
■ Device Variable: The device variable provides device-specific
information. This information is displayed using a device-specific unit
code.
For more information on what device-specific information is available and
on the device-specific unit codes, see the manual of the sub-device.
■ Battery Life
■ Device Status
For more information, see chapter 12.1.
■ Ext. Device Status
For more information, see chapter 12.1.
■ Device Status & Extended Device Status
■ CMD 48 Device Status
If you select CMD 48 Device Status, specify a response byte as well.
For more information, see chapter 12.1.
■ All CMD 48 Device States
■ Modbus Status
For more information, see chapter 12.2.
Table 5.16 Table Parameters
2015-07
69
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Caution!
System failure
If you click Refresh right after the device was switched on or reset, the system may stop
responding.
If the device was switched on or reset, wait about 1 minute until the boot process is complete
before you click Refresh.
Note!
When editing the mapping table, mapping errors or duplicate address allocations are
highlighted in red. These errors must be corrected before you can apply the MODBUS
mapping.
Warnings are highlighted in yellow.
1. To read the current mapping from the WirelessHART gateway using the web interface, click
Refresh. If using the DTM to configure the WirelessHART gateway, select the Wire-
lessHART gateway in the project tree and choose Device > Load from device.
2. On the Table tab, go to the row in the mapping table that contains free input registers that
have not been mapped yet.
3. Click into the Long Tag cell and select a device from the drop-down list.
We recommend that you map the values of the WirelessHART gateway on the first registers.
4. Click into the Value cell and select a value you want to read.
Note that if you select CMD 48 Device Status, Lower Significant Byte, or Most
Significant Byte, you must enter a response byte as well.
5. After you selected the device and value, press Enter to confirm.
The Register, Endregister, Card, and Channel values are updated automatically and a
new line for the remaining registers is inserted automatically.
6. Repeat these steps to complete the mapping table.
7. To write the current mapping table to the WirelessHART gateway using the web interface,
click Apply. If using the DTM to configure the WirelessHART gateway, select the
WirelessHART gateway in the project tree and choose Device > Store to device.
Note that the new mapping is applied immediately and the consistency of the mapping table
is not checked before it is applied.
To export the current mapping table to a CSV file, click Export (web interface) resp. Export
CSV (DTM).
To load the mapping table from a CSV file, click Import (web interface) resp. Import CSV
(DTM).
For more information on the structure of the CSV file, see chapter 12.3.
To delete a mapping entry, click the X-sign at the end of line. To delete the entire mapping
table, click the X-sign in the table header.
2015-07
70
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Tip
If a WirelessHART gateway is replaced with a new one, we recommend that you use the
export/import functionality to transfer the settings from the old WirelessHART gateway to the
new one. Otherwise, the new WirelessHART gateway rebuilds the WirelessHART network from
scratch by default, which means that the virtual HART I/O structure in the instrument list and
the MODBUS addresses of the devices will differ from the positions and addresses that have
been defined in the old WirelessHART gateway.
Furthermore, if using the DTM to configure the WirelessHART gateway, you can prepare the
instrument list and the MODBUS mapping tables offline and export the configuration into a
CSV file. Once the WirelessHART gateway is available on site, you can import the prepared
configuration via the CSV file.
Note!
The Instrument List must be available before you create the mapping table, because the
values for the mapping table are retrieved from the Instrument List.
For a detailed overview of the relationship between the configuration options in the DTM or web
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
Figure 5.22 Engineering > Modbus Mapping > Input Status/Register: Semi-Automatic Generation
2015-07
71
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Generation Parameters
Parameter Description
Start Register The first MODBUS register into which the first value is mapped.
Generation The generation order defines the order in which the HART devices will be
order mapped on the MODBUS input registers.
■ Index
The devices are mapped according to the index number. To look up the
index numbers, you can deactivate the Tree-View check box under
Diagnostics > Wireless Communication > Details.
■ Alphabetical
The devices are mapped in alphabetical order, according to the Long Tag
of the wireless device.
■ Alphabetical (sub-device)
The devices are mapped in alphabetical order, according to the Long Tag
of the sub-device.
■ IO card & channel
The devices are mapped according to the IO card & channel number of
the wireless device.
■ IO card & channel (sub-device)
The devices are mapped according to the IO card & channel number of
the sub-device.
2015-07
72
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Parameter Description
Value Enables you to define the values you want to read as well as their sequence.
Click into the Value column to select a value from the drop-down list.
The Input Status submenu enables you to map the following values:
■ Lower Significant Byte: If you select Lower Significant Byte, enter a
response byte as well.
■ Most Significant Byte: If you select Most Significant Byte, enter a
response byte as well.
The Input Register submenu enables you to map the following values:
■ Loop Current
■ Percent Range
■ PV: HART primary variable
■ SV: HART secondary variable
■ TV: HART tertiary variable
■ QV: HART quaternary variable
■ Device Variable: The device variable provides device-specific
information. This information is displayed using a device-specific unit
code.
For more information on what device-specific information is available and
on the device-specific unit codes, see the manual of the sub-device.
■ Battery Life
■ Device Status
For more information, see chapter 12.1.
■ Ext. Device Status
For more information, see chapter 12.1.
■ Device Status & Extended Device Status
■ CMD 48 Device Status
If you select CMD 48 Device Status, specify a response byte as well.
For more information, see chapter 12.1.
■ All CMD 48 Device States
■ Modbus Status
For more information, see chapter 12.2.
Default Generates a default mapping table that corresponds to the Automatic
settings mapping. For more information on the automatic mapping rules, see chapter
5.5.3.
Generate Writes the mapping to the table on the Table tab, according to your selections
on the Generate tab.
Delete all If activated, the mapping you generate overwrites all existing mappings on the
Mappings Table tab.
If deactivated, the mapping you generate is added to existing mappings on
the Table tab.
Table 5.17 Generation Parameters
2015-07
73
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
To delete a mapping entry, click the X-sign at the end of line. To delete the entire mapping
table, click the X-sign in the table header.
Tip
If a WirelessHART gateway is replaced with a new one, we recommend that you use the
export/import functionality to transfer the settings from the old WirelessHART gateway to the
new one. Otherwise, the new WirelessHART gateway rebuilds the WirelessHART network from
scratch by default, which means that the virtual HART I/O structure in the instrument list and
the MODBUS addresses of the devices will differ from the positions and addresses that have
been defined in the old WirelessHART gateway.
Furthermore, if using the DTM to configure the WirelessHART gateway, you can prepare the
instrument list and the MODBUS mapping tables offline and export the configuration into a
CSV file. Once the WirelessHART gateway is available on site, you can import the prepared
configuration via the CSV file.
2015-07
74
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Note!
The Instrument List must be available before you set up the topology view, because the set of
WirelessHART devices is derived from the Instrument List. See chapter 5.5.1
For a detailed overview of the relationship between the configuration options in the DTM or web
interface and the data in the WirelessHART gateway, see Figure 5.18 on page 60.
Caution!
System failure
If you click Refresh right after the device was switched on or reset, the system may stop
responding.
If the device was switched on or reset, wait about 1 minute until the boot process is complete
before you click Refresh.
75
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
5. If required, edit the coordinates of the image origin in the Horizontal image origin and
Vertical image origin boxes.
6. Enter a value in the Resolution box to scale the background image, for example 1 m/pixel.
Note that you can set the resolution only after you have uploaded an image.
7. Arrange the WirelessHART devices in the topology view by dragging and dropping the
devices to a selected position. Note that for a more accurate positioning you can use the
slider to zoom in or out of the topology view. To reset the zoom to its default value, click
Reset Zoom.
8. To write the current topology view to the WirelessHART gateway using the web interface,
click Apply. If using the DTM to configure the WirelessHART gateway, select the
WirelessHART gateway in the project tree and choose Device > Store to device.
To export the current devices and their positions to a CSV file, click Export (web interface)
resp. Export CSV (DTM).
To load a list of devices and their positions from a CSV file, click Import (web interface) resp.
Import CSV (DTM).
For more information on the structure of the CSV file, see chapter 12.
Reset Options
Parameter Description
Device Reset Restarts the software of the WirelessHART gateway without any impact on the
established network (which is not reformed).
This function does not set the parameters of the WirelessHART gateway back
to their default values. It restarts the WirelessHART gateway software only.
Rebuild Regenerates the instrument list from scratch.
Instrument The existing instrument list is overwritten. Note that the MODBUS addresses
List of the devices in the network will be changed by resetting the instrument list.
We recommend that you create a backup of the current instrument list before
rebuilding a new instrument list. See chapter 5.5.1
2015-07
76
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Parameter Description
Reform Restarts and re-establishes the network. For example, this function is needed
Network to activate a new network ID. See chapter 5.2.1
Depending on the size of the network, this process may take several minutes.
This function does not set the parameters of the WirelessHART gateway back
to their default values. It restarts the network only.
Reset Resets the HART parameters under Diagnostics > Wired Communication
Diagnostic > HART to its default values.
Bits
Table 5.18 Reset Options
Note!
The Long Tag parameterized in the Set DTM Address window must be identical with the
Long Tag of the same device parameterized in the Set device address window. See chapter
5.6.4
Otherwise the DTM is not able to establish a connection to the device.
77
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Note!
Additional functions > Set device address is available only online, while the connection to
the WirelessHART gateway and the WirelessHART device(s) is active.
Note!
The Long Tag parameterized in the Set Device Address window must be identical with the
Long Tag of the same device parameterized in the Set DTM address window. See chapter
5.6.3
Otherwise the DTM is not able to establish a connection to the device.
78
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
The connection to the web interface is made using a secure connection (HTTPS) which
requires a user name and a password. The factory default settings are:
User name: admin
Password: admin
You can change both user name and password in the web interface.
Changing the Password
1. Log on to the web interface of the WirelessHART gateway using the user name for which you
want to change the password.
2. Choose Additional Functions > Change Password.
3. Enter a new password into the corresponding fields.
4. To apply the new password, click Change Password. You can also abort the operation by
clicking Discard Operation.
The password for the current user has been changed.
5.6.8 Upload Certificate for HTTPS Connection
You can install a trusted certificate issued by a certification authority, such as TC TrustCenter,
Thawte, or VeriSign.
A digital certificate is an electronic document that binds a public key with an identity, for
example, an organization or an user. The binding between a public key and the identity is done
by a signature. This signature can be self-signed or authenticated by a certification authority.
The WirelessHART gateway is delivered with a self-signed certificate for the HTTPS
connection. Because the web browser cannot verify the authenticity of a self-signed certificate,
some web browsers display the following (or a similar) warning message in the address bar:
2015-07
79
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
Note!
This configuration option is only available in the web interface.
Note!
Prerequisites:
■ You need a certificate and a private key from a trusted authority, such as TC TrustCenter,
Thawte, or VeriSign.
■ Both files must comply with the following standard: X.509 Ver. 3
1. Click Browse and select the certificate file from the certification authority.
2. Click >> to upload the certificate.
The Upload Private Key option appears.
3. Click Browse and select the private key from the certification authority.
4. Click >> to upload the private key.
The Change Certificate and Private Key option appears.
5. Click >> to install the certificate and private key.
6. Go to Additional Functions > Device Reset and perform a device reset for the changes to
take effect.
If the trusted certificate has been installed successfully, the address bar in the web browser
displays a padlock icon:
This indicates that the web interface of the WirelessHART gateway is a trusted site.
2015-07
80
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
5.7 Measurement
The measurement list displays a comprehensive overview of all cached parameters and values
of all sub devices.
Note!
This list is stored in a non-volatile memory of the WirelessHART gateway. The card and
channel number assignment will remain the same after a restart of the WirelessHART gateway
or software.
Note!
Please keep in mind that the dynamic values of each sub device (analogue value, PV, SV, TV,
QV) are cached by the WirelessHART gateway only if the respective sub device publishes
those values. See chapter 2.1.4
After a network restart, the Operating Modes list needs time to rebuild. During this time, some
information is set to 0 or replaced by wildcard characters.
Caution!
System failure
If you click Refresh right after the device was switched on or reset, the system may stop
responding.
If the device was switched on or reset, wait about 1 minute until the boot process is complete
before you click Refresh.
Note!
If using the DTM and PACTware to configure the WirelessHART gateway, the following data is
available only during online parameterization.
2015-07
81
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via Web Interface
General Data
Displayed
Information Description
Long Tag Displays the long tag of the device.
HART 5 devices and older devices do not support long tags. For those
devices, the WirelessHART adapter uses the content of the Message field
which will be displayed here instead.
I/O Card Indicates the virtual I/O card number to which the device is mapped to. See
chapter 2.1.3
Channel Indicates the channel of the virtual I/O card that the device is mapped to. See
chapter 2.1.3
The value 0 identifies a WirelessHART device or a WirelessHART adapter,
while the value 1 identifies a wired device connected to a WirelessHART
adapter.
Device Type Displays the device type as registered at the HCF.
Status The following communication statuses exist:
communication not possible
communication possible, device not identified
(flashing) communication possible, identification ongoing
device connected and identified
Dev. Status Note that the device status displayed in the list may differ from the actual
device status because the HART status bits may be interpreted differently.
The following device statuses exist:
maintenance required
out of specification
check function
failure
Measured Values
Displayed
information Description
Loop Current Analogue value of the primary variable
PV Value of the primary variable
SV Value of the secondary variable
TV Value of the tertiary variable
QV Value of the quaternary variable
Table 5.19 Measured Values
2015-07
82
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DTM and PACTware
83
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DTM and PACTware
84
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DTM and PACTware
Note!
The HART Communication DTM is not included in the WirelessHART DTM Collection. It can be
downloaded separately from www.pepperl-fuchs.com.
4. To edit the parameters, right-click the HART communication DTM and select Properties.
5. Set the parameters according to the following table.
6. Click OK to save the changes and to close the parameter window.
Parameter Description Default
Communication Select HART multiplexer. HART
interface modem
Port Select the COM port of the RS-485 to RS-232 converter or COM1
of the RS-485 to USB converter.
Baudrate Select the baud rate of the WirelessHART gateway. 19200
RTS Control Depending on the RS-485 to RS-232 converter used, it Toggle
may be necessary to switch the request-to-send control on
or off, in order to switch correctly between reception and
transmitting mode.
Master Specify if you want the WirelessHART gateway to be the Primary
primary or the secondary master. If there is already a Master
primary master, define the WirelessHART gateway as
secondary master.
Preamble Select the number of preambles for HART communication. 5
Number of Select the number of retries for HART communication in 3
communication case of an error.
retries
Start address Select the address range in which the HART 0
Communication DTM searches for HART multiplexers.
End address 15
2015-07
85
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DTM and PACTware
Tip
After you have added the DTM for the WirelessHART gateway, you can easily add other
WirelessHART devices by performing a topology scan. To do so, right-click the WirelessHART
gateway and select Connect. When you have an active connection to the WirelessHART
gateway, right-click the WirelessHART gateway and select Topology Scan.
Note!
Data that is edited and stored on the device during online parameterization is not automatically
synchronized with the offline data in the PACTware project. If you change device parameters in
online mode, the data in PACTware differs from the data on the device. To make sure the data in
PACTware matches the data on the device after online parameterization, load the data from the
device into the PACTware project.
2015-07
86
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DTM and PACTware
Offline Parameterization
1. Right-click the device entry in the PACTware project.
2. Choose Parameter > Offline Parameterization.
The window containing the offline data record appears.
3. Modify a parameter by typing in a new value or choosing a new value from the drop-down
list.
4. To accept the new value, press Enter.
5. After all parameter changes have been made, save your project by choosing File > Save.
6. To write the new offline configuration to the device, right-click the device entry in the project
view and choose Connect.
A connection to the device is established.
7. Right-click the device entry again and choose Store to device.
The new configuration is stored in the device.
Online Parameterization
Note!
Some options are only available during online parameterization. These options are pointed out
in the relevant sections
87
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
7.1 Integration
The WirelessHART gateway is integrated into the Emerson AMS Suite by creating a new
wireless network that is established by the WirelessHART gateway.
Create New Wireless Network
1. Make sure the AMS Device Manager is not running.
2. Choose Start > Programs > AMS Device Manager > Network Configuration to start
Network Configuration.
The Network Configuration window appears.
3. Click Add.
2015-07
88
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
5. Click Next.
6. Enter a name for the network in the Network Name field and click Next.
2015-07
89
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
7. Enter the IP address of the WirelessHART gateway in the Smart Wireless Gateway Name
or IP Address field and click Add. The default IP address is 192.168.001.001. If you
changed the IP address of the WirelessHART gateway, type in the new IP address.
The IP address is displayed in the upper area under Wireless Network Parameters.
8. Click Finish to close the Add Wireless Network Wizard.
The name of the new wireless network is displayed in the Network Configuration
window.
9. Click Close to exit Network Configuration.
2015-07
90
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
7.2 Configuration
The Device Connection View is a graphical representation of the WirelessHART gateway and
the connected wireless and wired subdevices. From this view you can directly open the
configuration window for each device.
Display Network Participants
1. Start the AMS Device Manager as administrator. To do so, right-click the program icon and
select Run as administrator.
2. Log in to the AMS Device Manager using your user name, password, and the Standard
login type.
3. To establish a connection to your devices, choose View > Device Connection View.
The Device Connection View window displays the networks from the Network
Configuration window. In this example, Wireless Network 1 represents the
WirelessHART network that is established by the WirelessHART gateway.
91
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
4. Right-click the network that is created by the WirelessHART gateway and select Rebuild
and Identify Hierarchy.
The WirelessHART gateway is displayed underneath the network. Note that if the device
description has been installed, the WirelessHART gateway is displayed with a device-
specific icon. Otherwise the system uses a generic icon.
5. To view the wireless and wired subdevices of the WirelessHART gateway, click the + symbol
in front of the device icon.
The AMS Device Manager checks the HART loops and adds the field devices to the
network tree. Depending on the number of network participants and the network topology,
this process can take up to a few minutes.
Configure WirelessHART Gateway
Note!
Unless the device description has been installed, you can only configure basic options. The
device description adds device-specific options to the configuration window.
1. To open the configuration window, double-click the WirelessHART gateway in the Device
Connection View.
The configuration window of the selected device appears.
92
WHA-GW-F2D2-0-A*-Z2-ETH
Configuration via DD file and Emerson AMS Suite
2. If you change the value of a field, the background color of this field turns yellow. To apply the
changes, click Send.
The system displays a warning message, asking you to provide an update reason and to
confirm that you want to change the values.
93
WHA-GW-F2D2-0-A*-Z2-ETH
Operation
8 Operation
8.1 MODBUS and HART Status Information on Lost Connection
While you can easily retrieve the status information in the Measurement overview (see chapter
5.7), this chapter describes how to read the MODBUS and HART status information by means
of some examples.
The MODBUS mapping of the device with long tag BARCON looks as follows.
Excerpt from MODBUS Mapping Table
Register Endregister Long Tag IO-Card Channel Value
...
241 242 BARCON 11 1 Loop Current
243 244 BARCON 11 1 PV
245 246 BARCON 11 1 SV
247 248 BARCON 11 1 TV
249 250 BARCON 11 1 QV
251 251 BARCON 11 1 MODBUS Status
252 252 BARCON 11 1 Device Status
...
94
WHA-GW-F2D2-0-A*-Z2-ETH
Operation
The MODBUS readout of registers 30241 ... 30250 results ????? respectively NaN because
no field device is available and therefore no values are available.
Status Information
The MODBUS mapping of the device with long tag T209innen looks as follows.
Excerpt from MODBUS Mapping Table for T209innen
Register Endregister Long Tag IO-Card Channel Value
...
11 11 T209innen 1 0 MODBUS Status
12 12 T209innen 1 0 Device Status
...
95
WHA-GW-F2D2-0-A*-Z2-ETH
Operation
The HART status information in register 30012 returns 0000000000010000 that corresponds
to the hexadecimal value 0x10. This indicates that more status information is available via
command 48. See chapter 12.1
This information is also displayed in the Measurement window when hovering over the icon in
the Com. Status column.
The MODBUS mapping of the device with long tag 40000003410027 looks as follows.
Excerpt from MODBUS Mapping Table for 40000003410027
Register Endregister Long Tag IO-Card Channel Value
...
217 218 40000003410027 13 0 Loop Current
219 220 40000003410027 13 0 PV
221 222 40000003410027 13 0 SV
223 224 40000003410027 13 0 TV
225 226 40000003410027 13 0 QV
227 227 40000003410027 13 0 MODBUS Status
228 228 40000003410027 13 0 Device Status
...
The MODBUS readout of registers 30217 ... 30226 results ????? respectively NaN because
no field device is available and therefore no values are available.
96
WHA-GW-F2D2-0-A*-Z2-ETH
Operation
This information is also displayed in the Measurement window when hovering over the icon in
the Com. Status column.
Verify Connections
Check that each device has joined the network and is communicating properly. See chapter
5.4.2 Details
If you cannot establish a connection to a device, the device is probably too far away or an
obstacle blocks the radio waves. In this case, add an additional device to bridge the gap.
Eliminate Bottlenecks
If the messages of several devices all have to pass through one single device to get to the
WirelessHART gateway, the network has a bottleneck. If the device at the bottleneck fails,
whole parts of the network get cut off from communication because there are no alternative
paths to route messages.
To eliminate bottlenecks in a wireless network, add at least one device near the bottleneck to
provide redundant communication paths.
There should always be at least two communication paths from one device to another.
1. Bottleneck
2. WirelessHART gateway
3. Possible position of an additional WirelessHART device eliminating the bottleneck
2015-07
97
WHA-GW-F2D2-0-A*-Z2-ETH
Operation
2015-07
98
WHA-GW-F2D2-0-A*-Z2-ETH
Maintenance and Repair
99
WHA-GW-F2D2-0-A*-Z2-ETH
Troubleshooting
10 Troubleshooting
10.1 Faults Indicated by LEDs of the WirelessHART Gateway
Indication Possible cause Corrective action
Red LED is on Hardware fault that makes normal Try powering the WirelessHART
operation of the WirelessHART gateway down and up again. If the
gateway impossible. problem persists, please return the
WirelessHART gateway to
Pepperl+Fuchs for repair.
Red LED flashes Under certain conditions the LED If the problem persists, please
flashes while the WirelessHART contact Pepperl+Fuchs customer
gateway tries to eliminate the fault. service.
100
WHA-GW-F2D2-0-A*-Z2-ETH
Troubleshooting
101
WHA-GW-F2D2-0-A*-Z2-ETH
Technical Specifications
11 Technical Specifications
11.1 WHA-GW-F2D2-0-*-Z2-ETH
Supply
Rated voltage 20 ... 30 V DC SELV/PELV
Power consumption <5W
External bus
Connection screw terminals for
- 0.2 ... 4 mm2 (rigid wire)
- 0.2 ... 2.5 mm2 (flexible wire)
Interface 1 Ethernet
10 BASE-T/100 BASE-TX , full galvanic isolation
Protocol HART UDP, MODBUS TCP
Cable length max. 100 m , depending on cables and transfer rate
Connection UTP, STP or FTP
Interface 2 RS-485
Protocol HART, MODBUS RTU
Daisy-chain capability supported by duplicated connection terminals
Transfer rate max. 115 kBit/s
Cable length max. 1200 m , depending on cables and transfer rate
Bus termination integrated termination resistor , adjustable via DIP switch and
software
Input
Number of channels 250
Interface omnidirectional dipole antenna, removable
Communication WirelessHART specifications
- physical layer: IEEE 802.15.4.2006
- frequency band: 2.4 GHz (ISM band, licence free)
- transmission rate: 250 kBit/s
- max. transmit power: +10 dBm (EIRP)
- transmission range: outdoor 250 m, indoor 50 m (under
reference conditions)
- communication standard: WirelessHART
Electrical isolation
Interface/power supply basic insulation according to IEC 61140, rated insulation
voltage 50 Veff
Interface/interface basic insulation according to IEC 61140, rated insulation
voltage 50 Veff
Indicators/settings
Display elements LED PWR (power supply status), one green LED
LED COM (communication status), three yellow LEDs
LED FLT (fault signal), one green LED
Control elements 2 push buttons:
- restore HART configuration
- restore communication configuration
DIP switches:
- baud rate
- RS-485 address
- RS-485 termination
2015-07
- security mode
102
WHA-GW-F2D2-0-A*-Z2-ETH
Technical Specifications
Directive conformity
Electromagnetic compatibility
Directive 2004/108/EC EN 61326-1:2006
Radio and The usage of 2.4 GHz equipment is bound to local restrictions.
telecommunication terminal Ensure that restrictions allow usage of this product before
equipment commisioning.
Directive 99/5/EC EN 300328: V1.7.1
EN 301489-17: V1.3.2
FCC CFR47 Part 15 B and ANSI C63.4-2003
C
Conformity
Degree of protection IEC 60529
Shock resistance EN 60068-2-27
Vibration resistance EN 60068-2-6
Ambient conditions
Ambient temperature -20 ... 60 °C (-4 ... 140 °F)
Storage temperature -40 ... 85 °C (-40 ... 185 °F)
Relative humidity 5 ... 95 %, noncondensing
Corrosion resistance acc. to ISA-S71.04-1985, severity level G3
test setup and execution acc. to EN 60068-2-60
Mechanical specifications
Degree of protection IP66/IP67
Mass approx. 1 kg
Dimensions 258 mm x 114 mm x 84 mm
without antenna and cable glands
Mounting panel mounting
Data for application in connection with Ex-areas
EC-Type Examination FM 12 ATEX 0061 , for additional certificates see
Certificate www.pepperl-fuchs.com
Group, category, type of II 3 G Ex nA nC IIC T4 Gc
protection, temperature class
Directive conformity
Directive 94/9/EC EN 60079-0:2012
EN 60079-15:2010
General information
Supplementary information EC-Type Examination Certificate, Statement of Conformity,
Declaration of Conformity, Attestation of Conformity and
instructions have to be observed where applicable. For
information see www.pepperl-fuchs.com.
2015-07
103
WHA-GW-F2D2-0-A*-Z2-ETH
Technical Specifications
Country Guideline
Bulgaria General authorization required for outdoor use
and public service.
Italy If used outside of own premises, general
authorization is required.
Japan The device is granted pursuant to the
Japanese Radio Law and the Japanese
Telecommunications Business Law.
The device must not be modified (otherwise
the granted designation number will become
invalid).
Latvia The outdoor usage of the 2.4 GHz band
requires an authorization from the Electronic
Communications Office.
Norway May be restricted in the geographical area
within a radius of 20 km from the center of Ny-
Alesund.
Rumania Use on a secondary basis. Individual license
required.
2015-07
104
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
12 Appendix
12.1 HART Status Information
HART Device Status
The HART device status or field device status indicates the current operating status of the field
device.
105
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
Command 48
Command 48 returns additional status information that is not included in the HART device
status response code.
All field devices must support at least bytes 0 ... 8. Thus, the minimum response length of
command 48 is 9 bytes. If a field device supports more than one analog channel, bytes 9 ... 13
must be supported as well. In this case, the minimum response length of command 48 is 14
bytes.
Response Data Bytes
Byte Parameter Description
0 Device-Specific ■ 0x01 Manager Fault
Status 0
Extended Device ■ 0x02 Non-Volatile Memory Defect
Malfunction ■ 0x04 Volatile Memory Defect
106
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
107
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
Example!
The value this is a "long tag" that contains quote signs must be entered like this:
"this is a ""long tag"" that contains quote signs"
Avoid special characters. They can easily be corrupted or they can cause the whole data row to
be skipped during the import of the CSV file.
Avoid leading blanks, trailing blanks, and tabs, especially for integer or hexadecimal values.
Respect the data type of each column.
If a mandatory column is missing, the whole file is rejected and nothing is imported.
If a mandatory value is missing, the corresponding data row is skipped.
MODBUS Mapping
The files for the MODBUS mapping contain the following columns.
File Structure
Expande
d Device
Type Register Informati Mapping
Code Device Id IO-Card Channel Long Tag Register Type on Code Code
4 digits 6 digits int int string[32] int int int int
hex hex decimal decimal decimal decimal decimal decimal
mandato mandato mandato mandato mandato
ry ry ry ry ry
InformationCode Codes
Value Description
0 HART Status (RegisterType Code = 3)
1 CMD 48 Status (RegisterType Code = 3)
2 Device Variables (RegisterType Code = 3)
3 MODBUS Status (RegisterType Code = 3)
4 Discrete Variables (RegisterType Code = 3)
108
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
MappingCode Codes
Information Code Value Description
0 (HART Status) 0 Device Status
1 Extended Device Status
2 Device Status & Extended Device Status
1 (CMD 48 Status) 0 ... 12 CMD 48 status word to be mapped
0 maps CMD 48 bytes 0&1
1 maps CMD 48 bytes 2&3 and so on
Note: 12 maps CMD 48 byte 24 only
2 (Device Variable) 0 ... 242 Device Variables
For more information on what device-specific
information is available and on the device-
specific unit codes, see the manual of the sub-
device.
243 Battery Life
244 Percent Range
245 Loop Current
246 Primary Variable
247 Secondary Variable
248 Tertiary Variable
249 Quaternary Variable
255 Slot 0 data time stamp
3 (MODBUS Status) 0 "Mod Stat" information
4 (Discrete Variable - LSB) 0 ... 255 Discrete Variable Index
The less significant byte of the variable is
mapped.
5 (Discrete Variable - MSB) 0 ... 255 Discrete Variable Index
The most significant byte of the variable is
mapped.
6 (Network Statistic) 0 Reliability
1 Stability
2 Latency
3 Lost Upstream Packets
LSB: least significant byte
MSB: most significant byte
Instrument List
The files for the instrument list contain the following columns.
File Structure
Expanded Device
Type Code Device Id IO-Card Channel Long Tag
4 digits hex 6 digits hex int decimal int decimal string[32]
mandatory
Topology View
The files for the topology view contain the following columns.
Note that the X- and Y-origins of the background image are not part of the CSV file, as these
2015-07
109
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
File Structure
Expanded Device Type Code
X-Coordinate
Z-Coordinate
Y-Coordinate
Units Code
Device Id
Long Tag
Channel
IO-Card
Range
4 digits 6 digits int int string[32] int float float float float
hex hex decimal decimal decimal decimal decimal decimal decimal
mandator mandator mandator
y y y
Diagnostic Details
The files you can export under Diagnostics > Wireless Communication > Details contain
the following columns. There are no mandatory columns as there is no import function.
Nevertheless, you can export the data in CSV format for documentation.
File Structure
Expanded Device Type Code
Neighbors
Reliability
Device Id
Long Tag
Channel
IO-Card
Latency
Stability
Status
RSSI
4 6 int int string 2 2 int yyyy: float float string int float
digits digits decim decim [32] digits digits decim mm: [32] decim
hex hex al al hex hex al dd al
hh:m
m:ss
2015-07
110
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
Note!
Unlike a HART multiplexer the WirelessHART gateway only accepts commands directly
addressed to its HART slave address.
111
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
112
WHA-GW-F2D2-0-A*-Z2-ETH
Appendix
113
PROCESS AUTOMATION –
PROTECTING YOUR PROCESS
Worldwide Headquarters
Pepperl+Fuchs GmbH
68307 Mannheim · Germany
Tel. +49 621 776-0
E-mail: [email protected]
www.pepperl-fuchs.com
Subject to modifications
Copyright PEPPERL+FUCHS • Printed in Germany / TDOCT-1898HENG
07/2015