Gx6384SetGroupRow64Columns

Purpose

Sets the state of all 64 relays of the specified group’s row when configured as one group with 64 columns.

Syntax

Gx6384SetGroupRow64Columns (nHandle, nGroup, nRow, dwStatesColumns32to63, dwStatesColumns0to31, pnStatus)

Parameters

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_A
1. GX6384_GROUP_B
If the Switch Matrix is configured as one group with 64 columns the only Group number 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).
dwStatesColumns32to63
DWORD
 
Returned state of relays 0-31 in the row. Each bit corresponds to a relay in the selected row where a ‘1’ corresponds to a closed relay and ‘0’ to an open relay. The low order bit represents column 0 and the high order bit represents the last column.
dwStatesColumns0to31
DWORD
Returned state of the relays 32-63 in the row. Each bit corresponds to a relay in the selected row where a ‘1’ corresponds to a closed relay and ‘0’ to an open relay. The low order bit represents column 0 and the high order bit represents the last column.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The Switch Matrix can be configured via software as two groups with 32 columns or one group with 64 columns. 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.

Use the Gx6384GetChannel function to retrieve the state of a specific relay.

NOTE: The function returns an error if the Switch Matrix is configured as one group with 64 columns.

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.

 

Example

The following example close relays 0, 1, 4, 8 and 19, 34, 36, 40-44, 63 in group A, row 0:

 

Gx6384SetGroupRow32Columns (nHandle, GX6384_ROW_0, 0x80001f14, 0x80113, &nStatus);

 

See Also

Gx6384SetGroupRow32Columns, Gx6384SetGroupRow64Columns, Gx6384GetChannel, Gx6384Close, Gx6384Open, Gx6384SetGroupsConfiguration, GxSWGetErrorString