src/rp2_common/pico_stdio_usb/include/pico/stdio_usb.h - third_party/github/raspberrypi/pico-sdk - Git at Google

 /*
  * Copyright (c) 2020 Raspberry Pi (Trading) Ltd.
  *
  * SPDX-License-Identifier: BSD-3-Clause
  */

 #ifndef _PICO_STDIO_USB_H
 #define _PICO_STDIO_USB_H

 #include "pico/stdio.h"

 /** \brief Support for stdin/stdout over USB serial (CDC)
  *  \defgroup pico_stdio_usb pico_stdio_usb
  *  \ingroup pico_stdio
  *
  *  Linking this library or calling `pico_enable_stdio_usb(TARGET ENABLED)` in the CMake (which
  *  achieves the same thing) will add USB CDC to the drivers used for standard input/output
  *
  *  Note this library is a developer convenience. It is not applicable in all cases; for one it takes full control of the USB device precluding your
  *  use of the USB in device or host mode. For this reason, this library will automatically disengage if you try to using it alongside \ref tinyusb_device or
  *  \ref tinyusb_host. It also takes control of a lower level IRQ and sets up a periodic background task.
  *
  *  This library also includes (by default) functionality to enable the RP-series microcontroller to be reset over the USB interface.
  */

 // PICO_CONFIG: PICO_STDIO_USB_DEFAULT_CRLF, Default state of CR/LF translation for USB output, type=bool, default=PICO_STDIO_DEFAULT_CRLF, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_DEFAULT_CRLF
 #define PICO_STDIO_USB_DEFAULT_CRLF PICO_STDIO_DEFAULT_CRLF
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_STDOUT_TIMEOUT_US, Number of microseconds to be blocked trying to write USB output before assuming the host has disappeared and discarding data, default=500000, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_STDOUT_TIMEOUT_US
 #define PICO_STDIO_USB_STDOUT_TIMEOUT_US 500000
 #endif

 // todo perhaps unnecessarily frequent?
 // PICO_CONFIG: PICO_STDIO_USB_TASK_INTERVAL_US, Period of microseconds between calling tud_task in the background, default=1000, advanced=true, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_TASK_INTERVAL_US
 #define PICO_STDIO_USB_TASK_INTERVAL_US 1000
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_LOW_PRIORITY_IRQ, Explicit User IRQ number to claim for tud_task() background execution instead of letting the implementation pick a free one dynamically (deprecated), advanced=true, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_LOW_PRIORITY_IRQ
 // this variable is no longer set by default (one is claimed dynamically), but will be respected if specified
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE, Enable/disable resetting into BOOTSEL mode if the host sets the baud rate to a magic value (PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE), type=bool, default=1 if application is not using TinyUSB directly, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE
 #if !defined(LIB_TINYUSB_HOST) && !defined(LIB_TINYUSB_DEVICE)
 #define PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE 1
 #endif
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE, baud rate that if selected causes a reset into BOOTSEL mode (if PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE is set), default=1200, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE
 #define PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE 1200
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS, Maximum number of milliseconds to wait during initialization for a CDC connection from the host (negative means indefinite) during initialization, default=0, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS
 #define PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS 0
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS, Number of extra milliseconds to wait when using PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS after a host CDC connection is detected (some host terminals seem to sometimes lose transmissions sent right after connection), default=50, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS
 #define PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS 50
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_DEINIT_DELAY_MS, Number of milliseconds to wait before deinitializing stdio_usb, default=110, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_DEINIT_DELAY_MS
 #define PICO_STDIO_USB_DEINIT_DELAY_MS 110
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_ACTIVITY_LED, Optionally define a pin to use as bootloader activity LED when BOOTSEL mode is entered via USB (either VIA_BAUD_RATE or VIA_VENDOR_INTERFACE), type=int, min=0, max=29, group=pico_stdio_usb

 // PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED, Whether the pin specified by PICO_STDIO_USB_RESET_BOOTSEL_ACTIVITY_LED is fixed or can be modified by picotool over the VENDOR USB interface, type=bool, default=0, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED
 #define PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED 0
 #endif

 // Any modes disabled here can't be re-enabled by picotool via VENDOR_INTERFACE.
 // PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK, Optionally disable either the mass storage interface (bit 0) or the PICOBOOT interface (bit 1) when entering BOOTSEL mode via USB (either VIA_BAUD_RATE or VIA_VENDOR_INTERFACE), type=int, min=0, max=3, default=0, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK
 #define PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK 0u
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE, Enable/disable resetting into BOOTSEL mode via an additional VENDOR USB interface - enables picotool based reset, type=bool, default=1 if application is not using TinyUSB directly, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE
 #if !defined(LIB_TINYUSB_HOST) && !defined(LIB_TINYUSB_DEVICE)
 #define PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE 1
 #endif
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL, If vendor reset interface is included allow rebooting to BOOTSEL mode, type=bool, default=1, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL
 #define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL 1
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT, If vendor reset interface is included allow rebooting with regular flash boot, type=bool, default=1, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT
 #define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT 1
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR, If vendor reset interface is included add support for Microsoft OS 2.0 Descriptor, type=bool, default=1, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR
 #define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR 1
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS, Delay in ms before rebooting via regular flash boot, default=100, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS
 #define PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS 100
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_CONNECTION_WITHOUT_DTR, Disable use of DTR for connection checking meaning connection is assumed to be valid, type=bool, default=0, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_CONNECTION_WITHOUT_DTR
 #define PICO_STDIO_USB_CONNECTION_WITHOUT_DTR 0
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_DEVICE_SELF_POWERED, Set USB device as self powered device, type=bool, default=0, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_DEVICE_SELF_POWERED
 #define PICO_STDIO_USB_DEVICE_SELF_POWERED 0
 #endif

 // PICO_CONFIG: PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK, Enable USB STDIO support for stdio_set_chars_available_callback. Can be disabled to make use of USB CDC RX callback elsewhere, type=bool, default=1, group=pico_stdio_usb
 #ifndef PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK
 #define PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK 1
 #endif

 #ifdef __cplusplus
 extern "C" {
 #endif

 extern stdio_driver_t stdio_usb;

 /*! \brief Explicitly initialize USB stdio and add it to the current set of stdin drivers
  *  \ingroup pico_stdio_usb
  *
  *  \ref PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS can be set to cause this method to wait for a CDC connection
  *  from the host before returning, which is useful if you don't want any initial stdout output to be discarded
  *  before the connection is established.
  *
  *  \return true if the USB CDC was initialized, false if an error occurred
  */
 bool stdio_usb_init(void);

 /*! \brief Explicitly deinitialize USB stdio and remove it from the current set of stdin drivers
  *  \ingroup pico_stdio_usb
  *
  *  \return true if the USB CDC was deinitialized, false if an error occurred
  */
 bool stdio_usb_deinit(void);

 /*! \brief Check if there is an active stdio CDC connection to a host
  *  \ingroup pico_stdio_usb
  *
  *  \return true if stdio is connected over CDC
  */
 bool stdio_usb_connected(void);
 #ifdef __cplusplus
 }
 #endif

 #endif
	/*
	* Copyright (c) 2020 Raspberry Pi (Trading) Ltd.
	*
	* SPDX-License-Identifier: BSD-3-Clause
	*/

	#ifndef _PICO_STDIO_USB_H
	#define _PICO_STDIO_USB_H

	#include "pico/stdio.h"

	/** \brief Support for stdin/stdout over USB serial (CDC)
	* \defgroup pico_stdio_usb pico_stdio_usb
	* \ingroup pico_stdio
	*
	* Linking this library or calling `pico_enable_stdio_usb(TARGET ENABLED)` in the CMake (which
	* achieves the same thing) will add USB CDC to the drivers used for standard input/output
	*
	* Note this library is a developer convenience. It is not applicable in all cases; for one it takes full control of the USB device precluding your
	* use of the USB in device or host mode. For this reason, this library will automatically disengage if you try to using it alongside \ref tinyusb_device or
	* \ref tinyusb_host. It also takes control of a lower level IRQ and sets up a periodic background task.
	*
	* This library also includes (by default) functionality to enable the RP-series microcontroller to be reset over the USB interface.
	*/

	// PICO_CONFIG: PICO_STDIO_USB_DEFAULT_CRLF, Default state of CR/LF translation for USB output, type=bool, default=PICO_STDIO_DEFAULT_CRLF, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_DEFAULT_CRLF
	#define PICO_STDIO_USB_DEFAULT_CRLF PICO_STDIO_DEFAULT_CRLF
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_STDOUT_TIMEOUT_US, Number of microseconds to be blocked trying to write USB output before assuming the host has disappeared and discarding data, default=500000, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_STDOUT_TIMEOUT_US
	#define PICO_STDIO_USB_STDOUT_TIMEOUT_US 500000
	#endif

	// todo perhaps unnecessarily frequent?
	// PICO_CONFIG: PICO_STDIO_USB_TASK_INTERVAL_US, Period of microseconds between calling tud_task in the background, default=1000, advanced=true, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_TASK_INTERVAL_US
	#define PICO_STDIO_USB_TASK_INTERVAL_US 1000
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_LOW_PRIORITY_IRQ, Explicit User IRQ number to claim for tud_task() background execution instead of letting the implementation pick a free one dynamically (deprecated), advanced=true, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_LOW_PRIORITY_IRQ
	// this variable is no longer set by default (one is claimed dynamically), but will be respected if specified
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE, Enable/disable resetting into BOOTSEL mode if the host sets the baud rate to a magic value (PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE), type=bool, default=1 if application is not using TinyUSB directly, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE
	#if !defined(LIB_TINYUSB_HOST) && !defined(LIB_TINYUSB_DEVICE)
	#define PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE 1
	#endif
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE, baud rate that if selected causes a reset into BOOTSEL mode (if PICO_STDIO_USB_ENABLE_RESET_VIA_BAUD_RATE is set), default=1200, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE
	#define PICO_STDIO_USB_RESET_MAGIC_BAUD_RATE 1200
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS, Maximum number of milliseconds to wait during initialization for a CDC connection from the host (negative means indefinite) during initialization, default=0, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS
	#define PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS 0
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS, Number of extra milliseconds to wait when using PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS after a host CDC connection is detected (some host terminals seem to sometimes lose transmissions sent right after connection), default=50, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS
	#define PICO_STDIO_USB_POST_CONNECT_WAIT_DELAY_MS 50
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_DEINIT_DELAY_MS, Number of milliseconds to wait before deinitializing stdio_usb, default=110, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_DEINIT_DELAY_MS
	#define PICO_STDIO_USB_DEINIT_DELAY_MS 110
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_ACTIVITY_LED, Optionally define a pin to use as bootloader activity LED when BOOTSEL mode is entered via USB (either VIA_BAUD_RATE or VIA_VENDOR_INTERFACE), type=int, min=0, max=29, group=pico_stdio_usb

	// PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED, Whether the pin specified by PICO_STDIO_USB_RESET_BOOTSEL_ACTIVITY_LED is fixed or can be modified by picotool over the VENDOR USB interface, type=bool, default=0, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED
	#define PICO_STDIO_USB_RESET_BOOTSEL_FIXED_ACTIVITY_LED 0
	#endif

	// Any modes disabled here can't be re-enabled by picotool via VENDOR_INTERFACE.
	// PICO_CONFIG: PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK, Optionally disable either the mass storage interface (bit 0) or the PICOBOOT interface (bit 1) when entering BOOTSEL mode via USB (either VIA_BAUD_RATE or VIA_VENDOR_INTERFACE), type=int, min=0, max=3, default=0, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK
	#define PICO_STDIO_USB_RESET_BOOTSEL_INTERFACE_DISABLE_MASK 0u
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE, Enable/disable resetting into BOOTSEL mode via an additional VENDOR USB interface - enables picotool based reset, type=bool, default=1 if application is not using TinyUSB directly, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE
	#if !defined(LIB_TINYUSB_HOST) && !defined(LIB_TINYUSB_DEVICE)
	#define PICO_STDIO_USB_ENABLE_RESET_VIA_VENDOR_INTERFACE 1
	#endif
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL, If vendor reset interface is included allow rebooting to BOOTSEL mode, type=bool, default=1, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL
	#define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_BOOTSEL 1
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT, If vendor reset interface is included allow rebooting with regular flash boot, type=bool, default=1, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT
	#define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_RESET_TO_FLASH_BOOT 1
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR, If vendor reset interface is included add support for Microsoft OS 2.0 Descriptor, type=bool, default=1, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR
	#define PICO_STDIO_USB_RESET_INTERFACE_SUPPORT_MS_OS_20_DESCRIPTOR 1
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS, Delay in ms before rebooting via regular flash boot, default=100, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS
	#define PICO_STDIO_USB_RESET_RESET_TO_FLASH_DELAY_MS 100
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_CONNECTION_WITHOUT_DTR, Disable use of DTR for connection checking meaning connection is assumed to be valid, type=bool, default=0, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_CONNECTION_WITHOUT_DTR
	#define PICO_STDIO_USB_CONNECTION_WITHOUT_DTR 0
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_DEVICE_SELF_POWERED, Set USB device as self powered device, type=bool, default=0, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_DEVICE_SELF_POWERED
	#define PICO_STDIO_USB_DEVICE_SELF_POWERED 0
	#endif

	// PICO_CONFIG: PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK, Enable USB STDIO support for stdio_set_chars_available_callback. Can be disabled to make use of USB CDC RX callback elsewhere, type=bool, default=1, group=pico_stdio_usb
	#ifndef PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK
	#define PICO_STDIO_USB_SUPPORT_CHARS_AVAILABLE_CALLBACK 1
	#endif

	#ifdef __cplusplus
	extern "C" {
	#endif

	extern stdio_driver_t stdio_usb;

	/*! \brief Explicitly initialize USB stdio and add it to the current set of stdin drivers
	* \ingroup pico_stdio_usb
	*
	* \ref PICO_STDIO_USB_CONNECT_WAIT_TIMEOUT_MS can be set to cause this method to wait for a CDC connection
	* from the host before returning, which is useful if you don't want any initial stdout output to be discarded
	* before the connection is established.
	*
	* \return true if the USB CDC was initialized, false if an error occurred
	*/
	bool stdio_usb_init(void);

	/*! \brief Explicitly deinitialize USB stdio and remove it from the current set of stdin drivers
	* \ingroup pico_stdio_usb
	*
	* \return true if the USB CDC was deinitialized, false if an error occurred
	*/
	bool stdio_usb_deinit(void);

	/*! \brief Check if there is an active stdio CDC connection to a host
	* \ingroup pico_stdio_usb
	*
	* \return true if stdio is connected over CDC
	*/
	bool stdio_usb_connected(void);
	#ifdef __cplusplus
	}
	#endif

	#endif