Skip to content
This repository has been archived by the owner on Jan 5, 2023. It is now read-only.
/ imxrt-uart-log Public archive

Logging over an i.MX RT serial interface

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

imxrt-rs/imxrt-uart-log

Repository files navigation

imxrt-uart-log

Replaced by imxrt-log. imxrt-hal 0.5 users should use imxrt-log, since this package only supports imxrt-hal 0.4 and will not be developed further.

If you have a bug fix for this package that you would like released, contact an imxrt-rs maintainer.


Crates.io Build

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.