Nut/OS  4.10.3
API Reference
blockdev.h
Go to the documentation of this file.
00001 #ifndef DEV_BLOCKDEV_H_
00002 #define DEV_BLOCKDEV_H_
00003 
00004 /*
00005  * Copyright (C) 2005 by egnite Software GmbH. All rights reserved.
00006  *
00007  * Redistribution and use in source and binary forms, with or without
00008  * modification, are permitted provided that the following conditions
00009  * are met:
00010  *
00011  * 1. Redistributions of source code must retain the above copyright
00012  *    notice, this list of conditions and the following disclaimer.
00013  * 2. Redistributions in binary form must reproduce the above copyright
00014  *    notice, this list of conditions and the following disclaimer in the
00015  *    documentation and/or other materials provided with the distribution.
00016  * 3. Neither the name of the copyright holders nor the names of
00017  *    contributors may be used to endorse or promote products derived
00018  *    from this software without specific prior written permission.
00019  *
00020  * THIS SOFTWARE IS PROVIDED BY EGNITE SOFTWARE GMBH AND CONTRIBUTORS
00021  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00022  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
00023  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL EGNITE
00024  * SOFTWARE GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00025  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00026  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
00027  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
00028  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00029  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
00030  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00031  * SUCH DAMAGE.
00032  *
00033  * For additional information see http://www.ethernut.de/
00034  */
00035 
00060 #include <sys/types.h>
00061 #include <stdint.h>
00062 #include <sys/device.h>
00063 #include <sys/file.h>
00064 
00069 
00074 
00076 #define NUTBLKDEV_MEDIAAVAIL   0x1200
00077 
00078 #define NUTBLKDEV_MEDIACHANGE  0x1201
00079 
00080 #define NUTBLKDEV_INFO         0x1202
00081 
00082 #define NUTBLKDEV_SEEK         0x1203
00083 
00091 typedef struct _BLKPAR_SEEK {
00092     NUTFILE *par_nfp;
00093     uint32_t par_blknum;
00094 } BLKPAR_SEEK;
00095 
00101 typedef struct _BLKPAR_INFO {
00102     NUTFILE *par_nfp;
00103     uint32_t par_nblks;
00104     uint32_t par_blksz;
00105     uint8_t *par_blkbp;
00106 } BLKPAR_INFO;
00107 
00109 typedef struct _NUTBLOCKIO NUTBLOCKIO;
00110 
00119 struct _NUTBLOCKIO {
00123     void *blkio_info;
00124 
00128     uint32_t blkio_blk_cnt;
00129 
00133     uint32_t blkio_blk_siz;
00134 
00138     uint32_t blkio_vol_bot;
00139 
00143     uint32_t blkio_vol_top;
00144     
00148     int (*blkio_read) (NUTDEVICE *, uint32_t, void *, int);
00149 
00153     int (*blkio_write) (NUTDEVICE *, uint32_t, CONST void *, int);
00154 
00155 #ifdef __HARVARD_ARCH__
00156 
00159     int (*blkio_write_P) (NUTDEVICE *, uint32_t, PGM_P, int);
00160 #endif
00161 
00165     int (*blkio_ioctl)(NUTDEVICE *, int, void *);
00166 };
00167 
00170 __BEGIN_DECLS
00171 /* Prototypes */
00172 extern int NutBlockDeviceInit(NUTDEVICE * dev);
00173 extern NUTFILE *NutBlockDeviceOpen(NUTDEVICE * dev, CONST char *name, int mode, int acc);
00174 extern int NutBlockDeviceClose(NUTFILE * nfp);
00175 extern int NutBlockDeviceIOCtl(NUTDEVICE * dev, int req, void *conf);
00176 extern int NutBlockDeviceRead(NUTFILE * nfp, void *buffer, int num);
00177 extern int NutBlockDeviceWrite(NUTFILE *nfp, CONST void *buffer, int num);
00178 extern long NutBlockDeviceSize(NUTFILE *nfp);
00179 #ifdef __HARVARD_ARCH__
00180 extern int NutBlockDeviceWrite_P(NUTFILE * nfp, PGM_P buffer, int num);
00181 #endif
00182 /* Prototypes */
00183 __END_DECLS
00184 
00185 #endif