MsysControl

See also

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux with restrictions

Partially supported on:

Partially supported on Host system (a)

Partially supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Partially supported on Matrox Morphis (g)

Partially supported on Matrox Morphis QxT (h)

Partially supported on Matrox Orion HD (i)

Partially supported on Matrox Radient eCL (j)

Partially supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Partially supported on Matrox Solios eA/XA (l)

Partially supported on Matrox Solios ecl/xcl/ev-cl (m)

Partially supported on Matrox USB3 Vision driver (Update 19) (o)

Partially supported on Matrox RadientPro-CL (Update 7) (p)

Partially supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Partially supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Partially supported on Matrox Clarity UHD (Update 36 or 76) (u)

Partially supported on Matrox GenTL driver (Update 34) (v)

Partially supported on Matrox Indio (Update 53 or Update 68) (w)

Partially supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Partially supported on Matrox Concord PoE with ToE (Update 82) (z)

Partially supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Matrox 4Sight-X with restrictions

Available on Matrox Supersight with restrictions

Available on Non-Matrox computer with restrictions

Available on Matrox 4Sight GP/GPm

Function map

Examples

actiontrigger.cpp
gentl.cpp
morphischannelswitchingdlg.cpp
msysio.cpp
muart.cpp
triggeroverethernet.cpp

Function Map

- SysId

Table:

For the system identifier

- ControlType

- ControlValue

Parameter Associations

Table:	For general system settings
+ combination:	For specifying which connector or port to control
+ combination:	For specifying which configuration information file to access
+ combination:	For specifying whether Matrox Feature Browser should be synchronous or asynchronous
+ combination:	For specifying the number of hook threads
Table:	For routing I/O signals and setting their mode
+ combination:	For specifying the type and number of the I/O signal to affect
Table:	For setting the state of specified user-bits in a static-user-output register
+ combination:	For specifying the bit in a static-user-output register to affect
Table:	For controlling the settings of a timer
+ combination:	For specifying which on-board timer to control
Table:	For controlling the settings of a rotary decoder
+ combination:	For specifying which rotary decoder to set
Table:	For controlling the settings of a data latch associated with rotary encoders
+ combination:	For specifying which data latch to set
Table:	For UART settings
+ combination:	For specifying which UART to control
Table:	For Watchdog settings
Table:	For configuring and sending an action command to a GigE Vision camera
Table:	For specifying a Trigger-over-Ethernet packet (action command or GigE Vision software trigger) for transmission using a ToE module
+ combination:	For specifying which action command to control
+ combination:	For specifying which GigE Vision software trigger to control
+ combination:	For specifying which I/O command register bit to use

Remarks

Type-specific versions of the function when using a C compiler

Compilation information

Synopsis

Control a system setting.

Syntax

void MsysControl(

MIL_ID SysId,	//in
MIL_INT64 ControlType,	//in
MIL_DOUBLE ControlValue	//in

)

Description

This function allows you to control the specified system setting.

Note that, when a control type has only one supported control value on a given system, it is not documented in this function because it cannot be changed to another value. Instead, it can only be inquired.

To inquire the current value of a particular system setting, use MsysInquire().

You can also interactively control and test most of the system settings in real-time, using Matrox Intellicam's Feature Browser.

Note that when using a C compiler (not a C++ or other compiler), it is suggested to use the type-specific versions of this particular function, rather than the standard function prototype at the top of this page. An exhaustive list of type-specific versions of this function can be found at the bottom of this page.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

SysId

Specifies the system identifier. This parameter should be set to one of the following values:

For the system identifier
Value	Description
M_DEFAULT_HOST	Specifies the default Host system of the current MIL application.
MIL system identifier	Specifies a valid system identifier, previously allocated using MsysAlloc().

ControlType

Specifies the type of setting to control.

See the Parameter associations section for possible values that can be specified.

ControlValue

Specifies the new value to assign to the system setting specified by the ControlType parameter.

See the Parameter associations section for possible values that can be specified.

Parameter associations

The tables below list possible values for the ControlType and ControlValue parameters.

For general system settings
For routing I/O signals and setting their mode
For setting the state of specified user-bits in a static-user-output register
For controlling the settings of a timer
For controlling the settings of a rotary decoder
For controlling the settings of a data latch associated with rotary encoders
For UART settings
For Watchdog settings
For configuring and sending an action command to a GigE Vision camera
For specifying a Trigger-over-Ethernet packet (action command or GigE Vision software trigger) for transmission using a ToE module

The following control types allow you to control the general system settings.

For general system settings

ControlType

Description

MIL system-specific
tooltip (‡)

ControlValue

M_ALLOCATION_OVERSCAN

Sets whether image buffers, allocated on the system, are allocated by default with an overscan region. Specify the size of the overscan region using M_ALLOCATION_OVERSCAN_SIZE.

Note that you can override this setting when allocating a buffer using the M_ALLOCATION_OVERSCAN attribute. INQ

(summarize)

Sets whether image buffers, allocated on the system, are allocated by default with an overscan region. INQ

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DEFAULT

Same as M_ENABLE.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DISABLE

Specifies that image buffers allocated on the system will have no overscan region.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_ENABLE

Specifies that image buffers are allocated on the system with an overscan region.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_ALLOCATION_OVERSCAN_SIZE

Sets the size of the overscan region, added around all subsequently allocated image buffers (MbufAlloc...()). The overscan settings previously allocated image buffers are not changed. For more information, see the Buffer overscan region section of Chapter 21: Data buffers.

To enable or disable the allocation of an overscan region, change the setting of M_ALLOCATION_OVERSCAN. INQ

(summarize)

Sets the size of the overscan region, added around all subsequently allocated image buffers (MbufAlloc...()). INQ

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DEFAULT

Specifies the default size of the overscan region.

(summarize)

Specifies the default size of the overscan region.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

MIL system specific

The default size is 8 pixels.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

Value

Specifies the size of the overscan region, in pixels. For example, if you specify a size of 2, a 2-pixel overscan border is added around subsequently allocated image buffers.

(summarize)

Specifies the size of the overscan region, in pixels.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DEFAULT_PITCH_BYTE_MULTIPLE

Sets the pitch (or stride) multiple (in bytes) for the buffers allocated on the system. The pitch is the number of bytes between the beginnings of any two adjacent rows of the buffer's data. The pitch multiple is the factor by which the pitch of a buffer must be divisible. When a buffer is allocated, if the specified width is not a multiple of this value, padding is added to the buffer so that the buffer's pitch meets this constraint. You would typically change this value when you need to reduce the padding of your buffer.

Note that, allocating a buffer with an overscan region can also be a cause of buffer padding. For more information, refer to M_ALLOCATION_OVERSCAN and the Accessing a MIL buffer directly section of Chapter 21: Data buffers.

When dealing with an on-board operation, changing the pitch multiple might force on-board operations to be performed off-board due to hardware limitations, thereby increasing the amount of time the operation might take. INQ

(summarize)

Sets the pitch (or stride) multiple (in bytes) for the buffers allocated on the system. INQ

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DEFAULT

Specifies the default value for the pitch multiple. The default value is highly MIL system-dependent. Always inquire the current pitch multiple before setting it, using MsysInquire() with M_DEFAULT_PITCH_BYTE_MULTIPLE.

(summarize)

Specifies the default value for the pitch multiple.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

Value

Specifies the pitch multiple, in bytes.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_DEVICE_NAME

Sets a user-defined name for the board. The user-defined name is written to the board, making it persistent, and allows the board to be allocated using this user-defined name in the future. The name is typically assigned and written to the board from a separate executable that allocates a system for the board with M_DEVn and then calls MsysControl() with the control type (M_DEVICE_NAME).

This control type is also available for the Matrox Concord PoE base model.

(summarize)

Sets a user-defined name for the board.

(more details...)

‡

M_PTR_TO_DOUBLE(

MIL_CONST_TEXT_PTR String

)

Casts the address of the string specifying the board's name, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(summarize)

Casts the address of the string specifying the board's name, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(more details...)

‡

Parameters

String

This parameter specifies the string to cast.

‡

DeviceName

Specifies the name of the board. Note that this must be a unique name with a string that can be up to M_DEVICE_NAME_MAX_SIZE characters.

‡

M_GC_FEATURE_BROWSER +

[This is only applicable to Windows]

Sets whether to open or close a dialog box that allows you to view and edit the GenTL SFNC-compliant system and interface configuration information interactively, using Matrox Feature Browser.

(summarize)

[This is only applicable to Windows]

Sets whether to open or close a dialog box that allows you to view and edit the GenTL SFNC-compliant system and interface configuration information interactively, using Matrox Feature Browser.

(more details...)

‡

M_DEFAULT

Same as M_OPEN.

‡

M_CLOSE

Closes Matrox Feature Browser.

‡

M_OPEN +

Opens Matrox Feature Browser.

You must specify a combination value from the following table:

To set whether the Feature Browser should be synchronous or asynchronous

(summarize)

Opens Matrox Feature Browser.

(more details...)

‡

M_GC_FEATURE_EXECUTE_POLLING_MODE

Sets whether the executable feature is executed synchronously or asynchronously. INQ

(summarize)

Sets whether the executable feature is executed synchronously or asynchronously. INQ

(more details...)

‡

c
U25

M_DEFAULT

Same as M_MANUAL.

‡

c
U25

M_AUTOMATIC

Specifies that the specific executable camera feature is executed synchronously.

When in automatic mode, the executable feature is executed synchronously. MIL polls the feature to establish if the executable feature has completed, returning control only when the operation is complete. Get the polling interval using M...InquireFeature() with M_FEATURE_POLLING_INTERVAL.

(summarize)

Specifies that the specific executable camera feature is executed synchronously.

(more details...)

‡

c
U25

M_MANUAL

Specifies that the executable camera feature is executed asynchronously.

When in manual mode, the executable feature is executed asynchronously, and control is returned once the executable operation begins. To determine whether the executable feature completed, use M...InquireFeature() with M_FEATURE_EXECUTE_COMPLETED.

(summarize)

Specifies that the executable camera feature is executed asynchronously.

(more details...)

‡

c
U25

M_LED_USER

Sets the color of the user LED on your Matrox Iris GTR. INQ

(summarize)

Sets the color of the user LED on your Matrox Iris GTR. INQ

(more details...)

‡

t
U28

M_DEFAULT

Same as M_OFF.

‡

t
U28

M_GREEN

Specifies to turn the user LED green.

‡

t
U28

M_OFF

Specifies to turn the user LED off.

‡

t
U28

M_ORANGE

Specifies to turn the user LED orange.

‡

t
U28

M_RED

Specifies to turn the user LED red.

‡

t
U28

M_MODIFIED_BUFFER_HOOK_MODE

Sets whether to run user-defined functions hooked to a buffer modification on separate threads, up to the number of CPU cores present in the computer. This is particularly useful when functions are hooked using MdigProcess(). INQ

