Spazio di lavoro per il reverse engineering e lo sviluppo di software tecnico per l'ingegneria elettrica. Qui si studiano applicazioni, file e funzionalità con strumenti di analisi (REA, Ghidra) e si sviluppano strumenti propri, preferibilmente reimplementando le funzioni a partire dalle norme tecniche pubbliche. Il repository è condiviso tra il PC Windows dell'ufficio e le sessioni Claude Code nel cloud, e GitHub fa da punto di sincronizzazione.
- Capire come funziona un software o un formato di file (interoperabilità, documentazione, recupero di dati) usando REA e Ghidra su copie con licenza.
- Sviluppare software tecnico proprio, ad esempio calcoli elettrici secondo le norme IEC, con codice testato e documentato.
- Tenere traccia del lavoro: ogni progetto ha una cartella con analisi, evidenze, codice e test, versionata su GitHub e sempre consultabile.
Reverse_Engineering/
├── README.md ← questa pagina
├── CONTRIBUTING.md ← come aprire un progetto e contribuire
├── CHANGELOG.md ← cronologia delle modifiche
├── LICENSE ← licenza MIT
├── CLAUDE.md ← istruzioni e flusso di lavoro per Claude Code
├── .mcp.json ← registra REA come server MCP per Claude Code
├── .gitignore ← esclude binari, archivi di analisi, file temporanei
├── .editorconfig ← stile dei file (UTF-8, LF, indentazione)
├── .github/ ← modelli per pull request e segnalazioni
├── scripts/
│ ├── setup-cloud.sh ← installa REA + skill + Ghidra nelle sessioni cloud
│ └── setup-mac.sh ← installa REA, SolidCraft, Open CAD Studio, OpenSCAD (e Ghidra) su macOS
└── Wiki_Progettazione/
└── PROGRAMMAZIONE/ ← cartella di lavoro principale
├── README.md ← indice dei progetti
├── _MODELLO_PROGETTO/← modello da copiare per ogni nuovo progetto
└── <NomeProgetto>/ ← un progetto per cartella
├── README.md ← obiettivo, target, stato, conclusioni
├── analisi/ ← note di analisi con evidenze
└── implementazione/ ← codice e test
| Progetto | Descrizione | Stato |
|---|---|---|
| Electrical Power Simulator Software | Simulatore di reti elettriche ispirato a ETAP Power Simulator, ricostruito dalle norme tecniche pubbliche (nessuna decompilazione di software commerciale). Pacchetto Python iec60909: correnti di cortocircuito secondo IEC 60909-0:2016, flusso di potenza (Newton-Raphson), arc flash secondo IEEE 1584-2018, coordinamento delle protezioni, stabilità transitoria, armoniche, avviamento dei motori, affidabilità, dimensionamento dei cavi e portate dei cavi MT secondo IEC 60287, validati con calcoli a mano, con pandapower e (cortocircuito) con gli studi della demo di ETAP. |
Cortocircuito IEC 60909, flusso di potenza, arc flash IEEE 1584 e coordinamento delle protezioni, stabilità transitoria, armoniche, avviamento dei motori, affidabilità, dimensionamento dei cavi e portate MT (IEC 60287) implementati e testati |
L'elenco aggiornato è anche in
Wiki_Progettazione/PROGRAMMAZIONE/README.md.
- Richiesta: si indica cosa analizzare o sviluppare (un'applicazione, un file, un sito, una funzionalità, un calcolo).
- Cartella di progetto: si crea
Wiki_Progettazione/PROGRAMMAZIONE/<NomeProgetto>/copiando_MODELLO_PROGETTO/, e si lavora solo lì. - Avanzamento su GitHub: a ogni passo significativo (analisi completata, conclusione, pezzo di implementazione con test) si fa commit e push, non solo alla fine; si aggiorna la tabella dei progetti.
I dettagli operativi per Claude Code sono in CLAUDE.md; le
convenzioni per chi contribuisce sono in CONTRIBUTING.md.
| Strumento | Uso | Note |
|---|---|---|
| REA – Reverse Engineer Anything | Analisi di applicazioni JavaScript/Electron, .NET, siti web e binari nativi | Pacchetto npm rea-agents@6.9.0, registrato come server MCP in .mcp.json |
| Ghidra 12.1.4 | Motore per l'analisi dei binari nativi usato da REA | Richiede JDK 21 a 64 bit e la variabile GHIDRA_INSTALL_DIR |
| Python 3.10+ | Implementazioni e test dei progetti (es. iec60909) |
numpy; pytest e pandapower per i test |
Requisiti: Git, Node.js 22.23.4+ (o 24.22.1+, 26.12.1+; non 23 e 25), Claude Code.
La cartella Wiki Progettazione sul PC deve diventare (o contenere) un clone di
questo repository. Da PowerShell:
cd C:\Users\pietr\Workspace\02_TECNICO
git clone https://github.com/gioorom/Reverse_Engineering.git
# copia eventuali file già presenti nella vecchia cartella PROGRAMMAZIONE in:
# Reverse_Engineering\Wiki_Progettazione\PROGRAMMAZIONE\
npm install --global rea-agents@6.9.0
rea setup --client claude_code # registra REA e installa la skill
rea doctor # verifica
cd Reverse_Engineering
claudeIn alternativa, dalla cartella del repository, uno script installa tutto
(Git e Node 24 se mancano; un Node troppo vecchio viene aggiornato, REA con la skill, JDK 21 e Ghidra 12.1.4 con
GHIDRA_INSTALL_DIR); richiede winget (provato su Windows x64 con un Node 24 già installato):
powershell -ExecutionPolicy Bypass -File scripts\setup-windows.ps1A mano, per l'analisi di binari nativi serve Ghidra 12.1.4 (gratuito):
scarica ghidra_12.1.4_PUBLIC_20260921.zip dalle
release ufficiali,
estrailo (es. in C:\tools\), installa un JDK 21 a 64 bit e imposta la
variabile d'ambiente utente:
setx GHIDRA_INSTALL_DIR "C:\tools\ghidra_12.1.4_PUBLIC"Poi riapri il terminale e verifica con rea doctor. L'analisi di
JavaScript/Electron, .NET e siti web non richiede motori esterni.
Per i progetti Python (es. iec60909) serve Python 3.10 o successivo; le
istruzioni di installazione e test sono nel README di ciascun progetto.
Il container delle sessioni Claude Code nel cloud è temporaneo: a ogni nuova sessione esegui (o inserisci nello script di setup dell'ambiente)
bash scripts/setup-cloud.shLo script è idempotente: se serve aggiorna Node alla 22.23.4 (release ufficiale,
hash verificato), installa rea-agents@6.9.0, la skill di REA per
Claude Code (~/.claude/skills/reverse-engineer-anything, con
rea setup --skill-client claude_code; il server MCP resta quello di
.mcp.json) e Ghidra 12.1.4 in /opt/ghidra_12.1.4_PUBLIC (verificando
l'hash SHA-256 dell'archivio) e salta i passi già fatti. Richiede un JDK 21+.
Sul Mac, dalla cartella del repository:
bash scripts/setup-mac.sh # REA, SolidCraft, Open CAD Studio, OpenSCAD
bash scripts/setup-mac.sh --ghidra # anche Ghidra 12.1.4 (con JDK 21)
bash scripts/setup-mac.sh --senza-openscad --senza-opencadstudioPrerequisiti: Homebrew e Xcode (per OpenSCAD serve Xcode completo, per il resto bastano gli strumenti da riga di comando). Lo script è idempotente e installa le versioni fissate in testa al file, tutte da GitHub o npm:
| Strumento | Versione | Origine |
|---|---|---|
REA (rea-agents) + skill Claude Code |
6.9.0 | npm (sorgenti su morluto/rea) |
| SolidCraft | 0.43.0 | release GitHub tangency-labs/solidcraft, solidcraft-macos-universal.dmg (hash SHA-256 verificato) → /Applications |
| Open CAD Studio | v2026.46 | release GitHub HakanSeven12/OpenCADStudio, OpenCADStudio-v<versione>-macos-arm64.dmg (hash SHA-256 verificato) → /Applications |
| OpenSCAD | openscad-2026.10-TEST4 |
compilato dai sorgenti GitHub openscad/openscad (dipendenze Homebrew) → /Applications |
| Ghidra (facoltativo) | 12.1.4 | release GitHub, hash SHA-256 verificato → ~/.local |
Note:
- OpenSCAD non pubblica eseguibili per macOS su GitHub (solo i sorgenti):
l'ultima versione stabile, la 2021.01, è del 2021; il tag
openscad-2026.10-TEST4è una versione di prova della prossima release. La compilazione richiede parecchio tempo. - SolidCraft installa anche
solidcraft-clinel PATH. Le note di rilascio del progetto dicono che i pacchetti non sono ancora firmati: se macOS blocca il primo avvio, fai clic destro suSolidCraft.appe scegli Apri. La firma non è stata verificata su un Mac. - Open CAD Studio esce ogni domenica (versioni
anno.settimana), solo per Mac con Apple Silicon; non è notarizzato: se macOS blocca il primo avvio, approvalo in Impostazioni di Sistema → Privacy e sicurezza. - Gli hash dei dmg sono stati calcolati sui file delle release al momento
dell'aggiornamento dello script. SolidCraft pubblica anche i propri
checksum (
SHA256SUMS.txt), con cui l'hash è confrontato; Open CAD Studio non ne pubblica. - Se Node manca o è più vecchio di quanto richiede REA, lo script installa
node@22con Homebrew. - Ghidra 12.2 non è usato: REA 6.9.0 accetta solo Ghidra 12.1.x.
- Le versioni installate sono riepilogate in
~/.config/reverse-engineering/versioni-installate.txt.
PC, GitHub e cloud restano allineati tramite git:
- prima di iniziare:
git pull - alla fine (o a ogni passo significativo):
git add -A && git commit -m "..." && git push
Le sessioni cloud lavorano su un branch dedicato e aprono una pull request:
dopo il merge, sul PC basta git pull.
- Solo copie con licenza: si analizzano esclusivamente programmi e file di cui si possiede una copia legittima.
- Quadro normativo: l'analisi rientra nei limiti della Direttiva 2009/24/CE sulla tutela giuridica dei programmi per elaboratore, in particolare l'art. 5, par. 3 (osservare, studiare e sperimentare il funzionamento di un programma per determinarne idee e principi) e l'art. 6 (decompilazione consentita solo se indispensabile per ottenere le informazioni necessarie all'interoperabilità, e nei limiti ivi previsti).
- Nessun binario nel repository: eseguibili, librerie, installer e archivi
da analizzare restano fuori da git (vedi
.gitignore); nel README del progetto si annotano solo provenienza e versione. - Prima le norme pubbliche: quando l'obiettivo è ottenere una funzione (come un calcolo elettrico), si preferisce reimplementarla dalle norme tecniche e dalla letteratura pubblica invece di decompilare software commerciale, come avviene in Electrical Power Simulator Software.
- Evidenze verificabili: ogni conclusione rimanda alle note in
analisi/, e ogni implementazione ha test che ne confrontano i risultati con riferimenti indipendenti.
Distribuito con licenza MIT: il contenuto può essere usato, modificato e redistribuito liberamente, mantenendo l'avviso di copyright.
I calcoli sono forniti "così come sono", senza garanzie (vedi la licenza): i risultati vanno sempre verificati da un tecnico abilitato prima di essere usati per progettazione o dimensionamento.