summaryrefslogtreecommitdiff
path: root/examples/device/webusb_serial/src
diff options
context:
space:
mode:
authorhathach <[email protected]>2021-03-10 11:23:44 +0700
committerhathach <[email protected]>2021-03-10 11:23:44 +0700
commit4a73b6a21930c71368153fe4197b96f9d100fc4c (patch)
tree431ca32797b665b5c9a76b2fefa5549caa8d9bb8 /examples/device/webusb_serial/src
parent2adb7e719316b12c53a907153cfa0056db1abd70 (diff)
update doc for BOARD name, add note for udev on Linux
Diffstat (limited to 'examples/device/webusb_serial/src')
-rw-r--r--examples/device/webusb_serial/src/main.c20
1 files changed, 20 insertions, 0 deletions
diff --git a/examples/device/webusb_serial/src/main.c b/examples/device/webusb_serial/src/main.c
index 143a73374..6a5a9fa61 100644
--- a/examples/device/webusb_serial/src/main.c
+++ b/examples/device/webusb_serial/src/main.c
@@ -23,6 +23,26 @@
*
*/
+/* This example demonstrates WebUSB as web serial with browser with WebUSB support (e.g Chrome).
+ * After enumerated successfully, browser will pop-up notification
+ * with URL to landing page, click on it to test
+ * - Click "Connect" and select device, When connected the on-board LED will litted up.
+ * - Any charters received from either webusb/Serial will be echo back to webusb and Serial
+ *
+ * Note:
+ * - The WebUSB landing page notification is currently disabled in Chrome
+ * on Windows due to Chromium issue 656702 (https://crbug.com/656702). You have to
+ * go to landing page (below) to test
+ *
+ * - On Windows 7 and prior: You need to use Zadig tool to manually bind the
+ * WebUSB interface with the WinUSB driver for Chrome to access. From windows 8 and 10, this
+ * is done automatically by firmware.
+ *
+ * - On Linux/macOS, udev permission may need to be updated by
+ * - copying '/examples/device/99-tinyusb.rules' file to /etc/udev/rules.d/ then
+ * - run 'sudo udevadm control --reload-rules && sudo udevadm trigger'
+ */
+
#include <stdlib.h>
#include <stdio.h>
#include <string.h>