This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
resources:tools-software:sigmastudiov2:modules:basic:singlebandleveldetector [11 May 2021 11:35] – [DSP Parameters] Nikhin Shetty | resources:tools-software:sigmastudiov2:modules:basic:singlebandleveldetector [14 Sep 2022 12:16] (current) – Updates Image Angu Sewa | ||
---|---|---|---|
Line 3: | Line 3: | ||
\\ | \\ | ||
{{: | {{: | ||
+ | \\ | ||
+ | {{: | ||
+ | \\ | ||
+ | {{: | ||
+ | ===== Variants ===== | ||
+ | -Single Band Level Detector | ||
+ | -Level Detector Designer (RTA to OUTPUT) | ||
+ | -Level Detector Designer (Pass Through) | ||
+ | -Single Band Level Detector (Direct Read) | ||
+ | -Level Detector Low DSP MIPS | ||
+ | -Single Band Level Detector (Running Average) | ||
===== Description ===== | ===== Description ===== | ||
The Single Band Level Detector blocks calculate the input signal level, reading directly from the hardware in real time, and display the level graphically in meter displays. The Single-Level Detector calculates and displays the rms level of the signal, shown in dB. | The Single Band Level Detector blocks calculate the input signal level, reading directly from the hardware in real time, and display the level graphically in meter displays. The Single-Level Detector calculates and displays the rms level of the signal, shown in dB. | ||
The level detector performs analysis only and does not modify the input signal. The signal at the output pin is identical to the input. | The level detector performs analysis only and does not modify the input signal. The signal at the output pin is identical to the input. | ||
+ | |||
\\ | \\ | ||
+ | Single Band Level Detector (Direct Read) module is similar to the Single Level Detector w Numeric Display. However, the calculations are split between the DSP and SigmaStudio. The DSP calculates the level of the signal in dB, as dB = 20*Log(SampleValue), | ||
+ | |||
+ | \\ | ||
+ | The Level Detector Low DSP MIPS block acts as an audio sample readback register. The DSP does not perform any level detector calculations. Instead, SigmaStudio reads back the sample, converts it to dB, and performs averaging. As with the Direct Read algorithm, transient peaks may be missed by this level detector. | ||
+ | |||
+ | \\ | ||
+ | Level Detector Designer (Pass Through) module algorithm receives a 8.24 number (8 bytes to represent the integer portion of the value, 24 bytes for the decimal portion) during readback and converts it to a decimal value represented in decibels. This is what is seen on the display bar. Because this is a passthrough system, the output is the same signal being sent to the block. | ||
+ | |||
+ | \\ | ||
+ | Level Detector Designer (RTA to OUTPUT) module algorithm outputs the rms level value through the output pin. This pin is red because no actual audio is being sent out, just the level values for each frequency band. Observe that when you grow this algorithm, each pin corresponds to a frequency band. | ||
+ | \\ | ||
+ | |||
===== Usage ===== | ===== Usage ===== | ||
Use the On / Off button to enable or disable the display. The level detector will not function until the schematic design has been compiled and downloaded to the hardware and a USB communication channel is properly configured. | Use the On / Off button to enable or disable the display. The level detector will not function until the schematic design has been compiled and downloaded to the hardware and a USB communication channel is properly configured. | ||
The refresh rate of the display is approximately 10 Hz, while the green cross-bar tracks the maximum rms value with a slight delay. Note that the display' | The refresh rate of the display is approximately 10 Hz, while the green cross-bar tracks the maximum rms value with a slight delay. Note that the display' | ||
+ | |||
\\ | \\ | ||
- | ===== Variants ===== | + | Level Detector Designer (RTA to OUTPUT) |
- | -Single Band Level Detector | + | The default block contains only one color bar, but when you grow your algorithm you can account for multiple frequency bands. |
- | -Level Detector Designer (RTA to OUTPUT) | + | To make the most of your level detector, it's important to understand the parameters in the designer window. The parameters are Filter type, Center Frequency, and Q or Bandwidth depending on filter type. There also is an overall Time Constant and Decay value that can be set in dB/s to control the refresh time. |
- | -Level Detector Designer (Pass Through) | + | |
- | | + | |
- | | + | |
- | | + | |
===== Targets Supported ===== | ===== Targets Supported ===== | ||
^ Name ^ ADSP-214xx ^ ADSP-215xx/ | ^ Name ^ ADSP-214xx ^ ADSP-215xx/ | ||
Line 41: | Line 63: | ||
^ GUI Parameter | ^ GUI Parameter | ||
| ---------------------------------------- | ---------------------- | ------------------ | ---------------------------------------- | | | ---------------------------------------- | ---------------------- | ------------------ | ---------------------------------------- | | ||
- | | On/Off Switch | OFF | + | | On/Off Switch | OFF |
+ | | Stage<fc # | ||
+ | | Stage<fc # | ||
+ | | Stage<fc # | ||
+ | | Stage<fc # | ||
+ | | Time Constant | 10 | 10 to 1000 | This value, in dB/s, designates the averaging time of the detector: how rapidly it assesses and responds to signal level changes (Only applicable for Pass-through & RTA to Output )| | ||
+ | | Decay | 0 | 0 to 1000 | Another type of time constant, Decay designates the rate at which signal returns to a lower detected level. Decay is responsible for releasing the signal at the given rate (Only applicable for Pass-through & RTA to Output )| | ||
+ | | NumStages| 1 | 1 to 14| Number of stages (Only applicable for Pass-through & RTA to Output ). Change in this value requires re-compilation | | ||
+ | Note: | ||
+ | * <fc # | ||
\\ | \\ | ||
===== DSP Parameters ===== | ===== DSP Parameters ===== | ||
^ Parameter Name ^ Description ^ ADSP-214xx/ | ^ Parameter Name ^ Description ^ ADSP-214xx/ | ||
| ---------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------- | | | ---------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------- | | ||
- | |TimeConstant|Used to calculate the RMS Value of the input signal. The time constant determines how rapidly the compressor will respond to input signal level changes, e.g. the “Attack” time |Float| | + | |TimeConstant | Used to calculate the RMS Value of the input signal. The time constant determines how rapidly the compressor will respond to input signal level changes, e.g. the “Attack” time |Float|FixPoint8d24| |
- | |Log | Constant Log Coefficients| Float| | + | |Log | Constant Log Coefficients| Float|NA| |
- | |Decay | Controls the rate at which the compressor gain decreases in response to decrease in the input signal level, e.g. the “Release” time | Float| | + | |Decay | Controls the rate at which the compressor gain decreases in response to decrease in the input signal level, e.g. the “Release” time | Float|FixPoint8d24| |
- | |Hold|Controls the time (in ms) the compressor maintains its current output | + | |Hold|Controls the time (in ms) the compressor maintains its current output |
- | | ReadBack | Reads the RMS level of the input signal | Float| | + | | ReadBack | Reads the RMS level of the input signal | Float|NA| |
| LinX| Reads the level of the input signal | NA |FixPoint8d24| | | LinX| Reads the level of the input signal | NA |FixPoint8d24| | ||
| LinX_lo | Reads the level of the input signal | NA |FixPoint8d24| | | LinX_lo | Reads the level of the input signal | NA |FixPoint8d24| | ||
+ | | level| Reads the level of the input signal | NA |FixPoint8d24| | ||
\\ | \\ | ||
===== DSP Parameter Computation ===== | ===== DSP Parameter Computation ===== |