|
fwConfigs
|
Functions | |
| fwPeriphAddress_changeOpcGroups (dyn_string dpes, string newGroupName, dyn_string &exceptionInfo) | |
| fwPeriphAddress_checkAreDriversRunning (dyn_int driverNumbers, dyn_bool &areRunning, dyn_string &exceptionInfo, string systemName="LOCAL") | |
| fwPeriphAddress_checkIsDriverRunning (int driverNumber, bool &isRunning, dyn_string &exceptionInfo, string systemName="LOCAL") | |
| fwPeriphAddress_checkModbusParameters (dyn_string dsParameters, dyn_string &exceptionInfo) | |
| fwPeriphAddress_createPvssInternalDpsForDriver (unsigned driverNumber, dyn_string &exceptionInfo) | |
| fwPeriphAddress_delete (string dpe, dyn_string &exceptionInfo) | |
| fwPeriphAddress_deleteMultiple (dyn_string dpes, dyn_string &exceptionInfo) | |
| fwPeriphAddress_get (string dpe, bool &configExists, dyn_anytype &config, bool &isActive, dyn_string &exceptionInfo) | |
| Get the address config of a datapoint element. More... | |
| fwPeriphAddress_getDataType (int &dataType, string dpe, string addressType) | |
| fwPeriphAddress_getMany (dyn_string &dpes, dyn_bool &configExists, dyn_dyn_anytype &config, dyn_bool &isActive, dyn_string &exceptionInfo) | |
| Get the address config of a datapoint element. More... | |
| fwPeriphAddress_getUnicosAddressReference (dyn_string dsParameters, string &addressReference) | |
| fwPeriphAddress_readSettings (string referencePanel, dyn_string &addressParam, dyn_string &exceptionInfo) | |
| fwPeriphAddress_set (string dpe, dyn_anytype configParameters, dyn_string &exceptionInfo, bool runDriverCheck=FALSE) | |
| Set the address config for a given data point element. More... | |
| fwPeriphAddress_setMany (dyn_string &dpes, dyn_dyn_anytype &configParameters, dyn_string &exceptionInfo, bool runDriverCheck=FALSE) | |
| Sets the address config for a given set of data point elements. More... | |
| fwPeriphAddress_setModbus (string dpe, dyn_string dsParameters, dyn_string &exceptionInfo) | |
| fwPeriphAddress_setOPC (string dpe, string opcServerName, int driverNum, string OPCItemName, string OPCGroup, int datatype, int mode, unsigned subindex, dyn_string &exceptionInfo) | |
| fwPeriphAddress_setOPCUA (string dpe, string opcServerName, int driverNum, string opcItemName, string opcSubscription, string opcKind, string opcVariant, int datatype, int mode, string pollGroup, dyn_string &exceptionInfo) | |
Variables | |
| const unsigned | FW_PARAMETER_FIELD_ACTIVE = 6 |
| Is address active. | |
| const unsigned | FW_PARAMETER_FIELD_ADDRESS = 3 |
| Address reference. | |
| const unsigned | FW_PARAMETER_FIELD_COMMUNICATION = 1 |
| Type of communication. ex : "MODBUS". | |
| const unsigned | FW_PARAMETER_FIELD_DATATYPE = 5 |
| Type of data (see constants below) | |
| const unsigned | FW_PARAMETER_FIELD_DRIVER = 2 |
| Driver number. | |
| const unsigned | FW_PARAMETER_FIELD_INTERVAL = 14 |
| Interval time. | |
| const unsigned | FW_PARAMETER_FIELD_LOWLEVEL = 11 |
| Is low level config used. | |
| const unsigned | FW_PARAMETER_FIELD_MODE = 4 |
| Mode. | |
| const unsigned | FW_PARAMETER_FIELD_NUMBER = 15 |
| Number of parameters. | |
| const unsigned | FW_PARAMETER_FIELD_START = 13 |
| Starting time. | |
| const unsigned | FW_PARAMETER_FIELD_SUBINDEX = 12 |
| Address subindex. | |
| const unsigned | fwPeriphAddress_ACTIVE = 6 |
| const unsigned | fwPeriphAddress_DATATYPE = 5 |
| const unsigned | fwPeriphAddress_DIM_CONFIG_DP = 11 |
| const unsigned | fwPeriphAddress_DIM_DEFAULT_VALUE = 12 |
| const unsigned | fwPeriphAddress_DIM_DRIVER_NUMBER = 1 |
| const unsigned | fwPeriphAddress_DIM_FLAG = 14 |
| const unsigned | fwPeriphAddress_DIM_IMMEDIATE_UPDATE = 15 |
| const unsigned | fwPeriphAddress_DIM_OBJECT_SIZE = 15 |
| const unsigned | fwPeriphAddress_DIM_TIMEOUT = 13 |
| const unsigned | fwPeriphAddress_DIP_BUFFER_TIME = 12 |
| const unsigned | fwPeriphAddress_DIP_CONFIG_DP = 11 |
| const unsigned | fwPeriphAddress_DIRECTION = 4 |
| const unsigned | fwPeriphAddress_DRIVER_NUMBER = 2 |
| const unsigned | fwPeriphAddress_MODBUS_INTERVAL = 14 |
| const unsigned | fwPeriphAddress_MODBUS_LOWLEVEL = 11 |
| const unsigned | fwPeriphAddress_MODBUS_OBJECT_SIZE = 15 |
| const unsigned | fwPeriphAddress_MODBUS_POLL_GROUP = 15 |
| const unsigned | fwPeriphAddress_MODBUS_START = 13 |
| const unsigned | fwPeriphAddress_MODBUS_SUBINDEX = 12 |
| const unsigned | fwPeriphAddress_OPC_GROUP_IN = 14 |
| const unsigned | fwPeriphAddress_OPC_GROUP_OUT = 15 |
| const unsigned | fwPeriphAddress_OPC_LOWLEVEL = 11 |
| const unsigned | fwPeriphAddress_OPC_OBJECT_SIZE = 15 |
| const unsigned | fwPeriphAddress_OPC_SERVER_NAME = 13 |
| const unsigned | fwPeriphAddress_OPC_SUBINDEX = 12 |
| const unsigned | fwPeriphAddress_OPCUA_KIND = 14 |
| Kind (1=Value; 2=Event; 3=Alarm) | |
| const unsigned | fwPeriphAddress_OPCUA_LOWLEVEL = 11 |
| Low level comparison. | |
| const unsigned | fwPeriphAddress_OPCUA_OBJECT_SIZE = 16 |
| const unsigned | fwPeriphAddress_OPCUA_POLL_GROUP = 16 |
| Polling group name. | |
| const unsigned | fwPeriphAddress_OPCUA_SERVER_NAME = 12 |
| OPC UA Server name. | |
| const unsigned | fwPeriphAddress_OPCUA_SUBSCRIPTION = 13 |
| Subscription name. | |
| const unsigned | fwPeriphAddress_OPCUA_VARIANT = 15 |
| Variant (1=Node ID; 2=Browse Path) | |
| const unsigned | fwPeriphAddress_REFERENCE = 3 |
| const unsigned | fwPeriphAddress_ROOT_NAME = 3 |
| const unsigned | fwPeriphAddress_TYPE = 1 |
| const string | fwPeriphAddress_TYPE_DIM = "DIM" |
| const string | fwPeriphAddress_TYPE_DIMCLIENT = "DIMCLIENT" |
| const string | fwPeriphAddress_TYPE_DIMSERVER = "DIMSERVER" |
| const string | fwPeriphAddress_TYPE_DIP = "DIP" |
| const string | fwPeriphAddress_TYPE_MODBUS = "MODBUS" |
| const string | fwPeriphAddress_TYPE_NONE = "None" |
| const string | fwPeriphAddress_TYPE_OPC = "OPC" |
| const string | fwPeriphAddress_TYPE_OPCCLIENT = "OPCCLIENT" |
| const string | fwPeriphAddress_TYPE_OPCSERVER = "OPCSERVER" |
| const string | fwPeriphAddress_TYPE_OPCUA = "OPCUA" |
| const string | fwPeriphAddress_TYPE_OPCUACLIENT = "OPCUA" |
| const int | PVSS_ADDRESS_LOWLEVEL_TO_MODE = 64 |
| const int | PVSS_MODBUS_BOOL = 567 |
| const int | PVSS_MODBUS_FLOAT = 566 |
| const int | PVSS_MODBUS_INT16 = 561 |
| const int | PVSS_MODBUS_INT32 = 562 |
| const int | PVSS_MODBUS_UINT16 = 563 |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_ADDRESS = 5 |
| Address in PLC. | |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_EVENT = 4 |
| Is event. | |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_MODE = 1 |
| Mode. | |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_NUMBER = 5 |
| Number of parameters. | |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_PLCNUMBER = 3 |
| PLC number. | |
| const unsigned | UN_ADDRESS_PARAMETER_FIELD_PLCTYPE = 2 |
| PLC type ie "QUANTUM" or "PREMIUM". | |
| const char | UN_PREMIUM_INPUT_LETTER_EVENT = "U" |
| const char | UN_PREMIUM_INPUT_LETTER_MISC = "U" |
| const int | UN_PREMIUM_INPUT_NB_EVENT = 18 |
| const int | UN_PREMIUM_INPUT_NB_MISC = 1 |
| const char | UN_PREMIUM_QUANTUM_OUTPUT_LETTER_ALL = "M" |
| const int | UN_PREMIUM_QUANTUM_OUTPUT_NB_ALL = 16 |
| const char | UN_QUANTUM_INPUT_LETTER_EVENT = "U" |
| const char | UN_QUANTUM_INPUT_LETTER_MISC = "M" |
| const int | UN_QUANTUM_INPUT_NB_EVENT = 18 |
| const int | UN_QUANTUM_INPUT_NB_MISC = 16 |
This library contains function associated with the address config. Functions are provided for getting the current settings, deleting the config and setting the config
15/01/2013 Marco Boccioli
12/08/2011 Marco Boccioli
12/08/2011 Marco Boccioli
27/04/2010 Frederic Bernard (EN-ICE) update Exception management in fwPeriphAddress_setModbus()
15/01/2004 Oliver Holme (IT-CO) Modified library to match functionality of other config libs
| fwPeriphAddress_changeOpcGroups | ( | dyn_string | dpes, |
| string | newGroupName, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Changes the OPC group in the address config for the given list of dpes
| dpes | The list of dpes to act on |
| newGroupName | The new OPC server group name |
| exceptionInfo | Details of any exceptions are returned here |
References _fwConfigs_getConfigTypeAttribute(), and _fwConfigs_setConfigTypeAttribute().
| fwPeriphAddress_checkAreDriversRunning | ( | dyn_int | driverNumbers, |
| dyn_bool & | areRunning, | ||
| dyn_string & | exceptionInfo, | ||
| string | systemName = "LOCAL" |
||
| ) |
Checks to see if a given list of driver managers are running or not
| driverNumbers | the numbers of the drivers to check |
| areRunning | A list of the driver states is returned here - TRUE if manager is running, else FALSE |
| exceptionInfo | if the driver is not running, an exception is returned |
| systemName | OPTIONAL PARAMETER: System name on which to check if the drivers are running (e.g. dist_1:). If not passed, the local system is checked. |
Referenced by _fwConfigs_checkAreConfigsAccessible(), and fwPeriphAddress_checkIsDriverRunning().
| fwPeriphAddress_checkIsDriverRunning | ( | int | driverNumber, |
| bool & | isRunning, | ||
| dyn_string & | exceptionInfo, | ||
| string | systemName = "LOCAL" |
||
| ) |
Checks to see if a given driver manager is running or not
| driverNumber | the number of the driver to check |
| isRunning | Driver state is returned here - TRUE if manager is running, else FALSE |
| exceptionInfo | if the driver is not running, an exception is returned |
| systemName | OPTIONAL PARAMETER: System name on which to check if the driver is running (e.g. dist_1:). If not passed, the local system is checked. |
References fwPeriphAddress_checkAreDriversRunning().
Referenced by fwPeriphAddress_get(), fwPeriphAddress_getMany(), and fwPeriphAddress_set().
| fwPeriphAddress_checkModbusParameters | ( | dyn_string | dsParameters, |
| dyn_string & | exceptionInfo | ||
| ) |
Check if data is Ok to set a MODBUS address
| dsParameters | parameters used to set the _address config (see constants definition) |
| exceptionInfo | for any error. If a parameter is incorrect, exceptionInfo is not empty ! |
References FW_PARAMETER_FIELD_ACTIVE, FW_PARAMETER_FIELD_ADDRESS, FW_PARAMETER_FIELD_COMMUNICATION, FW_PARAMETER_FIELD_DATATYPE, FW_PARAMETER_FIELD_DRIVER, FW_PARAMETER_FIELD_INTERVAL, FW_PARAMETER_FIELD_LOWLEVEL, FW_PARAMETER_FIELD_MODE, FW_PARAMETER_FIELD_NUMBER, and FW_PARAMETER_FIELD_SUBINDEX.
| fwPeriphAddress_createPvssInternalDpsForDriver | ( | unsigned | driverNumber, |
| dyn_string & | exceptionInfo | ||
| ) |
Creates the necessary PVSS internal data for a given driver number. These are "_DriverX" and "_Stat_Configs_driver_X" where X is the driver number.
| driverNumber | The driver number for which you wish to create the internal PVSS dps |
| exceptionInfo | Details of any exceptions are returned here |
| fwPeriphAddress_delete | ( | string | dpe, |
| dyn_string & | exceptionInfo | ||
| ) |
Deletes the address config of the given dp element
| dpe | data point element |
| exceptionInfo | details of any errors are returned here |
References fwPeriphAddress_get().
Referenced by fwPeriphAddress_deleteMultiple().
| fwPeriphAddress_deleteMultiple | ( | dyn_string | dpes, |
| dyn_string & | exceptionInfo | ||
| ) |
Deletes the address config of the given dp elements
| dpes | list of data point elements |
| exceptionInfo | details of any errors are returned here |
References fwPeriphAddress_delete().
| fwPeriphAddress_get | ( | string | dpe, |
| bool & | configExists, | ||
| dyn_anytype & | config, | ||
| bool & | isActive, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Get the address config of a datapoint element.
The function checks that the relevant driver is running. If not it returns an exception saying the config could not be read.
Example: get the address of a dpe
| dpe | datapoint element to read from |
| configExists | TRUE if address config exists, else FALSE |
| config | Address object is returned here: configParameters[fwPeriphAddress_TYPE] contains type of addressing: fwPeriphAddress_TYPE_OPCCLIENT fwPeriphAddress_TYPE_OPCUACLIENT fwPeriphAddress_TYPE_DIMCLIENT fwPeriphAddress_TYPE_DIP fwPeriphAddress_TYPE_MODBUS fwPeriphAddress_TYPE_S7 or fwPeriphAddress_TYPE_CMW configParameters[fwPeriphAddress_DRIVER_NUMBER] contains driver number configParameters[fwPeriphAddress_ROOT_NAME] contains address string configParameters[fwPeriphAddress_DIRECTION] contains direction of address for dpe: DPATTR_ADDR_MODE_OUTPUT_SINGLE DPATTR_ADDR_MODE_INPUT_SPONT or 6 for in/out (no PVSS constant available yet) configParameters[fwPeriphAddress_DATATYPE] contains the translation datatype configParameters[fwPeriphAddress_ACTIVE] contains whether or not the address is active Note: This active parameter is ignored if using DIM (always active) MODBUS Specific entries in address object: configParameters[fwPeriphAddress_MODBUS_LOWLEVEL] configParameters[fwPeriphAddress_MODBUS_SUBINDEX] configParameters[fwPeriphAddress_MODBUS_START] configParameters[fwPeriphAddress_MODBUS_INTERVAL] OPC Specific entries in address object: configParameters[fwPeriphAddress_OPC_LOWLEVEL] contains is lowlevel comparison is enabled (output only) configParameters[fwPeriphAddress_OPC_SUBINDEX] contains subindex if datatype = 'bitstring' configParameters[fwPeriphAddress_OPC_SERVER_NAME] contains OPC server name configParameters[fwPeriphAddress_OPC_GROUP_IN] contains OPC group for input address configs only configParameters[fwPeriphAddress_OPC_GROUP_OUT] contains OPC group for output address configs only OPC UA Specific entries in address object: configParameters[fwPeriphAddress_OPCUA_LOWLEVEL] contains is lowlevel comparison is enabled (output only) configParameters[fwPeriphAddress_OPCUA_SERVER_NAME] contains OPC server name configParameters[fwPeriphAddress_OPCUA_SUBSCRIPTION] contains OPC UA subscription name configParameters[fwPeriphAddress_OPCUA_KIND] contains OPC UA kind configParameters[fwPeriphAddress_OPCUA_VARIANT] contains OPC UA variant configParameters[fwPeriphAddress_OPCUA_POLL_GROUP] contains polling group name (including system name). Compulsory in case no subscription is specified DIM Client Service Specific entries in address object: configParameters[fwPeriphAddress_DIM_CONFIG_DP] the DIM config data point to which the config is saved configParameters[fwPeriphAddress_DIM_DEFAULT_VALUE] default value setting configParameters[fwPeriphAddress_DIM_TIMEOUT] timeout setting configParameters[fwPeriphAddress_DIM_FLAG] flag setting configParameters[fwPeriphAddress_DIM_IMMEDIATE_UPDATE] immediate update setting DIP Client Specific entries in address object: configParameters[fwPeriphAddress_DIP_CONFIG_DP] the DIP config data point to which the config is saved S7 Specific entries in address object: configParameters[fwPeriphAddress_S7_LOWLEVEL] configParameters[fwPeriphAddress_S7_SUBINDEX] configParameters[fwPeriphAddress_S7_START] configParameters[fwPeriphAddress_S7_INTERVAL] configParameters[fwPeriphAddress_S7_POLL_GROUP] |
| isActive | TRUE is address config is active, else FALSE |
| exceptionInfo | details of any errors are returned here |
References _fwConfigs_getSystemsInDpeList(), fwPeriphAddress_checkIsDriverRunning(), fwPeriphAddress_OPCUA_KIND, fwPeriphAddress_OPCUA_POLL_GROUP, fwPeriphAddress_OPCUA_SERVER_NAME, fwPeriphAddress_OPCUA_SUBSCRIPTION, and fwPeriphAddress_OPCUA_VARIANT.
Referenced by _fwPeriphAddressCMW_initPanel(), _fwPeriphAddressS7_initPanel(), and fwPeriphAddress_delete().
| fwPeriphAddress_getDataType | ( | int & | dataType, |
| string | dpe, | ||
| string | addressType | ||
| ) |
Checks the type of a data point element and returns the integer used to represent this data type
depending on the required type of peripheral address.
NOTE: this function is mostly redundant now as OPC supports the default data transformation now.
The results for address type DIM are also redundant now.
| dataType | The integer representing the data type is returned here (returns -1 if dpe type is unsupported) |
| dpe | The data point element to check |
| addressType | The type of peripheral address (DIM or OPC) |
| fwPeriphAddress_getMany | ( | dyn_string & | dpes, |
| dyn_bool & | configExists, | ||
| dyn_dyn_anytype & | config, | ||
| dyn_bool & | isActive, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Get the address config of a datapoint element.
The function checks that the relevant driver is running. If not it returns an exception saying the config could not be read.
| dpes | datapoint element to read from. Passed as reference for performance reasons. Not modified. |
| configExists | TRUE if address config exists, else FALSE |
| config | address object is returned here. See fwPeriphAddress_get() for details on the addess object. |
| isActive | TRUE is address config is active, else FALSE |
| exceptionInfo | details of any errors are returned here |
References _fwConfigs_getSystemsInDpeList(), fwPeriphAddress_checkIsDriverRunning(), fwPeriphAddress_OPCUA_KIND, fwPeriphAddress_OPCUA_LOWLEVEL, fwPeriphAddress_OPCUA_POLL_GROUP, fwPeriphAddress_OPCUA_SERVER_NAME, fwPeriphAddress_OPCUA_SUBSCRIPTION, and fwPeriphAddress_OPCUA_VARIANT.
| fwPeriphAddress_getUnicosAddressReference | ( | dyn_string | dsParameters, |
| string & | addressReference | ||
| ) |
Get formatted address for Unicos using given parameters
| dsParameters | parameters used to build the address reference (see constants definition) |
| addressReference | address reference (empty string in case of error) |
References UN_ADDRESS_PARAMETER_FIELD_ADDRESS, UN_ADDRESS_PARAMETER_FIELD_EVENT, UN_ADDRESS_PARAMETER_FIELD_MODE, UN_ADDRESS_PARAMETER_FIELD_NUMBER, UN_ADDRESS_PARAMETER_FIELD_PLCNUMBER, and UN_ADDRESS_PARAMETER_FIELD_PLCTYPE.
| fwPeriphAddress_readSettings | ( | string | referencePanel, |
| dyn_string & | addressParam, | ||
| dyn_string & | exceptionInfo | ||
| ) |
This function is used to read the address configuration parameters that can be entered in the panels fwPeriphAddressDIM.pnl and fwPeriphAddressOPC.pnl. It can be extended to support other address formats.
| referencePanel | the name of the reference panel to read from |
| addressParam | the address parameterization that was entered in the panel |
| exceptionInfo | details of any exceptions are returned here |
| fwPeriphAddress_set | ( | string | dpe, |
| dyn_anytype | configParameters, | ||
| dyn_string & | exceptionInfo, | ||
| bool | runDriverCheck = FALSE |
||
| ) |
Set the address config for a given data point element.
Example: S7.
It connects the dpe sys_1:testPerAddr.input to the element DB81.DBD0F. The PLC connection is defined on Test_PLC.
Example: OPC UA.
It connects the dpe sys_1:testPerAddr.input to the element OPCUAConnection1$subscription2$1$1$item1. The OPC UA Client connection is defined on OPCUAConnection1.
| dpe | datapoint element to act on |
| configParameters | Address object is passed here: configParameters[fwPeriphAddress_TYPE] contains type of addressing: fwPeriphAddress_TYPE_OPCCLIENT fwPeriphAddress_TYPE_OPCUACLIENT fwPeriphAddress_TYPE_DIMCLIENT fwPeriphAddress_TYPE_DIP fwPeriphAddress_TYPE_MODBUS fwPeriphAddress_TYPE_S7 or fwPeriphAddress_TYPE_CMW configParameters[fwPeriphAddress_DRIVER_NUMBER] contains driver number configParameters[fwPeriphAddress_ROOT_NAME] contains address string configParameters[fwPeriphAddress_DIRECTION] contains direction of address for dpe: DPATTR_ADDR_MODE_OUTPUT_SINGLE DPATTR_ADDR_MODE_INPUT_SPONT or 6 for in/out (no PVSS constant available yet) configParameters[fwPeriphAddress_DATATYPE] contains the translation datatype configParameters[fwPeriphAddress_ACTIVE] contains whether or not the address is active Note: This active parameter is ignored if using DIM (always active) MODBUS Specific entries in address object: configParameters[fwPeriphAddress_MODBUS_LOWLEVEL] configParameters[fwPeriphAddress_MODBUS_SUBINDEX] configParameters[fwPeriphAddress_MODBUS_START] configParameters[fwPeriphAddress_MODBUS_INTERVAL] OPC Specific entries in address object: configParameters[fwPeriphAddress_OPC_LOWLEVEL] contains is lowlevel comparison is enabled (output only) configParameters[fwPeriphAddress_OPC_SUBINDEX] contains subindex if datatype = 'bitstring' configParameters[fwPeriphAddress_OPC_SERVER_NAME] contains OPC server name configParameters[fwPeriphAddress_OPC_GROUP_IN] contains OPC group for input address configs only configParameters[fwPeriphAddress_OPC_GROUP_OUT] contains OPC group for output address configs only OPC UA Specific entries in address object: configParameters[fwPeriphAddress_OPCUA_LOWLEVEL] contains is lowlevel comparison is enabled (output only) configParameters[fwPeriphAddress_OPCUA_SERVER_NAME] contains OPC server name configParameters[fwPeriphAddress_OPCUA_SUBSCRIPTION] contains OPC UA subscription name configParameters[fwPeriphAddress_OPCUA_KIND] contains OPC UA kind configParameters[fwPeriphAddress_OPCUA_VARIANT] contains OPC UA variant configParameters[fwPeriphAddress_OPCUA_POLL_GROUP] contains polling group name (including system name). Compulsory in case no subscription is specified DIM Client Service Specific entries in address object: configParameters[fwPeriphAddress_DIM_CONFIG_DP] the DIM config data point to which the config is saved configParameters[fwPeriphAddress_DIM_DEFAULT_VALUE] default value setting configParameters[fwPeriphAddress_DIM_TIMEOUT] timeout setting configParameters[fwPeriphAddress_DIM_FLAG] flag setting configParameters[fwPeriphAddress_DIM_IMMEDIATE_UPDATE] immediate update setting DIP Client Specific entries in address object: configParameters[fwPeriphAddress_DIP_CONFIG_DP] the DIP config data point to which the config is saved S7 Specific entries in address object: configParameters[fwPeriphAddress_S7_LOWLEVEL] configParameters[fwPeriphAddress_S7_SUBINDEX] configParameters[fwPeriphAddress_S7_START] configParameters[fwPeriphAddress_S7_INTERVAL] configParameters[fwPeriphAddress_S7_POLL_GROUP] |
| exceptionInfo | details of any errors are returned here |
| runDriverCheck | Optional parameter (default value = FALSE) - TRUE to check if driver is running before setting config, else FALSE The necessary driver number must be running in order to successfully create config |
References _fwConfigs_getSystemsInDpeList(), FW_PARAMETER_FIELD_NUMBER, fwPeriphAddress_checkIsDriverRunning(), fwPeriphAddress_OPCUA_KIND, fwPeriphAddress_OPCUA_POLL_GROUP, fwPeriphAddress_OPCUA_SERVER_NAME, fwPeriphAddress_OPCUA_SUBSCRIPTION, fwPeriphAddress_OPCUA_VARIANT, fwPeriphAddress_setModbus(), fwPeriphAddress_setOPC(), and fwPeriphAddress_setOPCUA().
Referenced by fwPeriphAddress_setMany().
| fwPeriphAddress_setMany | ( | dyn_string & | dpes, |
| dyn_dyn_anytype & | configParameters, | ||
| dyn_string & | exceptionInfo, | ||
| bool | runDriverCheck = FALSE |
||
| ) |
Sets the address config for a given set of data point elements.
| dpe | datapoint element to act on |
| configParameters | Address object is passed here. See fwPeriphAddress_set() for details. |
| exceptionInfo | details of any errors are returned here |
| runDriverCheck | Optional parameter (default value = FALSE) - TRUE to check if driver is running before setting config, else FALSE The necessary driver number must be running in order to successfully create config |
References fwPeriphAddress_set().
| fwPeriphAddress_setModbus | ( | string | dpe, |
| dyn_string | dsParameters, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Set MODBUS address
| dpe | datapoint element whose address have to be set |
| dsParameters | parameters used to set the _address config (see constants definition) |
| exceptionInfo | for any error... |
References FW_PARAMETER_FIELD_ACTIVE, FW_PARAMETER_FIELD_ADDRESS, FW_PARAMETER_FIELD_DATATYPE, FW_PARAMETER_FIELD_DRIVER, FW_PARAMETER_FIELD_INTERVAL, FW_PARAMETER_FIELD_LOWLEVEL, FW_PARAMETER_FIELD_MODE, FW_PARAMETER_FIELD_START, and FW_PARAMETER_FIELD_SUBINDEX.
Referenced by fwPeriphAddress_set().
| fwPeriphAddress_setOPC | ( | string | dpe, |
| string | opcServerName, | ||
| int | driverNum, | ||
| string | OPCItemName, | ||
| string | OPCGroup, | ||
| int | datatype, | ||
| int | mode, | ||
| unsigned | subindex, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Add an address config for an OPC Item
| dpe | data point element |
| opcServerName | data point name of the OPC Server wihtout system name and "_" |
| driverNum | driver number |
| OPCItemName | opc item name |
| OPCGroup | opc group name |
| datatype | translation datatype for address (0 gives automatic translation) |
| mode | DPATTR_ADDR_MODE_INPUT_SPONT: spontaneous input DPATTR_ADDR_MODE_INPUT_SPONT+64: spontaneous input and old/new comparison DPATTR_ADDR_MODE_OUTPUT_SINGLE: output DPATTR_ADDR_MODE_OUTPUT_SINGLE+64: output and old/new comparison |
| subindex | used where datatype is set to 'bitstring'. Subindex gives the position of the desired bit. |
| exceptionInfo | details of any errors are returned here |
Referenced by fwPeriphAddress_set().
| fwPeriphAddress_setOPCUA | ( | string | dpe, |
| string | opcServerName, | ||
| int | driverNum, | ||
| string | opcItemName, | ||
| string | opcSubscription, | ||
| string | opcKind, | ||
| string | opcVariant, | ||
| int | datatype, | ||
| int | mode, | ||
| string | pollGroup, | ||
| dyn_string & | exceptionInfo | ||
| ) |
Add an address config for an OPC UA Item
| dpe | data point element |
| opcServerName | data point name of the OPC Server wihtout system name and "_" |
| driverNum | driver number |
| opcItemName | opc item name |
| opcSubscription | opc subscription name |
| opcKind | opc kind |
| opcVariantn | opc variant |
| pollGroup | polling group name (used only if no subscription name is specified) |
| datatype | translation datatype for address (0 gives automatic translation). See WinCC OA help on _address for a list of data type translations |
| mode | DPATTR_ADDR_MODE_INPUT_SPONT: spontaneous input DPATTR_ADDR_MODE_INPUT_SPONT+64: spontaneous input and old/new comparison DPATTR_ADDR_MODE_OUTPUT_SINGLE: output DPATTR_ADDR_MODE_OUTPUT_SINGLE+64: output and old/new comparison DPATTR_ADDR_MODE_IO_POLL: in/out with polling mode DPATTR_ADDR_MODE_IO_SQUERY: in/out with single query DPATTR_ADDR_MODE_INPUT_POLL: input with polling mode DPATTR_ADDR_MODE_INPUT_SQUERY: input with single query |
| exceptionInfo | details of any errors are returned here |
Referenced by fwPeriphAddress_set().