1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * OMAP GPMC Platform data
4 *
5 * Copyright (C) 2014 Texas Instruments, Inc. - https://www.ti.com
6 * Roger Quadros <rogerq@ti.com>
7 */
8
9#ifndef _GPMC_OMAP_H_
10#define _GPMC_OMAP_H_
11
12/* Maximum Number of Chip Selects */
13#define GPMC_CS_NUM 8
14
15/* bool type time settings */
16struct gpmc_bool_timings {
17 bool cycle2cyclediffcsen;
18 bool cycle2cyclesamecsen;
19 bool we_extra_delay;
20 bool oe_extra_delay;
21 bool adv_extra_delay;
22 bool cs_extra_delay;
23 bool time_para_granularity;
24};
25
26/*
27 * Note that all values in this struct are in nanoseconds except sync_clk
28 * (which is in picoseconds), while the register values are in gpmc_fck cycles.
29 */
30struct gpmc_timings {
31 /* Minimum clock period for synchronous mode (in picoseconds) */
32 u32 sync_clk;
33
34 /* Chip-select signal timings corresponding to GPMC_CS_CONFIG2 */
35 u32 cs_on; /* Assertion time */
36 u32 cs_rd_off; /* Read deassertion time */
37 u32 cs_wr_off; /* Write deassertion time */
38
39 /* ADV signal timings corresponding to GPMC_CONFIG3 */
40 u32 adv_on; /* Assertion time */
41 u32 adv_rd_off; /* Read deassertion time */
42 u32 adv_wr_off; /* Write deassertion time */
43 u32 adv_aad_mux_on; /* ADV assertion time for AAD */
44 u32 adv_aad_mux_rd_off; /* ADV read deassertion time for AAD */
45 u32 adv_aad_mux_wr_off; /* ADV write deassertion time for AAD */
46
47 /* WE signals timings corresponding to GPMC_CONFIG4 */
48 u32 we_on; /* WE assertion time */
49 u32 we_off; /* WE deassertion time */
50
51 /* OE signals timings corresponding to GPMC_CONFIG4 */
52 u32 oe_on; /* OE assertion time */
53 u32 oe_off; /* OE deassertion time */
54 u32 oe_aad_mux_on; /* OE assertion time for AAD */
55 u32 oe_aad_mux_off; /* OE deassertion time for AAD */
56
57 /* Access time and cycle time timings corresponding to GPMC_CONFIG5 */
58 u32 page_burst_access; /* Multiple access word delay */
59 u32 access; /* Start-cycle to first data valid delay */
60 u32 rd_cycle; /* Total read cycle time */
61 u32 wr_cycle; /* Total write cycle time */
62
63 u32 bus_turnaround;
64 u32 cycle2cycle_delay;
65
66 u32 wait_monitoring;
67 u32 clk_activation;
68
69 /* The following are only on OMAP3430 */
70 u32 wr_access; /* WRACCESSTIME */
71 u32 wr_data_mux_bus; /* WRDATAONADMUXBUS */
72
73 struct gpmc_bool_timings bool_timings;
74};
75
76/* Device timings in picoseconds */
77struct gpmc_device_timings {
78 u32 t_ceasu; /* address setup to CS valid */
79 u32 t_avdasu; /* address setup to ADV valid */
80 /* XXX: try to combine t_avdp_r & t_avdp_w. Issue is
81 * of tusb using these timings even for sync whilst
82 * ideally for adv_rd/(wr)_off it should have considered
83 * t_avdh instead. This indirectly necessitates r/w
84 * variations of t_avdp as it is possible to have one
85 * sync & other async
86 */
87 u32 t_avdp_r; /* ADV low time (what about t_cer ?) */
88 u32 t_avdp_w;
89 u32 t_aavdh; /* address hold time */
90 u32 t_oeasu; /* address setup to OE valid */
91 u32 t_aa; /* access time from ADV assertion */
92 u32 t_iaa; /* initial access time */
93 u32 t_oe; /* access time from OE assertion */
94 u32 t_ce; /* access time from CS asertion */
95 u32 t_rd_cycle; /* read cycle time */
96 u32 t_cez_r; /* read CS deassertion to high Z */
97 u32 t_cez_w; /* write CS deassertion to high Z */
98 u32 t_oez; /* OE deassertion to high Z */
99 u32 t_weasu; /* address setup to WE valid */
100 u32 t_wpl; /* write assertion time */
101 u32 t_wph; /* write deassertion time */
102 u32 t_wr_cycle; /* write cycle time */
103
104 u32 clk;
105 u32 t_bacc; /* burst access valid clock to output delay */
106 u32 t_ces; /* CS setup time to clk */
107 u32 t_avds; /* ADV setup time to clk */
108 u32 t_avdh; /* ADV hold time from clk */
109 u32 t_ach; /* address hold time from clk */
110 u32 t_rdyo; /* clk to ready valid */
111
112 u32 t_ce_rdyz; /* XXX: description ?, or use t_cez instead */
113 u32 t_ce_avd; /* CS on to ADV on delay */
114
115 /* XXX: check the possibility of combining
116 * cyc_aavhd_oe & cyc_aavdh_we
117 */
118 u8 cyc_aavdh_oe;/* read address hold time in cycles */
119 u8 cyc_aavdh_we;/* write address hold time in cycles */
120 u8 cyc_oe; /* access time from OE assertion in cycles */
121 u8 cyc_wpl; /* write deassertion time in cycles */
122 u32 cyc_iaa; /* initial access time in cycles */
123
124 /* extra delays */
125 bool ce_xdelay;
126 bool avd_xdelay;
127 bool oe_xdelay;
128 bool we_xdelay;
129};
130
131#define GPMC_BURST_4 4 /* 4 word burst */
132#define GPMC_BURST_8 8 /* 8 word burst */
133#define GPMC_BURST_16 16 /* 16 word burst */
134#define GPMC_DEVWIDTH_8BIT 1 /* 8-bit device width */
135#define GPMC_DEVWIDTH_16BIT 2 /* 16-bit device width */
136#define GPMC_MUX_AAD 1 /* Addr-Addr-Data multiplex */
137#define GPMC_MUX_AD 2 /* Addr-Data multiplex */
138
139/* Wait pin polarity values */
140#define GPMC_WAITPINPOLARITY_INVALID UINT_MAX
141#define GPMC_WAITPINPOLARITY_ACTIVE_LOW 0
142#define GPMC_WAITPINPOLARITY_ACTIVE_HIGH 1
143
144#define GPMC_WAITPIN_INVALID UINT_MAX
145
146struct gpmc_settings {
147 bool burst_wrap; /* enables wrap bursting */
148 bool burst_read; /* enables read page/burst mode */
149 bool burst_write; /* enables write page/burst mode */
150 bool device_nand; /* device is NAND */
151 bool sync_read; /* enables synchronous reads */
152 bool sync_write; /* enables synchronous writes */
153 bool wait_on_read; /* monitor wait on reads */
154 bool wait_on_write; /* monitor wait on writes */
155 u32 burst_len; /* page/burst length */
156 u32 device_width; /* device bus width (8 or 16 bit) */
157 u32 mux_add_data; /* multiplex address & data */
158 u32 wait_pin; /* wait-pin to be used */
159 u32 wait_pin_polarity;
160};
161
162/* Data for each chip select */
163struct gpmc_omap_cs_data {
164 bool valid; /* data is valid */
165 bool is_nand; /* device within this CS is NAND */
166 struct gpmc_settings *settings;
167 struct gpmc_device_timings *device_timings;
168 struct gpmc_timings *gpmc_timings;
169 struct platform_device *pdev; /* device within this CS region */
170 unsigned int pdata_size;
171};
172
173struct gpmc_omap_platform_data {
174 struct gpmc_omap_cs_data cs[GPMC_CS_NUM];
175};
176
177#endif /* _GPMC_OMAP_H */
178

source code of linux/include/linux/platform_data/gpmc-omap.h