xref: /openbmc/u-boot/include/mtd/cfi_flash.h (revision 20b9f2ea)
1 /*
2  * (C) Copyright 2009
3  * Stefan Roese, DENX Software Engineering, sr@denx.de.
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 #ifndef __CFI_FLASH_H__
9 #define __CFI_FLASH_H__
10 
11 #define FLASH_CMD_CFI			0x98
12 #define FLASH_CMD_READ_ID		0x90
13 #define FLASH_CMD_RESET			0xff
14 #define FLASH_CMD_BLOCK_ERASE		0x20
15 #define FLASH_CMD_ERASE_CONFIRM		0xD0
16 #define FLASH_CMD_WRITE			0x40
17 #define FLASH_CMD_PROTECT		0x60
18 #define FLASH_CMD_SETUP			0x60
19 #define FLASH_CMD_SET_CR_CONFIRM	0x03
20 #define FLASH_CMD_PROTECT_SET		0x01
21 #define FLASH_CMD_PROTECT_CLEAR		0xD0
22 #define FLASH_CMD_CLEAR_STATUS		0x50
23 #define FLASH_CMD_READ_STATUS		0x70
24 #define FLASH_CMD_WRITE_TO_BUFFER	0xE8
25 #define FLASH_CMD_WRITE_BUFFER_PROG	0xE9
26 #define FLASH_CMD_WRITE_BUFFER_CONFIRM	0xD0
27 
28 #define FLASH_STATUS_DONE		0x80
29 #define FLASH_STATUS_ESS		0x40
30 #define FLASH_STATUS_ECLBS		0x20
31 #define FLASH_STATUS_PSLBS		0x10
32 #define FLASH_STATUS_VPENS		0x08
33 #define FLASH_STATUS_PSS		0x04
34 #define FLASH_STATUS_DPS		0x02
35 #define FLASH_STATUS_R			0x01
36 #define FLASH_STATUS_PROTECT		0x01
37 
38 #define AMD_CMD_RESET			0xF0
39 #define AMD_CMD_WRITE			0xA0
40 #define AMD_CMD_ERASE_START		0x80
41 #define AMD_CMD_ERASE_SECTOR		0x30
42 #define AMD_CMD_UNLOCK_START		0xAA
43 #define AMD_CMD_UNLOCK_ACK		0x55
44 #define AMD_CMD_WRITE_TO_BUFFER		0x25
45 #define AMD_CMD_WRITE_BUFFER_CONFIRM	0x29
46 #define AMD_CMD_SET_PPB_ENTRY		0xC0
47 #define AMD_CMD_SET_PPB_EXIT_BC1	0x90
48 #define AMD_CMD_SET_PPB_EXIT_BC2	0x00
49 #define AMD_CMD_PPB_UNLOCK_BC1		0x80
50 #define AMD_CMD_PPB_UNLOCK_BC2		0x30
51 #define AMD_CMD_PPB_LOCK_BC1		0xA0
52 #define AMD_CMD_PPB_LOCK_BC2		0x00
53 
54 #define AMD_STATUS_TOGGLE		0x40
55 #define AMD_STATUS_ERROR		0x20
56 
57 #define ATM_CMD_UNLOCK_SECT		0x70
58 #define ATM_CMD_SOFTLOCK_START		0x80
59 #define ATM_CMD_LOCK_SECT		0x40
60 
61 #define FLASH_CONTINUATION_CODE		0x7F
62 
63 #define FLASH_OFFSET_MANUFACTURER_ID	0x00
64 #define FLASH_OFFSET_DEVICE_ID		0x01
65 #define FLASH_OFFSET_LOWER_SW_BITS	0x0C
66 #define FLASH_OFFSET_DEVICE_ID2		0x0E
67 #define FLASH_OFFSET_DEVICE_ID3		0x0F
68 #define FLASH_OFFSET_CFI		0x55
69 #define FLASH_OFFSET_CFI_ALT		0x555
70 #define FLASH_OFFSET_CFI_RESP		0x10
71 #define FLASH_OFFSET_PRIMARY_VENDOR	0x13
72 /* extended query table primary address */
73 #define FLASH_OFFSET_EXT_QUERY_T_P_ADDR	0x15
74 #define FLASH_OFFSET_WTOUT		0x1F
75 #define FLASH_OFFSET_WBTOUT		0x20
76 #define FLASH_OFFSET_ETOUT		0x21
77 #define FLASH_OFFSET_CETOUT		0x22
78 #define FLASH_OFFSET_WMAX_TOUT		0x23
79 #define FLASH_OFFSET_WBMAX_TOUT		0x24
80 #define FLASH_OFFSET_EMAX_TOUT		0x25
81 #define FLASH_OFFSET_CEMAX_TOUT		0x26
82 #define FLASH_OFFSET_SIZE		0x27
83 #define FLASH_OFFSET_INTERFACE		0x28
84 #define FLASH_OFFSET_BUFFER_SIZE	0x2A
85 #define FLASH_OFFSET_NUM_ERASE_REGIONS	0x2C
86 #define FLASH_OFFSET_ERASE_REGIONS	0x2D
87 #define FLASH_OFFSET_PROTECT		0x02
88 #define FLASH_OFFSET_USER_PROTECTION	0x85
89 #define FLASH_OFFSET_INTEL_PROTECTION	0x81
90 
91 #define CFI_CMDSET_NONE			0
92 #define CFI_CMDSET_INTEL_EXTENDED	1
93 #define CFI_CMDSET_AMD_STANDARD		2
94 #define CFI_CMDSET_INTEL_STANDARD	3
95 #define CFI_CMDSET_AMD_EXTENDED		4
96 #define CFI_CMDSET_MITSU_STANDARD	256
97 #define CFI_CMDSET_MITSU_EXTENDED	257
98 #define CFI_CMDSET_SST			258
99 #define CFI_CMDSET_INTEL_PROG_REGIONS	512
100 
101 #ifdef CONFIG_SYS_FLASH_CFI_AMD_RESET /* needed for STM_ID_29W320DB on UC100 */
102 # undef  FLASH_CMD_RESET
103 # define FLASH_CMD_RESET	AMD_CMD_RESET /* use AMD-Reset instead */
104 #endif
105 
106 #define NUM_ERASE_REGIONS	4 /* max. number of erase regions */
107 
108 typedef union {
109 	u8 w8;
110 	u16 w16;
111 	u32 w32;
112 	u64 w64;
113 } cfiword_t;
114 
115 /* CFI standard query structure */
116 /* The offsets and sizes of this packed structure members correspond
117  * to the actual layout in CFI Flash chips. Some 16- and 32-bit members
118  * are unaligned and must be accessed with explicit unaligned access macros.
119  */
120 struct cfi_qry {
121 	u8	qry[3];
122 	u16	p_id;			/* unaligned */
123 	u16	p_adr;			/* unaligned */
124 	u16	a_id;			/* unaligned */
125 	u16	a_adr;			/* unaligned */
126 	u8	vcc_min;
127 	u8	vcc_max;
128 	u8	vpp_min;
129 	u8	vpp_max;
130 	u8	word_write_timeout_typ;
131 	u8	buf_write_timeout_typ;
132 	u8	block_erase_timeout_typ;
133 	u8	chip_erase_timeout_typ;
134 	u8	word_write_timeout_max;
135 	u8	buf_write_timeout_max;
136 	u8	block_erase_timeout_max;
137 	u8	chip_erase_timeout_max;
138 	u8	dev_size;
139 	u16	interface_desc;		/* aligned */
140 	u16	max_buf_write_size;	/* aligned */
141 	u8	num_erase_regions;
142 	u32	erase_region_info[NUM_ERASE_REGIONS];	/* unaligned */
143 } __attribute__((packed));
144 
145 struct cfi_pri_hdr {
146 	u8	pri[3];
147 	u8	major_version;
148 	u8	minor_version;
149 } __attribute__((packed));
150 
151 #ifndef CONFIG_SYS_FLASH_BANKS_LIST
152 #define CONFIG_SYS_FLASH_BANKS_LIST { CONFIG_SYS_FLASH_BASE }
153 #endif
154 
155 /*
156  * CFI_MAX_FLASH_BANKS only used for flash_info struct declaration.
157  *
158  * Use CONFIG_SYS_MAX_FLASH_BANKS_DETECT if defined
159  */
160 #if defined(CONFIG_SYS_MAX_FLASH_BANKS_DETECT)
161 #define CONFIG_SYS_MAX_FLASH_BANKS	(cfi_flash_num_flash_banks)
162 #define CFI_MAX_FLASH_BANKS	CONFIG_SYS_MAX_FLASH_BANKS_DETECT
163 /* board code can update this variable before CFI detection */
164 extern int cfi_flash_num_flash_banks;
165 #else
166 #define CFI_MAX_FLASH_BANKS	CONFIG_SYS_MAX_FLASH_BANKS
167 #endif
168 
169 phys_addr_t cfi_flash_bank_addr(int i);
170 unsigned long cfi_flash_bank_size(int i);
171 void flash_cmd_reset(flash_info_t *info);
172 
173 #ifdef CONFIG_CFI_FLASH_USE_WEAK_ACCESSORS
174 void flash_write8(u8 value, void *addr);
175 void flash_write16(u16 value, void *addr);
176 void flash_write32(u32 value, void *addr);
177 void flash_write64(u64 value, void *addr);
178 u8 flash_read8(void *addr);
179 u16 flash_read16(void *addr);
180 u32 flash_read32(void *addr);
181 u64 flash_read64(void *addr);
182 #endif
183 
184 #endif /* __CFI_FLASH_H__ */
185