.. _`tp2/ble`:

KogniDoor-BLE-Grabber
=====================

:Kontakt: Michael Adams <madas@techfak.uni-bielefeld.de>
:CITK: `kognidoor-ble-grabber <https://opensource.cit-ec.de/projects/citk/repository/revisions/master/entry/projects/kognidoor-ble-grabber.project>`_
:Vorbedingung:
    Der Grabber benötigt `Bluegiga BLED112 <https://www.silabs.com/products/wireless/bluetooth/bluetooth-smart-modules/Pages/bled112-bluetooth-smart-dongle.aspx>`_
    Bluetooth-Dongle. Diese müssen angeschlossen sein, als TTY/COM-Device (i.d.R. zu finden unter */dev/ttyACMx*, wobei x ∈ ℕ) erreichbar und der Nutzer muss sowohl Lese-
    als auch Schreibrechte für diese seriellen Schnittstellen (i.d.R. Gruppe *dialout*; *sudo usermod -a -G groupName userName*)  besitzen.
:Quickstart:

    Der Ble-Grabber benötigt die Adresse der beiden Endpunkte::

        $ ble-grabber <ADDRESS1> <ADDRESS2>
        $ ble-grabber /dev/ttyACM0 /dev/ttyACM1

    Alternativ kann das Skript ``get_tty``, welches in :ref:`tools/kogniconfig` verfügbar ist genutzt werden. Dies
    bietet sich vor allem für die Automatisierung an und für die Fälle in denen die zugewiesenen TTY-Adressen nicht
    fix sind::

        $ ble-grabber `get_tty.py 0x2458`

    Der übergebene String ``0x2458`` entspricht der :term:`VendorID` der Bluetooth-Dongle.

RSB-Schnittstellen
------------------

.. rsbpubsub:: IN /io/control/bluetooth/outside bool Aktiviert/Deaktiviert das Grabbing auf der Außenseite der Tür
.. rsbpubsub:: IN /io/control/bluetooth/inside bool Aktiviert/Deaktiviert das Grabbing auf der Innenseite der Tür

.. rsbpubsublist::
    :type: IN

.. rsbpubsub:: OUT-Pub-1 /io/emr/bluetooth/outside rst.door.BluetoothInfo Sendet Daten der aufgezeichneten
    Advertising-Pakete von der Aussenseite der Tür
.. rsbpubsub:: OUT-Pub-1 /io/emr/bluetooth/inside rst.door.BluetoothInfo Sendet Daten der aufgezeichneten
    Advertising-Pakete von der Innenseite der Tür

.. rsbpubsublist::
    :type: OUT