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/ (4.6.1 32bit recommended for windows - https://nodejs.org/download/release/v4.6.1/node-v4.6.1-x86.msi)

==== 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: http://digistump.com/spark-server.zip
  * 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 (for OpenSSL - in our experience - you'll want this version: http://code.x2go.org/releases/binary-win32/3rd-party/Win32OpenSSL/Win32OpenSSL-1_0_1j.exe)

The Particle local server should now be running!

===== Installing the Particle CLI Tool =====

  * With node installed in the last step you can install the Particle CLI tool with this command:
<code>npm install -g particle-cli</code>

  * If you are on the Raspberry Pi, you need to use the following command so that the serialport dependency is successfully compiled as there are no pre-compiled binaries for the Raspberry Pi/ARM platform: <code>sudo npm install -g particle-cli --unsafe-perm --build-from-source</code>


===== 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 ====


  * Windows Only: Install OpenSSL if you don't have it - http://gnuwin32.sourceforge.net/packages/openssl.htm

Run (from the same folder as the server):
<code>
openssl rsa -in  default_key.pub.pem -pubin -pubout -outform DER -out default_key.pub.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.pub.der and get the hex 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


==== 2. Copy the device Public Key to the Server  ====

In the server folder create a core_keys folder if it does not exist.

While still connected to the Oak that is in config mode go to http://192.168.0.1/device-id - you should get a response like this:

<code>
{ "id":"ABCDEFGHJK","c":"1" }
</code>

Where "ABCDEFGHJK" is the device ID for this device - copy this without the quotes, you will need it to complete the rest of this step.

Now go to http://192.168.0.1/public-key - you should get a response like this:
<code>
{ "r": 0, "b":"AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUVVWWXXYYZZ" }
</code>

Where "AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUVVWWXXYYZZ" is a string of numbers and letters that make up the hex encoded public key for the device. Copy this string without the quotes into a text editor and save as DEVICE_ID.pub.der - where DEVICE_ID is the device id you got above.

Upload it here (or use another hex decoder): http://bin-hex-converter.online-domain-tools.com/ and hit decode, then click download as binary file. Rename that download to DEVICE_ID.pub.pem and place in the core_keys directory you created above.


==== 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 ====

Stop and restart the server.

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
