Manpages

NAME

SYF − Finite State Machine synthesizer.

SYNOPSIS

syf −a|j|m|u|o|r [−CDEOPRSTV] input_name [output_name]

DESCRIPTION

syf is a Finite State Machine synthesizer. syf allows a fast generation of VHDL Data Flow description (see vbe(5)) from a VHDL Finite State Machine description (see fsm(5)). The input FSM specification can use an internal STACK. Both MOORE and MEALEY FSMs can be synthesized, with output registers if desired. For a MOORE FSM, a timing−optimized implementation that emulates a ROM with microsequencer is possible. A scan-path for the state registers can also be implemented.

ENVIRONMENT VARIABLES

MBK_WORK_LIB(1)

indicates the path to the read/write directory for the session.

OPTIONS

−a

Uses "Asp" as encoding algorithm.

−j

Uses "Jedi" as encoding algorithm.

−m

Uses "Mustang" as encoding algorithm.

−u

Uses an encoding given by user through <input_name>.enc file. In this file, a line started by a # character is a comment. A valid line contains one state name followed by its hexadecimal code.

−o

Uses the one hot encoding algorithm.

−r

Uses distinct random numbers for state encoding.

−C

Checks the transition’s consistency.

−D

With this option syf doesn’t optimize unused, i.e Don’t Care, codes.

−E

Saves the encoding result in the <output_name>.enc. This file has the same syntax as <input_name>.enc file which is used by −u option.

−O

With this option syf places registers on the outputs.

−P

Implements a scan-path for the state registers, stack registers and possibly output registers. Scan-path mechanism is directely included in states decoder. Users should use scapin(5) for a correct insertion of a scan-path in a netlist. Please check fsm(5) for information about scan-path descriptions.

−R

This option is only available for MOORE FSM. With this option, syf emulate s a ROM with micro−sequencer implementation : there is no combinatorial logic between the state registers and the FSM outputs. This can be mandatory for external timing constraints. See fsm(5) and grog(1) for more on ROM descriptions.

−S

With this option syf doesn’t take into account the cost of the transitions to compute an encoding.

−V

Verbose mode on. Each step of the FSM synthesis is displayed on the standard output, along with some statistics.

EXAMPLE

Environment variables:
setenv MBK_WORK_LIB /alliance/tutorials/dlxm

syf is called as follow (the dlx_ctrl.fsm is already created in /alliance/tutorials/dlxm) :

syf -sE dlx_ctrl

Two files will be generated, a states encoding file dlx_ctrls.enc and a VHDL data flow file /alliance/tutorials/dlxm/dlx_ctrls.vbe

SEE ALSO

fsm(5), vbe(5), vhdl(5), boom(1), boog(1), loon(1), scapin(1), asimut(1), proof(1), MBK_WORK_LIB(1).