docs updated

Author: fabiankuffer

components/ble/gap.c

@@ -172,6 +172,7 @@ int bleGAPEevent(struct ble_gap_event *event, void *arg) {
         }
         break;
     case BLE_GAP_EVENT_REPEAT_PAIRING:
+        //https://ubuntu.com/core/docs/bluez/reference/pairing/introduction
         /* We already have a bond with the peer, but it is attempting to
          * establish a new secure link.  This app sacrifices security for
          * convenience: just throw away the old bond and accept the new link.

docs/BLE-Debugging.md

@@ -0,0 +1,93 @@
+# iOS
+- Unter iOS kann die App [LightBlue](https://punchthrough.com/lightblue/) verwendet werden. Zu beachten ist das Apple bei einigen Diensten nicht die rohen Daten an 3rd party Apps weitergeben [S. 197](https://developer.apple.com/accessories/Accessory-Design-Guidelines.pdf). Dadurch können manche Daten nicht gedebugged werden. Ein Service ist beispielsweise HID.
+- Eine weitere Möglichkeit für das Debugging für iOS ist mit einem Macbook auf dem XCode läuft. Dafür gibt es [PacketLogger](https://developer.apple.com/bluetooth/) womit Bluetooth-Pakete live gelogged werden können. Zusätzlich muss auf dem iOS-Gerät ein Logging-Profil heruntergeladen werden und installiert werden.
+
+# Android
+- Unter Android können die Apps [LightBlue](https://punchthrough.com/lightblue/) und [nRF Connect](https://play.google.com/store/apps/details?id=no.nordicsemi.android.mcp&hl=en&gl=US) verwendet werden. Dort können mehr Daten / Dienste wie unter iOS ausgelesen werden.
+- In den Entwickleroptionen kann "Bluetooth HCI-Snoop-Protokoll aktiviert" werden und die Daten gelogged werden und später mittels Wirekshark ausgelesen werden.
+
+# Linux
+- Tools: hcitool, gatttool, bluetoothctl, hidraw-dump, Bluepy
+
+## hcitool
+
+### Verfügbares Bluetoothgerät am Linuxrechner
+`hcitool dev`
+
+### Scan for BLE-Devices
+`sudo hcitool lescan`
+
+## gatttool
+
+### Verbindung aufbauen
+1. `sudo gatttool [-t random] -b <BLE ADDRESS> -I`
+2. `connect`
+
+### Liste aller vorhandenen Dienste aufzeigen
+`primary`
+
+### Liste aller vorhandenen Handles
+Jeder Handle ist ein Verbindungspunkt, wo Daten gelesen oder geschrieben werden können.
+
+`char-desc`
+
+### Ein Handle auslesen
+`char-read-hnd <handle>`
+
+### Schreiben eines Werts in ein Handle
+`char-write-req <handle> <data>`
+
+## bluetoothctl
+`sudo bluetoothctl`
+
+### Geräte suchen
+`scan le`
+
+### Gerät verbinden
+`connect <BLE ADDRESS>`
+
+### Info des Geräts
+`info`
+
+### Menü wechseln, damit mit GATT gearbeitet werden kann
+`menu gatt`
+
+#### Attributliste
+`list-attributes`
+
+#### Attribut auslesen
+- `select-attribute <Pfad>`
+- `read`
+
+## hidraw-dump
+
+### Installation
+- `sudo apt-get install build-essential pkg-config libudev-dev`
+- `git clone https://github.com/todbot/hidraw-dump`
+- `cd hidraw-dump`
+- `make`
+
+### Auslesen aller HID-Deskriptoren
+`sudo ./hidraw-dump`
+
+### HID Deskriptor menschen lesbar machen
+Auf dieser [Website](https://eleccelerator.com/usbdescreqparser/) umwandeln.
+
+## Bluepy
+
+### Installation
+1. `sudo apt-get install bluetooth build-essential libglib2.0-dev libdbus-1-dev`
+2. `git clone https://github.com/IanHarvey/bluepy.git`
+3. `cd bluepy/bluepy`
+4. `make`
+
+### Verwendung
+
+#### Starten
+`./bluepy-helper`
+
+#### Verbinden
+`conn <BT ADDRESS>`
+
+#### Liste von Diensten
+`svcs`

docs/links

@@ -0,0 +1,28 @@
+# Apple
+- [Connect Bluetooth Controller](https://support.apple.com/en-us/HT210414)
+- [About External Accessories](https://developer.apple.com/library/archive/featuredarticles/ExternalAccessoryPT/Introduction/Introduction.html)
+- [Working with Accessories](https://developer.apple.com/accessories/)
+- [Bluetooth](https://developer.apple.com/bluetooth/)
+- [Game Controller Framework](https://developer.apple.com/documentation/gamecontroller)
+- [Connecting Game Controllers via Bluetooth](https://kb.plugable.com/bluetooth-adapter/connecting-game-controllers-via-bluetooth)
+- [iOS: Xbox Series X-Controller mit iPhoone und iPad verbinden](https://amp.netzwelt.de/news/183500-ios-xbox-series-x-controller-iphone-ipad-verbinden.html)
+- [Kabellosen Xbox-Spielecontroller mit deinem Apple-Gerät verbinden](https://support.apple.com/de-de/HT211232)
+- [clarification for iOS compatibility note](https://github.com/lemmingDev/ESP32-BLE-Gamepad/issues/50#issuecomment-862770124)
+
+# Linux
+## XBox Controller
+- [How to use Xbox One controllers over Bluetooth on Linux](https://www.addictivetips.com/ubuntu-linux-tips/xbox-one-controllers-over-bluetooth-linux/amp/)
+- [XBox ONE Wireless Controller über Bluetooth nutzen](https://wiki.ubuntuusers.de/Howto/XBox_ONE_Wireless_Controller_%C3%BCber_Bluetooth_nutzen/)
+- [Xbox (One) Wireless Controller won't connect](https://bugs.launchpad.net/ubuntu/+source/gnome-control-center/+bug/1750146)
+
+## BLE
+- [How to Get Started with Bluetooth Low Energy on Linux](https://www.jaredwolff.com/get-started-with-bluetooth-low-energy/)
+- [Accesssing GATT Services](https://ubuntu.com/core/docs/bluez/reference/accessing-gatt-services)
+- [hidraw-dump](https://github.com/todbot/hidraw-dump)
+- [BLE on Linux with bluetoothclt](https://budimir.cc/2020/02/27/ble-on-linux-with-bluetoothctl/amp/)
+- [Communication with Bluetooth Low-Energy Devices on Linux](https://macchina.io/blog/internet-of-things/communication-with-low-energy-bluetooth-devices-on-linux/)
+- [Practical Guide to Bluetooth Hacking](https://blog.attify.com/the-practical-guide-to-hacking-bluetooth-low-energy/)
+
+# Microsoft
+## XInput
+- [Xinput support](https://github.com/lemmingDev/ESP32-BLE-Gamepad/issues/137)