Promotic

Object PmaComm (Communication)

Description:
The object provides the communication with other computers (usually with control computers of PLC type) via Ethernet or via the computer's serial port (COM1, COM2,...).

One or more objects PmaCommMsg or PmaCommGroup can be created in the PmaComm object.
This object can be created in objects: PmaRoot, PmaFolder, PmaPrototype. Multiple objects of this type can be created in such objects.
The usage of the PmaComm object requires purchase of the licence for the appropriate communication driver - see List of communication drivers.

The PmaComm object can be used in the application more times, it can be even configured more times with the same protocol (driver).
For serial link each PmaComm object must have defined another communication port. For example, if one PmaComm object communicates through COM1, then next PmaComm object can communicate for example through COM2 (COM3, ...) but it mustn't communicate through COM1.

The PmaComm object specifies what port and protocol will be used for the data transfer. Data required for transmission are then defined in the PmaCommMsg or PmaCommGroup nested objects.

PmaCommMsg and PmaCommGroup objects comparation:
- The PmaCommMsg object:
- Is a "low level" object, meaning that the data format in this object is created depending on the communication message type, defined by corresponding protocol. If you want to receive, for example, both registers and counters, then two PmaCommMsg objects must be created because the current protocol does not support receiving both registers and counters in one message.
- Can be used for all drivers except for the PmOpcUaClient, PmS7 and PmOmronFINS driver.
- The PmaCommGroup object:
- Compared to the PmaCommMsg object, it is on a higher level, because the data in this object are not depending on used protocol. It is possible, for example, to define data for both counters and registers and the object will intelligently assemble this data into communication messages.
- Can be used for following drivers: PmOpcUaClient, PmModbusMr, PmS7, PmSBUS, PmMBus, PmKNX, PmIEC8705, PmMelsecQA, PmMelsecFXS, PmABradleyDF1, PmFatek and PmTeco.
For some drivers the PmaCommGroup object cannot be used based on the principles (e.g. for the PmChar communication driver, because this user defined protocol does not have any general addressing and depends only on the user, what kind of message will be created by the PmaCommMsg object).
This object inherits properties, methods and events of the PmaObject object.
Properties and methods of this object:
ClosePortClose the serial/ethernet port
GetCountReturns the number of transfers
GetProtParamReturns some values defined in configurators of the "PmaComm > Parameters" tab
IsConnectedDetects whether Ethernet or serial link is connected
OpenPortOpen the serial/ethernet port
SetProtParamSets values in some configurators of the "PmaComm > Parameters" tab
Properties only for serial link:
BaudRateThe baud rate of the serial link
ByteSizeThe number of data bits of the serial link
DtrValue of DTR signal of the serial link
ParityValue of the transfer parity of the serial link
RtsValue of RTS signal of the serial link
StopBitsThe number of stopbits of the serial link
Properties and methods inherited from the PmaObject object:
AddEventRegisters a function into selected event
GetInfoReturns the Info object with the specified name
GetOwnedByIndexReturns the subobject defined by its index
GetOwnedByNameReturns reference to the subobject defined by its name
GetOwnedByTypeArray of references to the subobjects
GetOwnedNumReturns number of subobjects in the object
GetParReading the value of the Pma object parameter (or its parents)
GetPathNameObject name with the path to this object
GetPermissionReturns permission of corresponding operation from object
MethodsAccess to designer's methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
PmReturns reference to the Pma object or to its implementation subobject
RemoveEventUnregisters the function in the specified event
RootReturns reference to the root application object PmaRoot
Events of this object:
onConnectIs triggered after the successful connection
onDisconnectIs triggered after the connection is closed
Events inherited from the PmaObject object:
onStartIs triggered for each object in the runtime only once at the beginning
onStopIs triggered for each Pma object in runtime only once at the stop of the application
Configuration tabs:
ObjectGeneral information about the object
EventsDefinition of object events algorithms
ParametersCommunication protocol and parameter setting
Related objects:
PmaCommGroup(Communication data) Definition of the communication data group
PmaCommMsg(Communication message) Format definition of one communication message

History:
Pm8.00.09: Fixed bug: Sometimes the communication stopped and in order to restart it, it was necessary to call the OpenPort method, or restart the application!
Pm9.00.00: Object name changed: PmComm -> PmaComm
PROMOTIC 9.0.24 SCADA system documentation MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.