rvdt.c File Reference

#include <stdlib.h>
#include <math.h>
#include "rvdt.h"
#include "utilHelper.h"
#include "interDrv.h"
#include "interStatus.h"
#include "mmapRvdt.h"

Include dependency graph for rvdt.c:

Macros
#define	RVDT_AMP_GAIN   (16.1F)
#define	RVDT_LSB_RESOLUTION   (0.000119842249F)
#define	RVDT_MAX_WAVE_GAIN   (3U)
#define	RVDT_MAX_DACVCM   (3U)
#define	RVDT_MAX_VOCM   (3U)
#define	RVDT_MAX_WAVE_MODE   (1U)
#define	RVDT_MAX_VCM_BIAS   (3U)
#define	RVDT_MAX_CFG_SENSE   (1U)
#define	RVDT_MAX_CFG_GAIN   (3U)
#define	RVDT_MAX_CFG_RATE   (1U)
#define	RVDT_B1_COEFF_X   (52.6590464548F)
#define	RVDT_B1_COEFF_C   (1.7176039120F)
#define	RVDT_A2_COEFF_X2   (-0.0003316888F)
#define	RVDT_A2_COEFF_X1_1   (0.0030424130F)
#define	RVDT_A2_COEFF_X1_2   (-52.6378998842F)
#define	RVDT_A2_COEFF_C   (-6.3314601043F)
#define	RVDT_A3_COEFF_X   (-105.3227383863F)
#define	RVDT_A3_COEFF_C   (-3.1955990220F)

Functions
static DriverStatus	readRvdtReg (const UInt32 baseAddress, const UInt32 offset, UInt32 *data)
	readRvdtReg.
static DriverStatus	writeRvdtReg (const UInt32 baseAddress, const UInt32 offset, const UInt32 data)
	writeRvdtReg.
static Float64	customRound (const Float64 x)
	customRound.
static DriverStatus	calculateWaveformTableSize (const Float32 voltRms, const Float32 frequency, Float32 *roundedWfmAmpPtr, ExcWaveformTable *wfmTablePtr, const Float32 gainValue)
	calculateWaveformTableSize.
static DriverStatus	calculateWaveformTableValue (const Float32 roundedWfmAmp, const Float32 frequency, ExcWaveformTable *wfmTablePtr)
	calculateWaveformTableValue.
static DriverStatus	configSec1BpfA2 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec1BpfA2.
static DriverStatus	configSec1BpfA3 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec1BpfA3.
static DriverStatus	configSec1BpfB1 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec1BpfB1.
static DriverStatus	configSec2BpfB1 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec2BpfB1.
static DriverStatus	configSec2BpfA2 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec2BpfA2.
static DriverStatus	configSec2BpfA3 (const RvdtDevHandler rvdtDevHdl, UInt8 *bpfData)
	configSec2BpfA3.
static DriverStatus	configSec1Lpf (const RvdtDevHandler rvdtDevHdl, UInt8 *buff)
	configSec1Lpf.
static DriverStatus	configSec2Lpf (const RvdtDevHandler rvdtDevHdl, UInt8 *buff)
	configSec2Lpf.
static DriverStatus	getSenseDemod1Demod2Data (const RvdtDevHandler rvdtDevHdl, UInt32 *senseData)
	getSenseDemod1Demod2Data.
static DriverStatus	butterworthLowPassFilter (const Float64 cutoffFreq, const Float64 samplingFreq, const Float64 halfRate, LPFFilterCoeffs *lpfCoeffsPtr)
	butterworthLowPassFilter.
DriverStatus	rvdt_getPbit (const RvdtDevHandler rvdtDevHdl, RvdtPbitStatus *pbitStatus)
	rvdt_getPbit.
DriverStatus	rvdt_getCbit (const RvdtDevHandler rvdtDevHdl, RvdtCbitStatus *cbitStatus)
	rvdt_getCbit.
DriverStatus	rvdt_getTemp (const RvdtDevHandler rvdtDevHdl, Float32 *temp)
	rvdt_getTemp.
DriverStatus	rvdt_initDev (const RvdtDevHandler rvdtDevHdl)
	rvdt_initDev.
DriverStatus	rvdt_getRefStatus (const RvdtDevHandler rvdtDevHdl, Bool *opStatus)
	rvdt_getRefStatus.
DriverStatus	rvdt_setPowerEnable (const RvdtDevHandler rvdtDevHdl, const Bool enable)
	rvdt_setPowerEnable.
DriverStatus	rvdt_setTestMux (const RvdtDevHandler rvdtDevHdl, const Bool enable)
	rvdt_setTestMux
DriverStatus	rvdt_setRefWaveEnable (const RvdtDevHandler rvdtDevHdl, const Bool enable)
	rvdt_setRefWaveEnable.
DriverStatus	rvdt_configWaveformGeneration (const RvdtDevHandler rvdtDevHdl, const UInt8 dacvcm, const UInt8 vocm, const UInt8 gain, const UInt8 mode, const Float32 voltageRms, const Float32 frequency)
	rvdt_configWaveformGeneration.
DriverStatus	rvdt_getSenseStatus (const RvdtDevHandler rvdtDevHdl, Bool *opStatus)
	rvdt_getSenseStatus.
DriverStatus	rvdt_setSenseEnable (const RvdtDevHandler rvdtDevHdl, const Bool enable)
	rvdt_setSenseEnable.
DriverStatus	rvdt_setS1s2Config (const RvdtDevHandler rvdtDevHdl, const UInt8 vcmBias)
	rvdt_setS1s2Config.
DriverStatus	rvdt_configSec1 (const RvdtDevHandler rvdtDevHdl, const UInt8 sense, const UInt8 gain, const UInt8 rate)
	rvdt_configSec1.
DriverStatus	rvdt_configSec2 (const RvdtDevHandler rvdtDevHdl, const UInt8 sense, const UInt8 gain, const UInt8 rate)
	rvdt_configSec2.
DriverStatus	rvdt_configLpfCoefficient (const RvdtDevHandler rvdtDevHdl, const UInt32 lpfFreq, const UInt32 lpfRate)
	rvdt_configLpfCoefficient.
DriverStatus	rvdt_configBpfCoefficient (const RvdtDevHandler rvdtDevHdl, const UInt32 bpfFreq, const UInt32 bpfBandwidth)
	rvdt_configBpfCoefficient.
DriverStatus	rvdt_setRefConfigCommand (const RvdtDevHandler rvdtDevHdl)
	rvdt_setRefConfigCommand.
DriverStatus	rvdt_setSenseConfigCommand (const RvdtDevHandler rvdtDevHdl)
	rvdt_setSenseConfigCommand.
DriverStatus	rvdt_setSenseFilterCommand (const RvdtDevHandler rvdtDevHdl)
	rvdt_setSenseFilterCommand
DriverStatus	rvdt_getSensePosition (const RvdtDevHandler rvdtDevHdl, Float32 *demod1Ptr, Float32 *demod2Ptr, Float32 *deltaVal, UInt32 *adcVal1, UInt32 *adcVal2)
	rvdt_getSensePosition.

Detailed Description

Author

Ramza Anuar ramza.nosp@m..anu.nosp@m.ar@tu.nosp@m.sas..nosp@m.my

Rvdt device driver file

Macro Definition Documentation

RVDT_A2_COEFF_C

#define RVDT_A2_COEFF_C   (-6.3314601043F)

RVDT_A2_COEFF_X1_1

#define RVDT_A2_COEFF_X1_1   (0.0030424130F)

RVDT_A2_COEFF_X1_2

#define RVDT_A2_COEFF_X1_2   (-52.6378998842F)

RVDT_A2_COEFF_X2

#define RVDT_A2_COEFF_X2   (-0.0003316888F)

RVDT_A3_COEFF_C

#define RVDT_A3_COEFF_C   (-3.1955990220F)

RVDT_A3_COEFF_X

#define RVDT_A3_COEFF_X   (-105.3227383863F)

RVDT_AMP_GAIN

#define RVDT_AMP_GAIN   (16.1F)

RVDT_B1_COEFF_C

#define RVDT_B1_COEFF_C   (1.7176039120F)

RVDT_B1_COEFF_X

#define RVDT_B1_COEFF_X   (52.6590464548F)

RVDT_LSB_RESOLUTION

#define RVDT_LSB_RESOLUTION   (0.000119842249F)

RVDT_MAX_CFG_GAIN

#define RVDT_MAX_CFG_GAIN   (3U)

RVDT_MAX_CFG_RATE

#define RVDT_MAX_CFG_RATE   (1U)

RVDT_MAX_CFG_SENSE

#define RVDT_MAX_CFG_SENSE   (1U)

RVDT_MAX_DACVCM

#define RVDT_MAX_DACVCM   (3U)

RVDT_MAX_VCM_BIAS

#define RVDT_MAX_VCM_BIAS   (3U)

RVDT_MAX_VOCM

#define RVDT_MAX_VOCM   (3U)

RVDT_MAX_WAVE_GAIN

#define RVDT_MAX_WAVE_GAIN   (3U)

RVDT_MAX_WAVE_MODE

#define RVDT_MAX_WAVE_MODE   (1U)

Function Documentation

butterworthLowPassFilter()

DriverStatus butterworthLowPassFilter ( const Float64 cutoffFreq, const Float64 samplingFreq, const Float64 halfRate, LPFFilterCoeffs * lpfCoeffsPtr )

static

butterworthLowPassFilter.

Calculates the coefficients for a Butterworth low-pass filter. This function computes the coefficients for a Butterworth low-pass filter based on the given cutoff frequency, sampling frequency, and half-rate. The coefficients are stored in the provided LPFFilterCoeffs structure.

Parameters

[in]	cutoffFreq	The cutoff frequency of the low-pass filter (Hz).
[in]	samplingFreq	The sampling frequency of the signal (Hz).
[in]	halfRate	The half-rate of the filter.
[out]	lpfCoeffsPtr	Pointer to the structure where the filter coefficients will be stored.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_INVALID_VALUE	: The value input is out of range.
DRV_INVALID_PARAM	:The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: butterworthLowPassFilter

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_BUTTERWORTHLOWPASSFILTER_01	HLR_RVDT_18870	WHEN the destination pointer parameter lpfCoeffsPtr is NULL, the butterworthLowPassFilter() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:butterworthLowPassFilter()	Test	Closed
LLR_RVDT_BUTTERWORTHLOWPASSFILTER_02	HLR_RVDT_18870	WHEN the parameter samplingFreq is within the zero-tolerance range (greater than -FLOAT_TOLERANCE and less than FLOAT_TOLERANCE), the butterworthLowPassFilter() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:butterworthLowPassFilter()	Test	Closed
LLR_RVDT_BUTTERWORTHLOWPASSFILTER_03	HLR_RVDT_18870	WHEN the term (alpha + 1.0) is within the zero-tolerance range (greater than -FLOAT_TOLERANCE and less than FLOAT_TOLERANCE), the butterworthLowPassFilter() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:butterworthLowPassFilter()	Test	Closed
LLR_RVDT_BUTTERWORTHLOWPASSFILTER_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the butterworthLowPassFilter() function SHALL compute the second-order Butterworth filter coefficients using tan() and write the calculated parameters into the output structure referenced by lpfCoeffsPtr.	rvdt.c:butterworthLowPassFilter()	Test	Closed
LLR_RVDT_BUTTERWORTHLOWPASSFILTER_05	HLR_RVDT_18870	WHEN all coefficient calculations complete successfully, the butterworthLowPassFilter() function SHALL return DRV_SUCCESS.	rvdt.c:butterworthLowPassFilter()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

calculateWaveformTableSize()

DriverStatus calculateWaveformTableSize ( const Float32 voltRms, const Float32 frequency, Float32 * roundedWfmAmpPtr, ExcWaveformTable * wfmTablePtr, const Float32 gainValue )

static

calculateWaveformTableSize.

Waveform table size calculation.

Parameters

[in]	voltRms	VRms value.
[in]	frequency	Operating frequency (kHz).
[out]	roundedWfmAmpPtr	Rounded waveform amplitude value.
[out]	wfmTablePtr	Waveform table size and amplitude value.
[in]	gainValue	The gain value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_INVALID_PARAM	: The provided address pointer is invalid.
DRV_INVALID_VALUE	: The value is out of range.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: calculateWaveformTableSize

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CALCULATEWAVEFORMTABLESIZE_01	HLR_RVDT_18870	WHEN the pointer parameter roundedWfmAmpPtr is NULL or the pointer parameter wfmTablePtr is NULL, the calculateWaveformTableSize() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:calculateWaveformTableSize()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLESIZE_02	HLR_RVDT_18870	WHEN the parameter gainValue is within the zero-tolerance range (greater than -FLOAT_TOLERANCE and less than FLOAT_TOLERANCE), the calculateWaveformTableSize() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:calculateWaveformTableSize()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLESIZE_03	HLR_RVDT_18870	WHEN the parameter frequency is within the zero-tolerance range (greater than -FLOAT_TOLERANCE and less than FLOAT_TOLERANCE), the calculateWaveformTableSize() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:calculateWaveformTableSize()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLESIZE_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the calculateWaveformTableSize() function SHALL compute excitation waveform amplitude scaling using sqrt() and populate the excitation table referenced by wfmTablePtr.	rvdt.c:calculateWaveformTableSize()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLESIZE_05	HLR_RVDT_18870	WHEN all table calculations complete successfully, the calculateWaveformTableSize() function SHALL return DRV_SUCCESS.	rvdt.c:calculateWaveformTableSize()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

calculateWaveformTableValue()

DriverStatus calculateWaveformTableValue ( const Float32 roundedWfmAmp, const Float32 frequency, ExcWaveformTable * wfmTablePtr )

static

calculateWaveformTableValue.

Waveform table amplitude table calculation.

Parameters

[in]	roundedWfmAmp	Rounded waveform amplitude value.
[in]	frequency	Operating frequency (Hz).
[in,out]	wfmTablePtr	Waveform table size and amplitude value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_INVALID_PARAM	: Invalid address pointer.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: calculateWaveformTableValue

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CALCULATEWAVEFORMTABLEVALUE_01	HLR_RVDT_18870	WHEN the pointer wfmTablePtr is NULL (invalid), the calculateWaveformTableValue() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:calculateWaveformTableValue()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLEVALUE_02	HLR_RVDT_18870	WHEN preconditions are satisfied, the calculateWaveformTableValue() function SHALL invoke routine sin() to execute target subsystem hardware operation.	rvdt.c:calculateWaveformTableValue()	Test	Closed
LLR_RVDT_CALCULATEWAVEFORMTABLEVALUE_03	HLR_RVDT_18870	WHEN all operational processing completes successfully, the calculateWaveformTableValue() function SHALL return DRV_SUCCESS.	rvdt.c:calculateWaveformTableValue()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec1BpfA2()

DriverStatus configSec1BpfA2 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec1BpfA2.

Configure secondary 1 bpf a2.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec1BpfA2

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC1BPFA2_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec1BpfA2() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec1BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA2_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec1BpfA2() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec1BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA2_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec1BpfA2() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC1_BPF_A2) at physical offset 0x0024 (MMAP_RVDT_CFG_SEC1_BPF_A2) using writeRvdtReg().	rvdt.c:configSec1BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA2_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec1BpfA2() function SHALL return DRV_SUCCESS.	rvdt.c:configSec1BpfA2()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec1BpfA3()

DriverStatus configSec1BpfA3 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec1BpfA3.

Configure secondary 1 bpf a3.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec1BpfA3

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC1BPFA3_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec1BpfA3() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec1BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA3_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec1BpfA3() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec1BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA3_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec1BpfA3() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC1_BPF_A3) at physical offset 0x0028 (MMAP_RVDT_CFG_SEC1_BPF_A3) using writeRvdtReg().	rvdt.c:configSec1BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFA3_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec1BpfA3() function SHALL return DRV_SUCCESS.	rvdt.c:configSec1BpfA3()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec1BpfB1()

DriverStatus configSec1BpfB1 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec1BpfB1.

Configure secondary 1 bpf b1.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec1BpfB1

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC1BPFB1_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec1BpfB1() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec1BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFB1_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec1BpfB1() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec1BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFB1_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec1BpfB1() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC1_BPF_B1) at physical offset 0x0020 (MMAP_RVDT_CFG_SEC1_BPF_B1) using writeRvdtReg().	rvdt.c:configSec1BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC1BPFB1_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec1BpfB1() function SHALL return DRV_SUCCESS.	rvdt.c:configSec1BpfB1()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec1Lpf()

DriverStatus configSec1Lpf ( const RvdtDevHandler rvdtDevHdl, UInt8 * buff )

static

configSec1Lpf.

Configure secondary 1 lpf.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	buff	Buffer to hold lpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec1Lpf

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC1LPF_01	HLR_RVDT_18874	WHEN the pointer buff is NULL (invalid), the configSec1Lpf() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec1Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC1LPF_02	HLR_RVDT_18874	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec1Lpf() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec1Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC1LPF_03	HLR_RVDT_18874	WHEN preconditions are satisfied, the configSec1Lpf() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC1_LPF) at physical offset 0x0018 (MMAP_RVDT_CFG_SEC1_LPF) using writeRvdtReg().	rvdt.c:configSec1Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC1LPF_04	HLR_RVDT_18874	WHEN all operational processing completes successfully, the configSec1Lpf() function SHALL return DRV_SUCCESS.	rvdt.c:configSec1Lpf()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec2BpfA2()

DriverStatus configSec2BpfA2 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec2BpfA2.

Configure secondary 2 bpf a2.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec2BpfA2

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC2BPFA2_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec2BpfA2() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec2BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA2_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec2BpfA2() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec2BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA2_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec2BpfA2() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC2_BPF_A2) at physical offset 0x0030 (MMAP_RVDT_CFG_SEC2_BPF_A2) using writeRvdtReg().	rvdt.c:configSec2BpfA2()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA2_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec2BpfA2() function SHALL return DRV_SUCCESS.	rvdt.c:configSec2BpfA2()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec2BpfA3()

DriverStatus configSec2BpfA3 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec2BpfA3.

Configure secondary 2 bpf a3.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec2BpfA3

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC2BPFA3_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec2BpfA3() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec2BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA3_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec2BpfA3() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec2BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA3_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec2BpfA3() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC2_BPF_A3) at physical offset 0x0034 (MMAP_RVDT_CFG_SEC2_BPF_A3) using writeRvdtReg().	rvdt.c:configSec2BpfA3()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFA3_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec2BpfA3() function SHALL return DRV_SUCCESS.	rvdt.c:configSec2BpfA3()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec2BpfB1()

DriverStatus configSec2BpfB1 ( const RvdtDevHandler rvdtDevHdl, UInt8 * bpfData )

static

configSec2BpfB1.

Configure secondary 2 bpf b1.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfData	Buffer to hold bpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec2BpfB1

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC2BPFB1_01	HLR_RVDT_18873	WHEN the pointer bpfData is NULL (invalid), the configSec2BpfB1() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec2BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFB1_02	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec2BpfB1() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec2BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFB1_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the configSec2BpfB1() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC2_BPF_B1) at physical offset 0x002C (MMAP_RVDT_CFG_SEC2_BPF_B1) using writeRvdtReg().	rvdt.c:configSec2BpfB1()	Test	Closed
LLR_RVDT_CONFIGSEC2BPFB1_04	HLR_RVDT_18873	WHEN all operational processing completes successfully, the configSec2BpfB1() function SHALL return DRV_SUCCESS.	rvdt.c:configSec2BpfB1()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

configSec2Lpf()

DriverStatus configSec2Lpf ( const RvdtDevHandler rvdtDevHdl, UInt8 * buff )

static

configSec2Lpf.

Configure secondary 2 lpf.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	buff	Buffer to hold lpf data.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: configSec2Lpf

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CONFIGSEC2LPF_01	HLR_RVDT_18874	WHEN the pointer buff is NULL (invalid), the configSec2Lpf() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:configSec2Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC2LPF_02	HLR_RVDT_18874	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the configSec2Lpf() function SHALL abort processing and return that driver failure status.	rvdt.c:configSec2Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC2LPF_03	HLR_RVDT_18874	WHEN preconditions are satisfied, the configSec2Lpf() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC2_LPF) at physical offset 0x001C (MMAP_RVDT_CFG_SEC2_LPF) using writeRvdtReg().	rvdt.c:configSec2Lpf()	Test	Closed
LLR_RVDT_CONFIGSEC2LPF_04	HLR_RVDT_18874	WHEN all operational processing completes successfully, the configSec2Lpf() function SHALL return DRV_SUCCESS.	rvdt.c:configSec2Lpf()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

customRound()

Float64 customRound ( const Float64 x )

static

customRound.

Custom rounding function for Float64 values. This function rounds a floating-point number of type Float64 to the nearest integer value. If the fractional part of the number is 0.5 or greater, the function rounds up. Otherwise, it rounds down.

Parameters

[in]

x

The Float64 number to be rounded.

Returns

The rounded Float64 value.

Return values

value

: The rounded Float64 value.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: customRound

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_CUSTOMROUND_01	HLR_RVDT_18870	WHEN the input floating-point value x is less than 0.0, the customRound() function SHALL compute the ceiling of (x - 0.5) and return the resulting rounded value.	rvdt.c:customRound()	Test	Closed
LLR_RVDT_CUSTOMROUND_02	HLR_RVDT_18870	WHEN the input floating-point value x is greater than or equal to 0.0, the customRound() function SHALL compute the floor of (x + 0.5) and return the resulting rounded value.	rvdt.c:customRound()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

getSenseDemod1Demod2Data()

DriverStatus getSenseDemod1Demod2Data ( const RvdtDevHandler rvdtDevHdl, UInt32 * senseData )

static

getSenseDemod1Demod2Data.

Get sense demod 1 and demod 2 data.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	senseData	The sense data output value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: getSenseDemod1Demod2Data

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_GETSENSEDEMOD1DEMOD2DATA_01	HLR_RVDT_18870	WHEN the pointer senseData is NULL (invalid), the getSenseDemod1Demod2Data() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:getSenseDemod1Demod2Data()	Test	Closed
LLR_RVDT_GETSENSEDEMOD1DEMOD2DATA_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the getSenseDemod1Demod2Data() function SHALL abort processing and return that driver failure status.	rvdt.c:getSenseDemod1Demod2Data()	Test	Closed
LLR_RVDT_GETSENSEDEMOD1DEMOD2DATA_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the getSenseDemod1Demod2Data() function SHALL read the RVDT module device block members memory offset (RVDT_SENSE1_SENSE2_DATA) at physical offset 0x02BC (MMAP_RVDT_SENSE1_SENSE2_DATA) using readRvdtReg().	rvdt.c:getSenseDemod1Demod2Data()	Test	Closed
LLR_RVDT_GETSENSEDEMOD1DEMOD2DATA_04	HLR_RVDT_18870	WHEN all operational processing completes successfully, the getSenseDemod1Demod2Data() function SHALL return DRV_SUCCESS.	rvdt.c:getSenseDemod1Demod2Data()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

readRvdtReg()

DriverStatus readRvdtReg ( const UInt32 baseAddress, const UInt32 offset, UInt32 * data )

static

readRvdtReg.

RVDT PCIe read function.

Parameters

[in]	baseAddress	The base address of the module and device.
[in]	offset	The offset address from module base address.
[out]	data	32bit data to read from PCIe.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: PCIe failed to read value.
DRV_INVALID_PARAM	: Address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: readRvdtReg

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_READRVDTREG_01	HLR_RVDT_18870	WHEN the pointer data is NULL (invalid), the readRvdtReg() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:readRvdtReg()	Test	Closed
LLR_RVDT_READRVDTREG_02	HLR_RVDT_18870	WHEN the pointer data is valid, the readRvdtReg() function SHALL read a 32-bit register value from physical memory address (baseAddress + addrOffset) into *data using PCIe primitive interDrv_Read32().	rvdt.c:readRvdtReg()	Test	Closed
LLR_RVDT_READRVDTREG_03	HLR_RVDT_18870	WHEN memory access via interDrv_Read32() fails (status not equal to INTF_SUCCESS), the readRvdtReg() function SHALL abort processing and return DRV_READ_FAILED.	rvdt.c:readRvdtReg()	Test	Closed
LLR_RVDT_READRVDTREG_04	HLR_RVDT_18870	WHEN all operational processing completes successfully, the readRvdtReg() function SHALL return DRV_SUCCESS.	rvdt.c:readRvdtReg()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_configBpfCoefficient()

DriverStatus rvdt_configBpfCoefficient	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt32	bpfFreq,
		const UInt32	bpfBandwidth )

rvdt_configBpfCoefficient.

Configure band pass filter coefficient.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	bpfFreq	BPF Center Frequency value in Hz
[in]	bpfBandwidth	Band pass filter bandwidth in Hz

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_configBpfCoefficient

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_01	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_configBpfCoefficient() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_02	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_configBpfCoefficient() function SHALL invoke routine floor() to execute target subsystem hardware operation.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_configBpfCoefficient() function SHALL invoke routine configSec1BpfB1() to execute target subsystem hardware operation.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_04	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_configBpfCoefficient() function SHALL invoke routine configSec2BpfB1() to execute target subsystem hardware operation.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_05	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_configBpfCoefficient() function SHALL invoke routine configSec1BpfA2() to execute target subsystem hardware operation.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_06	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_configBpfCoefficient() function SHALL invoke routine configSec2BpfA2() to execute target subsystem hardware operation.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGBPFCOEFFICIENT_07	HLR_RVDT_18873	WHEN all operational processing completes successfully, the rvdt_configBpfCoefficient() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_configBpfCoefficient()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_configLpfCoefficient()

DriverStatus rvdt_configLpfCoefficient	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt32	lpfFreq,
		const UInt32	lpfRate )

rvdt_configLpfCoefficient.

Configure low pass filter coefficient.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	lpfFreq	Low pass filter frequency (Hz).
[in]	lpfRate	Low pass filter rate (0 - 128us, 1 - 256us).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.
DRV_INVALID_VALUE	: The value is out of range.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_configLpfCoefficient

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_01	HLR_RVDT_18874	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_configLpfCoefficient() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_02	HLR_RVDT_18874	WHEN preconditions are satisfied, the rvdt_configLpfCoefficient() function SHALL invoke routine with() to execute target subsystem hardware operation.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_03	HLR_RVDT_18874	WHEN preconditions are satisfied, the rvdt_configLpfCoefficient() function SHALL invoke routine customRound() to execute target subsystem hardware operation.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_04	HLR_RVDT_18874	WHEN preconditions are satisfied, the rvdt_configLpfCoefficient() function SHALL invoke routine configSec1Lpf() to execute target subsystem hardware operation.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_05	HLR_RVDT_18874	WHEN preconditions are satisfied, the rvdt_configLpfCoefficient() function SHALL invoke routine configSec2Lpf() to execute target subsystem hardware operation.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed
LLR_RVDT_RVDT_CONFIGLPFCOEFFICIENT_06	HLR_RVDT_18874	WHEN all operational processing completes successfully, the rvdt_configLpfCoefficient() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_configLpfCoefficient()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_configSec1()

DriverStatus rvdt_configSec1	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt8	sense,
		const UInt8	gain,
		const UInt8	rate )

rvdt_configSec1.

Configure secondary 1 coil.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	sense	The secondary 1 sense value (0 - 1).
[in]	gain	The secondary 1 gain value (0 - 3).
[in]	rate	The demod 1 sample output rate (0 - 1).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_VALUE	: The sense, gain, or rate value exceed limit.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_configSec1

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_CONFIGSEC1_01	HLR_RVDT_18870	WHEN sense is greater than RVDT_MAX_CFG_SENSE or gain is greater than RVDT_MAX_CFG_GAIN or rate is greater than RVDT_MAX_CFG_RATE, the rvdt_configSec1() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:rvdt_configSec1()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC1_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_configSec1() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_configSec1()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC1_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_configSec1() function SHALL read the RVDT module device block members memory offset (RVDT_CFG_SEC1) at physical offset 0x0010 (MMAP_RVDT_CFG_SEC1) using readRvdtReg().	rvdt.c:rvdt_configSec1()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC1_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_configSec1() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC1) at physical offset 0x0010 (MMAP_RVDT_CFG_SEC1) using writeRvdtReg().	rvdt.c:rvdt_configSec1()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC1_05	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_configSec1() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_configSec1()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_configSec2()

DriverStatus rvdt_configSec2	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt8	sense,
		const UInt8	gain,
		const UInt8	rate )

rvdt_configSec2.

