Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

[Docs] Added USB documentation #6036

Merged
merged 8 commits into from
Dec 21, 2021

Conversation

pedrominatel
Copy link
Member

Summary

Added USB documentation.

Impact

None.

Related links

Closes: #5784

@pedrominatel pedrominatel added the Type: Documentation Issue pertains to Documentation of Arduino ESP32 label Dec 17, 2021
@pedrominatel pedrominatel self-assigned this Dec 17, 2021
docs/source/api/usb.rst Outdated Show resolved Hide resolved
docs/source/api/usb.rst Outdated Show resolved Hide resolved
docs/source/api/usb.rst Outdated Show resolved Hide resolved
@me-no-dev
Copy link
Member

Seems you have added docs only for CDC and MSC so far. Will those show on separate pages? They should :) Also once you cover all exposed classes, maybe we can add doc on how to add a custom device as well.

@pedrominatel
Copy link
Member Author

My suggestion is to create a separate page for CDC (usb_cdc.rst) and MSC (usb_msc.rst) and let the common API as the usb.rst. For the custom device, we can add it as a tutorial, not as part of the API.


USB Communications Device Class API. This class is used to enable communication between the host and the device.

This class is often used to enable serial communication and can be used to flash the firmware on the ESP32-S2 without the external USB to Serial chip.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ESP32-S2 mentioned here

HIDVendor
*********

.. literalinclude:: ../../../libraries/USB/examples/HIDVendor/HIDVendor.ino
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

examples here seem unrelated to CDC. We do have CDC examples that you can add here

@me-no-dev me-no-dev merged commit 7ba11cc into espressif:master Dec 21, 2021
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
Type: Documentation Issue pertains to Documentation of Arduino ESP32
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Docs] Add USB driver library on the documentation
2 participants