CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

No unreleased changes yet

1.0.3 - 2023-07-11

• Crate is deprecated, use portable-atomic instead.

1.0.2 - 2023-03-12

• Add MSP430 support.

1.0.1 - 2022-08-12

• Fix AtomicPtr accidentally not being available when not polyfilled.

1.0.0 - 2022-08-12

• Update to critical-section v1.0

0.1.11 - 2022-11-29

• Bump critical-section dependency from 0.2 to 1.0.

  This is a breaking change if you were relying on the default implementations available on critical-section 0.2.7 and earlier. They have been removed in critical-section 0.2.8 because they were unsound, since there's no way to guarantee they're correct for the target in use (for example for multi-core embedded targets). Since critical-section 0.2.8 just forwards to 1.0 now, we decided to change atomic-polyfill to use 1.0 directly.

  If you're seeing a linker error like undefined symbol: _critical_section_1_0_acquire, you're affected. To fix it:

  • If your target supports std: Add the critical-section dependency to Cargo.toml enabling the std feature.

    [dependencies]
    critical-section = { version = "1.1", features = ["std"]}

  • For single-core Cortex-M targets in privileged mode:

    [dependencies]
    cortex-m = { version = "0.7.6", features = ["critical-section-single-core"]}

  • For single-hart RISC-V targets in privileged mode:

    [dependencies]
    riscv = { version = "0.10", features = ["critical-section-single-hart"]}

  • For other targets: check if your HAL or architecture-support crate has a critical-section 1.0 implementation available. Otherwise, provide your own.

0.1.10 - 2022-08-12

• Fix AtomicPtr accidentally not being available when not polyfilled.

0.1.9 - 2022-08-12

• Switch to only two polyfill levels.

The "CAS" level which uses atomic load/store and critical-section based CAS was not sound, because critical-section guarantees only "no other critical section can run concurrently", not "no other code can run concurrently". Therefore a CS-based CAS can still race a native atomic store.

0.1.8 - 2022-04-12

• Added AVR support.

0.1.7 - 2022-03-22

• Added support for xtensa (ESP chips), with and without ESP-IDF.
• Reexport core::sync::atomic::* as-is for unknown targets, to avoid build failures if they don't have full atomic support.

0.1.6 - 2022-02-08

• Add polyfill support for thumbv4t targets. (Nintendo Game Boy Advance)
• Added get_mut() to AtomicBool.
• Added into_inner() to all atomics
• Added fmt::Debug impl to AtomicBool, AtomicPtr.
• Added fmt::Pointer impl to AtomicPtr.
• Added From<*mut T> impl to AtomicPtr.
• Added RefUnwindSafe impl to all atomics.

0.1.5 - 2021-11-02

• Updated critical-section to v0.2.5. Fixes std implementation to allow reentrant (nested) critical sections. This would previously deadlock.

0.1.4 - 2021-09-20

• Added support for RISC-V.
• Added support for "full polyfill" level, where load/stores are polyfilled, not just CAS operations.
• Added support for AtomicU64, AtomicI64.

0.1.3 - 2021-08-07

• Only import cortex-m when needed (#4)
• Fix panic on fetch_update due to incorrect ordering (#5)

0.1.2 - 2021-03-29

• Added missing reexport of fence and compiler_fence in polyfilled mode.

0.1.1 - 2021-03-04

• Added polyfills for AtomicU8, AtomicU16, AtomicUsize, AtomicI8, AtomicI16, AtomicI32, AtomicIsize

0.1.0 - 2021-03-04

• First release