prod/doc/: added marked-up layout to indicate CLKM/CLK test points

- atben.fig, atusb.fig: layout images overlaid by markup
- Makefile: added images derived from atben.fig and atusb.fig
- Makefile: added generation of the layout images atben.fig and
  atusb.fig are based on
- analysis.html: show measurement locations for CLKM and CLK

prod/doc/Makefile

@@ -1,4 +1,6 @@
-PNGS=flow.png setup-A.png setup-B.png setup-C.png setup-D.png
+PNGS=flow.png setup-A.png setup-B.png setup-C.png setup-D.png \
+     atben-A.png atusb-A.png \
+     atben-A-small.png atusb-A-small.png
 HTMLS=index.html setup.html flash.html test.html analysis.html
 JPGS=atusb-programming.jpg atrf-path.png atrf-path-small.png
 
@@ -17,6 +19,28 @@ setup-%.png:	setup.fig
 		    fig2dev -L png -m 0.7 -S 4 >$@ || \
 		    { rm -f $@; exit 1; }
 
+atben-%-small.png: \
+		  atben.fig
+		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
+		    fig2dev -L png -m 0.5 -S 4 >$@ || \
+		    { rm -f $@; exit 1; }
+
+atben-%.png:	atben.fig
+		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
+		    fig2dev -L png -m 2 -S 4 >$@ || \
+		    { rm -f $@; exit 1; }
+
+atusb-%-small.png: \
+		  atusb.fig
+		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
+		    fig2dev -L png -m 0.5 -S 4 >$@ || \
+		    { rm -f $@; exit 1; }
+
+atusb-%.png:	atusb.fig
+		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
+		    fig2dev -L png -m 2 -S 4 >$@ || \
+		    { rm -f $@; exit 1; }
+
 atusb-programming.jpg:
 		wget $(DL)/atusb-programming.jpg
 
@@ -27,6 +51,10 @@ atrf-path-small.png: \
 		  atrf-path.png
 		convert -scale 50% $< $@
 
+%-front.png:
+		$(MAKE) -C ../../$* $@
+		mv ../../$*/$@ .
+
 upload:		$(HTMLS) $(PNGS) $(JPGS)
 		rsync -e ssh $^ \
 		    www-data@downloads.qi-hardware.com:werner/wpan/prod/

prod/doc/analysis.html

@@ -104,7 +104,6 @@ requires an accuracy of +/− 2500 ppm.
 We can therefore consider all results within a range of +/− 1000 ppm as
 sufficient, and perform more precise measurements by other means. This
 applies to <B>atben</B> as well as to <B>atusb</B>.
-<P>
 
 
 <!-- ---------------------------------------------------------------------- -->
@@ -120,6 +119,10 @@ atrf-txrx -d net:ben -C 1
 This configures <B>atben</B> as a promiscuous receiver. The reception
 of any IEEE 802.15.4 frame or pressing Ctrl-C will terminate the command.
 <P>
+The clock signal (CLKM) is available on the test pad shown here:
+<P>
+<A href="atben-A.png"><IMG src="atben-A-small.png"></A>
+<P>
 <TABLE frame="border" cellpadding="2">
 <TR><TH align="left">Clock<TH align="left">Action
 <TR><TD>0 Hz<TD>Check voltages; check that the clock is enabled;
@@ -142,6 +145,12 @@ the transceiver generates a 1 MHz clock. When the microcontrolled comes out
 of reset, it raises the transceiver's clock output to 8 MHz and then
 enables USB.
 <P>
+The clock signal is available at the terminals of several components,
+either as the direct output from the transceiver (CLKM) or after passing
+a low-pass filter (CLK):
+<P>
+<A href="atusb-A.png"><IMG src="atusb-A-small.png"></A>
+<P>
 <TABLE frame="border" cellpadding="2">
 <TR><TH align="left">Clock<TH align="left">Action
 <TR><TD>0 Hz<TD>Check voltages; check for shorts around crystal; check

prod/doc/atben.fig

@@ -0,0 +1,24 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+2 5 0 1 0 -1 100 -1 -1 0.000 0 0 -1 0 0 5
+	0 atben-front.png
+	 2475 2475 8790 2475 8790 7161 2475 7161 2475 2475
+# A
+2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 1980 4050 2745 4185
+# A
+2 1 0 3 4 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 1935 4545 2925 4365
+# A
+4 2 0 50 -1 18 24 0.0000 4 300 915 1890 4140 GND\001
+# A
+4 2 4 50 -1 18 24 0.0000 4 300 1200 1890 4725 CLKM\001

prod/doc/atusb.fig

@@ -0,0 +1,48 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+2 5 0 1 0 -1 100 -1 20 0.000 0 0 -1 0 0 5
+	0 atusb-front.png
+	 6975 2925 9875 2925 9875 9625 6975 9625 6975 2925
+# A
+2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 6615 6255 7650 6390
+# A
+2 1 0 3 4 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 6570 6795 7605 6570
+# A
+2 1 0 3 4 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 6750 7650 8010 6750
+# A
+2 1 0 3 4 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 10260 7875 8820 7740
+# A
+2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 10305 7380 9540 7605
+# A
+2 1 0 3 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 3.00 60.00 120.00
+	 6660 8550 7335 8235
+# A
+4 2 4 50 -1 18 24 0.0000 4 300 855 6525 6975 CLK\001
+# A
+4 2 0 50 -1 18 24 0.0000 4 300 915 6525 6345 GND\001
+# A
+4 2 4 50 -1 18 24 0.0000 4 300 1200 6795 8055 CLKM\001
+# A
+4 0 0 50 -1 18 24 0.0000 4 300 915 10350 7425 GND\001
+# A
+4 0 4 50 -1 18 24 0.0000 4 300 855 10350 8010 CLK\001
+# A
+4 2 0 50 -1 18 24 0.0000 4 300 915 6570 8820 GND\001