Admin at 10:40, 13 February 2013

2013-02-13T10:40:14Z

New page

'''== (**COPIED FROM ENGLISH PAGE**) =='''AVR-DOS is a Disk Operating System (DOS) for Atmel AVR microcontroller.

The AVR-DOS file system is written by Josef Franz Vögel. He can be contacted via the BASCOM forum.

Josef has put a lot of effort in writing and especially testing the routines.

 

Topics of AVR-DOS File System:
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 1.
| Introduction
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 2.
| Important Steps to configure AVR-DOS
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 3.
| Requirements
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 4.
| Steps to get started with an ATMEGA (and with MMC.lib)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 5.
| Getting started with an ATMEGA and ATXMEGA with MMCSD_HC.LIB
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 6.
| Memory Usage of DOS – File System
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 7.
| Error Codes
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 8.
| Buffer Status: Bit definitions of Buffer Status Byte (Directory, FAT and File)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 9.
| Validity of the file I/O operations regarding the opening modes
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 10.
| SD and SDHC specs and pin-out
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 11.
| Example 1 for getting started with an ATMEGA and ATXMEGA with MMCSD_HC.LIB
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 12.
| Example 1: Following the Config_MMCSD_HC.INC which is included in the main example program
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 13.
| Example 1: Following the Config_AVR-DOS.inc which is included in the main example program
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 14.
| Example 2: SD and SDHC Card Analysis Example Demo program
|}
</div>
(Show the Card Capacity and the Card-Register CSD, CID, OCR and SD_Status)

 

= Introduction =

 

AVR-DOS provide the needed libraries to handle:
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| The file system like open and/or create a file, send to or read from a file (Binary files and ASCII files)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Interface functions (drivers) for [[Compact_FlashCard_Driver|Compact Flash]], hard disk, SD-Cards, SDHC (also microSD or microSDHC). See SD and SDHC pinout below.
|}
</div>
 

See also: [[New_CF-Card_Drivers|New CF-Card Drivers]], [[Elektor_CF-Interface|Elektor CF-Interface]]

 

The Filesystem works with:
<div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| FAT16 formatted partitions
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| FAT32 formatted partitions
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Short file name (8.3)
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Files with a long file name can be accessed by their short file name alias
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Files in Root Directory. The root dir can store 512 files. Take in mind that when you use long file names, less filenames can be stored.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Files in Root directory and sub directories
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| LBA mode (Logical block addressing) which is a linear addressing scheme where blocks are located by an integer index.
|}
</div>
 

SD-card is a further development of the former MMC (Multi Media Card).

FAT = File Allocation Table and is the name of the file system architecture (FAT16 means 16-Bit version of FAT).

 

A SD or SDHC card is working at 2.7V ... 3.6V so for ATMEGA running at 5V you need a voltage converter or voltage divider. ATXMEGA are running at 2.7V ... 3.6V anyway so you can connect the sd-card direct to the ATXMEGA pin's.

 

Everything is written in Assembler to ensure a fast and compact code.

The intention in developing the DOS – file system was to keep close to the equivalent VB functions.

 

[[File:Notice.jpg]] Note that it is not permitted to use the AVR-DOS file system for commercial applications without the purchase of a license. A license comes with the ASM source. You can buy a user license that is suited for most private users.

When you develop a commercial product with AVR-DOS you need the company license. The ASM source is shipped with both licenses.

 

[[File:Notice.jpg|notice]]Josef nor MCS Electronics can be held responsible for any damage or data loss of your memory cards or disk drives.

 

 

= Important Steps to configure AVR-DOS =

 

1. Driver interface Library (select one of the following):

For compactFlash:

$include "Config_CompactFlash_ElektorIF_M128.bas" $include "Config_CompactFlash_M128.bas"

 

For Hard Drives:

$include "Config_HardDisk.bas"

 

For SD-Cards:

$include "Config_MMC.bas"

 

For SD-cards and SDHC cards (works also with ATXMEGA !): $include "config_MMCSD_HC.inc"

 

2. After calling the Driver interface library you need check the Error Byte which is Gbdriveerror and which is output of the function [[DriveInit|DRIVEINIT()]]. If the output is 0 (no error) you can include the AVR-DOS configuration file. Otherwise you should output the error number.

 

If Gbdriveerror = 0 Then

  $include "Config_AVR-DOS.inc"

End If

 

3. In case of Gbdriveerror = 0 (No Error) you can Initialize the file system with [[INITFILESYSTEM]](1) where 1 is the partition number. For the Error Output var you need to dim a byte variable like Dim Btemp1 As Byte wbefore you call the Initfilesystem.

 

Btemp1 = Initfilesystem(1)

 

With Btemp1 =  0 (no error) the Filesystem is successfully initialized and you can use all other AVR-DOS functions like open, close, read and write.

Functions like [[PUT]], [[GET]], [[SEEK]]-Set only work when the file is opened in binary mode for example: Open "test.bin"For Binary As #2

 

 

When you want change (ejecting  from the card socket) the SD-card (during the AVR is running other code than AVR-DOS) you need to call [[DriveInit|DRIVEINIT()]] and [[INITFILESYSTEM]](1) again in order to reset the AVR-Hardware (PORTs, PINs) attached to the Drive,reset the Drive again and initialize the file system again.

 

= Requirements =
<div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Software: appr. 2K-Word Code-Space (4000 Bytes in flash)
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SRAM: 561 Bytes for File system Info and DIR-Handle buffer
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| 517 Bytes if FAT is handled in own buffer (for higher speed), otherwise it is handled with the DIR Buffer
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| 534 Bytes for each File handle
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| This means that a  ATMEGA644, ATMEGA128 or ATXMEGA have enough memory for it.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Even an ATMEGA32 could work but you really need to know what you do and you need to fully understand the settings in Config_AVR-DOS.BAS to reduce the amount of SRAM used by AVR-DOS (which will also affect AVR-DOS performance)
|}
</div>
 

 For example by setting Const Cfilehandles = 1 and handling of FAT- and DIR-Buffer in one SRAM buffer with 561 bytes). You will not have much SRAM left anyway for other tasks in the ATMEGA32 and you can not expect maximum performance. [[$HWSTACK]], [[$SWSTACK]] and [[$FRAMESIZE]] also needs to be set carefully.

 

' Count of file-handles, each file-handle needs 524 Bytes of SRAM Const Cfilehandles = 1                                     ' [default = 2]   ' Handling of FAT-Buffer in SRAM: ' 0 = FAT- and DIR-Buffer is handled in one SRAM buffer with 561 bytes ' 1 = FAT- and DIR-Buffer is handled in separate SRAM buffers with 1078 bytes ' Parameter 1 increased speed of file-handling Const Csepfathandle = 0                                     ' [default = 1]

 

 

In the Main.bas you also need a Filename like Dim File_name As String * 12  

 

With the above configuration and with the filename there is approximately 500 byte SRAM left in an ATMEGA32 for other tasks. Or in other words AVR-DOS needs at least 1500 Byte SRAM in this case. To get detailed values compile your AVR-DOS application and open the Bascom-AVR compiler Report (CTRL+W) then you see the value with Space left : 508 Bytes (then you have 508 Bytes left for other tasks).

 

 

Then you can log data with for example:

 

Wait 4

 

Open File_name For Append As #100   Print #100 , "This is what I log to SD-Card !" Close #100

 

When you change now Const Csepfathandle = 1 then you will get an OUT OF SRAM  space message from the compiler with an ATMEGA32 which indicates that this will not work with an ATMEGA32.

 
<div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Other chips have too little internal memory. You could use XRAM memory too to extend the RAM.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SPI Interface for SD and SDHC cards (can be used in hardware and software SPI mode where hardware SPI mode is faster)
|}
</div>
 

 

 

 

TTo get started there are Examples in the ...BASCOM-AVR\SAMPLES\avrdos folder.

 

= Steps to get started with an ATMEGA (and with MMC.lib) =

The MMC.lib is for SD-Cards (Standard SD-Cards usually up to 2Gbyte and not for SDHC cards)

 
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 1.
| Open Test_DOS_Drive.bas
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 2.
| Add $HWSTACK, $SWSTACK and $FRAMESIZE
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 3.
| Add the hardware driver you want to use (for example for SD-Card this is $include "Config_MMC.bas")
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 4.
| Open the Config_MMC.bas file and configure the SPI interface (hardware or software SPI and which Pin's for example for SPI chip select should be used. Config_MMC.bas will call the MMC.lib library which is located in the ...BASCOM-AVR\LIB folder.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 5.
| Then you will find in Test_DOS_Drive.bas the Include AVR-DOS Configuration and library ($include "Config_AVR-DOS.BAS"). Config_AVR-DOS.BAS can be also found in ...BASCOM-AVR\SAMPLES\avrdos folder.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 6.
| In Config_AVR-DOS.BAS you can change the AVR-DOS user settings like the number of file handles or if AT- and DIR-Buffer is handled in one SRAM buffer or in different SRAM buffer. With this settings you can balance between SRAM space used and speed/performance of AVR-DOS.
|}
</div>
 

File System Configuration in CONFIG_AVR-DOS.BAS

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="609" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 166px; border: 1px solid rgb(0, 0, 0);" |
cFileHandles:

| valign="top" width="100%" style="width: 434px; border: 1px solid rgb(0, 0, 0);" |
Count of File handles: for each file opened at same time, a file handle buffer of 534 Bytes is needed

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 166px; border: 1px solid rgb(0, 0, 0);" |
cSepFATHandle:

| valign="top" width="100%" style="width: 434px; border: 1px solid rgb(0, 0, 0);" |
For higher speed in handling file operations the FAT info can be stored in a own buffer, which needs additional 517 Bytes.

 

Assign Constant cSepFATHandle with 1, if wanted, otherwise with 0.

|}
</div>
 
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 7.
| Config_AVR-DOS.BAS will call AVR-DOS.Lbx library which is located in the ...BASCOM-AVR\LIB folder.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 8.
| Compile, flash and run Test_DOS_Drive.bas
|}
</div>
 

 

Files used in the Test_DOS_Drive.bas example:

 

'  +-------------------------------------------------+ '  |                Test_DOS_Drive.bas               |      Main '  +-------------------------------------------------+ '            |                          | '  +--------------------+     +----------------------+ '  |   config_MMC.bas   |     | Config_AVR-DOS.bas   |      Include Files '  +--------------------+     +----------------------+ '            |                          | '  +--------------------+     +----------------------+ '  |       MMC.lib      |     |     AVR-DOS.Lbx      |      Libraries '  +--------------------+     +----------------------+

 

= Getting started with an ATMEGA and ATXMEGA with MMCSD_HC.LIB =

 

The mmcsd_hc.lib can be found in the ...BASCOM-AVR\LIB folder.

 

This library support:
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SD-Cards (also known as SDSC Cards = Secure Digital Standard-Capacity usually up to 2 GByte (also microSD)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SDHC cards (Secure Digital High Capacity) cards start at 2Gbyte up to 32GByte. You can also use micro SDHC cards.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| It works with ATMEGA and ATXMEGA chips.
|}
</div>
 

See ATXMEGA example program below.

 

 

= Memory Usage of DOS – File System =

 

1. General File System information (need 35 Byte in SRAM)

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="623" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="25%" bgcolor="#ffff99" style="width: 164px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Variable Name

| valign="top" width="10%" bgcolor="#ffff99" style="width: 62px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Type

| valign="top" width="59%" bgcolor="#ffff99" style="width: 385px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Usage

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gbDOSError

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
holds DOS Error of last file handling routine

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; height: 32px; border: 1px solid rgb(0, 0, 0);" |
gbFileSystem

| valign="top" width="10%" style="width: 62px; height: 32px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="59%" style="width: 385px; height: 32px; border: 1px solid rgb(0, 0, 0);" |
File System Code from Master Boot Record

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
glFATFirstSector

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Number of first Sector of FAT Area on the Card

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gbNumberOfFATs

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Count of FAT copies

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gwSectorsPerFat

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Count of Sectors per FAT

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
glRootFirstSector

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Number of first Sector of Root Area on the Card

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gwRootEntries

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Count of Root Entries

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
glDataFirstSector

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Number of first Sector of Data Area on the Card

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gbSectorsPerCluster

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Count of Sectors per Cluster

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gwMaxClusterNumber

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Highest usable Cluster number

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gwLastSearchedCluster

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Last cluster number found as free

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gwFreeDirEntry

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
Last directory entry number found as free

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
glFS_Temp1

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
temporary Long variable for file system

|- style="vertical-align: top;"
| valign="top" width="25%" style="width: 164px; border: 1px solid rgb(0, 0, 0);" |
gsTempFileName

| valign="top" width="10%" style="width: 62px; border: 1px solid rgb(0, 0, 0);" |
String * 11

| valign="top" width="59%" style="width: 385px; border: 1px solid rgb(0, 0, 0);" |
temporary String for converting file names

|}
</div>
 

 

 

2. Directory (need 559 Byte in SRAM)

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="623" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="27%" bgcolor="#ffff99" style="width: 165px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Variable Name

| valign="top" width="17%" bgcolor="#ffff99" style="width: 102px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Type

| valign="top" width="68%" bgcolor="#ffff99" style="width: 344px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Usage

|- style="vertical-align: top;"
| valign="top" width="27%" style="width: 165px; border: 1px solid rgb(0, 0, 0);" |
gwDirRootEntry

| valign="top" width="17%" style="width: 102px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="68%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
number of last handled root entry

|- style="vertical-align: top;"
| valign="top" width="27%" style="width: 165px; border: 1px solid rgb(0, 0, 0);" |
glDirSectorNumber

| valign="top" width="17%" style="width: 102px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="68%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
Number of current loaded Sector

|- style="vertical-align: top;"
| valign="top" width="27%" style="width: 165px; border: 1px solid rgb(0, 0, 0);" |
gbDirBufferStatus

| valign="top" width="17%" style="width: 102px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="68%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
Buffer Status

|- style="vertical-align: top;"
| valign="top" width="27%" style="width: 165px; border: 1px solid rgb(0, 0, 0);" |
gbDirBuffer

| valign="top" width="17%" style="width: 102px; border: 1px solid rgb(0, 0, 0);" |
Byte (512)

| valign="top" width="68%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
Buffer for directory Sector

