Selector: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(add message ports)
 
(One intermediate revision by the same user not shown)
Line 29: Line 29:


; Input index
; Input index
: The 'iindex' message port accepts only <b>raw</b> PMT messages of the form <code>pmt.from_long(index)</code>
: The 'iindex' message port accepts a PMT message pair such as <code>pmt.cons(pmt.PMT_NIL, pmt.from_long(iindex))</code>


; Output index
; Output index
: The 'oindex' message port accepts only <b>raw</b> PMT messages of the form <code>pmt.from_long(index)</code>
: The 'oindex' message port accepts a PMT message pair such as <code>pmt.cons(pmt.PMT_NIL, pmt.from_long(oindex))</code>


== Example Flowgraph ==
== Example Flowgraph ==


=== Using Parameters ===
This example flowgraph is located in [https://github.com/gnuradio/gnuradio/blob/master/gr-blocks/examples/selector.grc]
This example flowgraph is located in [https://github.com/gnuradio/gnuradio/blob/master/gr-blocks/examples/selector.grc]


Line 42: Line 43:
In this example, there are three input signals, which can be directed by the parameters of the selector block to one of two of the output ports.  In the case where the input is set to 0 and the output is set to 0, we get the cosine signal passing from input 0 to Output 0.  In this case Output 1 produces no samples.
In this example, there are three input signals, which can be directed by the parameters of the selector block to one of two of the output ports.  In the case where the input is set to 0 and the output is set to 0, we get the cosine signal passing from input 0 to Output 0.  In this case Output 1 produces no samples.


[[File:Selector_output_1.png|800px]]


[[File:Selector_output_1.png]]
If we change the output index to 1, and the input index to 1, we see the triangle wave produced at output 1.  Output 0 in this case is producing no output samples, but the QT GUI Time sink does not update the display.


If we change the output index to 1, and the input index to 1, we see the triangle wave produced at output 1. Output 0 in this case is producing no output samples, but the QT GUI Time sink does not update the display.
[[File:Selector_output_2.png|800px]]
 
=== Using Messages ===
Messages can be used to enable the block and to select the input and output ports. Here is a snippet of a flowgraph to illustrate:


[[File:Selector_output_2.png]]
[[File:Selector_demo_fg.png|800px]]


== Source Files ==
== Source Files ==

Latest revision as of 10:52, 19 June 2024

Connect the sink at input index to the source at output index. Samples from other input ports are consumed and dumped. Other output ports produce no samples.

output[output_index][i] = input[input_index][i]

Parameters

(R): Run-time adjustable

Enabled (R)
Whether or not input gets copied to output.
NOTE: Selector block prior to GR 3.8 does not have Enabled parameter
Number of Inputs
Number of input streams
Number of Outputs
Number of output streams
Input Index (R)
Used to choose which input stream gets used. It is typical for this to be changed in realtime using e.g. a QT GUI Chooser
Output Index (R)
Used to choose which output stream gets the input copied to it. It is typical for this to be changed in realtime using e.g. a QT GUI Chooser

Messages

Enable
The 'en' message port accepts only raw PMT messages of the form pmt.to_pmt(False) or pmt.to_pmt(True)
Input index
The 'iindex' message port accepts a PMT message pair such as pmt.cons(pmt.PMT_NIL, pmt.from_long(iindex))
Output index
The 'oindex' message port accepts a PMT message pair such as pmt.cons(pmt.PMT_NIL, pmt.from_long(oindex))

Example Flowgraph

Using Parameters

This example flowgraph is located in [1]

Selector example flowgraph.png

In this example, there are three input signals, which can be directed by the parameters of the selector block to one of two of the output ports. In the case where the input is set to 0 and the output is set to 0, we get the cosine signal passing from input 0 to Output 0. In this case Output 1 produces no samples.

Selector output 1.png

If we change the output index to 1, and the input index to 1, we see the triangle wave produced at output 1. Output 0 in this case is producing no output samples, but the QT GUI Time sink does not update the display.

Selector output 2.png

Using Messages

Messages can be used to enable the block and to select the input and output ports. Here is a snippet of a flowgraph to illustrate:

Selector demo fg.png

Source Files

C++ files
[2]
Header files
[3]
Public header files
[4]
Block definition
[5]