Parametro

Parent page: Oggetti schematici

I parametri vengono utilizzati per componenti (mostrati), documenti e progetti per aggiungere informazioni di dettaglio al progetto.

Riepilogo

I parametri sono stringhe di testo di uso generale che sono oggetti figli di un oggetto padre e consentono di aggiungere informazioni di dettaglio a tale oggetto padre. Ad esempio, i componenti schematici fanno ampio uso dei parametri. Vengono utilizzati per definire il Designator e il Comment, nonché le stringhe di parametro di uso generale che possono essere aggiunte per definirlo completamente. I parametri generici del componente possono essere usati per una varietà di funzioni, inclusi i dettagli del componente, come potenza, tensione, ecc., dettagli del fornitore, incluso il nome del fornitore e il codice componente, dettagli di progettazione del componente di libreria, come il numero di revisione del simbolo, e dettagli di documentazione, come un URL che collega al datasheet del componente.

I parametri possono essere definiti a livello di foglio schematico (documento) e a livello di progetto. I parametri a livello di documento sono ideali per definire campi come il titolo e il numero del documento, mentre i parametri a livello di progetto sono ideali per definire campi come il progettista o il nome del progetto.

Disponibilità

I parametri vengono aggiunti come proprietà dell'oggetto padre; non vengono posizionati in modo indipendente come una stringa di testo. I parametri possono essere aggiunti a uno qualsiasi dei seguenti oggetti di progetto:

• Component - aggiungere parametri definiti dall'utente nell'area Parameters della finestra di dialogo Component Properties o della finestra di dialogo Library Component Properties se vengono aggiunti durante la definizione del componente nell'editor della libreria schematica. I parametri Designator e Comment sono sempre presenti per un oggetto Component. Per accedere alla finestra di dialogo, fare doppio clic su un componente nell'editor Schematic oppure fare doppio clic sul nome del componente nel pannello Sch Library nell'editor della libreria schematica.
• Pin - nella scheda Parameters della finestra di dialogo Pin Properties.
• Port - nella scheda Parameters della finestra di dialogo Port Properties.
• Sheet Symbol - nella scheda Parameters della finestra di dialogo Sheet Symbol.
• Document - nella finestra di dialogo Document Options (Project | Content | ). I parametri sono elencati nella scheda Parameters della finestra di dialogo; in un nuovo foglio schematico sono inclusi automaticamente alcuni parametri predefiniti.
• Project - nella finestra di dialogo Options for Project (Project | Content | ). I parametri sono elencati nella scheda Parameters della finestra di dialogo.

Modifica grafica

Le stringhe visibili possono essere modificate graficamente usando la cosiddetta modifica in-place. Per modificare una stringa sul posto, fare clic una volta per selezionarla, attendere un secondo, quindi fare clic una seconda volta per entrare in modalità di modifica.

 Fare clic una volta per selezionare la stringa.

 Attendere, quindi fare clic una seconda volta per entrare nella modalità di modifica sul posto.

Il valore della stringa del designatore può essere modificato sul posto.

 Qui la stringa è stata selezionata, pronta per digitare una stringa sostitutiva.

Una volta completata la modifica, premere Enter oppure fare clic lontano dalla stringa per uscire dalla modalità di modifica sul posto.

Modifica tramite un pannello Inspector

Panel pages: SCH Inspector, SCHLIB Inspector

Un pannello Inspector consente di esaminare e modificare le proprietà di uno o più oggetti di progetto nel documento attivo.

Parametri del componente

I parametri del componente includono il designatore e il commento, oltre a eventuali parametri definiti dall'utente.

Modifica dei parametri del componente nell'editor della libreria schematica

Per impostazione predefinita, il designatore, il commento e i parametri definiti dall'utente non sono visibili nell'editor della libreria schematica. Vengono modificati nella finestra di dialogo Library Component Properties. Fare doppio clic sul nome del componente nel pannello SCH Library oppure fare clic sul pulsante Edit per aprire la finestra di dialogo, come mostrato nell'immagine seguente.

Fare doppio clic sul nome del componente oppure fare clic sul pulsante Edit per aprire la finestra di dialogo e modificare i parametri del componente nell'editor della libreria.

I parametri definiti dall'utente possono essere visualizzati abilitando la relativa casella di controllo Visible nella finestra di dialogo Library Component Properties. Abilitando questa opzione verrà visualizzato il parametro Value. Per visualizzare il nome del parametro, fare clic sul pulsante Edit per aprire la finestra di dialogo Parameter Properties in cui è possibile abilitare la casella di controllo Visible per il campo Name.