|}
</div>
 

 

 

3. FAT (need 517 Byte in SRAM)

FAT Buffer is only allocated if the constant: cSepFATHandle = 1

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="623" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="26%" bgcolor="#ffff99" style="width: 159px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Variable Name

| valign="top" width="18%" bgcolor="#ffff99" style="width: 108px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Type

| valign="top" width="59%" bgcolor="#ffff99" style="width: 344px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Usage

|- style="vertical-align: top;"
| valign="top" width="26%" style="width: 159px; border: 1px solid rgb(0, 0, 0);" |
glFATSectorNumber

| valign="top" width="18%" style="width: 108px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="59%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
Number of current loaded FAT sector

|- style="vertical-align: top;"
| valign="top" width="26%" style="width: 159px; border: 1px solid rgb(0, 0, 0);" |
gbFATBufferStatus

| valign="top" width="18%" style="width: 108px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="59%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
Buffer status

|- style="vertical-align: top;"
| valign="top" width="26%" style="width: 159px; border: 1px solid rgb(0, 0, 0);" |
gbFATBuffer

| valign="top" width="18%" style="width: 108px; border: 1px solid rgb(0, 0, 0);" |
Byte(512)

| valign="top" width="59%" style="width: 344px; border: 1px solid rgb(0, 0, 0);" |
buffer for FAT sector

|}
</div>
 

 

 

4. File handling

 

Each file handle has a block of 534 Bytes in the variable abFileHandle which is a byte-array of size (534 * cFileHandles)

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="623" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="28%" bgcolor="#ffff99" style="width: 172px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Variable Name

| valign="top" width="15%" bgcolor="#ffff99" style="width: 91px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Type

| valign="top" width="56%" bgcolor="#ffff99" style="width: 348px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Usage

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileNumber

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
File number for identification of the file in I/O operations to the opened file

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileMode

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
File open mode

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileRootEntry

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
Number of root entry

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileFirstCluster

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
First cluster

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FATCluster

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Word

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
cluster of current loaded sector

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileSize

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
file size in bytes

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FilePosition

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
file pointer (next read/write) 0-based

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileSectorNumber

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Long

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
number of current loaded sector

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileBufferStatus

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
buffer Status

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
FileBuffer

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Byte(512)

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
buffer for the file sector

|- style="vertical-align: top;"
| valign="top" width="28%" style="width: 172px; border: 1px solid rgb(0, 0, 0);" |
SectorTerminator

| valign="top" width="15%" style="width: 91px; border: 1px solid rgb(0, 0, 0);" |
Byte

| valign="top" width="56%" style="width: 348px; border: 1px solid rgb(0, 0, 0);" |
additional 00 Byte (string terminator) for direct reading ASCII files from the buffer

|}
</div>
 

 

 

= Error Codes =

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="90%" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="17%" bgcolor="#ffff99" style="width: 88px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Code

| valign="top" width="60%" bgcolor="#ffff99" style="width: 452px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Compiler – Alias

| valign="top" width="100%" bgcolor="#ffff99" style="width: 71px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Remark

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
0

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoError

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No Error

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
1

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpEndOfFile

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Attempt behind End of File

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
17

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoMBR

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Sector 0 on Card is not a Master Boot Record

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
18

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoPBR

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No Partition Sector

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
19

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileSystemNotSupported

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Only FAT16 File system is supported

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
20

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpSectorSizeNotSupported

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Only sector size of 512 Bytes is supported

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
21

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpSectorsPerClusterNotSupported

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Only 1, 2, 4, 8, 16, 32, 64 Sectors per Cluster is supported. This are values of normal formatted partitions. Exotic sizes, which are not power of 2 are not supported

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
33

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoNextCluster

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Error in file cluster chain

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
34

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoFreeCluster

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No free cluster to allocate (Disk full)

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
35

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpClusterError

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Error in file cluster chain

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
49

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoFreeDirEntry

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Directory full

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
50

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileExist

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
 

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
65

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpNoFreeFileNumber

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No free file number available, only theoretical error, if 255 file handles in use

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
66

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileNotFound

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
File not found

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
67

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileNumberNotFound

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No file handle with such file number

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
68

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileOpenNoHandle

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
All file handles occupied

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
69

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileOpenHandleInUse

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
File handle number in use, can't create a new file handle with same file number

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
70

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileOpenShareConflict

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Tried to open a file in read and write modus in two file handles

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
71

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileInUse

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Can't delete file, which is in use

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
72

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileReadOnly

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Can't open a read only file for writing

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
73

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileNoWildCardAllowed

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
No wildcard allowed in this function

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
97

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFilePositionError

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
 

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
98

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileAccessError

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
function not allowed in this file open mode

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
99

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpInvalidFilePosition

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
new file position pointer is invalid (minus or 0)

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 88px; border: 1px solid rgb(0, 0, 0);" |
100

| valign="top" width="100%" style="width: 452px; border: 1px solid rgb(0, 0, 0);" |
cpFileSizeToGreat

| valign="top" width="100%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
File size to great for function BLoad

|}
</div>
 

 

 

= Buffer Status: Bit definitions of Buffer Status Byte (Directory, FAT and File) =

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="623" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="13%" bgcolor="#ffff99" style="width: 78px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Bit

| valign="top" width="9%" bgcolor="#ffff99" style="width: 53px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
DIR

| valign="top" width="9%" bgcolor="#ffff99" style="width: 53px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
FAT

| valign="top" width="14%" bgcolor="#ffff99" style="width: 84px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
File

| valign="top" width="23%" bgcolor="#ffff99" style="width: 140px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Compiler Alias

| valign="top" width="71%" bgcolor="#ffff99" style="width: 194px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Remark

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
0 (LSB)

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dBOF

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
Bottom of File (not yet supported)

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
1

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dEOF

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
End of File

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
2

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dEOFinSector

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
End of File in this sector (last sector)

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
3

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dWritePending

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
Something was written to sector, it must be saved to Card, before loading next sector

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
4

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dFATSector

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
This is an FAT Sector, at writing to Card, Number of FAT copies must be checked and copy updated if necessary

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 78px; border: 1px solid rgb(0, 0, 0);" |
5

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="14%" style="width: 84px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="23%" style="width: 140px; border: 1px solid rgb(0, 0, 0);" |
dFileEmpty

| valign="top" width="71%" style="width: 194px; border: 1px solid rgb(0, 0, 0);" |
File is empty, no sector (Cluster) is allocated in FAT to this file

|}
</div>
 

 

= Validity of the file I/O operations regarding the opening modes =

 
<div style="padding: 0px; margin: 0px;">
{| width="567" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 21px; border: 1px solid rgb(0, 0, 0);" |
 

| colspan="4" valign="top" width="100%" style="width: 200px; height: 21px; border: 1px solid rgb(0, 0, 0);" |
Open mode

|- style="vertical-align: top;"
| valign="top" width="100%" bgcolor="#ffff99" style="width: 358px; height: 4px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Action

| valign="top" width="100%" bgcolor="#ffff99" style="width: 39px; height: 4px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Input

| valign="top" width="100%" bgcolor="#ffff99" style="width: 50px; height: 4px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Output

| valign="top" width="100%" bgcolor="#ffff99" style="width: 55px; height: 4px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Append

| valign="top" width="100%" bgcolor="#ffff99" style="width: 47px; height: 4px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Binary

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Attr

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Close

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Put

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Get

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
LOF

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
LOC

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
EOF

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
1)

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
1)

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
SEEK

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
SEEK-Set

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Line Input

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Print

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Input

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|- style="vertical-align: top;"
| valign="top" width="100%" style="width: 358px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
Write

| valign="top" width="100%" style="width: 39px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="100%" style="width: 50px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 55px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

| valign="top" width="100%" style="width: 47px; height: 4px; border: 1px solid rgb(0, 0, 0);" |
[[File:Dot.gif]]

|}
</div>
 

 

1) Position pointer is always at End of File

 

Supported statements and functions:

 

[[INITFILESYSTEM]] , [[OPEN]] , [[CLOSE]], [[FLUSH]] , [[PRINT]], [[LINE INPUT]], [[LOC]], [[LOF]] , [[EOF]] , [[FREEFILE]] , [[FILEATTR]] , [[SEEK]] , [[BSAVE]] ,[[BLOAD]] , [[KILL]] , [[DISKFREE]] , [[DISKSIZE]] , [[GET]] , [[PUT]] ,[[FILEDATE]] , [[FILETIME]] , [[FILEDATETIME]] , [[DIR]] , [[WRITE]] , [[INPUT]] , [[FILELEN]]

 

= SD and SDHC specs and pin-out  =

(also microSD and microSD pin-out for SPI mode):

 

 

SD/SDHC Specs:

 
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SD and SDHC Cards offer a cost-effective and  way to store large amounts of data on a removable memory and is ideal for data logging applications.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SDHC has a different protocol than SD card with standard Capacity (therefore there was different libraries available at the beginning)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Standard SD-Cards have a byte addressing. SDHC-Cards have sector-addressing like hard-disks and CF-Cards. One Sector is a portion of 512Bytes. SD cards and SDHC cards also have differences in the protocol at initializing the card, which can be used to check, which kind of card is inserted.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SD Card operating range: 2.7V...3.6V. So you need a voltage level converter to connect a 5V micro to a SD-card.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| SD cards can be controlled by the six line SD card interface containing the signals: CMD,CLK,DAT0~DAT3 however this is not supported with AVR-DOS.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| AVR-DOS support the SPI interface which can be easily used with the hardware SPI interface of ATMEGA and ATXMEGA. (Software SPI is also supported).
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| The SPI mode is active if the CS signal is asserted (negative) during the reception of the reset command (CMD0) which will be automatically handled by AVR-DOS
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| The advantage of the SPI mode is reducing the host design in effort.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| With the Chip Select you can also connect several SPI slaves to one SPI interface
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Endurance: Usually SD or SDHC cards can handle  typical up to 100,000 writes for each sector. Reading a logical sector is unlimited. Please take care when writing to SD cards in a loop.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| A typical SD Card current consumption should be between 50mA .... 80mA but should not exceed 200mA
|}
</div>
 

 

 

[[File:Sd and microsd pinout.png|center|sd and microSD pinout]]

Picture: Backside of SD/SDHC card and microSD card

 

SD/SDHC card pin out:

 
<div style="padding: 0px; margin: 0px;">
{| cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing: 0px;"
|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | Pin #
| valign="top" width="228" style="width: 228px;" |
Description for SPI mode

| valign="top" width="230" style="width: 230px;" |
Connect to Pin on ATMEGA128

| valign="top" width="300" style="width: 300px;" |
Connect to Pin on ATXMEGA128A1

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 1
| valign="top" width="228" style="width: 228px;" |
Chip Select (SS) (Active low)

| valign="top" width="230" style="width: 230px;" |
SS (PortB 0) (Active low)

| valign="top" width="300" style="width: 300px;" |
SS (example for SPIC) PortC 4 (Active low)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 2
| valign="top" width="228" style="width: 228px;" |
DI (Data In)

| valign="top" width="230" style="width: 230px;" |
MOSI (PortB 2)

| valign="top" width="300" style="width: 300px;" |
MOSI (example for SPIC) PortC 5

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 3
| valign="top" width="228" style="width: 228px;" |
GND

| valign="top" width="230" style="width: 230px;" |
GND

| valign="top" width="300" style="width: 300px;" |
GND

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 4
| valign="top" width="228" style="width: 228px;" |
Vdd (Supply Voltage)

| valign="top" width="230" style="width: 230px;" |
Supply Voltage (2.7V...3.6V)

| valign="top" width="300" style="width: 300px;" |
Supply Voltage (2.7V...3.6V)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 5
| valign="top" width="228" style="width: 228px;" |
Clock

| valign="top" width="230" style="width: 230px;" |
SCK (PortB 1)

| valign="top" width="300" style="width: 300px;" |
SCK (example for SPIC) PortC 7

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 6
| valign="top" width="228" style="width: 228px;" |
GND

| valign="top" width="230" style="width: 230px;" |
GND

| valign="top" width="300" style="width: 300px;" |
GND

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 7
| valign="top" width="228" style="width: 228px;" |
D0 (Data Out)

| valign="top" width="230" style="width: 230px;" |
MISO (PortB 3)

| valign="top" width="300" style="width: 300px;" |
MISO (example for SPIC) PortC 6

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 8
| valign="top" width="228" style="width: 228px;" |
Reserved

| valign="top" width="230" style="width: 230px;" |
- - -

| valign="top" width="300" style="width: 300px;" |
- - -

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 9
| valign="top" width="228" style="width: 228px;" |
Reserved

| valign="top" width="230" style="width: 230px;" |
- - -

| valign="top" width="300" style="width: 300px;" |
- - -

|}
</div>
 

Depending on the used SD-card (or microSD) socket you can also detect if the card is inserted or ejected (for this you need an additional pin on the micro).

In some cases it is best practise to spend another pin able to switch on and off the power to the SD-card socket (e.g. over a transistor or FET). In this case you can cycle power from the AVR when the sd-card controller hangs.

It is also best practise in some cases when you open a file for append, write the data to it and close it right after this so there is no open file where data could be corrupted by an undefined external event.

 

 

microSD card pin out (same as microSDHC pin-out):

 
<div style="padding: 0px; margin: 0px;">
{| cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing: 0px;"
|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | Pin #
| valign="top" width="261" style="width: 261px;" |
microSD Description for SPI mode

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 1
| valign="top" width="261" style="width: 261px;" |
Reserved

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 2
| valign="top" width="261" style="width: 261px;" |
Chip Select (SS)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 3
| valign="top" width="261" style="width: 261px;" |
DI (Data In)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 4
| valign="top" width="261" style="width: 261px;" |
Vdd (Supply Voltage)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 5
| valign="top" width="261" style="width: 261px;" |
Clock

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 6
| valign="top" width="261" style="width: 261px;" |
GND

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 7
| valign="top" width="261" style="width: 261px;" |
DO (Data Out)

|- style="vertical-align: top;"
| valign="top" width="47" style="width: 47px;" | 8
| valign="top" width="261" style="width: 261px;" |
Reserved

|}
</div>
 

 

= Example 1 for getting started with an ATMEGA and ATXMEGA with MMCSD_HC.LIB =

