/* * The MIT License (MIT) * * Copyright (c) 2019 Ha Thach (tinyusb.org) * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. * */ /* 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 #include #include #include "bsp/board.h" #include "tusb.h" #include "usb_descriptors.h" //--------------------------------------------------------------------+ // MACRO CONSTANT TYPEDEF PROTYPES //--------------------------------------------------------------------+ /* Blink pattern * - 250 ms : device not mounted * - 1000 ms : device mounted * - 2500 ms : device is suspended */ enum { BLINK_NOT_MOUNTED = 250, BLINK_MOUNTED = 1000, BLINK_SUSPENDED = 2500, BLINK_ALWAYS_ON = UINT32_MAX, BLINK_ALWAYS_OFF = 0 }; static uint32_t blink_interval_ms = BLINK_NOT_MOUNTED; #define URL "example.tinyusb.org/webusb-serial/index.html" const tusb_desc_webusb_url_t desc_url = { .bLength = 3 + sizeof(URL) - 1, .bDescriptorType = 3, // WEBUSB URL type .bScheme = 1, // 0: http, 1: https .url = URL }; static bool web_serial_connected = false; //------------- prototypes -------------// void led_blinking_task(void); void cdc_task(void); void webserial_task(void); /*------------- MAIN -------------*/ int main(void) { board_init(); // init device stack on configured roothub port tud_init(BOARD_TUD_RHPORT); while (1) { tud_task(); // tinyusb device task cdc_task(); webserial_task(); led_blinking_task(); } } // send characters to both CDC and WebUSB void echo_all(uint8_t buf[], uint32_t count) { // echo to web serial if ( web_serial_connected ) { tud_vendor_write(buf, count); tud_vendor_write_flush(); } // echo to cdc if ( tud_cdc_connected() ) { for(uint32_t i=0; ibmRequestType_bit.type) { case TUSB_REQ_TYPE_VENDOR: switch (request->bRequest) { case VENDOR_REQUEST_WEBUSB: // match vendor request in BOS descriptor // Get landing page url return tud_control_xfer(rhport, request, (void*)(uintptr_t) &desc_url, desc_url.bLength); case VENDOR_REQUEST_MICROSOFT: if ( request->wIndex == 7 ) { // Get Microsoft OS 2.0 compatible descriptor uint16_t total_len; memcpy(&total_len, desc_ms_os_20+8, 2); return tud_control_xfer(rhport, request, (void*)(uintptr_t) desc_ms_os_20, total_len); }else { return false; } default: break; } break; case TUSB_REQ_TYPE_CLASS: if (request->bRequest == 0x22) { // Webserial simulate the CDC_REQUEST_SET_CONTROL_LINE_STATE (0x22) to connect and disconnect. web_serial_connected = (request->wValue != 0); // Always lit LED if connected if ( web_serial_connected ) { board_led_write(true); blink_interval_ms = BLINK_ALWAYS_ON; tud_vendor_write_str("\r\nWebUSB interface connected\r\n"); tud_vendor_write_flush(); }else { blink_interval_ms = BLINK_MOUNTED; } // response with status OK return tud_control_status(rhport, request); } break; default: break; } // stall unknown request return false; } void webserial_task(void) { if ( web_serial_connected ) { if ( tud_vendor_available() ) { uint8_t buf[64]; uint32_t count = tud_vendor_read(buf, sizeof(buf)); // echo back to both web serial and cdc echo_all(buf, count); } } } //--------------------------------------------------------------------+ // USB CDC //--------------------------------------------------------------------+ void cdc_task(void) { if ( tud_cdc_connected() ) { // connected and there are data available if ( tud_cdc_available() ) { uint8_t buf[64]; uint32_t count = tud_cdc_read(buf, sizeof(buf)); // echo back to both web serial and cdc echo_all(buf, count); } } } // Invoked when cdc when line state changed e.g connected/disconnected void tud_cdc_line_state_cb(uint8_t itf, bool dtr, bool rts) { (void) itf; // connected if ( dtr && rts ) { // print initial message when connected tud_cdc_write_str("\r\nTinyUSB WebUSB device example\r\n"); } } // Invoked when CDC interface received data from host void tud_cdc_rx_cb(uint8_t itf) { (void) itf; } //--------------------------------------------------------------------+ // BLINKING TASK //--------------------------------------------------------------------+ void led_blinking_task(void) { static uint32_t start_ms = 0; static bool led_state = false; // Blink every interval ms if ( board_millis() - start_ms < blink_interval_ms) return; // not enough time start_ms += blink_interval_ms; board_led_write(led_state); led_state = 1 - led_state; // toggle }