Closes a relay specified by group, row, and column.
Gx6384Close (nHandle, nGroup, nRow, nColumn, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Handle to a GX6384 board. |
nGroup |
SHORT |
If the Switch Matrix is configured as two groups with 32 columns (default configuration) Group numbers are:0. GX6384_GROUP_A1. GX6384_GROUP_BIf the Switch Matrix is configured as one group with 64 columns the only Group is:0. GX6384_GROUP_A |
nRow |
SHORT |
Row numbers are:0. GX6384_ROW_0: row number 0 (all models).1. GX6384_ROW_1: row number 1 (all models).2. GX6384_ROW_2: row number 2 (models Gx6384-2 and Gx6384-3 only).3. GX6384_ROW_3: row number 3 (models Gx6384-2 and Gx6384-3 only).4. GX6384_ROW_4: row number 4 (Gx6384-3 only).5. GX6384_ROW_5: row number 5 (Gx6384-3 only). |
nColumn |
SHORT |
Specified column relay number is as follows:0-31: Switch Matrix is configured as two groups with 32 columns (default configuration).0-63: Switch Matrix is configured as single group with 64 columns. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The Switch Matrix can be configured via software as two groups with 32 columns or one group with 64 columns. The function closes the specified relay at the specified group’s row column. The function ensures that a proper delay is used from the last open command. This prevents 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. |
Note - In order to prevent power supply overloading the maximum number of all the relays that can be closed at any given time cannot exceed 128. The function returns an error if trying to exceed the limit. |
The following example closes relay at group A row 1 relay 0:
Gx6384Close(nHandle, GX6384_GROUP_A, GX6384_ROW_1, 0, &nStatus);
Gx6384SetGroupRow32Columns, Gx6384SetGroupRow64Columns, Gx6384GetChannel, Gx6384Open, Gx6384SetGroupsConfiguration, GxSWGetErrorString