Additive Scrambler: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
[[Category:Block Docs]]
[[Category:Block Docs]]
[[Category:Pages with no Example Flowgraph]]
Scramble an input stream using a Linear Feedback Shift Register (LFSR).
Scramble an input stream using a Linear Feedback Shift Register (LFSR).


Line 22: Line 21:
== Example Flowgraph ==
== Example Flowgraph ==


Insert description of flowgraph here, then show a screenshot of the flowgraph and the output if there is an interesting GUI. Currently we have no standard method of uploading the actual flowgraph to the wiki or git repo, unfortunately. The plan is to have an example flowgraph showing how the block might be used, for every block, and the flowgraphs will live in the git repo.
[[File:Additive_Scrambler_fg.png|800px]]
 
The state diagram for this flowgraph:
 
[[File:Additive_Scrambler_State_Diagram.png|500px]]
 
<p>This flowgraph can be downloaded from [[Media:Additive Scrambler.grc]].</p>
 
=== Generating Gold Codes ===
 
[https://en.wikipedia.org/wiki/Gold_code Gold Codes] can be generated using LSRFs, as explained [https://natronics.github.io/blag/2014/gps-prn/ here].
 
[[File:Additive Scrambler Gold Code fg.png|800px]]
 
Output:
 
[[File:Additive Scrambler Gold Code Plot fg.png|800px]]
 
<p>This flowgraph can be downloaded from [[Media:Additive Scrambler Gold Code.grc]].</p>


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

Revision as of 20:06, 25 May 2025

Scramble an input stream using a Linear Feedback Shift Register (LFSR).

This block scrambles up to 8 bits per byte of the input data stream, starting at the LSB. The scrambler works by XORing the incoming bit stream by the output of the LFSR. Optionally, after bits have been processed, the shift register is reset to the value. This allows processing fixed length vectors of samples.

Alternatively, the LFSR can be reset using a reset tag to scramble variable length vectors. However, it cannot be reset between bytes.

For details on configuring the LFSR, see gr::digital::lfsr.

Parameters

(R): Run-time adjustable

Mask
Polynomial mask for LFSR
Seed
Initial shift register contents
Length
Shift register length
Count
Number of bytes after which shift register is reset, 0=never
Bits per byte
Number of bits per byte
Reset tag key
When a tag with this key is detected, the shift register is reset (when this is set, count is ignored!)

Example Flowgraph

Additive Scrambler fg.png

The state diagram for this flowgraph:

Additive Scrambler State Diagram.png

This flowgraph can be downloaded from Media:Additive Scrambler.grc.

Generating Gold Codes

Gold Codes can be generated using LSRFs, as explained here.

Additive Scrambler Gold Code fg.png

Output:

Additive Scrambler Gold Code Plot fg.png

This flowgraph can be downloaded from Media:Additive Scrambler Gold Code.grc.

Source Files

C++ files
additive_scrambler_impl.cc
Header files
additive_scrambler_impl.h
Public header files
additive_scrambler.h
Block definition
digital_additive_scrambler_bb.block.yml