199767f8919635c4928607450d9e0abb932109ceToomas Soome * Copyright (c) 2006 M. Warner Losh. All rights reserved.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * Redistribution and use in source and binary forms, with or without
199767f8919635c4928607450d9e0abb932109ceToomas Soome * modification, are permitted provided that the following conditions
199767f8919635c4928607450d9e0abb932109ceToomas Soome * 1. Redistributions of source code must retain the above copyright
199767f8919635c4928607450d9e0abb932109ceToomas Soome * notice, this list of conditions and the following disclaimer.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * 2. Redistributions in binary form must reproduce the above copyright
199767f8919635c4928607450d9e0abb932109ceToomas Soome * notice, this list of conditions and the following disclaimer in the
199767f8919635c4928607450d9e0abb932109ceToomas Soome * documentation and/or other materials provided with the distribution.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
199767f8919635c4928607450d9e0abb932109ceToomas Soome * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
199767f8919635c4928607450d9e0abb932109ceToomas Soome * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
199767f8919635c4928607450d9e0abb932109ceToomas Soome * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
199767f8919635c4928607450d9e0abb932109ceToomas Soome * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
199767f8919635c4928607450d9e0abb932109ceToomas Soome * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
199767f8919635c4928607450d9e0abb932109ceToomas Soome * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
199767f8919635c4928607450d9e0abb932109ceToomas Soome * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
199767f8919635c4928607450d9e0abb932109ceToomas Soome * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * This software is derived from software provide by Kwikbyte who specifically
199767f8919635c4928607450d9e0abb932109ceToomas Soome * disclaimed copyright on the code.
199767f8919635c4928607450d9e0abb932109ceToomas Soome/* MCI_read() is the original read function, taking a byte offset and byte
199767f8919635c4928607450d9e0abb932109ceToomas Soome * count. It is preserved to support existing customized boot code that still
199767f8919635c4928607450d9e0abb932109ceToomas Soome * refers to it; it will work fine even on SDHC cards as long as the kernel and
199767f8919635c4928607450d9e0abb932109ceToomas Soome * the metadata for locating it all exist within the first 4GB of the card.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * MCI_readblocks() is the new read function, taking offset and length in terms
199767f8919635c4928607450d9e0abb932109ceToomas Soome * of block counts (where the SD spec defines a block as 512 bytes), allowing
199767f8919635c4928607450d9e0abb932109ceToomas Soome * the kernel and filesystem metadata to be located anywhere on an SDHC card.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * Returns 0 on success, non-zero on failure.
199767f8919635c4928607450d9e0abb932109ceToomas Soomeint MCI_read (char* dest, unsigned bytenum, unsigned length);
199767f8919635c4928607450d9e0abb932109ceToomas Soomeint MCI_readblocks (char* dest, unsigned blknum, unsigned blkcount);
199767f8919635c4928607450d9e0abb932109ceToomas Soome/* sdcard_init() - get things set up to read from an SD or SDHC card.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * Returns 0 on failure, non-zero on success.
199767f8919635c4928607450d9e0abb932109ceToomas Soome/* By default sdcard_init() sets things up for a 1-wire interface to the
199767f8919635c4928607450d9e0abb932109ceToomas Soome * SD card. Calling sdcard_4wire(true) after sdcard_init() allows customized
199767f8919635c4928607450d9e0abb932109ceToomas Soome * boot code to change to 4-bit transfers when the hardware supports it.
199767f8919635c4928607450d9e0abb932109ceToomas Soome * Returns 0 on failure, non-zero on success.