Manuale di riferimento

This document is Copyright © 2010-2024 by its contributors as listed below. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.

Tutti i marchi registrati all’interno di questa guida appartengono ai loro legittimi proprietari.

Collaboratori

Jean-Pierre Charras, Fabrizio Tappero, Jon Evans.

Traduzione

Marco Ciampa <[email protected]>, 2014-2018.

Commenti

The KiCad project welcomes feedback, bug reports, and suggestions related to the software or its documentation. For more information on how to submit feedback or report an issue, please see the instructions at https://www.kicad.org/help/report-an-issue/

Introduzione

KiCad è una suite software open source per la creazione di schemi elettrici e circuiti stampati (PCB). KiCad supporta un flusso di lavoro di progettazione integrato in cui uno schema e un C.S. corrispondente sono progettati insieme, nonché flussi di lavoro autonomi per usi speciali. KiCad include anche diverse utilità per aiutare con la progettazione di circuiti e C.S., tra cui una calcolatrice per determinare le proprietà elettriche delle strutture dei circuiti, un visualizzatore di file Gerber per l’ispezione dei file di produzione e un simulatore SPICE integrato per la verifica del comportamento del circuito elettrico.

KiCad funziona su tutti i principali sistemi operativi e su un’ampia gamma di computer. Supporta C.S. con un massimo di 32 strati di rame ed è adatto per creare progetti di ogni complessità. KiCad è sviluppato da un team di volontari di software ed ingegneri in tutto il mondo con la missione di creare software di progettazione elettronica gratuito e open source adatto a progettisti professionisti.

L’ultima versione di questa documentazione è disponibile all’indirizzo https://docs.kicad.org.

Requisiti di sistema

KiCad è in grado di funzionare su un’ampia varietà di macchine e di sistemi operativi, ma alcune attività potrebbero essere più lente o più difficili su dispositivi di fascia bassa. Per un’esperienza ottimale, si consiglia una scheda grafica e uno schermo dedicati con risoluzione 1920x1080 o superiore.

Controllare sul sito Web di KiCad per i requisiti di sistema più recenti: https://kicad.org/help/system-requirements/

Cartelle e file di KiCad

KiCad crea e usa file con le seguenti estensioni (e cartelle) per la modifica di schemi e schede.

File di progetto

*.kicad_pro

Project file, containing settings that are shared between the schematic and PCB

*.pro

Legacy (KiCad 5.x and earlier) project file. Can be read and will be converted to a .kicad_pro file by the project manager.

File dell’editor degli schemi elettrici

*.kicad_sch

Schematic files, containing all symbol and connection information.

*.kicad_sym

Schematic symbol library file, containing the symbol descriptions: graphic shape, pins, fields.

*.kicad_blocks

Schematic design block library folders. The folder itself is the library.

*.kicad_block

Schematic design block folder for defining a reusable schematic design. The folder is the design block, and contains a .kicad_sch file defining the design block’s schematic and a .json file defining the design block’s metadata.

*.wbk

Simulator workbook file containing SPICE simulation setup information.

*.sch

Legacy (KiCad 5.x and earlier) schematic file. Can be read and will be converted to a .kicad_sch file on write.

*.lib

Legacy (KiCad 5.x and earlier) schematic library file. Can be read but not written.

*.dcm

Legacy (KiCad 5.x and earlier) schematic library documentation. Can be read but not written.

*-cache.lib

Legacy (KiCad 5.x and earlier) schematic component library cache file. Required for proper loading of a legacy schematic (.sch) file.

sym-lib-table

Symbol library table: list of symbol libraries available in the schematic editor.

design-block-lib-table

Design block library table: list of design block libraries available in the schematic editor.

File e cartelle dell’editor schede

*.kicad_pcb

Board file containing all info but the page layout.

*.pretty

Footprint library folders. The folder itself is the library.

*.kicad_mod

Footprint files, containing one footprint description each.

*.kicad_dru

Design rules file, containing custom design rules for a certain .kicad_pcb file.

*.brd

Legacy (KiCad 4.x and earlier) board file. Can be read, but not written, by the current board editor.

*.mod

Legacy (KiCad 4.x and earlier) footprint library file. Can be read by the footprint or the board editor, but not written.

fp-lib-table

Footprint library table: list of footprint libraries available in the board editor.

fp-info-cache

Cache to speed up loading of footprint libraries. Does not need to be distributed with the project or put under version control.

File comuni

*.kicad_prl

