189 lines
7.9 KiB
Matlab
189 lines
7.9 KiB
Matlab
classdef trackingRecoveryConfig < comm.internal.ConfigBase
|
|
%trackingRecoveryConfig Construct a configuration object for data recovery
|
|
% CFGREC = trackingRecoveryConfig constructs a configuration object for
|
|
% recovering the data fields using function which perform sample rate
|
|
% offset tracking: <a href="matlab:help('trackingNonHTDataRecover')">trackingNonHTDataRecover</a>, <a href="matlab:help('trackingHTDataRecover')">trackingHTDataRecover</a>, and
|
|
% <a href="matlab:help('trackingVHTDataRecover')">trackingVHTDataRecover</a>. Adjust the property values of the object,
|
|
% which indicate different algorithm parameters or operations at the
|
|
% receiver, to achieve optimal recovery performance.
|
|
%
|
|
% CFGREC = trackingRecoveryConfig(Name,Value) constructs a recovery
|
|
% configuration object, CFGREC, with the specified property Name set to
|
|
% the specified Value. You can specify additional name-value pair
|
|
% arguments in any order as (Name1,Value1,...,NameN,ValueN).
|
|
%
|
|
% trackingRecoveryConfig properties:
|
|
%
|
|
% OFDMSymbolOffset - OFDM symbol sampling offset
|
|
% EqualizationMethod - Equalization method
|
|
% PilotTracking - Pilot tracking
|
|
% PilotTrackingWindow - Pilot tracking averaging window
|
|
% PilotGainTracking - Pilot gain tracking
|
|
% LDPCDecodingMethod - LDPC decoding algorithm
|
|
% MinSumScalingFactor - Scaling factor for normalized min-sum LDPC
|
|
% decoding algorithm
|
|
% MinSumOffset - Offset for offset min-sum LDPC decoding
|
|
% algorithm
|
|
% MaximumLDPCIterationCount - Maximum number of decoding iterations
|
|
% EarlyTermination - Enable early termination of LDPC decoding
|
|
%
|
|
% % Example:
|
|
% % Create a trackingRecoveryConfig object for performing ZF
|
|
% % equalization, OFDM symbol sampling offset of 0.5, and not pilot
|
|
% % tracking in a recovery process.
|
|
%
|
|
% cfgRec = trackingRecoveryConfig( ...
|
|
% 'OFDMSymbolOffset', 0.5, ...
|
|
% 'EqualizationMethod', 'ZF', ...
|
|
% 'PilotTracking', 'None')
|
|
%
|
|
% See also trackingVHTDataRecover, trackingHTDataRecover,
|
|
% trackingNonHTDataRecover.
|
|
|
|
% Copyright 2016-2022 The MathWorks, Inc.
|
|
|
|
%#codegen
|
|
%#ok<*EMCA>
|
|
|
|
properties (Access = 'public')
|
|
%OFDMSymbolOffset OFDM symbol offset
|
|
% Specify the sampling offset as a fraction of the cyclic prefix (CP)
|
|
% length for every OFDM symbol, as a double precision, real scalar
|
|
% between 0 and 1, inclusive. The OFDM demodulation is performed
|
|
% based on Nfft samples following the offset position, where Nfft
|
|
% denotes the FFT length. The default value of this property is 0.75,
|
|
% which means the offset is three quarters of the CP length.
|
|
OFDMSymbolOffset = 0.75;
|
|
%EqualizationMethod Equalization method
|
|
% Specify the equalization method as one of 'MMSE' | 'ZF'. The
|
|
% default value of this property is 'MMSE'.
|
|
EqualizationMethod = 'MMSE';
|
|
%PilotTracking Pilot tracking
|
|
% Specify the pilot phase tracking performed as one of 'Joint',
|
|
% 'CPE', or 'None'. 'Joint' pilot tracking estimates and corrects for
|
|
% a sample rate offset and residual carrier frequency offset across
|
|
% all receive antennas for each received OFDM symbol before
|
|
% equalization. 'CPE' pilot tracking estimates and corrects for a
|
|
% common phase error caused by residual carrier frequency offset. The
|
|
% default is 'Joint'.
|
|
PilotTracking = 'Joint';
|
|
%PilotTrackingWindow Pilot tracking averaging window
|
|
% Specify the pilot phase tracking averaging window in OFDM symbols,
|
|
% as an odd, integer scalar greater than 0. When set to 1, no
|
|
% averaging is applied. The default is 9. Within the tracking
|
|
% algorithm the window is truncated to the number of OFDM symbols to
|
|
% demodulate if required.
|
|
PilotTrackingWindow = 9;
|
|
%PilotGainTracking Pilot gain tracking
|
|
% Enable or disable pilot gain tracking. The default is false.
|
|
PilotGainTracking (1,1) logical = false;
|
|
%LDPCDecodingMethod LDPC decoding algorithm
|
|
% Specify the LDPC decoding algorithm as one of these values:
|
|
% - 'bp' : Belief propagation (BP)
|
|
% - 'layered-bp' : Layered BP
|
|
% - 'norm-min-sum' : Normalized min-sum
|
|
% - 'offset-min-sum': Offset min-sum
|
|
% The default is 'norm-min-sum'.
|
|
LDPCDecodingMethod = 'norm-min-sum';
|
|
%MinSumScalingFactor Scaling factor for normalized min-sum LDPC decoding algorithm
|
|
% Specify the scaling factor for normalized min-sum LDPC decoding
|
|
% algorithm as a scalar in the interval (0,1]. This argument applies
|
|
% only when you set LDPCDecodingMethod to 'norm-min-sum'. The default
|
|
% is 0.75.
|
|
MinSumScalingFactor = 0.75;
|
|
%MinSumOffset Offset for offset min-sum LDPC decoding algorithm
|
|
% Specify the offset for offset min-sum LDPC decoding algorithm as a
|
|
% finite real scalar greater than or equal to 0. This argument
|
|
% applies only when you set LDPCDecodingMethod to 'offset-min-sum'.
|
|
% The default is 0.5.
|
|
MinSumOffset = 0.5;
|
|
%MaximumLDPCIterationCount Maximum number of decoding iterations
|
|
% Specify the maximum number of iterations in LDPC decoding as an
|
|
% integer valued numeric scalar. This applies when you set the
|
|
% channel coding property to LDPC. The default is 12.
|
|
MaximumLDPCIterationCount = 12;
|
|
%EarlyTermination Enable early termination of LDPC decoding
|
|
% Set this property to true to enable early termination of LDPC
|
|
% decoding if all parity-checks are satisfied. If set to false, the
|
|
% decoding process will iterate for a fixed number of iterations
|
|
% specified by MaximumLDPCIterationCount. This property applies when
|
|
% ChannelCoding is set to LDPC for a user. The default is false.
|
|
EarlyTermination (1,1) logical = false;
|
|
end
|
|
|
|
properties(Constant, Hidden)
|
|
EqualizationMethod_Values = {'MMSE', 'ZF'};
|
|
PilotTracking_Values = {'Joint', 'CPE', 'None'};
|
|
LDPCDecodingMethod_Values = {'bp','layered-bp','norm-min-sum','offset-min-sum'};
|
|
end
|
|
|
|
methods
|
|
function obj = trackingRecoveryConfig(varargin)
|
|
obj = obj@comm.internal.ConfigBase('EqualizationMethod', 'MMSE', ...
|
|
'PilotTracking','Joint',varargin{:});
|
|
end
|
|
|
|
function obj = set.OFDMSymbolOffset(obj, val)
|
|
prop = 'OFDMSymbolOffset';
|
|
validateattributes(val, {'double'}, ...
|
|
{'real','scalar','>=',0,'<=',1}, ...
|
|
[class(obj) '.' prop], prop);
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.EqualizationMethod(obj, val)
|
|
prop = 'EqualizationMethod';
|
|
validateEnumProperties(obj, prop, val);
|
|
obj.(prop) = '';
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.PilotTracking(obj,val)
|
|
prop = 'PilotTracking';
|
|
validateEnumProperties(obj, prop, val);
|
|
obj.(prop) = '';
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.PilotTrackingWindow(obj,val)
|
|
prop = 'PilotTrackingWindow';
|
|
validateattributes(val,{'numeric'}, ...
|
|
{'real','integer','odd','scalar','>',0}, ...
|
|
[class(obj) '.' prop], prop);
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.LDPCDecodingMethod(obj, val)
|
|
prop = 'LDPCDecodingMethod';
|
|
validateEnumProperties(obj, prop, val);
|
|
obj.(prop) = '';
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.MinSumScalingFactor(obj, val)
|
|
prop = 'MinSumScalingFactor';
|
|
validateattributes(val, {'double'}, ...
|
|
{'real','scalar','>',0,'<=',1}, ...
|
|
[class(obj) '.' prop], prop);
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.MinSumOffset(obj, val)
|
|
prop = 'MinSumOffset';
|
|
validateattributes(val, {'double'}, ...
|
|
{'real','scalar','>',0}, ...
|
|
[class(obj) '.' prop], prop);
|
|
obj.(prop) = val;
|
|
end
|
|
|
|
function obj = set.MaximumLDPCIterationCount(obj, val)
|
|
prop = 'MaximumLDPCIterationCount';
|
|
validateattributes(val, {'double'}, ...
|
|
{'real','integer','scalar','>',0}, ...
|
|
[class(obj) '.' prop], prop);
|
|
obj.(prop) = val;
|
|
end
|
|
end
|
|
|
|
end
|