awesome-tcadclaw

Category: Tools & Productivity | Uploader: hope-young | Downloads: 0 | Version: v1.0（Latest）

Controls the Sentaurus TCAD simulation environment running on a CentOS virtual machine via SSH.

Changelog: Source: GitHub https://github.com/hope-young/awesome-tcadclaw

Directory Structure

Current level: skills/sentaurus-vm/

📄 SKILL.md 4.3 KB

SKILL.md

# Sentaurus TCAD VM Control Skill

Controls the Sentaurus TCAD simulation environment running on a CentOS virtual machine via SSH.

## Environment Configuration

### VM Information
- **IP Address**: `$SENTAURUS_VM_IP` (static)
- **Username**: `$SENTAURUS_VM_USER`
- **SSH Port**: 22
- **Project Path**: `$STDB/`

### SSH Configuration
- SSH Key: `$SENTAURUS_VM_KEY`
- Quick Connect: `ssh -i $SENTAURUS_VM_KEY $SENTAURUS_VM_USER@$SENTAURUS_VM_IP`

## Python Environment

### Python Interpreter
```bash
$SENTAURUS_HOME/tcad/current/linux64/bin/python3
```

### Environment Variables (Required)
```python
import os
os.environ["STROOT"] = "$SENTAURUS_HOME"
os.environ["SENTAURUS_HOME"] = "$SENTAURUS_HOME"
os.environ["STRELEASE"] = "$SENTAURUS_VERSION"
os.environ["STDB"] = "$STDB"
os.environ["QT_QPA_PLATFORM"] = "offscreen"  # Required for headless mode
```

### Python Path
```python
import sys
sys.path.insert(0, "$SENTAURUS_HOME/tcad/current/linux64/lib/python3.6/site-packages")
```

## Running Projects via Deck API

### Basic Code
```python
import os
import sys

os.environ["STROOT"] = "$SENTAURUS_HOME"
os.environ["SENTAURUS_HOME"] = "$SENTAURUS_HOME"
os.environ["STRELEASE"] = "$SENTAURUS_VERSION"
os.environ["STDB"] = "$STDB"
os.environ["QT_QPA_PLATFORM"] = "offscreen"

sys.path.insert(0, "$SENTAURUS_HOME/tcad/current/linux64/lib/python3.6/site-packages")

from swbpy2.gtree import Deck

deck = Deck("$STDB/YourProject")
deck.preprocess()
deck.run(queue="local:default")
print(deck.status())
```

## Key Issues and Solutions

### ⚠️ Issue 1: gtooldb.tcl Configuration (Most Important!)

**Error**: `KeyError: "Key 'sprocess,acronym' not found in DBToolContext"`

**Cause**: Project uses custom tool names (e.g., NMOS, DevMesh) that need mapping to actual tools.

**Solution**: Create `gtooldb.tcl` file:
```tcl
# Load global tool database
source $SENTAURUS_HOME/tcad/$SENTAURUS_VERSION/lib/glib2/tooldb.tcl

# Map custom tool names to actual tools
set WB_tool(NMOS,sprocess) sprocess
set WB_tool(DevMesh,sprocess) sprocess
set WB_tool(IdVg,sdevice) sdevice
set WB_tool(IdVd,sdevice) sdevice
set WB_tool(BV,sdevice) sdevice
set WB_tool(Plot_IdVg,svisual) svisual
set WB_tool(Plot_IdVd,svisual) svisual
set WB_tool(Plot_BV,svisual) svisual
```

### ⚠️ Issue 2: File Suffix Format

**Important**: Sentaurus tools use specific file suffix formats:
- sprocess: `{toolname}_fps.cmd` (e.g., NMOS_fps.cmd)
- sdevice: `pp{node}_des.cmd`
- sde: `n{node}_dvs.cmd`

Not `{toolname}_sprocess.cmd` or `{toolname}_sdevice.cmd`

### ⚠️ Issue 3: Headless Operation

**Set QT_QPA_PLATFORM**:
```bash
export QT_QPA_PLATFORM=offscreen
```

## Running Commands

### gsub Commands
```bash
# Run all
gsub .

# Run single node
gsub -n 7 .

# Specify queue
gsub -q local:default .
```

### Execute Python via SSH
```bash
ssh -i $SENTAURUS_VM_KEY $SENTAURUS_VM_USER@$SENTAURUS_VM_IP \
  "export QT_QPA_PLATFORM=offscreen && $SENTAURUS_HOME/bin/gsub -n 7 $STDB/YourProject"
```

## Monitoring Simulation Status

### Check Node Status File
```bash
cat results/nodes/7/n7_fps.sta
```

### View Output Log
```bash
tail -f results/nodes/7/n7_fps.out
```

### View Generated Files
```bash
ls -la results/nodes/7/*.tdr
```

### Check Process
```bash
ps aux | grep sprocess
```

## Quick Command Reference

| Operation | Command |
|------------|---------|
| Load Project | `Deck(project_path)` |
| Preprocess | `deck.preprocess()` |
| Run | `deck.run(queue="local:default")` |
| Status | `deck.status()` |
| Run Single Node | `gsub -n {node} .` |
| View Log | `tail -f n*.out` |
| View Status | `cat n*.sta` |

## Environment Variables Summary

| Variable | Description | Example |
|----------|-------------|---------|
| `$SENTAURUS_VM_IP` | VM IP address | `192.168.1.100` |
| `$SENTAURUS_VM_USER` | VM username | `tcaduser` |
| `$SENTAURUS_VM_KEY` | SSH private key path | `~/.ssh/id_rsa` |
| `$SENTAURUS_HOME` | Sentaurus installation root | `/opt/synopsys/sentaurus/T-2022.03` |
| `$SENTAURUS_VERSION` | Sentaurus version | `T-2022.03` |
| `$STDB` | Project library root | `/home/$SENTAURUS_VM_USER/STDB` |

## Testing Notes

### 2026-03-15 Project Test
1. Created gtooldb.tcl to resolve tool mapping issue
2. `gsub -n 7` successfully started sprocess
3. sprocess running normally, generated n7_1_fps.tdr, n7_2_fps.tdr
4. Simulation still in progress (PID 38946)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

awesome-tcadclaw

Directory Structure

SKILL.md

Report

Notice