diff options
Diffstat (limited to 'pw_stream_uart_linux/docs.rst')
-rw-r--r-- | pw_stream_uart_linux/docs.rst | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/pw_stream_uart_linux/docs.rst b/pw_stream_uart_linux/docs.rst new file mode 100644 index 000000000..853da78d9 --- /dev/null +++ b/pw_stream_uart_linux/docs.rst @@ -0,0 +1,37 @@ +.. _module-pw_stream_uart_linux: + +==================== +pw_stream_uart_linux +==================== +``pw_stream_uart_linux`` implements the +:cpp:class:`pw::stream::NonSeekableReaderWriter` interface for reading from and +writing to a UART using Linux TTY interfaces. + +.. note:: + This module will likely be superseded by a future ``pw_uart`` interface. + +C++ +=== +.. doxygenclass:: pw::stream::UartStreamLinux + :members: + +Examples +======== +A simple example illustrating writing to a UART: + +.. code-block:: cpp + + constexpr const char* kUartPath = "/dev/ttyS0"; + constexpr uint32_t kBaudRate = 115200; + + pw::stream::UartStreamLinux stream; + PW_TRY(stream.Open(kUartPath, kBaudRate)); + + std::array<std::byte, 10> to_write = {}; + PW_TRY(stream.Write(to_write)); + +Caveats +======= +No interfaces are supplied for configuring data bits, stop bits, or parity. +These attributes are left as they are already configured on the TTY; only the +speed is modified. |