<source lang="bascomavr">
'-------------------------------------------------------------------------------
' Filename: XMEGA_AVR-DOS_SDHC.BAS
' Library needed: MMCSD_HC.LIB --> Place MMCSD_HC.LIB in the LIB-Path of BASCOM-AVR installation
' MMCSD_HC.LIB will be called from config_MMCSD_HC.inc
' AVR-DOS.Lbx
' Include file: config_MMCSD_HC.inc (will be called from XMEGA_AVR-DOS_SDHC.BAS)
' Used ATXMEGA: ATXMEGA128A1
' Used SPI Port: Port D (you can also use Software SPI)
'-------------------------------------------------------------------------------
'
' File Structure:
'
' +-------------------------------------------------+
' | XMEGA_AVR-DOS_SDHC.BAS | Main
' +-------------------------------------------------+
' | |
' +--------------------+ +----------------------+
' | config_MMCSD_HC.inc| | Config_AVR-DOS.inc | Include Files
' +--------------------+ +----------------------+
' | |
' +--------------------+ +----------------------+
' | MMCSD_HC.LIB | | AVR-DOS.Lbx | Libraries
' +--------------------+ +----------------------+
'
'
' Terminal output of following example (with hardware SPI over Port.D):
'
' Used SD-Card: 4GByte SDHC Card
'
'
'(

---Example for using a SDHC-Card with AVR-DOS and XMEGA---
Starting... SDHC with ATXMEGA....

SD Card Type = SDHC Spec. 2.0 or later

Init File System ... OK --> Btemp1= 0 / Gbdriveerror = 0
Filesystem = 6
FAT Start Sector: 8196
Root Start Sector: 8688
Data First Sector: 8720
Max. Cluster Nummber: 62794
Sectors per Cluster: 128
Root Entries: 512
Sectors per FAT: 246
Number of FATs: 2

Write to file done !
File length = 46
This is my 1 first Text to File with XMEGA !
write to file
Total bytes written: 10200
Write and Readback test done !
Dir function demo
LOGGER.TXT 01\01\01 01:00:00 3120
MY_FILE.TXT 01\01\01 01:00:00 46
TEST.TXT 01\01\01 01:00:00 10200

Diskfree = 4018560
Disksize = 4018752

')

$regfile = "xm128a1def.dat"
$crystal = 32000000 '32MHz
$hwstack = 128
$swstack = 128
$framesize = 128

Config Osc = Disabled , 32mhzosc = Enabled '32MHz
Config Sysclock = 32mhz '32Mhz
Config Priority = Static , Vector = Application , Lo = Enabled 'config interrupts
Enable Interrupts

'=====[ Serial Interface to PC = COM5 ]========================================
Config Com5 = 57600 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
Open "COM5:" For Binary As #2
Waitms 1

Print #2 ,
Print #2 , "---Example for using a SDHC-Card with AVR-DOS and XMEGA---"

'=====[ Global Vars ]==========================================================
Dim Btemp1 As Byte ' Needed for Fat Drivers
Dim Input_string As String * 100
Dim Output_string As String * 100
Dim File_handle As Byte
Dim File_name As String * 14
Dim X As Long

Print #2 , "Starting... SDHC with ATXMEGA...."
Print #2 ,

'------------------------------------------------------------------------------

'=====[ Includes ]============================================================

$include "config_MMCSD_HC.inc"

Print #2 , "SD Card Type = " ;
Select Case Mmcsd_cardtype
Case 0 : Print #2 , "can't init the Card"
Case 1 : Print #2 , "MMC"
Case 2 : Print #2 , "SDSC Spec. 1.x "
Case 4 : Print #2 , "SDSC Spec. 2.0 or later"
Case 12 : Print #2 , "SDHC Spec. 2.0 or later"
End Select

Print #2 ,

If Gbdriveerror = 0 Then 'from.... Gbdriveerror = Driveinit()
$include "Config_AVR-DOS.inc" ' Include AVR-DOS Configuration and library

Print #2 , "Init File System ... " ;
Btemp1 = Initfilesystem(1) ' Reads the Master boot record and the partition boot record (Sector) from the flash card and initializes the file system
'1 = Partitionnumber
If Btemp1 <> 0 Then
Print #2 , "Error: " ; Btemp1 ; " at Init file system"
Else
Print #2 , " OK --> Btemp1= " ; Btemp1 ; " / Gbdriveerror = " ; Gbdriveerror
Print #2 , "Filesystem = " ; Gbfilesystem
Print #2 , "FAT Start Sector: " ; Glfatfirstsector
Print #2 , "Root Start Sector: " ; Glrootfirstsector
Print #2 , "Data First Sector: " ; Gldatafirstsector
Print #2 , "Max. Cluster Nummber: " ; Glmaxclusternumber
Print #2 , "Sectors per Cluster: " ; Gbsectorspercluster
Print #2 , "Root Entries: " ; Gwrootentries
Print #2 , "Sectors per FAT: " ; Glsectorsperfat
Print #2 , "Number of FATs: " ; Gbnumberoffats
End If

Print #2 ,
Print #2 ,

'-------------------------------------------------------------------------
' Write Text to file
File_handle = Freefile() ' get a file handle
File_name = "My_file.txt"
Open File_name For Output As #file_handle ' open file for output with file_handle
' If the file exist already, the file will be overwritten !
Print #file_handle , "This is my 1 first Text to File with XMEGA !"
Close #file_handle

Print #2 , "Write to file done !"

'-------------------------------------------------------------------------
'Now we want to read back the text we wrote to file and print it over Serial Interface
File_handle = Freefile()
Open "My_file.txt" For Input As #file_handle ' we can use a constant for the file too
Print #2 , "File length = " ; Lof(#file_handle)
Line Input #file_handle , Input_string ' read a line
Print #2 , Input_string 'print the line
Close #file_handle

'WRITE TO FILE
Print #2 , "write to file"
File_name = "Test.txt"
Input_string = "1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890"

Open File_name For Output As #10

While X < 10000 '10000 * 102 Byte / 100 = 10200 Byte
Print #10 , Input_string
X = X + 100
Wend

Close #10

X = Filelen(file_name)
Print #2 , "Total bytes written: " ; X

'READ FROM FILE

