qi-hardware/ben-wpan
1
0
Fork 0
mirror of git://projects.qi-hardware.com/ben-wpan.git synced 2024-11-26 00:18:27 +02:00
Code

prod/doc/: converted setup.html, flash.html, and test.html to hmac

Browse Source
This commit is contained in:
Werner Almesberger 2011-05-27 07:02:41 -03:00
parent 9ab082432b
commit 8a70d4b2f3
3 changed files with 91 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
prod/doc/flash.html → prod/doc/flash.hmac
View File

@ -1,7 +1,22 @@
<TITLE>Production and testing: Flashing</TITLE> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<BODY>
<HTML> <HTML>
<H1>Production and testing: Flashing</H1> <TITLE>Production and testing: Flashing</TITLE>
<BODY bgcolor="#ffffff" link="#000000" vlink="#404040">
<INCLUDE file="style.inc">
<PAGE_BAR title="Production and testing">
<PAGE_ITEM href="setup.html">Software setup</PAGE_ITEM>
<PAGE_CURR href="flash.html">Flashing</PAGE_CURR>
<PAGE_ITEM href="test.html">Functional test</PAGE_ITEM>
<PAGE_ITEM href="analysis.html">Fault analysis</PAGE_ITEM>
</PAGE_BAR>
<SECTION_BAR>
<SECTION_ITEM href="#boot">Boot loader</SECTION_ITEM>
<SECTION_ITEM href="#app">Application</SECTION_ITEM>
</SECTION_BAR>
<P>
The microcontroller of <B>atusb</B> contains firmware that must be The microcontroller of <B>atusb</B> contains firmware that must be
loaded before the testing process can commence. The firmware consists loaded before the testing process can commence. The firmware consists
@ -18,7 +33,7 @@ any flashing.
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Flashing the boot loader</H2> <SECTION ref="boot" title="Flashing the boot loader">
The following image shows the setup for flashing the boot loader: The following image shows the setup for flashing the boot loader:
<P> <P>
@ -51,7 +66,7 @@ If flashing fails despite numerous attempts, proceed to the
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Flashing the application</H2> <SECTION ref="app" title="Flashing the application">
The flashing script proceeds automatically to the flashing of the The flashing script proceeds automatically to the flashing of the
application. All you need to do is insert the <B>atusb</B> board application. All you need to do is insert the <B>atusb</B> board
@ -69,11 +84,7 @@ If the board fails to enumerate, proceed with the
<P> <P>
<HR> <HR>
Up: <A href="index.html">Production and testing</A>&nbsp; Last update: 2011-05-27&nbsp;&nbsp;<I>Werner Almesberger</I>
Prev: <A href="setup.html">Software setup</A>
Next: <A href="test.html">Functional test</A>&nbsp;
<HR>
Last update: 2011-05-26&nbsp;&nbsp;<I>Werner Almesberger</I>
<HR> <HR>
</BODY> </BODY>
</HTML> </HTML>

65
prod/doc/setup.html → prod/doc/setup.hmac
View File

