CvPcb

La tabella librerie globale contiene l’elenco delle librerie che sono sempre disponibili indipendentemente dal file di progetto attualmente caricato. La tabella viene salvata nel file fp-lib-table nella cartella utente. La posizione di questa cartella dipende dal sistema operativo in uso.

La tabella librerie impronte specifica del progetto contiene l’elenco delle librerie disponibili specificamente per il file progetto attualmente caricato. Può essere modificata solamente quando viene caricata assieme al file della netlist del progetto. Se sessun file progetto viene caricato o non c'è il file tabella librerie impronte nel percorso del progetto, viene creata una tabella vuota che può essere modificata e successivamente salvata assieme al file di assegnamento impronte.

La prima volta che Pcbnew o CvPcb vengono eseguiti e il file tabella impronte globale fp-lib-table non viene trovato nella cartella utente, Pcbnew o CvPcb cercheranno di copiare il file tabella impronte predefinito fp-lib-table memorizzato nella cartella modelli di sistema di KiCad nel file fp-lib-table nella cartella utente.

Se fp-lib-table non viene trovato, verrà creato un file tabella librerie impronte vuoto nella cartella utente. Se ciò accade, l’utente può copiare fp-lib-table manualmente o configurare la tabella a mano.

La tabella librerie impronte predefinita include molte delle librerie impronte standard che sono installate assieme a KiCad.

Ovviamente, la prima cosa da fare è modificare questa tabella (aggiungere/rimuovere voci) a seconda del proprio lavoro e delle librerie necessarie per i propri progetti.

(se si caricano troppe librerie si può notare dei rallentamenti)

Per usare una libreria impronte, questa deve prima essere aggiunta alla tabella globale o a quella del progetto. La tabella del progetto è applicabile solo quando si ha un file di netlist aperto.

Ogni voce di libreria deve avere un identificativo unico.

Ciò non deve essere messo in relazione in alcun modo con il nome o il percorso file libreria correntemente caricato. Il carattere duepunti : non può essere usato da nessuna parte nella denominazione. Ogni voce di libreria deve avere un nome e/o percorso validi a seconda del tipo di libreria. I percorsi possono essere definiti come assoluti, relativi, o per sostituzione di variabile ambiente (vedere più avanti).

Si deve selezionare il tipo di plugin appropriato per consentire la corretta lettura della libreria. KiCad attualmente supporta la lettura di librerie di impronte KiCad obsolete, KiCad Pretty, Eagle, e GEDA.

C'è anche un campo che serve ad aggiungere una descrizione della voce di libreria. Il campo opzioni non è usato in questo momento per cui aggiungere opzioni non avrà alcun effetto durante il caricamento delle librerie.

Una delle caratteristiche più potenti della tabella librerie di impronte è la sostituzione di variabili ambiente. Ciò permette di definire percorsi personalizzati che puntano a dove le proprie librerie sono state memorizzate inserendoli in variabili ambiente. La sostituzione delle variabili ambiente è supportata usando la sintassi ${NOME_VAR_AMB} nel percorso libreria di impronte.

Come impostazione predefinita, durante l’esecuzione KiCad definisce due variabili ambiente:

Può avere la precedenza rispetto a KISYSMOD se la si definisce in preferenze/Configura percorsi e permette di sostituire le librerie di impronte predefinite di KiCad con le proprie.

Quando un file netlist del progetto viene caricato, CvPcb definisce la variabile KIPRJMOD usando il percorso file (del progetto).

Pcbnew anch’esso definisce questa variabile ambiente al caricamento di un file scheda.

Tutto ciò permette di memorizzare librerie nel percorso del progetto senza dover definire il percorso assoluto (che non sempre è conosciuto a priori) alla libreria nella tabella librerie impronte specifica del progetto.

Quello per GitHub è un plugin speciale che fornisce un’interfaccia per l’accesso in sola lettura ad un repository GitHub remoto contenente impronte pretty (pretty è il nome del formato file impronte di KiCad) e opzionalmente fornisce supporto “Copy On Write” (COW) per la modifica di impronte lette dal repo GitHub salvandole localmente. Perciò il plugin “Git Hub” è per l'accesso remoto in sola lettura a librerie di impronte su https://github.com. Per aggiungere una voce GitHub alla tabella librerie di impronte il “Percorso libreria” nella riga della tabella delle librerie di impronte deve essere impostato ad un URL GitHub valido.

Per esempio:

https://github.com/liftoff-sr/pretty_footprints

o

https://github.com/KiCad

Tipicamente gli URL di GitHub hanno la forma seguente:

https://github.com/nome_utente/nome_repo