Local settings for the current project; helps KiCad remember the last used settings such as layer visibility or selection filter. May not need to be distributed with the project or put under version control.

*.kicad_wks

Page layout (drawing border and title block) description file.

*.kicad_jobset

Jobset definition file containing output jobsets.

*.net

Netlist file created from the schematic, and read by the board editor. Note that the recommended workflow for transferring information from the schematic to the board does not require the use of netlist files.

*.cmp

Association between components used in the schematic and their footprints. It can be created by the Board Editor and imported by the Schematic Editor. Its purpose is to import changes from the board to the schematic, for users who change footprints in the Board Editor (for instance using Exchange Footprints command) and want to import these changes back to the schematic. Note that the recommended workflow for transferring information from the board to the schematic does not require the use of .cmp files.

File di fabbricazione e documentazione

*.gbr

File Gerber, per la fabbricazione

*.drl

File di foratura (formato Excellon), per la fabbricazione

*.pos

File di posizionamento (formato ASCII), per le macchine per l’inserzione automatica

*.rpt

File di rapporto (formato ASCII), per documentazione

*.ps

File di tracciatura (formato Postscript), per documentazione

*.pdf

File di tracciatura (formato PDF), per documentazione

*.svg

File di tracciatura (formato SVG), per documentazione

*.dxf

File di tracciatura (formato DXF), per documentazione

*.plt

File di tracciatura (formato HPGL), per documentazione

Memorizzazione e invio file KiCad

I file di schemi elettrici e C.S. di KiCad contengono tutti i simboli schema e le impronte utilizzati nel progetto, quindi si può eseguire il salvataggio o inviare questi file senza problemi. Alcune importanti informazioni sul progetto sono memorizzate nel file di progetto (.kicad_pro), quindi se si sta inviando un progetto completo, bisogna assicurarsi di includerlo.

Alcuni file, come quello delle impostazioni locali del progetto (.kicad_prl) e fp-info-cache, non serve includerli nel progetto da inviare. Se si usa un sistema di controllo versione come Git per tenere sotto controllo progetti KiCad, potrebbe essere utile aggiungere anche questi file all’elenco dei file ignorati in modo che non vengano considerati.

Installazione e aggiornamento KiCad

Importazione impostazioni

Ogni versione principale di KiCad ha la propria configurazione, in modo che si possa eseguire più versioni di KiCad sullo stesso computer senza che le configurazioni interferiscano fra loro. La prima volta che si esegue una nuova versione di KiCad, verrà chiesto come inizializzare le impostazioni:

configure settings

Se viene rilevata una versione precedente di KiCad, si avrà la possibilità di importare le impostazioni da quella versione. La posizione dei file di configurazione precedenti viene rilevata automaticamente, ma è possibile ignorarla per scegliere un’altra posizione, se lo si desidera.

Si noti che non verranno importate le tabelle delle librerie di simboli e di impronte dalle precedenti versioni di KiCad.

Si può anche scegliere di iniziare con le impostazioni predefinite se non si desidera importare le impostazioni da una versione precedente.

KiCad stores the settings files in a folder inside your user directory. Each KiCad version will use a different versioned subfolder. For KiCad 8, those folders are:

Windows

%APPDATA%\kicad\8.0

Linux

~/.config/kicad/8.0

macOS

/Users/<username>/Library/Preferences/kicad/8.0

Migrazione di file da versioni precedenti

Le versioni moderne di KiCad possono aprire file creati da versioni precedenti, ma possono solo scrivere file nei formati più recenti. Ciò significa che in generale non ci sono passaggi speciali per migrare i file da una versione precedente oltre all’apertura dei file. In alcuni casi, l’estensione di un file viene modificata da una versione di KiCad a quella successiva. Dopo aver aperto questi file, verranno salvati nel nuovo formato con la nuova estensione del file. I vecchi file non verranno eliminati automaticamente.

The schematic editor documentation describes several particular considerations for opening legacy schematics.

In generale, i file creati o modificati da una versione di KiCad non possono essere aperti da versioni precedenti di KiCad. Per questo motivo, è importante conservare copie di salvataggio dei propri progetti durante le prove di una nuova versione di KiCad, finché non si è sicuri di non dover più utilizzare la versione precedente di KiCad.

Attualmente le configurazioni dei tasti di scelta rapida non vengono importate dalle versioni precedenti. Si può manualmente importare le configurazioni dei tasti di scelta rapida copiando i vari file *.hotkeys dalla cartella di configurazione della vecchia versione in quella nuova. Nel caso, tenere presente che KiCad non rileva automaticamente i conflitti come l’assegnazione di un tasto a più azioni.

