AE-577: Added more details in comment headers.

Author: bogdanf132

examples/Barcode/Barcode.ino

@@ -1,7 +1,16 @@
-/* 
+/*
+ * This example shows how to use the Arduino Portenta C33 USBHIDHost library to read barcodes like the ones printed on common
+ * products packaging.
+ * 
  * 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.
+ * 
+ * Instructions:
+ * 1. Connect your Arduino Portenta C33 to a mid-carrier board;
+ * 2. Upload this sketch to the Portenta;
+ * 3. Open the Serial Monitor and chose the same baud rate as used in the sketch;
+ * 4. Connect your barcode scanner to the USB-A connector on the mid-carrier board and scan away.
  */
 
 #include <Arduino.h>

examples/Keyboard/Keyboard.ino

@@ -1,4 +1,12 @@
-/* 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 */
+/*
+ * 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
+ * 
+ * Instructions:
+ * 1. Connect your Arduino Portenta C33 to a mid-carrier board;
+ * 2. Upload this sketch to the Portenta;
+ * 3. Open the Serial Monitor and chose the same baud rate as used in the sketch;
+ * 4. Connect your keyboard to the USB-A connector and any keypress should be printed to the console window.
+ */
 
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>

examples/KeyboardAndMouse/KeyboardAndMouse.ino

@@ -1,15 +1,21 @@
-/* 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>
-
-/* 
+/*
+ * 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
+ * 
  * 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.
+ *
+ * Instructions:
+ * 1. Connect your Arduino Portenta C33 to a mid-carrier board;
+ * 2. Upload this sketch to the Portenta;
+ * 3. Open the Serial Monitor and chose the same baud rate as used in the sketch;
+ * 4. Connect a USB hub to the USB-A connector on the mid-carrier board;
+ * 5. Now connect your keyboard and mouse to the USB hub and check the printed output on the console when pressing a key on the keyboard or moving the mouse.
  */
 
+#include <Arduino.h>
+#include <Arduino_USBHIDHost.h>
 #include <tusb_config.h>
 
 // Global device instances

examples/Mouse/Mouse.ino

@@ -1,4 +1,13 @@
-/* This simple example shows how to read mouse data, like cursor position and key states, by registering a callback and listening for events */
+/*
+ * This simple example shows how to read mouse data, like cursor position and key states, by registering a callback and listening for events
+ * 
+ * Instructions:
+ * 1. Connect your Arduino Portenta C33 to a mid-carrier board;
+ * 2. Upload this sketch to the Portenta;
+ * 3. Open the Serial Monitor and chose the same baud rate as used in the sketch;
+ * 4. Connect your mouse to the USB-A connector and any movement or keypress should be printed as data to the console.
+ * Please not that scroll wheel data works inconsistently and might not function correctly with your mouse.
+ */
 
 #include <Arduino.h>
 #include <Arduino_USBHIDHost.h>