N: SIO Command 'Q' Query JSON - FujiNetWIFI/fujinet-firmware GitHub Wiki

N: SIO Command Query JSON ($51) ['Q']

This is a command for Devices $71-$78 - The N: Device (see SIO-Commands-for-Device-IDs-$71-to-$78).

Description

Query the JSON parser to return specific pieces of information specified by the query string. The query string is formally defined in the JSON Query Format. The size of this query string is always 256 bytes, and should be terminated by ATASCII EOL.

Parameters

DCB Value
DDEVIC $71
DUNIT $01 - $04
DCOMND $51 'Q'
DSTATS $80
DBUF Buffer pointing to device string containing query string e.g. "N:/queryString"
DTIMLO $0F
DBYT 256
DAUX1 Use the same value passed to N: SIO Command 'O' - Open
DAUX2 Use the same value passed to N: SIO Command 'O' - Open

Examples

Atari BASIC

REM QUERY JSON (CMD 81 'Q', AUX1=12)
REM Note: Query string must start with /
XIO 81,#1,12,0,"N:/some/key"

C

/**
 * sio_json_query() - Query parsed JSON pointed to by opened stream
 */
void sio_json_query(char* queryDeviceSpec)
{
  OS.dcb.ddevic=0x71;
  OS.dcb.dunit=1;
  OS.dcb.dcomnd='Q';
  OS.dcb.dstats=0x80;
  OS.dcb.dbuf=queryDeviceSpec;
  OS.dcb.dtimlo=0x0f;
  OS.dcb.dbyt=256;
  OS.dcb.daux=0;
  siov();
}

See Also