1# Copyright (c) 2021 - 2024 STMicroelectronics
2# SPDX-License-Identifier: Apache-2.0
3
4description: |
5    STM32 XSPI Flash controller supporting the JEDEC CFI interface
6
7    Representation of a serial flash on a xspi bus:
8
9        mx25lm51245: xspi-nor-flash@70000000 {
10                compatible = "st,stm32-xspi-nor";
11                reg = <0x70000000 DT_SIZE_M(64)>; /* 512 Mbits */
12                data-mode = <XSPI_OCTO_MODE>; /* access on 8 data lines */
13                data-rate = <XSPI_DTR_TRANSFER>; /* access in DTR */
14                ospi-max-frequency = <DT_FREQ_M(50)>;
15                status = "okay";
16        };
17
18compatible: "st,stm32-xspi-nor"
19
20include:
21  - name: st,stm32-ospi-nor.yaml
22    property-blocklist:
23      - spi-bus-width
24      - data-rate
25properties:
26  spi-bus-width:
27    type: int
28    required: true
29    description: |
30     The width of XSPI bus to which flash memory is connected.
31
32     Possible values are :
33      - XSPI_SPI_MODE  <1> = SPI mode on 1 data line
34      - XSPI_DUAL_MODE <2> = Dual mode on 2 data lines
35      - XSPI_QUAD_MODE <4> = Quad mode on 4 data lines
36      - XSPI_OCTO_MODE <8> = Octo mode on 8 data lines
37    enum:
38      - 1
39      - 2
40      - 4
41      - 8
42  data-rate:
43    type: int
44    required: true
45    description: |
46     The SPI data Rate is STR or DTR
47
48     Possible values are :
49      - XSPI_STR_TRANSFER <1> = Single Rate Transfer
50      - XSPI_DTR_TRANSFER <2> = Dual Rate Transfer (only with XSPI_OCTO_MODE)
51    enum:
52      - 1
53      - 2
54
55  ncs-line:
56    type: int
57    default: 1
58    enum:
59      - 1
60      - 2
61    description: |
62      Specifies which nCS line of the XSPI IO Manager is connected to the Flash.
63