{::options parse_block_html="true" /}
These are instructions for Tessel 2. Start here for Tessel 1.
New to the command line? Take a step back and learn the basics.
Select the operating system you are working on.
-
| [OSX](#tab-osx) || [Linux](#tab-linux) || [Windows](#tab-windows) |
Node.js is a prerequisite for installing the Tessel command line. You can install it from the official website, or if you have brew installed: brew install node
Once Node.js is installed, run this installation script from your terminal:
npm install -g t2-cli
Note: If you get the common npm EACCES error, correct it by fixing npm permissions and then running npm install -g t2-cli again.
Node.js is a prerequisite for installing the Tessel command line. You can install it from the official website or following these instructions for your package manager.
If you are running Ubuntu 13.10 or later, you can run this:
apt-get install nodejs nodejs-legacy
Once Node is installed, run this in your terminal:
apt-get install libusb-1.0-0-dev libudev-dev
npm install -g t2-cli
On Windows, Tessel drivers will install automatically when you plug in.
On Windows 7, you may receive the notification "Device driver software was not successfully installed". If you do, click on the notification, click the "Change settings..." button, and then select "Install driver software from Windows Update if it is not found on my computer." Save changes and re-try.
Next, install Node.JS. You need this to interact with Tessel from the command line.
After installing the Tessel drivers and Node.js, run this in cmd.exe:
npm install -g t2-cli
Plug in your Tessel over USB (use Tessel's microUSB port, between the USB ports and the module ports).
It takes ~30s to finish booting up (track the issue here); lights will flash during this process.
Run:
t2 list
You should be able to see your Tessel (and any other Tessels connected to the same network as your computer):
{% highlight sh %} INFO Searching for nearby Tessels... USB Tessel-AF768F095 {% endhighlight %}
Yay, you found it! At this point, your Tessel is operational and in communication with your computer.
Bonus: give your Tessel a name, like "Frank" or "Bulbasaur":
t2 rename <name>
If you run t2 list again, you'll see your Tessel has changed its name:
{% highlight sh %} INFO Searching for nearby Tessels... USB Bulbasaur {% endhighlight %}