LibrePilot/flight/PiOS/inc/pios_sdcard.h

/**
 ******************************************************************************
 *
 * @file       pios_sdcard.h  
 * @author     The OpenPilot Team, http://www.openpilot.org Copyright (C) 2010.
 * 	       Parts by Thorsten Klose (tk@midibox.org)
 * @brief      System and hardware Init functions header.
 * @see        The GNU Public License (GPL) Version 3
 *
 *****************************************************************************/
/* 
 * This program is free software; you can redistribute it and/or modify 
 * it under the terms of the GNU General Public License as published by 
 * the Free Software Foundation; either version 3 of the License, or 
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful, but 
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 
 * for more details.
 * 
 * You should have received a copy of the GNU General Public License along 
 * with this program; if not, write to the Free Software Foundation, Inc., 
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */

#ifndef PIOS_SDCARD_H
#define PIOS_SDCARD_H

#if defined(PIOS_INCLUDE_SDCARD)

/* Public Functions */
typedef struct {
	uint8_t  CSDStruct;				/* CSD structure */
	uint8_t  SysSpecVersion;		/* System specification version */
	uint8_t  Reserved1;				/* Reserved */
	uint8_t  TAAC;					/* Data read access-time 1 */
	uint8_t  NSAC;					/* Data read access-time 2 in CLK cycles */
	uint8_t  MaxBusClkFrec;			/* Max. bus clock frequency */
	uint16_t CardComdClasses;		/* Card command classes */
	uint8_t  RdBlockLen;			/* Max. read data block length */
	uint8_t  PartBlockRead;			/* Partial blocks for read allowed */
	uint8_t  WrBlockMisalign;		/* Write block misalignment */
	uint8_t  RdBlockMisalign;		/* Read block misalignment */
	uint8_t  DSRImpl;				/* DSR implemented */
	uint8_t  Reserved2;				/* Reserved */
	uint16_t DeviceSize;			/* Device Size */
	uint8_t  MaxRdCurrentVDDMin;	/* Max. read current @ VDD min */
	uint8_t  MaxRdCurrentVDDMax;	/* Max. read current @ VDD max */
	uint8_t  MaxWrCurrentVDDMin;	/* Max. write current @ VDD min */
	uint8_t  MaxWrCurrentVDDMax;	/* Max. write current @ VDD max */
	uint8_t  DeviceSizeMul;			/* Device size multiplier */
	uint8_t  EraseGrSize;			/* Erase group size */
	uint8_t  EraseGrMul;			/* Erase group size multiplier */
	uint8_t  WrProtectGrSize;		/* Write protect group size */
	uint8_t  WrProtectGrEnable;		/* Write protect group enable */
	uint8_t  ManDeflECC;			/* Manufacturer default ECC */
	uint8_t  WrSpeedFact;			/* Write speed factor */
	uint8_t  MaxWrBlockLen;			/* Max. write data block length */
	uint8_t  WriteBlockPaPartial;	/* Partial blocks for write allowed */
	uint8_t  Reserved3;				/* Reserved */
	uint8_t  ContentProtectAppli;	/* Content protection application */
	uint8_t  FileFormatGrouop;		/* File format group */
	uint8_t  CopyFlag;				/* Copy flag (OTP) */
	uint8_t  PermWrProtect;			/* Permanent write protection */
	uint8_t  TempWrProtect;			/* Temporary write protection */
	uint8_t  FileFormat;			/* File Format */
	uint8_t  ECC;					/* ECC code */
	uint8_t  msd_CRC;				/* CRC */
	uint8_t  Reserved4;				/* always 1*/
} SDCARDCsdTypeDef;

/* Structure taken from Mass Storage Driver example provided by STM */
typedef struct {
  uint8_t  ManufacturerID;			/* ManufacturerID */
  uint16_t OEM_AppliID;				/* OEM/Application ID */
  char ProdName[6];					/* Product Name */
  uint8_t  ProdRev;					/* Product Revision */
  u32 ProdSN;						/* Product Serial Number */
  uint8_t  Reserved1;				/* Reserved1 */
  uint16_t ManufactDate;			/* Manufacturing Date */
  uint8_t  msd_CRC;					/* CRC */
  uint8_t  Reserved2;				/* always 1*/
} SDCARDCidTypeDef;

/* Global Variables */
extern VOLINFO PIOS_SDCARD_VolInfo;
extern uint8_t PIOS_SDCARD_Sector[SECTOR_SIZE];

/* Prototypes */
extern int32_t PIOS_SDCARD_Init(void);
extern int32_t PIOS_SDCARD_PowerOn(void);
extern int32_t PIOS_SDCARD_PowerOff(void);
extern int32_t PIOS_SDCARD_CheckAvailable(uint8_t was_available);
extern int32_t PIOS_SDCARD_SendSDCCmd(uint8_t cmd, uint32_t addr, uint8_t crc);
extern int32_t PIOS_SDCARD_SectorRead(uint32_t sector, uint8_t *buffer);
extern int32_t PIOS_SDCARD_SectorWrite(uint32_t sector, uint8_t *buffer);
extern int32_t PIOS_SDCARD_CIDRead(SDCARDCidTypeDef *cid);
extern int32_t PIOS_SDCARD_CSDRead(SDCARDCsdTypeDef *csd);

extern int32_t PIOS_SDCARD_StartupLog(void);
extern int32_t PIOS_SDCARD_MountFS(uint32_t StartupLog);
extern int32_t PIOS_SDCARD_GetFree(void);

extern int32_t PIOS_SDCARD_ReadBuffer(PFILEINFO fileinfo, uint8_t *buffer, uint32_t len);
extern int32_t PIOS_SDCARD_ReadLine(PFILEINFO fileinfo, uint8_t *buffer, uint32_t max_len);
extern int32_t PIOS_SDCARD_FileCopy(char *Source, char *Destination);
extern int32_t PIOS_SDCARD_FileDelete(char *Filename);

#endif

#endif /* PIOS_SDCARD_H */