https://github.com/chipsalliance/fasm

FPGA Assembly (FASM) Parser and Generator
https://github.com/chipsalliance/fasm

bitstream bitstream-format f4pga fasm fpga fpga-assembly parser symbiflow

Last synced: 4 days ago
JSON representation

FPGA Assembly (FASM) Parser and Generator

• Host: GitHub
• URL: https://github.com/chipsalliance/fasm
• Owner: chipsalliance
• License: apache-2.0
• Created: 2018-10-19T00:42:26.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-07-25T14:57:14.000Z (over 2 years ago)
• Last Synced: 2024-11-01T02:35:45.228Z (9 days ago)
• Topics: bitstream, bitstream-format, f4pga, fasm, fpga, fpga-assembly, parser, symbiflow
• Language: Python
• Homepage: https://fasm.readthedocs.io
• Size: 4.92 MB
• Stars: 90
• Watchers: 15
• Forks: 30
• Open Issues: 32
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## FPGA Assembly (FASM) Parser and Generation library

This repository documents the FASM file format and provides parsing libraries and simple tooling for working with FASM files.

It provides both a pure Python parser based on `textx` and a significantly faster C parser based on `ANTLR`. The library will try and use the ANTLR parser first and fall back to the `textx` parser if the compiled module is not found.

Which parsers are supported by your currently install can be found via `python3 -c "import fasm.parser as p; print(p.available)`. The currently in use parser can be found via `fasm.parser.implementation`.

It is highly recommended to use the ANTLR parser as it is about 15 times faster.

functions for parsing and generating FASM files.

## Build Instructions

CMake is required, and ANTLR has a few dependencies:

    sudo apt install cmake default-jre-headless uuid-dev libantlr4-runtime-dev

Pull dependencies in `third_party`:

    git submodule update --init

Build:

    make build

Test with:

    python setup.py test

The ANTLR runtime can either be linked statically or as a shared library. Use the

`--antlr-runtime=[static|shared]` flag to select between the two modes e.g.:

    python setup.py install --antlr-runtime=shared

Or, using `pip`:

    pip install . --install-option="--antlr-runtime=shared" --no-use-pep517

The runtime will be built and statically linked by default. This flag is available in the build_ext, build, develop, and install commands.

The --no-use-pep517 flag is needed because there is currently no way to pass flags with PEP517.

Relevant issue: https://github.com/pypa/pip/issues/5771

## FPGA Assembly (FASM)

FPGA Assembly is a file format designed by the

[F4PGA Project](https://f4pga.org/) developers to provide a plain

text file format for configuring the internals of an FPGA.

It is designed to allow FPGA place and route to not care about the *actual*

bitstream format used on an FPGA.

![FASM Ecosystem Diagram](docs/_static/image/fasm-diagram.png)

### Properties

 * Removing a line from a FASM file leaves you with a valid FASM file.

 * Allow annotation with human readable comments.

 * Allow annotation with "computer readable" comments.

 * Has syntactic sugar for expressing memory / lut init bits / other large

   arrays of data.

 * Has a canonical form.

 * Does not require any specific bitstream format.

### Supported By

FASM is currently supported by the

[F4PGA Verilog to Routing fork](https://github.com/f4pga/vtr-verilog-to-routing),

but we hope to get it merged upstream sometime soon.

It is also used by [Project X-Ray](https://github.com/f4pga/prjxray).