Jump to content

Component: Level (DSP Outputs)

From Flowcode Help
Revision as of 15:20, 20 January 2023 by Wiki bot (talk | contribs)
Author Matrix Ltd
Version 1.2
Category DSP Outputs


Level component

Allows for detection and collection of peaks, troughs and averages.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_DSP_Level.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_DSP_Level.fcfx

Detailed description

No detailed description exists yet for this component

Examples

Here is a basic example of the Level component. The example collects the max, min and average readings from the buffer and displays them on the LCD display.

Level


The values in the buffer are defined using the InputADC component.


Min: Minimum (smallest) value read from the buffer.

Max: Maximum (largest) value read from the buffer.

Average: Rolling average calculated from the values inside the buffer.

Macro reference

ReadTroughArray
Returns the lowest value from the last "Decay" number of buffers. 
- UINT Return


ReadTrough
Returns the lowest value from the last "Decay" number of index locations. 
- LONG Return


ReadAverage
Returns the average from the last "Decay" number of index locations. 
- LONG Return


ReadPeakArray
Returns the highest value from the last "Decay" number of buffers. 
- UINT Return


ReadAverageArray
Returns the average from the last "Decay" number of buffers. 
- UINT Return


ReadPeak
Returns the highest value from the last "Decay" number of index locations. 
- LONG Return


ResetRecords
Allows the peak and trough to be reset back to default values. 
- BOOL ResetPeak
 
- BOOL ResetTrough
 
- VOID Return



Property reference

Properties
Connect To
DSP component with output buffer to collect our data from. 
Decay on Peak/Trough
Yes - The Peak and Trough value will only be maintained for the decay number of buffers. No - The record Peak and Trough values will be maintained until reset. 
Decay
Configures how many buffers or values to allow a record to persist 

==Macro reference==

ReadTroughArray
Returns the lowest value from the last "Decay" number of buffers. 
- UINT Return


ReadTrough
Returns the lowest value from the last "Decay" number of index locations. 
- LONG Return


ReadAverage
Returns the average from the last "Decay" number of index locations. 
- LONG Return


ReadPeakArray
Returns the highest value from the last "Decay" number of buffers. 
- UINT Return


ReadAverageArray
Returns the average from the last "Decay" number of buffers. 
- UINT Return


ReadPeak
Returns the highest value from the last "Decay" number of index locations. 
- LONG Return


ResetRecords
Allows the peak and trough to be reset back to default values. 
- BOOL ResetPeak
 
- BOOL ResetTrough
 
- VOID Return



Property reference

Properties
Connect To
DSP component with output buffer to collect our data from. 
Decay on Peak/Trough
Yes - The Peak and Trough value will only be maintained for the decay number of buffers. No - The record Peak and Trough values will be maintained until reset. 
Decay
Configures how many buffers or values to allow a record to persist 

==Macro reference==

ReadTroughArray
Returns the lowest value from the last "Decay" number of buffers. 
- UINT Return


ReadTrough
Returns the lowest value from the last "Decay" number of index locations. 
- LONG Return


ReadAverage
Returns the average from the last "Decay" number of index locations. 
- LONG Return


ReadPeakArray
Returns the highest value from the last "Decay" number of buffers. 
- UINT Return


ReadAverageArray
Returns the average from the last "Decay" number of buffers. 
- UINT Return


ReadPeak
Returns the highest value from the last "Decay" number of index locations. 
- LONG Return


ResetRecords
Allows the peak and trough to be reset back to default values. 
- BOOL ResetPeak
 
- BOOL ResetTrough
 
- VOID Return



Property reference

Properties
Connect To
DSP component with output buffer to collect our data from. 
Decay on Peak/Trough
Yes - The Peak and Trough value will only be maintained for the decay number of buffers. No - The record Peak and Trough values will be maintained until reset. 
Decay
Configures how many buffers or values to allow a record to persist