realvirtual.PLCOutputInt Class Reference

PLC Integer Output Signal - Represents a 32-bit integer output signal from PLC to simulation. More...

Inheritance diagram for realvirtual.PLCOutputInt:

Public Member Functions
override void	SetStatusConnected (bool status)
	Virtual for setting the Status to connected.
override bool	GetStatusConnected ()
	Virtual for getting the connected Status.
override void	SetValue (string value)
	Virtual for setting the value.
void	SetValue (int value)
	Sets the value as an int.
override void	SetValue (object value)
	Sets the value as an int.
override void	SetValue (byte[] value)
override object	GetValue ()
	Gets the value of the signal.
override byte[]	GetByteValue ()
override int	GetByteSize ()
override string	GetVisuText ()
	Virtual for getting the text for the Hierarchy View.
void	Update ()
Public Member Functions inherited from realvirtual.Signal
delegate void	OnSignalChangedDelegate (Signal obj)
void	OnInspectValueChanged ()
bool	OnObjectDrop (Object reference)
void	OnInspectedToggleChanged (bool arg0)
string	GetSignalName ()
virtual bool	IsInput ()
	Virtual for getting information if the signal is an Input.
virtual void	OnToggleHierarchy ()
	Virtual for toogle in hierarhy view.
void	Unforce ()
	Unforces the signal.
void	DeleteSignalConnectionInfos ()
void	AddSignalConnectionInfo (GameObject behavior, string connectionname)
bool	IsConnectedToBehavior ()
	Returns true if InterfaceSignal is connected to any Behavior Script.
string	GetTypeString ()
	Returns the type of the Signal as a String.
InterfaceSignal	GetInterfaceSignal ()
	Returns an InterfaceSignal Object based on the Signal Component.
void	SetMetadata (string key, object value)
	Set metadata value for this signal.
T	GetMetadata< T > (string key, T defaultValue=default(T))
	Get metadata value with automatic type conversion.
bool	HasMetadata (string key)
	Check if metadata key exists for this signal.
void	RemoveMetadata (string key)
	Remove metadata key from this signal.
IEnumerable< string >	GetMetadataKeys ()
	Get all metadata keys for this signal.
Public Member Functions inherited from realvirtual.realvirtualBehavior
virtual void	OnOwnershipChanged (bool isOwner)
	Called when network ownership changes.
void	SetNetworkOwner (bool isOwner)
	Sets IsNetworkOwner and triggers OnOwnershipChanged callback.
void	PreStartSim ()
	Is called by the realvirtualController before the component is started.
void	StartSim ()
	Is called by the realvirtualController to start or stop the component.
void	StopSim ()
Vector3	DirectionToVector (DIRECTION direction)
	Transfers the direction enumeration to a vector.
DIRECTION	VectorToDirection (bool torotatoin, Vector3 vector)
	Transfers a vector to the direction enumeration.
float	GetLocalScale (Transform thetransform, DIRECTION direction)
List< BehaviorInterfaceConnection >	UpdateConnectionInfo ()
List< Signal >	GetConnectedSignals ()
void	SetVisibility (bool visibility)
	Sets the visibility of this object including all subobjects.
List< BehaviorInterfaceConnection >	GetConnections ()
List< Signal >	GetSignals ()
GameObject	GetChildByName (string name)
	Gets a child by name.
List< GameObject >	GetChildsByName (string name)
	Gets all child by name.
GameObject	GetChildByNameAlsoHidden (string name)
List< GameObject >	GetAllMeshesWithGroup (string group)
List< GameObject >	GetAllWithGroup (string group)
List< GameObject >	GetAllWithGroups (List< string > groups)
List< GameObject >	GetAllMeshesWithGroups (List< string > groups)
List< string >	GetMyGroups ()
List< GameObject >	GetMeshesWithSameGroups ()
List< GameObject >	GetAllWithSameGroups ()
MeshRenderer	GetMeshRenderer ()
	Gets the mesh renderers in the childrens.
void	SetCollider (bool enabled, bool includeTriggers=true)
	sets the collider in all child objects
void	ErrorMessage (string message)
	Displays an error message.
void	ChangeConnectionMode (bool isconnected)
void	Log (string message)
	Logs a message.
void	Log (string message, object obj)
	Logs a message with a relation to an object.
void	Warning (string message, object obj)
	Logs a warning with a relation to an object.
void	Error (string message, object obj)
	Logs an error with a relation to an object.
void	Error (string message)
	Logs an error.
GameObject	DebugPosition (string debugname, Vector3 position, Quaternion quaternation, float scale)
	Displays a gizmo for debugging positions.
void	SetFreezePosition (bool enabled)
	Freezes all child components to the current poosition.
void	SetRbConstraints (RigidbodyConstraints constraints)
virtual void	AwakeAlsoDeactivated ()

Public Attributes
StatusInt	Status
Public Attributes inherited from realvirtual.Signal
string	Comment
string	OriginDataType
SettingsSignal	Settings
SignalEvent	EventSignalChanged
bool	Autoconnected
bool	UpdateEnable
List< Connection >	ConnectionInfo
InterfaceSignal	interfacesignal
SignalMetadata	Metadata
	Metadata for PLC communication and interface configuration.
Public Attributes inherited from realvirtual.realvirtualBehavior
string	Name
	The name of the component if it should be different from the GameObject name.
ActiveOnly	Active
GameObject	FromTemplate
realvirtualController	realvirtualController
bool	HideNonG44Components
bool	SceneIsAdditive
bool	ForceStop
bool	IsNetworkOwner
	True when this component owns its simulation (local authority). Set to false by MultiplayerWEB on remote clients.

