RNLRich Netlist
ES

Translated from English by AI; it may contain errors. Report an issue · The English terms are the normative ones. Glossary

RICH NETLIST · TOOLKIT 0.1Edita texto · resuelve en escritorio

Herramientas

Abre un netlist en el navegador o descarga el visor para Windows, Linux o macOS

El conjunto de herramientas de RNL incluye dos visores: el visor web, que no requiere instalación, y el visor de escritorio para Windows 10 y 11, Linux y macOS. Ambos leen netlists con registros RNL y los dibujan como esquemas, además de permitir editar el texto del netlist y volver a dibujarlo al aplicar los cambios. El visor web guarda descargando el archivo; el visor de escritorio lo escribe de vuelta en su ubicación original y además resuelve, mostrando el resultado como una vista previa que no modifica los archivos.

Abrir el visor web Descargar el visor de escritorio
Herramienta
RNL Viewer
Lee
Netlists SPICE y Spectre con registros RNL
Web
Chrome, Edge 109+ · Safari 16+ · Firefox 114+
Escritorio
0.5.3 · Windows 10/11 x64 · Linux x86_64 · macOS arm64 / x86_64
Lenguaje
RNL 0.3
Licencia
MIT · fuentes OFL-1.1

01 · Visores

Abre un netlist y ve el esquema. No se escribe nada hasta que guardas

Un visor abre un netlist SPICE o Spectre con registros RNL junto con los archivos que incluye, dibuja cada nivel del circuito y muestra a su lado el texto del netlist, los problemas y la jerarquía. También puede abrirse el texto de un netlist desde el portapapeles: Archivo › Cargar desde el portapapeles muestra primero el texto y lo abre cuando confirmas.

Dibuja cada nivel

El nivel superior y cada subcircuito tienen su propio dibujo, mostrados de uno en uno; arrastra para desplazar y usa la rueda para acercar o alejar. Haz doble clic en una instancia de subcircuito para abrir su dibujo; Backspace sube al nivel anterior.

El texto del netlist

El netlist y los archivos que incluye, con los registros RNL y las sentencias del netlist resaltados; las sentencias que no surten efecto llevan un fondo suave. Mientras se dibuja un subcircuito, el texto fuera de su definición se atenúa, y al entrar en el subcircuito la vista se desplaza al inicio de su definición.

Problemas

Los errores, las advertencias y las sugerencias se enumeran debajo del texto; haz clic en cualquiera para ir a su línea. Los números de esas líneas también se colorean.

Jerarquía

El árbol de instancias bajo el nivel superior y, debajo de él, todos los subcircuitos por nombre, agrupados por inicial y con un cuadro de búsqueda; elige uno para abrir su dibujo.

Dibujo y texto vinculados

Haz clic en una instancia o en un cable del dibujo y el texto marcará su sentencia y cada lugar que lo nombre; haz clic en el texto y el dibujo lo seleccionará.

Objetos no dibujados

Los objetos sin posición (o sin símbolo) no se dibujan; la vista No dibujados del panel lateral los enumera con sus símbolos y las redes de sus terminales, con búsqueda por nombre, y al hacer clic en uno se resalta su sentencia en el netlist. La barra de estado informa de cuántos objetos no se han dibujado, y al hacer clic en ese mensaje se abre la vista.

Editar, aplicar, guardar

Ambos visores permiten editar el texto del netlist. Un cambio no hace nada por sí solo: se dibuja cuando lo aplicas y se escribe cuando lo guardas, y nada se resuelve automáticamente.

Editar el texto

Editar › Editar texto (Ctrl+Q, también con la tecla Control en macOS) convierte la vista del netlist en un cuadro de texto editable con números de línea para cada archivo. Los cambios sin guardar se marcan con un punto junto a la ruta del archivo, y la barra situada sobre el texto indica cuándo hay cambios pendientes de aplicar. Editar › Descartar cambios descarta los cambios no aplicados y sale de la edición.

Aplicar

Editar › Aplicar y salir de la edición (Ctrl+Enter) recompila el netlist a partir del texto editado, vuelve a dibujar el esquema, actualiza la lista de problemas y la jerarquía conservando el nivel, la vista y la selección actuales, y sale de la edición. Si la compilación falla, la edición permanece abierta y el visor explica el motivo.

Guardar

Archivo › Guardar (Ctrl+S; Archivo › Descargar archivo en el visor web): el visor de escritorio escribe únicamente los archivos editados en la ubicación de donde se leyeron, conservando la codificación y los saltos de línea de cada archivo; el visor web no puede sobrescribir archivos locales, de modo que Descargar archivo descarga el archivo mostrado. Si hay cambios sin guardar, el visor pide confirmación antes de abrir otro archivo, recargar o cerrar.

Ambos visores dibujan el mismo esquema: un único núcleo en Rust decide dónde va cada línea y cada fragmento de texto, ejecutándose de forma nativa en el escritorio y como WebAssembly en el navegador, y compone el texto con las fuentes que incorpora.

02 · Visor web

El visor web: sin nada que instalar

En la pestaña Biblioteca de la barra lateral (la primera pestaña), los archivos abiertos se añaden al grupo Archivos sin duplicados. Incluir archivo e Incluir carpeta añaden archivos a la Biblioteca sin abrirlos, mientras que Excluir retira un archivo de la búsqueda sin cerrar el documento actual. Incluir paquete público añade paquetes alojados, como SKY130, desde este sitio sin usar la API de GitHub. Archivos se inicia desplegado y el grupo de solo lectura Integrados (series estándar 0.3 y 0.2) se inicia plegado; el estado de plegado dura toda la sesión y las filas de archivos raíz se resaltan. El texto pegado desde el portapapeles aparece como una única fila temporal · no buscado fuera de la búsqueda: haz clic en ella para volver al último texto aplicado, vuelve a pegar para reemplazarla o ciérrala para vaciarla. Dado que los navegadores no pueden buscar en directorios arbitrarios de PATH local, el visor web resuelve los archivos incluidos y los paquetes a partir de la Biblioteca.

El visor web es una página web estática en cuyo interior se ejecuta el núcleo de RNL compilado a WebAssembly. Abre archivos o una carpeta entera desde tu ordenador, o bien un netlist en la web; también abre archivos arrastrados sobre la página.

Abrir el visor webrich-netlist.github.io/rnl/viewer/

Prueba estos ejemplos

Los ejemplos provienen del corpus de conformidad de RNL y se publican junto con el visor web. Haz clic en cualquiera y el visor lo abrirá.

  1. 04JerarquíaUn búfer de dos etapas: un dibujo para cada subcircuito, representado como símbolo de bloque en el nivel superior, y un archivo incluido.
  2. 17Estilos de líneaTodos los estilos de línea en toda clase de formas: líneas discontinuas, punteadas, gruesas y dobles en rectángulos, círculos, elipses, arcos y curvas, así como en un cable.

Tus archivos no salen del navegador

Los archivos que abres desde tu ordenador se leen en la propia página y no se suben a ninguna parte: el sitio consta únicamente de archivos estáticos y no tiene servidor que los reciba.

Abrir una URL

Archivo › Abrir URL lee un netlist desde otro servidor web, así como los archivos que incluye desde el mismo lugar. Ese servidor debe permitir lecturas entre orígenes (CORS), tal como hacen los enlaces a archivos raw de GitHub.

Navegadores

Chrome y Edge 109 o posterior, Safari 16 o posterior y Firefox 114 o posterior (las primeras versiones compatibles con Workers de módulos).

El visor web edita el texto y vuelve a dibujar el esquema al aplicar los cambios, como se describe más arriba. Dado que una página del navegador no puede sobrescribir archivos locales, Archivo › Descargar archivo (Ctrl+S) descarga el archivo mostrado en UTF-8 con sus saltos de línea originales. Solo el visor de escritorio resuelve; el visor web no tiene menú Resolver.

La dirección del visor puede indicar el netlist que se desea abrir, lo que permite compartir un enlace: viewer/?url=https://raw.githubusercontent.com/…/04-hierarchy.sp abre un netlist alojado en GitHub junto con el archivo que incluye.

Incrustación en otra página

Usa viewer/?embed=1 en un iframe para disponer de un visor interactivo de solo lienzo. Permite cambiar de netlist, de nivel y de fondo mediante postMessage sin recargar. Consulta la API de incrustación y el ejemplo, o prueba la demostración.

El visor web disponible aquí se compila a partir de la confirmación más reciente de la rama main; Ayuda › Acerca de RNL Viewer muestra su versión y confirmación, y Ayuda › Visor de escritorio lleva de vuelta a esta página.

03 · Visor de escritorio

El visor de escritorio para Windows, Linux y macOS

RNL Viewer de escritorio lee y escribe archivos en disco por sus rutas: encuentra los archivos que un netlist incluye estén donde estén, F5 vuelve a leer un archivo modificado, el texto editado se guarda en su ubicación original y Archivo › Guardar como guarda el netlist con un nombre nuevo. Comparte la interfaz del visor web y añade un menú Resolver para la disposición automática.

En escritorio, la Biblioteca muestra grupos ordenados de PATH entre Archivos e Integrados, inicialmente plegados, con controles para añadir, mover y eliminar. Despliega un grupo para ver los archivos .rnl directamente en esa carpeta o a un nivel de profundidad en una subcarpeta con número de versión; al abrir una fila también se añade a Archivos. Los directorios se vuelven a examinar al abrir la Biblioteca y tras modificar PATH. Todos los ajustes —incluidos los del solucionador, la visualización y PATH— se guardan en settings.json dentro del directorio de configuración de la aplicación de Tauri; los ajustes existentes de la vista web se migran en el primer inicio y la ruta exacta de settings.json se muestra al pie de la Biblioteca. Los archivos incluidos prueban primero su ruta relativa; los nombres de archivo sin ruta recurren a la Biblioteca y luego a PATH, emitiendo una sugerencia que indica el archivo resuelto. Para buscar paquetes se consulta la Biblioteca, PATH y los integrados, tomando la primera coincidencia de la versión solicitada. Cada directorio comprueba primero name.rnl y version/name.rnl, y luego examina otros archivos .rnl en busca de sus encabezados PACKAGE, por lo que los nombres de archivo no tienen por qué coincidir con los nombres de paquete. Un rnl-std del usuario puede sustituir a la copia integrada.

RNL Viewer 0.5.3 · Windows x64Página y notas de la versión
RNL Viewer 0.5.3 · Linux x86_64
  • AppImageRNL-Viewer-0.5.3-linux-x86_64.AppImage

    Para sistemas x86_64 con Ubuntu 22.04 o posterior. En el directorio de descarga, ejecuta chmod +x RNL-Viewer-0.5.3-linux-x86_64.AppImage y luego ./RNL-Viewer-0.5.3-linux-x86_64.AppImage. Si no dispones de FUSE, usa ./RNL-Viewer-0.5.3-linux-x86_64.AppImage --appimage-extract-and-run.

  • Paquete DebianRNL-Viewer-0.5.3-linux-x86_64.deb

    Ubuntu 22.04 o posterior; otras distribuciones basadas en Debian requieren glibc y WebKitGTK 4.1 compatibles. En el directorio de descarga, ejecuta sudo apt install ./RNL-Viewer-0.5.3-linux-x86_64.deb y luego abre RNL Viewer desde el menú de aplicaciones o ejecuta rnl-viewer. Para desinstalarlo, usa sudo apt remove rnl-viewer.

  • Sumas de verificaciónSHA256SUMS.txt

    Descarga las sumas de verificación y el paquete que desees en un mismo directorio y ejecuta sha256sum --check --ignore-missing SHA256SUMS.txt.

RNL Viewer 0.5.3 · macOS 13+

Abre el archivo DMG correspondiente a tu procesador, arrastra RNL Viewer a Aplicaciones y expulsa la imagen de disco. La aplicación tiene firma ad hoc y no está notarizada por Apple. Si macOS la bloquea, elige Abrir igualmente en Ajustes del Sistema → Privacidad y seguridad o, para una descarga de confianza, ejecuta xattr -dr com.apple.quarantine "/Applications/RNL Viewer.app" en Terminal y ábrela de nuevo. Para desinstalarla, sal de la aplicación y muévela a la Papelera.

En el Finder, usa Abrir con → RNL Viewer; desde Obtener información puedes definirlo como predeterminado para ese tipo de archivo. También puedes arrastrar archivos directamente a la ventana. La mayoría de los atajos usan Cmd; la edición de texto mantiene Control+Q físico y Cmd+Q cierra la aplicación. Los ajustes se guardan en ~/Library/Application Support/io.github.rich-netlist.viewer/settings.json; puedes eliminar ese directorio tras desinstalar. Verifica las descargas con el archivo SHA256SUMS.txt de la versión y shasum -a 256.

RNL Viewer 0.5.3 · con los paquetes públicos

Los instaladores de arriba ofrecen los paquetes públicos al instalar: el instalador de Windows en una página propia, el MSI como una función. Aquí están las otras variantes, con los paquetes en la misma descarga. Son las últimas versiones de los paquetes de rnl-packages cuando se construyó la versión; el visor nunca los descarga por sí mismo, y Ayuda › Paquetes públicos dice cuáles trae esta compilación.

  • Fuentes chinas en LinuxLa interfaz y el netlist recurren a las fuentes web Noto Sans SC incluidas. Los menús nativos de GTK, las descripciones emergentes nativas y los diálogos de archivos del sistema necesitan fuentes chinas del sistema: en Debian o Ubuntu, ejecuta sudo apt install fonts-noto-cjk y reinicia la aplicación. Esto también se aplica a AppImage.
  • WebView2El visor de escritorio necesita el entorno de ejecución Microsoft Edge WebView2, ya incluido en Windows 10 y 11. Si faltara, puede descargarse desde Microsoft.
  • SmartScreenLos archivos aún no están firmados digitalmente, por lo que Windows SmartScreen puede indicar que protegió tu PC: elige Más información y luego Ejecutar de todas formas.
  • ActualizacionesAyuda › Buscar actualizaciones comprueba si hay una versión más reciente.

Resolución como vista previa

El menú Resolver del visor de escritorio coloca los objetos que no tienen posición mediante el solucionador de rnl solve. El resultado se muestra únicamente en la ventana y los archivos permanecen intactos.

Una vista previa resuelta

Resolver › Resolver (F9) resuelve el texto aplicado del netlist y los archivos que incluye de la misma manera que rnl solve. Se ejecuta en segundo plano para que la ventana siga siendo utilizable, mientras la barra de estado muestra el nivel que se está resolviendo y un botón Cancelar. Una barra situada sobre el dibujo indica que se trata de una vista previa y que los archivos en disco no se han modificado, y la vista Resolver del panel lateral muestra el informe del solucionador: haz clic en cualquier entrada para saltar a su línea en el netlist. Resolver › Cerrar vista previa vuelve al archivo tal como está escrito.

Guardar una copia resuelta

Resolver › Guardar copia resuelta como (Ctrl+Shift+S) guarda el resultado donde elijas: un solo archivo, propuesto como NAME-solved.EXT, para un netlist que no incluye otros archivos; o bien una carpeta con los archivos resueltos y los demás archivos leídos, tal como los escribe rnl solve -o DIR. Se rechaza cualquier ubicación que sobrescriba alguno de los archivos leídos.

Ajustes del solucionador

