Click or drag to resize

DmTx4kz100C1G Class

The DM-TX-4KZ-100-C-1G is a is a wall plate 4K DigitalMedia HDMI transmitter and control interface that connects to a DM® switcher or receiver over a single CAT (twisted pair) or DM 8G® cable and supports 4K Ultra HD video resolutions up to 4,096 x 2,160 at 24Hz or 3,840 x 2,160 at 30Hz.
Inheritance Hierarchy

Namespace: Crestron.SimplSharpPro.DM.Endpoints.Transmitters
Assembly: Crestron.SimplSharpPro.DM (in Crestron.SimplSharpPro.DM.dll) Version: 2.21.121
Syntax
C#
public sealed class DmTx4kz100C1G : DmTx200Base, 
	IIROutputPorts, IComPorts

The DmTx4kz100C1G type exposes the following members.

Constructors
 NameDescription
Public methodDmTx4kz100C1G(DMInput) Constructor to generate a new DM-TX-4KZ-100-C-1G that is connected to a switcher's DM Input.
Public methodDmTx4kz100C1G(UInt32, CrestronControlSystem) Constructor to generate a new DM-TX-4KZ-100-C-1G DM transmitter that is controlled separately from a DM switcher.
Public methodDmTx4kz100C1G(UInt32, CrestronDeviceWithEvents) Constructor to generate a new DM-TX-4KZ-100-C-1G that is connected to a DM Card.
Public methodDmTx4kz100C1G(UInt32, DMInput) Constructor to generate a new DM-TX-4KZ-100-C-1G that is connected to a switcher's DM Input.
Top
Properties
 NameDescription
Public propertyAudioSource Select the audio source for the Dm Endpoint. Not supported by "DM-TX-4KZ-100-C-1G" device. If this property is not supported then Auto will be returned and write to this property will be ignored.
(Inherited from DmTx200Base)
Public propertyAudioSourceFeedback Reports the active audio source. Not supported by "DM-TX-4KZ-100-C-1G" device. If this property is not supported then Auto will be returned.

The BaseEvent event will trigger with AudioSourceFeedbackEventId.


(Inherited from DmTx200Base)
Public propertyComPorts Collection of serial COM ports on the device.
Public propertyConnectedIpList A property containing the list of the ConnectedIpInformation objects which contain information about the devices that are connected to this IP ID. This property is only valid for an ethernet device. If this is not an ethernet device, then this property will return null. If this is an ethernet device, the list will be non-null. It will be empty if no devices are connected. The order of items in this list is not guaranteed.
(Inherited from GenericDevice)
Public propertyCode exampleDescription Get/Set the description of this device.
(Inherited from GenericBase)
Public propertyDisposed Property to indicate if the device has been disposed.
(Inherited from GenericDevice)
Public propertyDMInput Reference back to the DM Input this transmitter is attached to.
(Inherited from EndpointTransmitterBase)
Public propertyDmOutput Get the Dm Output port for this Endpoint.
(Inherited from DmTx200Base)
Public propertyHDBaseTDevice Get the current HDBaseTBase attached to this DM Input/Output
(Inherited from DMEndpointBase)
Public propertyHdmiInput Get the HDMI Input port for this Endpoint.
(Inherited from DmTx200Base)
Public propertyID Property to get the ID of the device.
(Inherited from GenericDevice)
Public propertyIROutputPorts Collection of IR output ports on the device.
Public propertyIsOnline Property to get the current online state of the device.
(Inherited from GenericDevice)
Public propertyName Get the name of this device.
(Inherited from GenericBase)
Public propertyNumberOfComPorts Number of serial COM ports this device supports.
Public propertyNumberOfIROutputPorts Number of IR output ports this device supports.
Public propertyParent The parent that a given object was added to.
(Inherited from GenericBase)
Public propertyRegisterable Property to indicate that this device can be registered.
(Inherited from GenericDevice)
Public propertyRegistered Property to get the current registration state of the device.
(Inherited from GenericDevice)
Public propertyRegistrationFailureReason Property to get the Registration Failure Reason, this will match the return value from the call to register.
(Inherited from GenericDevice)
Protected propertySIMPLDeviceImplementation Internal protected member used for actual device control.
(Inherited from GenericDevice)
Public propertyType Property to determine to type of device this is.
(Inherited from GenericDevice)
Public propertyUnRegistrationFailureReason Property to get the Unregistration Failure Reason, this will match the return value from the call to unregister.
(Inherited from GenericDevice)
Public propertyUsbPort Get the USB port for this Endpoint. Not supported by "DM-TX-4KZ-100-C-1G" device.
(Inherited from DmTx200Base)
Public propertyUserSpecifiedObject Can be assigned anything that user wants.
(Inherited from GenericBase)
Public propertyVgaInput Get the VGA Input port for this Endpoint. Not supported by "DM-TX-4KZ-100-C-1G" device.
(Inherited from DmTx200Base)
Public propertyVideoSource Select the Video Source for the Dm Endpoint. Not supported by "DM-TX-4KZ-100-C-1G" device. If this property is not supported then Auto will be returned and write to this property will be ignored.
(Inherited from DmTx200Base)
Public propertyVideoSourceFeedback Reports the active video source. Not supported by "DM-TX-4KZ-100-C-1G" device. If this property is not supported then Auto will be returned.

