aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/api/serialusb.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/lang/api/serialusb.rst')
-rw-r--r--docs/source/lang/api/serialusb.rst11
1 files changed, 9 insertions, 2 deletions
diff --git a/docs/source/lang/api/serialusb.rst b/docs/source/lang/api/serialusb.rst
index af3a7e0..e1d12bf 100644
--- a/docs/source/lang/api/serialusb.rst
+++ b/docs/source/lang/api/serialusb.rst
@@ -52,7 +52,9 @@ world!")``.
.. cpp:class:: USBSerial
Emulated serial-over-USB class. ``SerialUSB`` is the predefined
- instance.
+ (singleton) instance.
+
+.. _lang-serialusb-begin:
.. cpp:function:: USBSerial::begin()
@@ -65,7 +67,12 @@ world!")``.
.. cpp:function:: USBSerial::end()
- Disables the USB peripheral.
+ Disables the USB peripheral. Note that using this function will
+ terminate all USB communications between the Maple and the USB
+ host; in particular, it implies that you won't be able to upload
+ any new programs without resetting the board or using
+ :ref:`perpetual bootloader mode
+ <troubleshooting-perpetual-bootloader>`.
.. cpp:function:: unsigned int USBSerial::available()