Digital跨平台部署指南：在Windows、Linux和Mac上使用

1. 环境准备

1.1 系统要求

Digital是一款跨平台的数字逻辑设计与仿真工具，支持Windows、Linux和macOS系统。运行前需确保系统满足以下条件：

操作系统	最低配置	推荐配置
Windows 10/11	JRE 8+，2GB RAM	JRE 17+，4GB RAM
Linux (Ubuntu 20.04+/Fedora 34+)	OpenJDK 8+，2GB RAM	OpenJDK 17+，4GB RAM
macOS 10.15+	JRE 8+，2GB RAM	JRE 17+，4GB RAM

1.2 Java环境安装

所有平台均需安装Java运行时环境（JRE），推荐使用Eclipse Temurin（Adoptium）提供的二进制包：

• Windows：从Adoptium官网下载.msi安装包，默认路径安装即可
• Linux：通过包管理器安装

  # Ubuntu/Debian
  sudo apt install openjdk-17-jre
  
  # Fedora/RHEL
  sudo dnf install java-17-openjdk
  

• macOS：使用Homebrew安装

  brew install --cask temurin17
  

2. 下载与安装

2.1 获取软件包

从GitCode仓库克隆或下载最新发布包：

git clone https://gitcode.com/gh_mirrors/di/Digital.git
cd Digital

2.2 平台特定安装步骤

2.2.1 Windows系统

1. 解压distribution/Digital.zip到目标目录（如C:\Program Files\Digital）
2. 直接运行Digital.exe或Digital_noD3D.exe（针对高DPI显示器问题）
3. 故障排除：若图形显示异常，尝试通过命令行启动

   cd C:\Program Files\Digital
   java -jar Digital.jar
   

2.2.2 Linux系统

1. 解压发行包并赋予执行权限

   unzip distribution/Digital.zip -d ~/Digital
   cd ~/Digital
   chmod +x Digital.sh linux/install.sh
   

2. 运行安装脚本创建桌面快捷方式

   ./linux/install.sh
   

3. 脚本将自动完成以下操作：

   • 创建.desktop文件到~/.local/share/applications
   • 注册MIME类型支持.dig文件
   • 更新桌面数据库和MIME数据库

4. 启动方式

   # 命令行启动
   ./Digital.sh
   
   # 或通过应用菜单启动（搜索"Digital"）
   

2.2.3 macOS系统

1. 解压发行包到/Applications目录

   unzip distribution/Digital.zip -d /Applications
   

2. 通过终端启动

   cd /Applications/Digital
   java -jar Digital.jar
   

3. 可选：创建应用程序快捷方式

   • 打开Automator，创建"应用程序"
   • 添加"运行Shell脚本"操作，输入：

     cd /Applications/Digital && java -jar Digital.jar
     

   • 保存为Digital.app到/Applications目录

3. 配置与优化

3.1 图形渲染设置

针对不同显示硬件问题，可选择不同启动方式：

可执行文件	适用场景
Digital.exe	默认启动，使用Direct3D加速
Digital_noD3D.exe	解决高DPI显示器布局问题
java -jar Digital.jar	命令行启动，便于查看错误输出

3.2 性能优化

对于复杂电路仿真，可通过以下方式提升性能：

1. 调整Java堆大小

   # Linux/macOS
   java -Xmx2G -jar Digital.jar
   
   # Windows（编辑Digital.bat）
   @java -Xmx2G -jar Digital.jar %*
   

2. 禁用不必要的图形效果

   • 在设置中关闭"实时信号状态显示"
   • 使用"单步模式"分析振荡电路时关闭波形绘制

4. 基本使用流程

4.1 快速启动向导

flowchart TD
    A[启动Digital] --> B{选择操作}
    B -->|新建电路| C[从组件库添加逻辑门]
    B -->|打开示例| D[浏览examples目录]
    B -->|导入HDL| E[使用VHDL/Verilog模块]
    C --> F[连接线路并设置属性]
    D --> G[运行仿真查看结果]
    E --> H[综合为逻辑电路]
    F & G & H --> I[保存为.dig文件]

4.2 命令行工具

Digital提供CLI工具支持自动化测试：

# 运行电路测试
java -cp Digital.jar CLI test examples/74xx/74xx_xor.dig

5. 常见问题解决

5.1 图形显示问题

• Windows高DPI问题：使用Digital_noD3D.exe或兼容性设置

  # 创建快捷方式并设置高DPI缩放覆盖
  reg add "HKCU\Software\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers" /v "C:\Program Files\Digital\Digital.exe" /t REG_SZ /d "HIGHDPIAWARE"
  

• Linux字体模糊：调整Java渲染属性

  export _JAVA_OPTIONS="-Dsun.java2d.uiScale=2.0"
  ./Digital.sh
  

5.2 仿真性能问题

• 大型电路卡顿：减少同时显示的测量图表数量
• 振荡检测失败：启用"单门模式"逐步分析信号传播

5.3 HDL仿真支持

使用VHDL/Verilog功能需安装额外工具：

# Ubuntu安装仿真器
sudo apt install ghdl iverilog

6. 高级部署方案

6.1 多用户环境部署（Linux服务器）

1. 将Digital安装到公共目录

   sudo mkdir -p /opt/digital
   sudo unzip Digital.zip -d /opt/digital
   sudo chmod -R 755 /opt/digital
   

2. 创建全局启动脚本

   sudo ln -s /opt/digital/Digital.sh /usr/local/bin/digital
   

3. 为每个用户配置桌面快捷方式

   for user in /home/*; do
     cp /opt/digital/linux/digital-simulator.desktop $user/.local/share/applications/
     sed -i "s,<USER_HOME>,$user,g" $user/.local/share/applications/digital-simulator.desktop
   done
   

6.2 集成到教学环境

通过TCP远程接口控制仿真器，与教学平台集成：

// 示例代码：远程控制接口
Socket socket = new Socket("localhost", 10000);
DataOutputStream out = new DataOutputStream(socket.getOutputStream());
out.writeUTF("run");  // 启动仿真

7. 版本更新与维护

7.1 检查更新

查看发行说明获取最新特性：

cat distribution/ReleaseNotes.txt

7.2 升级步骤

# 拉取最新代码
cd /path/to/Digital
git pull origin master

# 重新构建（开发版本）
mvn clean install

8. 总结

Digital提供了跨平台的数字逻辑设计与仿真能力，通过本文档介绍的部署方法，可在Windows、Linux和macOS系统上高效使用该工具。关键注意事项：

• 环境依赖：确保Java 8+正确安装
• 性能调优：复杂电路需调整JVM参数
• 平台差异：Linux需运行安装脚本创建桌面集成，Windows注意高DPI设置

通过合理配置和优化，Digital可满足从教学实验到简单FPGA原型验证的多种需求。