N: SIO Command 'O' Open

N: SIO Command OPEN ($4F) ['O']

Description

Given a devicespec in the returned 256 byte buffer, parse it, and if valid, instantiate the protocol, and prepare the Atari to be able to send/receive an I/O channel for the chosen protocol.

If a devicespec is invalid, then an ERROR 165 is returned on the subsequent STATUS command (while returning an SIO ERROR 144, indicating that you should check the STATUS).

Parameters

DCB	Value
DDEVIC	$71
DUNIT	$01 - $04
DCOMND	$4F 'O'
DSTATS	$80
DBUF	a 256 byte buffer containing N: devicespec
DTIMLO	$0F
DBYT	256
DAUX1	N: AUX1 Values
DAUX2	N: AUX2 Values

Examples

CC65

static unsigned char hostname[256]="N:TCP://irata.online:8005/";

/**
 * io_init() - Set-up the I/O
 */
void io_init(void)
{
  OS.vprced=ih;
  PIA.pactl |= 1;
  // Establish connection
  OS.dcb.ddevic=0x71;
  OS.dcb.dunit=1;
  OS.dcb.dcomnd='O';
  OS.dcb.dstats=0x80;
  OS.dcb.dbuf=&hostname;
  OS.dcb.dtimlo=0x0f;
  OS.dcb.dbyt=256;
  OS.dcb.daux=0;
  siov();
}

See Also

Put other related command links here.