//! Nordic Semi nRF91 DSO implementation for Drone, an Embedded Operating System.
//!
//! **Warning**: currently logging operations are wrapped in critical sections
//! (temporarily disabling all interrupts.) This can impact the operation of
//! your program, but only after you run `drone probe log`. It will be fixed in
//! the future by using proper synchronization methods with minimal changes to
//! the API.
//!
//! # Documentation
//!
//! - [Drone Book](https://book.drone-os.com/)
//! - [API documentation](https://api.drone-os.com/drone-nrf91-dso/0.14/)
//!
//! # Usage
//!
//! Place the following to the Cargo.toml:
//!
//! ```toml
//! [dependencies]
//! drone-nrf91-dso = "0.14.0"
//! ```
//!
//! Exclude the following tokens from your register token index (change "uarte0"
//! if you choose a different peripheral):
//!
//! ```
//! # #![feature(proc_macro_hygiene)]
//! # drone_core::config_override! { "
//! # [memory]
//! # flash = { size = \"128K\", origin = 0x08000000 }
//! # ram = { size = \"20K\", origin = 0x20000000 }
//! # [heap.main]
//! # size = \"0\"
//! # pools = []
//! # [linker]
//! # platform = \"arm\"
//! # [probe]
//! # gdb-client-command = \"gdb-multiarch\"
//! # [log.dso]
//! # baud-rate = 115200
//! # serial-endpoint = \"/dev/ttyACM0\"
//! # " }
//! # fn main() {}
//! # use drone_nrf_map::nrf_reg_tokens;
//! nrf_reg_tokens! {
//!     index => pub Regs;
//!     exclude => {
//!         uarte0_ns_tasks_startrx, uarte0_ns_tasks_stoprx, uarte0_ns_tasks_starttx,
//!         uarte0_ns_tasks_stoptx, uarte0_ns_tasks_flushrx,
//!         uarte0_ns_subscribe_startrx, uarte0_ns_subscribe_stoprx,
//!         uarte0_ns_subscribe_starttx, uarte0_ns_subscribe_stoptx,
//!         uarte0_ns_subscribe_flushrx, uarte0_ns_events_cts, uarte0_ns_events_ncts,
//!         uarte0_ns_events_rxdrdy, uarte0_ns_events_endrx, uarte0_ns_events_txdrdy,
//!         uarte0_ns_events_endtx, uarte0_ns_events_error, uarte0_ns_events_rxto,
//!         uarte0_ns_events_rxstarted, uarte0_ns_events_txstarted,
//!         uarte0_ns_events_txstopped, uarte0_ns_publish_cts, uarte0_ns_publish_ncts,
//!         uarte0_ns_publish_rxdrdy, uarte0_ns_publish_endrx, uarte0_ns_publish_txdrdy,
//!         uarte0_ns_publish_endtx, uarte0_ns_publish_error, uarte0_ns_publish_rxto,
//!         uarte0_ns_publish_rxstarted, uarte0_ns_publish_txstarted,
//!         uarte0_ns_publish_txstopped, uarte0_ns_shorts, uarte0_ns_inten,
//!         uarte0_ns_intenset, uarte0_ns_intenclr, uarte0_ns_errorsrc,
//!         uarte0_ns_enable, uarte0_ns_psel_rts, uarte0_ns_psel_txd,
//!         uarte0_ns_psel_cts, uarte0_ns_psel_rxd, uarte0_ns_baudrate,
//!         uarte0_ns_rxd_ptr, uarte0_ns_rxd_maxcnt, uarte0_ns_rxd_amount,
//!         uarte0_ns_txd_ptr, uarte0_ns_txd_maxcnt, uarte0_ns_txd_amount,
//!         uarte0_ns_config
//!     }
//! }
//! # drone_nrf91_dso::set_log! {
//! #     periph: Uarte0S,
//! #     pin_number: 29,
//! #     buf_size: 64,
//! # }
//! ```
//!
//! Set up the logger:
//!
//! ```
//! # #![feature(proc_macro_hygiene)]
//! # drone_core::config_override! { "
//! # [memory]
//! # flash = { size = \"128K\", origin = 0x08000000 }
//! # ram = { size = \"20K\", origin = 0x20000000 }
//! # [heap.main]
//! # size = \"0\"
//! # pools = []
//! # [linker]
//! # platform = \"arm\"
//! # [probe]
//! # gdb-client-command = \"gdb-multiarch\"
//! # [log.dso]
//! # baud-rate = 115200
//! # serial-endpoint = \"/dev/ttyACM0\"
//! # " }
//! # fn main() {}
//! # use drone_nrf_map::nrf_reg_tokens;
//! # nrf_reg_tokens! {
//! #     index => pub Regs;
//! #     exclude => {
//! #         uarte0_ns_tasks_startrx, uarte0_ns_tasks_stoprx, uarte0_ns_tasks_starttx,
//! #         uarte0_ns_tasks_stoptx, uarte0_ns_tasks_flushrx,
//! #         uarte0_ns_subscribe_startrx, uarte0_ns_subscribe_stoprx,
//! #         uarte0_ns_subscribe_starttx, uarte0_ns_subscribe_stoptx,
//! #         uarte0_ns_subscribe_flushrx, uarte0_ns_events_cts, uarte0_ns_events_ncts,
//! #         uarte0_ns_events_rxdrdy, uarte0_ns_events_endrx, uarte0_ns_events_txdrdy,
//! #         uarte0_ns_events_endtx, uarte0_ns_events_error, uarte0_ns_events_rxto,
//! #         uarte0_ns_events_rxstarted, uarte0_ns_events_txstarted,
//! #         uarte0_ns_events_txstopped, uarte0_ns_publish_cts, uarte0_ns_publish_ncts,
//! #         uarte0_ns_publish_rxdrdy, uarte0_ns_publish_endrx, uarte0_ns_publish_txdrdy,
//! #         uarte0_ns_publish_endtx, uarte0_ns_publish_error, uarte0_ns_publish_rxto,
//! #         uarte0_ns_publish_rxstarted, uarte0_ns_publish_txstarted,
//! #         uarte0_ns_publish_txstopped, uarte0_ns_shorts, uarte0_ns_inten,
//! #         uarte0_ns_intenset, uarte0_ns_intenclr, uarte0_ns_errorsrc,
//! #         uarte0_ns_enable, uarte0_ns_psel_rts, uarte0_ns_psel_txd,
//! #         uarte0_ns_psel_cts, uarte0_ns_psel_rxd, uarte0_ns_baudrate,
//! #         uarte0_ns_rxd_ptr, uarte0_ns_rxd_maxcnt, uarte0_ns_rxd_amount,
//! #         uarte0_ns_txd_ptr, uarte0_ns_txd_maxcnt, uarte0_ns_txd_amount,
//! #         uarte0_ns_config
//! #     }
//! # }
//! drone_nrf91_dso::set_log! {
//!     periph: Uarte0S, // Peripheral from `drone_nrf_map::periph::uarte`
//!     pin_number: 29,  // Output pin number
//!     buf_size: 64,    // Output buffer size in bytes
//! }
//! ```

#![feature(const_fn)]
#![feature(const_panic)]
#![feature(llvm_asm)]
#![feature(prelude_import)]
#![warn(missing_docs, unsafe_op_in_unsafe_fn)]
#![warn(clippy::pedantic)]
#![allow(clippy::cast_possible_truncation, clippy::doc_markdown, clippy::wildcard_imports)]
#![no_std]

mod logger;
mod set_log;
mod uarte;

pub use self::{
    logger::{flush, is_enabled, write_bytes, Logger},
    uarte::baud_rate,
};

#[prelude_import]
#[allow(unused_imports)]
use drone_core::prelude::*;

#[doc(hidden)]
#[link_section = ".dronereg"]
#[no_mangle]
#[used]
static mut DSO_PORTS: u32 = 0;