third_party.pigweed.src/pw_sys_io_mcuxpresso/docs.rst
Scott James Remnant 27ff7448c7 pw_sys_io_mcuxpresso: support pw_sys_io on MCUXpresso SDK
Change-Id: I23c3f01347a56672451dfd2f9367ee0797502322
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/65400
Commit-Queue: Auto-Submit <auto-submit@pigweed.google.com.iam.gserviceaccount.com>
Reviewed-by: Ewout van Bekkum <ewout@google.com>
Pigweed-Auto-Submit: Scott James Remnant <keybuk@google.com>
2021-10-29 18:58:05 +00:00

38 lines
1.2 KiB
ReStructuredText

.. _module-pw_sys_io_mcuxpresso:
====================
pw_sys_io_mcuxpresso
====================
``pw_sys_io_mcuxpresso`` implements the ``pw_sys_io`` facade using the
NXP MCUXpresso SDK.
The implementation is based on the debug console component.
Setup
=====
This module requires a little setup:
1. Use ``pw_build_mcuxpresso`` to create a ``pw_source_set`` for an
MCUXpresso SDK.
2. Include the debug console component in this SDK definition.
3. Specify the ``pw_third_party_mcuxpresso_SDK`` GN global variable to specify
the name of this source set.
4. Use a target that calls ``pw_sys_io_mcuxpresso_Init`` in
``pw_boot_PreMainInit`` or similar.
The name of the SDK source set must be set in the
"pw_third_party_mcuxpresso_SDK" GN arg
Configuration
=============
The configuration of the module can be adjusted via compile-time configuration
of the MCUXpresso source set, see the
:ref:`documentation <module-pw_build_mcuxpresso>` for more details.
.. c:macro:: DEBUG_CONSOLE_TRANSFER_NON_BLOCKING
Whether the MCUXpresso debug console supports non-blocking transfers. The
default will depend on your SDK configuration.
Enabling this adds support for ``pw::sys_io::TryReadByte``.