The BaseEvent event will trigger with VideoSourceFeedbackEventId.


(Inherited from DmTx200Base)
Protected propertyXioEndpointStubSIMPLDevice The SIMPL "stub" Device that the XiO Director creates for an endpoint to send the 1C/0E to the correct place in hierarchy.
(Inherited from GenericDevice)
Top
Methods
 NameDescription
Public methodDispose Clean up of resources.
(Inherited from GenericBase)
Protected methodDispose(Boolean) Method to dispose the endpoint.
(Inherited from EndpointTransmitterBase)
Public methodEqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
Protected methodFinalize Destructor of the device.
(Inherited from GenericDevice)
Public methodGetHashCodeServes as the default hash function.
(Inherited from Object)
Public methodGetTypeGets the Type of the current instance.
(Inherited from Object)
Protected methodOnBaseEvent(Int32) Protected member used to fire the BaseEvent with the default extended information.
(Inherited from GenericBase)
Protected methodOnBaseEvent(Int32, UInt16) Protected member used to fine the BaseEvent with extended event information.
(Inherited from GenericBase)
Public methodRegister Register this device with the system.
(Overrides GenericDeviceRegister)
Public methodToString Return the name of the device.
(Inherited from GenericDevice)
Public methodUnRegister Unregister this device with the system. This function can not be called from the device's own SigChange event handler.
(Overrides GenericDeviceUnRegister)
Top
Events
 NameDescription
Public eventBaseEvent Generic base event, triggered when the there are no other handlers available for a specific EventID.
(Inherited from GenericBase)
Public eventIpInformationChange Event that tells what IP Address is connected/disconnected from an IP ID for a non-UDP device. This is only valid for an Ethernet device. An exception will be thrown if it is not.
(Inherited from GenericDevice)
Public eventOnlineStatusChange Event triggered when the Online status of the device changes.
(Inherited from GenericDevice)
Top
Example
C#
static DmTx4kz100C1G _dmTx4kz100C1G;

public ControlSystemDmTx4kz100C1G()
{
    //Register console commands 
    CrestronConsole.AddNewConsoleCommand(CreateDeviceCmd, "CreateDevice", "This is a DmTx4kz100C1G CreateDevice command", ConsoleAccessLevelEnum.AccessOperator);
}

public void CreateDeviceCmd(String args)
{
    //Initialize the DmTx4kz100C1G device
    _dmTx4kz100C1G = new DmTx4kz100C1G(0x16, this);

    _dmTx4kz100C1G.HdmiInput.StreamCec.CecChange += StreamCecChangeEventHandler;
    _dmTx4kz100C1G.HdmiInput.VideoAttributes.AttributeChange += VideoAttributeChange;
    _dmTx4kz100C1G.HdmiInput.InputStreamChange += HdmiInputStreamChange;

    _dmTx4kz100C1G.DmOutput.OutputStreamChange += DmOutputStreamChange;
    _dmTx4kz100C1G.DmOutput.StreamCec.CecChange += StreamCecChangeEventHandler;
    _dmTx4kz100C1G.DmOutput.ConnectedDevice.DeviceInformationChange += ConnectedDeviceOnDeviceInformationChange;

    _dmTx4kz100C1G.ComPorts[1].SerialDataReceived += OnSerialDataReceived;

    _dmTx4kz100C1G.Register();

    if (_dmTx4kz100C1G.Registered)
    {
        CrestronConsole.ConsoleCommandResponse("{0} device successfully registered\r\n", _dmTx4kz100C1G.ToString());
    }
}