Il “Tipo plugin” deve essere impostato su “Github”. Per abilitare la funzione “Copy On Write” è necessario aggiungere l’opzione allow_pretty_writing_to_this_dir all’impostazione “Opzioni” della voce della tabella librerie di impronte. Questa opzione è il “Percorso libreria” per la memorizzazione locale delle copie modificare di impronte lette dal repo GitHub. Le impronte salvate su questo percorso sono combinate con la parte in sola lettura del repository GitHub per creare la libreria di impronte. Se manca questa opzione, allora la libreria GitHub diventa a sola lettura. Se quest’opzione è invece presente per una libreria GitHub, allora qualsiasi scrittura su questa libreria ibrida andrà a finire nella cartella locale *.pretty. Si noti che la porzione residente di github.com di questa libreria ibrida COW è sempre in sola lettura, e questo vuol dire che è impossibile cancellare o modificare direttamente nulla di nessuna impronta nello repository GitHub specificato. Il tipo di libreria aggregato rimane “Github” in tutti i discorsi successivi, ma esso in realtà consiste nella porzione locale in lettura/scrittura unita alla porzione remota in sola lettura.

La tabella seguente mostra una voce di tabella di librerie impronte senza l’opzione allow_pretty_writing_to_this_dir:

La tabella seguente mostra una voce di tabella librerie impronte con l’opzione COW impostata. Si noti l’uso della variabile ambiente ${HOME} data solo come esempio. La cartella github.pretty è posizionata nel percorso ${HOME}/pretty/. Ogniqualvolta si usa l’opzione allow_pretty_writing_to_this_dir, sarà necessario creare manualmente in precedenza quella cartella ed il suo nome dovrà terminare con l’estensione .pretty.

Il caricamento di impronte darà sempre la precedenza alle impronte locali trovate nel percorso dato dall’opzione allow_pretty_writing_to_this_dir. Una volta salvata un’impronta nella cartella locale della libreria COW eseguendo un comando di salvataggio nell’editor delle impronte, non verrà visto nessun aggiornamento GitHub al caricamento di un’impronta con lo stesso nome di quella salvata localmente.

Mantenere sempre una cartella locale *.pretty per ogni libreria GitHub, mai combinarle riferendosi alla stessa cartella più di una volta.

Inoltre, non usare la stessa cartella COW (*.pretty) in una voce di tabella di libreria impronte. Così facendo si può facilmente creare confusione.

Il valore dell’opzione allow_pretty_writing_to_this_dir espanderà qualsiasi variabile ambiente che usi la notazione ${} per creare percorsi allo stesso modo delle impostazioni di “Percorso libreria”.

Qual'è il punto del COW (Copy On Write)? Vuol dire aumentare col turbo la condivisione di impronte.

Se si spedisce via email periodicamente le proprie impronte modificate con COW in formato pretty al gestore del repository GitHub, si può aiutare ad aggiornare la copia di riferimento su GitHub. Basta spedire nell’email i singoli file *.kicad_mod che si trovano nelle proprie cartelle COW al gestore del repository GitHub. Dopo aver ricevuto conferma del fatto che i propri cambiamenti siano stati applicati, si può tranquillamente cancellare i propri file COW e verrà scaricata dalla libreria GitHub la propria impronta aggiornata. Il proprio obiettivo dovrebbe essere quello di mantenere i propri file COW più piccoli possibile contribuendo frequentemente alle copie condivise principali su https://github.com.

Le librerie di impronte possono essere definite sia globalmente che specificatamente per il progetto attualmente caricato. Le librerie di impronte definite nella tabella utente globale sono sempre disponibili e sono memorizzate nel file fp-lib-table nella cartella home dell’utente.

Alle librerie di impronte globali si può accedere sempre anche quando non c'è nessuna netlist di progetto aperta.

La tabella delle impronte specifiche del progetto è attiva solo per il file netlist attualmente aperto.

La tabella librerie di impronte specifiche del progetto viene salvata nel file fp-lib-table presente nel percorso della netlist attualmente aperta. Si può scegliere di definire una libreria indifferentemente in una qualsiasi delle due tabelle.

Ci sono vantaggi e svantaggi per ogni metodo. Si può scegliere di definire tutte le proprie librerie nella tabella globale e ciò significherà che queste saranno sempre disponibili alla bisogna. Lo svantaggio di questo approccio è che si deve cercare tra molte librerie per trovare l’impronta desiderata. Oppure si può definire tutte le librerie sulla base di un progetto specifico.

Il vantaggio di quest’ultimo approccio è che necessario solamente definire le libreria di cui si abbisogna per il progetto e ciò riduce nettamente la ricerca.

Lo svantaggio di ciò consiste nel dover sempre ricordare di aggiungere ogni libreria di impronte che serve per ogni progetto. Si può anche definire librerie di impronte sia globalmente che per un progetto specifico.

Un modello di utilizzo potrebbe essere quello di definire globalmente le librerie che utilizziamo più comunemente mentre le librerie richieste solo per il progetto inserirle nella tabella librerie specifica del progetto. In questo senso non ci sono restrizioni particolari nel modo in cui si possono definire le proprie librerie.

La barra di stato è dislocata in fondo alla finestra principale di CvPcb e fornisce utili informazioni all’utente. La seguente tabella definisce il contenuto di ogni pannello sulla barra di stato.

Mostrato dal clic destro del mouse: