prod/doc/: completed section on component orientation (with pictures)

prod/doc/Makefile

@@ -4,8 +4,10 @@ GENERATED=index.html setup.html flash.html test.html analysis.html \
 	  atben-A.png atusb-A.png atben-B.png atusb-B.png \
 	  atben-A-small.png atusb-A-small.png \
 	  atben-B-small.png atusb-B-small.png \
-	  atrf-path-small.png
+	  atrf-path-small.png \
-ORIGINAL=scope-atben-clkm.png scope-atusb-clkm.png scope-atusb-clk.png
+	  atben-compor.png atusb-compor.png
+ORIGINAL=scope-atben-clkm.png scope-atusb-clkm.png scope-atusb-clk.png \
+         atben-compor.jpg atusb-compor.jpg
 
 DL=http://downloads.qi-hardware.com/people/werner/wpan/tmp
 
@@ -36,6 +38,10 @@ atben-%-small.png: \
 		    fig2dev -L png -m 0.5 -S 4 >$@ || \
 		    { rm -f $@; exit 1; }
 
+atben-compor.png: \
+		  atben-compor.fig
+		fig2dev -L png -m 0.25 -S 4 $< >$@ || { rm -f $@; exit 1; }
+
 atben-%.png:	atben.fig
 		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
 		    fig2dev -L png -m 2 -S 4 >$@ || \
@@ -47,6 +53,10 @@ atusb-%-small.png: \
 		    fig2dev -L png -m 0.5 -S 4 >$@ || \
 		    { rm -f $@; exit 1; }
 
+atusb-compor.png: \
+		  atusb-compor.fig
+		fig2dev -L png -m 0.25 -S 4 $< >$@ || { rm -f $@; exit 1; }
+
 atusb-%.png:	atusb.fig
 		./figfilt `echo $@ | tr -cd 'A-Z'` $< | \
 		    fig2dev -L png -m 2 -S 4 >$@ || \

prod/doc/analysis.hmac

@@ -24,7 +24,50 @@
 
 <SECTION ref="orientation" title="Component orientation">
 
-@@@
+There are several components whose footprint has a 180&deg; or even 90&deg; 
+rotational symmetry, but the component's electrical function is not symmetric.
+Therefore, if such a component is incorrectly rotated, it will appear to the
+casual observer to be properly placed, but it will not work.
+<P>
+These components are:
+<UL>
+  <LI>the transceiver chip,
+  <LI>the microcontroller (<B>atusb</B> only),
+  <LI>the balun, and
+  <LI>the LED (<B>atusb</B> only)
+</UL>
+
+
+<!-- ---------------------------------------------------------------------- -->
+
+
+<SUBSECTION title="atben components">
+
+<B>atben</B> only has the transceiver and the balun. The markings on
+both face towards the crystal and the antenna:
+<P>
+<A href="atben-compor.jpg"><IMG src="atben-compor.png"></A>
+<P>
+The corner next to pin 1 of the transceiver is marked with small dot.
+The picture above also shows the orientation of the text printed on
+the package. The balun is marked with a square between pins 1 and 6.
+
+
+<!-- ---------------------------------------------------------------------- -->
+
+
+<SUBSECTION title="atusb components">
+
+In <B>atusb</B>, the marking on the transceiver is on the corner between
+the crystal and the antenna. The marking on the balun faces towards the
+antenna. The microcontroller's "top" side faces towards the USB connector.
+<P>
+<A href="atusb-compor.jpg"><IMG src="atusb-compor.png"></A>
+<P>
+It is difficult to determine the LED's orientation by visual inspection.
+An efficient approach is to touch the LED's terminals with the probes
+of a multimeter set to measure resistance. The small current used for
+the measurement will light the LED.
 
 
 <!-- ====================================================================== -->

prod/doc/atben-compor.fig

@@ -0,0 +1,15 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+1 3 0 8 4 7 45 -1 -1 0.000 1 0.0000 5895 3240 407 407 5895 3240 6302 3240
+1 3 0 8 4 7 45 -1 -1 0.000 1 0.0000 4185 4365 405 405 4185 4365 4590 4365
+2 5 0 1 0 -1 50 -1 -1 0.000 0 0 -1 0 0 5
+	0 atben-compor.jpg
+	 405 1665 11377 1665 11377 8094 405 8094 405 1665
+4 1 4 45 -1 18 64 4.7124 4 780 2760 2700 5625 TEXT\001

prod/doc/atusb-compor.fig

@@ -0,0 +1,21 @@
+#FIG 3.2  Produced by xfig version 3.2.5b
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+1 3 0 8 4 7 45 -1 -1 0.000 1 0.0000 2295 5670 405 405 2295 5670 2700 5670
+1 3 0 8 4 7 45 -1 -1 0.000 1 0.0000 9090 6120 405 405 9090 6120 9495 6120
+1 3 0 8 4 7 45 -1 -1 0.000 1 0.0000 11925 5265 405 405 11925 5265 12330 5265
+2 5 0 1 0 -1 50 -1 20 0.000 0 0 -1 0 0 5
+	0 atusb-compor.jpg
+	 135 90 14022 90 14022 9548 135 9548 135 90
+2 3 0 4 7 0 45 -1 20 0.000 1 0 -1 0 0 4
+	 9000 1035 8100 585 8100 1485 9000 1035
+2 3 0 4 7 4 45 -1 20 0.000 1 0 -1 0 0 4
+	 9945 1035 10845 585 10845 1485 9945 1035
+4 1 4 45 -1 18 64 3.1416 4 780 2760 8055 4725 TEXT\001
+4 1 4 45 -1 18 64 1.5708 4 780 2760 3825 4590 TEXT\001