{"id":13649117,"url":"https://github.com/projf/projf-explore","last_synced_at":"2025-04-22T12:33:26.556Z","repository":{"id":37957252,"uuid":"258746878","full_name":"projf/projf-explore","owner":"projf","description":"Project F brings FPGAs to life with exciting open-source designs you can build on.","archived":false,"fork":false,"pushed_at":"2024-10-16T10:51:47.000Z","size":3170,"stargazers_count":576,"open_issues_count":9,"forks_count":52,"subscribers_count":38,"default_branch":"main","last_synced_at":"2024-10-18T06:23:33.941Z","etag":null,"topics":["fpga","graphics-hardware","oshw","verilog"],"latest_commit_sha":null,"homepage":"https://projectf.io","language":"SystemVerilog","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/projf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["WillGreen"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-04-25T10:21:33.000Z","updated_at":"2024-10-17T23:26:06.000Z","dependencies_parsed_at":"2024-02-07T11:46:53.179Z","dependency_job_id":"c1f25c12-4da9-4526-a962-67d4a549f474","html_url":"https://github.com/projf/projf-explore","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projf%2Fprojf-explore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projf%2Fprojf-explore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projf%2Fprojf-explore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projf%2Fprojf-explore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projf","download_url":"https://codeload.github.com/projf/projf-explore/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223896472,"owners_count":17221441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fpga","graphics-hardware","oshw","verilog"],"created_at":"2024-08-02T01:04:47.384Z","updated_at":"2024-11-09T23:30:57.496Z","avatar_url":"https://github.com/projf.png","language":"SystemVerilog","funding_links":["https://github.com/sponsors/WillGreen"],"categories":["SystemVerilog"],"sub_categories":[],"readme":"# Project F - FPGA Development\n\nProject F is a little oasis where you can quench your thirst for FPGA knowledge and find accessible, [open-source](LICENSE) designs to learn from and build on. Our projects include _FPGA Graphics_, _FPGA Maths_, and the _Verilog Library_.\n\nThe [Project F blog](https://projectf.io) features over fifty posts covering FPGAs, Verilog, and RISC-V.\n\nFollow @WillFlux on [Mastodon](https://mastodon.social/@WillFlux) or [X](https://x.com/WillFlux). Join the [Project F Discussions](https://github.com/projf/projf-explore/discussions) on GitHub.\n\n![](doc/img/fpga-ad-astra-banner.png?raw=true \"\")\n\n## FPGA Graphics\n\nIn this series, we learn about graphics at the hardware level and get a feel for the power of FPGAs. We'll learn how screens work, play Pong, create starfields and sprites, paint Michelangelo's David, draw lines and triangles, and animate characters and shapes. Along the way, you'll experience a range of designs and techniques, from memory and finite state machines to crossing clock domains and translating C algorithms into Verilog. I recently began adding Lattice ECP5 support to this series.\n\n![](doc/img/fpga-graphics-banner.png?raw=true \"\")\n\n* **Beginning FPGA Graphics**: [Designs](graphics/fpga-graphics) - [Blog](https://projectf.io/posts/fpga-graphics/)\n* **Racing the Beam**: [Designs](graphics/racing-the-beam) - [Blog](https://projectf.io/posts/racing-the-beam/)\n* **FPGA Pong**: [Designs](graphics/pong) - [Blog](https://projectf.io/posts/fpga-pong/)\n* **Display Signals**: [Blog](https://projectf.io/posts/display-signals/) (no designs in git)\n* **Hardware Sprites**: [Designs](graphics/hardware-sprites) - [Blog](https://projectf.io/posts/hardware-sprites/)\n* **Framebuffers**: [Designs](graphics/framebuffers) - [Blog](https://projectf.io/posts/framebuffers/)\n* **Lines and Triangles**: [Designs](graphics/lines-and-triangles) - [Blog](https://projectf.io/posts/lines-and-triangles/)\n* **2D Shapes**: [Designs](graphics/2d-shapes) - [Blog](https://projectf.io/posts/fpga-shapes/)\n* **Animated Shapes**: [Designs](graphics/animated-shapes) - [Blog](https://projectf.io/posts/animated-shapes/)\n\n## Hello\n\nA three-part introduction to FPGA development with Verilog with dev boards:\n\n* **Hello Arty**: [Designs](hello/hello-arty) - [Blog 1](https://projectf.io/posts/hello-arty-1/) - [Blog 2](https://projectf.io/posts/hello-arty-2/) - [Blog 3](https://projectf.io/posts/hello-arty-3/)\n* **Hello Nexys**: [Designs](hello/hello-nexys) - [Blog 1](https://projectf.io/posts/hello-nexys-1/) - [Blog 2](https://projectf.io/posts/hello-nexys-2/)\n\n## Maths and Algorithms\n\nPut maths to work in Verilog algorithms:\n\n* [Numbers in Verilog](https://projectf.io/posts/numbers-in-verilog/) - introduction to numbers in Verilog\n* [Vectors and Arrays](https://projectf.io/posts/verilog-vectors-arrays) - working with Verilog vectors and arrays\n* [Multiplication with DSPs](https://projectf.io/posts/multiplication-fpga-dsps) - efficient FPGA multiplication\n* [Fixed-Point Numbers](https://projectf.io/posts/fixed-point-numbers-in-verilog/) - precision without complexity\n* [Division in Verilog](https://projectf.io/posts/division-in-verilog) - divided we stand\n\n![](doc/img/sea-of-chaos.png?raw=true \"\")\n\n## Demos and Effects\n\n* **Ad Astra**: [Designs](demos/ad-astra) - [Blog](https://projectf.io/posts/fpga-ad-astra/) - greetings with starfields and hardware sprites\n* **Castle Drawing**: [Designs](demos/castle-drawing) - [Blog](https://projectf.io/posts/castle-drawing/) - draw a castle and rainbow in 16 colours\n* **Life on Screen**: [Designs](demos/life-on-screen) - [Blog](https://projectf.io/posts/life-on-screen/) - Conway's Game of Life in logic\n* **Mandelbrot Set**: [Designs](demos/mandelbrot) - [Blog](https://projectf.io/posts/mandelbrot-verilog/) - Mandelbrot set with fixed-point maths\n* **Rasterbars**: [Designs](demos/rasterbars) - [Blog](https://projectf.io/posts/rasterbars/) - classic animated colour bars\n* **Sine Scroller**: [Designs](demos/sinescroll) - [Blog](https://projectf.io/posts/sinescroll/) - greet your viewers in style\n\n![](doc/img/sinescroll-sim.png?raw=true \"\")\n\n## Verilog Library\n\nThe Project F Library includes handy Verilog designs for everyone. From framebuffers and video output to division and square root, rom and ram, and even circle drawing. You can freely build on these [MIT licensed](../../LICENSE) designs.\n\nVisit the [Library](lib/) for the Verilog designs or get an overview from the [Verilog Library blog post](https://projectf.io/verilog-lib/).\n\n## Requirements\n\n### FPGA Architecture\n\nOur designs seek to be vendor-neutral, but some functionality requires support for vendor primitives. We currently support these FPGA architectures:\n\n* **XC7** - Xilinx 7 Series FPGAs, such as Spartan-7 and Artix-7\n  * `BUFG`, `MMCME2_BASE`, `OBUFDS`, `OSERDES2`\n* **iCE40** - Lattice iCE40 FPGAs, such as iCE40 UltraPlus\n  * `SB_IO`, `SB_PLL40_PAD`, `SB_SPRAM256KA`\n* **ECP5** - Lattice ECP5 FPGAs, such as LFE5U-45\n  * `EHXPLLL`, `ODDRX1F`\n\nWe also infer block ram (BRAM); see [lib/memory](lib/memory).\n\nPorting to other architectures should be straightforward.\n\n## SystemVerilog?\n\nWe use a few simple features of SystemVerilog to make Verilog more pleasant:\n\n* `logic` type is safer and less work than using `wire` and `reg`\n* `always_comb` and `always_ff` to make intent clear and catch mistakes\n* `$clog2` to calculate vector widths (e.g. for addresses)\n* `enum` to make finite state machines simpler to work with\n* Matching names in module instances: `.clk_pix` instead of `.clk_pix(clk_pix)`\n\nI believe these features are helpful, especially for beginners. All the SystemVerilog features are compatible with recent versions of Verilator, Yosys, Icarus Verilog, and Xilinx Vivado.\n\n## Thank You, Sponsors!\n\nThank you to all my sponsors for supporting Project F. Special thanks go to the following: [David C. Norris](https://github.com/dcnorris), [Justin Finkelstein](https://github.com/iamfinky), [Kilometer780](https://github.com/Kilometer780), [matt venn](https://github.com/mattvenn), [Paul Sajna](https://github.com/sajattack), and [Renaldas Zioma](https://github.com/rejunity) for their recent generosity.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojf%2Fprojf-explore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojf%2Fprojf-explore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojf%2Fprojf-explore/lists"}