Fusion 360 - Esportatore Batch CAD e CAM (CAMExporter)

CAMExporter è un add-in C++ ad alte prestazioni per Autodesk Fusion 360 che esporta in batch dati di produzione CAD + CAM in una struttura di cartelle pulita, riproducibile e pronta per l'officina. Cattura setup CAM, operazioni, utensili, parametri, WCS/grezzo, genera fogli di setup e opzionalmente esporta geometria STEP, archivi F3D e librerie utensili compatibili con HSMWorks.

Se hai bisogno di un modo affidabile per archiviare lavori di lavorazione, trasferire l'intento CAM o riprodurre percorsi utensile di Fusion 360 in HSMWorks, CAMExporter fornisce una pipeline di esportazione pratica "un solo click" sia per singoli documenti che per intere cartelle del Data Panel.

Perché CAMExporter per Fusion 360 CAD/CAM?

I team di produzione spesso necessitano di più di un semplice file NC post-processato:

Riproducibilità del lavoro: preservare definizioni di setup, alberi delle operazioni, assegnazioni utensili e valori dei parametri.
Tracciabilità del processo: mantenere WCS, definizioni del grezzo e la lista delle operazioni che ha creato il programma.
Collaborazione: condividere un pacchetto di esportazione autonomo con colleghi, fornitori o un ufficio di programmazione.
Archiviazione in batch: esportare tutti i progetti in una cartella del Data Panel di Fusion (incluse le sottocartelle) in un'unica esecuzione.

CAMExporter è progettato per utenti CAM di Fusion 360, programmatori CNC, ingegneri di produzione e costruttori di pipeline CAD/CAM che desiderano esportazioni strutturate adatte per pacchetti lavoro, allegati PDM/PLM o archivi di produzione.

Funzionalità Principali (Add-In Fusion 360)

Esporta setup e operazioni CAM con cattura approfondita dei parametri
Estrai definizioni degli utensili (JSON + libreria .tools opzionale)
Genera fogli di setup (HTML) con screenshot
Esporta geometria CAD (STEP AP214 opzionale)
Crea backup nativi (archivio F3D opzionale)
Scrivi WCS + grezzo JSON per validazione a valle
Crea un CSV avanzamenti e velocità per revisione rapida in officina
Esportazione batch di intere cartelle del Data Panel (ricorsiva)
Salta esportazioni esistenti per esecuzioni incrementali veloci
Log di debug per documento per verificabilità e risoluzione problemi

Comandi in Fusion 360

CAMExporter installa due pulsanti nella scheda Utilità sia nell'ambiente Design che in quello Produzione.

Pulsante	Cosa fa
Export CAM	Esporta il documento attualmente attivo in `Desktop/fusion-export/<nomedoc>/`
Export Folder	Esporta in batch ogni file `.f3d` visibile nella cartella corrente del Data Panel (e tutte le sottocartelle) in una directory scelta dall'utente

Opzioni di Esportazione (Attivabili per Esecuzione)

Entrambi i comandi mostrano una finestra di dialogo con checkbox prima dell'esportazione. Ogni tipo di esportazione può essere abilitato indipendentemente.

Opzione	Default	Output
Esportazione CAM (setup/utensili)	✅ attivo	`cam_export.json` — setup, operazioni, utensili, parametri, template XML
Fogli di Setup (HTML)	✅ attivo	`setup-sheets/*.html` — una pagina HTML per setup con screenshot renderizzati
Esportazione STEP (geometria)	☐ disattivo	`geometry/<nomedoc>.step` — modello completo in formato STEP AP214
Archivio F3D (backup nativo)	☐ disattivo	`geometry/<nomedoc>.f3d` — file archivio nativo Fusion
Libreria Utensili (.tools)	☐ disattivo	`<nomedoc>.tools` — libreria utensili XML compatibile HSMWorks
Salta Esistenti	☐ disattivo	Salta i documenti la cui cartella di output esiste già su disco

I dati WCS/Grezzo e il CSV Avanzamenti e Velocità vengono sempre prodotti insieme all'Esportazione CAM (condividono lo stesso toggle).

Cosa Viene Esportato (CAM, Utensili, Parametri, Documentazione Lavoro)

CAMExporter si concentra sulla completezza produttiva: catturando sia documentazione leggibile dall'uomo (fogli di setup, riepiloghi markdown, CSV) che strutture ricostruibili dalla macchina (template XML, liste parametri, JSON utensili).

Esportazione CAM (JSON)

Il payload principale è cam_export.json, che include:

Setup e alberi delle operazioni
Identificatori di strategia delle operazioni
Flag di stato (soppressi, avvisi, errori)
Utensili (geometria completa + parametri di taglio)
Parametri enumerati (valori tipizzati, espressioni, modificabilità)
Template XML Fusion/HSM integrato per ricostruzione

Fogli di Setup (HTML)

I fogli di setup vengono esportati in setup-sheets/:

Una pagina HTML per setup
Include screenshot renderizzati
Utile per la stampa o come allegato ai documenti di viaggio del lavoro

Esportazioni Geometria (Opzionali)

Per supportare CAD/CAM a valle o archiviazione:

Esportazione STEP AP214: geometry/<nomedoc>.step
Archivio Fusion (F3D): geometry/<nomedoc>.f3d

Esportazione Libreria Utensili (Opzionale)

Per portabilità tra ambienti CAM basati su HSM:

Genera <nomedoc>.tools — una libreria utensili XML compatibile HSMWorks

Esportazione WCS + Grezzo (JSON)

Esporta offset di lavoro e definizioni del grezzo per setup:

wcs_stock.json con assi/origine WCS e dimensioni del grezzo a livello di setup

CSV Avanzamenti e Velocità

Crea un foglio di revisione rapida per verifica programmazione e comunicazione con l'officina:

feeds_speeds.csv (compatibile Excel)
Le colonne includono setup, operazione, numero utensile, RPM, avanzamento, DOC, stepover

Strategia di Estrazione a Tre Livelli (Massima Fedeltà CAM)

I dati CAM di Fusion possono essere difficili da riprodurre da un singolo percorso API. CAMExporter utilizza una strategia di estrazione a tre livelli per catturare il massimo dettaglio in modo affidabile.

Livello	Metodo API	Cosa cattura
Template XML	`CAM::generateTemplateXML(setup)`	Albero completo delle operazioni — riferimenti geometrici, assegnazioni utensili e tutte le impostazioni native Fusion/HSM (XML)
JSON Utensili	`Tool::toJson()`	Geometria completa dell'utensile e parametri di taglio come JSON
Enumerazione Parametri	Iterazione `CAMParameters`	Ogni parametro: nome, espressione, valore tipizzato (`boolean`/`integer`/`float`/`string`/`choice`), modificabilità

Questo approccio fornisce:

Uno snapshot "fonte di verità" (template XML)
Dati parametrici ricercabili e tipizzati (enumerazione)
Ricostruzione portabile degli utensili (JSON utensili / .tools)

Struttura Cartelle Output (Per Documento)

Ogni documento Fusion viene esportato in una cartella autonoma:

<dir-output>/<nome-documento>/
├── cam_export.json          # Setup CAM, operazioni, utensili, parametri, template XML
├── wcs_stock.json           # Sistemi di coordinate di lavoro + definizioni grezzo per setup
├── feeds_speeds.csv         # Tabella di riferimento rapido: operazione, utensile, RPM, avanzamento, DOC, stepover
├── <nome-documento>.tools   # Libreria utensili XML compatibile HSMWorks
├── export.log               # Log di debug per esportazione
├── geometry/
│   ├── <nome-documento>.step # Esportazione STEP AP214
│   └── <nome-documento>.f3d  # Archivio nativo Fusion
├── setup-sheets/
│   └── Setup1.html          # Foglio di setup HTML (uno per setup)
└── setups/
    └── <NomeSetup>/
        └── Readme.md        # Riepilogo Markdown con tabella operazioni, utensili, info grezzo

Readme Markdown a Livello di Setup (Compatibile con Pacchetti Lavoro)

Ogni setup riceve un Readme.md dentro setups/<NomeSetup>/ contenente:

Nome e tipo del setup
Grezzo: modalità, metadati materiale (nome, categoria, durezza), dimensioni e offset
Tabella operazioni: lista ordinata, strategia, numero utensile, RPM, avanzamento, velocità superficiale, indicatori di stato (⚠️/❌), stato di soppressione, raggruppamento pattern/cartella
Tabella utensili: utensili unici referenziati dal setup (numero, tipo, diametro, descrizione)

