Python Block Message Passing
The previous tutorial, Creating Your First Block, demonstrates how to create a Python block using the Embedded Python Block. The next tutorial, Low Pass Filter Example, demonstrates how to use filtering blocks in GNU Radio.
Message Overview
Messages are an asynchronous way to send information between blocks. Messages are good at conveying control data, maintaining a consistent state across blocks and providing some forms of non-data feedback to blocks in a flowgraph.
Messages have a couple unique properties:
- There is no sample-clock based guarantee when messages will arrive
- Messages are not associated with a specific sample like a tag
- Message input and output ports do not have to be connected in GRC
- Message ports use the Polymorphic Type (PMT)
Message ports are denoted by a grey color and their connections are distinguished by dashed lines:
More information on message passing and PMTs can be found here: Message Passing
Starting the Message Passing Flowgraph
The following flowgraph will demonstrate how to:
- Add message sending and receiving ports to Python blocks
- Transmit messages
- Receive and handle messages
- Adapt block behavior in the work() function based on a received messages
Two custom Embedded Python Blocks will be created to:
- Select, or multiplex, one of two input signals based on a receive message
- Count the number of samples and send a message to the multiplexing block to switch inputs
Start by adding the following blocks to the flowgraph and connecting them:
- Noise Source
- Signal Source
- Two Python Block
- Throttle
- QT GUI Time Sink
- Message Debug
Creating a Multiplexer Python Block
This tutorial assumes you have already created at least one Embedded Python Block. If not, please complete the tutorial Creating Your First Block before moving on.
Double-click the first Embedded Python Block and open the source in the editor:
Add a second input to the block:
in_sig=[np.complex64, np.complex64],
PMT
describe basic PMT types
link against other PMT pages
Creating a Message Output Port
- saving code 'compiles' the python and error messages are displayed the EPB window
- message ports do not have to be connected like stream/vector ports
The next tutorial, Low Pass Filter Example, demonstrates how to use filtering blocks in GNU Radio.