mirror of
git://projects.qi-hardware.com/ben-wpan.git
synced 2024-11-23 03:18:25 +02:00
258 lines
6.7 KiB
HTML
258 lines
6.7 KiB
HTML
<TITLE>Production and testing: Software setup</TITLE>
|
|
<BODY>
|
|
<HTML>
|
|
<H1>Production and testing: Software setup</H1>
|
|
|
|
Before performing any production tests, various pieces of software
|
|
need to be installed on Ben and PC, and configuration settings
|
|
@@@
|
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
|
<H2>PC software installation</H2>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install ben-wpan tools</H3>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install test scripts</H3>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install firmware binary</H3>
|
|
|
|
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>.
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Register Ben host name</H3>
|
|
|
|
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>
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Customize test scripts</H3>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
|
<H2>Ben software installation</H2>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Password-less remote access</H3>
|
|
|
|
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>
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install ben-wpan tools</H3>
|
|
|
|
@@@
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install avrdude</H3>
|
|
|
|
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>.
|
|
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Install boot-loader binary</H3>
|
|
|
|
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>.
|
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
|
<H2>Ben system setup</H2>
|
|
|
|
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.
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Enable network access</H3>
|
|
|
|
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>
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Silence other 8:10 card users</H3>
|
|
|
|
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>
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Start atrf-proxy</H3>
|
|
|
|
On the Ben, launch the proxy daemon. We pass the option -b to background it:
|
|
<PRE>
|
|
atrf-proxy -b
|
|
</PRE>
|
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
|
<H2>Test profiles</H2>
|
|
|
|
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.
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Clock count (atben only)</H3>
|
|
|
|
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.
|
|
|
|
|
|
<!-- ---------------------------------------------------------------------- -->
|
|
|
|
|
|
<H3>Signal strength</H3>
|
|
|
|
@@@
|
|
|
|
|
|
<P>
|
|
<HR>
|
|
Up: <A href="index.html">Production and testing</A>
|
|
Next: <A href="flash.html">Flashing (<B>atusb</B> only)</A>
|
|
<HR>
|
|
Last update: 2011-05-19 <I>Werner Almesberger</I>
|
|
<HR>
|
|
</BODY>
|
|
</HTML>
|