JSON2STEMS(1)

💖 JSON2STEMS(1) 💖

okay bestie, so this is a Filetype Conversion manual page — it's json2stems(1), and no cap it's the little glue tool that turns your Verilator JSON into stems. let's get into it 🦋

✨ NAME ✨

json2stems — Verilator JSON to rtlbrowse stems conversion. that's the whole vibe. 💅

🌸 SYNTAX 🌸

json2stems METAINFILE TREEINFILE OUTFILE

three args, in that order, no substitutions. periodt. 👑

🎀 DESCRIPTION 🎀

so what it does is: it converts a Verilator JSON AST representation into a stems file for use with rtlbrowse. like, that's the job. that's the whole job. ✨

and here's the tea — it's intended to replace the obsolete xml2stems(1). rip to xml2stems, she did her best. 🙈

also, lowkey foreshadowing: in the future, advanced tool features may possibly use additional data provided by the Verilator AST. so this little guy might get even more iconic later. no promises tho, that's literally just what the page says. 🔮

🧚 EXAMPLES 🧚

here's a whole chain of commands to compile Verilog source and then bring up gtkwave and rtlbrowse together for source code annotation. bestie duo behavior, honestly. 🫶

this assumes the file des.fst was already generated from a prior simulation — so don't come for me if that's missing, it's a prerequisite, okay? 💀

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

json2stems obj_dir/Vdes.tree.meta.json obj_dir/Vdes.tree.json des.stems

gtkwave -t des.stems des.fst

see how the output of one thing feeds the next? it's giving pipeline. it's giving main character energy. the des.stems shows up in the gtkwave call with -t and everything lines up. slay. 🔥

👑 AUTHORS 👑

Leon Wandruschka <leon.wandruschka@outlook.com> — the author, the moment, the legend. 🎀

🌈 SEE ALSO 🌈

• rtlbrowse(1)
• xml2stems(1)
• gtkwave(1)

go read those too, iykyk. 💜

fr fr that's the entire page. nothing skipped, nothing invented, every flag-free argument and every command kept exactly as it was. 💖

and a lil sign-off for you, bestie: this one's by Leon Wandruschka, version 3.3.125, dated 3.3.125, filed under JSON2STEMS(1). mwah, take care of her 🦋✨🌸