SYF(1)

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).