Add podman image and README

README.md

@@ -0,0 +1,42 @@
+This repository contains a podman image whichs contains all necessary tools to generate and flash bitstream file from a SystemVerilog program.
+It is build for the xilinx zybo zynq7 `xc7z010` card, but it can probably be easily edited to support another card.
+
+# Installation
+
+You will need [podman](https://podman.io/) to run the image.
+
+## Use the pre-built image
+
+You can directly use the pre-build image present in the repo
+
+```bash
+zstd -d fmn.tar.zst
+podman load --input fmn.tar
+```
+
+## Build the image from source
+
+You can build the image yourself by using this command:
+
+```bash
+podman build -t fmn_alpine .
+```
+
+It will first create an image which will build every tools, and then create the final image containing only needed binaries and libraries.
+
+For information, it takes around 5.63GB space and 10 minutes to build on my device.
+
+# Tools
+
+- [sv2v](https://github.com/zachjs/sv2v) : Convert SystemVerilog to Verilog.
+- [yosys](https://github.com/YosysHQ/yosys) : Do RTL synthesis from verilog files.
+- [nextpnr-himbaechel](https://github.com/YosysHQ/nextpnr) : placing and routing tool.
+- [fasm2frames](https://github.com/f4pga/prjxray) : Convert fasm files to frames files.
+- [xc7frames2bit](https://github.com/f4pga/prjxray) : Convert frames files to bitstream.
+- [openFPGALoader](https://github.com/trabucayre/openFPGALoader) : Flash a bitstream on a FPGA card.
+
+The image also contains some [databases](https://github.com/f4pga/prjxray-db) needed for prjxray tools to work.
+
+# Usage
+
+See the small [example](./example/).