Skip to content

Latest commit

 

History

History
89 lines (56 loc) · 3.75 KB

setup.md

File metadata and controls

89 lines (56 loc) · 3.75 KB
Raw

Setting up your NodeBots Environment

If you have all of this installed before you arrive then you'll be ready to get cracking and start playing with hardware.

If any of this isn't working, don't worry, our friendly team will be able to help you on the day but it's important to have everything downloaded or you'll be waiting a while to get it onto your machine.

After you have everything installed, and want to get the best out of a NodeBots event, then we highly recommend trying out the node school nodebot-workshop adventure, goto node school for more information

Mac OSX

  • XCode - Install from the Mac Store. If you have installed the Command Line Tools through another means (eg Homebrew) then you won't need to do this. This is a big download, you don't want to be doing this on the day or you'll miss out on an hour of the fun.
  • Development command line tools - Easiest way to do this is from xcode itself: See thread here at StackOverflow
  • Your choice of HomeBrew or MacPorts. We'd recommend homebrew as it makes getting node up and running easy.
  • NodeJS - Follow the appropriate directions here
  • Arduino - Mac Install guide

Finally - attempt to install node-serialport as this will test everything is working:

	npm install serialport

If you can install node-serialport then you're pretty much good to go.

The following commands will also install all these components using Homebrew and Cask. It assumes you are using OS X.9 or above. If you are using an earlier version of OS X then you will need to install XCode from the App Store and then install the command line tools; or download the command line development tools from the Apple developer site and install.

#! /usr/bin/env bash

# Install Apple CLI Dev tools, java, node, Arduino IDE etc

xcode-select --install # Works on Mavericks and hopefully above

echo
read -p "Please wait until CLI tools are installed and press enter"  < /dev/tty

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

#Symlink Cask apps into the normal place. Add this to login scripts as well
export HOMEBREW_CASK_OPTS="--appdir=/Applications"

brew tap caskroom/cask
brew install brew-cask

brew cask install java

brew install minicom # Useful to connect to serial devices
brew install node
brew cask install arduino
sudo npm -g install serialport

Linux

Linux is generally pretty straight forward. Install the following (assuming Ubuntu / Debian style machines):

Finally - attempt to install node-serialport as this will test everything is working:

	npm install serialport

Windows

Please note

Windows users generally have the most problems with getting up and running of anyone. Please ensure you can install Johnny Five before coming to the event or you may lose time on the day hunting for issues.

Install the following:

    npm install johnny-five

This will shake out any problems you've got. It's pretty common to have troubles with Windows but they are fairly well documented and a quick google of the error message will usually resolve it.

Documentation kindly copied from nodebotsau