embedded/README.txt

   1 uLan embedded source tree v 0.5
   2 ===============================
   3
   4 This is highly experimental code, look for latest
   5 version on the project related pages
   6
   7   http://ulan.sourceforge.net/
   8   http://sourceforge.net/projects/ulan
   9   http://cmp.felk.cvut.cz/~pisa#ulan
  10
  11 To build code you need to have SDCC 2.5.3-CVS.
  12 The snapshot past Sep 3 2005 are OK.
  13 The GNU make program 3.81beta3 or better is required.
  14 The full build has been tested on Linux based hosts only
  15 for now. The uLan protocol code has been successfully build
  16 by Keil compiler under Windows in the past.
  17
  18 The archive has to be unpacked with symbolic links
  19 for now. We are thinking about rearrangement
  20 of the code to make it more portable and drop
  21 link requirements.
  22
  23 The MCS51 is only port provided in this version.
  24
  25 To build do
  26
  27   cd ul_embedded-x.y/mcs51
  28   make defaul-config
  29   make
  30
  31 You should find resulting binaries in the "_compiled/bin"
  32 directory. The board and application is selected by used
  33 "config.omk" file. Example files can be found in the "configs"
  34 directory.
  35
  36 The next boards and applications are supported
  37
  38 Device: MCS51 TI MSC-1210
  39    Board: ULAD-21 - AD converter and uLan2USB converter
  40    Applications:
  41      config.mscboot-ulad21 - uLan enabled remote boot-loader and boot-block
  42      config.u2u-ulad21     - uLan to USB converter
  43
  44    Board: HISC - Home Information System Controller
  45      config.mscboot-hisc   - boot block for distributed HISC system
  46      config.blinder        - blinder controller
  47      config.kswtimer       - kettle switch timer
  48
  49 Device: MCS51 Atmel AT89C51RD2
  50      config.u2u-ps1        - AT89C51RD2 based uLan2USB converter
  51
  52
  53 The procedure to write boot-block into ULAD-21 MSC1210 based board
  54 requires next steps
  55
  56   FLASHMSC_TTY=/dev/ttyS1
  57   flashmsc -d $FLASHMSC_TTY -E 0x807f
  58   flashmsc -d $FLASHMSC_TTY -E 0x7fff
  59   flashmsc -d $FLASHMSC_TTY -X 18432000 ulad21-hcr.hex
  60   flashmsc -d $FLASHMSC_TTY -X 18432000 ulad21-boot.hex
  61
  62 The "flashmsc" sources can be found at page
  63   http://cmp.felk.cvut.cz/~pisa/#mcuutils
  64
  65 To replace application in the converter or other uLan node
  66 over uLan communication protocol, next steps are required
  67
  68   echo Reset application if running
  69   ul_sendhex -g 0 -m 0
  70   echo Waiting to target to go into boot block
  71   echo If application blocks, reset device at this time
  72   echo to activate boot block now
  73   ul_sendhex -o 0 -m 0
  74   echo Found devices
  75   ul_sendhex -p 64
  76   echo Erasing flash
  77   ul_sendhex -m 62 -t 5 -e -s 0x2000 -l 0x6000
  78   sleep 2
  79   echo Loading application
  80   ul_sendhex -m 62 -t 5 application.hex
  81
  82 Look for uLan driver for host side (Linux, Windows, DOS)
  83 uLan protocol driver. The uLan2USB converter requires
  84 at least version ul_drv-0.7 release.
  85
  86 The code authors
  87
  88   (C) Copyright 1996-2005 by Pavel Pisa
  89         http://cmp.felk.cvut.cz/~pisa
  90   (C) Copyright 1996-2005 PiKRON Ltd.
  91         http://www.pikron.com
  92   (C) Copyright 2002-2005 Petr Smolik
  93