Difference between revisions of "YAML GRC"

From GNU Radio
Jump to: navigation, search
m (Tiny indentation fix)
m (Cosmetic change, moved some text)
Line 2: Line 2:
  
 
The most notable change is of course the absence of XML’s angle brackets in favour of YAML’s colon-separated keys and values, and the change in file names for blocks. The latter is important for GRC to recognise the file. Namely, the “.xml” ending has been replaced with “.block.yml” for block descriptions and the underscore in block tree files has been replaced with a dot. (For example, “qtgui_tree.xml” becomes “qtgui.tree.yml”)
 
The most notable change is of course the absence of XML’s angle brackets in favour of YAML’s colon-separated keys and values, and the change in file names for blocks. The latter is important for GRC to recognise the file. Namely, the “.xml” ending has been replaced with “.block.yml” for block descriptions and the underscore in block tree files has been replaced with a dot. (For example, “qtgui_tree.xml” becomes “qtgui.tree.yml”)
 +
 +
== Block Descriptions ==
  
 
The content of the block descriptions is still the same, although it has been shuffled around a bit. The parts are elaborated below, in the order they should appear in the files.
 
The content of the block descriptions is still the same, although it has been shuffled around a bit. The parts are elaborated below, in the order they should appear in the files.
 
== Block Descriptions ==
 
  
 
=== ID ===
 
=== ID ===

Revision as of 18:11, 23 July 2018

Starting with release 3.8, XML replaces YAML as the file format for GNU Radio Companion. This is triggered by switching from Cheetah to Mako as the templating engine, since Cheetah does not support Python 3. Specifically, this will impact .grc files, block descriptions and block tree files. This article won’t focus on the .grc files, because they aren’t meant for manual editing.

The most notable change is of course the absence of XML’s angle brackets in favour of YAML’s colon-separated keys and values, and the change in file names for blocks. The latter is important for GRC to recognise the file. Namely, the “.xml” ending has been replaced with “.block.yml” for block descriptions and the underscore in block tree files has been replaced with a dot. (For example, “qtgui_tree.xml” becomes “qtgui.tree.yml”)

Block Descriptions

The content of the block descriptions is still the same, although it has been shuffled around a bit. The parts are elaborated below, in the order they should appear in the files.

ID

1 id: blocks_multiply_const_vxx
2 label: Multiply Const
3 
4 parameters:
5 -   id: type
6 label: IO Type
7 (...)

The ID is unique for each block and is used to identify it.

Label

1 id: blocks_multiply_const_vxx
2 label: Multiply Const
3 
4 parameters:
5 -   id: type
6 label: IO Type
7 (...)

The label is simply the human-readable name of the block, and will be visible from within GRC. It will not appear in the generated code.

Flags (optional)

1 id: blocks_throttle
2 label: Throttle
3 flags: throttle
4 
5 parameters:
6 -   id: type
7 label: Type
8 (...)

The flags indicate special attributes of the block. The only current example of this is the throttle flag, which is used in the Throttle and hardware blocks. For more information on throttling, see the Guided Tutorial: [1]

Parameters

Inputs

Outputs

Asserts (optional)

 1 (...)    
 2     dtype: ${ type }
 3     vlen: ${ vlen }
 4 
 5 asserts:
 6 - ${ vlen > 0 }
 7 
 8 templates:
 9     imports: from gnuradio import blocks
10     make: blocks.throttle(${type.size}*${vlen}, ${samples_per_second},${ignoretag})
11 (...)

Asserts (previously known as "checks" for the XML blocks) are expressions that need to be true, otherwise GRC won't let you generate the flowgraph.

Templates

Imports

Make

Callbacks

File Format

Others

Variable Make

Variable Value

Block Tree Files