Using the KiCad project manager

The KiCad project manager is a tool which creates and opens KiCad projects and launches the other KiCad tools (schematic and board editors, Gerber viewer, and utility tools).

][scaledwidth="90%"

La finestra del gestore progetti di KiCad è composta da una vista ad albero sulla sinistra che mostra i file associati al progetto aperto, e un pannello di avvio sulla destra contenente i pulsanti da usare per eseguire vari editor e strumenti software.

La barra degli strumenti sul lato sinistro della finestra fornisce scorciatoie per le operazioni di progetto comuni:

new project 24

Create a new project.

open project 24

Open an existing project.

zip 24

Create a zip archive of the whole project. This includes schematic files, libraries, PCB, etc.

unzip 24

Extract a project zip archive into a directory. Files in the destination directory will be overwritten.

refresh 24

Refresh the tree view, to detect changes made on the filesystem.

directory browser 24

Open the project working directory in a file explorer.

La vista ad albero mostra un elenco di file all’interno della cartella del progetto. Facendo doppio clic su un file nella vista ad albero lo si aprirà nell’editor associato. Facendo clic con il pulsante destro del mouse su un file, si aprirà un menu contestuale con alcuni comandi di elaborazione del file.

][scaledwidth="35%"
Solo i file che KiCad sa come aprire vengono visualizzati nella vista ad albero del progetto.

KiCad projects contain at least a project file, a schematic, and a board design. Schematics may contain multiple sheets, each in its own file, but a project can only contain a single board. KiCad expects the project file, schematic root sheet file, and board file to all have the same name.

Standalone mode

You can also run the KiCad editor tools in standalone mode, by launching them directly from your operating system’s application launcher rather than from the project manager. It is usually not recommended to run the tools in standalone mode, except for some specific situations where it is necessary, such as when importing projects from other EDA tools. When running in standalone mode, some project features are not available, including:

  • cross probing between the schematic editor and the board editor

  • design synchronization between the schematic and the board

Creazione di un nuovo progetto

La maggior parte dei progetti KiCad si iniziano con la creazione di un progetto. Esistono due modi per creare un progetto dalla gestione progetti di KiCad: si può creare un progetto vuoto o creare un progetto basato su un modello esistente. Questa sezione tratterà la creazione di un nuovo progetto vuoto. La creazione di progetti da modelli è trattata nella sezione Modelli di progetto.

Per creare un nuovo progetto, usare il comando Nuovo progetto…​ nel menu File, fare clic sul pulsante Nuovo progetto nella barra degli strumenti in alto o usare la scorciatoia da tastiera (Ctrl+N per impostazione predefinita).

Ti verrà chiesto un nome da assegnare al progetto. Per impostazione predefinita, verrà creata una directory per il tuo progetto con lo stesso nome. Ad esempio, se si inserisce il nome MioProgetto, KiCad creerà la cartella MioProgetto e il file di progetto MioProgetto/MioProgetto.kicad_pro al suo interno.

Se si dispone già di una cartella in cui archiviare i file del progetto, si può deselezionare la casella di controllo Crea una nuova cartella per il progetto nella finestra di dialogo Nuovo progetto.

È fortemente raccomandato memorizzare ogni progetto KiCad dentro la corrispondente cartella.

Una volta selezionato il nome del progetto, KiCad creerà i seguenti file all’interno della cartella del progetto:

esempio.kicad_pro

File progetto KiCad.

esempio.kicad_sch

File schema elettrico principale.

esempio.kicad_pcb

File del circuito stampato.

Importazione di un progetto da un altro strumento EDA

KiCad is able to import files created by some other software packages. Some software formats can be imported as complete projects. Others can only be imported as standalone schematics or boards at the moment, and must be manually linked together into a KiCad project. Currently the following types of project are supported:

*.sch, *.brd

Eagle 6.x or newer (XML format)

*.csa, *.cpa

CADSTAR archive format

\*.zip

EasyEDA (JLCEDA) Standard Backup

*.epro, *.zip

EasyEDA (JLCEDA) Pro Project

Per importare un progetto da uno di questi strumenti, scegliere l’opzione appropriata dal sottomenu Importa progetto non KiCad del menu File.

Verrà richiesto di selezionare un file di schema elettrico o di un circuito stampato nella finestra di dialogo della selezione dei file di importazione. I file dello schema e dello stampato devono avere lo stesso nome del file di base (ad es. progetto.sch e progetto.brd). Una volta selezionati i file richiesti, verrà chiesto di selezionare una cartella in cui memorizzare il progetto KiCad risultante.

Currently the following types of documents can be imported standalone. To import these documents, start the KiCad Schematic Editor or PCB Editor standalone (do not open the KiCad project manager first) and choose File > Import > Non-KiCad Schematic or File > Import > Non-KiCad Board File. When importing Altium projects, we recommend importing the PCB first, saving the resulting project, and then copying each schematic sheet into the project after importing it in a standalone Schematic Editor window.

*.SchDoc

Altium Designer, Circuit Studio, Circuit Maker schematic documents

*.PcbDoc

Altium Designer PCB

*.CMPcbDoc

Altium Circuit Maker PCB

*.CSPcbDoc

Altium Circuit Studio PCB

*.pcb

P-Cad 200x ASCII PCB

*.txt, *.fab

Fabmaster PCB

KiCad does not support schematics with multiple top-level sheets. When importing designs from other tools that do support this feature, each schematic sheet must be imported, and then the imported sheets must be placed as hierarchical sheets in a new KiCad project.

Saving and loading project archives

You can archive your project’s files into a zip archive with the Archive tool (FileArchive Project…​).

You can also unarchive a project using the Unarchive tool (FileUnarchive Project…​). When you unarchive a project into the currently loaded project directory, the project will be reloaded automatically to reflect any changes that were in the archived version of the project.

The archive tool saves the following files from your project folder into the archive:

*.kicad_prl, *.kicad_pro, *.kicad_sch, *.kicad_sym, *.kicad_pcb, *.kicad_mod, *.kicad_dru, *.kicad_wks, *.kicad_jobset, *.wbk, *.json, fp-lib-table, sym-lib-table, design-block-lib-table

KiCad design files

*.pro, *.sch, *.lib, *.dcm, *.cmp, *.brd, *.mod

Legacy KiCad design files

*.stp, *.step

3D models

*.g?, *.g??, *.gm??, *.gbrjob

Gerber files

*.pos, *.drl, *.nc, *.xnc, *.d356, *.rpt

Manufacturing files

*.net

Netlists

*.py

Python scripts

*.pdf, *.txt

Documentation files

*.cir, *.sub, *.model

SPICE models

*.ibs, *.pkg

IBIS models

Configurazione KiCad

The KiCad preferences can always be accessed from the Preferences menu, or by using the hotkey (default Ctrl+,). The Preferences dialog is shared between the running KiCad tools. Some preferences apply to all tools, and some are specific to a certain tool (such as the schematic or board editor).

Preferenze comuni

preferences common

Antialising grafico accelerato: KiCad può utilizzare diversi metodi per prevenire l’aliasing (linee frastagliate) durante il rendering utilizzando una scheda grafica. Diversi metodi possono avere un aspetto migliore su hardware diverso, quindi è meglio sperimentare per trovare quello che sembra migliore.

Antialiasing grafica di ripiego: KiCad può fare l’antialiasing anche in modalità grafica di ripiego. L’abilitazione di questa funzione però può comportare prestazioni scadenti su alcuni dispositivi.

Editor di testo: scegli un editor di testo da usare per aprire i file di testo dalla finestra dell’albero del progetto.

Visualizzatore PDF: scegli un programma da usare per aprire i file PDF.

Mostra le icone nei menu: abilita le icone nei menu a discesa in tutta l’interfaccia utente di KiCad.

Le icone nei menu non vengono comunque visualizzate in alcuni sistemi operativi.

Show scrollbars in editors: When enabled, scrollbars are displayed next to the editing canvases in each tool. When disabled, scrollbars are not shown.

Il focus segue il mouse tra gli editor dello schema e del C.S.: Quando abilitata, la finestra sotto il puntatore del mouse prenderà il focus automaticamente.

Scala icona: imposta la dimensione delle icone usate nei menu e nei pulsanti in tutto KiCad. Scegliere Automatico per fare in modo che scelga automaticamente una scala icone appropriata in base alle impostazioni del proprio sistema operativo.

Tema icone: imposta se usare il tema icone progettato per gli sfondi finestre chiari o per quelli scuri. L’impostazione predefinita automatica sceglierà il tema in base alla luminosità del tema delle finestre del sistema operativo.

Fattore di attenuazione modalità alto contrasto: imposta la quantità di oscuramento degli elementi non a fuoco nella modalità di visualizzazione ad alto contrasto.

Sposta il mouse all’origine dell’oggetto spostato: se abilitata, il cursore del mouse verrà riposizionato all’origine di un oggetto quando si avvia un comando di spostamento su quell’oggetto.

Il tasto seleziona la strumento: se disabilitata, eseguendo un comando da tastiera come Aggiungi filo inizierà immediatamente il comando alla posizione corrente del puntatore. Se abilitata, premendo il comando la prima volta selezionerà solamente lo strumento Aggiungi filo ma non comincerà immediatamente un filo.

Ricorda i file aperti per il prossimo lancio del progetto: se abilitata, KiCad riaprirà automaticamente tutti i file che erano stati aperti in precedenza alla riapertura di un progetto.

Salvataggio automatico: durante la modifica di file schemi e schede, KiCad può salvare il lavoro periodicamente in automatico. Impostare su 0 per disabilitare questa funzione.

Dimensione cronologia file: configura il numero massimo di voci nell’elenco dei file aperti recentemente.

Durata file cache 3D: KiCad crea una cache di modelli 3D per velocizzare il visualizzatore 3D. Si può configurare per quanto tempo conservare questa cache prima di eliminare i vecchi file.

Backup automatico dei progetti: se abilitata, i progetti KiCad verranno archiviati automaticamente in file ZIP in base alle impostazioni di seguito. Gli archivi verranno memorizzati in una sottocartella della cartella del progetto. I backup vengono creati quando si effettua il salvataggio dei file nel progetto.

Crea backup all’autosalvataggio: se abilitata, verrà creato un backup ogni volta che si verifica un salvataggio automatico file (se il backup è consentito dalle impostazioni di seguito). Questa impostazione non ha effetto se l’intervallo di salvataggio automatico è impostato su 0 (disabilitato).

Numero max backup da tenere: quando si crea un nuovo backup, il file di backup più vecchio verrà eliminato per mantenere il numero totale di file di backup al di sotto di questo limite.

Numero max backup per giorno: quando si crea un nuovo backup, il file di backup più vecchio creato nel giorno corrente verrà eliminato per rimanere al di sotto di questo limite.

Tempo minimo tra i backup: Se il backup viene attivato (ad esempio, salvando un file scheda), il backup non verrà creato se un file di backup esistente è più recente di questo limite.

Dimensione massima totale backup: quando si crea un nuovo backup, i file di backup meno recenti verranno eliminati per mantenere la dimensione totale della cartella dei file di backup al di sotto di questo limite.

Preferenze di mouse e touchpad

preferences mouse and touchpad

Centra e sposta il puntatore con lo zoom: se abilitata, facendo zoom usando i comandi da tastiera o la rotellina del mouse, la vista verrà centrata sulla posizione del puntatore.

Usa accelerazione zoom: se abilitata, lo scorrimento più veloce della rotellina del mouse o del touchpad farà cambiare lo zoom più velocemente.

Velocità zoom: controlla quanto cambia lo zoom per una determinata quantità di scorrimento della rotellina del mouse o del touchpad. Utilizzare Automatico per impostare un valore predefinito a seconda del sistema operativo.

Pan automatico mentre si sposta un oggetto: se abilitata, la vista può essere spostata (pan) mentre si sta spostando un oggetto in prossimità del bordo dell’area di disegno.

Velocità autopan: controlla la velocità di spostamento dell’area di disegno durante lo spostamento di un oggetto.

Pulsanti del mouse: è possibile impostare il comportamento del trascinamento dei pulsanti centrale e destro del mouse per ingrandire la vista, eseguire una panoramica della vista o non avere alcun effetto. Si può anche impostare il comportamento del trascinamento del pulsante sinistro del mouse a seconda che nell’area di modifica siano già selezionati o meno oggetti.

Il pulsante sinistro del mouse viene usato sempre per selezionare e gestire oggetti.

Rotellina del mouse e scorrimento touchpad: si può impostare il comportamento della rotellina del mouse o del movimento verticale del touchpad durante la pressione di certi tasti modificatori.

Pan sinista/destra con movimento orizzontale: se abilitata, si può ottenere lo scorrimento orizzontale della vista usando il touchpad o la rotellina di scorrimento orizzontale (se presente nel mouse).

Preferenze comandi da tastiera

preferences hotkeys

Si può usare questa finestra di dialogo per personalizzare i comandi da tastiera usati per controllare KiCad. I comandi da tastiera nella sezione Comuni sono condivisi tra ogni programma KiCad. I comandi da tastiera per ogni programma KiCad specifico vengono visualizzati quando quel programma è in esecuzione. Si può assegnare lo stesso tasto ad un’azione diversa in diversi programmi KiCad (ad esempio, l’editor di schemi e l’editor di schede), ma non si può assegnare lo stesso tasto a più di un’azione nello stesso programma.

Ci sono molti comandi disponibili e quindi non tutti hanno un tasto assegnato per impostazione predefinita. È possibile assegnare un tasto a un qualsiasi comando facendo doppio clic sul comando nell’elenco. Se si sceglie un tasto già assegnato a un comando diverso, si può scegliere di continuare a usare quel tasto sul comando scelto, rimuovendo l’assegnazione del tasto dal comando in conflitto.

Le modifiche apportate alle assegnazioni dei tasti vengono visualizzate con un carattere * alla fine del nome del comando. Si può annullare le modifiche a un comando specifico facendo clic con il pulsante destro del mouse su quel comando e selezionando Annulla cambiamenti, oppure si può annullare tutte le modifiche con il pulsante sotto l’elenco dei comandi.

Importazione comandi da tastiera

Le preferenze dei comandi da tastiera sono memorizzate in file .hotkeys nella cartella delle impostazioni di KiCad (consultare la sezione Impostazioni per informazioni su dove si trova la cartella delle impostazioni sul proprio sistema operativo). Se si ha personalizzato i comandi da tastiera di KiCad come si preferisce su un computer, si può trasferire questa configurazione su un altro computer importando i file .hotkeys appropriati.

Configurazione percorsi

In KiCad, one can define paths using a path variable. A few path variables are internally defined by KiCad, and can be used to define paths for libraries, 3D shapes, etc.

Ciò è utile quando i percorsi assoluti non sono conosciuti o sono soggetti a cambiamenti (per es. quando si trasferisce un progetto su un altro computer), o anche quando un percorso base viene condiviso con altri simili. Si consideri per esempio i seguenti che possono essere installati in posizioni variabili:

  • Librerie di simboli di schema elettrico

  • Librerie di impronte

  • File modelli 3D usati nelle definizioni delle impronte

For instance, the path to the connect.pretty footprint library, when using the KICAD8_FOOTPRINT_DIR path variable, would be defined as ${KICAD8_FOOTPRINT_DIR}/connect.pretty.

The PreferencesConfigure Paths…​ menu allows you to define paths for some built-in KiCad path variables, and add your own path variables to define personal paths, if needed.

KiCad will automatically resolve versioned path variables from older versions of KiCad to the value of the corresponding variable from the current KiCad version, as long as the old variable is not explicitly defined itself. For example, ${KICAD7_FOOTPRINT_DIR} will automatically resolve to the value of ${KICAD8_FOOTPRINT_DIR} if there is no KICAD7_FOOTPRINT_DIR variable defined.

KiCad path variables

KICAD8_3DMODEL_DIR

Base path of KiCad’s standard 3D footprint model library files.

KICAD8_3RD_PARTY

Location for plugins, libraries, and color themes installed by the Plugin and Content Manager.

KICAD8_FOOTPRINT_DIR

Base path of KiCad’s standard footprint library files.

KICAD8_SYMBOL_DIR

Base path of KiCad’s standard symbol library files.

KICAD8_TEMPLATE_DIR

Location of KiCad’s standard project template library files.

KICAD_USER_TEMPLATE_DIR

Location of personal project templates.

SPICE_LIB_DIR

Location of personal simulation model libraries. This variable is not defined by default.

KIPRJMOD

Absolute path to the current project directory. This variable is set automatically and cannot be redefined.

configure path dlg

I percorsi impostati nella finestra di dialogo Configura percorsi sono interni a KiCad e non sono visibili come variabili ambiente al di fuori di KiCad. Sono memorizzati nei file di configurazione utente di KiCad.

Paths can also be set as system environment variables outside of KiCad, which will override any settings in the user’s configuration.

You cannot override a system environment variable that has been set outside of KiCad by using the Configure Paths dialog. Any variable that has been set externally will be shown as read-only in the dialog.

Note also that the path variable KIPRJMOD is always internally defined by KiCad, and expands to the current project absolute path. For instance, ${KIPRJMOD}/connect.pretty is always the connect.pretty folder (the footprint library) inside the current project folder. The KIPRJMOD variable cannot be changed in the Configure Paths dialog or overridden by an external environment variable.

Variabili ambiente avanzate

Some advanced environment variables can be set to customize where KiCad expects certain files to be located. By default, these locations are set based on your platform, but they can be overridden by system environment variables. These variables are not shown in the Configure Paths dialog and cannot be used in path substitutions.

La modifica di queste variabili non comporterà lo spostamento di alcun file da parte di KiCad dalla posizione predefinita alla nuova posizione, quindi se si modificano queste variabili sarà necessario copiare manualmente le impostazioni o i file desiderati.

KICAD_CONFIG_HOME

Base path of KiCad configuration files. Subdirectories will be created within this directory for each KiCad minor version.

KICAD_DOCUMENTS_HOME

Base path of KiCad user-modifiable documents, such as projects, templates, Python scripts, libraries, etc. Subdirectories will be created within this directory for each KiCad minor version. This directory is provided as a suggested user data location, but does not need to be used.

KICAD_STOCK_DATA_HOME

Base path of KiCad stock data, including default libraries. The data in this directory is managed by the KiCad installer or system package manager, and is not intended for user-writeable data.

Se si modifica la configurazione dei percorsi, uscire e riavviare KiCad, per evitare qualsiasi problema nella gestione dei percorsi.

Configurazione librerie

The PreferencesManage Symbol Libraries…​ menu lets you manage the list of symbol libraries (symbol library table).

Likewise, use the PreferencesManage Footprint Libraries…​ menu to manage the list of footprint libraries (footprint library table).

Per ogni tipo di libreria (simboli e impronte), ci sono 2 tabelle di librerie: globali e specifiche del progetto. La tabella delle librerie globali si trova nella cartella di configurazione dell’utente e contiene l’elenco delle librerie disponibili per tutti i progetti. La tabella delle librerie specifiche del progetto è facoltativa, contiene appunto l’elenco delle librerie specifiche del progetto, e si trova nella cartella del progetto.

Modelli di progetto

L’uso di un modello di progetto facilita la creazione di un nuovo progetto, includendo alcune preimpostazioni. I modelli possono contenere: profili di scheda predefiniti, posizioni di connettori, elementi dello schema, regole di progettazione, ecc. Persino schemi elettrici o circuiti stampati completi possono venire inclusi come spunti per il nuovo progetto.

Uso dei modelli

Il menu File → Nuovo progetto da modello aprirà la finestra di dialogo di selezione dei modelli:

Un singolo clic sull’icona di un modello mostrerà le informazioni del modello stesso, mentre un ulteriore clic sul pulsante OK farà partire la creazione del nuovo progetto. I file del modello verranno copiati nella posizione del nuovo progetto e rinominati per riflettere il nome del nuovo progetto.

][scaledwidth="80%"

Posizioni modelli

KiCad looks for system templates in the path defined in the KICAD8_TEMPLATE_DIR path variable, and user templates in the path defined in KICAD_USER_TEMPLATE_DIR. However, you can browse for templates in an arbitrary directory using the Folder control at the top of the dialog.

Creazione dei modelli

A KiCad template is simply a directory containing the template project files, as well as some required metadata for the template in a subdirectory named meta. The name of the directory containing the template files determines the name of the template. When you create a project from a template, KiCad copies the template files to the new project directory, renaming them to match the new project name as described below.

All files in the template are copied, with two exceptions:

  • Files with names beginning with the . character (dotfiles) are not copied. There is a special case for files named .gitignore or .gitattributes, which are copied if they exist.

  • The meta directory is not copied

The meta directory must contain an HTML file named info.html, which is displayed in the KiCad template browser and should contain basic information describing the template. Basic HTML features are supported, including images. Any images referenced by info.html should also be stored in the meta directory.

The <title> tag determines the name of the template that is displayed during template selection. Note that the project template name will be cut off if it’s too long. This display name does not need to be the same as the template directory name.

Ecco un file info.html di esempio:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html;
charset=windows-1252">
<TITLE>Raspberry Pi - Expansion Board</TITLE>
</HEAD>
<BODY LANG="fr-FR" DIR="LTR">
<P>This project template is the basis of an expansion board for the
<A HREF="http://www.raspberrypi.org/" TARGET="blank">Raspberry Pi $25
ARM board.</A> <BR><BR>This base project includes a PCB edge defined
as the same size as the Raspberry-Pi PCB with the connectors placed
correctly to align the two boards. All IO present on the Raspberry-Pi
board is connected to the project through the 0.1&quot; expansion
headers. <BR><BR>The board outline looks like the following:
</P>
<P><IMG SRC="brd.png" NAME="brd" ALIGN=BOTTOM WIDTH=680 HEIGHT=378
BORDER=0><BR><BR><BR><BR>
</P>
<P>(c)2012 Brian Sidebotham<BR>(c)2012 KiCad Developers</P>
</BODY>
</HTML>

Finally, meta can optionally contain an image named icon.png, which will be used as the template’s icon in the template selection dialog. The icon should be a 64 x 64 pixel PNG image.

Template file renaming

All files and directories in a template are copied to the new project path when a project is created using a template, except meta and any dotfiles. Files and directories containing the template directory name will be renamed with the new project file name.

For example, using a template named example (left) to create a project named newproject (right), with renamed files shown in bold:

File presenti nella cartella modello esempio File creati nella cartella progetto nuovoprogetto

esempio.kicad_pro
esempio.kicad_sch
esempio.kicad_pcb
esempio-primo.kicad_sch
secondo-esempio.kicad_sch
terzo.kicad_sch
terzo.kicad_pcb

nuovoprogetto.kicad_pro
nuovoprogetto.kicad_sch
nuovoprogetto.kicad_pcb
nuovoprogetto-primo.kicad_sch
secondo-nuovoprogetto.kicad_sch
terzo.kicad_sch
terzo.kicad_pcb

A template does not need to contain a complete project. If a required project file is missing, KiCad will create the file using the default create project behavior:

File nella cartella modelli esempio File creati nella cartella nuovoprogetto

esempio.kicad_sch
primo-esempio.kicad_sch
primo-esempio.kicad_pcb
secondo-esempio.kicad_sch
secondo-esempio.kicad_pcb

nuovoprogetto.kicad_sch
primo-nuovoprogetto.kicad_sch
primo-nuovoprogetto.kicad_pcb
secondo-nuovoprogetto.kicad_sch
secondo-nuovoprogetto.kicad_pcb
nuovoprogetto.kicad_pro (predefinito)
nuovoprogetto.kicad_pcb (predefinito)

As an exception to the template name renaming rule, if the template contains one project file (.kicad_pro) and its name doesn’t match the template name, KiCad will do the renaming based on that project file name instead:

File nella cartella esempio File creati nella cartella nuovoprogetto

esempio.kicad_sch
esempio.kicad_pcb
primo-esempio.kicad_pro
primo-esempio.kicad_sch
primo-esempio.kicad_pcb
secondo-esempio.kicad_sch
secondo-esempio.kicad_pcb

esempio.kicad_sch
esempio.kicad_pcb
nuovoprogetto.kicad_pro
nuovoprogetto.kicad_sch
nuovoprogetto.kicad_pcb
secondo-esempio.kicad_sch
secondo-esempio.kicad_pcb

Non è consigliabile creare un modello con più di un file progetto.

Plugin e gestore contenuti

This section of the KiCad documentation has not yet been written. We appreciate your patience as our small team of volunteer documentation writers work to update and expand the documentation.

Elenco di riferimento azioni

Di seguito è riportato un elenco di tutte le azioni disponibili nella Gestione progetti di KiCad: un comando che può essere assegnato a un tasto comando.

Gestore progetti di KiCad

Le azioni seguenti sono disponibili nella Gestione progetti di KiCad. I tasti comando possono essere assegnati a una qualsiasi di queste azioni nella sezione Tasti comando delle preferenze.

Action Default Hotkey Description

Close Project

Close the current project

Image Converter

Ctrl+B

Convert bitmap images to schematic or PCB components

Drawing Sheet Editor

Ctrl+Y

Edit drawing sheet borders and title block

Footprint Editor

Ctrl+F

Edit PCB footprints

PCB Editor

Ctrl+P

Edit PCB

Schematic Editor

Ctrl+E

Edit schematic

Symbol Editor

Ctrl+L

Edit schematic symbols

Clone Project from Repository…​

Clone a project from an existing repository

New Project from Template…​

Ctrl+T

Create new project from template

New Project…​

Ctrl+N

Create new blank project

Open Demo Project…​

Open a demo project

Open Project…​

Ctrl+O

Open an existing project

Open Text Editor

Launch preferred text editor

Plugin and Content Manager

Ctrl+M

Run Plugin and Content Manager

Calculator Tools

Run component calculations, track width calculations, etc.

Gerber Viewer

Ctrl+G

Preview Gerber output files