Окружение AVR-DOS
Окружение AVR-DOS — конфигурация системы
AVR-DOS применительно к на данному микроконтроллеру.
Содержание
Конфигурация файловой системы
Задается файлом config_avr-dos.bas.
| Параметр | Значение |
|---|---|
| cFileHandles | Count of Filehandles: for each file opened at same
time, a filehandle buffer of 538 Bytes is needed |
| cSepFATHandle | For higher speed in handling file operations the FAT
info can be stored in an own buffer, which needs additional 517 Bytes. Assign Constant cSepFATHandle with 1, if wanted, otherwise with 0. |
| cFATDirSaveAtEnd | Handling of saving changed FAT and Directory
Information of a open file for output. Parameter 0 saves FAT and Directory information with every saving of a data sector Parameter 1 saves FAT and Directory Information only at the CLOSE and FLUSH statement. This option increases the writing speed of data and decreases the write frequency of FAT and Directory Sectors |
| cTextQuotationMarks | 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") |
| cFATSecondUpdate | Suppress updating of 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 [default] |
| cVariableSeparator | 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 |
Использование памяти файловой системой
General File System information (35 Bytes)
| Параметр | Тип | Использование |
|---|---|---|
| gbDOSError | Byte | holds DOS Error of last file handling routine |
| gbFileSystem | Byte | File System Code from Master Boot Record |
| gbFileSystemStatus | Byte | Holds Information about FAT Type (16 or 32) |
| glFATFirstSector | Long | Number of first Sector of FAT Area on the Card |
| gbNumberOfFATs | Byte | Count of FAT copies |
| glSectorsPerFat | Long | Count of Sectors per FAT |
| glRootFirstSector | Long | Number of first Sector of Root Area on the Card |
| gwRootEntries | Word | Count of Root Entries |
| glDataFirstSector | Long | Number of first Sector of Data Area on the Card |
| gbSectorsPerCluster | Byte | Count of Sectors per Cluster |
| glMaxClusterNumber | Long | Highest usable Cluster number |
| glLastSearchedCluster | Long | Last cluster number found as free |
| glFS_Temp1 | Long | temorary Long variable for file system |
Directory (559 Bytes)
| Параметр | Тип | Использование |
|---|---|---|
| glDirFirstSectorNumber | Long | Number of first sector of current actual directory |
| gwFreeDirEntry | Word | Number of first free Dir-Entry |
| glFreeDirSectorNumber | Long | Number of Sector number with first free Directory Entry |
| gsDir0TempFileName | String*11 | Temporary Buffer for file name |
| gwDir0Entry | Word | Temporary Buffer for Directory Entry Number |
| glDir0SectorNumber | Long | Temporary Buffer for Directory Sector Number |
| gsTempFileName | String*11 | Hold file name for directory search |
| gwDirRootEntry | Word | Number of last handled directory entry |
| glDirSectorNumber | Long | Number of current loaded Sector |
| gbDirBufferStatus | Byte | Sector Buffer Status |
| gbDirBuffer | Byte (512) | Buffer for directory Sector |
FAT (517 Bytes)
FAT Buffer is only allocated if the constant: cSepFATHandle = 1
| Параметр | Тип | Использование |
|---|---|---|
| glFATSectorNumber | Long | Number of current loaded FAT sector |
| gbFATBufferStatus | Byte | Buffer status |
| gbFATBuffer | Byte(512) | buffer for FAT sector |
File handling
Each file handle has a block of 538 Bytes in the variable abFileHandle which is a byte-array of size (538 * cFileHandles)
| Параметр | Тип | Использование |
|---|---|---|
| FileNumber | Byte | File number for identification of the file in I/O
operations to the opened file |
| FileMode | Byte | File open mode |
| FileDirEntry | Word | Number of directory entry |
| FileDirSectorNumber | Long | Number of Sector which holds the Directory entry of the file |
| FileFirstCluster | Word | First cluster |
| FileSize | Long | file size in bytes |
| FilePosition | Long | file pointer (next read/write) 0-based |
| FileSectorNumber | Long | number of current loaded sector |
| FileBufferStatus | Byte | buffer Status |
| FileBuffer | Byte(512) | buffer for the file sector |
| SectorTerminator | Byte | additional 00 Byte (string terminator) for direct reading ASCII files from the buffer |
Error codes
| Код | Имя в компиляторе | Объяснение |
|---|---|---|
| 0 | cpNoError | No Error |
| 1 | cpEndOfFile | Attempt behind End of File |
| 17 | cpNoMBR | Sector 0 on Card is not a Master Boot Record |
| 18 | cpNoPBR | No Partition Sector |
| 19 | cpFileSystemNotSupported | Only FAT16 File system is supported |
| 20 | cpSectorSizeNotSupported | Only sector size of 512 Bytes is supported |
| 21 | cpSectorsPerClusterNotSupported | which are not power of 2 are not supported |
| 22 | cpCountOfClustersNotSupported | Count of FAT (valid is 1 or 2) not supported (will be renamed with one of next release) |
| 33 | cpNoNextCluster | Error in file cluster chain |
| 34 | cpNoFreeCluster | No free cluster to allocate (Disk full) |
| 35 | cpClusterError | Error in file cluster chain |
| 49 | cpNoFreeDirEntry | Directory full |
| 50 | cpFileExist | |
| 51 | cpFileDeleteNotAllowed | Deleting of file not allowed (System, Hidden, Read-Only) |
| 52 | cpSubDirectoryNotEmpty | Removing of sub-directory not possible, because it is not empty |
| 53 | cpSubDirectoryError | General error at handling with sub-directory |
| 54 | cpNoASubDirectory | Passed name is a file name and not a directory name |
| 65 | cpNoFreeFileNumber | No free file number available, only theoretical error, if 255 file handles in use |
| 66 | cpFileNotFound | File not found |
| 67 | cpFileNumberNotFound | No file handle with such file number |
| 68 | cpFileOpenNoHandle | All file handles occupied |
| 69 | cpFileOpenHandleInUse | File handle number in use, can't create a new file handle with same file number |
| 70 | cpFileOpenShareConflict | Tried to open a file in read and write modus in two file handles |
| 71 | cpFileInUse | Can't delete file, which is in use |
| 72 | cpFileReadOnly | Can't open a read only file for writing |
| 73 | cpFileNoWildCardAllowed | No wildcard allowed in this function |
| 74 | CpFileNumberInvalid | File number 0 is not allowed |
| 97 | cpFilePositionError | |
| 98 | cpFileAccessError | function not allowed in this file open mode |
| 99 | cpInvalidFilePosition | new file position pointe is invalid (minus or 0) |
| 100 | cpFileSizeToGreat | File size to great for function BLoad |
Buffer Status: Bit definitions of Buffer Status Byte (Directory, FAT and File)
| Bit | DIR | FAT | File | Compiler Alias | Remark |
|---|---|---|---|---|---|
| 0 (LSB) | + | dFATDirSaveAnyWay | Status Bit which is set from CLOSE and FLUSh statement, to show AVR-DOS to save FAT and Directory Sectors | ||
| 1 | + | dEOF | End of File | ||
| 2 | + | dEOFinSector | End of File in this sector (= last sector loaded) | ||
| 3 | + | + | + | dWritePending | Something was written to sector, it must be saved to Card, before loading next sector |
| 4 | + | dFATSector | This is an FAT Sector, at writing to Card, Number of FAT copies must be checked and copy updated if necessary | ||
| 5 | + | dFileEmpty | File is empty, no sector (Cluster) is allocated in FAT to this file | ||
| 6 | + | dFATDIRWritePending | For this file FAT or directory was updated | ||
| 7 | + | dFATDirSaveAtEnd | Indicates, that FAT and Directory Information have only to be updated at FLUSH and CLOSE staements |
Validity of the file I/O operations regarding the opening modes
| Action | Input | Output | Append | Binary |
|---|---|---|---|---|
| Attr | + | + | + | + |
| Close | + | + | + | + |
| Put | + | |||
| Get | + | |||
| LOF | + | + | + | + |
| LOC | + | + | + | + |
| EOF | + | [1] | [1] | + |
| SEEK (Get Position) | + | +[1] | +[1] | + |
| SEEK (Set Position) | + | |||
| Line Input | + | + | ||
| + | + | + | ||
| Input | + | + | ||
| Write | + | + | + |
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 , FILELEN , WRITE , INPUT
