Introduction to port configuration

The most important functions for port configuration are the RComm::Config() and RComm::SetConfig(), which enable the port setting currently in force to be read or set using a configuration settings package, TCommConfig (which packages a structure TCommConfigV01 in a convenient form for passing to and from the server).

The capabilities of the port can be read with the member function Caps(), which uses a TCommCaps package (which in turn represents a TCommCapsV01 structure). The facilities for enquiring about the capabilities of a port parallel those for its configuration.

While many elements of these functions and structures should present no problems to anyone familiar with the operation of standard UARTs or the low-level communications APIs of other operating systems, there are nevertheless some aspects of port configuration in the definition of TCommConfig that are unusual enough to be worth describing in this section in more detail.

Package Buffers