tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
[MTD] LPDDR PFOW definition
LPDDR chips use PFOW window for sending commands, reading status and
capabilites requesting.
This pfow.h - contains definitions for PFOW window fileds, possible commands,
error flags and some common macro function to avoid code duplications.
Signed-off-by: Alexey Korolev <akorolev@infradead.org>
Acked-by: Jared Hulbert <jaredeh@gmail.com>
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
authored by
Alexey Korolev
and committed by
David Woodhouse
eb3db275
922ab535
+159
+159
include/linux/mtd/pfow.h
+159
include/linux/mtd/pfow.h
···
1
+
/* Primary function overlay window definitions
2
+
* and service functions used by LPDDR chips
3
+
*/
4
+
#ifndef __LINUX_MTD_PFOW_H
5
+
#define __LINUX_MTD_PFOW_H
6
+
7
+
#include <linux/mtd/qinfo.h>
8
+
9
+
/* PFOW registers addressing */
10
+
/* Address of symbol "P" */
11
+
#define PFOW_QUERY_STRING_P 0x0000
12
+
/* Address of symbol "F" */
13
+
#define PFOW_QUERY_STRING_F 0x0002
14
+
/* Address of symbol "O" */
15
+
#define PFOW_QUERY_STRING_O 0x0004
16
+
/* Address of symbol "W" */
17
+
#define PFOW_QUERY_STRING_W 0x0006
18
+
/* Identification info for LPDDR chip */
19
+
#define PFOW_MANUFACTURER_ID 0x0020
20
+
#define PFOW_DEVICE_ID 0x0022
21
+
/* Address in PFOW where prog buffer can can be found */
22
+
#define PFOW_PROGRAM_BUFFER_OFFSET 0x0040
23
+
/* Size of program buffer in words */
24
+
#define PFOW_PROGRAM_BUFFER_SIZE 0x0042
25
+
/* Address command code register */
26
+
#define PFOW_COMMAND_CODE 0x0080
27
+
/* command data register */
28
+
#define PFOW_COMMAND_DATA 0x0084
29
+
/* command address register lower address bits */
30
+
#define PFOW_COMMAND_ADDRESS_L 0x0088
31
+
/* command address register upper address bits */
32
+
#define PFOW_COMMAND_ADDRESS_H 0x008a
33
+
/* number of bytes to be proggrammed lower address bits */
34
+
#define PFOW_DATA_COUNT_L 0x0090
35
+
/* number of bytes to be proggrammed higher address bits */
36
+
#define PFOW_DATA_COUNT_H 0x0092
37
+
/* command execution register, the only possible value is 0x01 */
38
+
#define PFOW_COMMAND_EXECUTE 0x00c0
39
+
/* 0x01 should be written at this address to clear buffer */
40
+
#define PFOW_CLEAR_PROGRAM_BUFFER 0x00c4
41
+
/* device program/erase suspend register */
42
+
#define PFOW_PROGRAM_ERASE_SUSPEND 0x00c8
43
+
/* device status register */
44
+
#define PFOW_DSR 0x00cc
45
+
46
+
/* LPDDR memory device command codes */
47
+
/* They are possible values of PFOW command code register */
48
+
#define LPDDR_WORD_PROGRAM 0x0041
49
+
#define LPDDR_BUFF_PROGRAM 0x00E9
50
+
#define LPDDR_BLOCK_ERASE 0x0020
51
+
#define LPDDR_LOCK_BLOCK 0x0061
52
+
#define LPDDR_UNLOCK_BLOCK 0x0062
53
+
#define LPDDR_READ_BLOCK_LOCK_STATUS 0x0065
54
+
#define LPDDR_INFO_QUERY 0x0098
55
+
#define LPDDR_READ_OTP 0x0097
56
+
#define LPDDR_PROG_OTP 0x00C0
57
+
#define LPDDR_RESUME 0x00D0
58
+
59
+
/* Defines possible value of PFOW command execution register */
60
+
#define LPDDR_START_EXECUTION 0x0001
61
+
62
+
/* Defines possible value of PFOW program/erase suspend register */
63
+
#define LPDDR_SUSPEND 0x0001
64
+
65
+
/* Possible values of PFOW device status register */
66
+
/* access R - read; RC read & clearable */
67
+
#define DSR_DPS (1<<1) /* RC; device protect status
68
+
* 0 - not protected 1 - locked */
69
+
#define DSR_PSS (1<<2) /* R; program suspend status;
70
+
* 0-prog in progress/completed,
71
+
* 1- prog suspended */
72
+
#define DSR_VPPS (1<<3) /* RC; 0-Vpp OK, * 1-Vpp low */
73
+
#define DSR_PROGRAM_STATUS (1<<4) /* RC; 0-successful, 1-error */
74
+
#define DSR_ERASE_STATUS (1<<5) /* RC; erase or blank check status;
75
+
* 0-success erase/blank check,
76
+
* 1 blank check error */
77
+
#define DSR_ESS (1<<6) /* R; erase suspend status;
78
+
* 0-erase in progress/complete,
79
+
* 1 erase suspended */
80
+
#define DSR_READY_STATUS (1<<7) /* R; Device status
81
+
* 0-busy,
82
+
* 1-ready */
83
+
#define DSR_RPS (0x3<<8) /* RC; region program status
84
+
* 00 - Success,
85
+
* 01-re-program attempt in region with
86
+
* object mode data,
87
+
* 10-object mode program w attempt in
88
+
* region with control mode data
89
+
* 11-attempt to program invalid half
90
+
* with 0x41 command */
91
+
#define DSR_AOS (1<<12) /* RC; 1- AO related failure */
92
+
#define DSR_AVAILABLE (1<<15) /* R; Device availbility
93
+
* 1 - Device available
94
+
* 0 - not available */
95
+
96
+
/* The superset of all possible error bits in DSR */
97
+
#define DSR_ERR 0x133A
98
+
99
+
static inline void send_pfow_command(struct map_info *map,
100
+
unsigned long cmd_code, unsigned long adr,
101
+
unsigned long len, map_word *datum)
102
+
{
103
+
int bits_per_chip = map_bankwidth(map) * 8;
104
+
int chipnum;
105
+
struct lpddr_private *lpddr = map->fldrv_priv;
106
+
chipnum = adr >> lpddr->chipshift;
107
+
108
+
map_write(map, CMD(cmd_code), map->pfow_base + PFOW_COMMAND_CODE);
109
+
map_write(map, CMD(adr & ((1<<bits_per_chip) - 1)),
110
+
map->pfow_base + PFOW_COMMAND_ADDRESS_L);
111
+
map_write(map, CMD(adr>>bits_per_chip),
112
+
map->pfow_base + PFOW_COMMAND_ADDRESS_H);
113
+
if (len) {
114
+
map_write(map, CMD(len & ((1<<bits_per_chip) - 1)),
115
+
map->pfow_base + PFOW_DATA_COUNT_L);
116
+
map_write(map, CMD(len>>bits_per_chip),
117
+
map->pfow_base + PFOW_DATA_COUNT_H);
118
+
}
119
+
if (datum)
120
+
map_write(map, *datum, map->pfow_base + PFOW_COMMAND_DATA);
121
+
122
+
/* Command execution start */
123
+
map_write(map, CMD(LPDDR_START_EXECUTION),
124
+
map->pfow_base + PFOW_COMMAND_EXECUTE);
125
+
}
126
+
127
+
static inline void print_drs_error(unsigned dsr)
128
+
{
129
+
int prog_status = (dsr & DSR_RPS) >> 8;
130
+
131
+
if (!(dsr & DSR_AVAILABLE))
132
+
printk(KERN_NOTICE"DSR.15: (0) Device not Available\n");
133
+
if (prog_status & 0x03)
134
+
printk(KERN_NOTICE"DSR.9,8: (11) Attempt to program invalid "
135
+
"half with 41h command\n");
136
+
else if (prog_status & 0x02)
137
+
printk(KERN_NOTICE"DSR.9,8: (10) Object Mode Program attempt "
138
+
"in region with Control Mode data\n");
139
+
else if (prog_status & 0x01)
140
+
printk(KERN_NOTICE"DSR.9,8: (01) Program attempt in region "
141
+
"with Object Mode data\n");
142
+
if (!(dsr & DSR_READY_STATUS))
143
+
printk(KERN_NOTICE"DSR.7: (0) Device is Busy\n");
144
+
if (dsr & DSR_ESS)
145
+
printk(KERN_NOTICE"DSR.6: (1) Erase Suspended\n");
146
+
if (dsr & DSR_ERASE_STATUS)
147
+
printk(KERN_NOTICE"DSR.5: (1) Erase/Blank check error\n");
148
+
if (dsr & DSR_PROGRAM_STATUS)
149
+
printk(KERN_NOTICE"DSR.4: (1) Program Error\n");
150
+
if (dsr & DSR_VPPS)
151
+
printk(KERN_NOTICE"DSR.3: (1) Vpp low detect, operation "
152
+
"aborted\n");
153
+
if (dsr & DSR_PSS)
154
+
printk(KERN_NOTICE"DSR.2: (1) Program suspended\n");
155
+
if (dsr & DSR_DPS)
156
+
printk(KERN_NOTICE"DSR.1: (1) Aborted Erase/Program attempt "
157
+
"on locked block\n");
158
+
}
159
+
#endif /* __LINUX_MTD_PFOW_H */