(summarize)

Sets whether to run user-defined functions hooked to a buffer modification on separate threads, up to the number of CPU cores present in the computer. INQ

(more details...)

‡

c
M10

k
M10

r
U27

u
U36

y
U75

M_DEFAULT

Same as M_SINGLE_THREAD.

‡

c
M10

k
M10

r
U27

u
U36

y
U75

M_MULTI_THREAD +

Specifies to run user-defined functions hooked to a buffer modification on separate threads. The hooked functions are executed by any available CPU core. MIL cannot guarantee the processing order of any image on such a computer, because they are executed concurrently. If required, use Microsoft Windows functions to synchronize the threads.

Note that by default, this control value will allocate, as necessary, up to 16 threads, or the total number of CPU cores in the computer, whichever is least.

(summarize)

Specifies to run user-defined functions hooked to a buffer modification on separate threads.

(more details...)

‡

c
M10

k
M10

r
U27

u
U36

y
U75

M_SINGLE_THREAD

Specifies that only one thread should be created and that all user-defined functions hooked to buffer modifications are run on the same thread.

‡

c
M10

k
M10

r
U27

u
U36

y
U75

M_POWER_OVER_CABLE +

Sets whether the board provides power to connected devices. INQ

(summarize)

Sets whether the board provides power to connected devices. INQ

(more details...)

‡

y
U84

MIL system specific

You must specify a combination value from the following table:

To specify which connector or port to control

‡

y
U75

For a Host system, this sets whether PoE (Power over Ethernet) is enabled on the specified port.

This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6.

On a Matrox 4Sight GPm or EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed. It is not available on a Matrox 4Sight GP.

‡

For Matrox Concorde POE, this sets whether PoE (Power over Ethernet) is enabled on all ports.

This control type is also available for the Matrox Concord PoE base model.

‡

For Matrox Rapixo CXP, this sets whether PoCXP (Power over CXP) is automatically enabled when a PoCXP-compliant camera is connected to the specified connector.

‡

y
U84

M_DEFAULT

Specifies the default value.

(summarize)

Specifies the default value.

(more details...)

‡

y
U84

MIL system specific

For Matrox 4sight GPm and EV6, the default value is set in the UEFI.

On legacy computers, this was referred to as a BIOS.

‡

For Matrox Concorde POE, this is the same as M_ON.

‡

For Matrox Rapixo CXP, this is the same as M_AUTOMATIC.

‡

y
U84

M_AUTOMATIC

Specifies to automatically enable or disable PoCXP on this CXP connector, depending on detected device support.

‡

y
U84

M_OFF

Specifies not to provide power to connected devices.

(summarize)

Specifies not to provide power to connected devices.

(more details...)

‡

y
U84

MIL system specific

For Matrox 4sight GPm and EV6, this specifies to disable PoE on the specified port.

‡

For Matrox Concorde POE, this specifies to disable PoE on all ports.

‡

For Matrox Rapixo CXP, this specifies to manually disable PoCXP on the specified CXP connector.

‡

y
U84

M_ON

Specifies to provide power to connected devices.

(summarize)

Specifies to provide power to connected devices.

(more details...)

‡

y
U84

MIL system specific

For Matrox 4sight GPm and EV6, this specifies to enable PoE on the specified port.

‡

For Matrox Concorde POE, this specifies to enable PoE on all ports.

‡

For Matrox Rapixo CXP, this specifies to manually disable PoCXP on the specified CXP connector.

You should typically use the default setting (M_AUTOMATIC) which specifies to automatically detect whether the connected camera supports PoCXP. If you manually enable PoCXP and connect a device that is not fully CXP-compliant, the device might be damaged.

‡

y
U84

M_RESET

Specifies to reset an over- or under-current condition. To learn whether there is an over- or under-current condition, use MsysInquire() with M_POWER_OVER_CABLE_STATUS.

Typically, to prevent the over- or under-current condition from immediately recurring, you should first restart PoCXP for this connector by setting this control type to M_OFF and then returning it to its previous setting (M_AUTOMATIC is recommended). If the condition persists, discontinue using PoCXP with your camera by leaving this control type set to M_OFF.

(summarize)

Specifies to reset an over- or under-current condition.

(more details...)

‡

y
U84

M_THREAD_MODE

Sets whether threads allocated on the system can execute in asynchronous mode.

If you specify that threads on the system can execute in asynchronous mode, the MthrControl() M_THREAD_MODE control type setting of each of its threads is taken into account; otherwise, their M_THREAD_MODE control type setting is ignored. INQ

(summarize)

Sets whether threads allocated on the system can execute in asynchronous mode. INQ

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

MIL system specific

This inquire type is also available for the Matrox Concord PoE base model.

‡

M_DEFAULT

Specifies the default value.

(summarize)

Specifies the default value.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

MIL system specific

Same as M_ASYNCHRONOUS.

‡

c
M10

k
M10

r
U27

u
U36

y
U75

Same as M_SYNCHRONOUS.

‡

t
U28

M_ASYNCHRONOUS

Specifies that threads allocated on the system can execute in asynchronous mode. In asynchronous mode, control is returned to the Host immediately after a MIL function is sent to the processor of the system (when the system and function allow an immediate return).

(summarize)

Specifies that threads allocated on the system can execute in asynchronous mode.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

M_SYNCHRONOUS

Specifies that threads allocated on the system can only execute in synchronous mode. In synchronous mode, the execution of a MIL function sent to the processor of a system must be completed (execution terminated) before returning control to the Host.

(summarize)

Specifies that threads allocated on the system can only execute in synchronous mode.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

w
U53

y
U75

M_TIMEOUT

Sets the maximum amount of time for the Host to wait for a synchronous function to return before generating a time-out error, in sec.

Note that this value only works with functions that are performed on-board, such as MbufCopy() when copying from (or to) on-board memory or functions using an on-board processing FPGA. INQ

(summarize)

Sets the maximum amount of time for the Host to wait for a synchronous function to return before generating a time-out error, in sec. INQ

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

MIL system specific

This inquire type is also available for the Matrox Concord PoE base model.

‡

M_DEFAULT

Specifies the default value.

(summarize)

Specifies the default value.

(more details...)

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

MIL system specific

The default value is 20 sec.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

Same as M_INFINITE.

‡

M_INFINITE

Waits indefinitely.

‡

t
U28

Value

Specifies the time to wait, in sec.

‡

c
M10

k
M10

r
U27

t
U28

u
U36

y
U75

Combination values for M_POWER_OVER_CABLE.

You must add one of the following values to the above-mentioned value to specify which connector or port to control.

For specifying which connector or port to control
Combination value	Description		MIL system-specific tooltip (‡)
M_ALL	Specifies to control all relevant connectors or ports on your board or industrial computer.		‡	a	y U84
M_CONNECTIONn	Specifies to control connector n, where n corresponds to a physical connector or port on your board or industrial computer. (summarize) Specifies to control connector n, where n corresponds to a physical connector or port on your board or industrial computer. (more details...)		‡	a	y U84
		MIL system specific
		For a Matrox 4sight GPm and EV6, n can be a value from 1 to 4, depending on the number of PoE-enabled Ethernet ports on the version of your industrial computer.	‡	a
		For Matrox Rapixo CXP, n can be a value from 0 to 3, depending on the number of CXP connectors on the version of your board.	‡		y U84

Combination values for M_GC_FEATURE_BROWSER.

You can add one of the following values to the above-mentioned value to specify which instance of the GenTL interface configuration file (XML file) is associated with the feature.

For specifying which configuration information file to access

Combination value

Description

MIL system-specific
tooltip (‡)

M_GENTL_INTERFACE_NUMBER(

MIL_INT IndexValue

)

Specifies which instance of the GenTL interface configuration file is associated with the feature.

(summarize)

Specifies which instance of the GenTL interface configuration file is associated with the feature.

(more details...)

‡

Parameters

IndexValue

Specifies the index of the GenTL interface configuration file.

‡

0 <= Value <=
MsysInquire(M_GENTL_INTERFACE_COUNT)

Specifies the index.

‡

M_GENTL_SYSTEM

Specifies to display the GenTL system configuration information.

‡

Combination values for M_OPEN (when ControlType=M_GC_FEATURE_BROWSER and ControlValue=M_OPEN).

You must add one of the following values to the above-mentioned value to set whether the Feature Browser should be synchronous or asynchronous.

For specifying whether Matrox Feature Browser should be synchronous or asynchronous
Combination value	Description	MIL system-specific tooltip (‡)
M_ASYNCHRONOUS	Specifies that this function returns immediately once Matrox feature browser window opens.	‡	v
M_SYNCHRONOUS	Specifies that this function is blocked until Matrox feature browser window closes.	‡	v

Combination value for M_MULTI_THREAD (when ControlType=M_MODIFIED_BUFFER_HOOK_MODE and ControlValue=M_MULTI_THREAD).

You can add the following value to the above-mentioned value to set the number of hook threads to allocate.

For specifying the number of hook threads
Combination value	Description	MIL system-specific tooltip (‡)
Value >= 1	Specifies the number of hook threads to allocate. Note that this value cannot exceed the number of CPU cores available. (summarize) Specifies the number of hook threads to allocate. (more details...)	‡	c M10	g	h	j	k M10	l	m	o	p	r U27	v	y U75	aa

The following control types allow you to set the mode and the routing of your Matrox imaging board's I/O signals (such as, auxiliary signal). Once the routing and mode are determined for an I/O signal, the MIL function that you should use to act upon an input signal or setup the source of an output signal depends on the functionality. For example, you can use MsysControl() with M_USER_BIT... control types, MdigControl() with M_GRAB_TRIGGER... control types, or MdigControl() with M_TIMER... control types.

Note that for other Matrox imaging boards that have auxiliary I/O signals, but are not supported with the constants below, see MdigControl().

Each Matrox imaging board and MIL driver has its own list of limitations regarding the signals you can control with this function. While general limitations are listed in the table below, for a complete list of the available signals and their limitations, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

For routing I/O signals and setting their mode
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_IO_DEBOUNCE_TIME +		Sets the amount of time that the specified auxiliary input signal is debounced. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets the amount of time that the specified auxiliary input signal is debounced. INQ (more details...)									‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] When a signal is debounced on Matrox 4Sight GPm, after detecting a valid input signal edge any other transitions are considered noise and are suppressed for the specified time, to ignore any additional transitions caused by the contact bounce of mechanical switches.	‡	a
			When a signal is debounced on Matrox Iris GTR, after detecting a valid input signal edge any other transitions are considered noise and are suppressed for the specified time, to ignore any additional transitions caused by the contact bounce of mechanical switches. To remove problems occurring at the edge of a signal, use M_IO_GLITCH_FILTER_STATE.	‡				t U28
	Value >= 0	Specifies the minimum amount of time to ignore any additional signal transitions after accepting a signal transition, in nsec. (summarize) Specifies the minimum amount of time to ignore any additional signal transitions after accepting a signal transition, in nsec. (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] In the case of Matrox 4Sight GPm (Ivy Bridge), the maximum value is 503316450. Note that the number must be a multiple of 30. In the case of Matrox 4Sight GPm (Bay Trail), the maximum value is 671088600. Note that the number must be a multiple of 40.	‡	a
			In the case of Matrox Iris GTR, the maximum value is 268435440. Note that the number must be a multiple of 16.	‡				t U28
