Skip to content
GPL Electronic Design Automation
C Scheme Makefile Perl Shell Roff Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attrib attrib: Update --help output. Jun 4, 2019
build-tools build-tools: Fix unportable sed command. Jan 11, 2019
cli
contrib contrib: Fix distribution. May 29, 2019
docs liblepton: Fix Scheme API for arcs. Jun 9, 2019
examples scripts: Do not hardcode interpreters' paths. Apr 24, 2018
liblepton schematic: Deprecate window-size option. Jul 12, 2019
libleptonrenderer libleptonrenderer: Change default font name. May 29, 2019
m4 build: Rename --disable-gattrib configure switch. May 19, 2019
netlist vams: Add a comment for default-generic-value?(). Sep 4, 2019
schematic schematic: Fix clang++ warnings. Jul 21, 2019
symbols symbols: Install vhdl into separate directory. Jun 4, 2019
symcheck symcheck: Don't use error() if no files specified on command line. Jul 30, 2019
utils utils/sch2pcb: Update program name in its output. Jun 4, 2019
.dir-locals.el Add .dir-locals.el file for Emacs. Aug 6, 2016
.gitignore Add "tags" to .gitignore Apr 5, 2014
.travis.yml
AUTHORS Update AUTHORS. Nov 15, 2018
CODE_OF_CONDUCT.md docs: Fix typos in code of conduct Feb 19, 2017
CONTRIBUTING.md Add a note about code indentation to CONTRIBUTING. May 5, 2019
COPYING extension: Scaffold autotools-powered Python extension Dec 15, 2013
COPYING.LGPL Distribute a copy of the LGPL v2.1. Jan 12, 2011
Makefile.am build: Rename --disable-gattrib configure switch. May 19, 2019
NEWS.md Update NEWS with info on #450. Aug 7, 2019
README.md README: Update copyright years. Jan 30, 2019
autogen.sh rename: Rename gschem/ to schematic/. May 2, 2017
configure.ac schematic: Remove deprecated export scripts. Jun 8, 2019
version.h.in

README.md

Lepton Electronic Design Automation

Copyright (C) 1998-2017 gEDA Developers. Copyright (C) 2017-2019 Lepton Developers.

Introduction

The GPL Electronic Design Automation (gEDA) project has produced and continues working on a full GPL'd suite and toolkit of Electronic Design Automation tools. These tools are used for electrical circuit design, schematic capture, simulation, prototyping, and production. Currently, the gEDA project offers a mature suite of free software applications for electronics design, including schematic capture, attribute management, bill of materials (BOM) generation, netlisting into over 30 netlist formats, analog and digital simulation, and printed circuit board (PCB) layout.

The gEDA project was started because of the lack of free EDA tools for POSIX systems with the primary purpose of advancing the state of free hardware or open source hardware. The suite is mainly being developed on the GNU/Linux platform with some development effort going into making sure the tools run on other platforms as well.

The Lepton EDA suite (this package) provides schematic capture, netlisting, bill of materials generation, and many other features. It was forked from the gEDA/gaf suite in late 2016.

Tools in the Lepton EDA suite

The major components of the Lepton suite are:

  • liblepton

    • A library of functions for manipulating Lepton schematics and symbols.
  • lepton-schematic

    • A schematic editor.
  • lepton-attrib

    • A spreadsheet-like program for bulk editing of component attributes.
  • lepton-netlist

    • A highly-flexible, hierarchy-aware utility which parses schematics to generate a number of outputs, including netlists for a wide variety of PCB layout tools. It can also generate bills of materials and DRC reports for your schematics.
  • lepton-sch2pcb

  • lepton-symcheck

    • A utility for checking for common errors in schematic symbol files.
  • lepton-cli

    • A utility for interactive and batch mode working with Lepton EDA Scheme API, exporting schematics into various formats, and configuring all the programs of the suite.

Installation

The information in this section is intended to supplement the information in the INSTALL file.

Dependencies

In order to compile gEDA from the distributed source archives, you must have the following tools and libraries installed:

The following tools and libraries are highly recommended:

The following tools and libraries are optional:

  • libstroke, a stroke and gesture recognition library. If this is available, lepton-schematic will support mouse gesture recognition. http://www.etla.net/libstroke/

  • The doxygen API documentation tool. This is required for building the gEDA developer API documentation, not for the regular user documentation. http://www.doxygen.nl

  • 'Inkscape' or 'ImageMagick' for svg to png or pdf conversion This is required for building the gEDA developer API documentation, not for the regular user documentation. http://inkscape.org/ http://www.imagemagick.org/script/index.php

  • 'Graphviz' for drawing directed graphs. This is required for building the gEDA developer API documentation, not for the regular user documentation. http://www.graphviz.org/

Troubleshooting dependencies

"I've installed the libfoo library, but ./configure isn't picking it up!"

Many modern operating system distributions split a library into two packages:

  1. a libfoo package, which contains the files necessary to run programs which use libfoo.

  2. a libfoo-dev or libfoo-devel package, which contains the files necessary to compile programs which use libfoo.

If you're having problems, make sure that you have all of the necessary dev or devel packages installed.

"I have installed two versions of guile, but ./configure uses a wrong one!"

Specify right guile binary on the configure stage, e.g.:

./configure GUILE=/usr/bin/guile-2.0

Installation from a source archive

First extract the archive to a sensible place:

tar -xzvf lepton-eda-<version>.tar.gz && cd lepton-eda-<version>

Run the configuration script. You'll probably want to specify a custom directory to install gEDA to, for example:

./configure --prefix=$HOME/lepton

You can then compile Lepton:

make

And install it (if you used a --prefix outside your $HOME directory, you may need to run this as root):

make install

For more information on installing Lepton, see the INSTALL document.

Installation from the git repository

Lepton uses the git version control system. If you wish to try out the very latest version of Lepton, you will need to install some extra tools in addition to the ones listed above:

Once you have these installed, you need to clone the gEDA git repository:

git clone https://github.com/lepton-eda/lepton-eda.git

To generate the configure script, run:

./autogen.sh

You can then proceed to configure and build Lepton as described above.

Building Lepton developer API documentation

Several of the Lepton libraries and applications have doxygen API documentation available. To generate the API documentation from the source code, install doxygen (see Dependencies above. Next, add --enable-doxygen to your configure command line, i.e.:

./configure --enable-doxygen

To compile the documentation (quite a slow process), run:

make doxygen

The documentation can then be found in:

*/docs/html/index.html

Getting help

There are several ways to get help with installing and using Lepton and the rest of the gEDA tools:

  • Chat with Lepton developers and users at gitter.im. You can sign in there using your Twitter, GitHub or GitLab account (no registration is required to read the messages posted there). This is probably the fastest way to get in touch with us.

  • The gEDA website http://www.geda-project.org has more extensive information on the gEDA tools, and links to some successful projects which use gEDA.

  • The gEDA documentation wiki contains a large amount of helpful information. A static copy is included with this distribution; see the docs/wiki/index.html file. The wiki is accessible online at http://wiki.geda-project.org/.

  • If the resources above didn't help you resolve your problem, or you are having a design problem that you want to get help with, consider subscribing to and posting your question to the geda-user mailing list (http://wiki.geda-project.org/geda:mailinglists). You can also browse and search the mailing list archives.

  • If you have discovered a bug, have a feature request, or have written a patch to Lepton, please create an item on the lepton-eda bug tracker page: https://github.com/lepton-eda/lepton-eda/issues

License

Lepton EDA (this package) is freely distributable under the GNU Public License (GPL) version 2.0 or (at your option) any later version. See the COPYING file for the full text of the license.

The programs and associated files are:

Copyright (C) 1998-2017 by Ales Hvezda and the respective original authors. Copyright (C) 2017-2019 Lepton Developers.

See the AUTHORS file for a more extensive list of contributors to Lepton EDA and gEDA.

You can’t perform that action at this time.