Linuxstamp

From OpenCircuits
Jump to navigation Jump to search

Linuxstamp top 02.jpg

Status

You can now purchase Linuxstamp boards from thelinuxstamp.com

Description

The Linuxstamp is designed to be a general purpose processor module. It is designed to work as a stand alone module (SD card, Ethernet and USB/Serial converter are all on the module). This allows all initial development to be done without a motherboard, but for integration into a specific project a motherboard with specific features could be designed. Check out the start of the first mother board for the Linuxstamp, Mboard 1.

Features

  • Atmel AT91RM9200 processor (Arm9 processor with MMU, 180Mhz operation)
  • 32MB SDRAM (Only limited by 1x 54-TSOP SDRAM chip)
  • 8MB SPI Dataflash
  • 1x 10/100 Ethernet
  • 1x USB host port (allows wifi adapters, flash drives and other USB devices to be used)
  • 1x SD card slot
  • Serial debug port access through FTDI USB/Serial converter
  • JTAG port
  • 2-Layer PCB design
  • POE capable (48v -> 5v Power supply can be implemented on a motherboard)

License

All files for this project are licensed under the GNU GPL V2

Hardware design files

Warning!!! Use this design at your own risk.

Power

The power supply for the board is based on the Linear LTC3407-3. This is a very compact high frequency switching power supply. It has both a 3.3v and a 1.8v output. It does have a very tight input range 3.3v-5.5v. The Micrel PHY also needs 2.5v, but this is provided by an internal regulator. Currently a regulated 5v must be used to power the board. Talking with Jeff from Jendy Labs it seems like POE (Power Over Ethernet) is a good idea. Wikipedia has a good general description of POE. The basic idea is that POE provides 48v and up to 13 watts, more than enough power for the Linuxstamp. The problem for the module is that a 48v -> 5v power supply is not small or cheap. In order to take advantage of POE without increasing the board size I found a part from Transtek Magnetics that is made for POE and has the rectifier built into the jack. The 48v lines are then connected to the pin header. This will allow a motherboard to integrate a POE power supply.

Minicom & the debug port

The USB device port on the Linuxstamp does not connect directly to the AT91RM9200 it connects to the FT232R chip. The FT232R is a USB/serial converter. The FT232R chip has drivers for both Windows and Linux, but the Linux drivers are included in later kernels. When you plug the Linuxstamp into your host (Linux) machine a device should appear /dev/ttyUSB0 (I think the postfix number will increment as you add more devices). /dev/ttyUSB0 will behave as any other serial port now. Minicom is the standard program to access the serial port in Linux. The first time you run minicom you will have to be root in order to do the setup, after that you can change the permissions on /dev/ttyUSB0 so any user can run minicom. To enter configuration mode in minicom type CTRL-A o, now scroll down to Serial port setup. Use the letters to navigate. You will want the device to be /dev/ttyUSB0 and Bps/Par/Bits to read 115200 8N1. Connection to the board is important for loading Atmel's tiny program and u-boot, but once the board is working it might not be as important.

The built in xmodem in minicom does not seem to work with the hardware bootloader in the AT91RM9200. The folks at Koan have created a workaround. The one thing you have to do is edit the .c file for the proper serial port ttyUSB0 in my case.

nfs & tftp

Nfs (network file system) and tftp (trivial file transfer protocol) are two servers you will want running on your host machine. Nfs is useful for hosting the root file system of the Linuxstamp. Tftp is useful for u-boot to retrieve the kernel from. There are many other websites on nfs and tftp, but I will try and go over a simple setup. I would suggest being behind a firewall before trying either of these setups as neither is secure. I wrote this using a Fedora 7 system. First make sure you have nfs installed.

  • $ yum install nfs-utils nfs-utils-lib portmap system-config-nfs

Now to make sure the service is enabled run:

  • $ serviceconf and make sure nfs and nfs lock are checked

Now edit /etc/exports you should add a line like this /path_to_nfs_root/ *(rw,no_root_squash,insecure). Now restart nfs.

  • $ /etc/init.d/nfs restart

You can test this with

  • $ mount -t nfs server_name:/path_to_nfs_root /path_to_test_mount

Now on to tftp. Make sure it is installed.

  • $ yum install tftp-server

This will create a file /etc/xinetd.d/tftp. In this file you will want to change disable from yes to no. Now make a test file.

  • $ cd /tftpboot
  • $ echo hello > file

