DriveReadSector - Revision history

Admin: Created page with "= Action = Read a Sector (512 Bytes) from the (Compact Flashcard) Drive
2013-02-08T20:33:15Z

Created page with "= <span class="f_Header">Action</span> = Read a Sector (512 Bytes) from the (Compact Flashcard) Drive <span style="font-family: Arial;"> </span> <span style="font-fami..."

New page
= <span class="f_Header">Action</span> =

Read a Sector (512 Bytes) from the (Compact Flashcard) Drive

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

bErrorCode = <span class="f_Syntax">DRIVEREADSECTOR</span>(wSRAMPointer, lSectorNumber)

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =
<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="20%" style="width: 119px; border: 1px solid rgb(0, 0, 0);" |
bErrorCode

| valign="top" width="82%" style="width: 481px; border: 1px solid rgb(0, 0, 0);" |
A Byte Variable, which is assigned with the error code of the function

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

| valign="top" width="82%" style="width: 481px; border: 1px solid rgb(0, 0, 0);" |
A Word Variable, which contains the SRAM address (pointer) , to which the Sector from the Drive should be written

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

| valign="top" width="82%" style="width: 481px; border: 1px solid rgb(0, 0, 0);" |
A Long Variable, which give the sector number on the drive be transfer.

|}
</div>
<span style="font-family: Arial;"> </span>

Reads a Sector (512 Bytes) from the Drive and write it to SRAM starting at the address, to which the content of the variable wSRAMPointer is pointing. The functions returns 0 if no error occurred. For Error code see section Error codes.

<span style="font-family: Arial;"> </span>

Note: wSRAMPointer is not the variable, to which the content of the desired drive-sector should be written, it is the Word-Variable/Value which contains the SRAM address of the range, to which 512 Bytes should be written from the Drive. This gives you the flexibility to read and write every SRAM-Range to and from the drive, even it is not declared as variable. If you know the SRAM-Address (from the compiler report) of a buffer you can pass this value directly, otherwise you can get the address with the BASCOM-function VARPTR (see example).

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See also</span> =

[[DriveCheck]] , [[DriveReset]] , [[DriveInit]] , [[DriveGetIdentity]] , [[DriveWriteSector]]

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">ASM</span> =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="634" 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="29%" style="width: 181px; border: 1px solid rgb(0, 0, 0);" |
Calls

| valign="top" width="36%" style="width: 224px; border: 1px solid rgb(0, 0, 0);" |
_DriveReadSector

| valign="top" width="55%" style="width: 217px; border: 1px solid rgb(0, 0, 0);" |
<span style="font-family: Arial;"> </span>

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

| valign="top" width="36%" style="width: 224px; border: 1px solid rgb(0, 0, 0);" |
Z: SRAM-Address of buffer

*)

| valign="top" width="55%" style="width: 217px; border: 1px solid rgb(0, 0, 0);" |
X: Address of Long-variable with sectornumber

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

| valign="top" width="36%" style="width: 224px; border: 1px solid rgb(0, 0, 0);" |
r25: Errorcode

| valign="top" width="55%" style="width: 217px; border: 1px solid rgb(0, 0, 0);" |
C-Flag: Set on Error

|}
</div>
<span style="font-family: Arial;"> </span>

 

<span style="font-family: Arial;"> </span>

[[File:Notice.jpg|left|Notice.jpg]]This is not the address of wSRAMPointer, it is its content, which is the starting-address of the buffer.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Partial Example</span> =

<br/><source lang="bascomavr">
Dim bError as Byte
Dim aBuffer(512)as Byte' Hold Sector to and from CF-Card
Dim wSRAMPointer as Word' Address-Pointer for write
Dim lSectorNumber as Long' Sector Number

' give Address of first Byte of the 512 Byte Buffer to Word-Variable
wSRAMPointer =VarPtr(aBuffer(1))

' Set Sectornumber, sector 32 normally holds the Boot record sector of first partition
lSectorNumber = 32

' Now read in sector 32 from CF-Card
bError = DriveReadSector( wSRAMPointer , lSectorNumber)
' Now Sector number 32 is in Byte-Array bBuffer
</source><br/>{{Languages}}

[[Category:BASCOM Language Reference]]