Botón Izquierdo

Botón derecho

Puede mover, arrastrar, copiar y borrar áreas seleccionadas en todos los menús de Eeschema.

Areas are selected by drawing a box around items using the left mouse button.

Holding Shift'', Ctrl'', or ``Shift + Ctrl'' during selection respectively performs copying, dragging and deletion:

Cuando copie o arrastre, puede:

If a block move command has started, another command can be selected using the right-click pop-up menu.

Eeschema uses two library tables to store the list of available symbol libraries, which differ by the scope:

Libraries listed in the Global Libraries table are available to every project. They are saved in sym-lib-table in your home directory (exact path is dependent on the operating system; check the path above the table).

Libraries listed in Project Specific Libraries table are available to the currently opened project. They are saved in sym-lib-table file in the project directory (check the path above the table).

You can view either list by clicking on "Global Libraries" or "Project Specific Libraries" tab below the library table.

Errors are displayed in the Electrical Rules Checker dialog:

Opciones:

Comandos:

This tab allows you to define the connectivity rules between pins; you can choose between 3 options for each case:

Cada cuadro de la matriz puede ser modificado haciendo clic en el.

Opciones:

Comandos:

There are several special copy/paste methods in spreadsheet. They may be useful when entering field values that are repeated in a few components.

These methods are illustrated below.

The icon launches the back-annotate tool.

Esta herramienta permite que los cambios en las asignaciones de huellas realizadas en PcbNew puedan ser importados de vuelta a los campos correspondientes en Eeschema.

The global symbol library table contains the list of libraries that are always available regardless of the currently loaded project file. The table is saved in the file sym-lib-table in the user’s home folder. The location of this folder is dependent upon the operating system being used.

The project specific symbol library table contains the list of libraries that are available specifically for the currently loaded project file. The project specific symbol library table can only be edited when it is loaded along with the project file. If no project file is loaded or there is no symbol library table file in the current project path, an empty table is created which can be edited and later saved along with the project file.

The first time Eeschema is run and the global symbol table file sym-lib-table is not found in the user’s home folder, Eeschema will attempt to copy the default symbol table file sym-lib-table stored in the system’s KiCad template folder to the file sym-lib-table in the user’s home folder. If the default template sym-lib-table file cannot be found, a dialog will prompt for an alternate location for the sym-lib-table file. If no sym-lib-table is found or the dialog is dismissed, an empty symbol library table will be created in the user’s home folder. If this happens, the user can either copy sym-lib-table manually or configure the table by hand.

In order to use a symbol library, it must first be added to either the global table or the project specific table. The project specific table is only applicable when you have a project file open.

Each library entry must have a unique nickname.

This does not have to be related in any way to the actual library file name or path. The colon ':' and '/' characters cannot be used anywhere in the library nickname. Each library entry must have a valid path and/or file name depending on the type of library. Paths can be defined as absolute, relative, or by environment variable substitution (see section below).

The appropriate plug in type must be selected in order for the library to be properly read. KiCad currently supports only legacy symbol library files plug-in.

There is also a description field to add a description of the library entry. The option field is not used at this time so adding options will have no effect when loading libraries.

One of the most powerful features of the symbol library table is environment variable substitution. This allows for definition of custom paths to where symbol libraries are stored in environment variables. Environment variable substitution is supported by using the syntax $\{ENV_VAR_NAME\} in the library path.

By default, at run time KiCad defines two environment variables:

You can override KICAD_SYMBOL_DIR by defining it yourself in preferences/ Configure Path which allows you to substitute your own libraries in place of the default KiCad symbol libraries.

KIPRJMOD allows you to store libraries in the project path without having to define the absolute path (which is not always known) to the library in the project specific symbol library table.

Symbol libraries can be defined either globally or specifically to the currently loaded project. Symbol libraries defined in the user’s global table are always available and are stored in the sym-lib-table file in the user’s home folder. The project specific symbol library table is active only for the currently open project file.

There are advantages and disadvantages to each method. Defining all libraries in the global table means they will always be available when needed. The disadvantage of this is that load time will increase.

Defining all symbol libraries on a project specific basis means that you only have the libraries required for the project which decreases symbol library load times. The disadvantage is that you always have to remember to add each symbol library that you need for every project.

One usage pattern would be to define commonly used libraries globally and the libraries only required for the project in the project specific library table. There is no restriction on how to define libraries.