Resolver › Configuración establece las opciones del solucionador: el límite de tiempo por nivel, la tolerancia, la cuadrícula, el ancho de haz, el esfuerzo de búsqueda y del enrutador, y los objetivos que clasifican las disposiciones: qué objetivos están activados, su orden de clasificación y los pesos de los objetivos en el mismo rango. La prioridad de las restricciones (low, normal, high) se escribe en el netlist, no se configura aquí. Restaurar valores predeterminados restablece todas las opciones a sus valores por defecto, y la configuración se conserva entre inicios.

04 · Línea de comandos

Descargar, extraer y ejecutar

Usa rnl para comprobar netlists, renderizar archivos SVG y resolver disposiciones. No requiere tener Rust instalado; en Windows tampoco hace falta instalar por separado el entorno de ejecución de VC++. La CLI y el paquete de npm comparten la versión del núcleo, de forma independiente del visor y del estándar del lenguaje.

RNL core · CLIVersión del núcleo

SHA256SUMS.txt: verifica el SHA256 del archivo comprimido antes de ejecutarlo. rnl --version muestra la versión del núcleo y la confirmación de compilación; usa rnl check my.sp para comprobar un netlist y rnl render my.sp -o svg para exportar los dibujos.

Estos enlaces apuntan siempre a la publicación core-v* más reciente. Los archivos no están firmados: Windows puede mostrar SmartScreen y las descargas desde el navegador en macOS pueden requerir xattr -d com.apple.quarantine rnl. Linux arm64 requiere por ahora compilar desde el código fuente. Consulta la guía de la CLI para ver los comandos de descarga, extracción y suma de comprobación.

05 · Exportación desde Virtuoso

Exporta esquemas de Virtuoso a RNL

rnl-virtuoso añade RNL → Export RNL... al editor de esquemas de Virtuoso y File → Export → RNL... a la ventana CIW. Exporta una celda o una biblioteca entera conservando la jerarquía, los símbolos de bloque personalizados, la colocación, la orientación, los cables y los buses, y dibuja utilizando los paquetes eda-symbol y eda-style.

rnl-virtuosoRepositorio

06 · Cadena de herramientas

La cadena de herramientas de RNL: leer, resolver, dibujar y editar

La cadena de herramientas mantiene separados en módulos independientes “comprender RNL” y “convertir la intención en coordenadas”: puedes ver un dibujo sin solucionador y resolver únicamente cuando hace falta. Lo que existe hoy: el entorno de ejecución, los adaptadores de anfitrión, el renderizador y la línea de comandos, los dos visores anteriores y una primera versión del solucionador, integrada en rnl solve y en el visor de escritorio. Elige una ruta de uso para ver cómo fluyen los datos; haz clic en un módulo para ver qué hace.

Entornos de aplicación Visor web · WebAssembly Visor de escritorio · Tauri 2 Navegadores móviles Los dos visores comparten una misma interfaz de usuario; el núcleo está escrito en Rust y se ejecuta de forma nativa en el escritorio y como WebAssembly en el navegador. El núcleo en WebAssembly también se publica en npm como @rich-netlist/runtime.

07 · Licencias

Código abierto, de uso libre

El código fuente de los visores y de todo el conjunto de herramientas de RNL es público en GitHub.

MIT

El código de los visores está bajo la licencia MIT: puedes usarlo, modificarlo y compartirlo libremente conservando el aviso de derechos de autor.

OFL-1.1

El texto de los dibujos se compone y dibuja con Noto Sans SC, copyright 2014-2021 Adobe, bajo la SIL Open Font License 1.1. El núcleo incorpora las métricas de las fuentes, el visor de escritorio incluye las fuentes en su interior y el visor web carga lo que necesita cada dibujo (decisión 0009).

Código fuente

En GitHub: el visor web está en apps/web, el visor de escritorio en apps/desktop, la página que comparten en apps/viewer-ui y el núcleo en crates. Los cambios de cada versión se detallan en sus notas de la versión.