Note d'installazione

WxPython logo

PCI Bus Simulator è scritto in python, un linguaggio interpretato dalle innumerevoli possibilità espressive, che supporta tutti le piattaforme più utilizzate in ambito desktop-pc, tra cui Windows, Mac OS X e GNU/Linux.
Per una lista completa delle piattaforme supportate, si rimanda alla pagina ufficiale

La libreria GUI utilizzata è WxPython, un wrapper di WxWidgets per il linguaggio Python. La libreria è multipiattaforma ed utilizza il front-end grafico presente nel sistema, il che permette di ottenere un aspetto grafico nativo di ogni piattaforma.

I front-end grafici utilizzati sono i seguenti:

Sistema operativo Font-end grafico
GNU/Linux GTK
Apple Mac OS X Cocoa
Microsoft Windows MSW

Piattaforma di sistema

La scelta di un linguaggio ed una libreria multipiattaforma garantisce, in teoria, il funzionamento del simulatore sui tre sistemi indicati in tabella.
Tuttavia, a causa di lievi differenze presenti nei diversi sistemi operativi, in alcuni sistemi potrebbe verificarsi il malfunzionamento di alcune componenti del simulatore.

Viene fornita la seguente tabella col fine di mantenere una storia dei sistemi operativi su cui il simulatore è stato testato e l'esito del test.

Sistema Operativo Versione OS/kernel Versione Python Versione WxPython Esito
GNU/Linux Debian jessie − Linux 3.2.0-2-686-pae 2.7.8 2.8.12.1 Funzionante
GNU/Linux Debian squeeze − Linux 2.6.32-5-686 2.6.6 2.8.10.1 Funzionante

Requisiti di sistema

Il programma necessita dei seguenti componenti software:

Componente Versione consigliata Pacchetto debian Url per il download
Inteprete Python 2.7.8 python-2.7 https://www.python.org/download
Libreria WxPython 2.8.12.1 python-wxgtk2.8 http://www.wxpython.org/download.php

N.B. La versione di WxPython utilizzata risulta essere pressoché ininfluente sul funzionamento del programma.
La versione dell'interprete Python, al contrario, è essenziale che ricada all'interno della categoria 2.6.x/2.7.x.
In particolare le versioni 3.x di Python presentano un cambiamento radicale del linguaggio e pertanto non sono retrocompatibili

Per l'installazione dei pacchetti, riferirsi alla documentazione relativa al vostro specifico sistema.
Una volta installati i pacchetti, per verificarne il corretto funzionamento digitare in una shell o in un prompt il seguente comando:

python -c "import platform; import wx; print 'Python: %s\nWxPython: %s' % (platform.python_version(), wx.version())"

Il comando dovrebbe mostrare in output la versione di Python e di WxPython in uso nel sistema.
Messaggi di errore in cui figuri ImportError indicano una non corretta installazione dell'ambiente Python o della libreria WxPython.

Installazione del simulatore

I sorgenti python sono interpretati direttamente dall'interprete, pertanto non richiedono una particolare procedura d'installazione.
E' necessario scompattare l' archivio contenente il simulatore in una directory a scelta. A questo punto, la cartella pcisim_10 estratta dovrebbe contenere due cartelle:

Esecuzione del simulatore

Per lanciare il simulatore basta posizionarsi da terminale nella cartella src/pcisim ed eseguire il comando:

python main.py

Qualora il sistema lo supportasse, è spesso sufficiente fare doppio click sul file main.py e selezionare l'opzione di esecuzione del file.
Si raccomanda, tuttavia, l'esecuzione da terminale per permettere la visualizzazione di eventuali errori in fase di esecuzione.


Home