xref: /NextBSD/sys/dev/nand/nandsim.h (revision eb1a5f8de9f7ea602c373a710f531abbf81141c4)
1 /*-
2  * Copyright (C) 2009-2012 Semihalf
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _NANDSIM_H_
30 #define _NANDSIM_H_
31 
32 #include <sys/ioccom.h>
33 #include <sys/types.h>
34 
35 #define MAX_SIM_DEV		4
36 #define MAX_CTRL_CS		4
37 #define MAX_ECC_BYTES		512
38 #define MAX_BAD_BLOCKS		512
39 #define DEV_MODEL_STR_SIZE	21
40 #define MAN_STR_SIZE		13
41 #define FILENAME_SIZE		20
42 
43 #define MAX_CHIPS	(MAX_SIM_DEV*MAX_CTRL_CS)
44 
45 #define NANDSIM_OUTPUT_NONE	0x0
46 #define NANDSIM_OUTPUT_CONSOLE	0x1
47 #define NANDSIM_OUTPUT_RAM	0x2
48 #define NANDSIM_OUTPUT_FILE	0x3
49 
50 struct sim_ctrl_chip {
51 	uint8_t		ctrl_num;
52 	uint8_t		chip_num;
53 };
54 
55 #define NANDSIM_BASE	'A'
56 
57 struct sim_param {
58 	uint8_t	log_level;
59 	uint8_t	log_output;
60 };
61 
62 #define NANDSIM_SIM_PARAM	_IOW(NANDSIM_BASE, 1, struct sim_param)
63 
64 struct sim_ctrl {
65 	uint8_t running;
66 	uint8_t created;
67 	uint8_t	num;
68 	uint8_t	num_cs;
69 	uint8_t ecc;
70 	char	filename[FILENAME_SIZE];
71 	uint16_t ecc_layout[MAX_ECC_BYTES];
72 };
73 #define NANDSIM_CREATE_CTRL	_IOW(NANDSIM_BASE, 2, struct sim_ctrl)
74 #define NANDSIM_DESTROY_CTRL	_IOW(NANDSIM_BASE, 3, int)
75 
76 struct sim_chip {
77 	uint8_t		num;
78 	uint8_t		ctrl_num;
79 	uint8_t		created;
80 	uint8_t		device_id;
81 	uint8_t		manufact_id;
82 	char		device_model[DEV_MODEL_STR_SIZE];
83 	char		manufacturer[MAN_STR_SIZE];
84 	uint8_t		col_addr_cycles;
85 	uint8_t		row_addr_cycles;
86 	uint8_t		features;
87 	uint8_t		width;
88 	uint32_t	page_size;
89 	uint32_t	oob_size;
90 	uint32_t	pgs_per_blk;
91 	uint32_t	blks_per_lun;
92 	uint32_t	luns;
93 
94 	uint32_t	prog_time;
95 	uint32_t	erase_time;
96 	uint32_t	read_time;
97 	uint32_t	ccs_time;
98 
99 	uint32_t	error_ratio;
100 	uint32_t	wear_level;
101 	uint32_t	bad_block_map[MAX_BAD_BLOCKS];
102 	uint8_t		is_wp;
103 };
104 
105 #define NANDSIM_CREATE_CHIP	_IOW(NANDSIM_BASE, 3, struct sim_chip)
106 
107 struct sim_chip_destroy {
108 	uint8_t ctrl_num;
109 	uint8_t chip_num;
110 };
111 #define NANDSIM_DESTROY_CHIP	_IOW(NANDSIM_BASE, 4, struct sim_chip_destroy)
112 
113 #define NANDSIM_START_CTRL	_IOW(NANDSIM_BASE, 5, int)
114 #define NANDSIM_STOP_CTRL	_IOW(NANDSIM_BASE, 6, int)
115 #define NANDSIM_RESTART_CTRL	_IOW(NANDSIM_BASE, 7, int)
116 
117 #define NANDSIM_STATUS_CTRL	_IOWR(NANDSIM_BASE, 8, struct sim_ctrl)
118 #define NANDSIM_STATUS_CHIP	_IOWR(NANDSIM_BASE, 9, struct sim_chip)
119 
120 struct sim_mod {
121 	uint8_t	chip_num;
122 	uint8_t	ctrl_num;
123 	uint32_t field;
124 	uint32_t new_value;
125 };
126 #define SIM_MOD_LOG_LEVEL	0
127 #define SIM_MOD_ERASE_TIME	1
128 #define SIM_MOD_PROG_TIME	2
129 #define SIM_MOD_READ_TIME	3
130 #define SIM_MOD_CCS_TIME	4
131 #define SIM_MOD_ERROR_RATIO	5
132 
133 #define NANDSIM_MODIFY	_IOW(NANDSIM_BASE, 10, struct sim_mod)
134 #define NANDSIM_FREEZE	_IOW(NANDSIM_BASE, 11, struct sim_ctrl_chip)
135 
136 struct sim_error {
137 	uint8_t		ctrl_num;
138 	uint8_t		chip_num;
139 	uint32_t	page_num;
140 	uint32_t	column;
141 	uint32_t	len;
142 	uint32_t	pattern;
143 };
144 #define NANDSIM_INJECT_ERROR	_IOW(NANDSIM_BASE, 20, struct sim_error)
145 
146 #define NANDSIM_GOOD_BLOCK	0
147 #define NANDSIM_BAD_BLOCK	1
148 struct sim_block_state {
149 	uint8_t		ctrl_num;
150 	uint8_t		chip_num;
151 	uint32_t	block_num;
152 	int		wearout;
153 	uint8_t		state;
154 };
155 #define NANDSIM_SET_BLOCK_STATE	_IOW(NANDSIM_BASE, 21, struct sim_block_state)
156 #define NANDSIM_GET_BLOCK_STATE	_IOWR(NANDSIM_BASE, 22, struct sim_block_state)
157 
158 struct sim_log {
159 	uint8_t		ctrl_num;
160 	char*		log;
161 	size_t		len;
162 };
163 #define NANDSIM_PRINT_LOG	_IOWR(NANDSIM_BASE, 23, struct sim_log)
164 
165 struct sim_dump {
166 	uint8_t		ctrl_num;
167 	uint8_t		chip_num;
168 	uint32_t	block_num;
169 	uint32_t	len;
170 	void*		data;
171 };
172 #define NANDSIM_DUMP	_IOWR(NANDSIM_BASE, 24, struct sim_dump)
173 #define NANDSIM_RESTORE	_IOWR(NANDSIM_BASE, 25, struct sim_dump)
174 
175 #endif /* _NANDSIM_H_ */
176