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

SCSAnalogRead	SCSDeactivate
SCSIndentify	SCSInit
SCSPinsClear	SCSPinsRead
SCSPinsSet	SCSReset

#define SCS_STD_MAX_DEVS    32  // max to use standard tables

typedef union { struct { ushort id; ushort sn; }; ulong ref; } SCSDevice;
#define SCS_ALL_DEVS_REF    0xFFFFFFFF  // special value to reference all devices

enum
    {
      scsNoErr      = 0x00000000
    , scsIsReady    = 0x00000000    // from SCSReady()
    , scsNotReady   = 0xFFFFFFFF    // not ready, and told not to wait
    , scsNoResponse = 0xFFFFFFFE    // did not receive proper response
    };


typedef enum { SCSAD2, SCSAD3 } SCS_ADCH;   // for A-D reads

SCSInit -- Initialize the SandwichCard Supervisor driver

Description

   

      

         
Prototype:
      
      

         
short SCSInit(params);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSReady -- Return zero if ready now, or number of microseconds until ready

Description

   

      

         
Prototype:
      
      

         
ulong SCSReady(ulong
         scsref, bool wait);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSIndentify -- Return the specified ref (or iterate) from table and optionally confirm

Description

   

      

         
Prototype:
      
      

         
ulong SCSIndentify(ulong
         scsref, bool wait, short index, bool confirm);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX

         index XXXXX

         confirm XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSReset -- Reset one (or all) devices

Description

   

      

         
Prototype:
      
      

         
ulong SCSReset(ulong
         scsref, bool wait);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSDeactivate -- Deactivate a device until the next reset or power up

Description

   

      

         
Prototype:
      
      

         
ulong SCSDeactivate(ulong
         scsref, bool wait);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSPinsSet -- DDDD

Description

   

      

         
Prototype:
      
      

         
ulong SCSPinsSet(ulong
         scsref, bool wait, uchar setmask);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX

         setmask XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSPinsClear -- Clear devices I/O pins corrosponding to ones in clearmask

Description

   

      

         
Prototype:
      
      

         
ulong SCSPinsClear(ulong
         scsref, bool wait, uchar clearmask);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX

         clearmask XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSPinsRead -- Return devices I/O pins, force ones in inputmask to input

Description

   

      

         
Prototype:
      
      

         
ulong SCSPinsRead(ulong
         scsref, bool wait, uchar inputmask);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX

         inputmask XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCSAnalogRead -- Return devices analog value at the selected channel

Description

   

      

         
Prototype:
      
      

         
ulong SCSAnalogRead (ulong
         scsref, bool wait, SCS_ADCH ch);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scsref XXXXX

         wait XXXXX

         ch XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   





void    *SCSExp1(void *vp)                          PICO_CALL(SCSExp1);
void    *SCSExp2(void *vp)                          PICO_CALL(SCSExp2);
    

Previous

Next

Top

Contents

Glossary

Index

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