.. index::
   single: IOC; VME; mvme2100

======================
VME Bus CPU with RTEMS
======================

IDCP is an
`EPICS <http://www.aps.anl.gov/epics/about.php>`_ application
that runs on an
`IOC <https://docs.epics-controls.org/en/latest/guides/EPICS_Intro.html?highlight=IOC#ioc-software-components>`.

This document describes how to set up a
`VME Bus <https://en.wikipedia.org/wiki/VMEbus>`_
`mvme2100 <https://bitsavers.trailing-edge.com/pdf/motorola/VME/MVME2100/MVME2100_Brochure.pdf>`_
CPU
with `RTEMS <https://www.rtems.org>`_ 4.9 for this IOC.

.. note::
   IDCP can now also run on a PC with Linux and a PCAN-PCI CAN bus card, see :doc:`LinuxPC`.

Set up NVRAM
------------

Preparations
++++++++++++

Unplug jumper J9 on the CPU board.

Set up real-time clock
++++++++++++++++++++++

Switch on the board and enter the command::

  time

If it shows that the real time clock is not running, enter::

  set MMDDYYHHMM

where 'MM' is the month, 'DD' the day, 'YY' the year, 'HH' the hour and 'MM'
(at the end) the minutes.

Set up boot information
+++++++++++++++++++++++

Enter::

  niot

At each prompt shown press <ENTER> until you see::

  Client IP Address

There enter the IP address of the VME board. You can use <backspace> to delete
an address and enter a new one. Then press <ENTER>. At::

  Server IP Address

enter the IP address of your tftp boot server.

At the following prompts enter the correct network settings::

  Subnet IP Address Mask
  Broadcast IP Address
  Gateway IP Address

Now at::

  Boot File Name ("NULL" for None)

enter the file name of the boot file. The IOC loads this file with the TFTP
protocol from the boot server. It is recommended that this is a RTEMS 4.9 kernel
with cexp shell.

Now press <ENTER> until you see the prompt::

  Boot File Load Address

then press dot ('.') and <ENTER>.

At::

  Update Non-Volatile RAM (Y/N)

press 'Y' and <ENTER>.

Set up auto boot
++++++++++++++++

Enter::

  env

Now press <ENTER> (about 6 times) until you see the prompt::

  Network PReP -Boot Mode Enable [Y/N]

press 'Y' and <ENTER>.

Now press <ENTER> (about 23 times) until you see the prompt::

  Network Auto Boot Enable [Y/N]

press 'Y' and <ENTER>.

At the prompt::

  Update Non-Volatile RAM (Y/N)

press 'Y' and <ENTER>.

At the prompt::

  Reset Local System (CPU) (Y/N)

press 'Y' and <ENTER>.

Monitor the boot process
++++++++++++++++++++++++

If the RTEMS 4.9 kernel is loaded, you can use the command 'bootChange()' to enter
the boot parameter.

Configure boot parameters
+++++++++++++++++++++++++

To change the boot parameters enter::

  bootChange()

You can press <ENTER> if a parameter should remain unchanged or enter a new value.

.. note::
   The actual boot parameters for the :doc:`sites <sites>` where IDCP is used
   can be found at :doc:`List of IOC Bootparameters <id_ioc_bootparameters>`.

Below you find the *generic description*::

  boot device          : dc
  unit number          : 1
  processor number     : 0
  host RSH mount point : vwhost

At 'file name' enter the name of the boot file, usually a file named 'rtems.bin'::

  file name            : <rtems binary>

The following three parameters configure your network::

  inet on ethernet (e) : <IOC IP ADDRESS>:ffffff00
  inet on backplane (b): <ENTER>
  host inet (h)        : <SERVER IP ADDRESS>
  gateway inet (g)     : <IP GATEWAY>

Configure the user name the IOC uses to log on to the server::

  user (u)             : <USER>

Leave ftp password unchanged::

  ftp password (pw) (blank = use rsh): <ENTER>

The flags should always have this value::

  flags (f)            : 0xa

The target name is the hostname of the IOC::

  target name (tn)     : <IOC HOSTNAME>

The startup script is the script the IOC loads at boot::

  startup script (s)   : <STARTUP SCRIPT>

Leave NFS setting unchanged::

  NFS [server:]mnt (o) : <ENTER>