# YosysHQ/icestorm

Project IceStorm - Lattice iCE40 FPGAs Bitstream Documentation (Reverse Engineered)

Repository: https://github.com/YosysHQ/icestorm
Canonical: https://ross.abutalabs.com/products/icestorm
Language: Python
License: ISC
License Family: permissive
Last push: 2026-02-26T14:31:07+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 69, release rhythm 16, longevity 100
- inputs: {"age_days": 4064, "days_push": 188, "days_rel": 345, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1182, forks 244 (observed 2026-08-28T04:03:54.319061+00:00)

## What it is
Project IceStorm documents the reverse-engineered bitstream format of Lattice iCE40 FPGAs and provides tools for analyzing and creating bitstream files. It is a core component of the fully open-source FPGA toolchain for iCE40 devices.

## Use cases
- generate bitstreams for iCE40 FPGAs with open-source tools
- analyze and inspect iCE40 bitstream files
- document FPGA chip database for place-and-route tools
- build a fully open FPGA synthesis flow
- reverse-engineer FPGA bitstream formats

## When to choose
- you are using the open-source Yosys/nextpnr flow targeting Lattice iCE40 FPGAs
- you need to parse, create, or verify iCE40 bitstream files
- you want chip documentation for iCE40 devices

## When to avoid
- you target FPGA families other than Lattice iCE40
- you prefer vendor tools like Lattice Diamond or iCECube2
- you need synthesis or place-and-route itself (use Yosys/nextpnr instead)

## Facets
- artifact type: library
- maturity: active
- function: reverse-engineering, developer-tools, parser
- domain: hardware, embedded-systems, reverse-engineering, developer-tools
- platform: windows, cross-platform, python
- tags: fpga, bitstream, ice40, lattice, open-source-fpga-toolchain, hardware-documentation, linux, macos

## Member repositories
- YosysHQ/icestorm (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:54.319061+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:24:46.758845+00:00, confidence not recorded.
  - readme: https://github.com/YosysHQ/icestorm (fetched 2026-08-28T04:03:54.319061+00:00, sha edbc4e68fa29)
- Data as of 2026-08-30T08:39:29.467469+00:00.