In alternativa, le stringhe del designatore e del commento possono essere visualizzate nell'editor della libreria schematica e quindi modificate con un doppio clic per cambiarne le proprietà. Per visualizzare queste stringhe, fare clic su Tools | Options |

per aprire la finestra di dialogo Library Editor Workspace, quindi abilitare l'opzione Always Show Comment/Designator come mostrato nell'immagine seguente. Questa impostazione è una proprietà della libreria schematica.

Abilitare l'opzione Always Show Comment/Designator per visualizzare queste stringhe nell'editor della libreria schematica.

Modifica dei parametri del componente nell'editor schematico

I parametri del componente possono essere definiti nell'editor schematico durante il posizionamento del componente oppure dopo che il componente è stato posizionato su un foglio schematico.

• Per definire il designatore/commento/parametro utente durante il posizionamento del componente, premere il tasto Tab mentre il componente è agganciato al cursore. Si aprirà la finestra di dialogo Properties for Schematic Component. Immettere la stringa richiesta per designatore/commento/parametro definito dall'utente, quindi fare clic su OK per chiudere la finestra di dialogo e completare il posizionamento del componente. Continuare a posizionare componenti oppure premere Esc per terminare il posizionamento.
• Per definire il designatore/commento/parametro utente dopo il posizionamento, fare doppio clic sul componente posizionato per aprire la finestra di dialogo Properties for Schematic Component in cui è possibile modificare designatore/commento/parametro utente. Fare clic su OK per chiudere la finestra di dialogo e confermare la modifica.

Modifica delle proprietà di visualizzazione dei parametri del componente

L'aspetto delle stringhe designatore/commento/parametro utente, inclusi tipo di carattere, dimensione e colore, può essere definito:

1. Come proprietà del simbolo impostando le proprietà del designatore/commento/parametro utente nella finestra di dialogo Parameter Properties nell'editor della libreria schematica. Ciò richiede che la stringa del designatore sia resa visibile, come descritto in precedenza.
2. Modificando la stringa designatore/commento/parametro utente del componente schematico posizionato: fare doppio clic sul componente per modificare le diverse proprietà del parametro.

Entrambi gli approcci aprono la finestra di dialogo Parameter Properties, come mostrato di seguito. Si noti che in questa finestra di dialogo è possibile modificare tutte le proprietà del parametro.

Il valore e l'aspetto della stringa Designator possono essere modificati nella finestra di dialogo Parameter Properties.

Fissare la posizione delle stringhe di parametro

Il comportamento predefinito di una stringa di parametro del componente è di posizionarsi automaticamente quando un componente viene ruotato durante il posizionamento. Se questo comportamento non è richiesto, disattivare l'opzione Autoposition nella finestra di dialogo Parameter Properties (fare riferimento all'immagine precedente) durante la creazione del simbolo oppure dopo che il componente è stato posizionato su un foglio schematico. Si noti che così facendo questo parametro viene classificato come manual parameter (ovvero parametro posizionato manualmente). I parametri manuali sono identificati da un punto nell'angolo inferiore sinistro del relativo riquadro di selezione.

Parametri speciali del componente

Sono stati creati parametri speciali del componente per definire collegamenti dai componenti alla documentazione correlata. Tra questi vi sono la coppia di parametri HelpURL e ComponentLink.

Il parametro HelpURL

Il parametro HelpURL consente di definire un collegamento da un componente a un documento esterno, come un PDF o una pagina web. Il collegamento viene attivato quando si preme F1 sul componente nel foglio schematico oppure quando quel componente è selezionato nel pannello Libraries. Usando questo parametro è possibile fare riferimento a un PDF, un file di testo o una pagina HTML. Per utilizzare la funzione, aggiungere il parametro HelpURL al componente richiesto e impostare il valore del parametro sul documento che si desidera aprire.

Quando si specifica il valore del parametro, è possibile includere un percorso assoluto oppure immettere il nome del documento. I seguenti esempi sono voci valide per il valore del parametro:

• C:\Design_Projects\Schematics\Modifications.txt
• From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
• www.circuitstudio.com

Quando si preme F1 con il cursore posizionato sull'oggetto collocato, la ricerca del documento viene eseguita come segue:

