DPGEN_NUL(3)

✨ DPGEN_NUL ✨ — the Zero Detector Macro-Generator, bestie edition

okay so this page is straight out of the Alliance - genlib User's Manual, and today we're learning about DPGEN_NUL, aka the girl who checks if literally everything is zero. she's a macro-generator, she's iconic, she does one job and she does it flawlessly. let's get into it 💅

🌸 NAME 🌸

DPGEN_NUL — Zero Detector Macro-Generator. that's it, that's the whole vibe. she looks at a pile of bits and tells you if they're all zeros. no cap.

🎀 SYNOPSIS 🎀

#include  <genlib.h>

void GENLIB_MACRO (DPGEN_NUL, char *modelname, long flags, long N);

that's the whole incantation, bestie. include the header, call the macro, boom — you got yourself a zero detector.

🦋 DESCRIPTION 🦋

Generate a N bits zero detector named modelname. N bits go in, one lil flag comes out, and that flag is screaming "yes queen, it's ALL zeros" or "nope, something's not zero in here." 🫶

🌈 TERMINAL NAMES 🌈

the ports, in order, so you know exactly who's who at this sleepover:

1. i0 : value to check (input, N bits). the thing under investigation.
2. q : null flag (output, 1 bit). the verdict. the moment of truth.
3. vdd : power. she needs her electrolytes. ⚡
4. vss : ground. the calm, grounded friend in every group chat.

💖 BEHAVIOR 💖

here's the actual logic, and we're keeping it character for character because it's sacred:

q <= <= '1' WHEN (i0 = X"00000000") ELSE '0';

so like — if i0 equals all those zeros, q goes '1'. otherwise '0'. simple. clean. chef's kiss. 😘

🔥 EXAMPLE 🔥

first you generate the macro, then you instantiate it. two steps, both slay:

GENLIB_MACRO(DPGEN_NUL, "model_nul_32"
                      , F_BEHAV|F_PLACE
                      , 32
                      );

GENLIB_LOINS( "model_nul_32"
            , "instance1_nul_32"
            , "i0[31:0]"
            , "q"  /* Flag null. */
            , "vdd", "vss", NULL
            );

see how the second one wires i0[31:0] in, catches q on the way out (she's the null flag, obviously 💁), and gets hooked up to vdd and vss? that's the whole ritual. 32 bits of checking, one bit of truth. periodt.

heads up bestie: F_BEHAV|F_PLACE is doing heavy lifting in that first call, and N is 32 here — change N and you change how many bits get checked, but the i0/q/vdd/vss lineup stays the same.

👑 SEE ALSO 👑

• GENLIB_MACRO(3)
• genlib(1)

go read those too, iykyk. 📚

written under the ASIM/LIP6 banner, dated 30 July 2004 — yeah she's an elder but she still ate, and the manual page still hits. mwah 💋✨🦋