Release Notes - Software Distribution, release 2.10 _________________________________________________________ Table of Contents 1. Introduction 2. Installation 3. Licenses 4. Changes between software distribution release 2.01 and 2.10 4.1. Design decisions 4.2. Changes 5. Trouble reports for software distribution 2.10 While every care has been taken in the preparation of this software distribution, Axis Communications AB cannot be held responsible for any technical errors. If you do detect any inaccuracies or omissions, please inform us at: technology@axis.com _________________________________________________________ 1. Introduction These are the release notes for software distribution, release 2.10, that is part of the SDK for all AXIS Developer Boards/Device Servers as well as for custom boards built around the ETRAX 100LX or the ETRAX FS processors. Read more about the SDK and its parts at http://developer.axis.com/wiki/doku.php?id=axis:sdk This software distribution has been put together to ease the development of applications for the ETRAX 100LX and ETRAX FS processor. The intention is to provide a development environment based on open source utilities making it possible to create a Linux system running on various ETRAX 100LX or ETRAX FS based products. This software distribution includes Linux 2.6 kernel and a basic selection of applications and libraries. The most important news regarding this release is that ETRAX FS is now officially supported, including the ability to boot from NAND flash memory. For other changes read more under Changes chapter. NOTE: As this software uses a standard Linux 2.6 kernel, which takes advantage of the MMU in these chips, the produced firmware does NOT work with the older ETRAX 100 chip. _________________________________________________________ 2. Installation Please consult the INSTALL file or http://developer.axis.com/wiki/doku.php?id=axis:install-howto- 2_10 _________________________________________________________ 3. Licenses This package, the Software Distribution 2.10 install package, is licensed as GPL2. For license information on other packages in this software distribution consult the LICENSES file. _________________________________________________________ 4. Changes between software distribution release 2.01 and 2.10 4.1. Design decisions The Linux kernel version used in software distribution 2.10 is 2.6.19. In contrast to earlier versions Linux 2.4 is no longer a viable option. The reason for not including Linux 2.4 is lack of time for testing and maintaining two separate versions of the Linux kernel. By providing only the Linux 2.6 kernel we hope that you will experience the same functionality while enjoying a more thoroughly tested kernel. The install script found in earlier versions of the software distribution has been removed. Instead the functionality of the configure script has been extended to handle the whole installation process. This also eliminates the risk of accidentally using the install script instead of the install program when having the local directory in the $PATH. The product specific files have been moved from to configure-files/devboard/products/. The reason for this is to make future upgrades of individual product specific files easier. As a bonus the software distribution root directory becomes somewhat less cluttered. _________________________________________________________ 4.2. Changes The focus for this release has been to support the ETRAX FS processor. Moreover, much effort has been put into getting the ETRAX FS processor to boot securely from NAND flash memory. During this work major parts of the build system have been redesigned. Below is a list of packages that has been updated or added compared to the 2.01 release of the software distribution. This list does not include build system changes, tools used in the build process or software internally developed at Axis. Kernel: + Linux kernel 2.4 has been removed + Linux kernel 2.6.19 Applications: + Bluez utils - upgraded to version 2.25 + Bridge utils - upgraded to version 1.1 + Busybox - upgraded to version 1.1.3 + Dash - upgraded to version 0.5.3 + Gdbserver - upgraded to version 6.3 + iproute2 - version 2.6.15 added + stunnel - upgraded to version 4.14 + Tcpdump - upgraded to version 3.9.4 Libraries: + Bluez libs - upgraded to version 2.25 + Readline - upgraded to version 5.1 + libpcap - upgraded to version 0.9.4 _________________________________________________________ 5. Trouble reports for software distribution 2.10 During the test of this release a few irregularities were observed, as reported below. An updated list of reported irregularities will be available at http://developer.axis.com/wiki/doku.php?id=trouble_reports. If you detect any inaccuracies or omissions, please inform us at: technology@axis.com Old style PATH cause build problems When the PATH to gcc-cris looks like '/usr/local/cris/r63v32/:/usr/local/cris/r63v32/bin/' (with and without bin) some scripts get confused and compilation fails. To avoid this, change your PATH and remove the entry that does not point to the bin directory. The trailing "/" should also be omitted, if present. ETRAX FS Ethernet driver If the ETRAX FS Ethernet driver for some reason can not detect the PHY the kernel will oops if the interface is used. This could for example occur if jumper S9 on AXIS 88/89 is closed (eth1 PHY is disabled) and both interfaces are enabled in the kernel and product configuration. Removal and insertion of the crisv32-usb-hcd module fails Once the crisv32-usb-hcd module is inserted it can not be removed and inserted again. This problem does not interfere with normal use of the USB functionality. The build system is not POSIX compatible When /bin/sh is POSIX compatible shell the software distribution will fail to produce a working firmware. This is, for example, the case with Ubuntu 6.10 which uses dash as /bin/sh. Compiling kernel with some network packet filtering options fail The kernel compilation fails if some advanced "network packet filtering" options are selected in the kernel configuration. This is a result of a commented out line in 'os/linux-2.6/include/linux/netfilter/xt_conntrack.h'. The reason for commenting out the inclusion of 'linux/in.h' is that this line prevents compilation of the somewhat old apps/iptables application. If these advanced "network packet filtering" options are desired remove the comment and recompile the kernel. And then import a more recent version of iptables that goes well with the kernel.