Open File_name For Input As #10
While Eof(#10) = 0
Line Input #10 , Output_string ' read a line
If Input_string <> Output_string Then
Print #2 , "Buffer Error! near byte: " ; X ; " " ; "[" ; Output_string ; "]"
Waitms 2000
End If
Wend
Close #10

Print #2 , "Write and Readback test done !"

'-------------------------------------------------------------------------
'Print the file name which was created before
Print #2 , "Dir function demo"
Input_string = Dir( "*.*")
'The first call to the DIR() function must contain a file mask The * means everything.
' Print File Names
While Len(input_string) > 0 ' if there was a file found
Print #2 , Input_string ; " " ; Filedate() ; " " ; Filetime() ; " " ; Filelen()
' print file , the date the fime was created/changed , the time and the size of the file
Input_string = Dir() ' get next
Wend

'-------------------------------------------------------------------------

Print #2 ,
Print #2 , "Diskfree = " ; Diskfree()
Print #2 , "Disksize = " ; Disksize()

End If 'If Gbdriveerror = 0 Then

End 'end program

</source>

= Example 1: Following the Config_MMCSD_HC.INC which is included in the main example program =

<source lang="bascomavr">
$nocompile

'-------------------------------------------------------------------------------
' Config_MMCSD_HC.INC
' Config File for MMC/SD/SDHC Flash Cards Driver
' (c) 2003-2009 , MCS Electronics / Vögel Franz Josef
'-------------------------------------------------------------------------------
' Place MMCSD_HC.LIB in the LIB-Path of BASCOM-AVR installation
'
' you can vary MMC_CS on HW-SPI and all pins on SOFT-SPI, check settings
'
' ========== Start of user definable range =====================================
'
' Declare here you SPI-Mode
' using HW-SPI: cMMC_Soft = 0
Const Hardware_spi = 0
' not using HW_SPI: cMMC_Soft = 1
Const Software_spi = 1

Const Cmmc_soft = Hardware_spi

#if Cmmc_soft = 0

' --------- Start of Section for HW-SPI ----------------------------------------

'Port D of ATXMEGA is used in this example as SPI Interface to SD-Card

Portd_pin6ctrl = &B00_011_000 'Enable Pullup for MISO Pin

' Define here Slave Slect (SS) Pin of Hardware SPI
Config Pind.4 = Output ' define here Pin for CS of MMC/SD Card
Mmc_cs Alias Portd.4
Set Mmc_cs

' Define here Slave Slect (SS) Pin of Hardware SPI
Config Pind.4 = Output ' define here Pin of SPI SS
Spi_ss Alias Portd.4
Set Spi_ss ' Set SPI-SS to Output and High por Proper work of

'FOR XMEGA DEVICES
#if _xmega = 1
'SPI Configuration for XMEGA
'Used Library = $LIB "MMCSD_HC.LIB"

'Portd.4 SS --> SD-Card Slave Select
'Portd.5 MOSI --> SD-Card MISO
'Portd.6 MISO --> SD-Card MOSI
'Portd.7 CLK --> SD-Card Clock

Config Spid = Hard , Master = Yes , Mode = 0 , Clockdiv = Clk2 , Data_order = Msb
Open "SPID" For Binary As #14
Const _mmc_spi = Spid_ctrl
#else

' HW-SPI is configured to highest Speed
Config Spi = Hard , Interrupt = Off , Data Order = Msb , Master = Yes , Polarity = High , Phase = 1 , Clockrate = 4 , Noss = 1
' Spsr = 1 ' Double speed on ATMega128
Spiinit
#endif

' --------- End of Section for HW-SPI ------------------------------------------

#else ' Config here SPI pins, if not using HW SPI

' --------- Start of Section for Soft-SPI --------------------------------------

' Chip Select Pin => Pin 1 of MMC/SD
Config Pind.4 = Output
Mmc_cs Alias Portd.4
Set Mmc_cs

' MOSI - Pin => Pin 2 of MMC/SD
Config Pind.5 = Output
Set Pind.5
Mmc_portmosi Alias Portd
Bmmc_mosi Alias 5

' MISO - Pin => Pin 7 of MMC/SD
Config Pind.6 = Input
Mmc_portmiso Alias Pind
Bmmc_miso Alias 6

' SCK - Pin => Pin 1 of MMC/SD
Config Pind.7 = Output
Set Pind.7
Mmc_portsck Alias Portd
Bmmc_sck Alias 7

' --------- End of Section for Soft-SPI ----------------------------------------

#endif

' ========== End of user definable range =======================================

'==== Variables For Application ================================================
Dim Mmcsd_cardtype As Byte ' Information about the type of the Card
' 0 can't init the Card
' 1 MMC
' 2 SDSC Spec. 1.x
' 4 SDSC Spec. 2.0 or later
' 12 SDHC Spec. 2.0 or later

Dim Gbdriveerror As Byte ' General Driver Error register
' Values see Error-Codes
'===============================================================================

' ==== Variables for Debug =====================================================
' You can remove remarks(') if you want check this variables in your application
Dim Gbdrivestatusreg As Byte ' Driver save here Card response
' Dim gbDriveErrorReg as Byte at GbdriveStatusReg overlay '
' Dim gbDriveLastCommand as Byte ' Driver save here Last Command to Card
Dim Gbdrivedebug As Byte
' Dim MMCSD_Try As Byte ' how often driver tried to initialized the card
'===============================================================================

'==== Driver internal variables ================================================
' You can remove remarks(') if you want check this variables in your application
' Dim _mmcsd_timer1 As Word
' Dim _mmcsd_timer2 As Word
'===============================================================================

' Error-Codes
Const Cperrdrivenotpresent = &HE0
Const Cperrdrivenotsupported = &HE1
Const Cperrdrivenotinitialized = &HE2

Const Cperrdrivecmdnotaccepted = &HE6
Const Cperrdrivenodata = &HE7

Const Cperrdriveinit1 = &HE9
Const Cperrdriveinit2 = &HEA
Const Cperrdriveinit3 = &HEB
Const Cperrdriveinit4 = &HEC
Const Cperrdriveinit5 = &HED
Const Cperrdriveinit6 = &HEE

Const Cperrdriveread1 = &HF1
Const Cperrdriveread2 = &HF2

Const Cperrdrivewrite1 = &HF5
Const Cperrdrivewrite2 = &HF6
Const Cperrdrivewrite3 = &HF7
Const Cperrdrivewrite4 = &HF8

$lib "MMCSD_HC.LIB"
$external _mmc
' Init the Card
Gbdriveerror = Driveinit()

' you can remark/remove following two Code-lines, if you dont't use MMCSD_GetSize()
$external Mmcsd_getsize
Declare Function Mmcsd_getsize() As Long

' you can remark/remove following two Code-lines, if you dont't use MMCSD_GetCSD()
' write result of function to an array of 16 Bytes
$external Mmcsd_getcsd
Declare Function Mmcsd_getcsd() As Byte

' you can remark/remove following two Code-lines, if you dont't use MMCSD_GetCID()
' write result of function to an array of 16 Bytes
$external Mmcsd_getcid
Declare Function Mmcsd_getcid() As Byte

' you can remark/remove following two Code-lines, if you dont't use MMCSD_GetOCR()
' write result of function to an array of 4 Bytes
$external Mmcsd_getocr
Declare Function Mmcsd_getocr() As Byte

' you can remark/remove following two Code-lines, if you dont't use MMCSD_GetSDStat
' write result of function to an array of 64 Bytes
$external Sd_getsd_status
Declare Function Sd_getsd_status() As Byte

' check the usage of the above functions in the sample MMCSD_Analysis.bas
' check also the MMC and SD Specification for the content of the registers CSD, CID, OCR and SDStat

</source>

= Example 1: Following the Config_AVR-DOS.inc which is included in the main example program =

<source lang="bascomavr">
$nocompile
' Config File-System for Version 5.5:

' === User Settings ============================================================

' Count of file-handles, each file-handle needs 524 Bytes of SRAM
Const Cfilehandles = 2 ' [default = 2]

' Handling of FAT-Buffer in SRAM:
' 0 = FAT- and DIR-Buffer is handled in one SRAM buffer with 561 bytes
' 1 = FAT- and DIR-Buffer is handled in separate SRAM buffers with 1078 bytes
' Parameter 1 increased speed of file-handling
Const Csepfathandle = 1 ' [default = 1]