Now we can test it

  • $ tftp -v server_name -c get tmp

Now with u-boot we can load image files

  • > tftpboot 20800000 uImage

And boot them

  • > bootm 20800000

Cross Compilier

In order to compile for the AT91RM9200 we need to build a cross compilier. Dan Kegel has created a very useful tool for building a cross compiliers. I am using Fedora 6 (x86_64) as my host system. After downloading and extracting crosstool (I was using version 0.43) I made two small changes. In the "demo-arm.sh" file I changed the eval line to

  • "eval `cat arm.dat gcc-3.4.5-glibc-2.3.6.dat` sh all.sh --notest"

In the "arm.dat" file I changed the TARGET to "arm-linux" (By default u-boot looks for arm-linux-* tools). Now if you run "demo-arm.sh" you should get a cross compilier.

Booting

The AT91RM9200 has several features the facilitate easy booting. There is a good description of the booting order here. Atmel provides a tiny program that lives in the Dataflash and loads u-boot (see next section).

U-boot

First we need u-boot (doc) source (git) (formerly on sourceforge) (I was using version 1.1.6 - this is an old version). If you have not yet built a cross compilier now would be a good time to do so (See the cross compilier section above). Now you can do a test for the Atmel AT91RM9200 DK board.

  • $ make at91rm9200dk_config
  • $ make

This should give you a "u-boot.bin" file. We will have to write a board specific configuration file for the Linuxstamp. We should be able to base it off the the Atmel DK board. If you look at "/u-boot-1.1.6/include/configs/at91rm9200dk.h" you can see the configuration for the DK board.
Other u-boot commands:

  • > printenv, prints the enviroment variables
  • > saveenv, saves the enviroment variables
  • > setenv bootcmd 'tftpboot 20800000 uImage; bootm 20800000' Sets the boot command to load a image over tftp and boot it
  • > setenv bootargs mem=32M nfsroot=192.168.0.3:/nfs_root ip=192.168.0.51 console=ttyS0,115200n8 rootdelay=1

This sets the command line to be passed to the kernel. As you can see it sets the nfsrot, ip address and console

Busybox

Busybox provides the necessary utilities (e.g ls, cp, etc...). After you have downloaded and unpacked busybox we are ready to get started (I was using version 1.4.2).

  • $ make defconfig

Now for a quick test we can make busybox for our host machine

  • $ make

After you run this you should have a file 'busybox'. Now try

  • $ ./busybox ls

But we want to build busybox for our embedded system so run

  • $ make ARCH=arm CROSS_COMPILE=arm-linux-

If you want to make Busybox with all the symbolic links for the tools run

  • $ make CONFIG_PREFIX=/path_to_dir ARCH=arm CROSS_COMPILE=arm-linux- install

Building the Linux Kernel

If you have ever built the kernel for your desktop, then cross-compiling the kernel isn't that much harder. First get the latest kernel from kernel.org (I was using 2.6.23-rc9), then get the AT91RM9200 patch from here. After you unpack both of these you can apply the patch.

  • $ patch -p1 < 2.6.23-rc3-at91.patch

Now lets take a look at the default configurations

  • $ make ARCH=arm help

The ecbat91 is the closest to the linuxstamp.

  • $ make ARCH=arm ecbat91_defconfig

If we what to further customize the build we can use 'xconfig'

  • $ make ARCH=arm xconfig

Now we're are ready to build the kernel. You will have to have the u-boot tool mkimage in the PATH for this to work

  • $ make ARCH=arm CROSS_COMPILE=arm-linux- uImage

Minimal filesystem

There isn't much you need for a minimal filesystem. I suggest creating a staging area to create the filesystem. First you need the libraries generated by the cross compiler. On my machine they are located at /opt/crosstool/gcc-3.4.5-glibc-2.3.6/arm-linux/arm-linux/lib. Next you will need busybox, and we saw in the busybox section we can tell busybox where to output the files (use the root directory of your staging area). The last file we need is /dev/console.

  • $ mkdir /staging_path/dev

/dev/console is a special file used to bind a device driver to a file. As such we use the mknod command.

  • $ mknod /staging_path/dev/console c 5 1

The c says this is a character device. The 5 is the major node, and the 1 is the minor node.

