tinyfpga/icestudio

:snowflake: Experimental graphic editor for open FPGAs

Experimental graphic editor for open FPGAs. Built on top of the Icestorm project using Apio.

Graphic design -> Verilog, PCF -> Bistream -> FPGA

Supported boards

Board name	GNU/Linux	Windows	Mac OS
Alhambra II	✅	✅	✅
IceZUM Alhambra	✅	✅	✅
Kéfir I iCE40-HX4K	✅	✅	✅
Nandland Go board	✅	✅	✅
iCE40-HX8K Breakout Board	✅	✅	✅
iCEstick Evaluation Kit	✅	✅	✅
icoBOARD 1.0	:white_check_mark: *	:white_check_mark: *	:white_check_mark: *
BlackIce	✅	✅	✅
BlackIce II	✅	✅	✅
TinyFPGA B2	✅	✅	✅

* Use with Raspberry Pi

Installation

• GNU/Linux

  1. Install Python 2.7 and xclip
  2. Download and execute the AppImage

• Windows

  1. Download and execute the Windows installer

• Mac OS

  1. Install Python 2.7 and Homebrew
  2. Download and execute the DMG package

Check the Documentation for more information.

Development

Install Python 2.7 and nodejs.

Atom editor with linter-jshint is recommended.

If you want to add blocks or examples, please contribute to icestudio-blocks, icestudio-examples or collection-default.

Ubuntu

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs

Download

git clone https://github.com/FPGAwars/icestudio.git
cd icestudio

Install

npm install

Execute

npm start

Languages

Language	Translated strings
English
Spanish
French
Chinese
Catalan
Basque
Galician

Contribute!

Add or update the app translations using Poedit.

Developer note: use npm run gettext to extract the labels from the code.

Package

npm run dist

Target OS	Development OS	Output files
GNU/Linux	GNU/Linux	(linux32,linux64).zip, (linux32,linux64).AppImage
Windows	GNU/Linux	(win32,win64).zip, (win32,win64).exe
Mac OS	Mac OS	(osx32,osx64).zip, osx64.dmg

Troubleshooting

If you get this error npm ERR! peerinvalid The package grunt@1.0.1 does not satisfy its siblings' peerDependencies requirements!, try to update your nodejs or execute:

npm update -g

More information

Roadmap

There is a Wishlist in the wiki with the features proposed by the Community. If you want to contribute with new features and ideas write in the Google Group.

We use the GitHub issues to schedule our new features and improvements.

Videos

Version 0.2

Authors

• Jesús Arroyo Torrens

Contributors

• v0.3
  • Lorea-Aldabaldetreku
  • Carlos Díaz
  • Martoni
  • Xoan Sampaiño
  • Unai
  • Francisco Sayas
  • Pascal Cotret
  • Juan Jose Luna Espinosa
  • Salvador E. Tropea
  • redbeard
• v0.2
  • Tomás Calvo
  • Juan González (Obijuan)
  • Carlos Díaz
  • Xoan Sampaiño
  • Salvador E. Tropea
  • Democrito
  • Martoni
  • Pascal Cotret
• v0.1
  • Miguel Sánchez de León Peque

Credits

• v0.3, v0.2: using JointJS and AlertifyJS

• v0.1: using AngularJS-Flowchart

• FPGAwars community has developed this project in a voluntary and altruistic way since 02/2017.

  

• BQ sponsored this project from 02/2016 to 02/2017. Thanks

  

License

Licensed under GPL 2.0 and Creative Commons Attribution-ShareAlike 4.0 International License.