253 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---4$id: http://devicetree.org/schemas/memory-controllers/ti,gpmc-child.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Texas Instruments GPMC Bus Child Nodes8 9maintainers:10 - Tony Lindgren <tony@atomide.com>11 - Roger Quadros <rogerq@kernel.org>12 13description:14 This binding is meant for the child nodes of the GPMC node. The node15 represents any device connected to the GPMC bus. It may be a Flash chip,16 RAM chip or Ethernet controller, etc. These properties are meant for17 configuring the GPMC settings/timings and will accompany the bindings18 supported by the respective device.19 20properties:21 reg: true22 23# GPMC Timing properties for child nodes. All are optional and default to 0.24 gpmc,sync-clk-ps:25 description: Minimum clock period for synchronous mode26 default: 027 28# Chip-select signal timings corresponding to GPMC_CONFIG2:29 gpmc,cs-on-ns:30 description: Assertion time31 default: 032 33 gpmc,cs-rd-off-ns:34 description: Read deassertion time35 default: 036 37 gpmc,cs-wr-off-ns:38 description: Write deassertion time39 default: 040 41# ADV signal timings corresponding to GPMC_CONFIG3:42 gpmc,adv-on-ns:43 description: Assertion time44 default: 045 46 gpmc,adv-rd-off-ns:47 description: Read deassertion time48 default: 049 50 gpmc,adv-wr-off-ns:51 description: Write deassertion time52 default: 053 54 gpmc,adv-aad-mux-on-ns:55 description: Assertion time for AAD56 default: 057 58 gpmc,adv-aad-mux-rd-off-ns:59 description: Read deassertion time for AAD60 default: 061 62 gpmc,adv-aad-mux-wr-off-ns:63 description: Write deassertion time for AAD64 default: 065 66# WE signals timings corresponding to GPMC_CONFIG4:67 gpmc,we-on-ns:68 description: Assertion time69 default: 070 71 gpmc,we-off-ns:72 description: Deassertion time73 default: 074 75# OE signals timings corresponding to GPMC_CONFIG4:76 gpmc,oe-on-ns:77 description: Assertion time78 default: 079 80 gpmc,oe-off-ns:81 description: Deassertion time82 default: 083 84 gpmc,oe-aad-mux-on-ns:85 description: Assertion time for AAD86 default: 087 88 gpmc,oe-aad-mux-off-ns:89 description: Deassertion time for AAD90 default: 091 92# Access time and cycle time timings (in nanoseconds) corresponding to93# GPMC_CONFIG5:94 gpmc,page-burst-access-ns:95 description: Multiple access word delay96 default: 097 98 gpmc,access-ns:99 description: Start-cycle to first data valid delay100 default: 0101 102 gpmc,rd-cycle-ns:103 description: Total read cycle time104 default: 0105 106 gpmc,wr-cycle-ns:107 description: Total write cycle time108 default: 0109 110 gpmc,bus-turnaround-ns:111 description: Turn-around time between successive accesses112 default: 0113 114 gpmc,cycle2cycle-delay-ns:115 description: Delay between chip-select pulses116 default: 0117 118 gpmc,clk-activation-ns:119 description: GPMC clock activation time120 default: 0121 122 gpmc,wait-monitoring-ns:123 description: Start of wait monitoring with regard to valid data124 default: 0125 126# Boolean timing parameters. If property is present, parameter is enabled127# otherwise disabled.128 gpmc,adv-extra-delay:129 description: ADV signal is delayed by half GPMC clock130 type: boolean131 132 gpmc,cs-extra-delay:133 description: CS signal is delayed by half GPMC clock134 type: boolean135 136 gpmc,cycle2cycle-diffcsen:137 description: |138 Add "cycle2cycle-delay" between successive accesses139 to a different CS140 type: boolean141 142 gpmc,cycle2cycle-samecsen:143 description: |144 Add "cycle2cycle-delay" between successive accesses145 to the same CS146 type: boolean147 148 gpmc,oe-extra-delay:149 description: OE signal is delayed by half GPMC clock150 type: boolean151 152 gpmc,we-extra-delay:153 description: WE signal is delayed by half GPMC clock154 type: boolean155 156 gpmc,time-para-granularity:157 description: Multiply all access times by 2158 type: boolean159 160# The following two properties are applicable only to OMAP3+ and AM335x:161 gpmc,wr-access-ns:162 description: |163 In synchronous write mode, for single or164 burst accesses, defines the number of165 GPMC_FCLK cycles from start access time166 to the GPMC_CLK rising edge used by the167 memory device for the first data capture.168 default: 0169 170 gpmc,wr-data-mux-bus-ns:171 description: |172 In address-data multiplex mode, specifies173 the time when the first data is driven on174 the address-data bus.175 default: 0176 177# GPMC chip-select settings properties for child nodes. All are optional.178 gpmc,burst-length:179 description: Page/burst length.180 $ref: /schemas/types.yaml#/definitions/uint32181 enum: [0, 4, 8, 16]182 default: 0183 184 gpmc,burst-wrap:185 description: Enables wrap bursting186 type: boolean187 188 gpmc,burst-read:189 description: Enables read page/burst mode190 type: boolean191 192 gpmc,burst-write:193 description: Enables write page/burst mode194 type: boolean195 196 gpmc,device-width:197 description: |198 Total width of device(s) connected to a GPMC199 chip-select in bytes. The GPMC supports 8-bit200 and 16-bit devices and so this property must be201 1 or 2.202 $ref: /schemas/types.yaml#/definitions/uint32203 enum: [1, 2]204 default: 1205 206 gpmc,mux-add-data:207 description: |208 Address and data multiplexing configuration.209 Valid values are210 0 for Non multiplexed mode211 1 for address-address-data multiplexing mode and212 2 for address-data multiplexing mode.213 $ref: /schemas/types.yaml#/definitions/uint32214 enum: [0, 1, 2]215 216 gpmc,sync-read:217 description: |218 Enables synchronous read. Defaults to asynchronous219 is this is not set.220 type: boolean221 222 gpmc,sync-write:223 description: |224 Enables synchronous writes. Defaults to asynchronous225 is this is not set.226 type: boolean227 228 gpmc,wait-pin:229 description: |230 Wait-pin used by client. Must be less than "gpmc,num-waitpins".231 $ref: /schemas/types.yaml#/definitions/uint32232 233 ti,wait-pin-polarity:234 description: |235 Set the desired polarity for the selected wait pin.236 0 for active low, 1 for active high.237 $ref: /schemas/types.yaml#/definitions/uint32238 enum: [0, 1]239 240 gpmc,wait-on-read:241 description: Enables wait monitoring on reads.242 type: boolean243 244 gpmc,wait-on-write:245 description: Enables wait monitoring on writes.246 type: boolean247 248required:249 - reg250 251# the GPMC child will have its own native properties252additionalProperties: true253