Difference between revisions of "Component: Delay (DSP)"

From Flowcode Help
Jump to navigationJump to search
(XML import)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
+
{| style="width:50%"
 
 
{| width="50%"
 
 
|-
 
|-
| width="20%" style="color: gray;" | Author
+
| width="20%" style="color:gray;" | Author
 
| Matrix Ltd
 
| Matrix Ltd
 
|-
 
|-
| width="20%" style="color: gray;" | Version
+
| width="20%" style="color:gray;" | Version
| 1.2 (Release)
+
| 1.2
 
|-
 
|-
| width="20%" style="color: gray;" | Category
+
| width="20%" style="color:gray;" | Category
 
| DSP
 
| DSP
 
|}
 
|}
  
  
 
+
==Delay component==
==[[File:Component Icon e0ddc704_6bab_4d08_8f10_19a14c6683ef.png|Image]] Delay component==
 
 
Allows an adjustable delay to be inserted into the DSP system
 
Allows an adjustable delay to be inserted into the DSP system
  
==Examples==
+
==Component Pack==
Here is a simple example file for the Delay component.
 
{{Fcfile|Delay.fcfx|Delay}}
 
The DelayADC component is used to set the amount of delay that the component provides 0-2550 samples in steps of 10 samples.
 
  
 +
DSP
  
The Input ADC component is used to pass a variable value into the DSP chain to allow the delay to be simulated.
+
==Detailed description==
  
  
Here is a picture showing the scope response of the delay component.
 
  
[[File:DSPDelay.jpg]]
 
  
  
Note: 8-bit PICs can only reference an array of up to 256 elements. Anything more then this will cause compilation errors. There is a workaround documented on the user forums on how to get around this limitation but it adds overhead to the rest of the program.
 
  
==Downloadable macro reference==
 
  
===<span style="font-weight: normal;"><u><tt>DelayTick</tt></u></span>===
 
Passes a single value from a buffer into the delay buffer and spits out a delayed value at the other end
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
+
''No detailed description exists yet for this component''
  
:''This call does not return a value''
+
==Examples==
  
  
===<span style="font-weight: normal;"><u><tt>Delay</tt></u></span>===
 
Passes an entire buffer into the delay buffer and spits out a delayed version of the buffer at the other end
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
  
===<span style="font-weight: normal;"><u><tt>SetDelaySize</tt></u></span>===
 
Specifies the number of values in the delay buffer to allow the length of the delay to  be adjustable during runtime.
 
  
'''Parameters'''
 
  
:[[Variable Types|UINT]] ''Delay_Count''
 
  
 +
Here is a simple example file for the Delay component.
  
'''Return value'''
+
{{Fcfile|Delay.fcfx|Delay}}
  
:''This call does not return a value''
+
The DelayADC component is used to set the amount of delay that the component provides 0-2550 samples in steps of 10 samples.
  
  
 +
The Input ADC component is used to pass a variable value into the DSP chain to allow the delay to be simulated.
  
==Simulation macro reference==
 
  
''This component does not contain any simulation macros''
+
Here is a picture showing the response of the delay component using the data recorder window.
  
 +
[[File:DSPDelay.jpg]]
  
==Property reference==
+
==Downloadable macro reference==
<span style="font-weight: normal;"><u>Max Delay Count</u></span>
 
  
This property is of type ''Signed integer'' and can be referenced with the variable name ''max_delay''.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''DelayArray'''
 +
|-
 +
| colspan="2" | Passes an entire buffer into the delay buffer and spits out a delayed version of the buffer at the other end&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
The maximum number of values to delay the incoming signal by
 
  
<span style="font-weight: normal;"><u>Initial Delay Count</u></span>
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Delay'''
 +
|-
 +
| colspan="2" | Passes a single value from a buffer into the delay buffer and spits out a delayed value at the other end&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
This property is of type ''Signed integer'' and can be referenced with the variable name ''initial_delay''.
 
  
The initial delay that will be used at startup
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetDelaySize'''
 +
|-
 +
| colspan="2" | Specifies the number of values in the delay buffer to allow the length of the delay to  be adjustable during runtime.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 +
| width="90%" | Delay_Count
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
<span style="font-weight: normal;"><u>Buffer Manager</u></span>
 
  
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''buffer_manager''.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''PresetDelay'''
 +
|-
 +
| colspan="2" | Presets the contents of the delay buffer with the specified value.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 +
| width="90%" | Value
 +
|-
 +
| colspan="2" | &nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
Specifies the DSP system buffer manager
 
  
<span style="font-weight: normal;"><u>Input</u></span>
 
  
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''input_a''.
 
  
Specifies the buffer which is used as the input to the delay
+
==Property reference==
  
