%SOCHARDWAREBOARD Create connection to specified SoC hardware board
%
% hL = socHardwareBoard() returns a list of SoC hardware boards that
% support data logging with SoC Blockset. 
%
% hw = socHardwareBoard(boardname) creates a connection to the SoC hardware
% board specified by boardname. This connection reuses the IP address,
% username, and password from the most recent connection of that specified
% SoC hardware board. When you connect MATLAB to an SoC hardware board for
% the first time, enter the board name, IP address, username and password
% of the SoC hardware board as name-value pair arguments. To see the
% complete list of SoC hardware boards supported for data logging, call the
% socHardwareBoard function without any argument.
%
% hw = socHardwareBoard(boardName,Name,Value) creates a connection to the
% specified SoC hardware by using the IP address, username, and password
% that you specify.
%
% Input Arguments:
%   boardName - Name of supported SoC hardware board 
%               character vector | string scalar
%
%   Name-Value Pair Arguments: 
%     'hostname' - IP address of SoC hardware board
%                  character vector
%     'username' - Root username used to log into SoC hardware board
%                  character vector
%     'password' - Root password used to log into SoC hardware board
%                  character vector 
%     
% Output Arguments:
%   hL - List of supported SoC hardware boards
%        string array
%
%   hw - Connection to specified SoC hardware board
%        soc.internal.zynq object | soc.internal.intelsoc object | soc.internal.Arty object | soc.internal.KC705 object
% 
%
% Examples: 
% 
%   % Get list of supported SoC hardware boards
%   hL = socHardwareBoard()
%   hL = 
%       1×7 string array
%
%       "Altera Arria 10 SoC development kit"    "Altera Cyclone V SoC development kit"    "Artix-7 35T Arty FPGA evaluation kit"    "Xilinx Kintex-7 KC
%
%   % Connect MATLAB to SoC hardware board over Ethernet
%   hw = socHardwareBoard('Xilinx Zynq ZC706 evaluation kit','hostname','192.168.1.18','username','root','password','root')
%   hw = 
%       soc.internal.zynq with properties:
%
%              BoardName: 'Xilinx Zynq ZC706 evaluation kit'
%          DeviceAddress: '192.168.1.18'
%                   Port: 18735

% Copyright 2019 The MathWorks, Inc.


