Added a temporary fix for the DAQ2 board.
acozma
parent
c3b79abd6c
commit
9281e0c660
|
|
@ -0,0 +1,701 @@
|
|||
% Copyright 2014(c) Analog Devices, Inc.
|
||||
%
|
||||
% All rights reserved.
|
||||
%
|
||||
% Redistribution and use in source and binary forms, with or without modification,
|
||||
% are permitted provided that the following conditions are met:
|
||||
% - Redistributions of source code must retain the above copyright
|
||||
% notice, this list of conditions and the following disclaimer.
|
||||
% - Redistributions in binary form must reproduce the above copyright
|
||||
% notice, this list of conditions and the following disclaimer in
|
||||
% the documentation and/or other materials provided with the
|
||||
% distribution.
|
||||
% - Neither the name of Analog Devices, Inc. nor the names of its
|
||||
% contributors may be used to endorse or promote products derived
|
||||
% from this software without specific prior written permission.
|
||||
% - The use of this software may or may not infringe the patent rights
|
||||
% of one or more patent holders. This license does not release you
|
||||
% from the requirement that you obtain separate licenses from these
|
||||
% patent holders to use this software.
|
||||
% - Use of the software either in source or binary form or filter designs
|
||||
% resulting from the use of this software, must be connected to, run
|
||||
% on or loaded to an Analog Devices Inc. component.
|
||||
%
|
||||
% THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
||||
% INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A
|
||||
% PARTICULAR PURPOSE ARE DISCLAIMED.
|
||||
%
|
||||
% IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||||
% EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY
|
||||
% RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
||||
% BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
||||
% STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
|
||||
% THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
|
||||
classdef libiio_if < handle
|
||||
% libiio_if Interface object for for IIO devices
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Protected properties
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
properties (Access = protected)
|
||||
libname = 'libiio';
|
||||
hname = 'iio.h';
|
||||
dev_name = '';
|
||||
data_ch_no = 0;
|
||||
data_ch_size = 0;
|
||||
dev_type = '';
|
||||
iio_ctx = {};
|
||||
iio_dev = {};
|
||||
iio_buffer = {};
|
||||
iio_channel = {};
|
||||
iio_buf_size = 8192;
|
||||
iio_scan_elm_no = 0;
|
||||
if_initialized = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Static private methods
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
methods (Static, Access = private)
|
||||
function out = modInstanceCnt(val)
|
||||
% Manages the number of object instances to handle proper DLL unloading
|
||||
persistent instance_cnt;
|
||||
if isempty(instance_cnt)
|
||||
instance_cnt = 0;
|
||||
end
|
||||
instance_cnt = instance_cnt + val;
|
||||
out = instance_cnt;
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Protected methods
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
methods (Access = protected)
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Creates the network context
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = createNetworkContext(obj, ip_address)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Create the network context
|
||||
obj.iio_ctx = calllib(obj.libname, 'iio_create_network_context', ip_address);
|
||||
|
||||
% Check if the network context is valid
|
||||
if (isNull(obj.iio_ctx))
|
||||
obj.iio_ctx = {};
|
||||
err_msg = 'Could not connect to the IIO server!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Increase the object's instance count
|
||||
libiio_if.modInstanceCnt(1);
|
||||
msg_log = [msg_log sprintf('%s: Connected to IP %s\n', class(obj), ip_address)];
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Releases the network context and unload the libiio library
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function releaseContext(obj)
|
||||
calllib(obj.libname, 'iio_context_destroy', obj.iio_ctx);
|
||||
obj.iio_ctx = {};
|
||||
instCnt = libiio_if.modInstanceCnt(-1);
|
||||
if(instCnt == 0)
|
||||
unloadlibrary(obj.libname);
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Checks the compatibility of the different software modules.
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = checkVersions(obj)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Create a set of pointers to read the iiod and dll versions
|
||||
data = zeros(1, 10);
|
||||
remote_pMajor = libpointer('uint32Ptr', data(1));
|
||||
remote_pMinor = libpointer('uint32Ptr', data(2));
|
||||
remote_pGitTag = libpointer('int8Ptr', [int8(data(3:end)) 0]);
|
||||
local_pMajor = libpointer('uint32Ptr', data(1));
|
||||
local_pMinor = libpointer('uint32Ptr', data(2));
|
||||
local_pGitTag = libpointer('int8Ptr', [int8(data(3:end)) 0]);
|
||||
|
||||
% get remote libiio version
|
||||
calllib(obj.libname, 'iio_context_get_version', obj.iio_ctx, remote_pMajor, remote_pMinor, remote_pGitTag);
|
||||
% extract git hash without trailing null char
|
||||
remote_githash = remote_pGitTag.Value(1:7);
|
||||
remote_version_str = sprintf('Remote libiio version: %d.%d, (git-%s)', remote_pMajor.Value, remote_pMinor.Value, remote_githash);
|
||||
msg_log = [msg_log sprintf('%s: %s\n', class(obj), remote_version_str)];
|
||||
|
||||
% get local libiio version
|
||||
calllib(obj.libname, 'iio_library_get_version', local_pMajor, local_pMinor, local_pGitTag);
|
||||
local_githash = local_pGitTag.Value(1:7);
|
||||
local_version_str = sprintf('Local libiio version: %d.%d, (git-%s)', local_pMajor.Value, local_pMinor.Value, local_githash);
|
||||
msg_log = [msg_log sprintf('%s: %s\n', class(obj), local_version_str)];
|
||||
|
||||
if(remote_pMajor.Value < local_pMajor.Value)
|
||||
err_msg = ['The libiio version running on the device is outdated! ' ...
|
||||
'Run the adi_update_tools.sh script to get libiio up to date.'];
|
||||
return;
|
||||
elseif(remote_pMajor.Value > local_pMajor.Value)
|
||||
err_msg = ['The libiio version on the local host is outdated! ' ...
|
||||
'On Windows, reinstall the dll using the latest installer ' ...
|
||||
'from the Analog Devices wiki.'];
|
||||
return;
|
||||
end
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Detect if the specified device is present in the system
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = initDevice(obj, dev_name)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Store the device name
|
||||
obj.dev_name = dev_name;
|
||||
|
||||
% Get the number of devices
|
||||
nb_devices = calllib(obj.libname, 'iio_context_get_devices_count', obj.iio_ctx);
|
||||
|
||||
% If no devices are present return with error
|
||||
if(nb_devices == 0)
|
||||
err_msg = 'No devices were detected in the system!';
|
||||
return;
|
||||
end
|
||||
msg_log = [msg_log sprintf('%s: Found %d devices in the system\n', class(obj), nb_devices)];
|
||||
|
||||
% Detect if the targeted device is installed
|
||||
dev_found = 0;
|
||||
for i = 0 : nb_devices - 1
|
||||
dev = calllib(obj.libname, 'iio_context_get_device', obj.iio_ctx, i);
|
||||
name = calllib(obj.libname, 'iio_device_get_name', dev);
|
||||
if(strcmp(name, dev_name))
|
||||
obj.iio_dev = dev;
|
||||
dev_found = 1;
|
||||
break;
|
||||
end
|
||||
clear dev;
|
||||
end
|
||||
|
||||
% Check if the target device was detected
|
||||
if(dev_found == 0)
|
||||
err_msg = 'Could not find target configuration device!';
|
||||
return;
|
||||
end
|
||||
|
||||
msg_log = [msg_log sprintf('%s: %s was found in the system\n', class(obj), obj.dev_name)];
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Initializes the output data channels
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = initOutputDataChannels(obj, ch_no, ch_size)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Save the number of channels and size
|
||||
obj.data_ch_no = ch_no;
|
||||
obj.data_ch_size = ch_size;
|
||||
|
||||
% Get the number of channels that the device has
|
||||
nb_channels = calllib(obj.libname, 'iio_device_get_channels_count', obj.iio_dev);
|
||||
if(nb_channels == 0)
|
||||
err_msg = 'The selected device does not have any channels!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Enable the data channels
|
||||
if(ch_no ~= 0)
|
||||
% Check if the device has output channels. The
|
||||
% logic here assumes that a device can have
|
||||
% only input or only output channels
|
||||
obj.iio_channel{1} = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, 0);
|
||||
is_output = calllib(obj.libname, 'iio_channel_is_output', obj.iio_channel{1});
|
||||
if(is_output == 0)
|
||||
err_msg = 'The selected device does not have output channels!';
|
||||
return;
|
||||
end
|
||||
% Enable all the channels
|
||||
for j = 0 : nb_channels - 1
|
||||
obj.iio_channel{j+1} = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, j);
|
||||
if(j < ch_no)
|
||||
calllib(obj.libname, 'iio_channel_enable', obj.iio_channel{j+1});
|
||||
is_scan_element = calllib(obj.libname, 'iio_channel_is_scan_element', obj.iio_channel{j+1});
|
||||
if(is_scan_element == 1)
|
||||
obj.iio_scan_elm_no = obj.iio_scan_elm_no + 1;
|
||||
end
|
||||
else
|
||||
calllib(obj.libname, 'iio_channel_disable', obj.iio_channel{j+1});
|
||||
end
|
||||
end
|
||||
msg_log = [msg_log sprintf('%s: Found %d output channels for the device %s\n', class(obj), obj.iio_scan_elm_no, obj.dev_name)];
|
||||
|
||||
% Check if the number of channels in the device
|
||||
% is greater or equal to the system object
|
||||
% input channels
|
||||
if(obj.iio_scan_elm_no < ch_no)
|
||||
obj.iio_channel = {};
|
||||
err_msg = 'The selected device does not have enough output channels!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Enable the DAC buffer output
|
||||
obj.if_initialized = 1;
|
||||
ret = writeAttributeString(obj, 'altvoltage0*raw', '0');
|
||||
obj.if_initialized = 0;
|
||||
if(ret < 0)
|
||||
obj.iio_channel = {};
|
||||
err_msg = 'Could not enable the DAC buffer output!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Create the IIO buffer used to write data
|
||||
obj.iio_buf_size = obj.data_ch_size * obj.iio_scan_elm_no;
|
||||
obj.iio_buffer = calllib(obj.libname, 'iio_device_create_buffer', obj.iio_dev,...
|
||||
obj.data_ch_size, 1);
|
||||
end
|
||||
|
||||
msg_log = [msg_log sprintf('%s: %s output data channels successfully initialized\n', class(obj), obj.dev_name)];
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Initializes the input data channels
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = initInputDataChannels(obj, ch_no, ch_size)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Save the number of channels and size
|
||||
obj.data_ch_no = ch_no;
|
||||
obj.data_ch_size = ch_size;
|
||||
|
||||
% Get the number of channels that the device has
|
||||
nb_channels = calllib(obj.libname, 'iio_device_get_channels_count', obj.iio_dev);
|
||||
if(nb_channels == 0)
|
||||
err_msg = 'The selected device does not have any channels!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Enable the system object output channels
|
||||
if(ch_no ~= 0)
|
||||
% Check if the device has input channels. The
|
||||
% logic here assumes that a device can have
|
||||
% only input or only output channels
|
||||
obj.iio_channel{1} = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, 0);
|
||||
is_output = calllib(obj.libname, 'iio_channel_is_output', obj.iio_channel{1});
|
||||
if(is_output == 1)
|
||||
err_msg = 'The selected device does not have input channels!';
|
||||
return;
|
||||
end
|
||||
msg_log = [msg_log sprintf('%s: Found %d input channels for the device %s\n', class(obj), nb_channels, obj.dev_name)];
|
||||
|
||||
% Check if the number of channels in the device
|
||||
% is greater or equal to the system object
|
||||
% output channels
|
||||
if(nb_channels < ch_no)
|
||||
obj.iio_channel = {};
|
||||
err_msg = 'The selected device does not have enough input channels!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Enable the channels
|
||||
for j = 0 : ch_no - 1
|
||||
obj.iio_channel{j+1} = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, j);
|
||||
calllib(obj.libname, 'iio_channel_enable', obj.iio_channel{j+1});
|
||||
end
|
||||
for j = ch_no : nb_channels - 1
|
||||
obj.iio_channel{j+1} = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, j);
|
||||
calllib(obj.libname, 'iio_channel_disable', obj.iio_channel{j+1});
|
||||
end
|
||||
% Create the IIO buffer used to read data
|
||||
obj.iio_buf_size = obj.data_ch_size * obj.data_ch_no;
|
||||
obj.iio_buffer = calllib(obj.libname, 'iio_device_create_buffer', obj.iio_dev, obj.iio_buf_size, 0);
|
||||
end
|
||||
|
||||
msg_log = [msg_log sprintf('%s: %s input data channels successfully initialized\n', class(obj), obj.dev_name)];
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Public methods
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
methods
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Constructor
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function obj = libiio_if()
|
||||
% Constructor
|
||||
obj.if_initialized = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Destructor
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function delete(obj)
|
||||
% Release any resources used by the system object.
|
||||
if((obj.if_initialized == 1) && libisloaded(obj.libname))
|
||||
if(~isempty(obj.iio_buffer))
|
||||
calllib(obj.libname, 'iio_buffer_destroy', obj.iio_buffer);
|
||||
end
|
||||
if(~isempty(obj.iio_ctx))
|
||||
calllib(obj.libname, 'iio_context_destroy', obj.iio_ctx);
|
||||
end
|
||||
obj.iio_buffer = {};
|
||||
obj.iio_channel = {};
|
||||
obj.iio_dev = {};
|
||||
obj.iio_ctx = {};
|
||||
instCnt = libiio_if.modInstanceCnt(-1);
|
||||
if(instCnt == 0)
|
||||
unloadlibrary(obj.libname);
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Initializes the libiio interface
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, err_msg, msg_log] = init(obj, ip_address, ...
|
||||
dev_name, dev_type, ...
|
||||
data_ch_no, data_ch_size)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
err_msg = '';
|
||||
msg_log = [];
|
||||
|
||||
% Save the device type
|
||||
obj.dev_type = dev_type;
|
||||
|
||||
% Set the initialization status to fail
|
||||
obj.if_initialized = 0;
|
||||
|
||||
% Load the libiio library
|
||||
if(~libisloaded(obj.libname))
|
||||
try
|
||||
[notfound, warnings] = loadlibrary(obj.libname, obj.hname);
|
||||
catch exception
|
||||
err_msg = exception.message;
|
||||
return;
|
||||
end
|
||||
end
|
||||
|
||||
if(~libisloaded(obj.libname))
|
||||
err_msg = 'Could not load the libiio library!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Create the network context
|
||||
[ret, err_msg, msg_log] = createNetworkContext(obj, ip_address);
|
||||
if(ret < 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Check the software versions
|
||||
[ret, err_msg, msg_log_new] = checkVersions(obj);
|
||||
msg_log = [msg_log msg_log_new];
|
||||
if(ret < 0)
|
||||
releaseContext(obj);
|
||||
return;
|
||||
end
|
||||
|
||||
% Initialize the device
|
||||
[ret, err_msg, msg_log_new] = initDevice(obj, dev_name);
|
||||
msg_log = [msg_log msg_log_new];
|
||||
if(ret < 0)
|
||||
releaseContext(obj);
|
||||
return;
|
||||
end
|
||||
|
||||
% Initialize the output data channels
|
||||
if(strcmp(dev_type, 'OUT'))
|
||||
[ret, err_msg, msg_log_new] = initOutputDataChannels(obj, data_ch_no, data_ch_size);
|
||||
msg_log = [msg_log msg_log_new];
|
||||
if(ret < 0)
|
||||
releaseContext(obj);
|
||||
return;
|
||||
end
|
||||
end
|
||||
|
||||
% Initialize the input data channels
|
||||
if(strcmp(dev_type, 'IN'))
|
||||
[ret, err_msg, msg_log_new] = initInputDataChannels(obj, data_ch_no, data_ch_size);
|
||||
msg_log = [msg_log msg_log_new];
|
||||
if(ret < 0)
|
||||
releaseContext(obj);
|
||||
return;
|
||||
end
|
||||
end
|
||||
|
||||
% Set the initialization status to success
|
||||
obj.if_initialized = 1;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Implement the data capture flow
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, data] = readData(obj)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
data = cell(1, obj.data_ch_no);
|
||||
for i = 1 : obj.data_ch_no
|
||||
data{i} = zeros(obj.data_ch_size, 1);
|
||||
end
|
||||
|
||||
% Check if the interface is initialized
|
||||
if(obj.if_initialized == 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Check if the device type is output
|
||||
if(~strcmp(obj.dev_type, 'IN'))
|
||||
return;
|
||||
end
|
||||
|
||||
% Read the data
|
||||
calllib(obj.libname, 'iio_buffer_refill', obj.iio_buffer);
|
||||
buffer = calllib(obj.libname, 'iio_buffer_first', obj.iio_buffer, obj.iio_channel{1});
|
||||
setdatatype(buffer, 'int16Ptr', obj.iio_buf_size);
|
||||
for i = 1 : obj.data_ch_no
|
||||
data{i} = double(buffer.Value(i:obj.data_ch_no:end));
|
||||
end
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Implement the data transmit flow
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function ret = writeData(obj, data)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
|
||||
% Check if the interface is initialized
|
||||
if(obj.if_initialized == 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Check if the device type is input
|
||||
if(~strcmp(obj.dev_type, 'OUT'))
|
||||
return;
|
||||
end
|
||||
|
||||
% Destroy the buffer
|
||||
calllib(obj.libname, 'iio_buffer_destroy', obj.iio_buffer);
|
||||
obj.iio_buffer = {};
|
||||
|
||||
% Enable the DAC buffer output
|
||||
ret = writeAttributeString(obj, 'altvoltage0*raw', '0');
|
||||
if(ret < 0)
|
||||
obj.iio_channel = {};
|
||||
err_msg = 'Could not enable the DAC buffer output!';
|
||||
return;
|
||||
end
|
||||
|
||||
% Create the IIO buffer used to write data
|
||||
obj.iio_buf_size = obj.data_ch_size * obj.iio_scan_elm_no;
|
||||
obj.iio_buffer = calllib(obj.libname, 'iio_device_create_buffer', obj.iio_dev,...
|
||||
obj.data_ch_size, 1);
|
||||
|
||||
% Transmit the data
|
||||
buffer = calllib(obj.libname, 'iio_buffer_start', obj.iio_buffer);
|
||||
setdatatype(buffer, 'int16Ptr', obj.iio_buf_size);
|
||||
for i = 1 : obj.data_ch_no
|
||||
buffer.Value(i : obj.iio_scan_elm_no : obj.iio_buf_size) = int16(data{i});
|
||||
end
|
||||
for i = obj.data_ch_no + 1 : obj.iio_scan_elm_no
|
||||
buffer.Value(i : obj.iio_scan_elm_no : obj.iio_buf_size) = 0;
|
||||
end
|
||||
calllib(obj.libname, 'iio_buffer_push', obj.iio_buffer);
|
||||
|
||||
% Set the return code to success
|
||||
ret = 0;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Find an attribute based on the name. The name can contain wildcard '*' characters
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, ch, attr] = findAttribute(obj, attr_name)
|
||||
% Initialize the return values
|
||||
ret = -1;
|
||||
ch = 0;
|
||||
attr = '';
|
||||
|
||||
% Check if the interface is initialized
|
||||
if(obj.if_initialized == 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Check if this is a device attribute
|
||||
name = calllib(obj.libname, 'iio_device_find_attr', obj.iio_dev, attr_name);
|
||||
if(~isempty(name))
|
||||
ret = 0;
|
||||
return;
|
||||
end
|
||||
|
||||
% This is a channel attribute, search for the corresponding channel
|
||||
chn_no = calllib(obj.libname, 'iio_device_get_channels_count', obj.iio_dev);
|
||||
for k = 0 : chn_no - 1
|
||||
ch = calllib(obj.libname, 'iio_device_get_channel', obj.iio_dev, k);
|
||||
attr_no = calllib(obj.libname, 'iio_channel_get_attrs_count', ch);
|
||||
attr_found = 0;
|
||||
for l = 0 : attr_no - 1
|
||||
attr = calllib(obj.libname, 'iio_channel_get_attr', ch, l);
|
||||
name = calllib(obj.libname, 'iio_channel_attr_get_filename', ch, attr);
|
||||
% The attribute to find can contain wildcard '*' characters,
|
||||
% search for all the substrings in the attribute name
|
||||
str_find = strsplit(attr_name, '*');
|
||||
str_find = str_find(find(~strcmp(str_find, '')));
|
||||
has_wildcard = ~isempty(strfind(attr_name, '*'));
|
||||
attr_found = 1;
|
||||
for i = 1 : length(str_find)
|
||||
if(has_wildcard == 0)
|
||||
ret = strcmp(name, str_find{i});
|
||||
if(ret == 0)
|
||||
ret = [];
|
||||
end
|
||||
else
|
||||
ret = strfind(name, str_find{i});
|
||||
end
|
||||
if(isempty(ret))
|
||||
attr_found = 0;
|
||||
break;
|
||||
end
|
||||
end
|
||||
if(attr_found == 1)
|
||||
break;
|
||||
end
|
||||
clear attr;
|
||||
end
|
||||
% Check if the attribute was found
|
||||
if(attr_found == 0)
|
||||
clear ch;
|
||||
else
|
||||
ret = 1;
|
||||
break;
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Read an attribute as a double value
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, val] = readAttributeDouble(obj, attr_name)
|
||||
% Find the attribute
|
||||
[ret, ch, attr] = findAttribute(obj, attr_name);
|
||||
if(ret < 0)
|
||||
val = 0;
|
||||
return;
|
||||
end
|
||||
|
||||
% Create a double pointer to be used for data read
|
||||
data = zeros(1, 10);
|
||||
pData = libpointer('doublePtr', data(1));
|
||||
|
||||
% Read the attribute value
|
||||
if(ret > 0)
|
||||
calllib(obj.libname, 'iio_channel_attr_read_double', ch, attr, pData);
|
||||
clear ch;
|
||||
clear attr;
|
||||
else
|
||||
calllib(obj.libname, 'iio_device_attr_read_double', obj.iio_dev, attr_name, pData);
|
||||
end
|
||||
val = pData.Value;
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Read an attribute as a string value
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function [ret, val] = readAttributeString(obj, attr_name)
|
||||
% Find the attribute
|
||||
[ret, ch, attr] = findAttribute(obj, attr_name);
|
||||
if(ret < 0)
|
||||
val = '';
|
||||
return;
|
||||
end
|
||||
|
||||
% Create a pointer to be used for data read
|
||||
data = char(ones(1, 512));
|
||||
pData = libpointer('stringPtr', data);
|
||||
|
||||
% Read the attribute value
|
||||
if(ret > 0)
|
||||
[~, ~, ~, val] = calllib(obj.libname, 'iio_channel_attr_read', ch, attr, pData, 512);
|
||||
clear ch;
|
||||
clear attr;
|
||||
else
|
||||
[~, ~, ~, val] = calllib(obj.libname, 'iio_device_attr_read', obj.iio_dev, attr_name, pData, 512);
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Write a string double value
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function ret = writeAttributeDouble(obj, attr_name, val)
|
||||
% Find the attribute
|
||||
[ret, ch, attr] = findAttribute(obj, attr_name);
|
||||
if(ret < 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Write the attribute
|
||||
if(ret > 0)
|
||||
calllib(obj.libname, 'iio_channel_attr_write_double', ch, attr, val);
|
||||
clear ch;
|
||||
clear attr;
|
||||
else
|
||||
calllib(obj.libname, 'iio_device_attr_write_double', obj.iio_dev, attr_name, val);
|
||||
end
|
||||
end
|
||||
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
%% Write a string attribute value
|
||||
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||||
function ret = writeAttributeString(obj, attr_name, str)
|
||||
% Find the attribute
|
||||
[ret, ch, attr] = findAttribute(obj, attr_name);
|
||||
if(ret < 0)
|
||||
return;
|
||||
end
|
||||
|
||||
% Write the attribute
|
||||
if(ret > 0)
|
||||
calllib(obj.libname, 'iio_channel_attr_write', ch, attr, str);
|
||||
clear ch;
|
||||
clear attr;
|
||||
else
|
||||
calllib(obj.libname, 'iio_device_attr_write', obj.iio_dev, attr_name, str);
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
Loading…
Reference in New Issue