NOT FINALIZED!

The functions in this section exist to support new features of PicoDOS 2.0 and should be considered experimental. Even with the woefully inadequate documentation that currently exists, these may be useful to more complex applications. Be warned that unlike the finalized BIOS and PicoDOS functions, these functions are subject to much change, and you should not use them if you are not prepared to recode your projects as the functions mature.

Quick Reference Table

SSDCapacity	SSDDisplayATADriveID
SSDGetIODvr	SSDLookupID
SSDLookupName	SSDMediaCheck
SSDNamesList	SSDReadSectors
SSDRegisterDevice	SSDReset
SSDWriteSectors

#define SSD_MAX_DEVS    4
#define SSD_MAX_DEVNAME 12

typedef short   SSDRdf(void *iodvr, ulong sector, void *buffer, short count);
typedef short   SSDWrf(void *iodvr, ulong sector, void *buffer, short count);
typedef bool    SSDChkf(void *iodvr);
typedef short   SSDCapf(void *iodvr, ulong *sectors, ushort *spt,
                    ushort *heads, struct ATADriveID **info);

SSDReset -- Reset SSD tables and clear all registered devices

Description

   

      

         
Prototype:
      
      

         
void SSDReset(void);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDRegisterDevice -- Register a new Sector Storage Device

Description

   

      

         
Prototype:
      
      

         
ushort
         SSDRegisterDevice(char *name,
         void *iodvr, SSDRdf *rdf, SSDWrf *wrf, SSDCapf *capf,
         SSDChkf *chkf);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
name XXXXX

         iodvr XXXXX

         rdf XXXXX

         wrf XXXXX

         capf XXXXX

         chkf XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDReadSectors -- Read absolute (LBA) drive sector(s)

Description

   

      

         
Prototype:
      
      

         
short SSDReadSectors(ushort
         ssdid, ulong sector, void *buffer, short count);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX

         sector XXXXX

         buffer XXXXX

         count XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDWriteSectors -- Write absolute (LBA) drive sector(s)

Description

   

      

         
Prototype:
      
      

         
short
         SSDWriteSectors(ushort ssdid,
         ulong sector, void *buffer, short count);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX

         sector XXXXX

         buffer XXXXX

         count XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDCapacity -- Fetch the storage device capacity and geometry information

Description

   

      

         
Prototype:
      
      

         
short SSDCapacity(ushort
         ssdid, ulong *sectors, ushort *spt, ushort *heads,struct
         ATADriveID **info);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX

         sectors XXXXX

         spt XXXXX

         heads XXXXX

         info XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX

         see <dosdrive.h> for the ATADriveID definition
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDMediaCheck -- Return true if hardware and media are available

Description

   

      

         
Prototype:
      
      

         
bool SSDMediaCheck(ushort
         ssdid);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDNamesList -- Return a list of available Sector Storage Devices

Description

   

      

         
Prototype:
      
      

         
void
         SSDNamesList(void);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDLookupName -- Lookup a registered SSD by ID and return its name

Description

   

      

         
Prototype:
      
      

         
char SSDLookupName(ushort
         ssdid);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDLookupID -- Lookup a registered SSD by name and return its ID

Description

   

      

         
Prototype:
      
      

         
short SSDLookupID(char
         *name);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
name XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDGetIODvr -- Return the IODvr associated with this SSD

Description

   

      

         
Prototype:
      
      

         
void SSDGetIODvr (ushort
         ssdid);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SSDDisplayATADriveID -- Display the ATA drive ID information

Description

   

      

         
Prototype:
      
      

         
void SSDDisplayATADriveID
         (ushort ssdid, bool fullDisplay);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
ssdid XXXXX

         fullDisplay XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

Previous

Next

Top

Contents

Glossary

Index

Tel: 508-759-6434		Fax: 508-759-6436
Copyright (C) 1998 Persistor Instruments Inc. - All Rights Reserved