• Se viene specificato un percorso, questa posizione viene cercata per prima,
• Se il documento non può essere trovato in questa posizione o se non è specificato alcun percorso, viene cercata la cartella \Help dell'installazione di CircuitStudio,
• Se il documento non viene trovato, viene visualizzato l'argomento della guida predefinito per l'oggetto.

La coppia di parametri ComponentLink

Questa funzione consente di definire e presentare collegamenti con nome a un numero qualsiasi di documenti di riferimento. È possibile definire più coppie di parametri ComponentLink. Per utilizzare questa funzione, aggiungere e configurare i due parametri per ciascuna coppia ComponentLink come segue:

Primo parametro - utilizzato per definire il documento di destinazione:

• Nome parametro = ComponentLinknURL (dove n è un qualsiasi valore intero)
• Valore parametro = target document path\name

Secondo parametro - utilizzato per definire la voce che appare nel menu:

• Nome = ComponentLinknDescription (dove n è lo stesso valore intero usato nel primo parametro)
• Valore = Entry to appear in the menu

È possibile definire un numero qualsiasi di coppie di parametri ComponentLink; ogni coppia è associata condividendo lo stesso valore per n.

Per accedere ai collegamenti del componente, fare clic con il pulsante destro del mouse sulla parte posizionata nell'area di lavoro. La voce del collegamento apparirà nel sottomenu References.

Sostituzione del valore di una stringa con il valore di un parametro

I parametri del componente possono essere visualizzati facilmente tramite la relativa Visible casella di controllo. Questo non vale per i parametri di Documento o di Progetto, che non possono essere visualizzati direttamente sul foglio dello schema. Per visualizzare questi parametri, si utilizza una tecnica nota come String Indirection. L’indirezione delle stringhe è un sistema in cui una normale stringa di testo viene posizionata sul foglio dello schema e, invece di inserire un valore testuale, si immette il nome di un parametro di Documento o di Progetto preceduto da un segno di uguale, ad esempio =Title. Il software rileva automaticamente tali stringhe e, invece di visualizzare il contenuto della stringa di testo, come =Title, controlla i parametri di Documento e di Progetto e, se viene trovato un parametro chiamato Title, viene visualizzato il valore del parametro Title.

Le stringhe indirette sono note come Special Strings. Esiste un gran numero di stringhe speciali predefinite, elencate di seguito. Anche qualsiasi parametro di documento o di progetto definito dall’utente può essere considerato una stringa speciale ed essere indirizzato indirettamente a una stringa di testo sul foglio dello schema.

Stringhe speciali predefinite dello schema

Di seguito sono riportate le stringhe speciali predefinite disponibili per l’uso in un documento schematico. La maggior parte di esse è collegata alle informazioni dei parametri predefiniti definite per il documento attivo nella scheda Parameters della finestra di dialogo Document Options (Project | Content | Document Options).

