1# Copyright (c) 2023 Nuvoton Technology Corporation.
2# SPDX-License-Identifier: Apache-2.0
3
4description: |
5    The target flash devices accessed by Nuvoton eSPI TAF controller.
6
7    Representation:
8
9      espi_taf: espitaf@4000a000 {
10        compatible = "nuvoton,npcx-espi-taf";
11        reg = <0x4000a000 0x2000>;
12
13        mapped-addr = <0x68000000>;
14        max-read-sz = "NPCX_ESPI_TAF_MAX_READ_REQ_64B";
15        erase-sz = "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_4KB";
16
17        #address-cells = <1>;
18        #size-cells = <1>;
19        status = "okay";
20      };
21
22compatible: "nuvoton,npcx-espi-taf"
23
24include: [espi-controller.yaml, pinctrl-device.yaml]
25
26properties:
27  mapped-addr:
28    type: int
29    description: |
30      Mapped memory address of direct read access for flash.
31    required: true
32
33  erase-sz:
34    type: string
35    required: true
36    description: |
37      Erase block size of target flash. The default was 4KB Erase Block Size.
38      All Intel platforms require support for at least 4 KB Erase Block Size.
39    default: "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_4KB"
40    enum:
41      - "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_4KB"
42      - "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_32KB"
43      - "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_64KB"
44      - "NPCX_ESPI_TAF_ERASE_BLOCK_SIZE_128KB"
45
46  max-read-sz:
47    type: string
48    required: true
49    description: |
50      Maximum read request size of flash access channel. The default was 64 bytes.
51      This value is recommended in datasheet.
52    default: "NPCX_ESPI_TAF_MAX_READ_REQ_64B"
53    enum:
54      - "NPCX_ESPI_TAF_MAX_READ_REQ_64B"
55      - "NPCX_ESPI_TAF_MAX_READ_REQ_128B"
56      - "NPCX_ESPI_TAF_MAX_READ_REQ_256B"
57      - "NPCX_ESPI_TAF_MAX_READ_REQ_512B"
58      - "NPCX_ESPI_TAF_MAX_READ_REQ_1024B"
59      - "NPCX_ESPI_TAF_MAX_READ_REQ_2048B"
60      - "NPCX_ESPI_TAF_MAX_READ_REQ_4096B"
61
62  rpmc-cntr:
63    type: int
64    description: |
65      RPMC counter on RPMC flash devices.
66    default: 0
67
68  rpmc-op1-code:
69    type: int
70    description: |
71      RPMC OP1 opcode on RPMC flash devices.
72    default: 0
73