.rxbuffsize R/O Property


For the selected serial port (selection is made through ser.num), returns current the RX buffer capacity in bytes.


Word | dword

Value Range:

Platform-dependent, default = 0

See Also:

Buffer Memory Status


Buffer capacity can be changed through the ser.rxbuffrq method followed by the sys.buffalloc method.

The ser.rxbuffrq method requests the buffer size in 256-byte pages, whereas this property returns the buffer size in bytes. The relationship between the two is as follows: ser.rxbuffsize = num_pages * 256 - X (or = 0 when num_pages = 0), where "num_pages" is the number of buffer pages that was GRANTED through ser.rxbuffrq. The "- X" is because a number of bytes is needed for internal buffer variables. X = 17 bytes on 16-bit platforms and 33 bytes on 32-bit platforms. The platform type is specified in your platform documentation.

Older devices had smaller RAM sizes, so the value returned by this property was of the word type. On newer devices with larger RAM capacities, this property has the dword type. Inspect the property's declaration on the platform you are using to make sure you know its type.

.rxbuffsize R/O Property