View source for Template:SBC Developing with an External Computer

There are two main ways in which you can access your SBC from an external computer:
*SBC Web Interface
*Secure Shell (SSH)

The [[SBC3003 User Guide#Getting Started | user guide]] covers the SBC Web Interface in detail, so we will review SSH below.

====SSH====
If you are unfamiliar with SSH, it is a simple yet powerful tool that allows you to log into a remote machine in order to execute commands. You can also transfer files using the associated SCP tool.

In order to use SSH, you need to know the following things about the SBC:
*IP address (e.g. 192.168.3.195) or the link local address (e.g. phidgetsbc.local)
*The administrator password

You must also enable SSH on the SBC. You can do this via the SBC Web Interface which is shown in the image below:
[[File:phidgetsbc_enableSSH.PNG|link=|alt=|center]]

=====SSH on Windows=====
To use SSH on Windows, we recommend [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY]. Use the images below as a guide for configuring PuTTY (use the IP address or the link local address interchangeably):
[[File:Windows_PuttyIP.PNG|link=|alt=|left|425x411px]]
[[File:Windows_PuttyLL.PNG|link=|alt=|425x411px]]


After clicking open, simply login as root and provide the administrator password:
[[File:Windows_PuttyLogin.PNG|link=|alt=|center]]


To transfer files between your SBC and Windows machine, we recommend either of these programs:
* [https://winscp.net/eng/download.php WinSCP]
* [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY PSCP]

You will follow a similar process to access the SBC as described for SSH.

=====SSH on Linux and macOS=====
SSH is available on Linux and macOS by default. To run SSH, simply open the terminal and type the following:
<syntaxhighlight lang=bash>
ssh root@phidgetsbc.local
</syntaxhighlight>
Or, something like this (you will need to know the IP address of your SBC):
<syntaxhighlight lang=bash>
ssh root@192.168.3.195
</syntaxhighlight>

You will then be prompted for the password in order to gain access to the SBC:
[[File:macOS_SSH.png|link=|alt=|center]]


To copy a file from the SBC to your development machine using SCP, simply open the terminal and type the following:
<syntaxhighlight lang=bash>
scp root@phidgetsbc.local:/path/to/source /path/to/destination
</syntaxhighlight>
You can reverse this if you want to transfer a file from your development machine to your SBC:
<syntaxhighlight lang=bash>
scp  /path/to/source root@phidgetsbc.local:/path/to/destination
</syntaxhighlight>