-------------------------------------------------------------------------------
Matrox Imaging Library (MIL) 10.0
Release Notes (mil4sight)
December, 2013
(c) Copyright Matrox Electronic Systems Ltd., 1992-2013.
-------------------------------------------------------------------------------
This document outlines what is new with MIL for Matrox 4Sight family products
and explains the current limitations and particularities when using MIL with
Matrox 4Sight family products. In particular, it documents how to convert code
that controls/inquires about the Matrox Auxiliary I/O signals on Matrox 4Sight
family products so that it uses the new MIL 10 mechanism.
It also presents last minute information that did not make it into the manual
or on-line help. Note that this text file serves to complement your manual. The
information found in this file overrides your formally documented material.
Contents
1. MIL 10 implementation changes
2. MIL 10 driver update for MtxAux
===============================================================================
1. MIL 10 implementation changes
MsysControl/MsysInquire
Old control/inquire type New control/inquire type
----------------------------------------------------+------------------
Control of an output Control of an output
M_USER_BIT_VALUE_OUT M_USER_BIT_STATE
+ [0...15] + M_USER_BIT[0...15]
M_USER_BIT_VALUE_OUT M_USER_BIT_STATE_ALL
+ M_BIT_MASK(bit encoded value)
Inquire of an output Inquire of an output
M_USER_BIT_VALUE_OUT M_USER_BIT_STATE
+ [0...15] + M_USER_BIT[0...15]
M_IO_STATUS
+ M_AUX_IO[0...15]
M_USER_BIT_VALUE_OUT M_USER_BIT_STATE_ALL
+ M_BIT_MASK(bit encoded value) Returns MIL_INT64
Possible value
M_OFF
M_ON
----------------------------------------------------+------------------
M_USER_BIT_INTERRUPT_MODE M_IO_INTERRUPT_ACTIVATION
+ [0...15] + M_AUX_IO[16...31]
Possible value
M_DEFAULT or M_EDGE_RISING
M_EDGE_FALLING
----------------------------------------------------+------------------
M_USER_BIT_INTERRUPT_STATE M_IO_INTERRUPT_STATE
+ [0...15] + M_AUX_IO[16...31]
Possible value
M_DEFAULT or M_DISABLE
M_ENABLE
----------------------------------------------------+------------------
MsysInquire
Old inquire type New inquire type
----------------------------------------------------+------------------
Inquire of an input Inquire of an input
M_USER_BIT_VALUE_IN M_IO_STATUS
+ [0...15] + M_AUX_IO[16...31]
M_USER_BIT_VALUE M_IO_STATUS_ALL
+ M_BIT_MASK(bit encoded value) Returns MIL_INT64
----------------------------------------------------+------------------
M_USER_BIT_COUNT M_AUX_IO_COUNT
M_USER_BIT_COUNT_IN M_AUX_IO_COUNT_IN
M_USER_BIT_COUNT_OUT M_AUX_IO_COUNT_OUT
----------------------------------------------------+------------------
Other changes
----------------------------------------------------+------------------
MsysHookFunction(SysId, Type, M_USER_BIT_CHANGE, HPtr, DPtr)
Replaced by
MsysHookFunction(SysId, Type, M_IO_CHANGE, HPtr, DPtr)
----------------------------------------------------+------------------
MsysGetHookInfo(SysId, EvId, M_USER_BIT, UPtr)
Replaced by
MsysGetHookInfo(SysId, EvId, M_IO_INTERRUPT_SOURCE, UPtr)
Value [0...15] return changed into M_AUX_IO[16...31]
----------------------------------------------------+------------------
MsysGetHookInfo(SysId, EvId, M_USER_BIT_STATE, UPtr)
Replaced by
MsysGetHookInfo(SysId, EvId, M_IO_STATUS, UPtr)
----------------------------------------------------+------------------
Addition
----------------------------------------------------+------------------
MsysControl/MsysInquire M_IO_MODE + M_AUX_IO[n]
Possible value
M_OUTPUT for n=0...15
M_INPUT for n=16...31
----------------------------------------------------+------------------
MsysControl/MsysInquire M_IO_FORMAT + M_AUX_IO[n]
Possible value
M_OPEN_DRAIN for n=0...15
M_OPTO for n=16...31
----------------------------------------------------+------------------
===============================================================================
2. MIL 10 driver update for MtxAux
MtxAux DU9V13 10.0.2629 – 2014/05/26
- Added support for DesignAssistant DA 4.0 on host system.
- Fix to support returning from 4Sight system sleep or hibernate mode.
MtxAux DU22V2 10.0.2679 – 2014/06/24
- Fix for file details report on MtxAux DLL
- Fix for memory corruption that may happen when using DesignAssistant 4.0 on host system.
MtxAux DU26V6 10.0.2767 – 2014/10/07 SVN#223289
- Added support for Advanced IOs
- MtxAux FPGA update to add support for RS485 half-duplex auto mode.
- MtxAux FPGA changed to limit AuxIO ouptut toggle rate of 61Khz maximum.
- Fix MtxAux in 4Sight-GP system for MsysControl M_IO_SOURCE+M_AUX_IOn set to M_USER_BITn or M_DEFAULT.
- Added support of MtxAux with 4Sight-GPm BT.