search

EMGroup / js-eden

Javascript EDEN
emgroup.github.io/js-eden
Other
10 stars 5 forks source link

readme

Construit Build Status

Either use our hosted version at http://jseden.dcs.warwick.ac.uk/construit or you can download JS-Eden from the github releases page and use it off-line.

Local Installation

Reasons to install locally? 1) You prefer not to allow students internet access. 2) Have a poor/unreliable internet connection. 3) Wish to access local hardware such as Arduino.

A locally installed version can still connect to the online repository if there is an internet connection, but it will work without this and is presented as a desktop application instead of a web-site.

Download the latest release and extract it from the zip or tar.gz. If there is a binary version (for linux) then you can use this directly. Otherwise:

Windows

Install Node.js version 6.10 or newer. Install Git.

Afterwards, open a PowerShell in Administrator mode and cd into the folder extracted from the download and enter the following commands.

npm install -g windows-build-tools
npm install

If the above command produces an error then you may need to install Windows SDK 8.1 and try it again.

And to start Construit use:

npm start

We suggest you then make a desktop shortcut which does npm start in the correct working directory.

Linux

Either:

apt-get install npm
apt-get install git

or

dnf install npm
dnf install git

Then cd into the extracted jseden folder and run:

npm install

To start Construit run the following in the jseden directory

npm start

Arduino

If an Arduino is connected (by USB at present) then it should prompt you when you start js-eden. You must first have uploaded our firmware to the device using the Arduino IDE. The sketch file can be found in plugins/arduino/sketch.c.

Observables starting with arduino_ are created to correspond to pins on the device or configuration. For example:

arduino_d13 is ledOn;

Developers

A developer should fork the git repo or use git clone to get the latest but unstable version. Then, with nodejs installed, do an npm install.

You can then either test using the local app version with npm start or use npm run devserver to start a local web server on port 8000.