@ -1,7 +1,25 @@
<TITLE>Production and testing: Software setup</TITLE> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<BODY>
<HTML> <HTML>
<H1>Production and testing: Software setup</H1> <TITLE>Production and testing: Software setup</TITLE>
<BODY bgcolor="#ffffff" link="#000000" vlink="#404040">
<INCLUDE file="style.inc">
<PAGE_BAR title="Production and testing">
<PAGE_CURR href="setup.html">Software setup</PAGE_CURR>
<PAGE_ITEM href="flash.html">Flashing</PAGE_ITEM>
<PAGE_ITEM href="test.html">Functional test</PAGE_ITEM>
<PAGE_ITEM href="analysis.html">Fault analysis</PAGE_ITEM>
</PAGE_BAR>
<SECTION_BAR>
<SECTION_ITEM href="#pcsw">PC software</SECTION_ITEM>
<SECTION_ITEM href="#bensw">Ben software</SECTION_ITEM>
<SECTION_ITEM href="#bensys">Ben system</SECTION_ITEM>
<SECTION_ITEM href="#profiles">Test profiles</SECTION_ITEM>
</SECTION_BAR>
<P>
Before performing any production tests, various pieces of software Before performing any production tests, various pieces of software
need to be installed on Ben and PC, and configuration settings need to be installed on Ben and PC, and configuration settings
@ -11,7 +29,7 @@ need to be installed on Ben and PC, and configuration settings
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>PC software installation</H2> <SECTION ref="pcsw" title="PC software installation">
@@@ @@@
@ -19,7 +37,7 @@ need to be installed on Ben and PC, and configuration settings
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install ben-wpan tools</H3> <SUBSECTION title="Install ben-wpan tools">
@@@ @@@
@ -27,7 +45,7 @@ need to be installed on Ben and PC, and configuration settings
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install test scripts</H3> <SUBSECTION title="Install test scripts">
@@@ @@@
@ -35,7 +53,7 @@ need to be installed on Ben and PC, and configuration settings
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install firmware binary</H3> <SUBSECTION title="Install firmware binary">
The binary of the application running on <B>atusb</B> is transferred from The binary of the application running on <B>atusb</B> is transferred from
the PC. To download a pre-compiled version, use this command: the PC. To download a pre-compiled version, use this command:
@ -52,7 +70,7 @@ Instructions for building the binary from sources are
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Register Ben host name</H3> <SUBSECTION title="Register Ben host name">
To simplify accessing the Ben via TCP/IP, its IP address should be To simplify accessing the Ben via TCP/IP, its IP address should be
registered in the hosts file on the PC. If the Ben is running OpenWrt, registered in the hosts file on the PC. If the Ben is running OpenWrt,
@ -78,7 +96,7 @@ echo 192.168.1.202 jlime >>/etc/hosts
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Customize test scripts</H3> <SUBSECTION title="Customize test scripts">
@@@ @@@
@ -86,7 +104,7 @@ echo 192.168.1.202 jlime >>/etc/hosts
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Ben software installation</H2> <SECTION ref="bensw" title="Ben software installation">
@@@ @@@
@ -94,7 +112,7 @@ echo 192.168.1.202 jlime >>/etc/hosts
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Password-less remote access</H3> <SUBSECTION title="Password-less remote access">
To enable password-less remote access from the PC, set up network To enable password-less remote access from the PC, set up network
access to the Ben and run the following command: access to the Ben and run the following command:
@ -106,7 +124,7 @@ ssh ben 'cat >>/etc/dropbear/authorized_keys' <~/.ssh/id_rsa.pub
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install ben-wpan tools</H3> <SUBSECTION title="Install ben-wpan tools">
@@@ @@@
@ -114,7 +132,7 @@ ssh ben 'cat >>/etc/dropbear/authorized_keys' <~/.ssh/id_rsa.pub
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install avrdude</H3> <SUBSECTION title="Install avrdude">
The <B>atusb</B> boot loader is flashed using <B>avrdude</B>. A pre-compiled The <B>atusb</B> boot loader is flashed using <B>avrdude</B>. A pre-compiled
static binary (suitable for OpenWrt and Jlime) can be installed by running static binary (suitable for OpenWrt and Jlime) can be installed by running
@ -134,7 +152,7 @@ Instructions for building <B>avrdude</B> from sources are
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Install boot-loader binary</H3> <SUBSECTION title="Install boot-loader binary">
The binary of the boot loader running on <B>atusb</B> is transferred from The binary of the boot loader running on <B>atusb</B> is transferred from
the Ben. To download a pre-compiled version, use this command: the Ben. To download a pre-compiled version, use this command:
@ -151,7 +169,7 @@ Instructions for building the binary from sources are
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Ben system setup</H2> <SECTION ref="bensys" title="Ben system setup">
The configuration setting described in this section are lost on each The configuration setting described in this section are lost on each
reset or reboot and either need to be entered again. Alternatively, reset or reboot and either need to be entered again. Alternatively,
@ -161,7 +179,7 @@ a setup script running at boot time can be written.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Enable network access</H3> <SUBSECTION title="Enable network access">
Once the Ben has booted and started USB networking, the interface Once the Ben has booted and started USB networking, the interface
on the PC side is configured as follows: on the PC side is configured as follows:
@ -179,7 +197,7 @@ ifconfig usb0 192.168.1.200 up
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Silence other 8:10 card users</H3> <SUBSECTION title="Silence other 8:10 card users">
Before running any of the ben-wpan utilities, other users of the 8:10 Before running any of the ben-wpan utilities, other users of the 8:10
card slot have to be disabled. In a Ben running the regular OpenWrt or card slot have to be disabled. In a Ben running the regular OpenWrt or
@ -199,7 +217,7 @@ echo spi2.0 >/sys/bus/spi/drivers/at86rf230/unbind
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Start atrf-proxy</H3> <SUBSECTION title="Start atrf-proxy">
On the Ben, launch the proxy daemon. We pass the option -b to background it: On the Ben, launch the proxy daemon. We pass the option -b to background it:
<PRE> <PRE>
@ -210,7 +228,7 @@ atrf-proxy -b
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Test profiles</H2> <SECTION ref="profiles" title="Test profiles">
Some of the functional tests measure characteristics that are strongly Some of the functional tests measure characteristics that are strongly
influenced by the test setup. It is therefore not possible to provide influenced by the test setup. It is therefore not possible to provide
@ -221,7 +239,7 @@ in the actual test environment.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Clock count (atben only)</H3> <SUBSECTION title="Clock count (atben only)">
Insert a known to be good <B>atben</B> board and run the following Insert a known to be good <B>atben</B> board and run the following
command directly on the Ben to record the reference value for the command directly on the Ben to record the reference value for the
@ -241,17 +259,14 @@ Ben, and if a stable temperature is maintained.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Signal strength</H3> <SUBSECTION title="Signal strength">
@@@ @@@
<P> <P>
<HR> <HR>
Up: <A href="index.html">Production and testing</A>&nbsp; Last update: 2011-05-27&nbsp;&nbsp;<I>Werner Almesberger</I>
Next: <A href="flash.html">Flashing (<B>atusb</B> only)</A>&nbsp;
<HR>
Last update: 2011-05-19&nbsp;&nbsp;<I>Werner Almesberger</I>
<HR> <HR>
</BODY> </BODY>
</HTML> </HTML>

