hpretl/iic-osic-tools

IIC-OSIC-TOOLS Docker镜像文档

1. 镜像概述和主要用途

IIC-OSIC-TOOLS 是一个集成式 Docker 容器，专为基于 SKY130/GF180/IHP-SG13G2 工艺节点的集成电路（IC）设计打造，支持模拟和数字电路全流程开发。该镜像基于 Ubuntu 24.04 LTS 系统构建，原生支持 x86_64 和 aarch64 两种 CPU 架构，由约翰内斯·开普勒大学（JKU）集成电路系（IDC）官方维护，提供开箱即用的开源 IC 设计工具链。

2. 核心功能和特性

• 多工艺节点支持：集成 SKY130、GF180、IHP-SG13G2 工艺节点的设计工具链，覆盖主流开源工艺需求。
• 全流程覆盖：支持模拟电路和数字电路设计流程，包含从设计输入、仿真、综合到版图验证的完整工具链。
• 跨架构兼容：原生支持 x86_64（64位 Intel/AMD）和 aarch64（64位 ARM）架构，适配不同硬件环境。
• 稳定基础系统：基于 Ubuntu 24.04 LTS，确保工具运行环境的稳定性和兼容性。
• 官方维护：由 JKU 集成电路系（IDC）持续更新和维护，工具版本和配置经过学术验证。

3. 使用场景和适用范围

• 集成电路设计人员：适用于模拟/数字 IC 设计工程师，提供统一、标准化的开发环境，避免工具版本冲突和环境配置繁琐问题。
• 学术研究：高校、研究机构可基于此镜像开展 IC 设计相关研究，快速复现实验结果。
• 开源 IC 项目：开源芯片项目（如 RISC-V 相关设计）可利用该镜像简化协作流程，确保团队开发环境一致。
• 教学实践：IC 设计课程中作为教学环境，帮助学生快速上手专业工具，聚焦设计逻辑而非环境配置。

4. 使用方法和配置说明

4.1 获取镜像

镜像详细信息及最新版本可通过官方 GitHub 仓库获取，建议优先参考仓库说明：
https://github.com/iic-jku/iic-osic-tools

4.2 运行容器（docker run）

基础命令示例（根据实际需求调整挂载路径和参数）：

bash
docker run -it --rm \
  -v /本地工作目录:/workdir \  # 挂载本地工作目录到容器内/workdir
  -e DISPLAY=$DISPLAY \         # 传递图形界面显示变量（需本地支持X11）
  -v /tmp/.X11-unix:/tmp/.X11-unix \  # 挂载X11 socket，支持图形工具
  --user $(id -u):$(id -g) \    # 以当前用户权限运行，避免文件权限问题
  iic-jku/iic-osic-tools        # 镜像名称（以官方实际名称为准）

4.3 docker-compose 配置示例

创建 docker-compose.yml 文件，简化容器管理：

yaml
version: '3'
services:
  ic-design-env:
    image: docker.xuanyuan.run/iic-jku/iic-osic-tools  # 镜像名称（以官方实际名称为准）
    container_name: osic-tools-env
    volumes:
      - /本地工作目录:/workdir    # 挂载工作目录
      - /tmp/.X11-unix:/tmp/.X11-unix  # X11图形支持
    environment:
      - DISPLAY=${DISPLAY}        # 图形界面显示变量
      - USER_UID=$(id -u)         # 当前用户UID（需提前定义环境变量）
      - USER_GID=$(id -g)         # 当前用户GID（需提前定义环境变量）
    user: "${USER_UID}:${USER_GID}"  # 绑定用户权限
    stdin_open: true              # 保持标准输入打开
    tty: true                     # 分配伪终端

启动容器：

bash
export USER_UID=$(id -u) USER_GID=$(id -g) && docker-compose up -d

4.4 关键配置参数说明

5. 工具列表和详细操作指南

容器内安装的具体工具列表（如 KLayout、Ngspice、OpenLANE 等）及详细操作方法（如工具调用、流程配置），请参考官方文档：
https://github.com/iic-jku/iic-osic-tools

6. 参考链接

• 官方 GitHub 仓库：https://github.com/iic-jku/iic-osic-tools
• JKU 集成电路系（IDC）：[***]