Serial Read

From WikiPrizm
Jump to navigationJump to search


Synopsis

Header: fxcg/serial.h
Syscall index: 0x1BBA
Function signature: int Serial_Read(unsigned char *out, int sz, short *count)

Reads bytes from the serial receive buffer.

Parameters

  • out - Buffer to write received data to.
  • sz - Maximum number of bytes to read.
  • count - Output parameter receiving the number of bytes actually read.

Returns

  • 0 if successful,
  • 1 if the receive buffer is empty,
  • 3 if the serial channel is not open.

If successful, the actual number of bytes read is returned in count.

Comments

The receive buffer can hold up to 1024 bytes. Its behavior on overflow is unknown.

Originally documented as Serial_ReadNBytes.