.. _`kognihome/tools/kogniwatch`:

KogniWatch
==========

:Kontakt: Alexander Neumann <alneuman@techfak.uni-bielefeld.de> ; Michael adams <madams@techfak.uni-bielefeld.de>
:CITK: Befindet sich zur Zeit nicht im CITK. Der Quellcode ist unter https://synergy.cit-ec.de/git/kognihome.kogniwatch.git
:Vorbedingung:

    Um das Projekt kompilieren zu können, muss `Android Studio <https://developer.android.com/studio>`_ installiert sein.
    Ferner wird ein Lade-/Programmieradapter (rundes Plastikteil) benötigt, da die Uhr nicht über USB verfügt.
    Das Auschecken des Codes und das Flashen der Uhr gestaltet sich mit Android Studio einfach.

:Quickstart:

    KogniWatch ist unter Anwedungen zu finden und kann wie andere Anwendungen der SmartWatch gestartet werden. Durch Touch-Interaktion (lange halten)
    wird der Advertising-Modus (Hintergrund violett) für 10 Sekunden gestartet. Danach geht die Anwendung in
    den scannenden Modus (Hintergrund grau) über, wobei hier auf BLE Advertising Pakete des KogniLinks gewartet werden.
    Die Pakete des KogniLinks beinhalten innerhalb der Advertisement Pakete nun Payload, welcher entscheidet, welche der Uhren die Aktion
    ausführt. Dazu wurde im KogniLink ein Custom-Advertisement Paket vorbereitet, welche das MSB der BLE MAC Addresse der Uhr (z.B. 0xAB)
    und die auszuführende Aktion (0 --> Delivery ; 1 --> Dinner ; 2 --> Medicine) sendet.

Custom Advertising Paket::

    	uint8 adv_data[] = {
		0x02, // field length
		0x01, // field type (0x01) BGLIB_GAP_AD_TYPE_FLAGS
		0x06, // data (0x02 | 0x04 = 0x06, general discoverable + BLE only, no BR+EDR)
		0x03, // field length
		0x00, // field type
		(uint8) address, (uint8) action, 0x00
	};





Enumeration der Aktionen::

    public enum WatchNotificationAction {
        DELIVERY,
        DINNER,
        MEDICINE
    }

:Zuordnung der Smartwatches (Uhren sind markiert):

	+-----------+-------------------+------------------------------------------------------------------+
	| Person    | MAC Adresse       | Funktion                                                         |
	+-----------+-------------------+------------------------------------------------------------------+
	| Heinrich  | F8:95:C7:69:87:40 | Öffnet Tür; Aktiviert Medikamentendispenser                      |
	+-----------+-------------------+------------------------------------------------------------------+
	| Katharina | F8:95:C7:79:DB:86 | Öffnet Tür                                                       |
	+-----------+-------------------+------------------------------------------------------------------+
	| Paul      | F8:95:C7:69:87:80 | Öffnet Tür; Aktiviert Höhenverstellung der Küche                 |
	+-----------+-------------------+------------------------------------------------------------------+
	| Alexander | 88:44:77:20:49:58 | KogniSportsWatch: Aktiviert Personal Coach, überträgt Herzrate   |
	+-----------+-------------------+------------------------------------------------------------------+
	


    Die Uhren entscheiden auf Basis ihrer eigenen (bekannten) Adresse und der Aktion, welche der Uhren die Aktion anzeigt oder ausführt. 
    Nach einer längeren Zeit ohne Aktivität wechselt die Anwendung in den Wartemodus (Hintergrund schwarz).

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

.. rsbpubsub:: IN /io/smartwatch rst.kognihome.WatchNotification Aktiviert das BLE Advertising des *KogniLinks*, worauf die scannende Uhr ihre Aktion durchführt.

.. rsbpubsublist::
    :type: IN