dts: bindings: mtd: atmel,at2x: improve binding descriptions

Improve the binding descriptions for the atmel,at24 and atmel,at25 EEPROM
compatibles. These compatibles work for a number of different EEPROM
families manufactured by vendors other than Atmel.

Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
This commit is contained in:
Henrik Brix Andersen 2024-05-30 11:18:57 +02:00 committed by Henrik Brix Andersen
commit dd7f48ef4a
2 changed files with 60 additions and 2 deletions

View file

@ -2,7 +2,36 @@
# Copyright (c) 2018, Nordic Semiconductor
# SPDX-License-Identifier: Apache-2.0
description: Atmel AT24 (or compatible) I2C EEPROM
description: |
I2C EEPROMs compatible with Atmel's AT24 family
There are multiple vendors manufacturing I2C EEPROMs compatible with the programming model of the
Atmel AT24.
Examples of compatible EEPROM families:
- Microchip AT24xxx
- ST M24xxx
Each of these can be represented by a set of common parameters (EEPROM size, page size, address
width, and timeout) available from the datasheet of the specific EEPROM. The compatible string for
these can list the specific EEPROM vendor and model along with the vendor EEPROM family as long as
the least-specific compatible entry is "atmel,at24".
Example devicetree node describing a ST M24M01 EEPROM on the i2c0 bus:
&i2c0 {
status = "okay";
clock-frequency = <I2C_BITRATE_FAST>;
eeprom@56 {
compatible = "st,m24m01", "st,m24xxx", "atmel,at24";
reg = <0x56>;
size = <DT_SIZE_K(128)>;
pagesize = <256>;
address-width = <16>;
timeout = <5>;
};
};
compatible: "atmel,at24"

View file

@ -1,7 +1,36 @@
# Copyright (c) 2019 Vestas Wind Systems A/S
# SPDX-License-Identifier: Apache-2.0
description: Atmel AT25 (or compatible) SPI EEPROM
description: |
SPI EEPROMs compatible with Atmel's AT25 family
There are multiple vendors manufacturing SPI EEPROMs compatible with the programming model of the
Atmel AT25.
Examples of compatible EEPROM families:
- Microchip AT25xxx
- ST M95xxx
Each of these can be represented by a set of common parameters (EEPROM size, page size, address
width, and timeout) available from the datasheet of the specific EEPROM. The compatible string for
these can list the specific EEPROM vendor and model along with the vendor EEPROM family as long as
the least-specific compatible entry is "atmel,at25".
Example devicetree node describing a ST M95256 EEPROM on the spi0 bus:
&spi0 {
status = "okay";
eeprom@1 {
compatible = "st,m95256", "st,m95xxx", "atmel,at25";
reg = <0x1>;
size = <DT_SIZE_K(32)>;
pagesize = <64>;
address-width = <16>;
spi-max-frequency = <DT_FREQ_M(20)>;
timeout = <5>;
};
};
compatible: "atmel,at25"