Additive LFSR Scrambler

Verilog problems / Sequential Design

What you must build

Whiten a data stream by XORing it with a free-running LFSR keystream — the same circuit that descrambles it, since XOR is its own inverse.

Engineers use “Additive LFSR Scrambler” as a building block in sequential design. Interviewers ask for the same ports and the same corner cases this judge covers. Completing it in the browser is the same skill as writing synthesizable RTL at work, minus the EDA license.

Port contract

The judge instantiates exactly these ports. Extra ports or a different module name fail to elaborate.

How to approach this kata

This is a hard kata. Sketch the state bits and the illegal overlaps (full/empty, wrap, simultaneous enable) on paper first. A design that “usually works” in your head will fail a directed corner in the hidden tests.

Hidden tests instantiate top_module, drive the ports, and compare every sample against a golden model. They do not grade coding style. They do grade X/Z, off-by-one counters, and ignoring enables. Sign in only when you want the run saved on the leaderboard — the specification below is public.

Starter shape

Copy this skeleton into the editor (or press Reset starter). Fill the body; do not rename the module.

module top_module(
  input  clk,
  input  rst,
  input  data_in,
  output scrambled_out
);

  // Your code here — 7-bit LFSR, seed 7'h7F, fb=lfsr[6]^lfsr[0], free-running; scrambled_out = data_in ^ lfsr[6].

endmodule

Why this shows up in interviews

Additive LFSR Scrambler sits under Sequential Design (sequential, lfsr, protocol). Concept: Line codes avoid long runs of identical bits by scrambling data with a pseudo-random keystream from a free-running 7-bit LFSR ( fb = lfsr[6]^lfsr[0] , shifting every cycle regardless of the data). The output is simply data_in ^ lfsr[6] . Because XOR is its own inverse, feeding the scrambled output back through an identically-seeded LFSR recovers the original data — descrambling needs no separate circuit.

A passing solution is synthesizable intent: no delays in the DUT, no initial blocks inside top_module, and no reference to testbench tasks. Use blocking assignments only in combinational always blocks; use non-blocking for registers clocked by clk.

Related problems

• D Flip-Flop with Asynchronous Reset — Standard D flip-flop with an active-low asynchronous reset. Reset clears q immediately, without waiting for a clock edge.
• 4-Bit Shift Register (SIPO) — Serial-in, parallel-out shift register. Each clock, shift left and load sin into the LSB. Sync active-high reset clears q.
• JK Flip-Flop — The flip-flop with no forbidden state: j=k=1 toggles instead of racing. Classic building block for counters.
• 4-Bit Up/Down Counter — A synchronous counter that increments or decrements each clock edge depending on a direction input, with a synchronous reset.

FAQ