Documentation/HITACHI-EDOSK2674-HOWTO

   1 Hitachi EDOSK2674
   2 -----------------
   3
   4 The Hitachi/EDOSK2674 target uses the Hitachi H8300S processor.
   5 To build for this target you will need a working h8300-elf tool chain
   6 that includes elf2flt.  A precompiled chain can be found at:
   7
   8     http://www.uclinux.org/pub/uClinux/ports/h8/h8300-elf-tools-20030420.sh
   9
  10 It is a self installing tar file. login as root and run:
  11
  12     sh h8300-elf-tools-20030420.sh
  13
  14 Add /usr/local/bin to your path and then you will be able to use the tools.
  15 You do not need to be root to build the sources.
  16
  17 The linux-2.4.x kernel and uClibc are the only working combinations for
  18 this board at the moment.
  19
  20 When you have finished compiling there are several images in the "images"
  21 directory:
  22
  23     edosk2674-boot.mot       - a very small bootloader the boots a flash
  24                                image.  This version can be loaded using the
  25                                ROM monitor that comes with the board.
  26     edosk2674-boot.bin       - a "netflash" version of the bootloader.
  27     edosk2674-boot+image.mot - a full image (including bootloader) that can
  28                                be flashed in using the ROM monitor that
  29                                comes with the board.  This will take a
  30                                while to load at 115200.
  31     edosk2674-image.bin      - a "netflash" version of the kernel/romfs
  32                                image that can be flashed into the unit using
  33                                netflash.
  34     edosk2674-imagez.bin     - a compressed image,  not much use for people
  35                                other than me :-)
  36
  37 First Time Through
  38 ------------------
  39 The first time you load the image do the following steps:
  40
  41 1) Boot the board using the builtin ROM monitor running from the boot rom
  42    (boot mode) with writes to main flash enabled.
  43
  44 2) Compile "tip" from the latest/patched uClinux-dist source with:
  45
  46     cc -o tip user/tip/tip.c
  47
  48 3) Connect to the board using tip:
  49
  50     ./tip -l /dev/ttyS0 -s 115200 -d images/edosk2674-boot+image.mot
  51
  52 4) reset the board to get the menu.  Make sure it says boot mode. Select
  53    the following options:
  54
  55     ...
  56
  57     1. Flash Programming
  58
  59     ...
  60
  61     2. Main Flash (Intel)
  62
  63     ...
  64
  65     Are you sure you want to destroy existing Main Flash Data? (Y/N): y
  66     Is MF_WEN jumper fitted? (Y/N): y
  67
  68     Data downloaded sucessfully.
  69
  70     Writing S-Records into Intel flash... [\]
  71
  72     Updating has completed successfully.
  73
  74     The system can now be restarted with the updated software...
  75
  76 5) Now type ~s to send the file.  Be patient,  this will take some time.
  77
  78 6) Remove the jumper so that you may boot from flash (normal mode).
  79    type ~. to exit "tip" and then run:
  80
  81     ./tip -l /dev/ttyS0 -s 38400
  82
  83    Reset the board and you should see:
  84
  85     Hitachi EDOSK2674 Simple Boot Loader
  86     Copyright (C) 2003 David McCullough <davidm@snapgear.com>
  87     .............................................................
  88     Linux version 2.4.20-uc0 (davidm@beast) (gcc version 3.2.2) #361 Sun Apr 20
  89     22:29:55 EST 2003
  90
  91     uClinux H8S
  92     Target Hardware: EDOSK-2674R
  93     H8/300 series support by Yoshinori Sato <ysato@users.sourceforge.jp>
  94     Flat model support (C) 1998,1999 Kenneth Albanowski, D. Jeff Dionne
  95     On node 0 totalpages: 3060
  96     zone(0): 0 pages.
  97     zone(1): 3060 pages.
  98     zone(2): 0 pages.
  99     Kernel command line: console=ttySC2,38400
 100     Calibrating delay loop... 7.21 BogoMIPS
 101     Memory available: 6292k/7122k RAM, 0k/0k ROM (848k kernel code, 165k data)
 102     Dentry cache hash table entries: 2048 (order: 2, 16384 bytes)
 103     Inode cache hash table entries: 1024 (order: 1, 8192 bytes)
 104     Mount-cache hash table entries: 512 (order: 0, 4096 bytes)
 105     Buffer-cache hash table entries: 1024 (order: 0, 4096 bytes)
 106     Page-cache hash table entries: 4096 (order: 2, 16384 bytes)
 107     POSIX conformance testing by UNIFIX
 108     Linux NET4.0 for Linux 2.4
 109     Based upon Swansea University Computer Society NET3.039
 110     Initializing RT netlink socket
 111     Starting kswapd
 112     SuperH SCI(F) driver initialized
 113     ttySC0 at 0x00ffff78 is a SCI
 114     ttySC1 at 0x00ffff80 is a SCI
 115     ttySC2 at 0x00ffff88 is a SCI
 116     smc9194.c:v0.14 12/15/00 by Erik Stahlman (erik@vt.edu)
 117     eth0: SMC91C94(r:9) at 0xf80000 IRQ:16 INTF:TP MEM:6144b ADDR:
 118     00:00:87:d6:24:89
 119     Blkmem copyright 1998,1999 D. Jeff Dionne
 120     Blkmem copyright 1998 Kenneth Albanowski
 121     Blkmem 5 disk images:
 122     0: 4FF684-5A9A83 [VIRTUAL 4FF684-5A9A83] (RO)
 123     1: 0-1FFFF [VIRTUAL 0-1FFFF] (RW)
 124     2: 20000-3FFFF [VIRTUAL 20000-3FFFF] (RW)
 125     3: 40000-3FFFFF [VIRTUAL 40000-3FFFFF] (RW)
 126     4: 0-3FFFFF [VIRTUAL 0-3FFFFF] (RW)
 127     RAMDISK driver initialized: 16 RAM disks of 4096K size 1024 blocksize
 128     PPP generic driver version 2.4.2
 129     PPP MPPE compression module registered
 130     NET4: Linux TCP/IP 1.0 for NET4.0
 131     IP Protocols: ICMP, UDP, TCP
 132     IP: routing cache hash table of 512 buckets, 4Kbytes
 133     TCP: Hash tables configured (established 512 bind 1024)
 134     NET4: Unix domain sockets 1.0/SMP for Linux NET4.0.
 135     VFS: Mounted root (romfs filesystem) readonly.
 136     Freeing unused kernel memory: 0k freed (0x4e0000 - 0x4df000)
 137     Shell invoked to run file: /etc/rc
 138     Command: hostname EDOSK2674
 139     Command: /bin/expand /etc/ramfs.img /dev/ram0
 140     Command: /bin/expand /etc/ramfs.img /dev/ram1
 141     Command: mount -t proc proc /proc
 142     Command: mount -t ext2 /dev/ram0 /var
 143     Command: mount -t ext2 /dev/ram1 /etc/config
 144     Command: mkdir /var/tmp
 145     Command: mkdir /var/log
 146     Command: mkdir /var/run
 147     Command: mkdir /var/lock
 148     Command: flatfsd -r
 149     FLATFSD: created 3 configuration files (36 bytes)
 150     Command: cat /etc/motd
 151     Welcome to
 152               ____ _  _
 153              /  __| ||_|
 154         _   _| |  | | _ ____  _   _  _  _
 155        | | | | |  | || |  _ \| | | |\ \/ /
 156        | |_| | |__| || | | | | |_| |/    \
 157        |  ___\____|_||_|_| |_|\____|\_/\_/
 158        | |
 159        |_|
 160
 161     Hitachi/EDOSK2764 port.
 162     For further information check:
 163     http://www.uclinux.org/
 164
 165     Execution Finished, Exiting
 166     Shell invoked to run file: /etc/config/start
 167     Execution Finished, Exiting
 168
 169     Sash command shell (version 1.1.1)
 170     />
 171
 172 From Now On
 173 -----------
 174
 175 You can now upgrade this system over the Network.  Just config the board
 176 with an IP address,  for exmaple:
 177
 178     ifconfig eth0 192.168.20.2
 179
 180 Then to load a file off a tftp server run:
 181
 182     netflash -i 192.168.20.1 edosk2674-image.bin
 183
 184 or to get the file from a HTTP server:
 185
 186     netflash -i http://192.168.20.1/edosk2674-image.bin
 187
 188 This still takes a little while to load a new image but is much faster than
 189 the serial download.
 190
 191 Changing the Setup
 192 ------------------
 193
 194 By default a whole nuch of things are running.  A Web server,  telnetd.
 195 You may want to add some config files or inittab entries and have the
 196 preserved across boots.
 197
 198 While on the console (the tip login) just do something like:
 199
 200     /> cd /etc/config
 201     /etc/config> vi start
 202     ...
 203     add a line 'ifconfig eth0 192.168.20.69' to set the IP address save
 204     and quit.
 205     ...
 206     /etc/config> sync
 207     /etc/config> reboot
 208
 209 The sync command sends a signal to the flatfsd to save the contents of
 210 /etc/config to /dev/flash/config.  This is restored at boot time by the
 211 "flatfsd -r" command.
 212
 213
 214 If you need more info just ask me, David McCullough <davidm@snapgear.com>
 215