SET_OSC_OUTPUT_FREQ

The SET_OSC_OUTPUT_FREQ function sets the oscillator output frequency, in Hz. The oscillator output is one of the available pin types which can be set in the Pin Mapping.

If an initial oscillator output frequency has been specified in the Pin Mapping, the initial frequency will be set during hardware initialisation after power and soft grounds have been enabled. The frequency selected will stay selected until it is modified again using this function or the current tests finish.

When used inside a HOLDOFF block, HOLDOFF is temporarily disabled and all held off writes are performed. The frequency is then changed and HOLDOFF is re-enabled.

SET_OSC_OUTPUT_FREQ was added in XJTAG v3.11 and is not recognised in versions prior to that.

Syntax

SET_OSC_OUTPUT_FREQ ( frequency )

Parameters

frequency

The frequency to set the oscillator at in Hz. Possible values are between 10 kHz and 166 MHz in increments of 10 kHz.

If the frequency is set to zero then the output will be set to a high-impedance state.

If the frequency requested is not possible, then the value will always be rounded down, unless a value less than the minimum has been requested, in which case it will be set to 10 kHz. GET_OSC_OUTPUT_FREQ can be used to discover the actual frequency selected.

Example

SetOscOutputFreq(INT freq)()
  SET_OSC_OUTPUT_FREQ(freq);
  freq := GET_OSC_OUTPUT_FREQ();	
  PRINT("The OSC_OUTPUT frequency has been set to: ", freq, " Hz.\n");
END;