99 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			99 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
ADS GraphicsClient Plus Single Board Computer
 | 
						|
 | 
						|
For more details, contact Applied Data Systems or see
 | 
						|
http://www.applieddata.net/products.html
 | 
						|
 | 
						|
The original Linux support for this product has been provided by 
 | 
						|
Nicolas Pitre <nico@fluxnic.net>. Continued development work by
 | 
						|
Woojung Huh <whuh@applieddata.net>
 | 
						|
 | 
						|
It's currently possible to mount a root filesystem via NFS providing a
 | 
						|
complete Linux environment.  Otherwise a ramdisk image may be used.  The
 | 
						|
board supports MTD/JFFS, so you could also mount something on there.
 | 
						|
 | 
						|
Use 'make graphicsclient_config' before any 'make config'.  This will set up
 | 
						|
defaults for GraphicsClient Plus support.
 | 
						|
 | 
						|
The kernel zImage is linked to be loaded and executed at 0xc0200000.  
 | 
						|
Also the following registers should have the specified values upon entry:
 | 
						|
 | 
						|
	r0 = 0
 | 
						|
	r1 = 29	(this is the GraphicsClient architecture number)
 | 
						|
 | 
						|
Linux can  be used with the ADS BootLoader that ships with the
 | 
						|
newer rev boards. See their documentation on how to load Linux.
 | 
						|
Angel is not available for the GraphicsClient Plus AFAIK.
 | 
						|
 | 
						|
There is a  board known as just the GraphicsClient that ADS used to
 | 
						|
produce but has end of lifed. This code will not work on the older
 | 
						|
board with the ADS bootloader, but should still work with Angel,
 | 
						|
as outlined below.  In any case, if you're planning on deploying
 | 
						|
something en masse, you should probably get the newer board.
 | 
						|
 | 
						|
If using Angel on the older boards, here is a typical angel.opt option file
 | 
						|
if the kernel is loaded through the Angel Debug Monitor:
 | 
						|
 | 
						|
----- begin angelboot.opt -----
 | 
						|
base 0xc0200000
 | 
						|
entry 0xc0200000
 | 
						|
r0 0x00000000
 | 
						|
r1 0x0000001d
 | 
						|
device /dev/ttyS1
 | 
						|
options "38400 8N1"
 | 
						|
baud 115200
 | 
						|
#otherfile ramdisk.gz
 | 
						|
#otherbase 0xc0800000
 | 
						|
exec minicom
 | 
						|
----- end angelboot.opt -----
 | 
						|
 | 
						|
Then the kernel (and ramdisk if otherfile/otherbase lines above are
 | 
						|
uncommented) would be loaded with:
 | 
						|
 | 
						|
	angelboot -f angelboot.opt zImage
 | 
						|
 | 
						|
Here it is assumed that the board is connected to ttyS1 on your PC
 | 
						|
and that minicom is preconfigured with /dev/ttyS1, 38400 baud, 8N1, no flow
 | 
						|
control by default.
 | 
						|
 | 
						|
If any other bootloader is used, ensure it accomplish the same, especially
 | 
						|
for r0/r1 register values before jumping into the kernel.
 | 
						|
 | 
						|
 | 
						|
Supported peripherals:
 | 
						|
- SA1100 LCD frame buffer (8/16bpp...sort of)
 | 
						|
- on-board SMC 92C96 ethernet NIC
 | 
						|
- SA1100 serial port
 | 
						|
- flash memory access (MTD/JFFS)
 | 
						|
- pcmcia
 | 
						|
- touchscreen(ucb1200)
 | 
						|
- ps/2 keyboard
 | 
						|
- console on LCD screen
 | 
						|
- serial ports (ttyS[0-2])
 | 
						|
  - ttyS0 is default for serial console
 | 
						|
- Smart I/O (ADC, keypad, digital inputs, etc)
 | 
						|
  See http://www.applieddata.com/developers/linux for IOCTL documentation
 | 
						|
  and example user space code. ps/2 keybd is multiplexed through this driver
 | 
						|
 | 
						|
To do:
 | 
						|
- UCB1200 audio with new ucb_generic layer
 | 
						|
- everything else!  :-)
 | 
						|
 | 
						|
Notes:
 | 
						|
 | 
						|
- The flash on board is divided into 3 partitions.  mtd0 is where
 | 
						|
  the ADS boot ROM and zImage is stored.  It's been marked as
 | 
						|
  read-only to keep you from blasting over the bootloader. :)  mtd1 is
 | 
						|
  for the ramdisk.gz image.  mtd2 is user flash space and can be
 | 
						|
  utilized for either JFFS or if you're feeling crazy, running ext2
 | 
						|
  on top of it. If you're not using the ADS bootloader, you're
 | 
						|
  welcome to blast over the mtd1 partition also.
 | 
						|
 | 
						|
- 16bpp mode requires a different cable than what ships with the board.
 | 
						|
  Contact ADS or look through the manual to wire your own. Currently,
 | 
						|
  if you compile with 16bit mode support and switch into a lower bpp
 | 
						|
  mode, the timing is off so the image is corrupted.  This will be
 | 
						|
  fixed soon.
 | 
						|
 | 
						|
Any contribution can be sent to nico@fluxnic.net and will be greatly welcome!
 | 
						|
 |