Multichannel Systems nanoZ manual User Manual

Page 27

Advertising
background image

23

Function  descriptions  

getversion

Returns the version of the nanoz MEX file.

Usage: [major_version, minor_version] = nanoz(‘getversion’);

Arguments: none.

Return values: major_version, minor_version – major and minor versions of the
currently installed nanoz MEX file, respectively.

enumdevs

Enumerates attached nanoZ devices.

Usage: devs = nanoz(‘enumdevs’);

Arguments: none.

Return value: devs – cell array of strings, one string per each attached device,
containing the device-specific serial numbers.

Remarks: If a device is attached but already opened by this MEX file, or another
application, it will not be enumerated.

An empty cell array is returned if no devices are attached or available.

open

Opens and allocates a free nanoZ device for access by other functions.

Usage: handle = nanoz(‘open’, serial_number, buffer_transfer_size);

Arguments: serial_number – string, device serial number, which can be obtained
using the enumdevs function; buffer_transfer_size – packet size, in bytes, for
incoming data stream, range 32~1024.

Return value: handle – number, handle to the opened device to be used to access
all other device functions.

Remarks: If a nanoZ device with a given serial number is not attached, or is
already opened by this MEX file or another application, this function will fail. The
buffer_transfer_size determines the temporal resolution of the plating mode. 64 is a
good default value, however on slower machines this may need to be increased

Advertising