49
prod/doc/test.html → prod/doc/test.hmac
View File

@ -1,13 +1,28 @@
<TITLE>Production and testing: Functional test</TITLE> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<BODY>
<HTML> <HTML>
<H1>Production and testing: Functional test</H1> <TITLE>Production and testing: Functional test</TITLE>
<BODY bgcolor="#ffffff" link="#000000" vlink="#404040">
<INCLUDE file="style.inc">
<PAGE_BAR title="Production and testing">
<PAGE_ITEM href="setup.html">Software setup</PAGE_ITEM>
<PAGE_ITEM href="flash.html">Flashing</PAGE_ITEM>
<PAGE_CURR href="test.html">Functional test</PAGE_CURR>
<PAGE_ITEM href="analysis.html">Fault analysis</PAGE_ITEM>
</PAGE_BAR>
<SECTION_BAR>
<SECTION_ITEM href="#atben">atben setup</SECTION_ITEM>
<SECTION_ITEM href="#atusb">atusb setup</SECTION_ITEM>
<SECTION_ITEM href="#procedure">Test procedure</SECTION_ITEM>
</SECTION_BAR>
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Test setup for atben</H2> <SECTION ref="atben" title="Test setup for atben">
To test an <B>atben</B> board, place a reference <B>atusb</B> board into To test an <B>atben</B> board, place a reference <B>atusb</B> board into
the PC, insert the the PC, insert the
@ -19,7 +34,7 @@ the PC, insert the
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Test setup for atusb</H2> <SECTION ref="atusb" title="Test setup for atusb">
<P> <P>
<IMG src="setup-B.png"> <IMG src="setup-B.png">
@ -29,7 +44,7 @@ the PC, insert the
<!-- ====================================================================== --> <!-- ====================================================================== -->
<H2>Test procedure</H2> <SECTION ref="procedure" title="Test procedure">
The test process is started with The test process is started with
<PRE> <PRE>
@ -61,7 +76,7 @@ file <B>_log</B>.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Enumeration (atusb only)</H3> <SUBSECTION title="Enumeration (atusb only)">
The enumeration test verifies that the <B>atusb</B> board has been The enumeration test verifies that the <B>atusb</B> board has been
identified by the PC's USB stack. If this test fails, the board may identified by the PC's USB stack. If this test fails, the board may
@ -73,7 +88,7 @@ should always pass the enumeration test.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>LED (atusb only)</H3> <SUBSECTION title="LED (atusb only)">
@@@ @@@
@ -81,7 +96,7 @@ should always pass the enumeration test.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>GPIO scan</H3> <SUBSECTION title="GPIO scan">
@@@ @@@
@ -89,7 +104,7 @@ should always pass the enumeration test.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Identification</H3> <SUBSECTION title="Identification">
This test reads the transceiver's registers that contain values identifying This test reads the transceiver's registers that contain values identifying
the manufacturer, the chip's part number, and the chip revision. If an the manufacturer, the chip's part number, and the chip revision. If an
@ -109,7 +124,7 @@ eventually provide more detailed results for problems with the SPI interface.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Crystal frequency (atben only)</H3> <SUBSECTION title="Crystal frequency (atben only)">
This test measures the frequency of the crystal oscillator in the DUT. This test measures the frequency of the crystal oscillator in the DUT.
On <B>atben</B>, it does this by transmitting packets, and measuring On <B>atben</B>, it does this by transmitting packets, and measuring
@ -128,7 +143,7 @@ testing the crystal oscillator.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Spectrum</H3> <SUBSECTION title="Spectrum">
The spectrum test measures the reception of a signal sent from the The spectrum test measures the reception of a signal sent from the
reference device to the DUT. It does this across the entire frequency reference device to the DUT. It does this across the entire frequency
@ -162,7 +177,7 @@ and can only be entered if the measurements is outside the limits.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Receive</H3> <SUBSECTION title="Receive">
In the receive test, the reference device sends a number of frames to the 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 DUT. The test program verifies correct reception of all the frames. A
@ -174,7 +189,7 @@ the bypassing of the transceiver's 1.8 V supplies.
<!-- ---------------------------------------------------------------------- --> <!-- ---------------------------------------------------------------------- -->
<H3>Send</H3> <SUBSECTION title="Send">
The send test is like the receive test, but with the DUT acting as the 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 sender and the reference acting as the receiver. If a device passes the
@ -187,11 +202,7 @@ remain undetected until the send test.
<P> <P>
<HR> <HR>
Up: <A href="index.html">Production and testing</A>&nbsp; Last update: 2011-05-27&nbsp;&nbsp;<I>Werner Almesberger</I>
Prev: <A href="flash.html">Flashing (<B>atusb</B> only)</A>&nbsp;
Next: <A href="analysis.html">Fault analysis</A>&nbsp;
<HR>
Last update: 2011-05-26&nbsp;&nbsp;<I>Werner Almesberger</I>
<HR> <HR>
</BODY> </BODY>
</HTML> </HTML>