' Handling of pending FAT and Directory information of open files
' 0 = FAT and Directory Information is updated every time a data sector of the file is updated
' 1 = FAT and Directory Information is only updated at FLUSH and SAVE command
' Parameter 1 increases writing speed of data significantly
Const Cfatdirsaveatend = 1 ' [default = 1]

' Surrounding String with Quotation Marks at the Command WRITE
' 0 = No Surrounding of strings with quotation.marks
' 1 = Surrounding of strings with quotation.marks (f.E. "Text")
Const Ctextquotationmarks = 1 ' [default = 1]

' Write second FAT. Windows accepts a not updated second FAT
' PC-Command: chkdsk /f corrects the second FAT, it overwrites the
' second FAT with the first FAT
' set this parameter to 0 for high speed continuing saving data
' 0 = Second FAT is not updated
' 1 = Second FAT is updated if exist
Const Cfatsecondupdate = 1 ' [default = 1]

' Character to separate ASCII Values in WRITE - statement (and INPUT)
' Normally a comma (,) is used. but it can be changed to other values, f.E.
' to TAB (ASCII-Code 9) if EXCEL Files with Tab separated values should be
' written or read. This parameter works for WRITE and INPUT
' Parameter value is the ASSCII-Code of the separator
' 44 = comma [default]
' 9 = TAB ' [default = 44]
Const Cvariableseparator = 44

' === End of User Setting ======================================================

' === Variables for AVR-DOS ====================================================

' FileSystem Basis Informationen
Dim Gldrivesectors As Long
Dim Gbdoserror As Byte

' Master Boot Record
Dim Gbfilesystem As Byte
' Partition Boot Record
Dim Gbfilesystemstatus As Byte
Dim Glfatfirstsector As Long
Dim Gbnumberoffats As Byte
Dim Glsectorsperfat As Long
Dim Glrootfirstsector As Long
Dim Gwrootentries As Word
Dim Gldatafirstsector As Long
Dim Gbsectorspercluster As Byte
Dim Glmaxclusternumber As Long
Dim Gllastsearchedcluster As Long

' Additional info
Dim Glfs_temp1 As Long

' Block für Directory Handling

Dim Gldirfirstsectornumber As Long

Dim Gwfreedirentry As Word
Dim Glfreedirsectornumber As Long

Dim Gsdir0tempfilename As String * 11
Dim Gwdir0entry As Word ' Keep together with next, otherwise change _DIR
Dim Gldir0sectornumber As Long

Dim Gstempfilename As String * 11
Dim Gwdirentry As Word
Dim Gldirsectornumber As Long
Dim Gbdirbufferstatus As Byte
Dim Gbdirbuffer(512) As Byte
Const C_filesystemsramsize1 = 594
#if Csepfathandle = 1
Dim Glfatsectornumber As Long
Dim Gbfatbufferstatus As Byte
Dim Gbfatbuffer(512) As Byte
Const C_filesystemsramsize2 = 517
#else
Const C_filesystemsramsize2 = 0
#endif

' File Handle Block
Const Co_filenumber = 0
Const Co_filemode = 1
Const Co_filedirentry = 2 : Const Co_filedirentry_2 = 3
Const Co_filedirsectornumber = 4
Const Co_filefirstcluster = 8
Const Co_filesize = 12
Const Co_fileposition = 16
Const Co_filesectornumber = 20
Const Co_filebufferstatus = 24
Const Co_filebuffer = 25
Const C_filehandlesize = Co_filebuffer + 513 ' incl. one Additional Byte for 00 as string terminator
' for direct text reading from File-buffer
Const C_filehandlesize_m = 65536 - C_filehandlesize ' for use with add immediate word with subi, sbci
' = minus c_FileHandleSize in Word-Format

Const C_filehandlessize = C_filehandlesize * Cfilehandles

Dim Abfilehandles(c_filehandlessize) As Byte
Const C_filesystemsramsize = C_filesystemsramsize1 + C_filesystemsramsize2 + C_filehandlessize

' End of variables for AVR-DOS ================================================

' Definitions of Constants ====================================================

' Bit definiton for FileSystemStatus

Dfilesystemstatusfat Alias 0 : Const Dfilesystemstatusfat = 0 ' 0 = FAT16, 1 = FAT32
Dfilesystemsubdir Alias 1 : Const Dfilesystemsubdir = 1 ' 0 = Root-Directory, 1 = Sub-Directory
Const Dmfilesystemsubdir =(2 ^ Dfilesystemsubdir) ' not used yet
Const Dmfilesystemdirincluster =(2 ^ Dfilesystemstatusfat + 2 ^ Dfilesystemsubdir) ' not used yet
Dfatsecondupdate Alias 7 : Const Dfatsecondupdate = 7 ' Bit-position for parameter of
' Update second FAT in gbFileSystemStatus

' Bit Definitions for BufferStatus (FAT, DIR, File)

Deof Alias 1 : Const Deof = 1 : Const Dmeof =(2 ^ Deof)
Deofinsector Alias 2 : Const Deofinsector = 2 : Const Dmeofinsector =(2 ^ Deofinsector)
Dwritepending Alias 3 : Const Dwritepending = 3 : Const Dmwritepending =(2 ^ Dwritepending)
Dfatsector Alias 4 : Const Dfatsector = 4 : Const Dmfatsector =(2 ^ Dfatsector) ' For Writing Sector back (FATNumber times)
Dfileempty Alias 5 : Const Dfileempty = 5 : Const Dmfileempty =(2 ^ Dfileempty)

' New feature for reduce saving
Dfatdirwritepending Alias 6 : Const Dfatdirwritepending = 6 : Const Dmfatdirwritepending =(2 ^ Dfatdirwritepending)
Dfatdirsaveatend Alias 7 : Const Dfatdirsaveatend = 7 : Const Dmfatdirsaveatend =(2 ^ Dfatdirsaveatend)
Dfatdirsaveanyway Alias 0 : Const Dfatdirsaveanyway = 0 : Const Dmfatdirsaveanyway =(2 ^ Dfatdirsaveanyway)

Const Dmeofall =(2 ^ Deof + 2 ^ Deofinsector)
Const Dmeof_empty =(2 ^ Deof + 2 ^ Deofinsector + 2 ^ Dfileempty)

Const Cp_fatbufferinitstatus =(2 ^ Dfatsector)
Const Cp_dirbufferinitstatus = 0

#if Cfatdirsaveatend = 1
Const Cp_filebufferinitstatus =(2 ^ Dfatdirsaveatend)
#else
Const Cp_filebufferinitstatus = 0
#endif

#if Cfatsecondupdate = 0
Const Cp_fatsecondupdate =(2 ^ Dfatsecondupdate)
#else
Const Cp_fatsecondupdate = 0
#endif

' Bit definitions for FileMode (Similar to DOS File Attribut)
Dreadonly Alias 0 : Const Dreadonly = 0
'Const cpFileReadOnly = &H21 ' Archiv and read-only Bit set
Const Cpfilewrite = &H20 ' Archiv Bit set

' Error Codes

