Description:

The HD Leeza is Key Digital's follow up to the Digital Leeza box. Unlike the Digital Leeza, the HD Leeza splits out just the video processor functionality, leaving the switching to a separate device. It supports a good selection of inputs, including future compatible SDI and DVI inputs, and its major claim to fame is the ability to de-interlace high definition material to progressive format.

This version of the driver has been updated for the latest (as of this writing) firmware version of the HD Leeza, version 5.5.74. It may not work for previous versions, or later versions if any changes have been made to the serial protocol.

This driver's server side component is CML based. The server driver classes for this device are in the MEng.System.CQC.Drivers.HDLeeza scope.

Quirks and Limitations:

The HD Leeza does not have a soft power off mode, which is unfortunate. So you will either have to leave it on or turn it on and off manually.

The Leeza control protocol isn't as robust as it could be, and provides no feedback about errors or why a command was rejected or didn't work. And it's not very formally defined, so it is possible that future firmware updates could break this driver and require a driver upgrade. So you might want to check with us before upgrading the HD Leeza's firmware if you are using CQC to control it.

One quirk that has been seen is that it stops responding. Some code has been added in order to try to correct this, but it may hang up and require a hard power cycle. Please let us know if you experience this. We've not seen it since the latest firmware update, but we've not had that update installed very long as of this driver version release.

As is common with video processors, it can take a while for it to come back to earth after you change to a new input. So in macros you will generally want to pause a couple seconds after writing to the input changing fields, to give it some time to get caught up with itself, or you might get "Unknown" for the input or aspect ratios.

Note that the same serial port is used to upload firmware updates to the HD Leeza. If you need to do this, you will either need to use another computer, or a different serial port on the same computer, or you will have to unload the CQC driver temporarily, so that you can get to the serial port. Otherwise, the CQC driver will keep the serial port open, and the firmware update program won't be able to talk to the HD Leeza.

Connection Details

The Leeza uses a serial connection. It requires a 9-pin straight through serial cable. It can be a three wire since no hardware handshaking is required.

The serial port parameters are fixed, so you are not given a chance to configure them, you just get to choose the serial port. The parameters are 19200 baud, 8 bits, one stop bit, no parity. The protocol is very wordy and inefficient, but the baud rate is high enough that it's not too piggy. But the driver polls the device a little slower than it might otherwise, in order to make up for the wordiness.

Driver Fields

This section lists the fields that the driver makes available, their types, minimum and maximum values, etc...

Name	Type	R/W	Description/Limits
12VTrigger	Boolean	R/W	Turns on or off the HD Leeza's 12V triggers. Read it to get the current state, and write to it to set the state.
Input	String	R/W	Sets/gets the current input. This field is an enumerated string, and the possible values are: DVI/HDCP 1, DVI/HDCP 2, RGBHV, Component HD, SDI, Component SD, Svideo 1, Svideo 2, Composite 1, and Composite 2.
InputAR	String	R/W	The input aspect ratio. It is an enumerated string and the possible values are: 1.33, 1.66, 1.78, 1.85, 2.00, or 2.35.
OutputAR	String	R/W	The output aspect ratio. It is an enumerated string and the possible values are: 1.33, 1.66, 1.78, 1.85, 2.00, or 2.35
OutputRes	String	R	A read only field that shows the current output resolution.
OSD	Boolean	R/W	A Boolean field that controls whether the on screen display is enabled or not.
OSDInhibit	Boolean	R/W	Allows you to inhibit the on screen display from popping up.
NextPrevInput	Boolean	W	Another way to select inputs by cycling through them. True will cycle forward and False backwards. Mostly provided to simplify setting up IR triggered actions.
ROMDate	String	R	This is a read only field that holds the ROM date stamp string  from the Leeza. This can be useful information when contacting Key Digital about problems.
ToggleOSD	Boolean	W	Toggles the OSD enable state by writing either True or False. You can set this directly via the OSD field, but this is provided where a simple toggle is desirable.
VGABypass	Boolean	R/W	A Boolean field that controls whether the VGA bypass mode is enabled or not.