XML2STEMS(1)

💖 XML2STEMS(1) — Filetype Conversion, but make it cute 💖

okay bestie, welcome to the xml2stems page — manual name is Filetype Conversion, section 1, and she's a little tool with a big job. let's get into it 🎀

✨ NAME ✨

xml2stems — Verilator XML to rtlbrowse stems conversion.

✨ SYNTAX ✨

xml2stems [option]... INFILE [OUTFILE]

✨ DESCRIPTION ✨

So what does she do? Converts Verilator XML AST representation to stems file for use with rtlbrowse. that's the whole vibe 💅

She's intended to replace the obsolete vermin, and fr fr, in the future, advanced tool features may possibly use additional data provided by the Verilator AST. no cap.

Two lil quality-of-life things you need to know:

• Using - as an input filename reads from stdin. yes, the humble dash, main character energy.
• Omitting the output filename outputs to stdout. so she'll just talk right at your terminal 🫶

✨ OPTIONS ✨

• -V, --vl_sim — Adds TOP hierarchy for Verilator sim. Not necessary for other simulators. like, only needed if you're Verilator-ing, bestie 💜
• -h, --help — Display help then exit. the classic. she says her piece and dips 👑

✨ EXAMPLES ✨

okay so here's a whole chain of commands to compile Verilog source and then bring up gtkwave and rtlbrowse together for source code annotation. This assumes the file des.fst was already generated from a prior simulation. (iykyk 🌸)

verilator -Wno-fatal des.v -xml-only --bbox-sys

xml2stems obj_dir/Vdes.xml des.stems

gtkwave -t des.stems des.fst

three lines, whole pipeline, slay 🔥

✨ AUTHORS ✨

Anthony Bybell <bybell@rocketmail.com> — legend behaviour, honestly 🌈

✨ SEE ALSO ✨

rtlbrowse(1) gtkwave(1)

🦋 gentle reminder from your bestie: vermin is obsolete, so don't be out here using it, okay? use xml2stems instead. periodt.

this page was brought to you by Anthony Bybell, version 3.3.93 — mwah, take care of her, she's iconic 💖✨🎀