Handle Service
=====================

If the handle sevice is activated, it triggers the following behaviour once:

- handle is turned on and the color is set to blue
- when the corresponding door or drawer is opened, the handle changes its color to green
- when the corresponding door or drawer is closed again, the handle is turned off


Related resources
-----------------

Component repository:
 - Browse component repository: `handle service <https://projects.cit-ec.uni-bielefeld.de/projects/lsp-csra/repository/utils>`_.
 - ``git clone https://projects.cit-ec.uni-bielefeld.de/git/lsp-csra.utils.git``

System startup:
 - The handle service can be found in ``lsp-csra-base.sh`` on the ``base`` tab.
 - The component script is called ``handle_service``.

Related components:
 - Browse repository `system-startup <https://projects.cit-ec.uni-bielefeld.de/projects/lsp-csra/repository/system-startup>`_.
 - Browse project `inkg <https://projects.cit-ec.uni-bielefeld.de/projects/inkg/repository>`_.




Interfaces
----------------

At present we only have a handle service for the handle with id ``503``.

======================================================= ======================================= 
Scope (Listener)                                        Type                                    
======================================================= ======================================= 
``/home/kitchen/handleservice/<handle_id>``                                          
``/home/kitchen/reedswitch/<handle_id>``                 `ReedSwitch`_                            
======================================================= =======================================

.. _ReedSwitch: http://docs.cor-lab.de//rst-manual/trunk/html/generated/sandbox/package-rst-homeautomation.html#rst.homeautomation.unit.ReedSwitch


============================================================== ===================== ==================
Scope (Remote Server) + Method                                 Argument Type         Return Type       
============================================================== ===================== ==================
 ``/home/kitchen/ambientlight/<handle_id>/ctrl/setStatus()``    `AmbientLight`_
============================================================== ===================== ==================

.. _AmbientLight: http://docs.cor-lab.de//rst-manual/trunk/html/generated/sandbox/package-rst-homeautomation.html#rst.homeautomation.unit.AmbientLight


Examples
--------------

Start a handle service for handle with id 503:

.. code-block:: bash
   :emphasize-lines: 1

    > $prefix/bin/handle_service.py 503



Activate the handle service:

.. code-block:: bash
   :emphasize-lines: 1

    > $prefix/bin/tools0.12 send "" /home/kitchen/handleservice/503