Properties
int	Value [get, set]

Additional Inherited Members
Public Types inherited from realvirtual.realvirtualBehavior
enum	ActiveOnly {   Always , Connected , Disconnected , Never ,   DontChange }
Static Public Member Functions inherited from realvirtual.realvirtualBehavior
static bool	DirectionIsLinear (DIRECTION direction)
	Gets back if the direction is linear or a rotation.
Protected Member Functions inherited from realvirtual.Signal
void	SignalChangedEvent (Signal signal)
new bool	hidename ()
Protected Member Functions inherited from realvirtual.realvirtualBehavior
bool	hidename ()
bool	hideactiveonly ()
virtual void	OnStopSim ()
virtual void	OnPreStartSim ()
virtual void	OnStartSim ()
MU	GetTopOfMu (GameObject obj)
	Gets the top of an MU component (the first MU script going up in the hierarchy)
void	InitGame4Automation ()
	Initialiates the components and gets the reference to the realvirtualController in the scene.
virtual void	AfterAwake ()
void	Awake ()
Protected Attributes inherited from realvirtual.Signal
string	Visutext
Events inherited from realvirtual.Signal
OnSignalChangedDelegate	SignalChanged

Detailed Description

PLC Integer Output Signal - Represents a 32-bit integer output signal from PLC to simulation.

PLCOutputInt is an essential signal type for receiving integer data from external PLC systems into the Unity simulation environment. This component receives 32-bit signed integer values, allowing PLC programs to control simulation behavior through setpoints, commands, and parameter values.

Key Features:

• Receives 32-bit signed integer values from connected PLC systems
• Provides automatic change detection and event notification
• Supports discrete state and parameter value reception
• Includes override functionality for testing and manual control
• Maintains connection status for communication monitoring
• Robust type conversion with error handling

Signal Direction: PLC → Simulation (Output from PLC from PLC perspective) The signal flows from PLC controllers to Unity simulation, enabling PLC programs to control simulation behavior through integer commands such as speed setpoints, recipe numbers, and operation modes.

Common Applications:

• Sending simulated encoder positions and pulse counts
• Providing part counting and production statistics
• Transmitting state machine status codes
• Reporting error codes and diagnostic information
• Sending calculated integer results (total counts, averages)
• Providing array indices and selection values
• Transmitting quality codes and inspection results

Interface Integration: PLCOutputInt supports all major industrial communication protocols:

• OPC UA: Writes to OPC UA Int32 nodes with proper typing
• S7 TCP/IP: Direct writing to Siemens S7 DINT data blocks
• Modbus TCP/RTU: Updates holding registers (2 registers for 32-bit)
• TwinCAT ADS: Writes to Beckhoff DINT variables
• MQTT: Publishes integer values in JSON format
• Shared Memory: High-speed integer array updates

Data Integrity and Conversion: The component ensures reliable data transmission:

• Safe conversion from various numeric types (float, double, long)
• Overflow protection with Convert.ToInt32()
• Null value handling to prevent exceptions
• Byte array conversion for binary protocols
• String formatting for text-based communication

Update Mechanism: Value changes are monitored in Update() for responsive updates. When the value changes, EventSignalChanged is invoked to notify all connected interfaces. This ensures that PLC programs receive timely updates for counter values, state changes, and other discrete information critical for sequence control and decision making.

Virtual Commissioning: In virtual commissioning scenarios, PLCOutputInt signals simulate discrete sensors, encoders, and counting devices. This allows complete testing of PLC counting logic, state machines, and discrete control algorithms without physical hardware. The override feature enables manual value injection for comprehensive test coverage.

Performance Considerations: Integer signals are highly efficient for discrete value transmission, using only 4 bytes per value. They are ideal for high-frequency updates like encoder feedback and counter values, providing optimal network bandwidth usage compared to float types.

Member Function Documentation

GetByteSize()

override int realvirtual.PLCOutputInt.GetByteSize ( )

virtual

Reimplemented from realvirtual.Signal.

GetByteValue()

override byte[] realvirtual.PLCOutputInt.GetByteValue ( )

virtual

Reimplemented from realvirtual.Signal.

GetStatusConnected()

override bool realvirtual.PLCOutputInt.GetStatusConnected ( )

virtual

Virtual for getting the connected Status.

Reimplemented from realvirtual.Signal.

GetValue()

override object realvirtual.PLCOutputInt.GetValue ( )

virtual

Gets the value of the signal.

Reimplemented from realvirtual.Signal.

GetVisuText()

override string realvirtual.PLCOutputInt.GetVisuText ( )

virtual

Virtual for getting the text for the Hierarchy View.

Reimplemented from realvirtual.Signal.

SetStatusConnected()

override void realvirtual.PLCOutputInt.SetStatusConnected ( bool  status )

virtual

Virtual for setting the Status to connected.

Reimplemented from realvirtual.Signal.

SetValue() [1/4]

override void realvirtual.PLCOutputInt.SetValue ( byte[]  value )

virtual

Reimplemented from realvirtual.Signal.

SetValue() [2/4]

void realvirtual.PLCOutputInt.SetValue

(

int

value

)

Sets the value as an int.

SetValue() [3/4]

override void realvirtual.PLCOutputInt.SetValue ( object  value )

virtual

Sets the value as an int.

Reimplemented from realvirtual.Signal.

SetValue() [4/4]

override void realvirtual.PLCOutputInt.SetValue ( string  value )

virtual

Virtual for setting the value.

Reimplemented from realvirtual.Signal.