Update cookies preferences
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 (i.e. with the same 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 comparison:
- 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 reading 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:
ClosePort()Close the ethernet port or serial port
GetCount()Returns the number of transfers
GetProtParam()Returns some values defined in configurators of the "PmaComm > Parameters" tab
InfoLogAdd()Writing text into the "/COMM/Driver/Log" item in the Debug item of the INFO system
IsConnectedDetects whether Ethernet or serial link is connected
OpenPort()Open the ethernet port or serial port
SetProtParam()Sets 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:
AddEvent()Registers a function into the specified event
GetOwnedByIndex()Returns the subobject defined by its index
GetOwnedByName()Returns reference to the subobject defined by its name
GetOwnedByType()Returns an array of references to the subobjects
GetOwnedNum()Returns number of subobjects in the object
GetPar()Reading the value of the Pma object parameter (or its parents)
GetPathName()Object name with the path to this object
GetPermission()Returns permission of corresponding operation from object
MethodsAccess to designer methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
Pm()Returns reference to the Pma object or to its implementation subobject
RemoveEvent()Unregisters 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 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:
Pm9.00.00: Object name changed: PmComm -> PmaComm
Pm8.00.09: Fixed bug: Sometimes the communication stopped and in order to restart it, it was necessary either to call the OpenPort method, or restart the application!
PROMOTIC 9.0.31 SCADA system documentation MICROSYS, spol. s r.o.

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