Working on BT/BLE API

Author: mirkosertic

README.md

@@ -1,15 +1,15 @@
 # Megahub
 
-[![PlatformIO CI](https://github.com/mirkosertic/Megahub/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/mirkosertic/Megahub/actions/workflows/build.yml)
+![PlatformIO CI](https://github.com/mirkosertic/Megahub/actions/workflows/build.yml/badge.svg?branch=main)
 
 ## Introduction
 
-Megahub is an ESP32-based alternative hub designed for LEGO© enthusiasts and robotics builders. It combines the flexibility of the ESP32 platform with native support for LEGO© WeDo/Powered Up! devices, offering both Lua scripting and Blockly visual programming for easy control and automation.
+Megahub is an ESP32-based alternative hub designed for LEGO© enthusiasts and robotics builders. It combines the flexibility of the ESP32 platform with native support for LEGO© WeDo/Powered Up! devices, offering both Lua scripting and Blockly visual programming for easy control and automation.
 
-This project provides a powerful, open-source alternative to proprietary solutions, giving makers complete control over their robotic creations while maintaining compatibility with popular LEGO© sensors and motors.
+This project provides a powerful, open-source alternative to proprietary solutions, giving makers complete control over their robotic creations while maintaining compatibility with popular LEGO© sensors and motors.
 It comes with the hardware schematics, production files and the Megahub firmware as a PlatformIO project as well.
 
-** Build and use it at your own Risk!! **
+\*\* Build and use it at your own Risk!! \*\*
 
 ## Key Features
 
@@ -19,7 +19,7 @@ It comes with the hardware schematics, production files and the Megahub firmware
 - **IDE**: Configure and program Megahub through the intuitive [Megahub IDE](https://mirkosertic.github.io/Megahub/)
 - **Visual Programming Interface**: Blockly visual programming for beginners
 - **SD-Card**: Built-in SD-card reader to store multiple projects (autostart possible)
-- **4 UART Ports**: Connect up to 4 LEGO© WeDo/Powered Up! devices simultaneously (motors, sensors, etc.)
+- **4 UART Ports**: Connect up to 4 LEGO© WeDo/Powered Up! devices simultaneously (motors, sensors, etc.)
 - **Built-in IMU**: Integrated MPU6050 6-axis accelerometer and gyroscope for motion sensing
 - **FastLED/NeoPixel Support**: Built-in support for addressable RGB LED strips
 - **Flexible GPIO**: Additional GPIO pins available for custom sensors, buttons, and peripherals
@@ -36,17 +36,17 @@ It comes with the hardware schematics, production files and the Megahub firmware
 
 ## How It Differs from Existing Solutions
 
-### vs. LEGO© Powered Up!
+### vs. LEGO© Powered Up!
 
 - **Open Source**: Complete control over firmware and functionality
 - **Expandable**: Access to additional GPIO pins for custom hardware
 - **Programming Flexibility**: Choose between Lua scripting or visual programming
 - **Built-in Features**: Integrated IMU and LED controller without additional hubs
 - **Cost-effective**: Based on affordable ESP32 hardware
 
-### vs. fischertechnik© RX Controller
+### vs. fischertechnik© RX Controller
 
-- **LEGO Compatibility**: Native support for LEGO© WeDo 2.0 protocol
+- **LEGO Compatibility**: Native support for LEGO© WeDo 2.0 protocol
 - **Web-based Programming**: No proprietary software required
 - **Cost-effective**: Based on affordable ESP32 hardware
 - **Visual Programming**: Blockly support makes it accessible for all skill levels
@@ -63,5 +63,4 @@ It comes with the hardware schematics, production files and the Megahub firmware
 
 ## Getting Started
 
-Documentation coming soon...
-
+Documentation coming soon...

lib/btremote/include/btremote.h

@@ -2,20 +2,19 @@
 #define BTREMOTE_H
 
 #include "configuration.h"
-#include "megahub.h"
-
-#include <ArduinoJson.h>
-#include <map>
-#include <vector>
-
 #include "esp_bt.h"
+#include "esp_bt_defs.h"
 #include "esp_bt_main.h"
 #include "esp_gap_ble_api.h"
+#include "esp_gap_bt_api.h"
 #include "esp_gatt_common_api.h"
 #include "esp_gatts_api.h"
-#include "esp_gap_bt_api.h"
-#include "esp_bt_defs.h"
 #include "esp_hidh_api.h"
+#include "megahub.h"
+
+#include <ArduinoJson.h>
+#include <map>
+#include <vector>
 
 enum class ProtocolMessageType : uint8_t {
 	REQUEST = 0x01,
@@ -112,38 +111,23 @@ struct HIDDevice {
 	uint32_t handle;
 };
 
-// HID Report Data for Gamepad Processing
-struct HIDReportData {
-	uint8_t reportId;
-	uint8_t reportType;
-	uint16_t length;
-	uint8_t data[64]; // Max HID report size
-	uint32_t timestamp;
-};
-
 // Gamepad State - Standard HID gamepad layout
 struct GamepadState {
 	esp_bd_addr_t address;
 	bool connected;
 	uint32_t timestamp;
+	uint16_t vendorId;
+	uint16_t productId;
 
-	// Buttons (bit field): 0=A, 1=B, 2=X, 3=Y, 4=L1, 5=R1, 6=L2, 7=R2,
-	//                      8=Select, 9=Start, 10=L3, 11=R3, 12-15=Reserved
 	uint16_t buttons;
 
-	// D-Pad (hat switch): 0=up, 1=up-right, 2=right, 3=down-right,
-	//                     4=down, 5=down-left, 6=left, 7=up-left, 8=center
 	uint8_t dpad;
 
-	// Analog sticks (range: -127 to 127, center=0)
-	int8_t leftStickX;
-	int8_t leftStickY;
-	int8_t rightStickX;
-	int8_t rightStickY;
-
-	// Triggers (range: 0 to 255)
-	uint8_t leftTrigger;
-	uint8_t rightTrigger;
+	// Analog sticks (16-bit signed, range: -32768 to 32767, center=0)
+	int16_t leftStickX;
+	int16_t leftStickY;
+	int16_t rightStickX;
+	int16_t rightStickY;
 };
 
 // HID Event Queue Item for async processing

lib/btremote/include/hidreportparser.h

@@ -0,0 +1,111 @@
+#pragma once
+
+#include <Arduino.h>
+#include <ArduinoJson.h>
+#include <vector>
+
+/**
+ * @brief Parser for HID Report Descriptors
+ *
+ * Parses binary HID report descriptors according to the USB HID specification
+ * and converts them to human-readable JSON format for debugging purposes.
+ */
+class HIDReportParser {
+public:
+	/**
+	 * @brief Parse a HID report descriptor and output as JSON to Serial
+	 *
+	 * @param descriptor Pointer to the descriptor data
+	 * @param length Length of the descriptor in bytes
+	 */
+	static void parseAndPrintJSON(const uint8_t *descriptor, size_t length);
+
+private:
+	// HID Item Type (bits 2-3 of prefix byte)
+	enum ItemType {
+		ITEM_TYPE_MAIN = 0,
+		ITEM_TYPE_GLOBAL = 1,
+		ITEM_TYPE_LOCAL = 2,
+		ITEM_TYPE_RESERVED = 3
+	};
+
+	// Main Item Tags
+	enum MainItemTag {
+		MAIN_INPUT = 0x8,
+		MAIN_OUTPUT = 0x9,
+		MAIN_COLLECTION = 0xA,
+		MAIN_FEATURE = 0xB,
+		MAIN_END_COLLECTION = 0xC
+	};
+
+	// Global Item Tags
+	enum GlobalItemTag {
+		GLOBAL_USAGE_PAGE = 0x0,
+		GLOBAL_LOGICAL_MIN = 0x1,
+		GLOBAL_LOGICAL_MAX = 0x2,
+		GLOBAL_PHYSICAL_MIN = 0x3,
+		GLOBAL_PHYSICAL_MAX = 0x4,
+		GLOBAL_UNIT_EXPONENT = 0x5,
+		GLOBAL_UNIT = 0x6,
+		GLOBAL_REPORT_SIZE = 0x7,
+		GLOBAL_REPORT_ID = 0x8,
+		GLOBAL_REPORT_COUNT = 0x9,
+		GLOBAL_PUSH = 0xA,
+		GLOBAL_POP = 0xB
+	};
+
+	// Local Item Tags
+	enum LocalItemTag {
+		LOCAL_USAGE = 0x0,
+		LOCAL_USAGE_MIN = 0x1,
+		LOCAL_USAGE_MAX = 0x2,
+		LOCAL_DESIGNATOR_INDEX = 0x3,
+		LOCAL_DESIGNATOR_MIN = 0x4,
+		LOCAL_DESIGNATOR_MAX = 0x5,
+		LOCAL_STRING_INDEX = 0x7,
+		LOCAL_STRING_MIN = 0x8,
+		LOCAL_STRING_MAX = 0x9,
+		LOCAL_DELIMITER = 0xA
+	};
+
+	// Collection types
+	enum CollectionType {
+		COLLECTION_PHYSICAL = 0x00,
+		COLLECTION_APPLICATION = 0x01,
+		COLLECTION_LOGICAL = 0x02,
+		COLLECTION_REPORT = 0x03,
+		COLLECTION_NAMED_ARRAY = 0x04,
+		COLLECTION_USAGE_SWITCH = 0x05,
+		COLLECTION_USAGE_MODIFIER = 0x06
+	};
+
+	/**
+	 * @brief Parse the descriptor and build a JSON document
+	 */
+	static JsonDocument parseDescriptor(const uint8_t *descriptor, size_t length);
+
+	/**
+	 * @brief Get the name of a usage page
+	 */
+	static const char* getUsagePageName(uint16_t usagePage);
+
+	/**
+	 * @brief Get the name of a usage for a given usage page
+	 */
+	static const char* getUsageName(uint16_t usagePage, uint16_t usage);
+
+	/**
+	 * @brief Get the name of a collection type
+	 */
+	static const char* getCollectionTypeName(uint8_t type);
+
+	/**
+	 * @brief Decode input/output/feature flags
+	 */
+	static void decodeIOFlags(JsonObject &obj, uint32_t flags);
+
+	/**
+	 * @brief Extract signed or unsigned value from item data
+	 */
+	static int32_t extractValue(const uint8_t *data, uint8_t size, bool isSigned = false);
+};