Blame view

Documentation/arm/SA1100/GraphicsClient 3.48 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
  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@cam.org>. 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@cam.org and will be greatly welcome!