663 lines
27 KiB
Matlab
663 lines
27 KiB
Matlab
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);
|
|
pMajor = libpointer('uint32Ptr', data(1));
|
|
pMinor = libpointer('uint32Ptr', data(2));
|
|
pGitTag = libpointer('int8Ptr', [int8(data(3:end)) 0]);
|
|
|
|
% Check if the libiio version running on the device is
|
|
% compatible with this version of the system object
|
|
calllib(obj.libname, 'iio_context_get_version', obj.iio_ctx, pMajor, pMinor, pGitTag);
|
|
|
|
% extract git hash without trailing null char
|
|
githash = pGitTag.Value(1:7);
|
|
remote_version_str = sprintf('Remote libiio version: %d.%d, (git-%s)', pMajor.Value, pMinor.Value, githash);
|
|
|
|
if(pMajor.Value == 0 && pMinor.Value < 3)
|
|
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(~(pMajor.Value >= 0 && pMinor.Value >= 3))
|
|
err_msg = sprintf('The Simulink system object is outdated! Download the latest version from the Analog Devices github repository.\n\n%s\n', ...
|
|
remote_version_str);
|
|
return;
|
|
else
|
|
msg_log = [msg_log sprintf('%s: %s\n', class(obj), remote_version_str)];
|
|
end
|
|
|
|
% Check if the libiio dll is compatible with this version
|
|
% of the system object
|
|
calllib(obj.libname, 'iio_library_get_version', pMajor, pMinor, pGitTag);
|
|
githash = pGitTag.Value(1:7);
|
|
local_version_str = sprintf('Local libiio version: %d.%d, (git-%s)', pMajor.Value, pMinor.Value, githash);
|
|
if(pMajor.Value == 0 && pMinor.Value < 2)
|
|
err_msg = 'The libiio dll is outdated! Reinstall the dll using the latest installer from the Analog Devices wiki.';
|
|
return;
|
|
elseif(pMajor.Value > 0 || pMinor.Value > 3)
|
|
err_msg = sprintf('The Simulink system object is outdated! Download the latest version from the Analog Devices github repository.\n\n%s\n', ...
|
|
local_version_str);
|
|
return;
|
|
else
|
|
msg_log = [msg_log sprintf('%s: %s\n', class(obj), local_version_str)];
|
|
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);
|
|
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
|
|
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, '*');
|
|
attr_found = 1;
|
|
for i = 1 : length(str_find)
|
|
ret = strfind(name, str_find{i});
|
|
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
|