#log #nxp #logging #imxrt

no-std imxrt-uart-log

Logging over an i.MX RT serial interface

3 unstable releases

0.2.0 Aug 29, 2020
0.1.1 Jul 7, 2020
0.1.0 Jun 19, 2020

#16 in #imxrt

MIT/Apache

44KB
562 lines

imxrt-uart-log

Crates.io Build

API Docs

Log data over a serial interface. There are two logging implementations for NXP's i.MX RT processors:

  • a simple, blocking logger. Useful for basic logging throughout the software stack, including interrupt, fault, and panic handlers.
  • a DMA-based, non-blocking interface. Useful for logging that needs to happen quickly. Uses a default buffer, with an option for a user-supplied DMA buffer.

Built on the imxrt-hal hardware abstraction layer for i.MX RT processors, version 0.4. Compatible with log version 0.4.

i.MX RT Compatibility

This crate supports all of the same i.MX RT variants as the imxrt-hal crate. To see the supported i.MX RT variants, check the HAL's feature support list.

ℹ️ As of this writing, the HAL only supports one i.MX RT variant, the "imxrt1062". For convenience, the "imxrt1062" feature is this crate's default feature. This default feature may change in future releases.

Testing

The crate's examples run on hardware. See the documentation at the top of each example for more information.

For examples that run on a Teensy 4, you'll need the build dependencies described in the teensy4-rs project.

Use make to build an example for the Teensy 4:

make t4_blocking

When building an example for the Teensy 4, the build will print the location of the *.hex file. You may download the file to a Teensy using either the Teensy Loader Application or the teensy_loader_cli command-line Teensy loader.

To run this crate's unit tests, and to check documentation examples, use make test.

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~25MB
~695K SLoC