rtic/CHANGELOG.md

385 lines
12 KiB
Markdown
Raw Normal View History

2017-05-09 15:38:35 +02:00
# Change Log
All notable changes to this project will be documented in this file.
This project adheres to [Semantic Versioning](http://semver.org/).
## [Unreleased]
2020-10-22 19:02:03 +02:00
### Added
- Allow annotating resources to activate special resource locking behaviour.
- `#[lock_free]`, there might be several tasks with the same priority accessing
the resource without critical section.
- `#[task_local]`, there must be only one task, similar to a task local
resource, but (optionally) set-up by init. This is similar to move.
2020-10-25 16:16:17 +01:00
- Improved ergonomics allowing separation of task signatures to actual implementation in extern block `extern "C" { #[task(..)] fn t(..); }`.
2020-10-24 19:47:38 +02:00
2020-10-22 19:02:03 +02:00
### Changed
- [breaking-change] [PR 400] Move dispatchers from extern block to app argument.
[PR 400]: https://github.com/rtic-rs/cortex-m-rtic/pull/400
- [breaking-change] [PR 390] Rework whole spawn/schedule, support `foo::spawn( ... )`,
`foo::schedule( ... )`.
[PR 390]: https://github.com/rtic-rs/cortex-m-rtic/pull/390
- [breaking-change] [PR 368] `struct Resources` changed to attribute `#[resources]` on a struct.
- [breaking-change] [PR 368] Mod over const, instead of `const APP: () = {` use `mod app {`.
- [breaking-change] [PR 372] Init function always return `LateResources` for a symmetric API.
- [PR 355] Multi-core support was removed to reduce overall complexity.
[PR 368]: https://github.com/rtic-rs/cortex-m-rtic/pull/368
[PR 372]: https://github.com/rtic-rs/cortex-m-rtic/pull/372
[PR 355]: https://github.com/rtic-rs/cortex-m-rtic/pull/355
2020-10-23 10:35:56 +02:00
2020-08-27 14:45:29 +02:00
## [v0.5.5] - 2020-08-27
- Includes the previous soundness fix.
- Fixes wrong use of the `cortex_m` crate which can cause some projects to stop compiling.
## [v0.5.4] - 2020-08-26 - YANKED
2020-08-26 12:41:39 +02:00
- **Soundness fix in RTIC**, it was previously possible to get the `cortex_m::Peripherals` more than once, causing UB.
2020-06-12 09:32:43 +02:00
## [v0.5.3] - 2020-06-12
2020-06-12 09:51:09 +02:00
- Added migration guide from `cortex-m-rtfm` to `cortex-m-rtic`
2020-06-12 09:32:43 +02:00
- No code changes, only a version compatibility release with `cortex-m-rtfm` to ease the transition
for users.
2020-06-11 18:57:56 +02:00
## [v0.5.2] - 2020-06-11
- Using safe `DWT` interface
- Using GitHub Actions now
- Improved CI speed
- Now `main` can be used as function name
- Fixed so one can `cfg`-out resources when using a newer compiler
2019-11-19 15:46:07 +01:00
## [v0.5.1] - 2019-11-19
2020-10-22 19:02:03 +02:00
- Fixed arithmetic wrapping bug in src/cyccntr.rs
elapsed and duration could cause an internal overflow trap
on subtraction in debug mode.
2019-11-19 15:46:07 +01:00
- Fixed bug in SysTick implementation where the SysTick could be disabled by
accident
## [v0.5.0] - 2019-11-14
### Added
- Experimental support for homogeneous and heterogeneous multi-core
microcontrollers has been added. Support is gated behind the `homogeneous` and
`heterogeneous` Cargo features.
### Changed
2020-10-22 19:02:03 +02:00
- [breaking-change] [RFC 155] "explicit `Context` parameter" has been
implemented.
2020-06-11 19:18:29 +02:00
[RFC 155]: https://github.com/rtic-rs/cortex-m-rtic/issues/155
2020-10-22 19:02:03 +02:00
- [breaking-change] [RFC 147] "all functions must be safe" has been
implemented.
2020-06-11 19:18:29 +02:00
[RFC 147]: https://github.com/rtic-rs/cortex-m-rtic/issues/147
- All the queues internally used by the framework now use `AtomicU8` indices
instead of `AtomicUsize`; this reduces the static memory used by the
framework.
2020-10-22 19:02:03 +02:00
- [breaking-change] when the `capacity` argument is omitted, the capacity of
the task is assumed to be `1`. Before, a reasonable (but hard to predict)
capacity was computed based on the number of `spawn` references the task had.
2020-10-22 19:02:03 +02:00
- [breaking-change] resources that are appear as exclusive references
(`&mut-`) no longer appear behind the `Exclusive` newtype.
2020-10-22 19:02:03 +02:00
- [breaking-change] the `timer-queue` Cargo feature has been removed. The
`schedule` API can be used without enabling any Cargo feature.
2020-10-22 19:02:03 +02:00
- [breaking-change] when the `schedule` API is used the type of
`init::Context.core` changes from `cortex_m::Peripherals` to
2020-06-11 19:18:29 +02:00
`rtic::Peripherals`. The fields of `rtic::Peripherals` do not change when
Cargo features are enabled.
2020-10-22 19:02:03 +02:00
- [breaking-change] the monotonic timer used to implement the `schedule` API
is now user configurable via the `#[app(monotonic = ..)]` argument. IMPORTANT:
it is now the responsibility of the application author to configure and
initialize the chosen `monotonic` timer during the `#[init]` phase.
2020-10-22 19:02:03 +02:00
- [breaking-change] the `peripherals` field is not include in `init::Context`
by default. One must opt-in using the `#[app(peripherals = ..)]` argument.
2020-10-22 19:02:03 +02:00
- [breaking-change] the `#[exception]` and `#[interrupt]` attributes have been
removed. Hardware tasks are now declared using the `#[task(binds = ..)]`
attribute.
2020-10-22 19:02:03 +02:00
- [breaking-change] the syntax to declare resources has changed. Instead of
using a `static [mut]` variable for each resource, all resources must be
declared in a `Resources` structure.
### Removed
- [breaking-change] the integration with the `owned_singleton` crate has been
removed. You can use `heapless::Pool` instead of `alloc_singleton`.
- [breaking-change] late resources can no longer be initialized using the assign
syntax. `init::LateResources` is the only method to initialize late resources.
See [PR #140] for more details.
2020-06-11 19:18:29 +02:00
[PR #140]: https://github.com/rtic-rs/cortex-m-rtic/pull/140
2019-04-21 18:20:57 +02:00
## [v0.4.3] - 2019-04-21
### Changed
- Checking that the specified priorities are supported by the target device is
now done at compile time.
### Fixed
- Building this crate with the "nightly" feature and a recent compiler has been
fixed.
2019-02-27 00:56:56 +01:00
## [v0.4.2] - 2019-02-27
### Added
- `Duration` now has an `as_cycles` method to get the number of clock cycles
contained in it.
- An opt-in "nightly" feature that reduces static memory usage, shortens
initialization time and reduces runtime overhead has been added. To use this
feature you need a nightly compiler!
- [RFC 128] has been implemented. The `exception` and `interrupt` have gained a
`binds` argument that lets you give the handler an arbitrary name. For
example:
2020-06-11 19:18:29 +02:00
[RFC 128]: https://github.com/rtic-rs/cortex-m-rtic/issues/128
2019-02-27 00:56:56 +01:00
``` rust
// on v0.4.1 you had to write
#[interrupt]
fn USART0() { .. }
// on v0.4.2 you can write
#[interrupt(binds = USART0)]
fn on_new_frame() { .. }
```
### Changed
- Builds are now reproducible. `cargo build; cargo clean; cargo build` will
produce binaries that are exactly the same (after `objcopy -O ihex`). This
wasn't the case before because we used randomly generated identifiers for
memory safety but now all the randomness is gone.
### Fixed
- Fixed a `non_camel_case_types` warning that showed up when using a recent
nightly.
- Fixed a bug that allowed you to enter the `capacity` and `priority` arguments
in the `task` attribute more than once. Now all arguments can only be stated
once in the list, as it should be.
2019-02-12 11:28:34 +01:00
## [v0.4.1] - 2019-02-12
### Added
2020-06-11 19:18:29 +02:00
- The RTIC book has been translated to Russian. You can find the translation
online at https://japaric.github.io/cortex-m-rtic/book/ru/
2019-02-12 11:28:34 +01:00
- `Duration` now implements the `Default` trait.
### Changed
2020-10-22 19:02:03 +02:00
- [breaking-change] [soundness-fix] `init` can not contain any early return as
2019-02-12 11:28:34 +01:00
that would result in late resources not being initialized and thus undefined
behavior.
- Use an absolute link to the book so it works when landing from crates.io
documentation page
2019-02-12 15:27:08 +01:00
- The initialization function can now be written as `fn init() ->
init::LateResources` when late resources are used. This is preferred over the
old `fn init()` form. See the section on late resources (resources chapter) in
the book for more details.
2019-02-12 15:27:08 +01:00
2019-02-12 11:28:34 +01:00
### Fixed
- `#[interrupt]` and `#[exception]` no longer produce warnings on recent nightlies.
## [v0.4.0] - 2018-11-03 - YANKED
Yanked due to a soundness issue in `init`; the issue has been mostly fixed in v0.4.1.
2018-11-03 20:14:01 +01:00
### Changed
- This crate now compiles on stable 1.31.
2018-11-03 20:14:01 +01:00
- [breaking-change] The `app!` macro has been transformed into an attribute. See
the documentation for details.
- [breaking-change] Applications that use this library must be written using the
2018 edition.
- [breaking-change] The `Resource` trait has been renamed to `Mutex`.
`Resource.claim_mut` has been renamed to `Mutex.lock` and its signature has
changed (no `Threshold` token is required).
2020-06-11 19:18:29 +02:00
- [breaking-change] The name of the library has changed to `rtic`. The package
name is still `cortex-m-rtic`.
2018-11-03 20:14:01 +01:00
2020-06-11 19:18:29 +02:00
- [breaking-change] `cortex_m_rtic::set_pending` has been renamed to
`rtic::pend`.
2018-11-03 20:14:01 +01:00
### Added
- Software tasks, which can be immediately spawn and scheduled to run in the
future.
- `Instant` and `Duration` API.
- Integration with the [`Singleton`] abstraction.
[`Singleton`]: https://docs.rs/owned-singleton/0.1.0/owned_singleton/
### Removed
- [breaking-change] The `Threshold` token has been removed.
- [breaking-change] The `bkpt` and `wfi` re-exports have been removed.
2020-06-11 19:18:29 +02:00
- [breaking-change] `rtic::atomic` has been removed.
2018-11-03 20:14:01 +01:00
2018-08-27 14:54:45 +02:00
## [v0.3.4] - 2018-08-27
### Changed
- The documentation link to point to GH pages.
2018-08-24 16:48:33 +02:00
## [v0.3.3] - 2018-08-24
### Fixed
- Compilation with latest nightly
## [v0.3.2] - 2018-04-16
### Added
- Span information to error messages
### Changed
- Some non fatal error messages have become warning messages. For example, specifying an empty list
of resources now produces a warning instead of a hard error.
2018-01-16 00:25:25 +01:00
## [v0.3.1] - 2018-01-16
### Fixed
- Documentation link
2018-01-15 23:26:07 +01:00
## [v0.3.0] - 2018-01-15
### Added
- [feat] `&'static mut` references can be safely created by assigning resources to `init`. See the
`init.resources` section of the `app!` macro documentation and the `safe-static-mut-ref` example
for details.
### Changed
- [breaking-change] svd2rust dependency has been bumped to v0.12.0
- [breaking-change] resources assigned to tasks, or to idle, that were not declared in the top
`resources` field generate compiler errors. Before these were assumed to be peripherals, that's no
longer the case.
- [breaking-change] the layout of `init::Peripherals` has changed. This struct now has two fields:
`core` and `device`. The value of the `core` field is a struct that owns all the core peripherals
of the device and the value of the `device` field is a struct that owns all the device specific
peripherals of the device.
2017-11-22 09:27:14 +01:00
## [v0.2.2] - 2017-11-22
### Added
- Support for runtime initialized resources ("late" resources).
2017-07-29 08:50:04 +02:00
## [v0.2.1] - 2017-07-29
### Fixed
- Link to `app!` macro documentation.
2017-07-29 08:16:11 +02:00
## [v0.2.0] - 2017-07-29
### Added
- The `app!` macro, a macro to declare the tasks and resources of an
application.
- The `Resource` trait, which is used to write generic code that deals with
resources.
2017-07-29 08:57:45 +02:00
- Support for system handlers like SYS_TICK.
2017-07-29 08:16:11 +02:00
### Changed
- [breaking-change] The signature of the `atomic` function has changed.
- [breaking-change] The threshold token has become a concrete type and lost its
`raise` method.
### Removed
- [breaking-change] The `tasks!` and `peripherals!` macros.
- [breaking-change] The ceiling and priority tokens.
- [breaking-change] The `Local`, `Resource` and `Peripheral` structs.
- [breaking-change] The traits related to type level integers.
2017-06-06 04:05:29 +02:00
## [v0.1.1] - 2017-06-05
### Changed
- `peripherals!`: The `register_block` field is now optional
2017-05-09 15:38:35 +02:00
## v0.1.0 - 2017-05-09
- Initial release
2020-08-27 14:45:29 +02:00
[Unreleased]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.5...HEAD
[v0.5.5]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.4...v0.5.5
2020-08-26 12:41:39 +02:00
[v0.5.4]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.3...v0.5.4
2020-06-12 09:32:43 +02:00
[v0.5.3]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.2...v0.5.3
2020-06-11 19:18:29 +02:00
[v0.5.2]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.1...v0.5.2
[v0.5.1]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.5.0...v0.5.1
[v0.5.0]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.4.3...v0.5.0
[v0.4.3]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.4.2...v0.4.3
[v0.4.2]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.4.1...v0.4.2
[v0.4.1]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.4.0...v0.4.1
[v0.4.0]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.3.4...v0.4.0
[v0.3.4]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.3.3...v0.3.4
[v0.3.3]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.3.2...v0.3.3
[v0.3.2]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.3.1...v0.3.2
[v0.3.1]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.3.0...v0.3.1
[v0.3.0]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.2.2...v0.3.0
[v0.2.2]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.2.1...v0.2.2
[v0.2.1]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.2.0...v0.2.1
[v0.2.0]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.1.1...v0.2.0
[v0.1.1]: https://github.com/rtic-rs/cortex-m-rtic/compare/v0.1.0...v0.1.1