Panoramica Schema JSON CAM

cam_export.json è strutturato sia per leggibilità che per automazione a valle.

cam_export.json
├── exportVersion, exportDate, documentName
├── fusionVersion, hostname, username
├── setups[]
│   ├── name, strategy, flag di stato
│   ├── templateXML        ← XML completo del setup (incollare in HSMWorks)
│   ├── parameters[]       ← parametri a livello di setup
│   └── operations[]
│       ├── name, strategy, operationId, flag di stato
│       ├── toolJson         ← definizione completa dell'utensile (geometria, eliche, ecc.)
│       ├── toolParameters[] ← parametri utensile enumerati
│       └── parameters[]     ← parametri operazione (avanzamenti, velocità, profondità, ecc.)

Modalità Batch: Export Folder (Data Panel Ricorsivo)

Il comando Export Folder è costruito per l'esportazione batch CAD/CAM e l'archiviazione di produzione su larga scala.

Panoramica del processo:

Mostra le checkbox delle opzioni di esportazione
Apre un selettore cartella (default: Desktop/fusion-export)
Scansiona la cartella corrente del Data Panel ricorsivamente per file .f3d
Apre ogni documento, esegue le esportazioni selezionate, poi lo chiude
I documenti senza dati CAM vengono saltati silenziosamente
Se Salta Esistenti è abilitato, i documenti già esportati vengono saltati
Mostra un riepilogo al completamento

Questo rende pratico generare pacchetti di esportazione ripetibili per:

cartelle lavoro clienti
archivi di produzione annuali
pacchetti per consegne ai fornitori
revisione CAM interna e preventivazione

Workflow HSMWorks (Riproduzione Setup + Importazione Utensili)

L'output di CAMExporter è progettato per aiutare a ricostruire o verificare lavori in ambienti di tipo HSMWorks.

Riproduzione Setup

Ogni setup include templateXML, contenente dati nativi Fusion/HSM. Può essere caricato in HSMWorks tramite:

Setup::createFromTemplateXML()
o salvato come .hsmworks-template (dipendente dalla pipeline)

Importazione Utensili

Opzioni di portabilità utensili:

Importa <nomedoc>.tools direttamente come libreria utensili XML HSMWorks
Ricostruisci utensili individuali da toolJson tramite Tool::fromJson()

Revisione Avanzamenti e Velocità

Apri feeds_speeds.csv in Excel per una panoramica rapida di:

lista operazioni
RPM e avanzamenti
profondità di taglio e stepover

Utile come riferimento in officina e verifica setup CAM.

Debug e Tracciabilità

Ogni esportazione produce un log per documento:

<dir-output>/<nome-documento>/export.log

Il log include:

Tracciamento chiamate API e risultati
Errori (dati CAM mancanti, puntatori nulli, problemi I/O file)
Decisioni di salto (nessun dato CAM, output già esistente)
Tempistiche e riepiloghi di completamento

Se un'esportazione sembra fallire silenziosamente, export.log è il primo posto dove controllare.

Installazione e Distribuzione

Layout di Distribuzione

Il passaggio post-build copia automaticamente il manifesto e le risorse icona:

%APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\Exporter\
├── Exporter.dll
├── Exporter.manifest
└── resources/
    ├── export-cam/      (16x16.png, 32x32.png)
    └── export-folder/   (16x16.png, 32x32.png)

Primo Setup in Fusion 360

In Fusion 360: UTILITÀ → Add-Ins → trova Exporter → Esegui
Il pannello CAM Exporter appare in Utilità per Design e Produzione
Usa Export CAM (documento corrente) o Export Folder (esportazione batch)

Consiglio: abilita Esegui all'Avvio così i comandi sono sempre disponibili.

A Chi Si Rivolge

CAMExporter è ideale se:

programmi lavori CNC in Fusion 360 Manufacturing
hai bisogno di esportazioni dati CAM ripetibili e verificabili
vuoi impacchettare geometria + utensileria + documentazione setup insieme
gestisci molte parti e hai bisogno di esportazione batch dal Data Panel
supporti interoperabilità basata su HSM con librerie utensili HSMWorks e template XML