Configure secondary 2 coil.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	sense	The secondary 2 sense value (0 - 1).
[in]	gain	The secondary 2 gain value (0 - 3).
[in]	rate	The demod 2 sample output rate (0 - 1).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_VALUE	: The sense, gain, or rate value exceed limit.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_configSec2

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_CONFIGSEC2_01	HLR_RVDT_18870	WHEN sense is greater than RVDT_MAX_CFG_SENSE or gain is greater than RVDT_MAX_CFG_GAIN or rate is greater than RVDT_MAX_CFG_RATE, the rvdt_configSec2() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:rvdt_configSec2()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC2_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_configSec2() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_configSec2()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC2_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_configSec2() function SHALL read the RVDT module device block members memory offset (RVDT_CFG_SEC2) at physical offset 0x0014 (MMAP_RVDT_CFG_SEC2) using readRvdtReg().	rvdt.c:rvdt_configSec2()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC2_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_configSec2() function SHALL write the RVDT module device block members memory offset (RVDT_CFG_SEC2) at physical offset 0x0014 (MMAP_RVDT_CFG_SEC2) using writeRvdtReg().	rvdt.c:rvdt_configSec2()	Test	Closed
LLR_RVDT_RVDT_CONFIGSEC2_05	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_configSec2() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_configSec2()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_configWaveformGeneration()

DriverStatus rvdt_configWaveformGeneration	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt8	dacvcm,
		const UInt8	vocm,
		const UInt8	gain,
		const UInt8	mode,
		const Float32	voltageRms,
		const Float32	frequency )

rvdt_configWaveformGeneration.

Configure waveform generation.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	dacvcm	Differential offset adjustment value.
[in]	vocm	Differential mode output common mode.
[in]	gain	Reference gain.
[in]	mode	Single-ended mode or differential mode.
[in]	voltageRms	Operating vrms value.
[in]	frequency	Operating frequency value (Hz).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_INVALID_SIZE	: The size of the waveform table is invalid.
DRV_INVALID_PARAM	: The provided address pointer is invalid.
DRV_INVALID_VALUE	: The input value is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_configWaveformGeneration

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_01	HLR_RVDT_18870	WHEN any waveform configuration argument exceeds maximum hardware limits (gain > RVDT_MAX_WAVE_GAIN, dacvcm > RVDT_MAX_DACVCM, vocm > RVDT_MAX_VOCM, or mode > RVDT_MAX_WAVE_MODE), the rvdt_configWaveformGeneration() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_02	HLR_RVDT_18870	WHEN mode is equal to 0, the rvdt_configWaveformGeneration() function SHALL clear bit 7 (mode select) in the excitation waveform configuration data.	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_03	HLR_RVDT_18870	WHEN mode is not equal to 0, the rvdt_configWaveformGeneration() function SHALL set bit 7 (mode select) in the excitation waveform configuration data.	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_04	HLR_RVDT_18870	WHEN parameter validation passes, the rvdt_configWaveformGeneration() function SHALL calculate lookup table amplitude and write the excitation waveform pattern to FPGA memory map using writeRvdtReg().	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_05	HLR_RVDT_18870	WHEN any hardware register write operation fails (status not equal to DRV_SUCCESS), the rvdt_configWaveformGeneration() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed
LLR_RVDT_RVDT_CONFIGWAVEFORMGENERATION_06	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_configWaveformGeneration() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_configWaveformGeneration()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getCbit()

DriverStatus rvdt_getCbit	(	const RvdtDevHandler	rvdtDevHdl,
		RvdtCbitStatus *	cbitStatus )

rvdt_getCbit.

Get RVDT CBIT status.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	cbitStatus	The pointer of CBIT status value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getCbit

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETCBIT_01	HLR_RVDT_23601	WHEN the pointer cbitStatus is NULL (invalid), the rvdt_getCbit() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_02	HLR_RVDT_23601	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getCbit() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_03	HLR_RVDT_23601	WHEN querying RVDT Channel Bank 1, the rvdt_getCbit() function SHALL read common power-good, over-temperature, and supply rail fault status bits from the bank CBIT status register.	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_04	HLR_RVDT_23601	FOR each RVDT device bank, WHEN the demodulator configuration register does not match active status, the rvdt_getCbit() function SHALL set the configuration mismatch failure status for that bank.	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_05	HLR_RVDT_23601	FOR each configured RVDT device bank (0 through RVDT_DEV_CH_MAX - 1), the rvdt_getCbit() function SHALL calculate the register offset using MMAP_RVDT_DEV_OFFSET and read the bank CBIT Status Register (MMAP_RVDT_CBIT_STATUS) and Diagnostic Register via readRvdtReg().	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_06	HLR_RVDT_23601	WHEN preconditions are satisfied, the rvdt_getCbit() function SHALL invoke bitwise routine READ_BIT() to extract target channel status bit from register payload.	rvdt.c:rvdt_getCbit()	Test	Closed
LLR_RVDT_RVDT_GETCBIT_07	HLR_RVDT_23601	WHEN all operational processing completes successfully, the rvdt_getCbit() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getCbit()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getPbit()

DriverStatus rvdt_getPbit	(	const RvdtDevHandler	rvdtDevHdl,
		RvdtPbitStatus *	pbitStatus )

rvdt_getPbit.

Get RVDT PBIT status.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	pbitStatus	The pointer of PBIT status value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getPbit

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETPBIT_01	HLR_RVDT_323	WHEN the pointer pbitStatus is NULL (invalid), the rvdt_getPbit() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getPbit()	Test	Closed
LLR_RVDT_RVDT_GETPBIT_02	HLR_RVDT_323	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getPbit() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getPbit()	Test	Closed
LLR_RVDT_RVDT_GETPBIT_03	HLR_RVDT_323	WHEN querying RVDT Channel Bank 1, the rvdt_getPbit() function SHALL read the global PBIT execution completion status (MMAP_RVDT_POS_PBIT_BIT_DONE) from the PBIT status register.	rvdt.c:rvdt_getPbit()	Test	Closed
LLR_RVDT_RVDT_GETPBIT_04	HLR_RVDT_323	FOR each configured RVDT device bank (0 through RVDT_DEV_CH_MAX - 1), the rvdt_getPbit() function SHALL calculate the register offset using MMAP_RVDT_DEV_OFFSET and read the bank PBIT Status Register (MMAP_RVDT_PBIT_STATUS) via readRvdtReg().	rvdt.c:rvdt_getPbit()	Test	Closed
LLR_RVDT_RVDT_GETPBIT_05	HLR_RVDT_323	WHEN preconditions are satisfied, the rvdt_getPbit() function SHALL invoke bitwise routine READ_BIT() to extract target channel status bit from register payload.	rvdt.c:rvdt_getPbit()	Test	Closed
LLR_RVDT_RVDT_GETPBIT_06	HLR_RVDT_323	WHEN all operational processing completes successfully, the rvdt_getPbit() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getPbit()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getRefStatus()

DriverStatus rvdt_getRefStatus	(	const RvdtDevHandler	rvdtDevHdl,
		Bool *	opStatus )

rvdt_getRefStatus.

