AE-577: Added basic comments to example sketches to explain their intended purpose; Implemented in "KeyboardAndMouse" sketch the same solution to print mouse data to console, as used in the "Mouse" example.

Author: bogdanf132

examples/Barcode/Barcode.ino

@@ -1,3 +1,9 @@
+/* 
+ * By connecting a  handheld  barcode  reader  to the USB-A port  on  the  mid-carrier board  of  your Arduino Portenta C33,
+ * you  should  immediately  be  able to  read standard 13-digit  bar codes  on any  ordinary  commercial  product packaging.
+ * Please note that barcodes longer than 13 digits will result in the "Invalid character detected, resetting..." being printed.
+ */
+
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>
 

examples/Keyboard/Keyboard.ino

@@ -1,3 +1,5 @@
+/* This simple example shows how to read keyboard data by both listening for events and polling for available character data in the internal buffers of the USB HID Host */
+
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>
 
@@ -17,15 +19,16 @@ void setup() {
   while (!Serial);
 
   kb.attachConnectionCallback(onKeyboardConnected);
-  kb.attachKeyboardEventCallback(onKeyboardEvent);
+  kb.attachKeyboardEventCallback(onKeyboardEvent); // Register callback to get the keystrokes via events
   kb.begin();
 }
 
 void loop() {
   kb.poll();
 
+  // Second way of reading back the keystrokes is via polling for available characters
   while (kb.available() > 0) {
     char c = kb.read();
-    Serial.print(c);
+    Serial.println(c);
   }
 }

examples/KeyboardAndMouse/KeyboardAndMouse.ino

@@ -1,10 +1,24 @@
+/* This simple example demonstrates how to read mouse and keyboard data, by connecting these devices at the same time to the Portenta, via a USB hub */
+
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>
 
+/* 
+ * In order to use two (or more) HID devices connected via a USB hub to your Portenta C33 board, please open "tusb_config.h" below (right click -> Go To Definition)
+ * and make sure that "CFG_TUH_HUB" is set to value 1, and that "CFG_TUH_HID" is set to the number of HID devices you intend to connect to your Arduino (2 in this example). 
+ * Please also keep in mind that some keyboards and mice which include advanced illumination features might draw more power than the Arduino is able to provide on its
+ * USB-A port and might therefore lead to a reset or failure to be enumerated by the board. Ideally, use basic USB keyboards and mice, these should work best.
+ */
+
+#include <tusb_config.h>
+
 // Global device instances
 USBHIDKeyboard kb;
 USBHIDMouse ms;
 
+HIDMouseEvent mouseEvent;
+bool eventReceived = false;
+
 // Keyboard connection callback
 void onKeyboardConnected() {
   Serial.println("Keyboard connected (callback).");
@@ -23,14 +37,8 @@ void onMouseConnected() {
 
 // Mouse movement/button event callback
 void onMouseEvent(const HIDMouseEvent &event) {
-  Serial.print("Mouse event (callback) - Buttons: ");
-  Serial.print(event.buttons);
-  Serial.print(", x: ");
-  Serial.print(event.xMovement);
-  Serial.print(", y: ");
-  Serial.print(event.yMovement);
-  Serial.print(", wheel: ");
-  Serial.println(event.wheelMovement);
+  eventReceived = true;
+  mouseEvent = event;
 }
 
 void setup() {
@@ -55,12 +63,15 @@ void loop() {
   kb.poll();
   ms.poll();
 
-  // Optional: Read keyboard characters from buffer
-  while (kb.available() > 0) {
-    char c = kb.read();
-    Serial.print("Buffered keystroke: ");
-    Serial.println(c);
-  }
-
-  // You can also process mouse state if needed
+  if(eventReceived){
+    Serial.print("Mouse event (callback) - Buttons: ");
+    Serial.print(mouseEvent.buttons);
+    Serial.print(", x: ");
+    Serial.print(mouseEvent.xMovement);
+    Serial.print(", y: ");
+    Serial.print(mouseEvent.yMovement);
+    Serial.print(", wheel: ");
+    Serial.println(mouseEvent.wheelMovement);
+    eventReceived = false;
+   }
 }

examples/Mouse/Mouse.ino

@@ -1,3 +1,5 @@
+/* This simple example shows how to read mouse data, like cursor position and key states, by registering a callback and listening for events */
+
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>