Index

Function Name: CHKIN

Purpose: Open a channel for input
Call address: $FFC6 (hex) 65478 (decimal)
Communication registers:X
Preparatory routines: (OPEN)
Error returns:
Stack requirements: None
Registers affected: A, X

Description: Any logical file that has already been opened by the KERNAL OPEN routine can be defined as an input channel by this routine. Naturally, the device on the channel must be an input device. Otherwise an error will occur, and the routine will abort.

If you are getting data from anywhere other than the keyboard, this routine must be called before using either the CHRIN or the GETIN KERNAL routines for data input. If you want to use the input from the keyboard, and no other input channels are opened, then the calls to this routine, and to the OPEN routine are not needed.

When this routine is used with a device on the serial bus, it auto- matically sends the talk address (and the secondary address if one was specified by the OPEN routine) over the bus.

How to Use:

  1. OPEN the logical file (if necessary; see description above).
  2. Load the X register with number of the logical file to be used.
  3. Call this routine (using a JSR command).

Possible errors are:

   #3: File not open
   #5: Device not present
   #6: File not an input file

EXAMPLE:

   ;PREPARE FOR INPUT FROM LOGICAL FILE 2
   LDX #2
   JSR CHKIN