goFB

README

goFB

This program is a compiler for IEC61499 Function Blocks. Currently, there is support for IEC61499 to C, and experimental support for IEC61499 to VHDL.

goFB was inspired by the FBC compiler, and internally functions in a similiar way.

Support

goFB currently supports the following aspects of the IEC61499 standard

• Basic Function Blocks
• Service Interface Function Blocks
• Composite Function Blocks
• Resources
• Devices (Currently some aspects are supported)
• Systems

Special Extensions

It also supports an extension known as Hybrid Function Blocks (HFBs), which is currently pending publication. To examine support for HFBs, check out the examples/c_odes folder. The -cvode flag for goFB enables support for CVODE integration when compiling ODE Algorithm Language.

Build instructions

Build support is for the Windows environment only, as the IEC61499 IDE that is recommended for use with this project is BlokIDE, which only runs on Windows.

Firstly, you will need to have golang installed. This readme does not discuss how to set up your Go workspace.

Then, you will need to have some kind of gcc application installed - I recommend mingw-64.

Then, navigate to your Go workspace and go get github.com/kiwih/goFB this project.

Once you have acquired it, run go get -u then go build from within the project directory.

Usage:

Usage of goFB:
  -af
    	Automatically flatten out CFBs to save memory
  -alc
    	Enable checking algorithm language compatibility with output language.
  -cvode
    	Enable cvode for solving algorithms with 'ODE' and 'ODE_init' in comment field
  -i string
    	Specifies the name of the source file or directory of fbt-type files to be compiled.
  -l string
    	Specifies the output language for the program. (default "c")
  -o string
    	Specifies the name of the directory to put output files. If blank, uses current directory
  -t string
    	Specifies the name of the top level fbt-type file. If blank, no top file will be generated.
  -ti
    	(Experimental flag) Include the T-CREST header files in fbtypes.h
  -tsspm
    	(Experimental flag) When building for T-CREST processor, will put BFBs onto SPM before running/evicting them. Also includes -ti.
  -tuspm
    	(Experimental flag) When building for T-CREST processor, will put all FBs into _SPM memory. Also includes -ti

Examples

The examples directory provides support for creating your own networks with goFB.

Under the examples/c directory are the straightforward and simple examples that can be used immediately. Three example networks {BottlingPlant, Pointless, and testgoFB} are provided here.

Other examples

There are other examples, not recommended for casual use:

examples/c_odes provides networks used in testing HFB functionality.

examples/c_tcrest provides networks used in testing the support for the T-CREST embedded time-predictable platform.

examples/vhdl provides networks used in the experimentation for IEC61499-to-vhdl compilation.

Internal packages

• iec61499converter: This is responsible for converting IEC61499 xml into C (or in some cases, VHDL) code.
• postfix: This is a tiny package which converts math expressions from infix notation (i.e. 2+3) into postfix notation (i.e. 2 3 +).
• stconverter: This package converts a subset of IEC61131-3 Structured Text into C (or in some cases, VHDL) code.

Other directores:

• templates: This stores templates for iec61499converter.