eDrive  Help & Support Center

Search:
Contents
Display Legacy Contents

IndexBookmarkPrint
Home > Technical Reference > Device Specific Configuration > Siemens Apogee Devices and Points
Siemens Apogee Devices and Points

Siemens Apogee Device Configuration Parameters:

eDrive is capable of communication with Siemens Apogee devices through connection to an available MMI port on the controller.
Since the MMI port use RS-232 ASCII protocol, eDrive can only communicate with them by tunneling the request messages over an ethernet IP network.  Request messages are sent by eDrive over the IP network to a serial server device which routes them to the MMI port.  When the Siemens device replies to the request, the serial server routes it back toeDrive over the IP network.

Device Name Enter a descriptive name that eDrive will use to reference this device.  Spaces and punctuation characters are allowed.

Device Type From the drop down list, select the option: Siemens.

Polling Timeout From the drop down list, select the value (in seconds) that will determine how long eDrive will wait for responses from this device before declaring a timeout event and moving on to its next task.

The intent of the timeout period is to allow enough time for the device to fully respond to requests from eDrive, but also allow eDrive to move on to other tasks if the device is offline and not able to respond.

IP Address Enter the IP Address of the serial server device connected to the Siemens MMI port.  

Port Enter the IP Port Number of the serial server device assigned to the RS-232 port.

User Name Enter the Siemens Apogee user name that will be used when eDrive accesses data through a session on the MMI port.  

Password Enter the user password that associated with the User Name property above.

Target Interval Enter the value (in seconds) that represents how often this device needs to poll all of its Point Objects.  eDrive will distribute its polling activities over the Target Interval and attempt to complete the polling for all of its Point Objects within the Target Interval if possible.

Example:  All selected points for this device only need to be updated once every 2 minutes.  Set the Target Interval to 120 seconds.

When practical, use a longer value of Target Interval to spread out the polling activities and minimize impact on network bandwidth. 

Pacing User sessions through a Siemens MMI port are limited to one request/response at a time.  Therefore eDrive limits its operation to single-threaded requests.

Pacing represents the number of seconds that eDrive will pause between consecutive point requests for this device.  The default value is 1 second.  Setting this value to a greater number will decrease the bandwidth used by eDrive on the Siemens system, but will also increase the time it takes to poll all the points configured for this device.


Siemens Apogee Point Object Configuration Parameters:

Wildcard Group   eDrive will poll for Siemens point values either individually or in groups based on a group of points that will be returned by using a Wildcard Group designation.

If Wildcard Group field is left blank, the point will be polled individually by Name.

If Wildcard Group is present, it should be formatted with wildcard characters so as to return all the points matching it's pattern.  Example:  TEC01:DAY* (where the asterisk character implies the wildcard) will return values for several objects:
  - TEC01:DAY CLG STPT
  - TEC01:DAY HTG STPT
  - TEC01:DAY.NGT
Name Enter a descriptive name that eDrive will use to reference this Point Object.  Spaces and punctuation characters are allowed.

If '/' (forward slash) characters are included in the name, eDrive will create the Point Object in a hierarchical, tree structure with the '/' characters as delimiters.  The tree structure will appear in the list of eDrive objects along the right hand side of the page.

 Address The name of the Siemens point object as it will appear in the response from the Siemens MMI port.
 Value Modification Point value responses from Siemens Apogee systems will often contain string values instead of numeric valules.  eDrive can store these string values as-is or can easily convert them to multi-value numerics by selecting an entry from the Value Modification drop-down list.

For example, to convert the Siemens point values of 
"Stop, Slow, Fast" to corresponding numeric values of 0, 1, 2
select the "Stop, Slow, Fast" option from the drop-down list.

If the drop-down list does not contain the string value combination that you need, you may enter your own list of values.  The string values you enter must be separated by commas and exactly match the values that will be returned from the Siemens system for that point.  eDrive will then set values of 0, 1, 2, etc. for this point that correspond to the string values in your list.

Note!  You can assign Additional Properties to any Point Object such as Offset, scaling MultiplierHistory, etc.  Please refer to the Additional Point Properties section for more detail.

When Device and/or Point Object configuration is complete, select the Submit Config function to save your changes to eDrive.



Next: Calculated Points Configuration