From f5c46de802c330a75434e33d428aa7e4233f7be4 Mon Sep 17 00:00:00 2001 From: Werner Almesberger Date: Thu, 26 May 2011 19:42:57 -0300 Subject: [PATCH] prod/doc/test.html: added a decription of the tests --- prod/doc/Makefile | 9 ++- prod/doc/test.html | 158 ++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 164 insertions(+), 3 deletions(-) diff --git a/prod/doc/Makefile b/prod/doc/Makefile index ee1b09b..36155c7 100644 --- a/prod/doc/Makefile +++ b/prod/doc/Makefile @@ -1,6 +1,6 @@ PNGS=flow.png setup-A.png setup-B.png setup-C.png setup-D.png HTMLS=index.html setup.html flash.html test.html analysis.html -JPGS=atusb-programming.jpg +JPGS=atusb-programming.jpg atrf-path.png atrf-path-small.png .PHONY: all upload clean @@ -17,6 +17,13 @@ setup-%.png: setup.fig atusb-programming.jpg: wget http://downloads.qi-hardware.com/people/werner/wpan/tmp/atusb-programming.jpg +atrf-path.png: + wget http://downloads.qi-hardware.com/people/werner/wpan/tmp/atrf-path.png + +atrf-path-small.png: \ + atrf-path.png + convert -scale 50% $< $@ + upload: $(HTMLS) $(PNGS) $(JPGS) rsync -e ssh $^ \ www-data@downloads.qi-hardware.com:werner/wpan/prod/ diff --git a/prod/doc/test.html b/prod/doc/test.html index 95b25a5..f50ab8e 100644 --- a/prod/doc/test.html +++ b/prod/doc/test.html @@ -5,11 +5,12 @@ -

Test setup for atben

+To test an atben board, place a reference atusb board into +the PC, insert the

@@ -30,6 +31,159 @@

Test procedure

+The test process is started with +
+make ben
+
+for an atben DUT and with +
+make usb
+
+for an atusb DUT. It performs the following steps: + + +Of these tests, only "LED" and "Spectrum" require operator input. The +other tests run without interaction. +

+The test scripts log the commands they execute and their output in the +file _log. + + + + + +

Enumeration (atusb only)

+ +The enumeration test verifies that the atusb board has been +identified by the PC's USB stack. If this test fails, the board may +not be plugged in correctly or it may be missing the firmware. A +board that has passed both stages of the firmware flashing process +should always pass the enumeration test. + + + + + +

LED (atusb only)

+ +@@@ + + + + + +

GPIO scan

+ +@@@ + + + + + +

Identification

+ +This test reads the transceiver's registers that contain values identifying +the manufacturer, the chip's part number, and the chip revision. If an +atusb board fails this test, this probably means that the MISO signal +between transceiver and the microcontroller has a problem. +

+On atben, failure may simply indicate an improperly +inserted board. Eject the board, re-insert, and try again. If the test +keeps on failing, this may indicate a problem with MOSI, MISO, nSEL, +SCLK, the power supply, the crystal oscillator, or possibly the position +of the transceiver chip. +

+Note: this test is meant as a higher level test. The GPIO test should +eventually provide more detailed results for problems with the SPI interface. + + + + + +

Crystal frequency (atben only)

+ +This test measures the frequency of the crystal oscillator in the DUT. +On atben, it does this by transmitting packets, and measuring +the time between the SLP_TR pulse that starts the transmission and the +interrupt signaling the end of the transmission. +

+If this test fails, this may indicate that the load capacitors of the +crystal are missing, badly soldered, or have the wrong value. It could +also mean that the crystal itself is defective. Another possible cause +of oscillator malfunction could be flux residues bridging traces. +

+The fault analysis page has more details on +testing the crystal oscillator. + + + + + +

Spectrum

+ +The spectrum test measures the reception of a signal sent from the +reference device to the DUT. It does this across the entire frequency +range in which the WPAN boards operate, allowing the detection of +frequency-dependent anomalies. +

+This test depends on numerous external factors, like the exact position +and orientation of the two devices with respect to each other, and the +presence of any items that can reflect or absorb RF signals. Such items +include metal chairs and human bodies. Because of the test's sensitivity +to environmental factors, the operator needs to decide when the result +represents a valid measurement and then confirm the result shown. +

+The image below shows the typical display during the spectrum test: +the white line is the measured signal strength. The red lines indicate +the minimum and maximum allowed values. The green circle in the upper +right corner indicates that the signal strength is within the limits. +A downward-pointing red triangle would indicate that the signal is too +weak, an upward-pointing yellow triangle would indicate that the signal +is too strong. +

+ +

+To finish the test, the operator must type either P, F, +or Q in the window shown. P means "pass" and can only be +entered if the measurement is within the limits. F means "fail" +and can only be entered if the measurements is outside the limits. +Q, quit, can be entered at any time and also fails the test. + + + + + +

Receive

+ +In the receive test, the reference device sends a number of frames to the +DUT. The test program verifies correct reception of all the frames. A +device that has passed all the preceding tests should not encounter +problems in the receive test. If it does, there may be a problem with +the bypassing of the transceiver's 1.8 V supplies. + + + + + +

Send

+ +The send test is like the receive test, but with the DUT acting as the +sender and the reference acting as the receiver. If a device passes the +receive test but fails the send test, there is probably an issue with +the bypass capacitors of the analog 1.8 V supply. +

+Another possible cause could a problem with the SLP_TR signal. The +GPIO test should eventually catch this issue, but it may currently +remain undetected until the send test.

@@ -37,7 +191,7 @@ Up: Production and testing  Prev: Flashing (atusb only)  Next: Fault analysis 
-Last update: 2011-05-18  Werner Almesberger +Last update: 2011-05-26  Werner Almesberger