HFC 4S-8S

This driver supports Cologne Chip's HFC 4S and HFC 8S chip based cards.

Supported features:

• PCI bus mode
• FSM data flow
• S/T ports in TE and NT mode
• PCM port (not yes)

Driver attributes

• debug_level

  Read: reports the current debug level.

  Write: changes the driver's debug level.

  • 0: No debugging
  • 1: Rare and interesting messages
  • 2: More frequent messages
  • 3: Frames dump
  • 4: Frames dump with Z/F counters

  Note: This attribute is present only if the driver has been compiled in debug mode.

Device attributes

• bert_cnt

  Read: reports the number of BERT errors received

  Write: N/A

• bert_err

  Read: N/A

  Write: Introduces an intentional error in the BERT generated sequence

• bert_inv

  Read: BERT 0=normal/1=inverted mode

  Write: Sets the BERT inverted mode

• bert_mode

  Read: Current BERT generator sequence type

  Write: Sets the BERT generator sequence type

  ’’’’’’’0’ = continuous ’0’ pattern
  ’’’’’’’1’ = continuous ’1’ pattern
  ’’’’’’’2’ = sequence length 29−1 bits
  ’’’’’’’3’ = sequence length 210−1 bits
  ’’’’’’’4’ = sequence length 215−1 bits
  ’’’’’’’5’ = sequence length 220−1 bits
  ’’’’’’’6’ = sequence length 220−1 bits, but maximal 14 bits are zero
  ’’’’’’’7’ = pseudo random pattern seq. 223−1
  

• clock_source_config

  Read: report current clock source configured. auto=automatic clock source selection, decimal number 0-7 = S/T port 0-7

  Write: sets the clock source

• clock_source_current

  Read: report current clock source being used by the chip.

  Write: N/A

• dip_switches

  Read: reports the state of dip switches position

  Write: N/A

• fifo_state

  Read: reports the state of all the available FIFOs in the card

  Write: N/A

• output_level

  Read: reports the configured output level

  Write: sets the output level generated via the PWM output. 0=lowest level, FF=highest level

• ram_bandwidth

  Read: reports the used ram bandwidth percentage

  Write: N/A

• ram_size

  Read: reports the current RAM size

  Write: configures the available on-board RAM 32 = 32 kiBytes (on-chip memory), 128 = 128 kiBytes (external memory), 512 = 512 kiBytes (external memory).

  Note: Configure an external memory only if an external RAM is present on the board.

S/T port attributes

• enabled

  Read: reports the current state, 0=disabled, 1=enabled

  Write: enabled/disables the port.

  In order to avoid interferences on the S/T bus the port is disabled upon registration and should be enabled after configured appropriately.

• l1_state

  Read: reports the current state.

  Write: Writing a decimal number forces a fixed state to be set, writing the activate string causes activation to be initiated, writing deactivate string caused deactivation to be initiated.

  Example:
  echo "activate" > l1_state

• port_id

  Read: reports the port id locally to the card

  Write: N/A

• role

  Read: reports the port's role on the S/T bus. Possible values are "TE" (Terminal Equipment) and "NT" (Network Terminator).

  Write: Sets the role. To avoid disruption of the S/T bus functionality make sure to configure one and only one NT port within the S/T bus.

• st_clock_delay

  Read: reports the current port's clock delay parameter. Please refer to Cologne Chip's documentation for further details.

  Write: Sets the clock delay parameter. Avoid changing this parameter if you don't know what you're doing as it may disrupt the S/T bus functionality.

• st_sampling_comp

  Read: reports the current port's sampling compensation parameter. Please refer to Cologne Chip's documentation for further details.

  Write: Sets the sampling compensation parameter. Avoid changing this parameter if you don't know what you're doing as it may disrupt the S/T bus functionality.

PCM port attributes

• bitrate

  Read: reports the current PCM port bitrate.

  Write: Sets the PCM port bitrate. Available values are 2=2Mbit/s, 4=4Mbit/s, 8=8Mbit/s.

• enabled

  Read: reports the current state, 0=disabled, 1=enabled

  Write: enabled/disables the port.

  In order to avoid interferences on the S/T bus the port is disabled upon registration and should be enabled after configured appropriately.

• f0io_counter

  Read: reports the current value of the F0IO counter. It may be useful to diagnose if the chip is receiving the clock from the PCM bus in slave configuration.

  Write: N/A

• master

  Read: reports the current master/slave mode (0=slave, 1=master)

  Write: sets the master/slave mode for the bus.

  Note: If the card is configured in slave mode but no master provides the clock on the PCM bus, most chip functions will not work.

• port_id

  Read: reports the port id locally to the card

  Write: N/A

• slots_state

  Read: reports the state of all the available PCM timeslots

  Write: N/A

Channel attributes

• bert_enabled

  Read: Reports the current state

  Write: Connects the channel to the BERT generator