Rabbit 2000 Getting Started

Also see for 2000: Getting started manual Reference manual User manual Getting started manual Designers handbook

Rabbit 2000 Getting Started Manual pdf 28 page image

Getting Started Manual 234.3.2 Non-Cofunction Blocking Input FunctionsThese are simple functions that do not use Dynamic C costatements. If no input data areavailable when called, they return immediately with appropriate status information in theirreturn value. Once they begin to receive characters, they do not yield to other tasks untilthey complete their operation or until a character-to-character timeout period elapses.int serXgetc ( );Gets a single character. Always returns immediately, either with the next available input byte, or with –1if none is available.ParametersNoneReturn ValueAn integer with return character in the low byte. No character is represented by a return of –1.int serXread (void *data, int length, unsigned long tmout);Reads a block of characters. Returns the number of bytes read from an input serial stream. The stream isconsidered to be ended when all length bytes have been read or when the timeout period elapses wait-ing for data to appear in the input buffer.Parametersdata—Destination data structure. The user must ensure data is allocated for at least length bytes.length—The number of bytes to read.tmout—The number of milliseconds to wait for receipt of each byte before timing out.Return ValueThe number of bytes read into data until timed out or until all length bytes have been read.