Get reference status in control command.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	opStatus	The operational status for reference.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getRefStatus

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETREFSTATUS_01	HLR_RVDT_16937	WHEN the pointer opStatus is NULL (invalid), the rvdt_getRefStatus() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getRefStatus()	Test	Closed
LLR_RVDT_RVDT_GETREFSTATUS_02	HLR_RVDT_16937	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getRefStatus() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getRefStatus()	Test	Closed
LLR_RVDT_RVDT_GETREFSTATUS_03	HLR_RVDT_16937	WHEN preconditions are satisfied, the rvdt_getRefStatus() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_getRefStatus()	Test	Closed
LLR_RVDT_RVDT_GETREFSTATUS_04	HLR_RVDT_16937	WHEN preconditions are satisfied, the rvdt_getRefStatus() function SHALL invoke bitwise routine READ_BIT() to extract target channel status bit from register payload.	rvdt.c:rvdt_getRefStatus()	Test	Closed
LLR_RVDT_RVDT_GETREFSTATUS_05	HLR_RVDT_16937	WHEN all operational processing completes successfully, the rvdt_getRefStatus() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getRefStatus()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getSensePosition()

DriverStatus rvdt_getSensePosition	(	const RvdtDevHandler	rvdtDevHdl,
		Float32 *	demod1Ptr,
		Float32 *	demod2Ptr,
		Float32 *	deltaVal,
		UInt32 *	adcVal1,
		UInt32 *	adcVal2 )

rvdt_getSensePosition.

Get sense position data.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	demod1Ptr	The demod 1 value.
[out]	demod2Ptr	The demod 2 value.
[out]	deltaVal	The demod delta value.
[out]	adcVal1	The adc 1 value.
[out]	adcVal2	The adc 2 value.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getSensePosition

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETSENSEPOSITION_01	HLR_RVDT_18870	WHEN the pointer demod1Ptr is NULL (invalid) or the pointer demod2Ptr is NULL (invalid) or the pointer deltaVal is NULL (invalid) or the pointer adcVal1 is NULL (invalid) or the pointer adcVal2 is NULL (invalid), the rvdt_getSensePosition() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getSensePosition()	Test	Closed
LLR_RVDT_RVDT_GETSENSEPOSITION_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getSensePosition() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getSensePosition()	Test	Closed
LLR_RVDT_RVDT_GETSENSEPOSITION_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_getSensePosition() function SHALL invoke routine getSenseDemod1Demod2Data() to execute target subsystem hardware operation.	rvdt.c:rvdt_getSensePosition()	Test	Closed
LLR_RVDT_RVDT_GETSENSEPOSITION_04	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_getSensePosition() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getSensePosition()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getSenseStatus()

DriverStatus rvdt_getSenseStatus	(	const RvdtDevHandler	rvdtDevHdl,
		Bool *	opStatus )

rvdt_getSenseStatus.

Get RVDT sense status in control command.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	opStatus	The operational status for sense.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getSenseStatus

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETSENSESTATUS_01	HLR_RVDT_18870	WHEN the pointer opStatus is NULL (invalid), the rvdt_getSenseStatus() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getSenseStatus()	Test	Closed
LLR_RVDT_RVDT_GETSENSESTATUS_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getSenseStatus() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getSenseStatus()	Test	Closed
LLR_RVDT_RVDT_GETSENSESTATUS_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_getSenseStatus() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_getSenseStatus()	Test	Closed
LLR_RVDT_RVDT_GETSENSESTATUS_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_getSenseStatus() function SHALL invoke bitwise routine READ_BIT() to extract target channel status bit from register payload.	rvdt.c:rvdt_getSenseStatus()	Test	Closed
LLR_RVDT_RVDT_GETSENSESTATUS_05	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_getSenseStatus() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getSenseStatus()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_getTemp()

DriverStatus rvdt_getTemp	(	const RvdtDevHandler	rvdtDevHdl,
		Float32 *	temp )

rvdt_getTemp.

Get RVDT temperature value in degree celsius (C).

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[out]	temp	The pointer of temperature value in degree celsius (C).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_getTemp

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_GETTEMP_01	HLR_RVDT_29269	WHEN the pointer temp is NULL (invalid), the rvdt_getTemp() function SHALL abort processing and return DRV_INVALID_PARAM.	rvdt.c:rvdt_getTemp()	Test	Closed
LLR_RVDT_RVDT_GETTEMP_02	HLR_RVDT_29269	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_getTemp() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_getTemp()	Test	Closed
LLR_RVDT_RVDT_GETTEMP_03	HLR_RVDT_29269	WHEN preconditions are satisfied, the rvdt_getTemp() function SHALL read the RVDT module device block members memory offset (RVDT_TEMP_RAW) at physical offset 0x028C (MMAP_RVDT_TEMP_RAW) using readRvdtReg().	rvdt.c:rvdt_getTemp()	Test	Closed
LLR_RVDT_RVDT_GETTEMP_04	HLR_RVDT_29269	WHEN all operational processing completes successfully, the rvdt_getTemp() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_getTemp()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_initDev()

DriverStatus rvdt_initDev

(

const RvdtDevHandler

rvdtDevHdl

)

rvdt_initDev.

Initialize RVDT device.

Parameters

[in]

rvdtDevHdl

The RVDT device handler.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_initDev

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_INITDEV_01	HLR_RVDT_31389	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_initDev() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_initDev()	Test	Closed
LLR_RVDT_RVDT_INITDEV_02	HLR_RVDT_31389	WHEN preconditions are satisfied, the rvdt_initDev() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_initDev()	Test	Closed
LLR_RVDT_RVDT_INITDEV_03	HLR_RVDT_31389	WHEN preconditions are satisfied, the rvdt_initDev() function SHALL invoke bitwise routine TOGGLE_BIT() to update hardware control bit in register payload.	rvdt.c:rvdt_initDev()	Test	Closed
LLR_RVDT_RVDT_INITDEV_04	HLR_RVDT_31389	WHEN preconditions are satisfied, the rvdt_initDev() function SHALL write the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using writeRvdtReg().	rvdt.c:rvdt_initDev()	Test	Closed
LLR_RVDT_RVDT_INITDEV_05	HLR_RVDT_31389	WHEN all operational processing completes successfully, the rvdt_initDev() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_initDev()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setPowerEnable()

DriverStatus rvdt_setPowerEnable	(	const RvdtDevHandler	rvdtDevHdl,
		const Bool	enable )

rvdt_setPowerEnable.

Set enable or disable power.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	enable	The flag to enable or disable.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setPowerEnable

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETPOWERENABLE_01	HLR_RVDT_18870	WHEN enable is FALSE, the rvdt_setPowerEnable() function SHALL configure power shutdown by setting bit 0 (shutdown) and clearing bit 1 (ADC reference disable) in register MMAP_RVDT_EN_PWR.	rvdt.c:rvdt_setPowerEnable()	Test	Closed
LLR_RVDT_RVDT_SETPOWERENABLE_02	HLR_RVDT_18870	WHEN enable is TRUE, the rvdt_setPowerEnable() function SHALL configure active power by clearing bit 0 (power up) and setting bit 1 (ADC reference enable) in register MMAP_RVDT_EN_PWR.	rvdt.c:rvdt_setPowerEnable()	Test	Closed
LLR_RVDT_RVDT_SETPOWERENABLE_03	HLR_RVDT_18870	WHEN power state configuration data is formulated, the rvdt_setPowerEnable() function SHALL write the command register using writeRvdtReg().	rvdt.c:rvdt_setPowerEnable()	Test	Closed
LLR_RVDT_RVDT_SETPOWERENABLE_04	HLR_RVDT_18870	WHEN the register write operation fails (status not equal to DRV_SUCCESS), the rvdt_setPowerEnable() function SHALL abort processing and return that failure status.	rvdt.c:rvdt_setPowerEnable()	Test	Closed
LLR_RVDT_RVDT_SETPOWERENABLE_05	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_setPowerEnable() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setPowerEnable()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setRefConfigCommand()

