【亲测免费】 DigitalJS 使用教程

1、项目介绍

DigitalJS 是一个用 JavaScript 实现的数字电路模拟器，旨在模拟由硬件设计工具（如 Yosys）合成的电路。它还具有一个配套项目 yosys2digitaljs，用于将 Yosys 输出文件转换为 DigitalJS 格式。DigitalJS 不仅是一个模拟器，还是一个教学工具，因此其代码的可读性和易检查性是其主要关注点之一。

2、项目快速启动

安装

你可以通过 NPM 安装 DigitalJS：

npm install digitaljs

或者直接使用 Webpack 打包：

// 创建模拟对象
const circuit = new digitaljs.Circuit(input_goes_here);

// 在 #paper 上显示
const paper = circuit.displayOn($('#paper'));

// 激活实时模拟
circuit.start();

输入格式

电路使用 JSON 格式表示。顶级对象有三个键：

{
  "modules": { ... },
  "netlist": { ... },
  "signals": [ ... ]
}

3、应用案例和最佳实践

案例一：基本逻辑门模拟

使用 DigitalJS 模拟一个简单的 AND 门电路：

{
  "modules": {
    "and_gate": {
      "type": "and",
      "inputs": ["A", "B"],
      "outputs": ["out"]
    }
  },
  "netlist": {
    "and_gate": {
      "A": "input",
      "B": "input",
      "out": "output"
    }
  },
  "signals": ["A", "B", "out"]
}

案例二：复杂电路模拟

模拟一个包含多个子模块的复杂电路：

{
  "modules": {
    "submodule1": { ... },
    "submodule2": { ... },
    "main_module": {
      "submodules": ["submodule1", "submodule2"],
      "connections": { ... }
    }
  },
  "netlist": { ... },
  "signals": [ ... ]
}

4、典型生态项目

Yosys

Yosys 是一个开源的硬件合成框架，用于将高级硬件描述语言（如 Verilog）转换为低级硬件描述，是 DigitalJS 的主要输入源之一。

yosys2digitaljs

yosys2digitaljs 是一个转换工具，用于将 Yosys 的输出文件转换为 DigitalJS 格式，使得 Yosys 合成的电路可以在 DigitalJS 中进行模拟。

通过这些模块的介绍和示例，你可以快速上手并深入了解 DigitalJS 的使用和应用。