framlin / xcarve-server

A Node.js Raspberry Pi server for controlling a XCarve from a remote machine using Easel.

Raspberry Pi XCarve Server

A Node.js Raspberry Pi server for controlling a XCarve from a remote machine using Easel.

For detailed install instructions, please visit the tutorial on the Adafruit Learning System.

Connecting to a Headless Raspberry Pi

If you would like to connect to a headless Raspberry Pi for setting up WiFi access, you can use the Adafruit Raspberry Pi Finder app to find and connect to your Raspberry Pi.

Installation

Make sure you have the latest 4.x version of Node.js installed on your Raspberry Pi. You can install it using the NodeSource installer.

pi@xcarve ~ $ curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
pi@xcarve ~ $ sudo apt-get install -y nodejs
pi@xcarve ~ $ node -v
v4.6.2

Make sure the global node_modules folder on your Raspberry Pi is writable by the pi user.

pi@xcarve ~ $ sudo chown -R pi /usr/local

Install xcarve-server on your Raspberry Pi.

pi@xcarve ~ $ npm install -g xcarve-server

Starting the Server

If everything has been installed, you can start the service by running the following command:

pi@xcarve ~ $ xcarve-server start

██╗  ██╗      ██████╗ █████╗ ██████╗ ██╗   ██╗███████╗
╚██╗██╔╝     ██╔════╝██╔══██╗██╔══██╗██║   ██║██╔════╝
 ╚███╔╝█████╗██║     ███████║██████╔╝██║   ██║█████╗
 ██╔██╗╚════╝██║     ██╔══██║██╔══██╗╚██╗ ██╔╝██╔══╝
██╔╝ ██╗     ╚██████╗██║  ██║██║  ██║ ╚████╔╝ ███████╗
╚═╝  ╚═╝      ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝  ╚═══╝  ╚══════╝

starting service on port 1338...

Stopping the Server

pi@xcarve ~ $ xcarve-server stop
stopping service...

License

Some of the code included in the lib/ folder of this repo was extracted from v0.2.7 of the Easel local OS X installer.

All other code is Copyright (c) 2015-2016 Adafruit Industries. Licensed under the MIT license.

Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!