Additive Scrambler: Difference between revisions
No edit summary |
No edit summary |
||
(5 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Block Docs]] | [[Category:Block Docs]] | ||
Scramble an input stream using | 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. | This block scrambles up to 8 bits per byte of the input data stream, starting at the LSB. | ||
Line 7: | Line 7: | ||
Alternatively, the LFSR can be reset using a reset tag to scramble variable length vectors. However, it cannot be reset between bytes. | 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. | For details on configuring the LFSR, see [https://www.gnuradio.org/doc/doxygen/classgr_1_1digital_1_1lfsr.html gr::digital::lfsr]. | ||
== Parameters == | == Parameters == | ||
Line 21: | Line 21: | ||
== Example Flowgraph == | == Example Flowgraph == | ||
[[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 LFSRs, 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 == | ||
; C++ files | ; C++ files | ||
: [https://github.com/gnuradio/gnuradio | : [https://github.com/gnuradio/gnuradio/blob/main/gr-digital/lib/additive_scrambler_impl.cc additive_scrambler_impl.cc] | ||
; Header files | ; Header files | ||
: [https://github.com/gnuradio/gnuradio | : [https://github.com/gnuradio/gnuradio/blob/main/gr-digital/lib/additive_scrambler_impl.h additive_scrambler_impl.h] | ||
; Public header files | ; Public header files | ||
: [https://github.com/gnuradio/gnuradio | : [https://github.com/gnuradio/gnuradio/blob/main/gr-digital/include/gnuradio/digital/additive_scrambler.h additive_scrambler.h] | ||
; Block definition | ; Block definition | ||
: [https://github.com/gnuradio/gnuradio | : [https://github.com/gnuradio/gnuradio/blob/main/gr-digital/grc/digital_additive_scrambler_bb.block.yml digital_additive_scrambler_bb.block.yml] |
Latest revision as of 19:47, 26 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
The state diagram for this flowgraph:
This flowgraph can be downloaded from Media:Additive Scrambler.grc.
Generating Gold Codes
Gold Codes can be generated using LFSRs, as explained here.
Output:
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