]>
git.ipfire.org Git - people/ms/u-boot.git/blob - api/api_storage.c
2 * (C) Copyright 2007-2008 Semihalf
4 * Written by: Rafal Jaworowski <raj@semihalf.com>
6 * See file CREDITS for list of people who contributed to this
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License as
11 * published by the Free Software Foundation; either version 2 of
12 * the License, or (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
28 #if defined(CONFIG_API)
31 #include <api_public.h>
37 #define debugf(fmt, args...) do { printf("%s(): ", __func__); printf(fmt, ##args); } while (0)
39 #define debugf(fmt, args...)
42 #define errf(fmt, args...) do { printf("ERROR @ %s(): ", __func__); printf(fmt, ##args); } while (0)
56 int type
; /* "external" type: DT_STOR_{IDE,USB,etc} */
60 static struct stor_spec specs
[ENUM_MAX
] = { { 0, 0, 0, 0, "" }, };
63 void dev_stor_init(void)
65 #if defined(CONFIG_CMD_IDE)
66 specs
[ENUM_IDE
].max_dev
= CFG_IDE_MAXDEVICE
;
67 specs
[ENUM_IDE
].enum_started
= 0;
68 specs
[ENUM_IDE
].enum_ended
= 0;
69 specs
[ENUM_IDE
].type
= DEV_TYP_STOR
| DT_STOR_IDE
;
70 specs
[ENUM_IDE
].name
= "ide";
72 #if defined(CONFIG_CMD_MMC)
73 specs
[ENUM_MMC
].max_dev
= CFG_MMC_MAX_DEVICE
;
74 specs
[ENUM_MMC
].enum_started
= 0;
75 specs
[ENUM_MMC
].enum_ended
= 0;
76 specs
[ENUM_MMC
].type
= DEV_TYP_STOR
| DT_STOR_MMC
;
77 specs
[ENUM_MMC
].name
= "mmc";
79 #if defined(CONFIG_CMD_SATA)
80 specs
[ENUM_SATA
].max_dev
= CFG_SATA_MAX_DEVICE
;
81 specs
[ENUM_SATA
].enum_started
= 0;
82 specs
[ENUM_SATA
].enum_ended
= 0;
83 specs
[ENUM_SATA
].type
= DEV_TYP_STOR
| DT_STOR_SATA
;
84 specs
[ENUM_SATA
].name
= "sata";
86 #if defined(CONFIG_CMD_SCSI)
87 specs
[ENUM_SCSI
].max_dev
= CFG_SCSI_MAX_DEVICE
;
88 specs
[ENUM_SCSI
].enum_started
= 0;
89 specs
[ENUM_SCSI
].enum_ended
= 0;
90 specs
[ENUM_SCSI
].type
= DEV_TYP_STOR
| DT_STOR_SCSI
;
91 specs
[ENUM_SCSI
].name
= "scsi";
93 #if defined(CONFIG_CMD_USB) && defined(CONFIG_USB_STORAGE)
94 specs
[ENUM_USB
].max_dev
= USB_MAX_STOR_DEV
;
95 specs
[ENUM_USB
].enum_started
= 0;
96 specs
[ENUM_USB
].enum_ended
= 0;
97 specs
[ENUM_USB
].type
= DEV_TYP_STOR
| DT_STOR_USB
;
98 specs
[ENUM_USB
].name
= "usb";
103 * Finds next available device in the storage group
105 * type: storage group type - ENUM_IDE, ENUM_SCSI etc.
107 * first: if 1 the first device in the storage group is returned (if
108 * exists), if 0 the next available device is searched
110 * more: returns 0/1 depending if there are more devices in this group
111 * available (for future iterations)
113 * returns: 0/1 depending if device found in this iteration
115 static int dev_stor_get(int type
, int first
, int *more
, struct device_info
*di
)
122 block_dev_desc_t
*dd
;
125 di
->cookie
= (void *)get_dev(specs
[type
].name
, 0);
126 if (di
->cookie
== NULL
)
132 for (i
= 0; i
< specs
[type
].max_dev
; i
++)
133 if (di
->cookie
== (void *)get_dev(specs
[type
].name
, i
)) {
134 /* previous cookie found -- advance to the
135 * next device, if possible */
137 if (++i
>= specs
[type
].max_dev
) {
138 /* out of range, no more to enum */
143 di
->cookie
= (void *)get_dev(specs
[type
].name
, i
);
144 if (di
->cookie
== NULL
)
149 /* provide hint if there are more devices in
150 * this group to enumerate */
151 if ((i
+ 1) < specs
[type
].max_dev
)
159 di
->type
= specs
[type
].type
;
161 if (di
->cookie
!= NULL
) {
162 dd
= (block_dev_desc_t
*)di
->cookie
;
163 if (dd
->type
== DEV_TYPE_UNKNOWN
) {
164 debugf("device instance exists, but is not active..");
167 di
->di_stor
.block_count
= dd
->lba
;
168 di
->di_stor
.block_size
= dd
->blksz
;
180 * returns: ENUM_IDE, ENUM_USB etc. based on block_dev_desc_t
182 static int dev_stor_type(block_dev_desc_t
*dd
)
186 for (i
= ENUM_IDE
; i
< ENUM_MAX
; i
++)
187 for (j
= 0; j
< specs
[i
].max_dev
; j
++)
188 if (dd
== get_dev(specs
[i
].name
, j
))
196 * returns: 0/1 whether cookie points to some device in this group
198 static int dev_is_stor(int type
, struct device_info
*di
)
200 return (dev_stor_type(di
->cookie
) == type
) ? 1 : 0;
204 static int dev_enum_stor(int type
, struct device_info
*di
)
206 int found
= 0, more
= 0;
208 debugf("called, type %d\n", type
);
211 * Formulae for enumerating storage devices:
212 * 1. if cookie (hint from previous enum call) is NULL we start again
213 * with enumeration, so return the first available device, done.
215 * 2. if cookie is not NULL, check if it identifies some device in
218 * 2a. if cookie is a storage device from our group (IDE, USB etc.),
219 * return next available (if exists) in this group
221 * 2b. if it isn't device from our group, check if such devices were
222 * ever enumerated before:
223 * - if not, return the first available device from this group
227 if (di
->cookie
== NULL
) {
229 debugf("group%d - enum restart\n", type
);
232 * 1. Enumeration (re-)started: take the first available
235 found
= dev_stor_get(type
, 1, &more
, di
);
236 specs
[type
].enum_started
= 1;
238 } else if (dev_is_stor(type
, di
)) {
240 debugf("group%d - enum continued for the next device\n", type
);
242 if (specs
[type
].enum_ended
) {
243 debugf("group%d - nothing more to enum!\n", type
);
247 /* 2a. Attempt to take a next available device in the group */
248 found
= dev_stor_get(type
, 0, &more
, di
);
252 if (specs
[type
].enum_ended
) {
253 debugf("group %d - already enumerated, skipping\n", type
);
257 debugf("group%d - first time enum\n", type
);
259 if (specs
[type
].enum_started
== 0) {
261 * 2b. If enumerating devices in this group did not
262 * happen before, it means the cookie pointed to a
263 * device frome some other group (another storage
264 * group, or network); in this case try to take the
265 * first available device from our group
267 specs
[type
].enum_started
= 1;
270 * Attempt to take the first device in this group:
271 *'first element' flag is set
273 found
= dev_stor_get(type
, 1, &more
, di
);
276 errf("group%d - out of order iteration\n", type
);
283 * If there are no more devices in this group, consider its
284 * enumeration finished
286 specs
[type
].enum_ended
= (!more
) ? 1 : 0;
289 debugf("device found, returning cookie 0x%08x\n",
290 (u_int32_t
)di
->cookie
);
292 debugf("no device found\n");
297 void dev_enum_reset(void)
301 for (i
= 0; i
< ENUM_MAX
; i
++) {
302 specs
[i
].enum_started
= 0;
303 specs
[i
].enum_ended
= 0;
307 int dev_enum_storage(struct device_info
*di
)
312 * check: ide, usb, scsi, mmc
314 for (i
= ENUM_IDE
; i
< ENUM_MAX
; i
++) {
315 if (dev_enum_stor(i
, di
))
322 static int dev_stor_is_valid(int type
, block_dev_desc_t
*dd
)
326 for (i
= 0; i
< specs
[type
].max_dev
; i
++)
327 if (dd
== get_dev(specs
[type
].name
, i
))
328 if (dd
->type
!= DEV_TYPE_UNKNOWN
)
335 int dev_open_stor(void *cookie
)
337 int type
= dev_stor_type(cookie
);
339 if (type
== ENUM_MAX
)
342 if (dev_stor_is_valid(type
, (block_dev_desc_t
*)cookie
))
349 int dev_close_stor(void *cookie
)
352 * Not much to do as we actually do not alter storage devices upon
359 static int dev_stor_index(block_dev_desc_t
*dd
)
363 type
= dev_stor_type(dd
);
364 for (i
= 0; i
< specs
[type
].max_dev
; i
++)
365 if (dd
== get_dev(specs
[type
].name
, i
))
368 return (specs
[type
].max_dev
);
372 lbasize_t
dev_read_stor(void *cookie
, void *buf
, lbasize_t len
, lbastart_t start
)
375 block_dev_desc_t
*dd
= (block_dev_desc_t
*)cookie
;
377 if ((type
= dev_stor_type(dd
)) == ENUM_MAX
)
380 if (!dev_stor_is_valid(type
, dd
))
383 if ((dd
->block_read
) == NULL
) {
384 debugf("no block_read() for device 0x%08x\n", cookie
);
388 return (dd
->block_read(dev_stor_index(dd
), start
, len
, buf
));
391 #endif /* CONFIG_API */