ftdi_sio.c
ftdi_sio.h

Manual Installation Instructions:

Assuming your kernel is already built once and is in /usr/src/linux and the ftdi_sio files are in your current directory:

1. Place these files in your linux distribution as shown:

	cp ftdi_sio.c ftdi_sio.h /usr/src/linux/drivers/usb/serial

2. Rebuild your kernel
	In 2.4: cd /usr/src/linux ; make modules && make modules_install
	In 2.6: cd /usr/src/linux ; make && make install && make modules_install

	NOTE: For a full rebuild:
		In 2.4: cd /usr/src/linux ; make clean && make menuconfig ; make dep && make bzImage && make modules && make modules_install
		        cp arch/i386/boot/bzImage /boot/vmlinuz-2.4.XXXXX ; cp System.map /boot/System.map-2.4.XXXXX
			NOTE: XXXXX in the above represents the actual kernel version string
		In 2.6: cd /usr/src/linux ; make clean && make menuconfig ; make && make install && make modules_install

Once the new ftdi_sio module is rebuilt and installed, you are ready to use the pole display.

Usage:
	Plug in the USB pole display to any available USB port connector on your pc.
	To verify the module is running type:
		lsmod
	If the module does not appear in the listing, execute:
		modprobe ftdi_sio

ieeclock:
	This utility prints the time of day, a title string, and a line of scrolling information on the pole display.  You may design the information yourself, or use one of the built-in options to invoke an rss feed or a test script.

	Installation:
		Place ieeclock in /usr/bin as shown:
			cp ieeclock /usr/bin
		Ensure it will execute:
			chmod +x /usr/bin/ieeclock

	Execution:

		ieeclock <title> <d|l|n=<AP|CNN|BBC|APB|CNNT|BBCB|BENM|FARK|DEMO>> [s=<1|2|3|4|5>]

		    <title> = Maximum 11 character title string of your choosing appears on line 1
		             NOTE: Enclose your string in single quotes: ex: 'Hi there'
		                   Double quotes will NOT work correctly

		    d      = date mode - Show date string on line 2 of display

		    l      = load mode - Show linux system load values on line 2 of display

		    n      = news mode - Scroll one of the following feeds on line 2 of display
		                         NOTE: Not all feeds will work at all times
		                               All require internet access (except DEMO)
		             AP       = Associated Press top stories (default)
		             CNN      = CNN top stories
		             BBC      = BBC top stories
		             APB      = Associated Press business headlines
		             CNNT     = CNN technology headlines
		             BBCB     = BBC business headlines
		             BENM     = Ben Maller sports news and rumors
		             FARK     = It's not news - it's FARK
		             RSST     = Test rss filter
		             DEMO     = Use /tmp/demo.rss - format: <title>My line of text</title>
		                        NOTE: Use a text editor to create the file described above

		    s      = speed 1 through 5 where 5 is the fastest (default is 2)
		             NOTE: Range is roughly 4 cps to 64 cps, doubling at each step

		Examples:
			ieeclock 'IEE, Inc.' d
			ieeclock 'IEE, Inc.' l
			ieeclock 'AP News' n=AP s=2