• =Address1 – visualizza il valore specificato per il parametro predefinito a livello di documento Address1.
• =Address2 – visualizza il valore specificato per il parametro predefinito a livello di documento Address2.
• =Address3 – visualizza il valore specificato per il parametro predefinito a livello di documento Address3.
• =Address4 – visualizza il valore specificato per il parametro predefinito a livello di documento Address4.
• =Application_BuildNumber – visualizza la versione e la build dell’installazione corrente di CircuitStudio.
• =ApprovedBy – visualizza il valore specificato per il parametro predefinito a livello di documento ApprovedBy.
• =Author – visualizza il valore specificato per il parametro predefinito a livello di documento Author.
• =CheckedBy – visualizza il valore specificato per il parametro predefinito a livello di documento CheckedBy.
• =CompanyName – visualizza il valore specificato per il parametro predefinito a livello di documento CompanyName.
• =CurrentDate – la data corrente, calcolata automaticamente in base alle impostazioni di sistema dell’utente e nel formato dd/mm/yyyy, aggiornata durante la modifica dello schema o al refresh/ridisegno. Esempio: 10/12/2012.
• =CurrentTime – l’ora corrente, calcolata automaticamente in base alle impostazioni di sistema dell’utente e nel formato h:mm:ss AM/PM, aggiornata durante la modifica dello schema o al refresh/ridisegno. Esempio: 2:39:47 PM.
• =Date – utilizzata per visualizzare informazioni di data statiche. Visualizza il valore specificato per il parametro predefinito a livello di documento Date. A differenza della stringa speciale =CurrentDate, che viene calcolata automaticamente e presentata in un formato prestabilito, è possibile inserire informazioni di data statiche in qualsiasi formato desiderato.
• =DocumentFullPathAndName – utilizzata per visualizzare il percorso completo e il nome del documento in cui è inserita la stringa. Esempio: C:\MyTestDesign\PSU.SchDoc.
• =DocumentName – utilizzata per visualizzare solo il nome file dello schema (senza il percorso del file). Esempio: PSU.SchDoc.
• =DocumentNumber – visualizza il valore specificato per il parametro predefinito a livello di documento DocumentNumber. Il parametro sorgente può anche essere aggiornato tramite la finestra di dialogo Sheet Numbering For Project quando si utilizza il comando Tools | Annotation | Number Sheets.
• =DrawnBy – visualizza il valore specificato per il parametro predefinito a livello di documento DrawnBy.
• =Engineer – visualizza il valore specificato per il parametro predefinito a livello di documento Engineer.
• =ImagePath – visualizza il valore specificato per il parametro predefinito a livello di documento ImagePath.
• =ModifiedDate – il timestamp della data di modifica dello schema, compilato automaticamente. Esempio: 10/12/2012.
• =Organization – visualizza il valore specificato per il parametro predefinito a livello di documento Organization.
• =ProjectName – visualizza il nome effettivo del progetto (inclusa l’estensione). Ad esempio, per un progetto con nome file MyPCB.PrjPcb, questa stringa speciale visualizzerà MyPCB.PrjPcb.
• =Revision – visualizza il valore specificato per il parametro predefinito a livello di documento Revision.
• =Rule – visualizza il valore specificato per il parametro predefinito a livello di documento Rule. Il valore di questo parametro sarà inizialmente Undefined Rule (visualizzato come * sullo schema). Fare doppio clic sul valore del parametro per accedere alla possibilità di definire un tipo di regola e modificarne i vincoli.
• =SheetNumber – il numero del foglio dello schema corrente. Questo valore viene calcolato quando si utilizza il comando Tools | Annotate | Number Sheets. Il numero di foglio assegnato nella finestra di dialogo Sheet Numbering For Project verrà inserito nel valore del parametro predefinito a livello di documento SheetNumber. La stringa speciale, quando utilizzata nella vista scheda Editor del foglio dello schema, ricaverà da qui le proprie informazioni.
• =SheetTotal – il totale dei fogli del progetto. Questo valore viene calcolato quando si utilizza il comando Tools | Annotate | Number Sheets. Il totale dei fogli nella finestra di dialogo Sheet Numbering For Project verrà inserito nel valore del parametro predefinito a livello di documento SheetTotal. La stringa speciale, quando utilizzata nella vista scheda Editor del foglio dello schema, ricaverà da qui le proprie informazioni.
• =Time – utilizzata per visualizzare informazioni di ora statiche. Visualizza il valore specificato per il parametro predefinito a livello di documento Time. A differenza della stringa speciale =CurrentTime, che viene calcolata automaticamente e presentata in un formato prestabilito, è possibile inserire informazioni di ora statiche in qualsiasi formato desiderato.
• =Title – visualizza il valore specificato per il parametro predefinito a livello di documento Title.
• =VariantName - visualizza la variante da cui è stato generato l’output. Questa segue la voce della variante corrente (Project | Project Actions | Current Variant). Se per generare l’output viene utilizzato il progetto base, il valore sarà [No Variations].

Stringhe speciali da utilizzare con i parametri del componente

Sono disponibili diverse stringhe speciali aggiuntive (o interpretazioni speciali di quelle esistenti) durante la definizione dei parametri del componente. In ogni caso, la stringa speciale viene inserita come value per un parametro.

• =CurrentFootprint – visualizza il nome del footprint attualmente assegnato al componente, come definito nell’area Models della finestra di dialogo associata Component Properties.
• =Comment – visualizza il valore che appare nel campo Comment del componente, come definito nell’area Properties della finestra di dialogo associata Component Properties.
• =Description – visualizza il valore che appare nel campo Description del componente, come definito nell’area Properties della finestra di dialogo associata Component Properties.
• =[ParameterName] – visualizza il valore definito per un parametro del componente specificato. Immettere il nome effettivo di un parametro del componente come nome della stringa speciale; ad esempio, per un parametro del componente denominato PowerRating, immettere =PowerRating. Quando si definisce la proprietà Comment per un componente, il relativo campo a discesa verrà popolato con stringhe speciali per tutti i parametri del componente esistenti, consentendo l’uso rapido del valore di qualsiasi parametro definito per Comment.