ROHD Schematic ViewerROHD Schematic Viewer is an interactive viewer for netlists produced by the ROHD netlister using a superset of the Yosys JSON netlist format (which are also supported). It is designed for exploring ROHD-generated designs in Visual Studio Code, a web browser, or a native Flutter application. Use it to navigate a design hierarchy, inspect module ports and internal connections, find and highlight nets, and progressively expand the logic relevant to an investigation. Open the hosted ROHD Schematic Viewer Click the image to watch the viewer progressively expand a design and reveal the connections that matter. Embed the Viewer in a Flutter ApplicationImport the package library and place [EmbeddedSchematicViewer] in the host application's widget tree:
On Flutter web, the viewer loads its declared package-owned ELK assets on the
first layout request. Host applications do not need to copy scripts or modify
their
Use The main
Rendering, canvas state, painters, BLoCs, and concrete layout implementations are internal and are not supported package APIs. The JSON must use the Yosys-compatible netlist structure described below. See the complete runnable widget example for a minimal application and netlist. Loading Large Netlist FilesLarge files opened from disk use two loading levels. First, the viewer indexes the file and builds a slim hierarchy of modules, names, and pins without retaining connection arrays. When a user opens a block or needs its wires, the viewer reads that module's full connectivity on demand and reuses it for later expansions. Startup shows progress for scanning the file and building its hierarchy. Reads are performed in bounded chunks—up to 1 MiB in browsers and 64 KiB on native platforms—and stalled reads report an error instead of waiting forever. These chunk sizes are not limits on total file size. For implementation details, diagnostics, limitations, and tests, see Indexed Netlist Loading. Generate a Netlist Directly with ROHDROHD Schematic Viewer requires a netlist in the
Yosys JSON netlist format.
Plain Yosys JSON is sufficient for schematic exploration. For a ROHD design,
build the top-level module and pass it to You can generate a netlist from any ROHD top-level module with a small Dart
program. Replace
For example, save the program as
Then open Choose How to Open the ViewerVisual Studio CodeThe VS Code extension is the recommended option when schematic exploration is part of an editing or debugging workflow. After installing the extension:
The schematic opens as a custom editor in the current VS Code workspace. This mode enables integration with compatible ROHD extensions, including ROHD Wave Viewer. Web BrowserUse the hosted application without installing an extension: Select a Yosys JSON netlist from your computer. The hosted viewer processes the file locally in your browser; it does not upload the netlist to an application server. This release supports interactive schematic traversal in the browser. The standalone hosted application processes the netlist locally in the browser. Desktop ApplicationRun the native Flutter application for a standalone desktop experience. The application initially loads the bundled demonstration schematic; use its file picker to open another Yosys JSON netlist. This standalone application does not currently provide services beyond schematic exploration. Instructions for building and running desktop, web, and VS Code extension configurations are in doc/BUILD.md. Quick Start
The viewer supports incremental expansion and collapse, so large designs can be explored without rendering every level of hierarchy at once. Explore a Design HierarchyClick module instances to select them, then use their expansion controls to reveal or hide internal structure. Click a port to incrementally show or collapse only the logic connected through that port. This focused expansion is useful for tracing a signal through a large design:
Find and Inspect WiresClick a wire to highlight all of its connected segments in orange. Hover over a wire to view its signal name and hierarchy path. In an embedded or DevTools workflow that supplies current signal values, the tooltip also displays the value. Use Find Wire with
The result counter identifies the current match and total number of matches. Navigate the Schematic
The in-application Help button contains the current interaction reference. JSON Format SupportROHD Schematic Viewer reads the Yosys JSON netlist format:
See the
Yosys TroubleshootingA schematic does not load
A wire or connection is not visible
Send is not in the right-click menuSend Signal(s) is intentionally hidden until another compatible ROHD viewer registers in the current VS Code session. Open the other viewer, or reload the VS Code window after installing or updating an extension. Development and ContributionsThis README is the user guide. Instructions for selecting dependency modes, running Flutter configurations, packaging the VS Code extension, and troubleshooting builds are in doc/BUILD.md. Copyright (C) 2026 Intel Corporation |

