===============================
AdvaBoard RPi1 SysVinit-scripts
===============================

Installation / Configuration
----------------------------

The SysVinit-scripts can be installed and partly configured with the
``advaboard_rpi1_setup.sh``-script.

Alternatively, they can be installed manually by using::

    cd advaboard_rpi1-VERSION
    sudo make install_sysvinit

Rasbperry Pi power
------------------
:SeeAlso:
    http://www.advamation.de/produkte/embeddedpc/advaboard_rpi1/rpi-onoff.html (German)

Poweroff Raspberry Pi after shutdown
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Cut power from Raspberry Pi at ``poweroff``:

- The software includes some init-scripts which can tell the AdvaBoard to
  power-off the Raspberry after shutdown.

- If you're currently using a micro-USB power supply connected to the
  Raspberry Pi, replace this power supply by a 5V power supply connected
  to the AdvaBoard RPi1.

- optionally: edit ``/etc/default/am_rpi_power``:

  - OFF_DELAY: time to wait in secons between shutdown and poweroff
    (default: 5)
  - EVENT_HANDLER_NUMBER: number of the power-event-handler
    (default: 1)
  - RTC_ALARM_NUMBER: number of the RTC-alarm for poweroff
    (default: 1)
  - ON_*:  power-on/off-state of the components at boot
  - OFF_*: power-on/off-state of the components after poweroff

- enable::

    sudo update-rc.d am_rpi_power.sh defaults

- disable::

    sudo update-rc.d am_rpi_power.sh disable

- Remove the red jumper "RPi5V" from the AdvaBoard RPi1.


Turn Raspberry Pi on/off with a button
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:See:
    http://www.advamation.de/produkte/embeddedpc/advaboard_rpi1/rpi-onoff.html
    (currently only in German)


RTC
---
TODO


TFT-Display/Touchscreen
-----------------------
:Note:
    Since the installation and configuration of the display and the touchscreen
    is integrated into the AdvaBoard-setup-script, it's probably easier to use
    ``advaboard_rpi1_setup.sh`` instead of the following instructions.

Start display/framebuffer/touchscreen automatically during boot:

- Calibrate the touchscreen::

    sudo am_rpi_tft_tool -t TFT_32 -m TP_CALIB -f /etc/am_rpi_touchpanel.calib

  (replace TFT_32 by your display-type)

- Edit the configuration-file ``/etc/default/am_rpi_framebuffer``,
  to adapt it to your display-type, -rotation etc.

  You could also set ``USE_FB0=1`` to use the default HDMI-framebuffer,
  and ``TP_MODE="1"`` to turn on mouse-emulation for the touchscreen
  (which seems to be necessary for SDL without X11).

- enable (see also: ``man update-rc.d``)::

    update-rc.d am_rpi_framebuffer.sh defaults
    update-rc.d am_rpi_touchpanel.sh defaults

- disable::

    update-rc.d am_rpi_framebuffer.sh disable
    update-rc.d am_rpi_touchpanel.sh disable

- optionally: Configure X11:
  
  - Copy the included X11-configuration-file to /etc/X11::

        cp ../xorg.conf /etc/X11/

  - Select the desired X11 layout by editing ``/etc/X11/xorg.conf``, e.g.::

        Section "ServerFlags"
            Option "DefaultServerLayout" "HDMI_FB"
        EndSection

  - If you use several framebuffer-devices, you may have to replace ``/dev/fb1``
    by the appropriate device.