M_IO_GLITCH_FILTER_STATE +		Sets whether to enable a glitch filter on input signals. A glitch is an unexpected signal transition of a short duration. Enabling the glitch filter will eliminate glitches of less than 500 nsec on all input signals. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets whether to enable a glitch filter on input signals. INQ (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a			t U28	w U53	z
	M_DISABLE	Specifies not to use a glitch filter.		‡	a			t U28	w U53	z
	M_ENABLE	Specifies to use a glitch filter.		‡	a			t U28	w U53	z
M_IO_INTERRUPT_ACTIVATION +		Sets the signal transition upon which to generate an interrupt, if interrupt generation has been enabled for the specified I/O signal. Use M_IO_INTERRUPT_STATE to enable interrupt generation. Note that this only applies to input signals. Note that this control type only has an effect when M_IO_INTERRUPT_STATE is enabled. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets the signal transition upon which to generate an interrupt, if interrupt generation has been enabled for the specified I/O signal. INQ (more details...)		‡	a	g	h	t U28	w U53	z
			MIL system specific
			This control type is only available with auxiliary I/O signals 3-6.	‡				t U28
			[This is only applicable to Matrox 4Sight GP/GPm platform] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	g	h	t U28	w U53	z
	M_ANY_EDGE	Specifies to generate an interrupt upon both a low-to-high and a high-to-low signal transition. (summarize) Specifies to generate an interrupt upon both a low-to-high and a high-to-low signal transition. (more details...)		‡	a			t U68	w U68
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 68 (or later) is installed. It is not available on a Matrox 4Sight GP. On a Matrox 4Sight EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed.	‡	a
	M_EDGE_FALLING	Specifies that an interrupt will be generated upon a high-to-low signal transition.		‡	a	g	h	t U28	w U53	z
	M_EDGE_RISING	Specifies that an interrupt will be generated upon a low-to-high signal transition.		‡	a	g	h	t U28	w U53	z
M_IO_INTERRUPT_STATE +		Sets whether to generate an interrupt upon the specified transition of the I/O signal. Use M_IO_INTERRUPT_ACTIVATION to specify the transition. Note that this only applies to input signals, or I/O signals set to input (using M_IO_MODE). INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets whether to generate an interrupt upon the specified transition of the I/O signal. INQ (more details...)		‡	a	g	h	t U28	w U53	z
			MIL system specific
			This control type is only available with auxiliary I/O signals 3-6.	‡				t U28
			[This is only applicable to Matrox 4Sight GP/GPm and Matrox 4Sight-X platforms] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	g	h	t U28	w U53	z
	M_DISABLE	Specifies not to generate an interrupt.		‡	a	g	h	t U28	w U53	z
	M_ENABLE	Specifies to generate an interrupt.		‡	a	g	h	t U28	w U53	z
M_IO_INVERTER +		Sets whether the specified I/O signal should be inverted. This causes the low portion of the signal (the delay period) to be high and the high portion of the signal (the active portion) to be low. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets whether the specified I/O signal should be inverted. INQ (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a			t U28	w U53	z
	M_DISABLE	Specifies not to invert the specified I/O signal.		‡	a			t U28	w U53	z
	M_ENABLE	Specifies to invert the specified I/O signal.		‡	a			t U28	w U53	z
M_IO_MODE +		Sets the mode of the specified I/O signal. Note that you can only change the mode of a bidirectional (I/O) signal. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets the mode of the specified I/O signal. INQ (more details...)		‡		g	h
	M_INPUT	Specifies that the signal is for input.		‡		g	h
	M_OUTPUT	Specifies that the signal is for output.		‡		g	h
M_IO_SOURCE +		Sets the type of signal to route to an output signal, or a bidirectional signal set to output mode. INQ You must specify a combination value from the following table: To set the type and number of the I/O signal to affect (summarize) Sets the type of signal to route to an output signal, or a bidirectional signal set to output mode. INQ (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm and Matrox 4Sight-X platforms] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.	‡	a
	M_DEFAULT	Same as M_USER_BITn.		‡	a			t U28	w U53	z
	M_EXPOSURE	Specifies to route the exposure signal of the camera.		‡				t U28
	M_GRAB_TRIGGER_READY	Specifies to route the internal grab trigger ready signal.		‡				t U28
	M_IO_COMMAND_LISTn +	Specifies to route a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. You must specify a combination value from the following table: To specify which I/O command register bit to use (summarize) Specifies to route a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For the Matrox 4Sight GPm, n can be either 1 or 2. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
			For Matrox Iris GTR, n must be 1.	‡				t U28
	M_ROTARY_ENCODERn	Specifies to route the output of rotary encoder n, where n is the number of rotary encoders available. (summarize) Specifies to route the output of rotary encoder n, where n is the number of rotary encoders available. (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For the Matrox 4Sight GPm, n can be either 1 or 2. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
			For Matrox Iris GTR, n must be 1.	‡				t U28
	M_TIMER_STROBE	Specifies to route the internal timer strobe signal.		‡				t U28
	M_TIMERn	Specifies to route the output of timer n, where n is the number of timers available. (summarize) Specifies to route the output of timer n, where n is the number of timers available. (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed. For the Matrox 4Sight GPm, n can be a value from 1 to 16. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
			For Matrox Iris GTR, n can be a value from 1 to 8.	‡				t U28
	M_USER_BITn	Specifies to route the state of bit n of the main static-user-output register, where n is the bit number. (summarize) Specifies to route the state of bit n of the main static-user-output register, where n is the bit number. (more details...)		‡	a			t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
			For Matrox Iris GTR, n can be a value from 0 to 2.	‡				t U28

Combination value for the values listed in For routing I/O signals and setting their mode.

You must add the following value to the above-mentioned values to set the type and number of the I/O signal to affect.

For specifying the type and number of the I/O signal to affect
Combination value	Description		MIL system-specific tooltip (‡)
M_AUX_IOn	Specifies to affect auxiliary signal n, where n is the signal number. For a list of the available auxiliary I/O signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or Matrox 4Sight. (summarize) Specifies to affect auxiliary signal n, where n is the signal number. (more details...)		‡	a	g	h	t U28	w U53	z
		MIL system specific
		[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a

The following control types and control values allow you to set the bits in a static-user-output register. You can route the bits to output signals or I/O signals set to output; to do so use M_IO_SOURCE with M_USER_BIT...). To establish which user-bits can be routed to a specific signal, see the connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board.

[Matrox 4Sight GP/GPm]

This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.

Note that for other Matrox imaging boards that have user-bits, but are not supported with the constants below, see MdigControl().

For setting the state of specified user-bits in a static-user-output register
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_USER_BIT_STATE +		Sets the state of the specified bit of a static-user-output register. INQ You must specify a combination value from the following table: To specify the bit in a static-user-output register to affect (summarize) Sets the state of the specified bit of a static-user-output register. INQ (more details...)									‡	a	g	h	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm and Matrox 4Sight-X platforms] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.	‡	a
	M_OFF	Specifies that the specified bit is set to off.		‡	a	g	h	t U28	w U53	z
	M_ON	Specifies that the specified bit is set to on.		‡	a	g	h	t U28	w U53	z
M_USER_BIT_STATE_ALL		Sets the state of all the bits in the main static-user-output register. INQ (summarize) Sets the state of all the bits in the main static-user-output register. INQ (more details...)		‡	a	g	h	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm and Matrox 4Sight-X platforms] This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight.	‡	a
	Value	Specifies a bit-encoded value that establishes the value of all the bits of the specified static-user-output register. It is recommended to specify the value in hexadecimal notation (0x), so that it is more legible to what you are setting each bit of the register. (summarize) Specifies a bit-encoded value that establishes the value of all the bits of the specified static-user-output register. (more details...)		‡	a	g	h	t U28	w U53	z

Combination value for M_USER_BIT_STATE.

You must add the following value to the above-mentioned value to specify the bit in a static-user-output register to affect.

For specifying the bit in a static-user-output register to affect
Combination value	Description	MIL system-specific tooltip (‡)
M_USER_BITn	Specifies to affect bit n of the main static-user-output register.	‡	a	g	h	t U28	w U53	z

The following control types and control values specify the settings for controlling timers and the signals generated from a timer (timer output signals). For more information, see the Timers and coordinating events section of Chapter 41: I/O signals and communicating with external devices.

For controlling the settings of a timer
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_TIMER_ARM +		Sets whether to enable the timer arming mechanism. If timer arming is enabled, then the timer will ignore its trigger signal (M_TIMER_TRIGGER_SOURCE) until a signal transition specified using M_TIMER_ARM_ACTIVATION occurs on the signal specified using M_TIMER_ARM_SOURCE. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets whether to enable the timer arming mechanism. INQ (more details...)							‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	t U28	w U53	z
	M_DISABLE	Specifies that timer arming is disabled.		‡	a	t U28	w U53	z
	M_ENABLE	Specifies that timer arming is enabled.		‡	a	t U28	w U53	z
M_TIMER_ARM_ACTIVATION +		Sets the signal transition upon which to arm the timer, if timer arming is enabled. Use M_TIMER_ARM to enable timer arming. Use M_TIMER_ARM_SOURCE to set which input signal will arm the timer. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the signal transition upon which to arm the timer, if timer arming is enabled. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies that the timer will be armed by both a high-to-low and a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies that the timer will be armed upon a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies that the timer will be armed upon a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_LEVEL_HIGH	Specifies that a timer is continuously armed during a high signal polarity.		‡	a	t U28	w U53	z
	M_LEVEL_LOW	Specifies that a timer is continuously armed during a low signal polarity.		‡	a	t U28	w U53	z
M_TIMER_ARM_SOFTWARE +		Issues a software trigger to arm the timer. To use this setting, the timer's arm source must be set to software (M_TIMER_ARM_SOURCE set to M_SOFTWARE). You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Issues a software trigger to arm the timer. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_ACTIVATE	Specifies the default behavior.		‡	a	t U28	w U53	z
M_TIMER_ARM_SOURCE +		Sets which input signal will arm the timer, if timer arming is enabled. Use M_TIMER_ARM to enable timer arming. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets which input signal will arm the timer, if timer arming is enabled. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_AUX_IOn	Specifies to use auxiliary input signal n as the source signal used to arm the specified timer, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the source signal used to arm the specified timer, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_EXPOSURE	Specifies to use the exposure signal as the trigger source.		‡		t U28
	M_GRAB_TRIGGER_READY	Specifies to route the internal grab trigger ready signal to the specified signal.		‡		t U28
	M_SOFTWARE	Specifies to use software to arm the specified timer.		‡	a	t U28	w U53	z
	M_TIMER_STROBE	Specifies to route the strobe's timer signal to the specified signal.		‡		t U28
	M_TIMERn	Specifies to use the output signal of the specified timer as the source signal to arm the timer, where n is the timer number. (summarize) Specifies to use the output signal of the specified timer as the source signal to arm the timer, where n is the timer number. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 1 to 16.	‡	a
			With Matrox Iris GTR, n can be a value from 1 to 8.	‡		t U28
M_TIMER_CLOCK_ACTIVATION +		Sets the edge of the signal that will increment the clock used to control the active portion of the timer's output signal. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the edge of the signal that will increment the clock used to control the active portion of the timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies that the clock will be incremented by both a high-to-low and a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies that the clock will be incremented by a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies that the clock will be incremented by a low-to-high signal transition.		‡	a	t U28	w U53	z
M_TIMER_CLOCK_FREQUENCY +		Sets the frequency of the clock source signal for the active portion of the timer's output signal (M_TIMER_CLOCK_SOURCE). Note that if M_TIMER_CLOCK_SOURCE is set to M_AUX_IOn or M_ROTARY_ENCODERn, and no clock source frequency is specified, the values that are normally specified or returned in units of time will be in number of ticks (clock signal transitions on the clock source). If M_TIMER_CLOCK_SOURCE is set to M_SYSCLK, changing the frequency to any value different than the system clock's frequency will cause an error. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the frequency of the clock source signal for the active portion of the timer's output signal (M_TIMER_CLOCK_SOURCE). INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_UNKNOWN	Specifies that the signal is not periodic or the frequency is unknown.		‡	a	t U28	w U53	z
	0 < Value <= Frequency of M_SYSCLK	Specifies the frequency, in Hz.		‡	a	t U28	w U53	z
M_TIMER_CLOCK_SOURCE +		Sets the source of the clock that drives the active portion of the specified timer's output signal. The clock source used for the delay can be different from the clock source used for the active portion of the timer's output signal. This is useful, for example, if you want to specify the delay in signal transitions and the active portion in nsec. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the source of the clock that drives the active portion of the specified timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_SYSCLK.		‡	a	t U28	w U53	z
	M_AUX_IOn	Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. If the signal is periodic, specify its frequency using M_TIMER_CLOCK_FREQUENCY. (summarize) Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value of 8 to 15.	‡	a		w U53	z
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_ROTARY_ENCODERn	Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. If the signal is periodic, specify its frequency using M_TIMER_CLOCK_FREQUENCY. (summarize) Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be 1 or 2.	‡	a
			With Matrox Iris GTR, n must be 1.	‡		t U28
	M_SYSCLK	Specifies to use the allocated system's clock source.		‡	a	t U28	w U53	z
M_TIMER_DELAY +		Sets the delay between the timer trigger and the active portion of the timer's output signal. Note, an error is generated if the specified delay cannot be respected. The clock source used for the delay can be different from the clock source used for the active portion of the timer's output signal. This is useful, for example, if you want to specify the delay in signal transitions and the active portion in nsec. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the delay between the timer trigger and the active portion of the timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	0 <= Value <= Max. value	Specifies the delay. If M_TIMER_DELAY_CLOCK_SOURCE is set to M_SYSCLK or a frequency is specified using M_TIMER_DELAY_CLOCK_FREQUENCY, this value is specified in nsec. Otherwise, it is specified in number of clock ticks (signal transitions on the clock source). Use MsysInquire() to determine the maximum possible value. (summarize) Specifies the delay. (more details...)		‡	a	t U28	w U53	z
M_TIMER_DELAY_CLOCK_ACTIVATION +		Sets the signal transition that will increment the clock used to control the delay between the timer's trigger and the active portion of the timer's output signal. If M_TIMER_DELAY_CLOCK_SOURCE is set to M_FOLLOW_TIMER_CLOCK, changing this setting to a value different than the value of M_TIMER_CLOCK_ACTIVATION will cause an error. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the signal transition that will increment the clock used to control the delay between the timer's trigger and the active portion of the timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies that the clock will be incremented by both a high-to-low and a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies that the clock will be incremented by a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies that the clock will be incremented by a low-to-high signal transition.		‡	a	t U28	w U53	z
M_TIMER_DELAY_CLOCK_FREQUENCY +		Sets the frequency of the clock source signal for the delay between the timer's trigger and the active portion of the timer's output signal (M_TIMER_DELAY_CLOCK_SOURCE). Note that if M_TIMER_DELAY_CLOCK_SOURCE is set to M_AUX_IOn or M_ROTARY_ENCODERn, and no clock source frequency is specified, the values that are normally specified or returned in units of time will be in number of ticks. If M_TIMER_DELAY_CLOCK_SOURCE is set to M_SYSCLK, changing the frequency to any value different than system clock's frequency will cause an error. If M_TIMER_DELAY_CLOCK_SOURCE is set to M_FOLLOW_TIMER_CLOCK, changing the frequency to a value different than the value of M_TIMER_CLOCK_FREQUENCY will cause an error. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the frequency of the clock source signal for the delay between the timer's trigger and the active portion of the timer's output signal (M_TIMER_DELAY_CLOCK_SOURCE). INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_UNKNOWN	Specifies that the signal is not periodic or the frequency is unknown.		‡	a	t U28	w U53	z
	0 < Value <= Frequency of M_SYSCLK	Specifies the frequency, in Hz.		‡	a	t U28	w U53	z
M_TIMER_DELAY_CLOCK_SOURCE +		Sets the source of the clock that drives the delay between the timer's trigger and the active portion of the specified timer's output signal. The clock source used for the delay can be different from the clock source used for the active portion of the timer's output signal. This is useful, for example, if you want to specify the delay in signal transitions and the active portion in nsec. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the source of the clock that drives the delay between the timer's trigger and the active portion of the specified timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_FOLLOW_TIMER_CLOCK.		‡	a	t U28	w U53	z
	M_AUX_IOn	Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a		w U53	z
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_FOLLOW_TIMER_CLOCK	Specifies to use the clock source specified by M_TIMER_CLOCK_SOURCE. If the clock source is set to this value and M_TIMER_CLOCK_SOURCE is changed, this clock source changes as well. Additionally, any changes to M_TIMER_CLOCK_ACTIVATION and M_TIMER_CLOCK_FREQUENCY will also be reflected in M_TIMER_DELAY_CLOCK_ACTIVATION and M_TIMER_DELAY_CLOCK_FREQUENCY. (summarize) Specifies to use the clock source specified by M_TIMER_CLOCK_SOURCE. (more details...)		‡	a	t U28	w U53	z
	M_ROTARY_ENCODERn	Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. (summarize) Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be 1 or 2.	‡	a
			With Matrox Iris GTR, n must be 1.	‡		t U28
	M_SYSCLK	Specifies to use the allocated system's clock source.		‡	a	t U28	w U53	z
M_TIMER_DURATION +		Sets the duration for the active portion of the timer's output signal. Note, an error is generated if the specified duration cannot be respected. The clock source used for the delay can be different from the clock source used for the active portion of the timer's output signal. This is useful, for example, if you want to specify the delay in signal transitions and the active portion in nsec. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the duration for the active portion of the timer's output signal. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	0 <= Value <= Max. value	Specifies the duration of the active portion of the timer output signal. If M_TIMER_CLOCK_SOURCE is set to M_SYSCLK or a frequency is specified using M_TIMER_CLOCK_FREQUENCY, this value is specified in nsec. Otherwise, it is specified in number of clock ticks (signal transitions on the clock source). Use MsysInquire() to determine the maximum possible value. (summarize) Specifies the duration of the active portion of the timer output signal. (more details...)		‡	a	t U28	w U53	z
M_TIMER_OUTPUT_INVERTER +		Sets whether the output of the timer should be inverted. This causes the low portion of the signal (the delay period) to be high and the high portion of the signal (the active portion) to be low. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets whether the output of the timer should be inverted. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	t U28	w U53	z
	M_DISABLE	Specifies not to invert the output of the timer.		‡	a	t U28	w U53	z
	M_ENABLE	Specifies to invert the output of the timer.		‡	a	t U28	w U53	z
M_TIMER_STATE +		Sets the state of the specified timer. When a timer is enabled, the timer waits for a trigger to be received. To set the source of the trigger, use M_TIMER_TRIGGER_SOURCE. Once the trigger is received, the timer starts by outputting a low signal. This lasts for the duration of the delay period (set using M_TIMER_DELAY). The timer then changes to output a high signal for the duration of the active period (set using M_TIMER_DURATION). To invert this signal, use M_TIMER_OUTPUT_INVERTER. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the state of the specified timer. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	t U28	w U53	z
	M_DISABLE	Specifies that the timer is disabled.		‡	a	t U28	w U53	z
	M_ENABLE	Specifies that the timer is enabled.		‡	a	t U28	w U53	z
M_TIMER_TRIGGER_ACTIVATION +		Sets the signal variation upon which to generate a timer trigger. The timer will be triggered when the specified signal transition occurs on the source signal specified by M_TIMER_TRIGGER_SOURCE. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the signal variation upon which to generate a timer trigger. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies that a timer trigger will be generated both upon a high-to-low and a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies that a timer trigger will be generated upon a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies that a timer trigger will be generated upon a low-to-high signal transition.		‡	a	t U28	w U53	z
	M_LEVEL_HIGH	Specifies that a timer trigger is continuously issued during a high signal polarity.		‡	a	t U28	w U53	z
	M_LEVEL_LOW	Specifies that a timer trigger is continuously issued during a low signal polarity.		‡	a	t U28	w U53	z
M_TIMER_TRIGGER_OVERLAP +		Sets how to deal with a new trigger that occurs while the associated timer has not yet expired (both its delay and duration). INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets how to deal with a new trigger that occurs while the associated timer has not yet expired (both its delay and duration). INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 51 (or later) is installed. It is not available on a Matrox 4Sight GP.	‡	a
	M_DEFAULT	Same as M_OFF.		‡	a	t U28	w U53	z
	M_LATCH	Specifies that a trigger received, while the associated timer has not expired, will be latched (stored). As soon as the current timer expires, a new trigger is issued by software. (summarize) Specifies that a trigger received, while the associated timer has not expired, will be latched (stored). (more details...)		‡	a	t U28	w U53	z
	M_OFF	Specifies that a new trigger is ignored.		‡	a	t U28	w U53	z
	M_RESET	Specifies that a new trigger automatically resets the timer (regardless of whether it is in its delay or active period) and then restarts the timer. This process will repeat for each new trigger received. (summarize) Specifies that a new trigger automatically resets the timer (regardless of whether it is in its delay or active period) and then restarts the timer. (more details...)		‡	a	t U28	w U53	z
M_TIMER_TRIGGER_SOFTWARE +		Issues a software trigger for the specified timer. To use this setting, the timer's trigger source must be set to software (M_TIMER_TRIGGER_SOURCE set to M_SOFTWARE). You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Issues a software trigger for the specified timer. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_ACTIVATE	Specifies the default behavior.		‡	a	t U28	w U53	z
M_TIMER_TRIGGER_SOURCE +		Sets the trigger source for the specified timer. The timer will be triggered when the signal transition specified using M_TIMER_TRIGGER_ACTIVATION occurs on the selected source. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the trigger source for the specified timer. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_AUX_IOn	Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value of 8 to 15.	‡	a
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_CONTINUOUS	Specifies to run the specified timer in periodic mode; no actual trigger signal is used. The timer is automatically reset after the timer's duration expires. The timer loops between a delay and an active period. (summarize) Specifies to run the specified timer in periodic mode; no actual trigger signal is used. (more details...)		‡	a	t U28	w U53	z
	M_EXPOSURE	Specifies to use the exposure signal as the trigger source.		‡		t U28
	M_GRAB_TRIGGER_READY	Specifies to route the internal grab trigger ready signal to the specified signal.		‡		t U28
	M_IO_COMMAND_LISTn +	Specifies to use a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. You must specify a combination value from the following table: To specify which I/O command register bit to use (summarize) Specifies to use a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be either 1 or 2.	‡	a
			With Matrox Iris GTR, n must be 1.	‡		t U28
	M_ROTARY_ENCODERn	Specifies to use rotary decoder n as the trigger source, where n is the number of the rotary decoder. (summarize) Specifies to use rotary decoder n as the trigger source, where n is the number of the rotary decoder. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For a Host system, you must be using a Matrox 4Sight GPm unit.	‡	a
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be 1 or 2.	‡	a
			For Matrox Iris GTR, n must be 1.	‡		t U28
	M_SOFTWARE	Specifies to use a software trigger as the trigger source. Use M_TIMER_TRIGGER_SOFTWARE to issue the trigger. (summarize) Specifies to use a software trigger as the trigger source. (more details...)		‡	a	t U28	w U53	z
	M_TIMER_STROBE	Specifies to route the strobe's timer signal to the specified signal.		‡		t U28
	M_TIMERn	Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number. (summarize) Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value of 1 to 16.	‡	a
			With Matrox Iris GTR, n can be a value from 1 to 8.	‡		t U28
M_TIMER_USAGE +		Sets the purpose of the timer. INQ You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Sets the purpose of the timer. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_PULSE_GENERATION.		‡	a	t U28	w U53	z
	M_PULSE_GENERATION	Specifies the normal use of the timer, as described in the Timers and coordinating events section of Chapter 41: I/O signals and communicating with external devices.		‡	a	t U28	w U53	z
	M_PULSE_MEASUREMENT	Specifies to use the timer to measure the duration of the pulse that occurs on the timer's trigger source. Note that when in this mode, the values set using M_TIMER_DELAY_CLOCK_SOURCE, M_TIMER_DELAY, and M_TIMER_DURATION are ignored. When a timer is set in this mode, the duration of pulses that occur on the timer's trigger source (M_TIMER_TRIGGER_SOURCE) are measured with respect to the timer's clock source (M_TIMER_CLOCK_SOURCE). To measure active-high pulses, set M_TIMER_TRIGGER_ACTIVATION to M_LEVEL_HIGH; to measure active-low pulses, set M_TIMER_TRIGGER_ACTIVATION to M_LEVEL_LOW. The duration of the pulse can be inquired using MsysInquire() with M_TIMER_VALUE. Between pulses, you can reset the timer value using MsysControl() with M_TIMER_VALUE. (summarize) Specifies to use the timer to measure the duration of the pulse that occurs on the timer's trigger source. (more details...)		‡	a	t U28	w U53	z
M_TIMER_VALUE +		Resets the timer value. You must specify a combination value from the following table: To specify which on-board timer to control (summarize) Resets the timer value. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	0	Specifies to reset the timer value to 0.		‡	a	t U28	w U53	z

Combination value for the values listed in For controlling the settings of a timer.

You must add the following value to the above-mentioned values to specify which on-board timer to control.

For specifying which on-board timer to control
Combination value	Description		MIL system-specific tooltip (‡)
M_TIMERn	Specifies on-board timer n, where n is the number of the timer. To set the exposure and strobe timers, use MdigControl() with M_EXPOSURE_TIME or M_TIMER_STROBE, respectively. (summarize) Specifies on-board timer n, where n is the number of the timer. (more details...)		‡	a	t U28	w U53	z
		MIL system specific
		[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed. For Matrox 4Sight GPm, n can be a value from 1 to 16.	‡	a
		For Matrox Iris GTR, n can be a value from 1 to 8.	‡		t U28

The following control types allow you to control the settings of a quadrature decoder with inputs from a rotary or linear encoder.

For controlling the settings of a rotary decoder
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_ROTARY_ENCODER_BIT0_SOURCE +		Sets the auxiliary input signal on which to receive bit 0 of the 2-bit Gray code. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the auxiliary input signal on which to receive bit 0 of the 2-bit Gray code. INQ (more details...)							‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_AUX_IOn	Specifies to use auxiliary input signal n as the signal on which to receive bit 0 of the 2-bit Gray code, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the signal on which to receive bit 0 of the 2-bit Gray code, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
M_ROTARY_ENCODER_BIT1_SOURCE +		Sets the auxiliary input signal on which to receive bit 1 of the 2-bit Gray code. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the auxiliary input signal on which to receive bit 1 of the 2-bit Gray code. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a		w U53	z
	M_AUX_IOn	Specifies to use auxiliary input signal n as the signal on which to receive bit 1 of the 2-bit Gray code, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the signal on which to receive bit 1 of the 2-bit Gray code, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
M_ROTARY_ENCODER_OUTPUT_MODE +		Sets the rotary decoder's counter value and/or the direction of movement upon which the rotary decoder should output a pulse. The pulse can be used to trigger a timer. To trigger a timer, set M_TIMER_TRIGGER_SOURCE to M_ROTARY_ENCODERn. To decimate (subsample) the rotary decoder output signal before sending it to a timer or a grab controller, set this control type to M_POSITION_TRIGGER and set M_ROTARY_ENCODER_POSITION_TRIGGER to the required decimation value. For more information, refer to the Pixel aspect ratio subsection of the Using quadrature input from a rotary encoder section of Chapter 41: I/O signals and communicating with external devices. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the rotary decoder's counter value and/or the direction of movement upon which the rotary decoder should output a pulse. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_POSITION_TRIGGER	Specifies to output a pulse upon the trigger generated by M_ROTARY_ENCODER_POSITION_TRIGGER.		‡	a	t U28	w U53	z
	M_STEP_ANY	Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction).		‡	a	t U28	w U53	z
	M_STEP_BACKWARD	Specifies to output a pulse upon a rotary decoder counter decrement only.		‡	a	t U28	w U53	z
	M_STEP_FORWARD	Specifies to output a pulse upon a rotary decoder counter increment only.		‡	a	t U28	w U53	z
	M_STEP_FORWARD_NEW_POSITIVE	Specifies to output a pulse upon a rotary decoder counter increment of a new value that has not been reached before. For example, if the counter value is at 10, and is decremented down to 7, the rotary decoder will only output a pulse when the counter is incremented up to 11. (summarize) Specifies to output a pulse upon a rotary decoder counter increment of a new value that has not been reached before. (more details...)		‡	a	t U28	w U53	z
M_ROTARY_ENCODER_POSITION_TRIGGER +		Sets the value of the rotary decoder's counter upon which a trigger is generated. You can output this trigger to a timer or a grab controller using M_ROTARY_ENCODER_OUTPUT_MODE set to M_POSITION_TRIGGER. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the value of the rotary decoder's counter upon which a trigger is generated. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	0 <= Value <= 0xFFFFFFFF	Specifies the value of the counter upon which a trigger is generated. If a value beyond the supported range is specified, an error is generated. If you are treating the counter values as a signed range of values (for example, forcing the counter to reset to 0 at 0x80000000) and you want to generate a trigger upon a negative value, specify the equivalent value in the range of 0x80000000 to 0xFFFFFFFF. (summarize) Specifies the value of the counter upon which a trigger is generated. (more details...)		‡	a	t U28	w U53	z
M_ROTARY_ENCODER_RESET_ACTIVATION +		Sets the signal transition upon which to reset the rotary decoder's counter to 0. The rotary decoder will reset the counter to 0 when the signal transition occurs on the source signal specified by M_ROTARY_ENCODER_RESET_SOURCE. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the signal transition upon which to reset the rotary decoder's counter to 0. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies to reset the rotary decoder upon a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies to reset the rotary decoder upon a low-to-high signal transition.		‡	a	t U28	w U53	z
M_ROTARY_ENCODER_RESET_SOURCE +		Sets the source signal to use to reset the rotary decoder's counter to 0. The rotary decoder will reset the counter to 0 when the signal transition specified using M_ROTARY_ENCODER_RESET_ACTIVATION occurs on the selected source. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets the source signal to use to reset the rotary decoder's counter to 0. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_NULL	Specifies not to reset using a hardware signal source.		‡	a	t U28	w U53	z
	M_AUX_IOn	Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. (summarize) Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] With Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a
			With Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_POSITION_TRIGGER	Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER.		‡	a	t U28	w U53	z
M_ROTARY_ENCODER_STATE +		Sets whether to enable the rotary decoder. INQ You must specify a combination value from the following table: To specify which rotary decoder to set (summarize) Sets whether to enable the rotary decoder. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	t U28	w U53	z
	M_DISABLE	Specifies that the rotary decoder is disabled.		‡	a	t U28	w U53	z
	M_ENABLE	Specifies that the rotary decoder is enabled.		‡	a	t U28	w U53	z

Combination value for the values listed in For controlling the settings of a rotary decoder.

You must add the following value to the above-mentioned values to specify which rotary decoder to set.

For specifying which rotary decoder to set
Combination value	Description		MIL system-specific tooltip (‡)
M_ROTARY_ENCODERn	Specifies rotary decoder n, where n is the number of the rotary decoder. (summarize) Specifies rotary decoder n, where n is the number of the rotary decoder. (more details...)		‡	a	t U28	w U53	z
		MIL system specific
		[This is only applicable to Matrox 4Sight GP/GPm platform] For a Host system, you must be using a Matrox 4Sight GPm computer. For Matrox 4Sight GPm, n can be 1 or 2. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a

The following control types allow you to control the settings of a data latch associated with the rotary decoders of your system.

For controlling the settings of a data latch associated with rotary encoders
ControlType		Description	MIL system-specific tooltip (‡)
	ControlValue	Description
M_SYS_DATA_LATCH_STATE +		Sets the state of the specified data latch. This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6. On a Matrox 4Sight GPm or EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed. It is not available on a Matrox 4Sight GP. INQ You must specify a combination value from the following table: To specify which data latch to affect (summarize) Sets the state of the specified data latch. INQ (more details...)			‡	a
	M_DEFAULT	Same as M_DISABLE.	‡	a
	M_DISABLE	Specifies that the data latch is disabled.	‡	a
	M_ENABLE	Specifies that the data latch is enabled. The data latch will store the position couner value of the rotary encoder when its associated event (specified using M_SYS_DATA_LATCH_TRIGGER_ACTIVATION) occurs. (summarize) Specifies that the data latch is enabled. (more details...)	‡	a
M_SYS_DATA_LATCH_TRIGGER_ACTIVATION +		Sets the trigger signal transition upon which to store the specified information to the specified data latch. To set the signal with which to trigger the data latch, use M_SYS_DATA_LATCH_TRIGGER_SOURCE. This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6. On a Matrox 4Sight GPm or EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed. It is not available on a Matrox 4Sight GP. INQ You must specify a combination value from the following table: To specify which data latch to affect (summarize) Sets the trigger signal transition upon which to store the specified information to the specified data latch. INQ (more details...)	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.	‡	a
	M_ANY_EDGE	Specifies that the specified information is stored in the data latch both upon a high-to-low and a low-to-high signal transition.	‡	a
	M_EDGE_FALLING	Specifies that the specified information is stored in the data latch upon a high-to-low signal transition.	‡	a
	M_EDGE_RISING	Specifies that the specified information is stored in the data latch upon a low-to-high signal transition.	‡	a
M_SYS_DATA_LATCH_TRIGGER_SOURCE +		Sets what triggers storing the specified information to the specified data latch. This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6. On a Matrox 4Sight GPm or EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed. It is not available on a Matrox 4Sight GP. INQ You must specify a combination value from the following table: To specify which data latch to affect (summarize) Sets what triggers storing the specified information to the specified data latch. INQ (more details...)	‡	a
	M_AUX_IOn	Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal. In this case, n can be a value from 8 to 15. To specify the signal transition, use M_SYS_DATA_LATCH_TRIGGER_ACTIVATION. (summarize) Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal. (more details...)	‡	a
	M_TIMERn	Specifies to use the output signal of timer n as the trigger source, where n is the number of the timer. In this case, n can be a value from 1 to 16. (summarize) Specifies to use the output signal of timer n as the trigger source, where n is the number of the timer. (more details...)	‡	a
M_SYS_DATA_LATCH_TYPE +		Sets which rotary decoder the specified data latch will store the position counter value of when the data latch is triggered. You can access the stored rotary decoder position within a hook function that was triggered by an auxiliary input or a timer, using MsysGetHookInfo() with M_SYS_DATA_LATCH_VALUE. This constant is only available on a Host system if the Host system has been allocated on a Matrox 4Sight GPm or EV6. On a Matrox 4Sight GPm or EV6 platform, this value is only available if MIL 10 update 86 (or later) is installed. It is not available on a Matrox 4Sight GP. INQ You must specify a combination value from the following table: To specify which data latch to affect (summarize) Sets which rotary decoder the specified data latch will store the position counter value of when the data latch is triggered. INQ (more details...)	‡	a
	M_ROTARY_ENCODERn	Specifies to store the value of the counter of rotary decoder n, where n is a number between 1 and 2. To configure the rotary decoder, use the M_ROTARY_ENCODER... control types. (summarize) Specifies to store the value of the counter of rotary decoder n, where n is a number between 1 and 2. (more details...)	‡	a

Combination value for the values listed in For controlling the settings of a data latch associated with rotary encoders.

You must add the following value to the above-mentioned values to specify which data latch to affect.

For specifying which data latch to set
Combination value	Description	MIL system-specific tooltip (‡)
M_LATCHn	Specifies which data latch to affect, where n is 1 or 2.	‡	a

The following control types and control values specify the settings for UARTs. To specify a particular UART, see the For specifying which UART to control combination value below.

Note that for other Matrox imaging boards that have a UART, but are not supported with the constants below, see MdigControl().

For UART settings
ControlType		Description	MIL system-specific tooltip (‡)
	ControlValue	Description
M_UART_DATA_SIZE +		Sets the number of data bits per character that are sent or received by the UART. INQ (summarize) Sets the number of data bits per character that are sent or received by the UART. INQ (more details...)									‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Same as 8.	‡	g	j	l	m	p	r U27	aa
	7	Specifies that the data length is 7 bits.	‡	g	j	l	m	p	r U27	aa
	8	Specifies that the data length is 8 bits.	‡	g	j	l	m	p	r U27	aa
M_UART_FREE +		Stops all MIL UART operations and frees all UART resources used by MIL. (summarize) Stops all MIL UART operations and frees all UART resources used by MIL. (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Specifies the default behavior.	‡	g	j	l	m	p	r U27	aa
M_UART_PARITY +		Sets whether character data is sent or received with a parity bit and how the parity bit is set. The parity bit is an extra data bit (0 or 1) that is added to each character for error checking purposes. INQ (summarize) Sets whether character data is sent or received with a parity bit and how the parity bit is set. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Same as M_DISABLE.	‡	g	j	l	m	p	r U27	aa
	M_DISABLE	Specifies that no extra bit is added (no parity).	‡	g	j	l	m	p	r U27	aa
	M_EVEN	Specifies that the number of 1's will be even.	‡	g	j	l	m	p	r U27	aa
	M_ODD	Specifies that the number of 1's will be odd.	‡	g	j	l	m	p	r U27	aa
M_UART_READ_CHAR +		Reads one character from the UART input buffer. If the input buffer is empty, the function will wait for the amount of time specified by M_UART_TIMEOUT. If a time-out occurs, the '?' character will be returned. (summarize) Reads one character from the UART input buffer. (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the address of the variable in which to save the character read from the UART.	‡	g	j	l	m	p	r U27	aa
M_UART_READ_STRING +		Reads a string of incoming data from the UART. The number of characters to read can be specified with M_UART_READ_STRING_SIZE or M_UART_STRING_DELIMITER. M_UART_TIMEOUT specifies the maximum time to wait between each byte when reading incoming data. Use MsysInquire() with M_UART_BYTES_READ to wait for the read operation to complete and retrieve the actual number of bytes read. (summarize) Reads a string of incoming data from the UART. (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the address of the character array in which to save the string read from the UART. The size of this array must be set to the same value as the M_UART_READ_STRING_MAXIMUM_SIZE control type. (summarize) Specifies the address of the character array in which to save the string read from the UART. (more details...)	‡	g	j	l	m	p	r U27	aa
M_UART_READ_STRING_MAXIMUM_SIZE +		Sets the maximum length of the string to read. This prevents global protection faults from happening when using the M_UART_READ_STRING control type. INQ (summarize) Sets the maximum length of the string to read. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the maximum length of the string, in bytes.	‡	g	j	l	m	p	r U27	aa
M_UART_READ_STRING_SIZE +		Sets the length of the string to read using M_UART_READ_STRING. INQ (summarize) Sets the length of the string to read using M_UART_READ_STRING. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Specifies the use of M_UART_STRING_DELIMITER to delineate the end of the string to read.	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the string length, in bytes.	‡	g	j	l	m	p	r U27	aa
M_UART_SPEED +		Sets the baud rate of the UART. INQ (summarize) Sets the baud rate of the UART. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Specifies the default value; the default value is 14400.	‡	g	j	l	m	p	r U27	aa
	300;600;1200;1800;2400;4800;7200;9600;14400; 19200;38400;57600;115200	Specifies the baud rate of the UART. Note that the maximum baud rate is highly dependent on the amount of computer resources available. (summarize) Specifies the baud rate of the UART. (more details...)	‡	g	j	l	m	p	r U27	aa
M_UART_STOP_BITS +		Sets the number of extra data bit(s) (1 or 2) that are added to each character to indicate the end of the character. INQ (summarize) Sets the number of extra data bit(s) (1 or 2) that are added to each character to indicate the end of the character. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Same as 1.	‡	g	j	l	m	p	r U27	aa
	1	Specifies that there is 1 stop bit.	‡	g	j	l	m	p	r U27	aa
	2	Specifies that there are 2 stop bits.	‡	g	j	l	m	p	r U27	aa
M_UART_STRING_DELIMITER +		Sets the character used to terminate strings of incoming or outgoing data. The delimiter is used but not sent when writing data with M_UART_WRITE_STRING; it is read for incoming data with M_UART_READ_STRING. INQ (summarize) Sets the character used to terminate strings of incoming or outgoing data. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Specifies the default value; the default value is '\0'.	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the character used to terminate strings.	‡	g	j	l	m	p	r U27	aa
M_UART_TIMEOUT +		Sets the maximum time to wait between each byte when reading incoming data. INQ (summarize) Sets the maximum time to wait between each byte when reading incoming data. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Same as M_INFINITE.	‡	g	j	l	m	p	r U27	aa
	M_INFINITE	Waits indefinitely.	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the time to wait, in msec.	‡	g	j	l	m	p	r U27	aa
M_UART_WRITE_CHAR +		Sends one character to the UART for transmission. (summarize) Sends one character to the UART for transmission. (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the character to send.	‡	g	j	l	m	p	r U27	aa
M_UART_WRITE_STRING +		Sends a string of data through the UART for transmission. The number of characters to send can be specified with M_UART_WRITE_STRING_SIZE or M_UART_STRING_DELIMITER. Use MsysInquire() with M_UART_BYTES_WRITTEN to wait for the write operation to complete and retrieve the actual number of bytes written. (summarize) Sends a string of data through the UART for transmission. (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the character array.	‡	g	j	l	m	p	r U27	aa
M_UART_WRITE_STRING_SIZE +		Sets the length of the string to be sent to the UART for transmission. INQ (summarize) Sets the length of the string to be sent to the UART for transmission. INQ (more details...)	‡	g	j	l	m	p	r U27	aa
	M_DEFAULT	Specifies the use of M_UART_STRING_DELIMITER to end the string. The delimiter will not be sent through the UART. (summarize) Specifies the use of M_UART_STRING_DELIMITER to end the string. (more details...)	‡	g	j	l	m	p	r U27	aa
	Value	Specifies the string length, in bytes.	‡	g	j	l	m	p	r U27	aa

Combination value for the values listed in For UART settings.

You can add the following value to the above-mentioned values to set which UART to control.

For specifying which UART to control

Combination value

Description

MIL system-specific
tooltip (‡)

M_UART_NB(

MIL_INT DeviceToControl

)

Specifies which UART to control.

Use MsysInquire() with M_UART_PRESENT to determine the number of UARTS on the system.

(summarize)

Specifies which UART to control.

(more details...)

‡

r
U27

Parameters

DeviceToControl

Specifies a device (UART) to control.

‡

r
U27

M_DEVn

Specifies the device to control, where n can be from 0 and 15.

‡

r
U27

MIL system specific

There is 1 UART available on Matrox Morphis.

‡

There are 4 UARTs available on Matrox Solios eA/XA Quad, 2 on Matrox Solios eA/XA Dual, and 1 on Matrox Solios eA/XA Single.

‡

There are 2 UARTs available on Matrox Solios eCL/XCL dual-Base/single-Medium operating in dual-Base mode, and 1 is available on Matrox Solios eCL/XCL-B, eCL/XCL-F, and eCL/XCL dual-Base/single-Medium operating in single-Medium mode.

‡

r
U27

There are 2 UARTS available on Matrox Radient eCL-DB and eCL-DF, 3 on Matrox Radient eCL-QB, and 1 on Matrox Radient eCL-SF. Note that, using the CLProtocol will occupy one COM port per allocated digitizer.

‡

r
U27

The following control types and control values specify the settings for the Watchdog.

For Watchdog settings
ControlType		Description	MIL system-specific tooltip (‡)
	ControlValue	Description
M_WATCHDOG_MODE		Sets the current state of the Watchdog. INQ (summarize) Sets the current state of the Watchdog. INQ (more details...)				‡	g	h
	M_DEFAULT	Same as M_DISABLE.	‡	g	h
	M_DISABLE	Disables the Watchdog.	‡	g	h
	M_ENABLE	Enables the Watchdog. The application should be ready to reset the Watchdog and all timeouts (M_WATCHDOG_REBOOT_TIMEOUT & M_WATCHDOG_TIMEOUT) should be programmed before enabling the Watchdog. (summarize) Enables the Watchdog. (more details...)	‡	g	h
M_WATCHDOG_REBOOT_TIMEOUT		Sets the timeout value of the Watchdog's reboot timer. If, during a reboot, the Host computer does not reset the Watchdog reboot timer before the specified interval expires, the Host computer is assumed to have hung. The Watchdog's reboot timer will then force the Host computer to reboot again. INQ (summarize) Sets the timeout value of the Watchdog's reboot timer. INQ (more details...)	‡	g	h
	Value	Specifies the timeout value, in msec.	‡	g	h
M_WATCHDOG_RESET		Resets the Watchdog main, reboot, and warning timers. (summarize) Resets the Watchdog main, reboot, and warning timers. (more details...)	‡	g	h
	M_DEFAULT	Implements the default behavior.	‡	g	h
M_WATCHDOG_RESET_COUNTER		Clears the "number of reboots" counter that counts the number of times the Watchdog has rebooted your Host computer. Note that this count includes both reboots caused by the reboot timer and the main timer. (summarize) Clears the "number of reboots" counter that counts the number of times the Watchdog has rebooted your Host computer. (more details...)	‡	g	h
	M_DEFAULT	Implements the default behavior.	‡	g	h
M_WATCHDOG_TIMEOUT		Sets the timeout value of the Watchdog's main timer. If, during the course of regular operations, the Host computer does not reset the main timer before the specified interval expires, it is assumed to have hung. The Watchdog's main timer will then force the Host computer to reboot. To receive a warning before the reboot, you can set the Watchdog's warning timer, using M_WATCHDOG_WARNING_TIME. When the Watchdog's warning timer expires, an interrupt is generated to warn you to reset the Watchdog's main timer. You can hook a function to this interrupt using MsysHookFunction(). Set the Watchdog's main timer to a value greater than that of the Watchdog's warning timer to allow enough time for the interrupt to be generated. INQ (summarize) Sets the timeout value of the Watchdog's main timer. INQ (more details...)	‡	g	h
	Value	Specifies the timeout value, in msec.	‡	g	h
M_WATCHDOG_WARNING_TIME		Sets the timeout value of the Watchdog's warning timer. If, during the course of regular operations, the Host computer does not reset the warning timer before the specified interval expires, the Host computer is assumed to have hung. The Watchdog's warning timer will then generate a warning interrupt. You can hook a function to this interrupt using MsysHookFunction(). The warning timeout value should be less than M_WATCHDOG_TIMEOUT to give the computer enough time to finish the hooked function. INQ (summarize) Sets the timeout value of the Watchdog's warning timer. INQ (more details...)	‡	g	h
	M_INFINITE	Specifies that the Watchdog will never receive a warning.	‡	g	h
	Value	Specifies the warning time interval, in msec.	‡	g	h

The following control types and control values allow you to configure an action command and send it to one or more GigE Vision cameras. Action commands require both a MIL-side and a camera-side configuration. The following control types and control values configure the MIL-side of the action command. To configure the camera-side, use MdigControlFeature() with the appropriate feature values. For more information, refer to the Triggering simultaneous actions in multiple GigE Vision cameras section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes.

To configure features of the camera, use MdigControlFeature() with a digitizer allocated for the camera on a MIL GigE system.

For configuring and sending an action command to a GigE Vision camera
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_GC_ACTION_ACKNOWLEDGE_NUMBER +		Sets the number of acknowledgments that MIL should expect to receive when the action command is issued. There should be one per target camera performing the action. By default, this number is equal to the number of MIL digitizers added to the action command. If the number of MIL digitizers added to the action command does not equal the number of MIL digitizers that will perform the action (that is, if you set the M_GC_ACTION_GROUP_MASK to mask out one or more cameras), MIL will return an error. To avoid this error, use this control type to set the number of acknowledgments that MIL should expect. INQ You must specify a combination value from the following table: To set which action command to control (summarize) Sets the number of acknowledgments that MIL should expect to receive when the action command is issued. INQ (more details...)					‡	c U25
	M_DEFAULT	Specifies the number of cameras added to the action command, using M_GC_ACTION_ADD_DEVICE.		‡	c U25
	Value	Specifies the number of acknowledgments expected.		‡	c U25
M_GC_ACTION_ADD_DEVICE +		Adds a GigE Vision camera to the list of cameras associated with the action command. You must specify a combination value from the following table: To set which action command to control (summarize) Adds a GigE Vision camera to the list of cameras associated with the action command. (more details...)		‡	c U25
	MIL digitizer identifier	Specifies the digitizer identifier allocated for the GigE Vision camera to add. Note that the digitizer should be allocated on a MIL GigE Vision system using MdigAlloc(). (summarize) Specifies the digitizer identifier allocated for the GigE Vision camera to add. (more details...)		‡	c U25
M_GC_ACTION_CLEAR_DEVICES +		Removes all cameras from the list of cameras associated with the action command. You must specify a combination value from the following table: To set which action command to control (summarize) Removes all cameras from the list of cameras associated with the action command. (more details...)		‡	c U25
	M_DEFAULT	Specifies the default behavior.		‡	c U25
M_GC_ACTION_DEVICE_KEY +		Sets the action device key for the action command. The action device key identifies the cameras on which the action should be performed. For the camera to accept and perform the action, the device key on your camera and the device key of the action command must match. If they do not match, the camera ignores the action command. To configure the device key on your camera, use MdigControlFeature() with the appropriate GenICam SFNC feature (for example, ActionDeviceKey). INQ You must specify a combination value from the following table: To set which action command to control (summarize) Sets the action device key for the action command. INQ (more details...)		‡	c U25	z
			MIL system specific
			To configure features of the camera, use MdigControlFeature() with a digitizer allocated for the camera on a MIL GigE system. If using a MIL Concord PoE system, this control type is only available for Matrox Concord PoE with ToE. To configure an action command for the Matrox Concord PoE base model, use a MIL GigE system with this control type.	‡		z
	Value	Specifies the action device key.		‡	c U25	z
M_GC_ACTION_EXECUTE +		Issues the action command. You must specify a combination value from the following table: To set which action command to control (summarize) Issues the action command. (more details...)		‡	c U25
	M_DEFAULT	Specifies the default behavior.		‡	c U25
M_GC_ACTION_GROUP_KEY +		Sets the action group key for the action command. The action group key identifies the action you want to perform on the camera. For the camera to know which action signal to generate, the group key of the action command must match the group key on your camera. If they do not match, the camera ignores the action command. To configure the group key of the action command on your camera, use MdigControlFeature() with the appropriate GenICam SFNC feature (for example, ActionGroupKey). INQ You must specify a combination value from the following table: To set which action command to control (summarize) Sets the action group key for the action command. INQ (more details...)		‡	c U25	z
			MIL system specific
			To configure features of the camera, use MdigControlFeature() with a digitizer allocated for the camera on a MIL GigE system. If using a MIL Concord PoE system, this control type is only available for Matrox Concord PoE with ToE. To configure an action command for the Matrox Concord PoE base model, use a MIL GigE system with this control type.	‡		z
	Value	Specifies the action group key.		‡	c U25	z
M_GC_ACTION_GROUP_MASK +		Sets the action group mask for the action command. In the case where you need one (or more) cameras to temporarily ignore an action command, you can mask out the action command for the camera by changing the action group mask. For the camera to know if it generates an action signal upon receiving the command, the action group mask of the action command, and the action group mask of the camera, when combined in a bitwise AND operation, must result in a non-zero value. If the result is a zero, the camera ignores the action command. Note that, if you are masking out the action command for the camera, you must change the number of action acknowledgment packets MIL should expect; otherwise, MIL will generate an error. To set the number of action acknowledgment packets, use M_GC_ACTION_ACKNOWLEDGE_NUMBER. INQ You must specify a combination value from the following table: To set which action command to control (summarize) Sets the action group mask for the action command. INQ (more details...)		‡	c U25	z
			MIL system specific
			To configure features of the camera, use MdigControlFeature() with a digitizer allocated for the camera on a MIL GigE system. If using a MIL Concord PoE system, this control type is only available for Matrox Concord PoE with ToE. To configure an action command for the Matrox Concord PoE base model, use a MIL GigE system with this control type.	‡		z
	Value	Specifies the action group mask.		‡	c U25	z
M_GC_ACTION_REMOVE_DEVICE +		Removes a MIL GigE Vision camera from the list of cameras associated with the action command. You must specify a combination value from the following table: To set which action command to control (summarize) Removes a MIL GigE Vision camera from the list of cameras associated with the action command. (more details...)		‡	c U25
	MIL digitizer identifier	Specifies the digitizer identifier for the GigE Vision camera to remove. Note that the digitizer should be allocated on a MIL GigE Vision system using MdigAlloc(). (summarize) Specifies the digitizer identifier for the GigE Vision camera to remove. (more details...)		‡	c U25
M_GC_ACTION_TIME +		Sets the time at which the action command should execute. Note that, for scheduled action commands to function, your camera must be capable of using IEEE 1588, and the appropriate feature must be enabled (for example, GevIEEE1588). To verify the availability of these features on your camera, use MdigInquire() with M_GC_CONTROL_PROTOCOL_CAPABILITY. It should return M_GC_SCHEDULED_ACTION_SUPPORT or M_GC_IEEE_1588_SUPPORT. Note that, you must enable 1588 on each GigE Vision camera that will receive this action command, using MdigControlFeature(), or Matrox Feature Browser (accessible through MsysControl() with M_GC_FEATURE_BROWSER) and the appropriate SFNC feature (for example, GevIEEE1588). INQ You must specify a combination value from the following table: To set which action command to control (summarize) Sets the time at which the action command should execute. INQ (more details...)		‡	c U25
	Value	Specifies the time at which to execute the action command on your camera, relative to the time at which the action command was sent, in sec.		‡	c U25

The following control types and control values allow you to configure a Trigger-over-Ethernet packet for transmission using a ToE module. The Trigger-over-Ethernet packet can be sent as an action command or a GigE Vision software trigger. Action commands and GigE Vision software triggers require both a MIL-side and a camera-side configuration. The following control types and control values configure the MIL-side of the action command or GigE Vision software trigger. To configure the camera-side, you need to use a digitizer allocated for the camera on a MIL GigE system (MsysAlloc() with M_SYSTEM_GIGE_VISION) and use MdigControlFeature() with the appropriate feature values. For more information, refer to the Triggering simultaneous actions in multiple GigE Vision cameras section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes.

For specifying a Trigger-over-Ethernet packet (action command or GigE Vision software trigger) for transmission using a ToE module

ControlType

Description

MIL system-specific
tooltip (‡)

ControlValue

M_ADD_DESTINATION +

Adds a GigE Vision camera to the list of cameras associated with the specified action command or GigE Vision software trigger.

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Adds a GigE Vision camera to the list of cameras associated with the specified action command or GigE Vision software trigger.

(more details...)

‡

MIL digitizer identifier

Specifies the digitizer identifier allocated for the GigE Vision camera to add. Note that the digitizer should be allocated on a GigE Vision system using MdigAlloc().

(summarize)

Specifies the digitizer identifier allocated for the GigE Vision camera to add.

(more details...)

‡

M_CLEAR_DESTINATIONS +

Removes all cameras from the list of cameras associated with the specified action command or GigE Vision software trigger.

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Removes all cameras from the list of cameras associated with the specified action command or GigE Vision software trigger.

(more details...)

‡

M_DEFAULT

Specifies the default behavior.

‡

M_GC_TRIGGER_SELECTOR +

Sets the type of GigE Vision software trigger that should take place on the camera upon receiving the ToE packet (for example, FrameStart). For the camera to know what should be triggered upon receiving the packet, this control type must match the trigger selector on your camera. To configure the trigger selector on your camera, use MdigControlFeature() with the appropriate GenICam SFNC feature (for example, TriggerSelector).

You must specify a combination value from the following table:

To set which GigE Vision software trigger to control

(summarize)

Sets the type of GigE Vision software trigger that should take place on the camera upon receiving the ToE packet (for example, FrameStart).

(more details...)

‡

M_PTR_TO_DOUBLE(

MIL_CONST_TEXT_PTR String

)

Casts the address of the string specifying the trigger type, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(summarize)

Casts the address of the string specifying the trigger type, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(more details...)

‡

Parameters

String

This parameter specifies the string to cast.

‡

MIL_TEXT("FeatureName") ¹

Specifies the type of trigger; see your GigE Vision camera's documentation for a list of available types.

‡

M_REMOVE_DESTINATION +

Removes a GigE Vision camera from the list of cameras associated with the specifies action command or GigE Vision software trigger.

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Removes a GigE Vision camera from the list of cameras associated with the specifies action command or GigE Vision software trigger.

(more details...)

‡

MIL digitizer identifier

Specifies the digitizer identifier allocated for the GigE Vision camera to remove. Note that the digitizer should be allocated on a GigE Vision system using MdigAlloc().

(summarize)

Specifies the digitizer identifier allocated for the GigE Vision camera to remove.

(more details...)

‡

M_TRIGGER_COMMAND +

Issues a software trigger event to prompt the transmission of the specified action command or GigE Vision software trigger from the ToE module. To use this control type, M_TRIGGER_SOURCE must be set to M_SOFTWAREn.

Note that this will trigger any action command or GigE Vision software trigger that uses the same software signal (M_SOFTWAREn) as the specified action command/GigE Vision software trigger. For example, if you specify M_TRIGGER_COMMAND + M_GC_ACTION1 and the trigger source of M_GC_ACTION1 is M_SOFTWARE1, all ToE packets that use M_SOFTWARE1 are triggered.

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Issues a software trigger event to prompt the transmission of the specified action command or GigE Vision software trigger from the ToE module.

(more details...)

‡

M_ACTIVATE

Specifies the default behavior.

‡

M_TRIGGER_SOURCE +

Sets the event that will cause the ToE module to send the specified action command or GigE Vision software trigger as a ToE packet. INQ

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Sets the event that will cause the ToE module to send the specified action command or GigE Vision software trigger as a ToE packet. INQ

(more details...)

‡

M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal.

In this case, n can be a value from 0 to 5.

(summarize)

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal.

(more details...)

‡

M_IO_COMMAND_LISTn +

Specifies to use the I/O command list n, where n is the number of the I/O command list.

In this case, n can be a value from 0 to 1.

You must specify a combination value from the following table:

To specify which I/O command register bit to use

(summarize)

Specifies to use the I/O command list n, where n is the number of the I/O command list.

(more details...)

‡

M_ROTARY_ENCODERn

Specifies to use rotary decoder n as the trigger source, where n is the number of the rotary decoder.

In this case, n can be a value from 1 to 2.

(summarize)

Specifies to use rotary decoder n as the trigger source, where n is the number of the rotary decoder.

(more details...)

‡

M_SOFTWAREn

Specifies to use software as a trigger source to trigger the ToE module, where n is the number of the software trigger; n can be a value between 1 and 4. Use M_TRIGGER_COMMAND to issue the software trigger event.

In this case, n can be a value from 1 to 4.

(summarize)

Specifies to use software as a trigger source to trigger the ToE module, where n is the number of the software trigger; n can be a value between 1 and 4.

(more details...)

‡

M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source, where n is the number of the timer.

In this case, n can be a value from 1 to 16.

(summarize)

Specifies to use the output signal of the specified timer as the trigger source, where n is the number of the timer.

(more details...)

‡

M_TRIGGER_STATE +

Sets the state of the specified action command or GigE Vision software trigger in the ToE module. INQ

You must specify a combination value from one of the following tables:

To set which GigE Vision software trigger to control
To set which action command to control

(summarize)

Sets the state of the specified action command or GigE Vision software trigger in the ToE module. INQ

(more details...)

‡

M_DISABLE

Specifies the ToE packet is disabled.

‡

M_ENABLE

Specifies the ToE packet is enabled, and will be transmitted when its associated event (specified using M_TRIGGER_SOURCE) occurs.

‡

¹ If you are passing the value in a variable, don't enclose it in MIL_TEXT().

Combination value for the values listed in For configuring and sending an action command to a GigE Vision camera (exceptions might exist); the values listed in For specifying a Trigger-over-Ethernet packet (action command or GigE Vision software trigger) for transmission using a ToE module (exceptions might exist).

You must add the following value to the above-mentioned values to set which action command to control. Alternatively, you can add a value from For specifying which GigE Vision software trigger to control.

For specifying which action command to control
Combination value	Description		MIL system-specific tooltip (‡)
M_GC_ACTIONn	Specifies to control action command n, where n is a value from 0 to 31. (summarize) Specifies to control action command n, where n is a value from 0 to 31. (more details...)		‡	c U25	z
		MIL system specific
		If using this control type with Matrox Concord PoE with ToE, it cannot be used with M_GC_TRIGGER_SELECTOR.	‡		z

Combination value for the values listed in For specifying a Trigger-over-Ethernet packet (action command or GigE Vision software trigger) for transmission using a ToE module.

You must add the following value to the above-mentioned values to set which GigE Vision software trigger to control. Alternatively, you can add a value from For specifying which action command to control.

For specifying which GigE Vision software trigger to control
Combination value	Description	MIL system-specific tooltip (‡)
M_GC_TRIGGER_SOFTWAREn	Specifies to control a GigE Vision software trigger n, where n is a value from 0 to 31. This combination value cannot be used with M_GC_ACTION_DEVICE_KEY, M_GC_ACTION_GROUP_KEY, or M_GC_ACTION_GROUP_MASK. (summarize) Specifies to control a GigE Vision software trigger n, where n is a value from 0 to 31. (more details...)	‡	z

Combination value for M_IO_COMMAND_LISTn (when ControlType=M_IO_SOURCE and ControlValue=M_IO_COMMAND_LISTn); M_IO_COMMAND_LISTn (when ControlType=M_TIMER_TRIGGER_SOURCE and ControlValue=M_IO_COMMAND_LISTn); M_IO_COMMAND_LISTn (when ControlType=M_TRIGGER_SOURCE and ControlValue=M_IO_COMMAND_LISTn).

You must add the following value to the above-mentioned values to specify which I/O command register bit to use.

For specifying which I/O command register bit to use
Combination value	Description		MIL system-specific tooltip (‡)
M_IO_COMMAND_BITn	Specifies I/O command register bit n, where n represents the bit number. (summarize) Specifies I/O command register bit n, where n represents the bit number. (more details...)		‡	a	t U28	w U53	z
		MIL system specific
		[This is only applicable to Matrox 4Sight GP/GPm platform] For Matrox 4Sight GPm, n can be a value from 0 to 7. On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 26 (or later) is installed.	‡	a
		With Matrox Iris GTR, n can be a value from 0 to 4.	‡		t U28
		With Matrox Concord PoE with ToE, n can be a value from 0 to 7.	‡			w U53	z

Remark

[Host system]

[Matrox 4Sight GP/GPm]

Note that M_IO... and the M_USER_BIT... control types are available on 4Sight GP, even without any additional Matrox imaging boards, unless otherwise specified. For more information on auxiliary signals, refer to the the Matrox 4Sight GP connectors and signal names section of the Matrox 4Sight GP chapter in the MIL Hardware-specific Notes of the MIL Hardware-specific Notes.

Type-specific versions of the function when using a C compiler

void MsysControlDouble (MIL_ID SysId, MIL_INT64 ControlType, MIL_DOUBLE ControlValue)

Details

Parameters

SysId

See SysId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

void MsysControlInt64 (MIL_ID SysId, MIL_INT64 ControlType, MIL_INT64 ControlValue)

Details

Parameters

SysId

See SysId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

Compilation information

Header	Include mil.h.
Library	Use mil.lib.
DLL	Requires mil.dll.