esp-rom-sys 0.1.5

ROM code support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# esp-rom-sys

[![Crates.io](https://img.shields.io/crates/v/esp-rom-sys?labelColor=1C2C2E&color=C96329&logo=Rust&style=flat-square)](https://crates.io/crates/esp-rom-sys)
[![docs.rs](https://img.shields.io/docsrs/esp-rom-sys?labelColor=1C2C2E&color=C96329&logo=rust&style=flat-square)](https://docs.espressif.com/projects/rust/esp-rom-sys/latest/)
![MSRV](https://img.shields.io/badge/MSRV-1.95.0-blue?labelColor=1C2C2E&style=flat-square)
![Crates.io](https://img.shields.io/crates/l/esp-rom-sys?labelColor=1C2C2E&style=flat-square)
[![Matrix](https://img.shields.io/matrix/esp-rs:matrix.org?label=join%20matrix&labelColor=1C2C2E&color=BEC5C9&logo=matrix&style=flat-square)](https://matrix.to/#/#esp-rs:matrix.org)

ROM code support. This is an implementation detail of the esp-hal ecosystem crates.

This includes the definition of ROM code function addresses.

For some targets (ESP32 currently) we will use `libesp_rom.a` from ESP-IDF. The code here corresponds to [ESP-IDF v5.3.1](https://github.com/espressif/esp-idf/blob/v5.3.1/components/esp_rom/patches/esp_rom_spiflash.c)

Since there can be only one version of this crate used in a dependency tree this is expected to never see a major version bump. (i.e. all releases are patch releases)

That said, we cannot remove anything here. Degrading a symbol from hard linkage to weak linkage is allowed.

## Dependency policy in the esp-hal workspace

The workspace intentionally uses two dependency strategies for `esp-rom-sys`:

- Most crates use a non-exact requirement on the `0.1.x` line (for example
  `~0.1` / `~0.1.x`), so they can consume compatible patch updates.
- Crates that are tightly coupled to a specific radio/blob behavior pin an exact
  `esp-rom-sys` patch version (currently `esp-radio`).

Only one exact `esp-rom-sys` pin should exist in the dependency graph at a
time. This keeps Cargo resolution deterministic for radio stacks while
preserving patch-level flexibility for other crates.

## [Documentation](https://docs.espressif.com/projects/rust/esp-rom-sys/latest/)

## Minimum Supported Rust Version (MSRV)

This crate is guaranteed to compile when using the latest stable Rust version at the time of the crate's release. It _might_ compile with older versions, but that may change in any new release, including patches.

## License

Licensed under either of:

- Apache License, Version 2.0 ([LICENSE-APACHE](../LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](../LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

### Contribution

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.