EDRC is a tool that helps you collaborate with confidence on Eagle CAD hardware designs. Eagle allows you to easily:
If you've ever used automated software build/test systems you'll feel right at home setting up EDRC.
To start with, you'll need to ensure that your board and schematic files are committed into a git repository and uploaded to Github. Check out our guide for using eagle with git and Github if you haven't already.
To start, your directory structure probably looks something like this:
my-project/ my-design.brd my-design.sch
You have your root directory which contains the Eagle .brd and .sch files. You might have other files in your repository - that's fine, they won't cause problems. If your .brd and .sch files are not in your root directory that's fine too - just remember to adjust the paths below as needed.
You configure EDRC by placing an
edrc.yml file in the root of your project. This file will tell EDRC what files to process, and what design rules to use.
To start, create
edrc.yml in the root of your project, leaving your directory structure like this:
my-project/ edrc.yml my-design.brd my-design.sch
edrc.yml and add the following:
eagle: drc: - file: "my-design.brd"
This simple configuration file tells EDRC to run a design rule check (DRC) on the file
my-design.brd in the root of the project. If your files are in subdirectories add the relative path from the root of your project.
What we have is almost enough to commit and have EDRC process the file, but we haven't told EDRC what design rules to check against. Let's do that. For now, we're going to use the design rules for OSHPark.
EDRC maintains a list of the design rules for a number of PCB houses so there's a good chance that we already have the design rules you'll need. You can see the full list here.
edrc.yml and add the last line:
eagle: drc: - file: "my-design.brd" dru: "oshpark-2layer"
This will use the built-in OSHPark 2-layer design rules, which are configured to OSHPark's manufacturing capabilities.
Finish setting up EDRC by adding the
edrc.yml file to git:
git add edrc.yml git commit -m"Add EDRC configuration"
Once you have your
edrc.yml file inside your git repo and you have that pushed to Github you're ready to setup EDRC to automatically process your designs when you make a change.
Step 1: Start by going to EDRC and signing in with your Github account.
Step 2: Once you're signed in, click the "Add Project" button.
Step 3: Select your project in the list of projects from Github.
And that's it! Sit back and relax as EDRC queues and runs your design rule check.
Now that you've setup EDRC and had your first build run it's time to configure EDRC to do exactly what you want. Here's a few starting points: