Serial Open

From WikiPrizm
Jump to navigationJump to search


Synopsis

Header: fxcg/serial.h
Syscall index: 0x1BB7
Function signature: int Serial_Open(unsigned char* mode)

Opens the 3-pin serial port with the specified parameters.

Parameters

  • mode - pointer to a six-byte array containing the settings for the serial port:
Index Description Values
0 Unknown Always 0
1 Bit rate
Value Rate
0 300
1 600
2 1200
3 2400
4 4800
5 9600
6 19200
7 38400
8 57600
9 115200
2 Parity
Value Parity
0 None
1 Odd
2 Even
3 Data length
Value Length (bits)
0 8
1 7
4 Stop bits
Value Stop bits
0 1
1 2
5 Unused Always 0


Returns

  • 0 if successful;
  • 3 if the serial port is already open;
  • 4 if mode[0] is not zero.

Example

Check if the serial port is already open, and configure it for 9600 bps 8N1 operation if not.

if (Serial_IsOpen() != 1) {
    unsigned char mode[6] = {0, 5, 0, 0, 0, 0};    // 9600 bps 8n1
    Serial_Open(mode);
}