TrustedFirmware Git Browser
Code Review Sign In
review.trustedfirmware.org / rust-spmc / arm-pl011-uart / 8a952e6856ce5913ba1d601698fcf5b93fee3ea2
commit8a952e6856ce5913ba1d601698fcf5b93fee3ea2[log] [tgz]
authorImre Kis <imre.kis@arm.com>Wed Mar 26 13:26:54 2025 +0100
committerImre Kis <imre.kis@arm.com>Tue Apr 01 14:52:39 2025 +0200
tree16a1ba14a6d7ed631f7f54bb621dd63bfbd16678
parent2f3845a3297c203e2ef9f38a0ce5cb79434ca288 [diff]
Prepare for 0.3.1 release

Bump version number, update dependencies, and add an example to
README.md.

Change-Id: I26d8c54cab2ea32a1e1b12f5748b178ae23c36a0
Signed-off-by: Imre Kis <imre.kis@arm.com>
3 files changed
tree: 16a1ba14a6d7ed631f7f54bb621dd63bfbd16678
  1. src/
  2. .gitignore
  3. Cargo.lock
  4. Cargo.toml
  5. CHANGELOG.md
  6. dco.txt
  7. LICENSE-Apache-2.0
  8. LICENSE-MIT
  9. README.md
README.md

Arm PrimeCell UART (PL011) driver

Driver implementation for the PL011 UART peripheral.

The driver is designed to function regardless of whether a Memory Management Unit (MMU) is present. The primary role of the OwnedMmioPointer is to manage the lifetime of the peripheral, ensuring proper resource handling. In a system that includes an MMU, the peripheral's lifetime is dynamic because it is mapped into memory rather than having a fixed address. In a system without an MMU, the OwnedMmioPointer can be instantiated directly from the physical address of the register block, providing access to the peripheral without requiring memory mapping.

Implemented features

  • Enabling/disabling UART peripheral which includes configuring the data bit number, parity settings, stop bit count and baudrate
  • Checking various status flags
  • Non-blocking read/write functions
  • Handling UART errors
  • Reading UART identification structure
  • 98% unit test coverage
  • Setting FIFO level of RX/TX interrupts
  • Reading, masking and clearing interrupts
  • Implementing various traits
    • embedded_hal_nb::serial::{Write, Read} (optional, behind the embedded-hal-nb feature flag)
    • embedded_io::{Write, Read} (optional, behind the embedded-io feature flag)
    • core::fmt::Write

Feature flags

  • embedded-hal-nb: Adds implementations of embedded-hal-nb traits for the UART driver.
  • embedded-io: Adds implementations of embedded-io traits for the UART driver.

Future plans

  • Handling modem control and status signals
  • Adding peripheral testing

License

The project is MIT and Apache-2.0 dual licensed, see LICENSE-APACHE and LICENSE-MIT.

Maintainers

arm-pl011-uart is a trustedfirmware.org maintained project. All contributions are ultimately merged by the maintainers listed below.

Contributing

Please follow the directions of the Trusted Firmware Processes

Contributions are handled through review.trustedfirmware.org.

Reporting Security Issues

Please follow the directions of the Trusted Firmware Security Center

Copyright 2024 Arm Limited and/or its affiliates open-source-office@arm.com