Gx6377MatrixClose

Purpose

Closes a relay specified by group, row, and column.

Syntax

Gx6377MatrixClose (nHandle, nGroup, nRow, dwColumn, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX6377 board.
nGroup
SHORT
If the Switch Matrix is configured as two groups of 2x16 (default configuration) Group numbers are:
  • GX6377_GROUP_A
  • GX6377_GROUP_B
If the Switch Matrix is configured as one group of 2x32 the only Group number is:
  • GX6377_GROUP_A
nRow
SHORT
Row numbers are:
  • GX6377_ROW_0
  • GX6377_ROW_1
dwColumn
DWORD
If the Switch Matrix is configured as two groups of 2x16 (default configuration) Column numbers are 0 to 15.
If the Switch Matrix is configured as one group of 2x32 the only Column numbers are 0 to 31.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The Switch Matrix can be configured via software as two groups of 2x16 or one group of 2x32. All the Switch Matrix channels will be opened prior to applying the new configuration settings. Applying the same configuration settings will not change the current group’s channels settings.

The function closes the specified relay. The function ensures that a proper delay (one millisecond) is used from the last open command. This prevents a relay being closed before a previous switching command is complete.

Caution - The flexibility provided by the switch matrix means that any point could be connected to any other point. Extreme care should be observed when developing the control software to prevent shorts between low-impedance sources (such as power supplies). A typical method to prevent such shorts is to use a resistor in series between the power supplies and the switch matrix if these signals are for measurement purposes only. Before closing a relay, verify that no other low-impedance source is connected to the same Row/Column.

 

Example

The following example closes relay at group A row 1 relay 0:

 

Gx6377MatrixClose(nHandle, GX6377_GROUP_A, GX6377_ROW_1, 0, &nStatus);

 

See Also

Gx6377Initialize, Gx6377MatrixOpen, Gx6377MatrixSetRow, Gx6377MatrixGetChannel