static void OnSerialDataReceived(ComPort receivingComPort, ComPortSerialDataEventArgs args)
{
    CrestronConsole.PrintLine("Serial data received is {0}", args.SerialData);
}

static void ComPort_PropertyChanged(ComPort receivingcomport, ComPortPropertyEventArgs args)
{
    if (args.Property == eComPortProperty.CD)
    {
        CrestronConsole.PrintLine("DM-RMC-4K-SCALER-C COM Port {0} CD Changed to {1}", receivingcomport.ID, receivingcomport.CD);
    }
}

public void DmRmc4K100C1G_BaseEvent(GenericBase device, BaseEventArgs args)
{
    CrestronConsole.PrintLine("DmRmc4K100C1G_BaseEvent occurred. Event ID is {0} device index is {1}.\r\n", args.EventId, args.Index);
}

// Method to handle connected device sig change events for DM-TX-4KZ-100-C-1G device.
static void ConnectedDeviceOnDeviceInformationChange(ConnectedDeviceInformation connectedDevice, ConnectedDeviceEventArgs args)
{
    if (args.EventId == ConnectedDeviceEventIds.ManufacturerEventId)
    {
        CrestronConsole.PrintLine("Manufacturer Feedback Event occurred on {0} event ID is {1}", connectedDevice.ToString(), args.EventId);
    }
}

// Method to handle top level DM Out sig change events for DM-TX-4KZ-100-C-1G device.
static void DmOutputStreamChange(EndpointOutputStream outputStream, EndpointOutputStreamEventArgs args)
{
    if (args.EventId == EndpointOutputStreamEventIds.DmPassThroughModeEnabledFeedbackEventId)
    {
        CrestronConsole.PrintLine("DM Pass Through Mode Enabled Feedback Event occurred on {0} event ID is {1} stream string is {2}", outputStream.ToString(), args.EventId, outputStream.ToString());
    }
}

// Method to handle top level stream sec sig change events for DM-TX-4KZ-100-C-1G device.
static void StreamCecChangeEventHandler(Cec cecDevice, CecEventArgs args)
{
    if (args.EventId == CecEventIds.CecMessageReceivedEventId)
    {
        CrestronConsole.PrintLine("Cec Message Received Feedback Event occurred on {0} event ID is {1} cec string is {2}", cecDevice.Owner.ToString(), args.EventId, cecDevice.ToString());
    }
}

// Method to handle HDMI input stream sig change events for DM-TX-4KZ-100-C-1G device.
static void HdmiInputStreamChange(EndpointInputStream inputStream, EndpointInputStreamEventArgs args)
{
    if (args.EventId == EndpointInputStreamEventIds.AudioFormatFeedbackEventId)
    {
        CrestronConsole.PrintLine("Audio Format Feedback Event occurred on {0} event ID is {1}", inputStream.ToString(), args.EventId);
    }
}

// Method to handle video attribute sig change events for DM-TX-4KZ-100-C-1G device.
static void VideoAttributeChange(object sender, GenericEventArgs args)
{
    if (args.EventId == VideoAttributeEventIds.HorizontalResolutionFeedbackEventId)
    {
        CrestronConsole.PrintLine("Horizontal Resolution Feedback Event occurred on {0} event ID is {1}", sender.ToString(), args.EventId);
    }
}

// Method to handle top level sig change events for DM-TX-4KZ-100-C-1G Device.
static void DmTx20XC2EventHandler(GenericBase device, BaseEventArgs args)
{
    if (args.EventId == EndpointTransmitterBase.VideoSourceFeedbackEventId)
    {
        CrestronConsole.PrintLine("Video Source Feedback Event occurred on {0} event ID is {1}", device.ToString(), args.EventId);
    }
}

Version Information

.NET

Supported in: 6.0

.NET Compact Framework

Supported in: 3.5
See Also