Spectrum M3i.4830 Скачать руководство пользователя страница 42

Страница: 42 / 136

M3i.48xx / M3i.48xx-exp Manual

Driver functions

Software

recommended to use it. Otherwise the driver functions need to loaded from the dll using standard Windows functions. There is one example
in the example directory /examples/c_cpp/dll_loading that shows the process for 32 bit environments. The only line that needs to be mod-
ified is the one loading the DLL:

Example of function loading:

National Instruments LabWindows/CVI

Include Drivers

To use the Spectrum driver under LabWindows/CVI it is necessary to first load the functions from the driver dll. Please use the library file
spcm_win32_cvi.lib to access the driver functions.

Examples

Examples for LabWindows/CVI can be found on CD in the directory /examples/cvi. Please mix these examples with the standard C/C++
examples to have access to all functions and modes of the cards.

Driver functions

The driver contains seven main functions to access the hardware.

Own types used by our drivers

To simplify the use of the header files and our examples with different platforms and compilers and to avoid any implicit type conversions we
decided to use our own type declarations. This allows us to use platform independent and universal examples and driver interfaces. If you
do not stick to these declarations please be sure to use the same data type width. However it is strongly recommended that you use our defined
type declarations to avoid any hard to find errors in your programs. If you’re using the driver in an environment that is not natively supported
by our examples and drivers please be sure to use a type declaration that represents a similar data width

Notation of variables and functions

In our header files and examples we use a common and reliable form of notation for variables and functions. Each name also contains the
type as a prefix. This notation form makes it easy to see implicit type conversions and minimizes programming errors that results from using
incorrect types. Feel free to use this notation form for your programs also-

Function spcm_hOpen

This function initializes and opens an installed card supporting the new SpcM driver interface. At the time of printing this manual this are all
cards of the M2i/M3i/M4i cards and digitizerNETBOX devices. The function returns a handle that has to used for driver access. If the card
can’t be found or the loading of the driver generated an error the function returns a NULL. When calling this function all card specific instal-
lation parameters are read out from the hardware and stored within the driver. It is only possible to open one device by one software as
concurrent hardware access may be very critical to system stability. As a result when trying to open the same device twice an error will be
raised and the function returns NULL.

Function spcm_hOpen (char* szDeviceName):

Under Linux the device name in the function call need to be a valid device name. Please change the string according to the location of the
device if you don’t use the standard Linux device names. The driver is installed as default under /dev/spcm0, /dev/spcm1 and so on. The
kernel driver numbers the devices starting with 0.

hDLL = LoadLibrary ("spcm_win64.dll"); // Modified: Load the 64 bit version of the Spcm driver here
pfn_spcm_hOpen = (SPCM_HOPEN*) GetProcAddress (hDLL, "spcm_hOpen");
pfn_spcm_vClose = (SPCM_VCLOSE*) GetProcAddress (hDLL, "spcm_vClose");

Declaration

Type

Declaration

Type

int8

8 bit signed integer (range from -128 to +127)

uint8

8 bit unsigned integer (range from 0 to 255)

int16

16 bit signed integer (range from -32768 to 32767)

uint16

16 bit unsigned integer (range from 0 to 65535)