forked from Minki/linux
8ff16cf77c
Almost all flash that are "compatible" with m25p80 support the JEDEC
READ ID opcode (0x9F), and in fact, that is often the only thing that is
used to differentiate them. Let's add a compatible string that
represents this lowest common denominator of compatibility.
Device trees can still specify manufacturer/device names in addition,
but (until some reason is found to differentiate between them through
device tree) software will likely want to bind just against the generic
name, and avoid unnecessarily growing its device ID binding tables.
This is related to the work of commit a5b7616c55 ("mtd:
m25p80,spi-nor: Fix module aliases for m25p80"), which showed that
maintaining these device tables as stable device-tree/modalias binding
tables is not a worthwhile burden for mostly-comptatible flash.
At the same time, let's update the binding doc to point to the
m25p_ids[] ID list instead of spi_nor_ids[]. The former can be used for
device tree bindings, but the latter cannot. In the future, we should
pare down the m25p_ids[] list to only those IDs which are actually used
in device trees.
Signed-off-by: Brian Norris <computersforpeace@gmail.com>
Cc: Rafał Miłecki <zajec5@gmail.com>
Reviewed-by: Marek Vasut <marex@denx.de>
33 lines
1.3 KiB
Plaintext
33 lines
1.3 KiB
Plaintext
* MTD SPI driver for ST M25Pxx (and similar) serial flash chips
|
|
|
|
Required properties:
|
|
- #address-cells, #size-cells : Must be present if the device has sub-nodes
|
|
representing partitions.
|
|
- compatible : May include a device-specific string consisting of the
|
|
manufacturer and name of the chip. Bear in mind the DT binding
|
|
is not Linux-only, but in case of Linux, see the "m25p_ids"
|
|
table in drivers/mtd/devices/m25p80.c for the list of supported
|
|
chips.
|
|
Must also include "nor-jedec" for any SPI NOR flash that can be
|
|
identified by the JEDEC READ ID opcode (0x9F).
|
|
- reg : Chip-Select number
|
|
- spi-max-frequency : Maximum frequency of the SPI bus the chip can operate at
|
|
|
|
Optional properties:
|
|
- m25p,fast-read : Use the "fast read" opcode to read data from the chip instead
|
|
of the usual "read" opcode. This opcode is not supported by
|
|
all chips and support for it can not be detected at runtime.
|
|
Refer to your chips' datasheet to check if this is supported
|
|
by your chip.
|
|
|
|
Example:
|
|
|
|
flash: m25p80@0 {
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
compatible = "spansion,m25p80", "nor-jedec";
|
|
reg = <0>;
|
|
spi-max-frequency = <40000000>;
|
|
m25p,fast-read;
|
|
};
|