id: apollo_ranging_source
label: Apollo Ranging Source
category: '[Apollo USB]'
flags: [python]

parameters: []

outputs:
- label: out
  domain: stream
  dtype: byte

templates:
  imports: from apollo.ranging_source import ranging_source
  make: apollo.ranging_source.ranging_source()

documentation: |-
  Apollo PRN Ranging Source

  Generates a continuous stream of PRN ranging code chips (bytes 0 or 1).
  The composite code combines CL, X, A, B, and C component sequences
  using majority-vote logic: output = (NOT(X) AND maj(A,B,C)) XOR CL

  Code length: 5,456,682 chips (~5.49 seconds at 993,963 chips/sec)
  The code repeats cyclically.

  The full code period is pre-generated at startup, so the first call
  has a brief delay while the sequence is computed.

file_format: 1