DriverStatus rvdt_setRefConfigCommand

(

const RvdtDevHandler

rvdtDevHdl

)

rvdt_setRefConfigCommand.

Set reference configure command.

Parameters

[in]

rvdtDevHdl

The RVDT device handler.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setRefConfigCommand

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETREFCONFIGCOMMAND_01	HLR_RVDT_16937	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_setRefConfigCommand() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_setRefConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETREFCONFIGCOMMAND_02	HLR_RVDT_16937	WHEN preconditions are satisfied, the rvdt_setRefConfigCommand() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_setRefConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETREFCONFIGCOMMAND_03	HLR_RVDT_16937	WHEN preconditions are satisfied, the rvdt_setRefConfigCommand() function SHALL invoke bitwise routine TOGGLE_BIT() to update hardware control bit in register payload.	rvdt.c:rvdt_setRefConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETREFCONFIGCOMMAND_04	HLR_RVDT_16937	WHEN preconditions are satisfied, the rvdt_setRefConfigCommand() function SHALL write the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using writeRvdtReg().	rvdt.c:rvdt_setRefConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETREFCONFIGCOMMAND_05	HLR_RVDT_16937	WHEN all operational processing completes successfully, the rvdt_setRefConfigCommand() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setRefConfigCommand()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setRefWaveEnable()

DriverStatus rvdt_setRefWaveEnable	(	const RvdtDevHandler	rvdtDevHdl,
		const Bool	enable )

rvdt_setRefWaveEnable.

Set RVDT reference waveform enable.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	enable	The flag to enable or disable.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setRefWaveEnable

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETREFWAVEENABLE_01	HLR_RVDT_16938	WHEN invoked, the rvdt_setRefWaveEnable() function SHALL read the current reference enable register MMAP_RVDT_EN_REF using readRvdtReg().	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed
LLR_RVDT_RVDT_SETREFWAVEENABLE_02	HLR_RVDT_16938	WHEN the register read operation fails (status not equal to DRV_SUCCESS), the rvdt_setRefWaveEnable() function SHALL abort processing and return that failure status.	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed
LLR_RVDT_RVDT_SETREFWAVEENABLE_03	HLR_RVDT_16938	WHEN enable is FALSE, the rvdt_setRefWaveEnable() function SHALL disable reference waveform generation by clearing bit 0 in register MMAP_RVDT_EN_REF.	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed
LLR_RVDT_RVDT_SETREFWAVEENABLE_04	HLR_RVDT_16938	WHEN enable is TRUE, the rvdt_setRefWaveEnable() function SHALL enable reference waveform generation by setting bit 0 in register MMAP_RVDT_EN_REF.	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed
LLR_RVDT_RVDT_SETREFWAVEENABLE_05	HLR_RVDT_16938	WHEN reference waveform control bit is updated, the rvdt_setRefWaveEnable() function SHALL write back the modified register value using writeRvdtReg().	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed
LLR_RVDT_RVDT_SETREFWAVEENABLE_06	HLR_RVDT_16938	WHEN all operational processing completes successfully, the rvdt_setRefWaveEnable() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setRefWaveEnable()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setS1s2Config()

DriverStatus rvdt_setS1s2Config	(	const RvdtDevHandler	rvdtDevHdl,
		const UInt8	vcmBias )

rvdt_setS1s2Config.

Set RVDT s1 and s2 configuration.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	vcmBias	The vcm bias value (0 - 3).

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_VALUE	: The vcmBias value exceed limit.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setS1s2Config

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETS1S2CONFIG_01	HLR_RVDT_18870	WHEN vcmBias is greater than RVDT_MAX_VCM_BIAS, the rvdt_setS1s2Config() function SHALL abort processing and return DRV_INVALID_VALUE.	rvdt.c:rvdt_setS1s2Config()	Test	Closed
LLR_RVDT_RVDT_SETS1S2CONFIG_02	HLR_RVDT_18870	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_setS1s2Config() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_setS1s2Config()	Test	Closed
LLR_RVDT_RVDT_SETS1S2CONFIG_03	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_setS1s2Config() function SHALL read the RVDT module device block members memory offset (RVDT_EN_SENSE) at physical offset 0x000C (MMAP_RVDT_EN_SENSE) using readRvdtReg().	rvdt.c:rvdt_setS1s2Config()	Test	Closed
LLR_RVDT_RVDT_SETS1S2CONFIG_04	HLR_RVDT_18870	WHEN preconditions are satisfied, the rvdt_setS1s2Config() function SHALL write the RVDT module device block members memory offset (RVDT_EN_SENSE) at physical offset 0x000C (MMAP_RVDT_EN_SENSE) using writeRvdtReg().	rvdt.c:rvdt_setS1s2Config()	Test	Closed
LLR_RVDT_RVDT_SETS1S2CONFIG_05	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_setS1s2Config() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setS1s2Config()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setSenseConfigCommand()

DriverStatus rvdt_setSenseConfigCommand

(

const RvdtDevHandler

rvdtDevHdl

)

rvdt_setSenseConfigCommand.

Set sense configure command.

Parameters

[in]

rvdtDevHdl

The RVDT device handler.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setSenseConfigCommand

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETSENSECONFIGCOMMAND_01	HLR_RVDT_16940	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_setSenseConfigCommand() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_setSenseConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSECONFIGCOMMAND_02	HLR_RVDT_16940	WHEN preconditions are satisfied, the rvdt_setSenseConfigCommand() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_setSenseConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSECONFIGCOMMAND_03	HLR_RVDT_16940	WHEN preconditions are satisfied, the rvdt_setSenseConfigCommand() function SHALL invoke bitwise routine TOGGLE_BIT() to update hardware control bit in register payload.	rvdt.c:rvdt_setSenseConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSECONFIGCOMMAND_04	HLR_RVDT_16940	WHEN preconditions are satisfied, the rvdt_setSenseConfigCommand() function SHALL write the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using writeRvdtReg().	rvdt.c:rvdt_setSenseConfigCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSECONFIGCOMMAND_05	HLR_RVDT_16940	WHEN all operational processing completes successfully, the rvdt_setSenseConfigCommand() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setSenseConfigCommand()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setSenseEnable()

DriverStatus rvdt_setSenseEnable	(	const RvdtDevHandler	rvdtDevHdl,
		const Bool	enable )

rvdt_setSenseEnable.

