Digistump Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Oak on the Particle Local Server ======

You may chose to use your Oak with a local version of the Particle server. This is a guide for how to install the local server and setup an Oak to use it.

NOTE: You can also use many other cloud services for storing data, just look for any of them that have a ESP8266 Arduino library and they should work with the Oak - though you may need to remove the WiFi connection code in their examples because the Oak handles that automatically.

See this page for what the local server can and cannot do: https://github.com/spark/spark-server

===== Installing the Particle Local Server =====

  * Install Node.JS 4.x or older (anything from v0.10 to 4.x should work) for your platform: https://nodejs.org/en/download/

==== OSX/Linux ====

  * Install Git (apt-get git, brew git, or similar)
  * Download zip file of the Particle (Spark) server: https://github.com/digistump/spark-server/archive/master.zip (Note this version has been modified to fix some bugs that Particle has not fixed yet.) 
  * Unzip the download and open a command line window in that folder and then run the following commands:
<code>npm install
node main.js</code>

==== Windows ====

  * Download pre-built windows zip file here:
  * Unzip the download and open a command line window in that folder and then run the following command:
<code>node main.js</code>
  * If this doesn't work try the OSX/Linux procedure above, installing git from here: https://git-scm.com/downloads or any where else - git version doesn't matter too much. You will also need to install C++ compiling tools - see windows instructions on this page for more: https://github.com/nodejs/node-gyp

The Particle local server should now be running!


===== Setting up an Oak to use the Local Server =====

For an Oak to use the local server we'll need to do the following:
  - Convert the server's public key to the DER format and then Base64 Encode it
  - Set the Server Address and Server Public Key for the Oak to the those of the local server
  - Set the Particle CLI tool to allow it to talk to the local server and connect
  - Restart the Oak and allow it to connect


==== 1. Convert the server's public key to the DER format and then Base64 Encode it ====
Run (from the same folder as the server):
<code>
openssl rsa -in  default_key.pem -pubin -pubout -outform DER -out default_key.der
</code>
and then use a base64 encoder (locally for best safety) or here for convenience: http://bin-hex-converter.online-domain-tools.com/

Upload the default_key.der and get the encoded output, save this somewhere, you will need it in the next step.

==== 2. Set the Server Address and Server Public Key for the Oak ====

Go to this page: http://digistump.com/oak/localserver.html

Then disconnect from the internet and connect your wifi to an updated Oak that is in config mode (see: http://digistump.com/wiki/oak/tutorials/connecting).

On that page enter the server address (IP or domain) and the hex encoded key you got above and hit submit.

Or POST the following JSON as a raw body to http://192.168.0.1/set
<code>
{"server-address":"IP OR DOMAIN HERE","server_address_type":0,"server-public-key":"HEX PUBLIC KEY FROM ABOVE"}
</code>
server_address_type = 0 for IP address, 1 for domain name


==== 3. Set the Particle CLI tool to allow it to talk to the local server ====

Source: https://docs.particle.io/support/troubleshooting/cloud-solutions/photon/
Run the following commands on a separate CMD prompt from the one running the server:

<code>
particle config local_oak apiUrl "http://DOMAIN_OR_IP:8080"

particle config local_oak 

particle setup 
</code>

This adds the local server ip to the cli tool, switches to using it, and creates an account on the local cloud.

==== 4. Restart Oak so it connects ====

Repeat steps #2 and #3 for other Oaks you want on the same cloud.

Remove power from the Oak and then re-apply power. The Oak should now connect to the local server and you should see the connection in the local server command window.

See the Particle guides for more about what you can do with the local server, use the Particle-cli upload and compile options to push firmware.
Digistump Wiki

User Tools

Site Tools

Page Tools
