ADC DC Measurement

R2026b

Measure DC performance metrics of ADC output

Libraries:
Mixed-Signal Blockset / ADC / Measurements & Testbenches

Description

The ADC DC Measurement block measures ADC DC performance metrics such as offset error, gain error, integral nonlinearity (INL), and differential nonlinearity (DNL). You can use ADC DC Measurement block to validate the ADC architectural models provided in Mixed-Signal Blockset™, or you can use an ADC of your own implementation.

Ports

Input

expand all

analog — Analog input signal to ADC
scalar

Analog input signal to ADC block, specified as a scalar.

Data Types: double

start — External conversion start clock
scalar

External conversion start clock, specified as a scalar. The analog to digital conversion process starts at the rising edge of the signal at the start port.

Data Types: double

digital — Converted digital signal from ADC
scalar

Converted digital signal from an ADC, specified as a scalar.

ready — Indicates whether analog to digital conversion is complete
scalar

Indicates whether the analog to digital conversion is complete, specified as a scalar.

Data Types: double

Parameters

expand all

Input range (V) — Dynamic range of ADC
`[-1 1]` (default) | 2-element vector

Dynamic range of the ADC, specified as a 2-element vector in V. The two vector elements represent the minimum and maximum values of the dynamic range, from left to right.

Programmatic Use

Use get_param(gcb,'InputRange') to view the current value of Input range.
Use set_param(gcb,'InputRange',value) to set Input range to a specific value.

Hold off time (s) — Delays measurement analysis to avoid corruption by transients
`0` (default) | nonnegative real scalar

Delays measurement analysis to avoid corruption by transients, specified as a nonnegative real scalar in seconds.

Programmatic Use

Use get_param(gcb,'HoldOffTime') to view the current value of Hold off time.
Use set_param(gcb,'HoldOffTime',value) to set Hold off time to a specific value.

Number of bits — Number of physical bits in ADC
`5` (default) | positive real integer

Number of physical bits in ADC, specified as a unitless positive real integer. Number of bits must match the resolution specified in the ADC block.

Programmatic Use

Use get_param(gcb,'NBits') to view the current Number of bits.
Use set_param(gcb,'NBits',value) to set Number of bits to a specific value.

Start conversion frequency (Hz) — Frequency of the start conversion clock of ADC
`10e6` (default) | positive real scalar

Frequency of the start conversion clock of the ADC, specified as a positive real scalar in hertz. Start conversion frequency must match the frequency of the start conversion clock of the ADC block. This parameter is used to calculate Recommended simulation stop time.

Programmatic Use

Use get_param(gcb,'Frequency') to view the current value of Start conversion frequency.
Use set_param(gcb,'Frequency',value) to set Start conversion frequency to a specific value.

Recommended min. simulation stop time (s) — Minimum time simulation must run for meaningful result
`3.2e-5` (default) | positive real scalar

Minimum time the simulation must run to obtain meaningful results, specified as a positive real scalar in seconds.

For DC measurement, the simulation must run so that ADC can sample each digital code 10 times with the default error tolerance of 0.1, assuming a ramp input that traverses the full scale range of the ADC over the period of simulation. Based on this assumption, the analog input frequency (f_analog), generated by the ADC Testbench block for the sawtooth waveform is set as:

$f_{analog} = \frac{S t a r t F r e q \cdot E r r o r T o l e r a n c e}{2^{(N b i t s + 1)}}$

where StartFreq is the frequency of the conversion start clock and Nbits is the resolution of the ADC.

So, the Recommended min. simulation stop time (s) (T) is calculated by using the formula: $T = \frac{1}{f_{analog}} + H o l d O f f T i m e$ .

Data Types: double

Set as model stop time — Automatically set recommended min. simulation stop time as model stop time
button

Click to automatically set the Recommended min. simulation stop time (s) as the stop time of the Simulink^® model.

Endpoint — Measure DNL, INL using endpoint method
on (default) | off

Measure the differential nonlinearity (DNL) error and integral nonlinearity (INL) error using the endpoint method. This method uses the end points of the actual transfer function to measure the DNL and INL error.

Best fit — Measure DNL, INL using best fit method
on (default) | off

Measure the differential nonlinearity (DNL) error and integral nonlinearity (INL) error using the best fit method. This method uses a standard curve fitting technique to find the best fit to measure the DNL and INL error.

Output result to base workspace — Store detailed test results to base workspace
off (default) | on

Store detailed test results to a struct in the base workspace for further processing. By default, this option is not selected.

Workspace variable name — Name of the variable that stores detailed test results
`adc_dc_out` (default) | character string

Name of the variable that stores detailed test results, specified as a character string.

Dependencies

This parameter is only available when Output result to base workspace is selected

Programmatic Use

Use get_param(gcb,'VariableName') to view the current value of Workspace variable name.
Use set_param(gcb,'VariableName',value) to set Workspace variable name to a specific value.

Plot — Plot measurement results
button

Click to plot measurement result for further analysis.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"msbAdcMeasurements/ADC DC Measurement"

Example: add_block("msbAdcMeasurements/ADC DC Measurement","myModel/myBlock",MakeNameUnique="on")

More About

expand all

Offset Error

Offset error represents the offset of the ADC transfer function curve from it ideal value at a single point.

Gain Error

Gain error represents the deviation of the slope of the ADC transfer function curve from its ideal value.

INL Error

Integral nonlinearity (INL) error, also termed as relative accuracy, is the maximum deviation of the measured transfer function from a straight line. The straight line is can be a best fit using standard curve fitting technique, or drawn between the end points of the actual transfer function after gain adjustment.

The best fit method gives a better prediction of distortion in AC applications, and a lower value of linearity error. The endpoint method is mostly used in measurement application of data converters, since the error budget depends on the actual deviation from ideal transfer function.

DNL Error

Differential nonlinearity (DNL) is the deviation from the ideal difference (1 LSB) between analog input levels that trigger any two successive digital output levels. The DNL error is the maximum value of DNL found at any transition.

Version History

Introduced in R2019a

ADC DC Measurement

Description

Ports

Input

analog — Analog input signal to ADC
scalar

start — External conversion start clock
scalar

digital — Converted digital signal from ADC
scalar

ready — Indicates whether analog to digital conversion is complete
scalar

Parameters

Input range (V) — Dynamic range of ADC
`[-1 1]` (default) | 2-element vector

Programmatic Use

Hold off time (s) — Delays measurement analysis to avoid corruption by transients
`0` (default) | nonnegative real scalar

Programmatic Use

Number of bits — Number of physical bits in ADC
`5` (default) | positive real integer

Programmatic Use

Start conversion frequency (Hz) — Frequency of the start conversion clock of ADC
`10e6` (default) | positive real scalar

Programmatic Use

Recommended min. simulation stop time (s) — Minimum time simulation must run for meaningful result
`3.2e-5` (default) | positive real scalar

Set as model stop time — Automatically set recommended min. simulation stop time as model stop time
button

Endpoint — Measure DNL, INL using endpoint method
on (default) | off

Best fit — Measure DNL, INL using best fit method
on (default) | off

Output result to base workspace — Store detailed test results to base workspace
off (default) | on

Workspace variable name — Name of the variable that stores detailed test results
`adc_dc_out` (default) | character string

Dependencies

Programmatic Use

Plot — Plot measurement results
button

Programmatic Use: Add Block

More About

Offset Error

Gain Error

INL Error

DNL Error

Version History

See Also

Topics

ADC DC Measurement

Description

Ports

Input

analog — Analog input signal to ADC scalar

start — External conversion start clock scalar

digital — Converted digital signal from ADC scalar

ready — Indicates whether analog to digital conversion is complete scalar

Parameters

Input range (V) — Dynamic range of ADC [-1 1] (default) | 2-element vector

Programmatic Use

Hold off time (s) — Delays measurement analysis to avoid corruption by transients 0 (default) | nonnegative real scalar

Programmatic Use

Number of bits — Number of physical bits in ADC 5 (default) | positive real integer

Programmatic Use

Start conversion frequency (Hz) — Frequency of the start conversion clock of ADC 10e6 (default) | positive real scalar

Programmatic Use

Recommended min. simulation stop time (s) — Minimum time simulation must run for meaningful result 3.2e-5 (default) | positive real scalar

Set as model stop time — Automatically set recommended min. simulation stop time as model stop time button

Endpoint — Measure DNL, INL using endpoint method on (default) | off

Best fit — Measure DNL, INL using best fit method on (default) | off

Output result to base workspace — Store detailed test results to base workspace off (default) | on

Workspace variable name — Name of the variable that stores detailed test results adc_dc_out (default) | character string

Dependencies

Programmatic Use

Plot — Plot measurement results button

Programmatic Use: Add Block

More About

Offset Error

Gain Error

INL Error

DNL Error

Version History

See Also

Topics

analog — Analog input signal to ADC
scalar

start — External conversion start clock
scalar

digital — Converted digital signal from ADC
scalar

ready — Indicates whether analog to digital conversion is complete
scalar

Input range (V) — Dynamic range of ADC
`[-1 1]` (default) | 2-element vector

Hold off time (s) — Delays measurement analysis to avoid corruption by transients
`0` (default) | nonnegative real scalar

Number of bits — Number of physical bits in ADC
`5` (default) | positive real integer

Start conversion frequency (Hz) — Frequency of the start conversion clock of ADC
`10e6` (default) | positive real scalar

Recommended min. simulation stop time (s) — Minimum time simulation must run for meaningful result
`3.2e-5` (default) | positive real scalar

Set as model stop time — Automatically set recommended min. simulation stop time as model stop time
button

Endpoint — Measure DNL, INL using endpoint method
on (default) | off

Best fit — Measure DNL, INL using best fit method
on (default) | off

Output result to base workspace — Store detailed test results to base workspace
off (default) | on

Workspace variable name — Name of the variable that stores detailed test results
`adc_dc_out` (default) | character string

Plot — Plot measurement results
button