## Copyright (C) 2019 John Donoghue <john.donoghue@ieee.org>
## 
## This program is free software: you can redistribute it and/or modify it
## under the terms of the GNU General Public License as published by
## the Free Software Foundation, either version 3 of the License, or
## (at your option) any later version.
## 
## This program is distributed in the hope that it will be useful, but
## WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
## GNU General Public License for more details.

## -*- texinfo -*- 
## @deftypefn {} {} setDTR (@var{dev}, @var{true_false})
## Set the state of the DTR line
##
## @subsubheading Inputs
## @var{dev} - connected serial device.@*
## @var{true_false} - state to set the line.@*
##
## @subsubheading Outputs
## None
##
## @seealso{serialport, getpinstatus, setRTS}
## @end deftypefn

function setDTR (dev, tf)

  if nargin < 2
    print_usage();
  else
    if  !islogical (tf) && !isnumeric(tf)
      error("setDTR expected pin state to be true or false");
    endif

    __srlp_properties__ (dev, "__dataterminalready__", tf);

  endif
endfunction
