mirror of
git://projects.qi-hardware.com/ben-wpan.git
synced 2025-04-21 12:27:27 +03:00
prod/doc/: converted setup.html, flash.html, and test.html to hmac
This commit is contained in:
Werner Almesberger
@@ -0,0 +1,272 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||||
<HTML>
|
||||
<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
|
||||
need to be installed on Ben and PC, and configuration settings
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ====================================================================== -->
|
||||
|
||||
|
||||
<SECTION ref="pcsw" title="PC software installation">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install ben-wpan tools">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install test scripts">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install firmware binary">
|
||||
|
||||
The binary of the application running on <B>atusb</B> is transferred from
|
||||
the PC. To download a pre-compiled version, use this command:
|
||||
|
||||
<PRE>
|
||||
wget -O atusb.bin \
|
||||
http://downloads.qi-hardware.com/people/werner/wpan/bindist/atusb-de72af351f661b538add81cbc9965278a2f8c40c.bin
|
||||
</PRE>
|
||||
|
||||
Instructions for building the binary from sources are
|
||||
<A href="http://projects.qi-hardware.com/index.php/p/ben-wpan/source/tree/master/atusb/fw/README">here</A>.
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Register Ben host name">
|
||||
|
||||
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,
|
||||
use the following command:
|
||||
<PRE>
|
||||
echo 192.168.254.101 ben >>/etc/hosts
|
||||
</PRE>
|
||||
<P>
|
||||
If the Ben is running Jlime, the address would be as follows:
|
||||
<PRE>
|
||||
echo 192.168.1.202 ben >>/etc/hosts
|
||||
</PRE>
|
||||
<P>
|
||||
If using the same PC with Bens running OpenWrt and Jlime, one may choose
|
||||
different host names depending on the distribution, and adapt the commands
|
||||
used in the production and testing process accordingly. For example,
|
||||
<PRE>
|
||||
echo 192.168.254.101 ben >>/etc/hosts
|
||||
echo 192.168.1.202 jlime >>/etc/hosts
|
||||
</PRE>
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Customize test scripts">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ====================================================================== -->
|
||||
|
||||
|
||||
<SECTION ref="bensw" title="Ben software installation">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Password-less remote access">
|
||||
|
||||
To enable password-less remote access from the PC, set up network
|
||||
access to the Ben and run the following command:
|
||||
<PRE>
|
||||
ssh ben 'cat >>/etc/dropbear/authorized_keys' <~/.ssh/id_rsa.pub
|
||||
</PRE>
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install ben-wpan tools">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install avrdude">
|
||||
|
||||
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
|
||||
the following two command on the Ben:
|
||||
|
||||
<PRE>
|
||||
wget http://downloads.qi-hardware.com/people/werner/wpan/bindist/avrdude-5.10-de72af351f661b538add81cbc9965278a2f8c40c.tar.gz
|
||||
tar -xz -C / -f avrdude-5.10-de72af351f661b538add81cbc9965278a2f8c40c.tar.gz
|
||||
</PRE>
|
||||
|
||||
Instructions for building <B>avrdude</B> from sources are
|
||||
<A href="http://projects.qi-hardware.com/index.php/p/ben-blinkenlights/source/tree/master/avrdude/README
|
||||
">here</A>.
|
||||
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Install boot-loader binary">
|
||||
|
||||
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:
|
||||
|
||||
<PRE>
|
||||
wget -O boot.hex \
|
||||
http://downloads.qi-hardware.com/people/werner/wpan/bindist/boot-de72af351f661b538add81cbc9965278a2f8c40c.hex
|
||||
</PRE>
|
||||
|
||||
Instructions for building the binary from sources are
|
||||
<A href="http://projects.qi-hardware.com/index.php/p/ben-wpan/source/tree/master/atusb/fw/README">here</A>.
|
||||
|
||||
|
||||
<!-- ====================================================================== -->
|
||||
|
||||
|
||||
<SECTION ref="bensys" title="Ben system setup">
|
||||
|
||||
The configuration setting described in this section are lost on each
|
||||
reset or reboot and either need to be entered again. Alternatively,
|
||||
a setup script running at boot time can be written.
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Enable network access">
|
||||
|
||||
Once the Ben has booted and started USB networking, the interface
|
||||
on the PC side is configured as follows:
|
||||
<PRE>
|
||||
ifconfig usb0 192.168.254.100 up
|
||||
</PRE>
|
||||
<P>
|
||||
These are the settings for OpenWrt, assuming the network device is
|
||||
called "usb0". If using Jlime, the command would be as follows:
|
||||
<PRE>
|
||||
ifconfig usb0 192.168.1.200 up
|
||||
</PRE>
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Silence other 8:10 card users">
|
||||
|
||||
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
|
||||
Jlime distribution, the only such user that is automatically started
|
||||
is the MMC kernel driver. The following command disables it:
|
||||
<PRE>
|
||||
echo jz4740-mmc.0 >/sys/bus/platform/drivers/jz4740-mmc/unbind
|
||||
</PRE>
|
||||
<P>
|
||||
If a WPAN-enabled kernel has been installed, the AT86RF230 driver takes
|
||||
the place of the MMC driver. To disable it, run
|
||||
<PRE>
|
||||
echo spi2.0 >/sys/bus/spi/drivers/at86rf230/unbind
|
||||
</PRE>
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Start atrf-proxy">
|
||||
|
||||
On the Ben, launch the proxy daemon. We pass the option -b to background it:
|
||||
<PRE>
|
||||
atrf-proxy -b
|
||||
</PRE>
|
||||
|
||||
|
||||
<!-- ====================================================================== -->
|
||||
|
||||
|
||||
<SECTION ref="profiles" title="Test profiles">
|
||||
|
||||
Some of the functional tests measure characteristics that are strongly
|
||||
influenced by the test setup. It is therefore not possible to provide
|
||||
universally applicable reference values, but they have to be measured
|
||||
in the actual test environment.
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Clock count (atben only)">
|
||||
|
||||
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
|
||||
clock count with an accuracy of about +/−20 ppm:
|
||||
<PRE>
|
||||
atrf-xtal 1000 >ben.xtal
|
||||
</PRE>
|
||||
<P>
|
||||
This takes about 5 seconds.
|
||||
<P>
|
||||
Note that the result depends on the tolerance of the crystal in the Ben
|
||||
and is also affected by temperature. Good accuracy can therefore
|
||||
only be obtained if this measurement is performed individually on each
|
||||
Ben, and if a stable temperature is maintained.
|
||||
|
||||
|
||||
<!-- ---------------------------------------------------------------------- -->
|
||||
|
||||
|
||||
<SUBSECTION title="Signal strength">
|
||||
|
||||
@@@
|
||||
|
||||
|
||||
<P>
|
||||
<HR>
|
||||
Last update: 2011-05-27 <I>Werner Almesberger</I>
|
||||
<HR>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user