Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Reverse_Engineering

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.

A cosa serve

  • 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.

Contenuto del repository

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

Progetti

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.

Flusso di lavoro

  1. Richiesta: si indica cosa analizzare o sviluppare (un'applicazione, un file, un sito, una funzionalità, un calcolo).
  2. Cartella di progetto: si crea Wiki_Progettazione/PROGRAMMAZIONE/<NomeProgetto>/ copiando _MODELLO_PROGETTO/, e si lavora solo lì.
  3. 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.

Strumenti

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

Setup sul PC Windows

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
claude

In 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.ps1

A 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.

Sessioni cloud

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.sh

Lo 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+.

Mac

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-opencadstudio

Prerequisiti: 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-cli nel PATH. Le note di rilascio del progetto dicono che i pacchetti non sono ancora firmati: se macOS blocca il primo avvio, fai clic destro su SolidCraft.app e 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@22 con 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.

Sincronizzazione

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.

Principi

  • 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.

Licenza

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.

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages