Skip to content

zcohen-nerd/Fusion_System_Blocks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

210 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fusion System Blocks

Fusion System Blocks

A block-diagram editor that lives inside Autodesk Fusion.
Plan your system architecture without leaving your CAD environment.

License: Community Platform: Fusion


What This Tool Does

Fusion System Blocks adds a system block diagram palette directly inside Fusion. You draw blocks that represent the subsystems in your product — sensors, motors, PCBs, housings, software modules — and wire them together with typed connections. The diagram saves inside your Fusion document, right next to the 3D model.

Key capabilities:

  • Create blocks from electrical, mechanical, and software libraries with 8 supported shapes.
  • Connect blocks with typed wires, directional arrows, and optional orthogonal routing.
  • Link any block to an actual Fusion component so the diagram and the CAD model stay in sync.
  • Save diagrams and named variants inside the Fusion document, then create and restore snapshots from the History tab.
  • Run rule checks and requirements verification to catch orphan blocks, interface mismatches, and power-budget issues.
  • Export 11 report and artifact formats including BOM, connection matrix, SVG, PDF, and more.

Blank canvas – the diagram palette as it appears when first opened

The System Blocks palette, ready for a new diagram.


Why This Exists

Most engineering teams document their system architecture in separate tools — Visio, Draw.io, PowerPoint — that immediately fall out of sync with the CAD model. Fusion System Blocks keeps the diagram inside the assembly file so there is one source of truth. When you rename a component in the 3D model, the linked block updates automatically. When a newcomer opens the Fusion document, they see both the physical design and the logical architecture in one place.


Current Status

Experimental — V0.1.1

Core diagramming, named documents, snapshot history, CAD linking, rule checking, and 11-format exports are implemented and tested. Current workspace baseline: 707 automated tests and 32 in-app diagnostics checks. 16 of 18 milestones are complete; milestone 13 and milestone 15 remain not started. The add-in is usable for personal and academic projects. APIs and file formats may change before v1.0.


Installation

Requirements

  • Autodesk Fusion (latest version) on Windows 10/11 or macOS.
  • No other dependencies — Fusion bundles its own Python runtime.

Step-by-Step

  1. Download the latest release ZIP from the Releases page.

  2. Unzip it. You will get a single folder called Fusion_System_Blocks.

  3. Open Fusion (or restart it if it was already running).

  4. Go to Utilities → Add-Ins.

  5. Open Scripts and Add-Ins, switch to the Add-Ins tab, click the + button, and select the extracted Fusion_System_Blocks folder.

  6. Find Fusion System Blocks in the list, select it, and click Run.

    Optionally check Run on Startup so it loads every time you open Fusion.

  7. Manual alternative: copy the folder into the Fusion Add-Ins directory if you prefer a file-based install.

OS Path
Windows %APPDATA%\Autodesk\Autodesk Fusion\API\AddIns\
macOS ~/Library/Application Support/Autodesk/Autodesk Fusion/API/AddIns/

That's it — a "System Blocks" button appears in the toolbar. Click it to open the diagram palette.


Usage

What Is a System Block?

A system block is a rectangle (or other shape) on the diagram that represents one piece of your product — a motor controller, a chassis, a sensor module, a firmware process, etc. Each block has ports (connection points) and can carry metadata like status, cost, and mass.

Creating Your First Diagram

  1. Click the System Blocks button in the Fusion toolbar to open the palette.
  2. In the ribbon, choose a block type from the Create group (Electrical, Mechanical, or Software).
  3. The block appears on the canvas. Double-click it to rename it.
  4. Add a second block the same way.
  5. Select the first block and press C to enter connection mode, then click the second block. A wire appears between them.
  6. Press Ctrl+S to save the diagram inside the Fusion document.

A system diagram built in Fusion System Blocks

An example system diagram with blocks, connections, and hierarchy.

Typical Workflow

Open Fusion document
  → Open System Blocks palette
    → Add blocks for each subsystem
      → Wire them together
        → Link blocks to CAD components (optional)
          → Run Check Rules to validate
            → Export a report (PDF, BOM, etc.)
              → Save — diagram persists inside the .f3d file

Testing & Validation


License

Source code is available under the Fusion System Blocks Community License for personal, academic, and non-commercial use. Commercial use requires a paid license — open an issue to discuss.

About

Autodesk Fusion add-in for live system-level block diagrams—draw, link, and validate architecture directly inside Fusion with CAD/ECAD integration, rule checks, and reporting.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors