VHDL Source: olo_intf_sync
This component implements a double stage synchronizer for synchronizing external signals to the internal clock. It also sets all the attributes required for proper synthesis. Note that this synchronizer does not guarantee that all bits arrive in the same clock cycle at the destination clock domain, therefore it can only be used for independent single-bit signals. Do not use it to transfer multi-bit signals (e.g. numbers) where it is important that all the bits are updated in the same clock cycle.
It is suggested to use this entity only for synchronizing external signals. For synchronizing FPGA internal signals between clocks, the clock crossings in base shall be used (olo_base_cc_...).
For AMD tools (Vivado) an automatic constraint file exists, which automatically identifies all olo_intf_sync instances and constrains them correctly. To use the automatic constraints file, follow the steps described in clock crossing principles but use the constraints file source <path-to-open-logic>/src/intf/tcl/constraints_amd.tcl
Note: Automatic constraining currently only works for AMD tools (Vivado) and the usage in VHDL. Manual constraints are required for Verilog or other tools.
| Name | Type | Default | Description |
|---|---|---|---|
| Width_g | positive | 1 | Number of data bits to implement the synchronizer for |
| RstLevel_g | std_logic | '0' | Value to set the synchronizer registers to upon reset. Usually this does not play any role but if the value does not match the idle-state of the synchronized signal, a pulse is observed in the first two clock cycles after reset. This can be avoided by setting RstLevel_g to the idle-state of the signals synchronized. |
| Name | In/Out | Length | Default | Description |
|---|---|---|---|---|
| Clk | in | 1 | - | Clock |
| Rst | in | 1 | '0' | Reset input (high-active, synchronous to Clk) For synchronizers the reset is normally not required. |
| DataAsync | in | Width_g | - | Vector of independent input bits (asynchronous external input). |
| DataSync | out | Width_g | N/A | Vector of synchronized output bits (synchronous to Clk) |
The signal is synchronized using an ordinary two-stage synchronizer.
The VHDL code contains all synthesis attributes required to ensure correct behavior of tools (e.g. avoid mapping of the synchronizer FFs into shift registers) for the most common FPGA vendors AMD and Intel.