Description:

The Key Digital Leeza is a very slick box that is both a video switcher and a high quality video scaler, with analog and digital inputs and outputs. It can also transcode between component and RGB formats, and manage sync polarity, so it is quite flexible.

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

Quirks and Limitations:

The Leeza does not seem to have a working 'soft power' mode. If you turn it off, its dead and it cannot be turned on via software. So you'll probably want to just leave it on. The protocol defines start/stop commands, but they don't seem to do what one would expect. This will be explored and support added if I can figure it out.

The Leeza control protocol isn't that great, but it gets the job done. The port speed is quite high relative to the bulk of data so it has good response times, and hence low latencies keeping the driver up to date.

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 bit after writing to the input changing fields, to give it a minute to get caught up with itself.

Connection Details

The Leeza uses a serial connection. It requires a 9-pin straight through serial cable, and it must be a full cable or at least a 5 wire, not a three wire, because the Leeza wants to see the RTS line from the host computer, and the CQC driver watches for CTS to know that the Leeza is present.

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 38400 baud, 8 bits, one stop bit, no parity. The protocol is relatively wordy and inefficient, but the baud rate is far higher than most devices and the amount of data to poll is fairly small, so the performance is good.

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
AnamorphicMode	String	RW	Sets/gets the anamorphic mode. This only does anything for non-HD sources. It is an enumerated string and the possible values are: 1.78A, 1.78L, 1.33. A and L in this case refer to anamorphic or letterbox.
Brightness	Int	RW	Sets/gets the brightness level. Brightness is a per-input value, so it will change as you change inputs. It's range is -128 to 127.
Contrast	Card	RW	Sets/gets the contrast level. Contrast is a per-input value, so it will change as you changes inputs. It's range is 0 to 255.
Input	String	RW	Sets/gets the current input. This field is an enumerated string, and the possible values are: SD1, SD2, SD3, SD4, HD1, HD2, HD3.
InputAR	String	RW	The input aspect ratio. It is an enumerated string and the possible values are: 1.33, 1.66, 1.78, 1.85, 2.00, 2.35, CUSTOM
OutputAR	String	RW	The output aspect ratio. It is an enumerated string and the possible values are: 1.33, 1.66, 1.78, 1.85, 2.00, 2.35, CUSTOM
Resolution	String	RW	The current resolution setting. It is an enumerated string and the possible values are: 640x480, 720x480, 852x480, 800x600, 1920x540, 1280x720, 1024x768, 1280x768, 1366x768, 1280x960, 1024x512, 1024x1024, 1280x1024, 1365x1024, 1920x1080
NextPrevInput	Boolean	W	Another way to select inputs by cycling through them. This field is write only, and setting it true will move to the next input, while setting it false will move to the previous input.
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.
SystemId	String	R	This is a read only field that holds the Key Digital system id string, which provides release version information that may be useful.