=====                                               NOSview [301]
param
=====

The 'param' command allows device-specific control parameters to
be sent to an interface, and the status to be read back from an
interface.

On a KISS TNC interface, 'param' control packets to the TNC.
Argument to the 'param' command are always decimal.

On a SLIP interface, the 'param' command allows the baud rate to
be read (without arguments) or set.

The implementation of this command for the various interface
drivers is incomplete and subject to change.


_________________________________________________________________
param <interface>
_________________________________________________________________
The 'param' command displays interface characteristics.  The
actual data displayed depends on the interface type.

>>  Example of the output from 'param tnc0':

...............
: DTR: 1      :
: RTS: 1      :
: Speed: 4800 :
:.............:


_________________________________________________________________
param <interface> <param> [<param> ...]
_________________________________________________________________
General command to send parameters to the interface.  Specific
commands for a KISS interface are shown below.


_________________________________________________________________
param <KISS_interface> 0 <data frame>
_________________________________________________________________
[This command is not used to send data to the TNC, but is
included here for completeness].


_________________________________________________________________
param <KISS_interface> 1 <TX_delay>                  (10mS units)
_________________________________________________________________
Set the TNC TXDELAY parameter.

>> Example:  param tnc0 1 20                    (TXDELAY = 200mS)


_________________________________________________________________
param <KISS_interface> 2 <persistence>                    (0-255)
_________________________________________________________________
Set the p-persistence parameter.  This parameter contributes
towards collision avoidance on a busy channel.  When the channel
is free, a random number between 0 and 255 is generated.  If this
number is not greater than the <persistence> value, the packet is
transmitted.  Otherwise the TNC waits for another slot time
before trying again (see 'param 3' below).

>> Example:  param tnc0 2 63


_________________________________________________________________
param <KISS_interface> 3 <slot_time>                 (10mS units)
_________________________________________________________________
Set the duration of the p-persistence slot time.

>> Example:  param tnc0 3 10                  (Slot time = 100mS)


_________________________________________________________________
param <KISS_interface> 4 <TX_tail>                   (10mS units)
_________________________________________________________________
Set the TXTAIL parameter.

>> Example:  param tnc0 4 10                     (TXTAIL = 100mS)


_________________________________________________________________
param <KISS_interface> 5 <n>
_________________________________________________________________
Set the interface to half duplex or full duplex working.

n=0: half duplex
n>0: full duplex

Most packet radio links are half duplex.

>> Example:  param tnc0 5 0                         (Half duplex)


_________________________________________________________________
param <KISS_interface> 255
_________________________________________________________________
Terminate TNC KISS mode and switch it back to native mode.  This
is necessary if you wish to use the TNC in its traditional dumb-
terminal mode (i.e. with the "cmd:" prompt).

This command returns the message "Return: 0" if it was
successful.

>> Example:  param tnc0 255


=====================
SUMMARY OF PARAMETERS
=====================
   0  Data       - Normal KISS data
   1  TxDelay    - set TX delay for TNC (x 10ms)
   2  Persist    - set persistence for TNC
   3  Slottime   - set slottime delay for TNC (x 10ms)
   4  TxTail     - set TX tail delay for TNC (x 10ms)
   5  Fulldup    - 0=half duplex, 1=full duplex
   6  Hardware   - Hardware dependent
   7  TxMute     -
   8  DTR        - 0 = down, 1 = up
   9  RTS        - 0 = down, 1 = up
  10  Speed      - baud rate
  11  Enddelay   -
  12  Group      -
  13  Idle       -
  14  Min        -
  15  Maxkey     -
  16  Wait       -
  17  Parity     - 0 = none, 1 = even, 2 = odd parity
 129  Down       -
 130  Up         -
 254  Return2    - Some TNCs need this
 255  Return     - Reset a TNC from KISS into command mode
