Converti ASM in PDF

Una copia PDF consente ai revisori di stampare o archiviare il codice sorgente in linguaggio assembly senza richiedere un assembler e consente ai destinatari CAD di esaminare un assieme quando non dispongono dell'applicazione di authoring. La procedura corretta dipende dal fatto che .asm contenga codice sorgente per processori oppure un assieme CAD.

Cos'è il formato ASM

.asm è un'estensione ambigua. Nei progetti software, identifica solitamente codice sorgente in linguaggio assembly in testo semplice per processori come x86, ARM, MIPS, 8051 o 6502. MASM, NASM, GNU assembler, Keil, MPLAB e gli IDE per sistemi embedded possono creare questi file. Possono contenere istruzioni, label, direttive, macro, commenti e istruzioni include.

Nel CAD meccanico, .asm può identificare un documento di assieme, in particolare in Solid Edge. Un assieme CAD normalmente fa riferimento a file separati di parti e sottoassiemi; non è un documento di testo semplice e non può essere convertito correttamente semplicemente rinominando l'estensione o inviandolo a un convertitore da testo a PDF.

Cos'è il formato PDF

PDF memorizza una rappresentazione visiva impaginata con font, posizionamento, grafica e impostazioni di stampa. È adatto a listati di codice, documentazione tecnica, copie per la revisione e snapshot d'archivio, ma non compila il codice sorgente assembly né conserva la modificabilità nativa, la cronologia parametrica o la struttura completa dei componenti di un assieme CAD.

Convertire il codice sorgente in linguaggio assembly su Windows

1. Aprire il file .asm in Notepad++, Visual Studio Code o un altro editor di testo. Non aprirlo in un elaboratore di testi che potrebbe sostituire le tabulazioni o alterare i caratteri.
2. Selezionare il lexer più vicino al linguaggio assembly se si desidera la colorazione della sintassi. In Notepad++, usare Language → A → Assembly; la colorazione è visiva e non verifica la sintassi né identifica il dialetto del processore.
3. Usare un font monospaziato come Consolas o DejaVu Sans Mono. Impostare l'interlinea, i margini, l'orientamento e una dimensione del font che impedisca alle istruzioni importanti di andare a capo.
4. Scegliere File → Print, selezionare Microsoft Print to PDF e impostare formato della carta, orientamento, margini, numeri di riga ed evidenziazione della sintassi nelle opzioni di stampa. Salvare il PDF risultante.

Per un PDF contenente solo codice, il comando di stampa di un editor è preferibile alla copia del codice sorgente in un elaboratore di testi, perché conserva più affidabilmente l'indentazione e la struttura delle righe.

Generare PDF evidenziati e ripetibili su qualsiasi piattaforma desktop

Pygments può creare una resa HTML che un browser stampa in PDF. Installarlo con:

python -m pip install Pygments

Per la sintassi NASM, eseguire:

pygmentize -l nasm -f html -O full,style=default -o program.html program.asm

Per la sintassi GNU assembler, usare -l gas; selezionare un altro lexer Pygments quando il dialetto lo richiede. Aprire program.html in un browser e scegliere Print → Save as PDF. Usare un font monospaziato, l'orientamento orizzontale, margini stretti e una scala adeguata per le righe lunghe. Questa procedura esegue il rendering del codice sorgente; non lo assembla né lo convalida.

Convertire un assieme Solid Edge o un altro assieme CAD

1. Aprire l'assieme nell'applicazione CAD nativa e risolvere i riferimenti mancanti a parti, sottoassiemi, materiali e texture prima dell'esportazione.
2. Usare il comando Publish 3D PDF di Solid Edge, se disponibile nella release e nella licenza installate, quindi selezionare le viste, le proprietà del modello, il PMI e la struttura dell'assieme richiesti. I nomi dei comandi e la disponibilità del 3D PDF variano in base alla release.
3. Per ottenere invece un documento tecnico piatto, creare o aprire un disegno e usare File → Export o Print per creare un PDF 2D. In questo modo si producono tavole di disegno, non un modello 3D interattivo.
4. Aprire il risultato in un visualizzatore PDF desktop che supporti contenuti 3D incorporati. Molti visualizzatori PDF per browser e app mobili mostrano solo la pagina o omettono le funzionalità 3D interattive.

Altri sistemi CAD possono pubblicare direttamente PDF 3D oppure richiedere un exporter o un translator. Un convertitore online generico non è un'alternativa affidabile, perché potrebbe ignorare i riferimenti dell'assieme, sopprimere componenti o supportare solo disegni 2D.

Convertitori online

CloudConvert e Online-Convert possono essere utili per attività di conversione da testo semplice a PDF quando il servizio accetta esplicitamente il file caricato o una copia temporanea .txt. Verificare il tipo di input, la codifica, il layout della pagina e il testo generato prima di condividere il risultato. I servizi online comunemente non supportano gli assiemi Solid Edge o l'esportazione di PDF 3D interattivi.

Non caricare firmware proprietario, credenziali, ricerche su exploit, codice sorgente non rilasciato o dati CAD riservati a meno che i termini di conservazione ed elaborazione del servizio non siano accettabili. L'esportazione locale da editor, browser o CAD nativo evita tale esposizione.

Limiti di qualità e compatibilità

La conversione in PDF non risolve i file include, non espande le macro, non rileva gli errori dell'assembler, non conserva le impostazioni di build né riproduce l'output eseguibile di un programma. Aprire il codice sorgente usando la codifica effettiva, comunemente UTF-8, prima della stampa; una codifica errata può sostituire i commenti non ASCII. Controllare le righe lunghe, le tabulazioni, i numeri di riga, le interruzioni di pagina, i simboli e i colori della sintassi nel PDF finale.

Conservare il file originale .asm e i relativi file del progetto o dei componenti CAD. L'estrazione del testo dal PDF può modificare tabulazioni, spazi bianchi, terminatori di riga e ordine di lettura, mentre un PDF 3D potrebbe omettere funzionalità CAD non supportate. Per le copie d'archivio, registrare il processore, l'assembler e la versione, la codifica del codice sorgente, l'applicazione CAD e la versione quando applicabile, le impostazioni di esportazione e la data di conversione.