Download Dock Server User Guide

Revision 7.10
2/28/2012
The glider arity option, ­n, ­­arity <single | multiple>, specifies how many gliders are expected to connect on the associated serial port. The two possible values are single and multiple.
The value single indicates that once a glider has connected to this serial port, Dock Server can assume subsequent connections to the port are by this same glider. This assumption allows Dock Server to skip the glider identification phase at the start of every connection (refer to section 9.4). Thus, this glider connects faster and the user sees its connect indicator turn green sooner. For example, the port­dockserver command:
port­dockserver mod ­n single ttyUSB0
Configures Dock Server to treat every subsequent connection on serial port ttyUSB0 as if it’s from the same glider as the one that first connects. If the first glider that connects is identified as “Darwin” (using the process detailed in section 9.4), then all subsequent connections to the associated serial port are assumed to be the glider Darwin.
Dock Server clears the association between a glider and serial port when Dock Server is restarted or when the serial port’s Data Set Ready line transitions high to low (occurs when a serial cable is unplugged from a serial port).
If at any time, Dock Server detects that a connected glider is not the assumed glider, Dock Server switches to the detected glider.
The value multiple indicates that more than one glider may connect to this serial port. Thus, Dock Server always attempts to identify the glider with each connection as described in section 9.4. For example, the port­dockserver command:
port­dockserver mod ­n multiple ttyS0
Configures Dock Server to treat each connection to port ttyS0 as if it could be from a different glider. Thus, Dock Server attempts to identify the connecting glider each time carrier detect goes high.
Table 2­2 shows the default glider arity option values for each device type.
Page 33 of 228