This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

st,stm32-ospi-nor (on ospi bus)

Vendor: STMicroelectronics

Description

STM32 OSPI Flash controller supporting the JEDEC CFI interface

Representation of a serial flash on a octospi bus:

    mx25lm51245: ospi-nor-flash@0 {
            compatible = "st,stm32-ospi-nor";
            label = "MX25LM512";
            reg = <0>;
            data-mode = <OSPI_OPI_MODE>; /* access on 8 data lines */
            data-rate = <OSPI_DTR_TRANSFER>; /* access in DTR */
            ospi-max-frequency = <DT_FREQ_M(50)>;
            size = <DT_SIZE_M(4)>;
            status = "okay";
    };

Properties

Properties not inherited from the base binding file.

Name

Type

Details

ospi-max-frequency

int

Maximum clock frequency of device's OSPI interface in Hz

This property is required.

size

int

Flash Memory size in bits

This property is required.

reset-gpios

phandle-array

RESETn pin

spi-bus-width

int

The width of (Octo)SPI bus to which flash memory is connected.

Possible values are :
 - OSPI_SPI_MODE <1> = SPI mode on 1 data line
 - OSPI_OPI_MODE <8> = Octo SPI mode on 8 data lines

This property is required.

Legal values: 1, 8

data-rate

int

The SPI data Rate is STR or DTR

Possible values are :
 - OSPI_STR_TRANSFER <1> = Single Rate Transfer
 - OSPI_DTR_TRANSFER <2> = Dual Rate Transfer (only with OSPI_OPI_MODE)

This property is required.

Legal values: 1, 2

jedec-id

uint8-array

JEDEC ID as manufacturer ID, memory type, memory density

sfdp-bfp

uint8-array

Contains the 32-bit words in little-endian byte order from the
JESD216 Serial Flash Discoverable Parameters Basic Flash
Parameters table.  This provides flash-specific configuration
information in cases were runtime retrieval of SFDP data
is not desired.

quad-enable-requirements

string

Quad Enable Requirements value from JESD216 BFP DW15.

Use NONE if the device detects 1-1-4 and 1-4-4 modes by the
instruction.  Use S1B6 if QE is bit 6 of the first status register
byte, and can be configured by reading then writing one byte with
RDSR and WRSR.  For other fields see the specification.

Legal values: 'NONE', 'S2B1v1', 'S1B6', 'S2B7', 'S2B1v4', 'S2B1v5', 'S2B1v6'

enter-4byte-addr

int

Enter 4-Byte Addressing value from JESD216 BFP DW16

This property is ignored if the device is configured to use SFDP data
from the sfdp-bfp property (CONFIG_SPI_NOR_SFDP_DEVICETREE) or to read
SFDP properties at runtime (CONFIG_SPI_NOR_SFDP_RUNTIME).

For CONFIG_SPI_NOR_SFDP_MINIMAL this is the 8-bit value from bits 31:24
of DW16 identifying ways a device can be placed into 4-byte addressing
mode.  If provided as a non-zero value the driver assumes that 4-byte
addressing is require to access the full address range, and
automatically puts the device into 4-byte address mode when the device
is initialized.