' Group Number is upper nibble of Error-Code
' Group 0 (0-15): No Error or File End Information
Const Cpnoerror = 0
Const Cpendoffile = 1

' Group 1 (17-31): File System Init
Const Cpnombr = 17
Const Cpnopbr = 18
Const Cpfilesystemnotsupported = 19
Const Cpsectorsizenotsupported = 20
Const Cpsectorsperclusternotsupported = 21
Const Cpcountofclustersnotsupported = 22

' Group 2 (32-47): FAT - Error
Const Cpnonextcluster = 33
Const Cpnofreecluster = 34
Const Cpclustererror = 35
' Group 3 (49-63): Directory Error
Const Cpnofreedirentry = 49
Const Cpfileexists = 50
Const Cpfiledeletenotallowed = 51
Const Cpsubdirectorynotempty = 52
Const Cpsubdirectoryerror = 53
Const Cpnotasubdirectory = 54
' Group 4 (65-79): File Handle
Const Cpnofreefilenumber = 65
Const Cpfilenotfound = 66
Const Cpfilenumbernotfound = 67
Const Cpfileopennohandle = 68
Const Cpfileopenhandleinuse = 69
Const Cpfileopenshareconflict = 70
Const Cpfileinuse = 71
Const Cpfilereadonly = 72
Const Cpfilenowildcardallowed = 73
Const Cpfilenumberinvalid = 74 ' Zero is not allowed

' Group 7 (97-127): other errors
Const Cpfilepositionerror = 97
Const Cpfileaccesserror = 98
Const Cpinvalidfileposition = 99
Const Cpfilesizetogreat = 100

Const Cpdrivererrorstart = &HC0

' Range 224 to 255 is reserved for Driver

' Other Constants
' File Open Mode / stored in File-handle return-value of Fileattr(FN#, [1])
Const Cpfileopeninput = 1 ' Read
Const Cpfileopenoutput = 2 ' Write sequential
'Const cpFileOpenRandom = 4 ' not in use yet
Const Cpfileopenappend = 8 ' Write sequential; first set Pointer to end
Const Cpfileopenbinary = 32 ' Read and Write; Pointer can be changed by user

' permission Masks for file access routine regarding to the file open mode
Const Cfilewrite_mode = &B00101010 ' Binary, Append, Output
Const Cfileread_mode = &B00100001 ' Binary, Input
Const Cfileseekset_mode = &B00100000 ' Binary
Const Cfileinputline = &B00100001 ' Binary, Input
Const Cfileput_mode = &B00100000 ' Binary
Const Cfileget_mode = &B00100000 ' Binary

' Directory attributs in FAT16/32
Const Cpfileopenallowed = &B00100001 ' Read Only and Archiv may be set
Const Cpfiledeleteallowed = &B00100000
Const Cpfilesearchallowed = &B00111101 ' Do no search hidden Files
' Bit 0 = Read Only
' Bit 1 = Hidden
' Bit 2 = System
' Bit 3 = Volume ID
' Bit 4 = Directory
' Bit 5 = Archiv
' Long File name has Bit 0+1+2+3 set
Dim Lastdosmem As Byte

$lib "AVR-DOS.Lbx"

</source>

= Example 2: SD and SDHC Card Analysis Example Demo program =

= Show the Card Capacity and the Card-Register CSD, CID, OCR and SD_Status =

This example uses:        $include "Config_MMCSD_HC.bas"    which calls following Libary:   $lib "MMCSD_HC.LIB"

This example is written for ATMEGA but is also working for ATXMEGA devices.

  <source lang="bascomavr">
'-------------------------------------------------------------------------------
' MMCSD_Analysis.BAS
' Test MMC / SD Card
' (c) 2003-2012 , MCS Electronics / Vögel Franz Josef
'-------------------------------------------------------------------------------
' Test MMC / SD Card
' Show the Card Capacity and the Card-Register CSD, CID, OCR and SD_Status
' First you have to init the Card in the File Config_MMCSD_HC.bas with
' $Include "Config_MMCSD_HC.bas"
' All Card registers are written with the MSB first to the Byte-array
' f.E. CSD(1) contains then MSB (Bit 120-127) of the CSD-Register

$regfile = "M644pdef.dat"
$crystal = 16000000

$hwstack = 100
$swstack = 100
$framesize = 100

$baud = 57600

Config Serialin = Buffered , Size = 20
Config Clock = Soft

Enable Interrupts

Config Date = Dmy , Separator = .
Print "Test_Dos_Drive compiled at " ; Version()
$include "Config_MMCSD_HC.bas"

Dim Xc As Byte ' for Print - counter
Dim Xd As Byte ' for Print - Counter

Print "Start of Card Analysis"
Print "Last Drive-Error-Code = " ; Gbdriveerror
Print "Gbdrivestatusreg =" ; Gbdrivestatusreg

' Check detected Card Type
Select Case Mmcsd_cardtype
Case 1
Print "MMC-Card detected"
Case 2
Print "SD-Card Spec. 1.x detected"
Case 4
Print "SD-Card Spec. 2.0 detected"
Case 12
Print "SD-Card Spec. 2.0 High Capacity detected"
Case Else
Print "No Card detected"
End Select

If Mmcsd_cardtype > 0 Then

' check the CSD Register

Dim Csd(16) As Byte
Print "Get CSD"
Csd(1) = Mmcsd_getcsd()
If Gbdriveerror <> 0 Then
Print "Error at reading CSD"
Else
For Xc = 1 To 16
Print Hex(csd(xc)) ; " " ;
Next
Print " "
End If

' Get the Card Capacity from the CSD Register

Dim Mmcsd_size As Long
Print "Get Card Capacity [KB]"
Mmcsd_size = Mmcsd_getsize()
If Gbdriveerror <> 0 Then
Print "Error at reading CSD"
Else
Print "Card Capacity = ; " ; Mmcsd_size ; "kb (1KB=1024 Bytes)"
End If

' Get the CID Register

Dim Cid(16) As Byte
Print "Get CID"
Cid(1) = Mmcsd_getcid()
If Gbdriveerror <> 0 Then
Print "Error at reading CID"
Else
For Xc = 1 To 16
Print Hex(cid(xc)) ; " " ;
Next
Print " "
End If

' Get the OCR Register

Dim Ocr(4) As Byte
Print "Get OCR"
Ocr(1) = Mmcsd_getocr()
If Gbdriveerror <> 0 Then
Print "Error at reading OCR"
Else
For Xc = 1 To 4
Print Hex(ocr(xc)) ; " " ;
Next
Print " "
End If

If Mmcsd_cardtype > 1 Then

' Get the SD_Status Register on SD-Cards

Dim Sd_status(64) As Byte
Print "Get SD_Status"
Sd_status(1) = Sd_getsd_status()
If Gbdriveerror <> 0 Then
Print "Error at reading SD_Status"
Else
For Xc = 1 To 64
Print Hex(sd_status(xc)) ; " " ;
Xd = Xc Mod 8
If Xd = 0 Then
Print " "
End If
Next
End If
End If
End If

Print "End of Card Analysis"

End

</source>

 {{Languages}}

[[Category:AVR-DOS/de]]

AVR-DOS File System/de - Revision history

Admin: 1 revision

Admin at 10:40, 13 February 2013