Set RVDT sense enable or disable.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	enable	The flag to enable or disable.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setSenseEnable

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETSENSEENABLE_01	HLR_RVDT_16942	WHEN invoked, the rvdt_setSenseEnable() function SHALL read the current demodulator control register MMAP_RVDT_CONTROL_CMD using readRvdtReg().	rvdt.c:rvdt_setSenseEnable()	Test	Closed
LLR_RVDT_RVDT_SETSENSEENABLE_02	HLR_RVDT_16942	WHEN the register read operation fails (status not equal to DRV_SUCCESS), the rvdt_setSenseEnable() function SHALL abort processing and return that failure status.	rvdt.c:rvdt_setSenseEnable()	Test	Closed
LLR_RVDT_RVDT_SETSENSEENABLE_03	HLR_RVDT_16942	WHEN enable is FALSE, the rvdt_setSenseEnable() function SHALL disable demodulator sense by clearing bit 1 in register MMAP_RVDT_CONTROL_CMD.	rvdt.c:rvdt_setSenseEnable()	Test	Closed
LLR_RVDT_RVDT_SETSENSEENABLE_04	HLR_RVDT_16942	WHEN enable is TRUE, the rvdt_setSenseEnable() function SHALL enable demodulator sense by setting bit 1 in register MMAP_RVDT_CONTROL_CMD.	rvdt.c:rvdt_setSenseEnable()	Test	Closed
LLR_RVDT_RVDT_SETSENSEENABLE_05	HLR_RVDT_16942	WHEN demodulator sense bit is updated, the rvdt_setSenseEnable() function SHALL write back the modified register value using writeRvdtReg().	rvdt.c:rvdt_setSenseEnable()	Test	Closed
LLR_RVDT_RVDT_SETSENSEENABLE_06	HLR_RVDT_16942	WHEN all operational processing completes successfully, the rvdt_setSenseEnable() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setSenseEnable()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setSenseFilterCommand()

DriverStatus rvdt_setSenseFilterCommand

(

const RvdtDevHandler

rvdtDevHdl

)

rvdt_setSenseFilterCommand

Set sense filter command.

Parameters

[in]

rvdtDevHdl

The RVDT device handler.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setSenseFilterCommand

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETSENSEFILTERCOMMAND_01	HLR_RVDT_18873	WHEN a driver operation reports a failure status other than DRV_SUCCESS, the rvdt_setSenseFilterCommand() function SHALL abort processing and return that driver failure status.	rvdt.c:rvdt_setSenseFilterCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSEFILTERCOMMAND_02	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_setSenseFilterCommand() function SHALL read the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using readRvdtReg().	rvdt.c:rvdt_setSenseFilterCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSEFILTERCOMMAND_03	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_setSenseFilterCommand() function SHALL invoke bitwise routine TOGGLE_BIT() to update hardware control bit in register payload.	rvdt.c:rvdt_setSenseFilterCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSEFILTERCOMMAND_04	HLR_RVDT_18873	WHEN preconditions are satisfied, the rvdt_setSenseFilterCommand() function SHALL write the RVDT module device block members memory offset (RVDT_CONTROL_CMD) at physical offset 0x0258 (MMAP_RVDT_CONTROL_CMD) using writeRvdtReg().	rvdt.c:rvdt_setSenseFilterCommand()	Test	Closed
LLR_RVDT_RVDT_SETSENSEFILTERCOMMAND_05	HLR_RVDT_18873	WHEN all operational processing completes successfully, the rvdt_setSenseFilterCommand() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setSenseFilterCommand()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

rvdt_setTestMux()

DriverStatus rvdt_setTestMux	(	const RvdtDevHandler	rvdtDevHdl,
		const Bool	enable )

rvdt_setTestMux

Set to test mux.

Parameters

[in]	rvdtDevHdl	The RVDT device handler.
[in]	enable	The flag to enable or disable.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: Failed to write to the device or module.
DRV_READ_FAILED	: Failed to read from the device or module.
DRV_INVALID_PARAM	: The provided address pointer is invalid.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: rvdt_setTestMux

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_RVDT_SETTESTMUX_01	HLR_RVDT_18870	WHEN invoked, the rvdt_setTestMux() function SHALL read the current multiplexer enable register MMAP_RVDT_EN_SENSE using readRvdtReg().	rvdt.c:rvdt_setTestMux()	Test	Closed
LLR_RVDT_RVDT_SETTESTMUX_02	HLR_RVDT_18870	WHEN the register read operation fails (status not equal to DRV_SUCCESS), the rvdt_setTestMux() function SHALL abort processing and return that failure status.	rvdt.c:rvdt_setTestMux()	Test	Closed
LLR_RVDT_RVDT_SETTESTMUX_03	HLR_RVDT_18870	WHEN enable is FALSE, the rvdt_setTestMux() function SHALL disable the test multiplexer channels by clearing bit 1 and bit 2 in register MMAP_RVDT_EN_SENSE.	rvdt.c:rvdt_setTestMux()	Test	Closed
LLR_RVDT_RVDT_SETTESTMUX_04	HLR_RVDT_18870	WHEN enable is TRUE, the rvdt_setTestMux() function SHALL enable the test multiplexer channels by setting bit 1 and bit 2 in register MMAP_RVDT_EN_SENSE.	rvdt.c:rvdt_setTestMux()	Test	Closed
LLR_RVDT_RVDT_SETTESTMUX_05	HLR_RVDT_18870	WHEN test multiplexer control bits are updated, the rvdt_setTestMux() function SHALL write back the modified register value using writeRvdtReg().	rvdt.c:rvdt_setTestMux()	Test	Closed
LLR_RVDT_RVDT_SETTESTMUX_06	HLR_RVDT_18870	WHEN all operational processing completes successfully, the rvdt_setTestMux() function SHALL return DRV_SUCCESS.	rvdt.c:rvdt_setTestMux()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function:

writeRvdtReg()

DriverStatus writeRvdtReg ( const UInt32 baseAddress, const UInt32 offset, const UInt32 data )

static

writeRvdtReg.

RVDT PCIe write function.

Parameters

[in]	baseAddress	The base address of the module and device.
[in]	offset	The offset address from module base address.
[in]	data	32bit data to write to PCIe.

Returns

DriverStatus - Driver status return code, If no error occurs during the operation of the function, it returns DRV_SUCCESS. Otherwise related error message is returned.

Return values

DRV_SUCCESS	: Success.
DRV_WRITE_FAILED	: PCIe failed to write value.

Low-Level Software Requirements (LLR)

Low-Level Requirement Specification: writeRvdtReg

Requirement ID	Parent HLR ID	Detailed Low-Level Requirement Statement (EARS Format)	Software Unit Reference	Verification Method	Status
LLR_RVDT_WRITERVDTREG_01	HLR_RVDT_18870	WHEN invoked, the writeRvdtReg() function SHALL write the 32-bit word data to physical memory address (baseAddress + addrOffset) using PCIe primitive interDrv_Write32().	rvdt.c:writeRvdtReg()	Test	Closed
LLR_RVDT_WRITERVDTREG_02	HLR_RVDT_18870	WHEN memory access via interDrv_Write32() fails (status not equal to INTF_SUCCESS), the writeRvdtReg() function SHALL abort processing and return DRV_WRITE_FAILED.	rvdt.c:writeRvdtReg()	Test	Closed
LLR_RVDT_WRITERVDTREG_03	HLR_RVDT_18870	WHEN all operational processing completes successfully, the writeRvdtReg() function SHALL return DRV_SUCCESS.	rvdt.c:writeRvdtReg()	Test	Closed

Control Coupling Diagram (CCD)

Control Coupling Structure Chart

Data Coupling Diagram (DCD)

Data Coupling Structure Chart

Control Flow Diagram (CFD)

Control Flow Diagram

Data Flow Diagram (DFD)

Data Flow Diagram

Here is the call graph for this function:

Here is the caller graph for this function: