From 507e6c33dea0d9547309edc9c52e7c17ecd974c3 Mon Sep 17 00:00:00 2001
From: Werner Almesberger <werner@openmoko.org>
Date: Wed, 23 Mar 2011 04:47:21 -0300
Subject: [PATCH] added project-specific footprint reference for SMT fab

- makefiles/Makefile.kicad: added generation of a footprint reference
- atben/README-SMT, atusb/README-SMT: added footprint reference, with
  explanation
---
 atben/README-SMT         | 4 +++-
 atusb/README-SMT         | 4 +++-
 makefiles/Makefile.kicad | 9 +++++++--
 3 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/atben/README-SMT b/atben/README-SMT
index 76332c3..5439c7a 100644
--- a/atben/README-SMT
+++ b/atben/README-SMT
@@ -12,7 +12,7 @@ Design files:
 atben-front.png		Illustration of the PCB's front side (with silk screen)
 atben-bom.csv		Bill of materials
 atben-pos.csv		Automatic insertion file
-* footprints
+atben-footprints.pdf	Footprint reference
 
 The PCB design files (Gerbers, etc.) are in a separate archive, atben-pcb-*
 
@@ -22,3 +22,5 @@ Interpretation of files:
 - for all coordinates, the origin is the lower left corner of the board
 - coordinates in atben-pos.csv are in inches
 - rotation in atben-pos.csv is in degrees, counter-clockwise
+- in the footprint reference, footprints are shown in the 0 degree
+  orientation and with their center at the crosshairs
diff --git a/atusb/README-SMT b/atusb/README-SMT
index 4c40456..75309c6 100644
--- a/atusb/README-SMT
+++ b/atusb/README-SMT
@@ -14,7 +14,7 @@ Design files:
 atusb-front.png		Illustration of the PCB's front side (with silk screen)
 atusb-bom.csv		Bill of materials
 atusb-pos.csv		Automatic insertion file
-* footprints
+atusb-footprints.pdf	Footprint reference
 
 The PCB design files (Gerbers, etc.) are in a separate archive, atusb-pcb-*
 
@@ -24,3 +24,5 @@ Interpretation of files:
 - for all coordinates, the origin is the lower left corner of the board
 - coordinates in atusb-pos.csv are in inches
 - rotation in atusb-pos.csv is in degrees, counter-clockwise
+- in the footprint reference, footprints are shown in the 0 degree
+  orientation and with their center at the crosshairs
diff --git a/makefiles/Makefile.kicad b/makefiles/Makefile.kicad
index c9e22cf..52d9165 100644
--- a/makefiles/Makefile.kicad
+++ b/makefiles/Makefile.kicad
@@ -23,6 +23,7 @@ CPTX = ../../eda-tools/mlztx/cptx
 GMERGE = ../../eda-tools/fab/gmerge
 PRETTYGERBV = ../../eda-tools/fab/prettygerbv
 POS2FAB = ../../eda-tools/fab/pos2fab
+FPDOC = PATH=$$PATH:../../eda-tools/fab:../../eda-tools/fpd2pdf fpdoc
 
 DIR = $(shell pwd | sed 's|.*/||')
 
@@ -84,7 +85,8 @@ GERBERS = $(NAME)-SilkS_Front.gto $(NAME)-Mask_Front.gts \
 PCB_FILES = README-PCB $(NAME)-front.png $(NAME)-back.png \
 	    $(NAME)-PCB_Edges.dxf $(NAME).drl $(GERBERS)
 
-SMT_FILES = README-SMT $(NAME)-front.png $(NAME)-bom.csv $(NAME)-pos.csv
+SMT_FILES = README-SMT $(NAME)-front.png $(NAME)-bom.csv $(NAME)-pos.csv \
+	    $(NAME)-footprints.pdf
 
 gerber:		$(GERBERS)
 
@@ -129,6 +131,9 @@ $(NAME)-pos.csv: $(NAME)Front.pos $(NAME).cmp
 $(NAME)-bom.csv: ../bom/$(NAME)-bom.csv
 		mv $< $@
 
+$(NAME)-footprints.pdf: $(NAME).pro $(NAME).cmp $(NAME)Front.pos
+		$(FPDOC) $(NAME).pro "$@" || { rm -f "$@"; exit 1; }
+
 fab-smt:	$(SMT_FILES)
 		mkdir -p fab
 		tar Ccfz .. fab/$(NAME)-smt-$(VERSION).tar.gz \
@@ -167,7 +172,7 @@ clean::
 		rm -f $(NAME)-Comments.gbr $(NAME)-Drawings.gbr
 		rm -f $(NAME)-overview.png $(NAME)-front.png $(NAME)-back.png
 		rm -f $(NAME)Front.pos $(NAME)-pos.csv
-		rm -f $(NAME)-bom.csv
+		rm -f $(NAME)-bom.csv $(NAME)-footprints.pdf
 
 spotless::	clean
 		rm -f '$$'savepcb.000 '$$'savepcb.brd