<span style="font-weight: normal;"><u>Output</u></span>
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 
+
|-
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''output_c''.
+
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
 
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
Specifies the buffer which is used as the output to the delay
+
|-
 
+
|-
<span style="font-weight: normal;"><u>Sample Rate (Hz)</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Connect To
This property is of type ''Floating point'' and can be referenced with the variable name ''sample_rate''.
+
|-
 
+
| colspan="2" | DSP component with output buffer to collect our data from.&nbsp;
Sample rate used to generate some useful calculations
+
|-
 
+
| width="10%" align="center" | [[File:Fc9-type-21-icon.png]]
<span style="font-weight: normal;"><u>Max Delay (s)</u></span>
+
| width="90%" | Buffer Size
 
+
|-
This property is of type ''Floating point'' and can be referenced with the variable name ''del_max''.
+
| colspan="2" | Number of individual elements the buffer can store, default 1.&nbsp;
 
+
|-
Maximum possible delay in seconds at the specified sample rate
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
+
| width="90%" | Buffer Type
<span style="font-weight: normal;"><u>Initial Delay (s)</u></span>
+
|-
 
+
| colspan="2" | Sets the buffer data type.&nbsp;
This property is of type ''Floating point'' and can be referenced with the variable name ''del_initial''.
+
|-
 
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
Initial delay in seconds at the specified sample rate
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Delay
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
 +
| width="90%" | Initial Delay Count
 +
|-
 +
| colspan="2" | The initial delay that will be used at startup&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
 +
| width="90%" | Max Delay Count
 +
|-
 +
| colspan="2" | The maximum number of values to delay the incoming signal by&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
 +
| width="90%" | Initial Value
 +
|-
 +
| colspan="2" | Value used to preset the delay buffer.&nbsp;
 +
|-
 +
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 +
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Delay Calculation
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
 +
| width="90%" | Sample Rate (Hz)
 +
|-
 +
| colspan="2" | Sample rate used to generate some useful calculations&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
 +
| width="90%" | Max Delay (s)
 +
|-
 +
| colspan="2" | Maximum possible delay in seconds at the specified sample rate&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-15-icon.png]]
 +
| width="90%" | Initial Delay (s)
 +
|-
 +
| colspan="2" | Initial delay in seconds at the specified sample rate&nbsp;
 +
|}

Latest revision as of 17:19, 9 November 2022

Author Matrix Ltd
Version 1.2
Category DSP


Delay component

Allows an adjustable delay to be inserted into the DSP system

Component Pack

DSP

Detailed description

No detailed description exists yet for this component

Examples

Here is a simple example file for the Delay component.

FC6 Icon.png Delay

The DelayADC component is used to set the amount of delay that the component provides 0-2550 samples in steps of 10 samples.


The Input ADC component is used to pass a variable value into the DSP chain to allow the delay to be simulated.


Here is a picture showing the response of the delay component using the data recorder window.

DSPDelay.jpg

Downloadable macro reference

Fc9-comp-macro.png DelayArray
Passes an entire buffer into the delay buffer and spits out a delayed version of the buffer at the other end 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png Delay
Passes a single value from a buffer into the delay buffer and spits out a delayed value at the other end 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png SetDelaySize
Specifies the number of values in the delay buffer to allow the length of the delay to be adjustable during runtime. 
Fc9-u16-icon.png - UINT Delay_Count
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png PresetDelay
Presets the contents of the delay buffer with the specified value. 
Fc9-u16-icon.png - UINT Value
 
Fc9-void-icon.png - VOID Return



Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Connect To
DSP component with output buffer to collect our data from. 
Fc9-type-21-icon.png Buffer Size
Number of individual elements the buffer can store, default 1. 
Fc9-type-16-icon.png Buffer Type
Sets the buffer data type. 
Fc9-conn-icon.png Delay
Fc9-type-14-icon.png Initial Delay Count
The initial delay that will be used at startup 
Fc9-type-14-icon.png Max Delay Count
The maximum number of values to delay the incoming signal by 
Fc9-type-14-icon.png Initial Value
Value used to preset the delay buffer. 
Fc9-conn-icon.png Delay Calculation
Fc9-type-15-icon.png Sample Rate (Hz)
Sample rate used to generate some useful calculations 
Fc9-type-15-icon.png Max Delay (s)
Maximum possible delay in seconds at the specified sample rate 
Fc9-type-15-icon.png Initial Delay (s)
Initial delay in seconds at the specified sample rate