WebPicSimulator

Simulatore PIC16F84A per WordPress

Un plugin didattico che simula un microcontrollore Microchip PIC16F84A direttamente nel browser. Editor Assembly, assemblatore, debugger con breakpoint e pannelli di ispezione. Nessuna toolchain da installare, nessun hardware richiesto.

Versione: 1.0.1
Autore: Davide Bertolino
Licenza: GPL v2 or later
Richiede WordPress: 5.8+
Richiede PHP: 7.4+

Descrizione

WebPicSimulator porta la programmazione dei microcontrollori in classe senza MPLAB, senza programmatore e senza breadboard. Lo studente scrive Assembly nell'editor, assembla, e vede il programma girare istruzione per istruzione con registri, memoria e pin sotto gli occhi.

Tutto avviene lato client: nessun dato lascia il browser, nessuna chiamata a servizi esterni. Il simulatore riproduce il comportamento del chip reale — banking della RAM, latch di porta distinti dai livelli sui pin, prescaler del Timer0, vettore di interrupt a 0x004, stack hardware a 8 livelli che avvolge.

Caratteristiche

Core PIC16F84A

• Set di istruzioni completo a 14 bit
• 1K di memoria programma, 68 byte di GPR, 64 byte di EEPROM
• Banking Bank 0/Bank 1 con indirizzamento indiretto via INDF/FSR
• Stack hardware a 8 livelli
• Timer0 con prescaler configurabile e clock interno o esterno (RA4/T0CKI)
• Interrupt: Timer0, INT esterno su RB0, cambio su RB4-RB7, fine scrittura EEPROM
• EEPROM con la sequenza di sblocco 0x55/0xAA

Assemblatore

• Due passate con risoluzione delle etichette in avanti
• Direttive ORG, EQU, CBLOCK/ENDC, DW, DT, DE, DATA, RES
• Letterali esadecimali, binari, ottali, decimali e carattere in tutte le notazioni MPASM
• Errori riportati riga per riga, evidenziati nell'editor
• Disassemblatore, usato nella vista Programma

Debugger

• Run, Step, Step Over, Animate e Reset, con velocità regolabile
• Breakpoint cliccabili sui numeri di riga
• Pannelli: Registri, bit di STATUS, Stack, Memoria (RAM/Programma/EEPROM), TMR0
• Celle di RAM ed EEPROM editabili a mano durante l'esecuzione
• Pin di ingresso cliccabili per simulare pulsanti e segnali esterni
• Vista Programma con disassemblato e istruzione corrente evidenziata

Uso in classe

• 10 esempi progressivi, dal blink LED alla macchina a stati
• Load e Save dei sorgenti .asm dal PC locale
• Modalità a schermo intero
• Scorciatoie da tastiera, attive solo quando il simulatore ha il focus

Installazione

1. Carica la cartella pic-simulator in /wp-content/plugins/
2. Attiva il plugin dal menu Plugin in WordPress
3. Inserisci lo shortcode [pic_simulator] in una pagina

Gli aggiornamenti successivi arrivano dalle release GitHub e compaiono nella pagina Plugin come per ogni altro plugin.

Shortcode

[pic_simulator]
[pic_simulator height="600px" fullwidth="yes"]

È possibile inserire un solo simulatore per pagina: l'interfaccia usa identificatori fissi.

Scorciatoie

Struttura

pic-simulator/
├── pic-simulator.php        # Bootstrap, shortcode, pagina admin
├── uninstall.php            # Pulizia alla disinstallazione
├── inc/
│   └── class-updater.php    # Aggiornamenti da GitHub Releases (condiviso)
├── assets/
│   ├── css/
│   │   ├── style.css        # Interfaccia del simulatore
│   │   └── db-admin-ui.css  # Design system admin (condiviso)
│   └── js/
│       ├── pic16f84a.js     # Core CPU: istruzioni, memoria, periferiche
│       ├── assembler.js     # Assemblatore a due passate e disassemblatore
│       ├── simulator.js     # Motore di esecuzione e breakpoint
│       └── ui.js            # Controller dell'interfaccia
├── templates/
│   ├── simulator.php        # Template HTML del simulatore
│   └── admin/
│       └── settings.php     # Pagina informazioni
└── examples/                # 10 programmi Assembly didattici

Esempi inclusi

Privacy

Nessuna richiesta a servizi esterni: niente font da CDN, niente analytics, niente chiamate di rete durante l'uso. Il plugin non scrive nulla nel database, a parte la cache dell'updater.

Limitazioni

Questo è un simulatore didattico:

• Non sostituisce MPLAB X né un programmatore reale
• Il watchdog timer è dichiarato ma non implementato
• I tempi di ciclo sono approssimati: non c'è simulazione al quarto di ciclo
• Alcuni dettagli di temporizzazione sono semplificati (scrittura EEPROM istantanea, inibizione di TMR0 dopo la scrittura)
• L'assemblatore non valuta espressioni nelle direttive EQU
• L'export Intel HEX esiste nel codice (Simulator.exportHex()) ma non è ancora collegato a un comando dell'interfaccia

Licenza

GPL v2 or later

Sei libero di utilizzare, modificare e distribuire questo plugin.

Disclaimer: Questo progetto non è affiliato con Microchip Technology Inc. "PIC" e "MPLAB" sono marchi registrati di Microchip Technology Inc.

Autore

Davide "the Prof." Bertolino

• 🌐 www.davidebertolino.it
• ✉️ info@davidebertolino.it