For development the most convenient way to work is by mounting an NFS root file system. Another easy way to deal with thre root file system is by mounting it on either a USB drive or SD card, but if you want a stand alone system you will want the root filesystem to come from the onboard Dataflash. There are several steps to do this. The Dataflash on the Linuxstamp is 8MB. A little under 2MB is used for the bootloaders and the Linux kernel. This leaves about 6MB for the filesystem. The filesystem I am working with is about 10MB, so we will need to compress the filesystem. One method of doing this is to use the initramfs function in the kernel. The kernel expects the image to be a gzipped CPIO archive. In the kernel source there are tools to create the CPIO archive. First we must create a file list from our file system (presumedly this is just the root of your current NFS mount).
/!!Remember that you need a 'init' file in /. You can just link to /sbin/init

  • $ cd /path_to_linux_source
  • # scripts/gen_initramfs_list.sh /path_to_fs_root/ > cpio_list

Next create the CPIO archive

  • # usr/gen_init_cpio cpio_list > initramfs.cpio

You might have to make gen_init_cpio

  • # make gen_init_cpio

Gzip the CPIO archive

  • $ gzip initramfs.cpio

Now copy initramfs.cpio.gz to usr/initramfs_data.cpio.gz, and run the normal kernel make. You will notice that uImage is much larger (size = kernel + fs).

Dropbear SSH

One of the first non busybox tools you will want is SSH. Dropbear is a small SSH client/server. I was able to get version 0.50 working.

  • $ ./configure --host="arm-linux" --disable-zlib --prefix=/staging_path
  • $ make all
  • # make all install

You will have to make the device nodes /dev/ptmx and /dev/tty

  • # mknod /dev/ptmx c 5 2
  • # mknod /dev/tty c 5 0

You will also have to have the devpts filesystem mounted.

Servos

Servos.jpg

It is very easy to use the Linuxstamp with a RC servo controller like this one from pololu. In this setup the board is powered from the USB connector, so I was able to use the power terminal to power the pololu module. On the under side of the pololu module I connected the servo power with the chip power. The only other thing that is needed is the serial TX line from the Linuxstamp (yellow wire). I created a very simple program to run the servos. The following example would set servo 0 to a speed of 54 (64 is stopped) with an acceleration of 2.

    1. servo_ser 0 2 54

Eagle Stuff

I will put tools and libraries here.

  • I would post a cam job, but opencircuits won't let me upload a .cam file

Links

  • Atmel: AT91RM9200 info on Atmel's site
  • [1]: Up to date kernel patch for the AT91RM9200
  • Cadsoft.de: Free (as in beer) tools for schematic and PCB design
  • openhardware.wordpress.com: Here is my openhardware blog
  • ftp site: Here you will find tools and images like the crosscompilier and a debian file system
  • App notes: for Atmel arm processors
  • Jendy Labs
  • Mborad 1 for the Linuxstamp
  • ECB AT91 This is another open source project similar to the Linuxstamp. They have somve very good documentation.

Pricing

The parts cost for qty 1 is $75 from digikey, and $55 for qty 100
I'm sure this can be greatly reduced with higher quantity
We will make a small run soon, and I will let you know when these are available.

Discussion

Can I plug a USB peripheral into the Linuxstamp, such as a USB Wifi adapter? --DavidCary 22:02, 17 April 2007 (PDT)

Yes, any USB device that is supported by the kernel should work with the Linuxstamp. --Linuxvolts 23:15, 18 April 2007 (PDT)

This is not a true USB port is it? Its just a usb serial peripheral port, therefore USB stick will not work.

Should be answered by the last answer, too. An USB stick is also USB peripheral^^ --SebDE

This is not a USB host....it (Linuxstamp)is seen as the peripheral surely?

From the Features:
1x USB host port (allows wifi adapters, flash drives and other USB devices to be used)
You can plug in any USB device that is supported by the kernel. The Linuxstamp is not supposed to be plugged via USB to a PC.
--SebDE

The AT91RM9200 has 2x USB host ports and 1x device port. I bring out one of the USB host ports directly from the chip to a USB A connector. There is also a mini USB B connector on the board this is connected to the FT232RQ (USB/serial converter) which in turn is connected to the debug serial port on the AT91RM9200. So the linuxstamp can be both a USB host and a USB device. --Linuxvolts 20:10, 4 July 2007 (PDT)

Contact

For further questions or comments please contact Paul (pthomas8589 _at_ gmail _dot_ com)

other boards that run Linux