Talk:Guided Tutorial GNU Radio in C++


 * gr_modtool changes in 3.8:
 * gr_modtool nm doesn't exist anymore. Use newmod
 * Module creation adds a MANIFEST.md file now, in the format used by CGRAN.
 * Block creation asks for a copyright owner

Suggestion of YAML section:

Step 4 bis: Flesh out the YAML file
Since version 3.8, GNU Radio has replaced the The .yml provides the user interface between the OOT module displayed in the GRC and the source code. Moreover, the YAML file defines an interface to pass the parameters specific for the module. Hence, to access the module inside GRC, it is important to modify the .yml files manually. The YAML file for our block is named as  inside the   folder. Presently, the 's version looks like:

Default version: id: tutorial_my_qpsk_demod_cb label: my_qpsk_demod_cb category: '[tutorial]'

templates: imports: import tutorial make: tutorial.my_qpsk_demod_cb(${gray_code})

parameters: - id: ... label: ...  dtype: ... - id: ... label: ...  dtype: ...
 * 1)  Make one 'parameters' list entry for every parameter you want settable from the GUI.
 * 2)     Keys include:
 * 3)     * id (makes the value accessible as \$keyname, e.g. in the make entry)
 * 4)     * label (label shown in the GUI)
 * 5)     * dtype (e.g. int, float, complex, byte, short, xxx_vector, ...)

inputs: - label: ... domain: ...  dtype: ...  vlen: ...  optional: ...
 * 1)  Make one 'inputs' list entry per input and one 'outputs' list entry per output.
 * 2)  Keys include:
 * 3)      * label (an identifier for the GUI)
 * 4)      * domain (optional - stream or message. Default is stream)
 * 5)      * dtype (e.g. int, float, complex, byte, short, xxx_vector, ...)
 * 6)      * vlen (optional - data stream vector length. Default is 1)
 * 7)      * optional (optional - set to 1 for optional inputs. Default is 0)

outputs: - label: ... domain: ...  dtype: ...  vlen: ...  optional: ...

file_format: 1
 * 1)  'file_format' specifies the version of the GRC yml format used in the file
 * 2)  and should usually not be changed.

The parameter  can be put under the   tag.

Adding parameter tag:

parameters: - id: gray_code label: Gray Code dtype: bool default: 'True'

Like the work function, the datatypes for the input and output ports represented by  and   tags should be modified.

Modifying source and sink tag:

inputs: - label: in dtype: complex outputs: - label: out dtype: byte

After all the necessary modification the "tutorial_my_qpsk_demod_cb.block.yml" looks like this:

Modified version:

id: tutorial_my_qpsk_demod_cb label: My QPSK Demodulator category: '[tutorial]'

templates: imports: import tutorial make: tutorial.my_qpsk_demod_cb(${gray_code})

parameters: - id: gray_code label: Gray Code dtype: bool default: 'True'

inputs: - label: in dtype: complex outputs: - label: out dtype: byte.

file_format: 1