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

SCBGetWaits	SCBIdentify
SCBInit	SCBNotifyPostClockChange
SCBNotifyPreClockChange	SCBSetup
SCBUpdateWaits

#define SCB_DEFAULTS            (ulong) -1  // use standard defaults
#define SCB_DEFAULT_CS8_ADDR    0xFFFF8000  // short absolute addressing
#define SCB_DEFAULT_CS10_ADDR   0xFFFF0000  // regular absolute addressing
#define SCB_DEFAULT_NS_ACCESS   40          // start small, work up
#define SCB_MAX_CARDS           32          // max unique SandwichCards
#define SCB_MAX_HALF            (SCB_MAX_CARDS / 2) // for indexing CS10

SCBInit -- Initialize the SandwichCard hardware interface

Description

   

      

         
Prototype:
      
      

         
bool SCBInit(ulong cs8addr,
         ulong cs10addr, bool autowait);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
cs8addr XXXXX

         cs10addr XXXXX

         autowait XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBSetup -- Board specific SandwichCard initialization

Description

   

      

         
Prototype:
      
      

         
ulong SCBSetup(ushort scms,
         short nsAccess, char *id);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scms XXXXX

         nsAccess XXXXX

         id XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBIdentify -- Return board specific SandwichCard information

Description

   

      

         
Prototype:
      
      

         
char SCBIdentify(ushort
         scms, short *nsAccess);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scms XXXXX

         nsAccess XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBUpdateWaits -- Update wait states for all SandwichCards

Description

   

      

         
Prototype:
      
      

         
void
         SCBUpdateWaits(params);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBGetWaits -- Return current wait states for this card at this system clock

Description

   

      

         
Prototype:
      
      

         
short SCBGetWaits(ushort
         scms);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
scms XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBNotifyPreClockChange -- Prepare wait states for a pending clock change

Description

   

      

         
Prototype:
      
      

         
void
         SCBNotifyPreClockChange(void);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

SCBNotifyPostClockChange -- Adjust wait states after a clock change

Description

   

      

         
Prototype:
      
      

         
void
         SCBNotifyPostClockChange(void);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
none
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   






void    *SCBExp1(void *vp)                          PICO_CALL(SCBExp1);
void    *SCBExp2(void *vp)                          PICO_CALL(SCBExp2);

Previous

Next

Top

Contents

Glossary

Index

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