  PCM5820 & LRP HOWTO
  Heimo Schn <heimo.schoen@gmx.at>

  Version 0.1 , 1. November 1999

  Setup a 5820/L with LRP the Linux-router-project


  11..

  OOvveerrvviieeww

  11..11..

  AAbboouutt tthhiiss HHOOWWTTOO

  This document describes how to setup your 5820/L with LRP the Linux-
  router-project

  If you have any suggestions to this document, than feel free to
  contact me:


  +o  Heimo Schn <heimo.schoen@gmx.at>

  +o  http://fly.to/heimo.schoen

  Have a lot of fun with your PCM5820/L.


  11..22..

  VVeerrssiioonn HHiissttoorryy


  +o  0.1 01 Nov 1999 first trial


  22..

  IInnttrroodduuccttiioonn

  In this chapter I want to discribe what you can do with LRP on a
  PCM5820.  I try to give you a overview from my test equipment.


  22..11..

  TTaarrggeett

  I started to look for small computer solutions when I had to calculate
  a tender for a passanger-information-system project in 1999. There was
  the need for translating different protocols between different
  proprietary protocols.

  In the past our company did this job by developing microcontroller
  boards and developing the applications on this boards for different
  projects. There was a lot of work to manage the hardware- and
  software-releases.

  the idea was to use small and cheap standard hardware and a releable
  cheap operating system. After consulting the internet searchmachines I
  decided that the best choice would be a PC/104 compatible Intel-
  processor board and a small linux-kernel. Therefore I use the
  PCM5820/L board and the fantastic small Linux Kernel from the Linux-
  Router-Project.


  22..22..

  HHWW--CCoonnffiigguurraattiioonn PPCCMM55882200//LL

  For the PCM5920/L onboard features refer to : 5820/L

  In the PCM5820/L I installed 16 MB Memory, a 20 MB Flashdisk
  (Sandisk), a 10MBit HUB for a connection to my Linux-Server at home,
  and a 3 1/2 " Floppy Drive for booting the lrp system.


  22..33..

  SSWW--CCoonnffiigguurraattiioonn LLRRPP

  You should refer to LRP for more details about how LRP works.


  33..

  IInnssttaalllliinngg LLRRPP oonn PPCCMM55882200//LL

  33..11..

  PPaarrttiittiioonnss

  In this step we create partitions on the flashdisk installed in the
  PCM5820/L.


  The partitions are named /dev/hdc, /dev/hdc1, ...  on yor PCM-5820L.
  You should create the following partitions on your flashdisk:


              root@ternitz60:/croot/etc > fdisk /dev/hdc

              Command (m for help): p

              Disk /dev/hdc: 2 heads, 32 sectors, 612 cylinders
              Units = cylinders of 64 * 512 bytes

              Device Boot Start End Blocks Id System
              /dev/hdc1 * 1 150 4784 83 Linux native
              /dev/hdc2 151 612 14784 5 Extended
              /dev/hdc5 151 612 14768 83 Linux native

              Command (m for help):


  33..22..  PPCCMM--55882200 BBoooottffllooppppyy

  Create a PCM5820 bootfloppy and the PCM-5820 LRP-Floppy (you need two
  floppies)


              cp pcm5820_dos_floppy.image /dev/fd0
              cp pcm5820_lrp_floppy.image /dev/fd0


  You can download this floppy-images here:

  pcm5820_lrp_floppy.image

  pcm5820_dos_floppy.image


  33..33..  BBoooott ffrroomm mmyy PPCCMM--55882200 BBoooottffllooppppyy

  Now you made your Floppies and can boot now with your dos-floppy


  33..44..

  ffoorrmmaatt ffllaasshhddiisskk

  Now you can format the boot partition of the flashdisk


              format c:


  33..55..

  bboooottsseeccttoorr oonn ffllaasshhddiisskk

  Now create a bootsektor on the flashdisk.  Dont foreget to unlock the
  flashdisk before writing the bootsektor.


             lock c:
                       (note: answer the question with y)

             syslinux c:


  33..66..

  FFiilleess ttoo ffllaasshhddiisskk

  Now insert the lrp-files floppy and copy all lrp files to the
  flashdisk:


             copy a:*.* c:


  33..77..

  LLRRPP iinnssttaalllleedd

  Remove floppy from floppydrive and reboot the 5820. Now 5820 is
  booting from your new flashdisk!!!

  You should see lrp booting.


  44..

  nnootteess

  44..11..

  WWaattcchhddoogg

  Die Beschreibung des Watchdog in der 5820 Motherboardbeschreibung ist
  schlicht falsch. Hier ein User-Space-Programm das ich zum Laufen
  gebracht habe und das genau das macht was man sich davon erwartet:


  #include <unistd.h>
  #include <stdio.h>
  #include <sys/io.h>

  #define WD_VERSION "V0.1"

  int main(int argc, char ** argv)
  {
    int count=0;
    int retval=0;

    // Allow the Process to access the watchdog-port
    retval = iopl(3);
    if (retval == 0) {
      printf("watchdog " WD_VERSION " started!\n");
      // TODO: print to Logfiles !!!

      for (;;) {

        outb_p(0xff ,0x443);
  /*        retval = inb(0x443); */

  /*        if ( (  retval != 0) || */
  /*         ( (argv[0][0] == '-') && */
  /*           (argv[0][1] == 'd') ) ) */
  /*      printf("%d. inb(0x443) says %d\n", count, retval); */

        usleep(100000);

        // be a little bit verbose all 10 minutes
        count ++;
        if (!(count % 6000)) {
          // TODO: print to Logfiles !!!
          printf("watchdog " WD_VERSION " running since 10 Minutes\n");
          count = 0;
        }

      }

      // Switch of Watchdog
      outb(1, 0x043);
      retval = inb(0x043);
      if ( (  retval != 0) ||
           ( (argv[0][0] == '-') &&
             (argv[0][1] == 'd') ) )
        printf("inb(0x043) says %d\n", retval);

    } else {
      // TODO: print to Logfiles !!!
      printf("watchdog " WD_VERSION " had problems with iopl(3)\n");
      printf("iopl(3) returned %d\n", retval);
      printf("perhaps watchdog didn't run with root privileges\n");
      printf("Try to set sticky-bit on the watchdog executable\n");
      exit(1);
    }
  }


  Nun will man ja nicht jede Sekunde aus dem Userspace auf das Register
  0x443 schreiben und dem Anwenderproze root-Rechte verpassen. Daher
  habe ich nach einer Kerneldriver-Lsung gesucht. Der advantechwdt.c der
  bei jeder gngigen Linux-Distribution enthalten ist, deutete stark auf
  einen 5820 kompatiblen Watchdog-Treiber hin. Dieser funktionierte auch
  nicht auf Anhieb. Um mit z.B.


           echo 1 > /dev/watchdog


  und einem sleep 1 in einer Endlosschleife den Watchdog am Leben zu
  erhalten mu man zuerst in der Datei /etc/modconf folgende Zeile


           alias char-major-10-130 softdog


  auskommentieren und gegen den Start des advantechwdt ersetzen. Statt
  der Zeile sollte das ganze dann so aussehen:


           alias char-major-10-130 advantechwdt


  Nun sind wir so weit, da wir nur durch ein


           echo 1 > /dev/watchdog


  schon unseren advantechwdt geladen bekommen. Leider werden Sie vermut-
  lich auch feststellen, da zwar der Modul geladen ist, in /var/log/mes-
  sages meldet wer brav seine Version, nur rebootet die PCM5820 Kiste
  leider nicht.  Nun auch das lt sich beheben. ;-)

  Wechseln Sie in das Directory /usr/src/linux (oder wo immer Sie ihre
  Kernel-Sourcen haben) und editieren Sie dort die Datei
  drivers/char/advantechwdt.c

  Suchen Sie nach einer Zeile die lautet:


           #define WD_TIMO 60 /* 1 Minute */


  und ndern Sie diese Zeile in :


           #define WD_TIMO 1 /* 1 second */


  Danach bauen Sie Ihre module neu und installieren diese, indem Sie die
  Befehle:


           make modules
           make modules_install


  in Ihrem Kernel-Source Diretory eingeben. Danach entfernen Sie den
  gerade laufenden advantechwdt Modul und laden ihn neu mit:


           rmmod advantechwdt
           modprobe advantechwdt


  Nun sollten Sie in der Lage sein durch ein echo 1 > /dev/watchdog und
  danach 1 Sekunde warten, den Rechner zum Rebooten zu bringen. Nun
  braucht man nur noch in seiner Anwenderapplikation einen Subprozess
  starten, der jede Sekunde ein Byte auf /dev/watchdog schreibt. Wenn
  dieser Prozess fr mehr als 1,6 Sekunden pausiert, wird der PCM5820
  gebootet.

  Have a lot of fun ...


  44..22..

  rrddeevv


             rdev /croot/vmlinuz # Anschauen welche disk als / gemountet wird
             rdev /croot/vmlinuz /dev/hdc2 # anderes Device als / dem Kernel beibringen


  44..33..

  rraammddiisskk


             dd bs=1M count=40 if=/dev/zero of=/cuser/dev/ramdisk
             mke2fs /cuser/dev/ramdisk
             mount /cuser/dev/ramdisk


  44..44..

  PPaakkaaggeess


             /var/lib/lrpkg ......... here you find the pakages on the flashdisk


  55..  AAllllggeemmeeiinneess

  55..11..  CCooppyyrriigghhtt

  Dieses Dokument ist urheberrechtlich geschtzt. Das Copyright liegt bei
  Heimo Schn.

  Das Dokument darf gem der GNU General Public License verbreitet
  werden. Insbesondere bedeutet dieses, da der Text sowohl ber
  elektronische wie auch physikalische Medien ohne die Zahlung von
  Lizenzgebhren verbreitet werden darf, solange dieser Copyright Hinweis
  nicht entfernt wird. Eine kommerzielle Verbreitung ist erlaubt und
  ausdrcklich erwnscht. Bei einer Publikation in Papierform ist der
  Autor zu informieren.

  This howto is free documentation; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of the
  License, or (at your option) any later version.

  This document is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this document; if not, write to the: Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.