When loading a schematic created prior to the symbol library table implementation, Eeschema will attempt to remap the symbol library links in the schematic to the appropriate library table symbols. The success of this process is dependent on several factors:

To load a symbol into your schematic you can use the icon . A dialog box allows you to type the name of the symbol to load.

The Choose Symbols dialog will filter symbols by name, keywords, and description according to what you type into the search field. Advanced filters can be used just by typing them:

Before placing the symbol in the schematic, you can rotate it, mirror it, and edit its fields, by either using the hotkeys or the right-click context menu. This can be done the same way after placement.

Here is a symbol during placement:

A power port symbol is a symbol (the symbols are grouped in the “power” library), so they can be placed using the symbol chooser. However, as power placements are frequent, the tool is available. This tool is similar, except that the search is done directly in the ``power'' library.

There are two ways to edit a symbol:

When a symbol has just been placed, you may have to modify its value (particularly for resistors, capacitors, etc.), but it is useless to assign to it a reference number right away, or to select the unit (except for components with locked units, which you have to assign manually). This can be done automatically by the annotation function.

Todos estos elementos de dibujo pueden ser colocados con las herramientas de la barra de herramientas lateral derecha.

Estos elementos son:

Existen dos métodos de establecer conexiones:

La siguiente figura muestra los dos métodos:

Nota 1:

El punto de "contacto" de una etiqueta es la esquina inferior izquierda de la primera letra de la etiqueta. Este punto es mostrado mediante un pequeño cuadrado cuando no esta conectado.

Este punto debe estar en contacto con el hilo, o sobreponerse al final de un pin de forma que la etiqueta sea vista como conectada.

Nota 2:

Para establecer una conexión, un segmento de hilo debe estar conectado en su extremo a otro segmento de hilo o a un pin.

Si existe superposición (si un hilo pasa sobre un pin, pero no es conectado al extremo del pin) no existe conexión.

Nota 3:

Los hilos que se cruzan no están implícitamente conectados. Es necesario unirlos mediante un punto de unión si se desea que exista conexión entre ambos.

En la figura previa (los hilos conectados a los pines 22, 21, 20 y 19 del componente DB25FEMALE) muestran el caso de conexión usando el símbolo de unión.

Nota 4:

Si dos etiquetas distintas son colocadas en el mismo hilo, éstas están conectadas entre si y se convierten en equivalentes: todos los elementos conectados a una u otra etiquetas están conectados entre si.

En el siguiente esquema, múltiples pines están conectados a buses.

When the power pins of the symbols are visible, they must be connected, as for any other signal.

Symbols such as gates and flip-flops may have invisible power pins. Care must be taken with these because:

Y además, seria una mala idea hacerlos visibles y conectarlos como los otros pines debido a que el esquema podría volverse ilegible y no estar en concordancia con las convenciones usuales.

Eeschema automáticamente conecta los pines de alimentación con el mismo nombre a la red de alimentación con ese nombre. Puede ser necesario unir redes de alimentación con distinto nombre (por ejemplo, "GND" en componentes TTL y "VSS" en componentes MOS); use para esto los puertos de potencia.

No es recomendable usar etiquetas para conexiones de alimentación. Estas solo tienen un alcance de conexión local, y podrían no conectar los pines de alimentación invisibles.

La siguiente figura muestra un ejemplo de conexiones con puertos de potencia.

En este ejemplo, la tierra (GND) esta conectada al puerto de potencia VSS, y el puerto de potencia VCC esta conectado a VDD

Dos símbolos PWR_FLAG son visibles. Estos indican que los dos puertos de potencia VCC y GND están realmente conectados a fuentes de alimentación. Sin esos dos símbolos, la herramienta ERC diagnosticaría: Warning: power port not powered.

All these symbols can be found in the ``power'' symbol library.

These symbols are very useful to avoid undesired ERC warnings. The electrical rules check ensures that no connection has been accidentally left unconnected.

Si los pines realmente deben estar sin conectar, es necesario colocar una marca de "No Conectado" (herramienta ) sobre esos pines. Estos símbolos no tienen ninguna influencia sobre los netlists generados.

It can be useful (to aid in understanding the schematic) to place annotations such as text fields and frames. Text fields (tool ) and Polyline (tool ) are intended for this use, contrary to labels and wires, which are connection elements.

Aquí puede encontrar un ejemplo de un cuadro con un comentario en texto.

El bloque de titulo de la hoja se edita con la herramienta .

El número de hoja (Hoja X/Y) es actualizado automáticamente.

Las etiquetas locales, herramienta , son señales de conexión solo dentro de una hoja. Las etiquetas jerárquicas (herramienta ) son señales de conexión solo entre una hoja y un pin jerárquico situado en la hoja padre.

Las etiquetas globales (herramienta ) son señales de conexión a lo largo de toda la jerarquía. Los pines de potencia ( tipos power in y power out) invisibles son como etiquetas globales porque están conectados entre ellos a lo largo de toda la jerarquía.

A continuación se indican varios modos de proveer conexión, además de las conexiones mediante hilos.

Las etiquetas globales que tienen idéntico nombre están conectadas a lo largo de la jerarquía completa.

(Las etiquetas de potencia como vcc …​ son etiquetas globales)

Este ejemplo muestra 5 elementos ubicados pero no anotados.

Después de ejecutar la anotación, se obtiene el siguiente resultado.

Ordenar con respecto a la posición X.

Ordenar con respecto a la posición Y.

Puede observarse que cuatro puertas 74LS00 fueron distribuidas en el encapsulado U1, y que la quinta puerta 74LS00 ha sido asignada al siguiente encapsulado, U2.

Esta es una anotación en la hoja 2 donde fue usada la opción usar primer número libre en el esquema.

La opción comenzar por el número de hoja*100 y usar el primer número libre arrojó el siguiente resultado.

La opción comenzar por el número de hoja*1000 y usar el primer número libre produjo el siguiente resultado.

Many software tools that use netlists do not accept spaces in the component names, pins, nets or other informations. Avoid using spaces in labels, or names and value fields of components or their pins to ensure maximum compatibility.

Del mismo modo, los caracteres especiales distintos de letras y números pueden causar problemas. Note que esta limitación no es relativa a Eeschema sino a los formatos de netlist que pueden resultar intraducibles para otros programas que usen ficheros de netlist.

Para el simulador Pspice, tiene que incluir algunas lineas de comando en el propio netlist (.PROBE, .AC, etc.).

Cualquier linea de texto incluida en el diagrama de esquema comenzando con la clave -pspice o -gnucap será insertada (sin la clave) al inicio del netlist.

Cualquier linea de texto incluida en el diagrama de esquema comenzando con la clave +pspice o +gnucap será insertada (sin la clave) al inicio del netlist.

Aquí se muestra un ejemplo usando varias textos de una línea y textos multi-línea.

Por ejemplo, si escribe el siguiente texto (¡No use una etiqueta!):

una línea .PROBE se insertará en el netlist.

En el ejemplo anterior tres lineas fueron insertadas al inicio del netlist y dos al final con esta técnica.

Si está usando textos multilinea, las claves +pspice or +gnucap serán necesarias solo una vez:

Crea las siguientes cuatro lineas:

Also note that the GND net must be named 0 (zero) for Pspice.

Puede añadir un nuevo plugin de netlist mediante el botón Añadir Plugin.

Aquí se muestra la ventana de ajuste del plugin PadsPcb:

La configuración requerirá:

Cuando el netlist es generado:

Aquí se muestra un ejemplo usando xsltproc.exe como herramienta para convertir archivos .xsl, y un archivo metlist_from_pads-pcb.xsl como hoja de estilo conversora:

f:/kicad/bin/xsltproc.exe -o %O.net f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl %I

Con:

Para un fichero de esquema llamado test.sch, la linea de comando actual es:

f:/kicad/bin/xsltproc.exe -o test.net f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl test.tmp.

Este es un software muy simple porque su propósito es simplemente convertir un fichero de entrada (el fichero de texto intermedio) a otro fichero de texto. Además, desde el fichero de texto intermedio, se puede crear una lista de materiales (BOM).

Cuando se usa xsltproc como herramienta de conversión solo será generado el fichero tipo hoja.

Vea el capitulo 14 para mas explicaciones sobre xslproc, descripciones del formato de archivo intermedio, y algunos ejemplo de conversores de estilo hoja.

Normalmente el tamaño de la hoja es comprobado. En este caso, se usará el tamaño de hoja definido en el menú del bloque y la escala elegida será 1. Si se selecciona un tamaño de hoja diferente (A4 con A0, o A con E), la escala se ajusta automáticamente al tamaño de la hoja.

Para todas las dimensiones estándar, puede ajustar el offset para centrar el dibujo tan precisamente como sea posible. Dado que los plotters tienen el punto de origen en el centro o en la esquina inferior izquierda, es necesario que sea posible introducir un offset para imprimir adecuadamente.

Generalidades:

Ajustar el offset:

The main tool bar typically located at the top of the main window shown below consists of the library management tools, undo/redo commands, zoom commands, and symbol properties dialogs.

The vertical toolbar typically located on the right hand side of the main window allows you to place all of the elements required to design a symbol. The table below defines each toolbar button.

La barra de herramientas que se ubica generalmente a la izquierda de la pantalla principal le permite ajustar algunas de las opciones del editor de componentes. La siguiente tabla define cada botón de la barra de herramientas.

When you edit a symbol you are not really working on the symbol in its library but on a copy of it in the computer’s memory. Any edit action can be undone easily. A symbol may be loaded from a local library or from an existing symbol.

A new symbol can be created by clicking the . You will be asked for a symbol name (this name is used as default value for the value field in the schematic editor), the reference designator (U, IC, R…​), the number of units per package (for example a 7400 is made of 4 units per package) and if an alternate body style (sometimes referred to as DeMorgan) is desired. If the reference designator field is left empty, it will default to "U". These properties can be changed later, but it is preferable to set them correctly at the creation of the symbol.

A new symbol will be created using the properties above and will appear in the editor as shown below.

Often, the symbol that you want to make is similar to one already in a symbol library. In this case it is easy to load and modify an existing symbol.

Symbol properties should be carefully set during the symbol creation or alternatively they are inherited from the copied symbol. To change the symbol properties, click on the to show the dialog below.

It is very important to correctly set the number of units per package and the alternate symbolic representation, if enabled, because when pins are edited or created the corresponding pins for each unit will be affected. If you change the number of units per package after pin creation and editing, there will be additional work to add the new unit pins and symbols. Nevertheless, it is possible to modify these properties at any time.

The graphic options "Show pin number" and "Show pin name" define the visibility of the pin number and pin name text. This text will be visible if the corresponding options are checked. The option "Place pin names inside" defines the pin name position relative to the pin body. This text will be displayed inside the symbol outline if the option is checked. In this case the "Pin Name Position Offset" property defines the shift of the text away from the body end of the pin. A value from 30 to 40 (in 1/1000 inch) is reasonable.

The example below shows a symbol with the "Place pin name inside" option unchecked. Notice the position of the names and pin numbers.

If the symbol has more than one symbolic repersentation, you will have to select one representation to edit them. To edit the normal representation, click the .

To edit the alternate representation, click on the . Use the shown below to select the unit you wish to edit.

Cada elemento gráfico (línea, arco, círculo, etc.) puede definirse como común a todas las unidades y/o estilos de símbolo, o específicos a una unidad o estilo de símbolo concreto. Puede accederse rápidamente a las opciones de los elementos mediante un menú contextual haciendo clic derecho en el elemento. Debajo se muestra el menú contextual para un elemento línea.

Además puede realizar doble clic sobre un elemento para modificar sus propiedades. Debajo se muestra el formulario de propiedades para un elemento polígono.

Las propiedades de un elemento gráfico son:

The allows for the creation of graphical text. Graphical text is always readable, even when the symbol is mirrored. Please note that graphical text items are not fields.

Este es un ejemplo de un relé definido por tres unidades por encapsulado, contacto 1, contacto 2 y la bobina:

Opción: Los pines no están enlazados. Se pueden añadir o editar pines para cada unidad sin que interfiera en los pines de las otras unidades.

Debe seleccionarse la opción "Todas las unidades no son intercambiables".

Unidad 1

Unidad 2

Unidad 3

Esta no tiene el mismo símbolo ni distribución de pines que las unidades 1 y 2, y por tanto no es intercambiable con ellas.

Un pin es definido por su representación gráfica, su nombre y su "número". El "número" del pin es definido por un conjunto de 4 letras y/o números. Para que la herramienta de Comprobación de Reglas Eléctricas (ERC) sea útil, el tipo "eléctrico" del pin (entrada, salida, tri-estado) también debe ser definido correctamente. Si no se define este tipo correctamente, la comprobación eléctrica del esquema puede ser invalida.

Notas importantes:

El formulario de propiedades del pin le permite editar todas las características de un pin. Este formulario aparece automáticamente cuando crea un pin o cuando hace doble clic en un pin que ya exista. Desde este formulario podrá modificar:

En la siguiente figura se muestran los diferentes estilos gráficos de los pines. La elección de un estilo gráfico no tiene ninguna influencia en el tipo eléctrico del mismo.

Elegir el tipo eléctrico correctamente es muy importante para la herramienta de comprobación ERC. Los tipos eléctricos definidos son:

You can modify the length or text size of the name and/or number of all the pins using the Global command entry of the pin context menu. Click on the parameter you want to modify and type the new value which will then be applied to all of the current symbol’s pins.

Symbols with multiple units and/or graphical representations are particularly problematic when creating and editing pins. The majority of pins are specific to each unit (because their pin number is specific to each unit) and to each symbolic representation (because their form and position is specific to each symbolic representation). The creation and the editing of pins can be problematic for symbols with multiple units per package and alternate symbolic representations. The symbol library editor allows the simultaneous creation of pins. By default, changes made to a pin are made for all units of a multiple unit symbol and both representations for symbols with an alternate symbolic representation.

La única excepción a esto son los campos tipo gráfico y nombre del pin. Esa dependencia fue establecida para permitir una creación y edición de pines mas fácil en la mayoría de los casos. Esta dependencia puede ser deshabilitada cambiando el estado de en la barra de herramientas principal. Esto le permitirá crear pines para cada unidad y representación completamente independientes.

A symbol can have two symbolic representations (representation known as``DeMorgan'') and can be made up of more than one unit as in the case of symbols with logic gates. For certain symbols, you may want several different graphic elements and pins. Like the relay sample shown in the previous section, a relay can be represented by three distinct units: a coil, switch contact 1, and switch contact 2.

The management of the symbols with multiple units and symbols with alternate symbolic representations is flexible. A pin can be common or specific to different units. A pin can also be common to both symbolic representations or specific to each symbolic representation.

Por defecto, los pines son específicos de cada unidad, dado que sus números son diferentes para cada unidad, y su diseño es diferente para cada representación simbólica. Cuando un pin es común para todas las unidades este solo se dibuja una vez como en el caso de los pines de alimentación.

An example is the output pin 7400 quad dual input NAND gate. Since there are four units and two symbolic representations, there are eight separate output pins defined in the symbol definition. When creating a new 7400 symbol, unit A of the normal symbolic representation will be shown in the library editor. To edit the pin style in alternate symbolic representation, it must first be enabled by clicking the button on the tool bar. To edit the pin number for each unit, select the appropriate unit using the drop down control.

To edit an existing symbol field, right-click on the field text to show the field context menu shown below.

To edit undefined fields, add new fields, or delete optional fields on the main tool bar to open the field properties dialog shown below.

Fields are text sections associated with the symbol. Do not confuse them with the text belonging to the graphic representation of this symbol.

Notas importantes:

Keywords allow you to search in a selective way for a symbol according to specific selection criteria (function, technological family, etc.)

La herramienta de búsqueda de Eeschema no es sensible a mayúsculas. Las palabras clave típicas en las bibliotecas son:

The line of comment (and keywords) is displayed in various menus, particularly when you select a symbol in the displayed symbols list of a library and in the ViewLib menu.

If this Doc. file exists, it is also accessible in the schematic capture software, in the pop-up menu displayed by right-clicking on the symbol.

Indica un fichero adjunto (documentación, notas de aplicación) disponible (fichero pdf, diagrama de esquema, etc).

You can enter a list of allowed footprints for the symbol. This list acts as a filter used by CvPcb to display only the allowed footprints. A void list does not filter anything.

Están permitidos los metacaracteres.

SO14* permite a CvPcb mostrar todos las huellas cuyo nombre comience por S014.

Para una resistencia, R? muestra todas las huellas de 2 letras que comiencen por R.

Aquí hay unos ejemplos: con y sin filtrado.

Con filtrado.

Sin filtrado

A symbol can be exported with the button . You can generally create only one graphic, also it will be a good idea to delete all pins, if they exist.

Importing allows you to add graphics to a symbol you are editing. A symbol is imported with the button . Imported graphics are added as they were created in existing graphics.

El netlist intermedio correspondiente (usando sintaxis XML) al circuito anterior es mostrado a continuación.

El formato pads-pcb está compuesto por dos secciones.

Justo debajo se muestra una hoja de estilo que convierte el fichero netlist intermedio al formato netlist pads-pcb:

Y aquí se muestra el fichero de salida tipo netlist pads-pcb tras ejecutar xsltproc:

La linea de comando para realizar esta conversión es:

El formato Cadstar está compuesto por dos secciones.

Aquí se muestra un fichero de hoja de estilo que realiza esta conversión:

A continuación se muestra el fichero de salida formato Caadstar.

Este formato tiene solo una sección que es la lista de huellas. Cada huella incluye su lista de pads con referencias a nodos.

Aqui se muestra la hoja de estilo para esta conversión:

Este es el fichero de salida en formato OrcadPCB2

Los conversores de netlist intermedio pueden ser automáticamente ejecutados dentro de Eeschema.

Dado que el netlist intermedio contiene toda la información sobre los componentes usados, una lista BOM puede ser extraída de el. Aquí se muestra la ventana de ajuste del plug-in (en Linux) para crear un fichero de lista de materiales (BOM) personalizado:

La ruta al archivo de hoja de estilo bom2csv.xsl depende del sistema empleado. La mejor hoja de estilo XSLT actualmente para la generación de listas de materiales es llamada bom2csv.xsl. Siéntase libre de modificarla de acuerdo a sus necesidades, y si desarrolla algo útil en general, pregunte para que forme parte del proyecto kiCad.

El fichero netlist intermedio cuenta con cinco secciones.

El contenido del archivo tiene el delimitador <export>

La cabecera tiene el delimitador <design>

Esta sección puede ser considerada como una sección para comentarios.

La sección de componentes tiene el delimitador <components>

Esta sección contiene la lista de componentes en el esquema eléctrico. Cada componente es descrito como sigue:

La sección libparts tiene el delimitador <libparts>, y su contenido es definido en las bibliotecas del esquema. La sección libparts contiene

Las líneas como <pin num="1" type="passive"/> indican, además, las especificaciones eléctricas del pin. Los posibles tipos eléctricos para los pines son

La sección bibliotecas tiene el delimitador <libraries>. Esta sección contiene la lista de bibliotecas usada en el proyecto.

La sección nodos usa el delimitador <nets>. Esta sección especifica la "conectividad" del esquema.

Esta sección contiene todos los nodos del esquema.

Un posible nodo contiene lo siguiente.

xsltproc es una herramienta bajo línea de comando para aplicar hojas de estilo XSLT a documentos XML. Aunque fue desarrollada como parte del proyecto GNOME, puede funcionar independientemente del escritorio GNOME.

xsltproc es invocado desde la consola con el nombre de la hoja de estilo a ser usada seguida del nombre del fichero o ficheros a los que ha de aplicarse la hoja de estilo. Usará la entrada estándar si el nombre de fichero indicado es - .

Si una hoja de estilo es incluida en un documento XML con instrucciones de procesamiento, no se necesita llamar a ninguna hoja de estilo en el comando. xsltproc detectará automáticamente la hoja de estilo incluida y la usará. Por defecto, la salida la redirige a stdout. Puede especificar un fichero como salida usando la opción -o.

-V o --version

Muestra las versiones de libxml y libxslt usadas.

-v o --verbose

Muestra cada paso tomado por xsltproc durante el procesado de la hoja de estilo y el documento.

-o o --output file

Redirige la salida al fichero llamado file. Para múltiples salidas, también conocido como ``chunking'', -o directorio/ redirige los ficheros de salida al directorio especificado. El directorio de existir previamente.

--timing

Muestra el tiempo usado para traducir la hoja de estilo, traducir el documento, aplicar la hoja de estilo y guardar el resultado. Se muestra en milisegundos.

--repeat

Usa la transformación 20 veces. Usado para test de tiempos.

--debug

Muestra un árbol XML del documento transformado con propósitos de depuración.

--novalid

Omite la carga del DTD del documento.

--noout

No muestra el resultado.

--maxdepth value

Ajusta la profundidad máxima de la pila de la plantilla para evitar que libxslt entre en un bucle infinito. Por defecto es 500.

--html

El fichero de entrada es un fichero HTML

--param name value

Pasa un parámetro de nombre name y valor value a la hoja de estilo. Puede pasar múltiples parejas nombre/valor hasta un máximo de 32. Si el valor que se pasa es una cadena en vez de un identificador de nodo, use --stringparam en su lugar.

--stringparam name value

Pasa un parámetro de nombre name y valor value donde value es una cadena en vez de un identificador de nodo. (Nota: la cadena debe estar en formato utf-8)

--nonet

No utiliza Internet para buscar los DTD, entidades o documentos.

--path paths

Use the list (separated by space or column) of filesystem paths specified by paths to load DTDs, entities or documents.

--load-trace

Muestra en stderr todos los documentos cargados durante el proceso.

--catalogs

Usa el catálogo especificado en SGML_CATALOG_FILES para resolver la ubicación de entidades externas. Por defecto, xsltproc busca el catálogo especificado en XML_CATALOG_FILES. Si este no se especifica, usa /etc/xml/catalog.

--xinclude

Procesa el documento de entrada usando las especificaciones Xinclude. Mas detalles sobre esto pueden obtenerse en las especificaciones Xinclude: http://www.w3.org/TR/xinclude/

--profile --norman

Muestra información de evaluación indicando la cantidad de tiempo consumida en cada parte de la hoja de estilo. Esto es útil para la optimización del rendimiento de las hojas de estilo.

--dumpextensions

Vuelca la lista de todas la extensiones registradas por stdout.

--nowrite

Rechaza la escritura a cualquier archivo o recurso.

--nomkdir

Rechaza la creación de directorios.

--writesubtree path

Permite la escritura de ficheros solo en la ruta especificada en path.

--nodtdattr

No aplica los atributos por defecto de los DTD de los documentos.

Xsltproc devuelve un numero de estado que puede ser bastante útil cuando se llama desde un script.

0: normal

1: sin argumento

2: demasiados parámetros

3: opción desconocida

4: fallo al traducir la hoja de estilo

5: error en la hoja de estilo

6: error en uno de los documentos.

7: método de salida:xsl no soportado

8: parámetro cadena contiene comilla simples y dobles

9: error de procesamiento interno

10: El proceso fue interrumpido por un mensaje de finalización

11: no se puede escribir el resultado al fichero de salida

página web de libxml: http://www.xmlsoft.org/

Página W3C XSLT: http://www.w3.org/TR/xslt

Passive tab allows the user to assign a passive device model (resistor, capacitor or inductor) to a component. It is a rarely used option, as normally passive components have models assigned implicitly, unless component reference does not match the actual device type.

Model tab is used to assign a semiconductor or a complex model defined in an external library file. Spice model libraries are often offered by device manufacturers.

The main text widget displays the selected library file contents. It is a common practice to put models description inside library files, including the node order.

Source tab is used to assign a power or signal source model. There are two sections: DC/AC analysis and Transient analysis. Each defines source parameters for the corresponding simulation type.

Source type option applies to all simulation types.

Refer to the ngspice documentation, chapter 4 (Voltage and Current Sources) for more details about sources.

The top toolbar provides access to the most frequently performed actions.

Visualizes the simulation results as plots. One can have multiple plots opened in separate tabs, but only the active one is updated when a simulation is executed. This way it is possible to compare simulation results for different runs.

Plots might be customized by toggling grid and legend visibility using View menu. When a legend is visible, it can be dragged to change its position.

Plot panel interaction:

Output console displays messages from the simulator. It is advised to check the console output to verify there are no errors or warnings.

Shows the list of signals displayed in the active plot.

Signals list interaction:

Shows the list of cursors and their coordinates. Each signal may have one cursor displayed. Cursors visibility is set using the Signals list.

Displays components picked with the Tuner tool. Tune panel allows the user to quickly modify component values and observe their influence on the simulation results - every time a component value is changed, the simulation is rerun and plots are updated.

For each component there a few controls associated:

The three text fields recognize Spice unit prefixes.

Tuner tool lets the user pick components for tuning.

To select a component for tuning, click on one in the schematics editor when the tool is active. Selected components will appear in the Tune panel. Only passive components might be tuned.

Probe tool provides an user-friendly way of selecting signals for plotting.

To add a signal to plot, click on a corresponding wire in the schematics editor when the tool is active.

Simulation settings dialog lets the user set the simulation type and parameters. There are four tabs:

The first three tabs provide forms where simulation parameters might be specified. The last tab allows the user to type in custom Spice directives to set up a simulation. You can find more information about simulation types and parameters in the ngspice documentation, chapter 1.2.

An alternative way to configure a simulation is to type Spice directives into text fields on schematics. Any text field directives related to simulation type are overridden by the settings selected in the dialog. It means that once you start using the simulation dialog, the dialog overriddes the schematics directives until the simulator is reopened.

There are two options common to all simulation types: