53 lines
1.9 KiB
TypeScript
53 lines
1.9 KiB
TypeScript
|
/**
|
|||
|
|
* Chip pin drive registry — the bridge between a custom-chip's WASM-driven
|
|||
|
|
* output pins and the SPICE electrical engine.
|
|||
|
|
*
|
|||
|
|
* When a custom-chip drives an OUTPUT pin (ChipRuntime), it records the pin's
|
|||
|
|
* voltage here keyed by `${chipId}:${pinName}`. The SPICE netlist builder's
|
|||
|
|
* `custom-chip` mapper (spice/componentToSpice) reads these to emit a DC
|
|||
|
|
* voltage source on the chip pin's net, exactly like a board GPIO. That makes
|
|||
|
|
* the chip drive LEDs, resistors and any analog part wired to it through
|
|||
|
|
* ngspice, in addition to the digital PinManager path.
|
|||
|
|
*
|
|||
|
|
* Presence of a key == that pin is a driven output. Absence == input / Hi-Z.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
const drives = new Map<string, number>();
|
|||
|
|
|
|||
|
|
function key(chipId: string, pinName: string): string {
|
|||
|
|
return `${chipId} ${pinName}`;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Record (or clear) a chip output pin's drive voltage. Pass `null` to mark the
|
|||
|
|
* pin as a non-driving input. Returns true if the registry actually changed
|
|||
|
|
* (so callers can skip a redundant SPICE re-solve).
|
|||
|
|
*/
|
|||
|
|
export function setChipPinDrive(chipId: string, pinName: string, voltage: number | null): boolean {
|
|||
|
|
const k = key(chipId, pinName);
|
|||
|
|
if (voltage == null) {
|
|||
|
|
return drives.delete(k);
|
|||
|
|
}
|
|||
|
|
if (drives.get(k) === voltage) return false;
|
|||
|
|
drives.set(k, voltage);
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** All driven output pins for a chip, with their voltages. */
|
|||
|
|
export function getChipDrivenPins(chipId: string): { pin: string; voltage: number }[] {
|
|||
|
|
const prefix = `${chipId} `;
|
|||
|
|
const out: { pin: string; voltage: number }[] = [];
|
|||
|
|
for (const [k, v] of drives) {
|
|||
|
|
if (k.startsWith(prefix)) out.push({ pin: k.slice(prefix.length), voltage: v });
|
|||
|
|
}
|
|||
|
|
return out;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** Forget every drive for a chip (on dispose / simulation stop). */
|
|||
|
|
export function clearChipDrives(chipId: string): void {
|
|||
|
|
const prefix = `${chipId} `;
|
|||
|
|
for (const k of Array.from(drives.keys())) {
|
|||
|
|
if (k.startsWith(prefix)) drives.delete(k);
|
|||
|
|
}
|
|||
|
|
}
|