beagle(varargin)

function h = beagle(varargin)
% BEAGLE Establish connection with BeagleBoard hardware.
% 
% C = beagle creates a connection object, C, for communicating with 
% a BeagleBoard hardware.
%
% C = beagle(hostname, username, password, builddir) allows specification
% of non-default values for the IP address, user name, password, and the
% build directory on the BeagleBoard hardware.
%
% Methods:
% 
% [status, msg] = C.connect tests SSH connection to the BeagleBoard
% hardware. If connection is successful, the return value for status is
% zero. Otherwise an error has occurred during connection. The output
% argument msg provides diagnostic messages if the connection fails.
%
% [status, msg] = C.execute('command') executes the Linux command on the
% BeagleBoard hardware and returns the resulting status and standard output. 
%
% C.execute('command', true) executes the Linux command on the BeagleBoard
% hardware and forces the output to the MATLAB command window.
%
% C.run(modelName) runs the previously compiled Simulink model on the
% BeagleBoard hardware.
%
% C.stop(modelName) stops the execution of the Simulink model on the
% BeagleBoard hardware.
%
% Examples:
%
%    C = beagle;
%    C.execute('ls -al ~', true);
%
%  lists the contents of the home directory for the current user on the
%  BeagleBoard hardware.
%
%    [st, msg] = C.connect
%
%  tests the SSH connection to the BeagleBoard hardware. 
%
%    C.run('beagleboard_gettingstarted') 
%
%  runs the model 'beagleboard_gettingstarted' on the BeagleBoard hardware.
%  The model must have run previously on the BeagleBoard hardware for this
%  method to work properly


%   Copyright 2011-2012 The MathWorks, Inc.

h = realtime.internal.LinuxServices(varargin{:});