Skip to content

Latest commit

 

History

History
108 lines (68 loc) · 6.2 KB

setting_up_osc.md

File metadata and controls

108 lines (68 loc) · 6.2 KB
Raw

Step 1. Set up your raspberry pi as a Wireless Access Point (maybe should be last step)

Important! Make sure to do all this once you have downloaded all the packages (npm install, updates, etc) you need from internet, you won't be able to access the internet once you set up your Pi as a Wireless Access Point.

To set up your raspberry pi zero W as a wireless access point, follow these instructions.

Step 2. Install Node on the raspberry pi

So first of all type this in your terminal on raspberry pi to detect the version that you need:

uname -m

If the response starts with armv6 than that's the version that you will need. For example for raspberry pi zero W you will need ARMv6

The latest version that supports armv6 is v.10.x, go to Node's official website and download the tar.gz file that you need.

In my case it was: node-v10.17.0-linux-armv6l.tar.gz

You can download the file either by doing (if your pi is connected to the internet):

wget https://nodejs.org/dist/latest-v10.x/node-v10.17.0-linux-armv6l.tar.gz

or

curl -o node-v10.17.0-linux-armv6l.tar.gz https://nodejs.org/dist/latest-v10.x/node-v10.17.0-linux-armv6l.tar.gz

or doing ssh into the pi and copying the files to the pi from the terminal of your computer:

"C:\Program Files\PuTTY\pscp.exe" node-v10.17.0-linux-armv6l.tar.gz pi@192.168.4.1:/home/pi

Then extract the file:

tar -xzf node-v10.17.0-linux-armv6l.tar.gz

Finally copy node to its final location and expose it as a global command:

cd node-v6.11.1-linux-armv6l/
sudo cp -R * /usr/local/

Now run: node -v to verify that node was installed correctly.

Step 3. Install socket.io

If you haven't set up the wireless port yet, the connectivity of your Raspberry Pi W should work, in that case, type: npm install socket.io --save and npm should install the package for you.

or

If you didn't follow the steps in order, and you set up the Wireless Access Point before, you won't have access to internet, so you'll need to download the package on your computer, pass it through SSH to the Raspberry Pi and then install it from there.

The steps for that unfortunate case are:

  1. Download the zip file of socket.io from github.com
  2. Extract the zip file and go inside the folder in your terminal: cd socket.io-master
  3. Run npm install inside socket.io-master so you download all dependencies and generate the node_modules folder.
  4. In the package.json file add a "bundledDependencies" array with the names of all the packages listed in the "dependencies" property In my case it ended up like this:
"bundledDependencies": [
    "debug", "engine.io", "has-binary2", "socket.io-adapter", "socket.io-client", "socket.io-parser"
  ],

This will put all the dependencies also inside of the tarball, because you won't have internet to download them in the offline pi.

  1. Run npm pack in your terminal. This will generate a tarball (.tgz or tar.gz) file.
  2. Transfer the tarball file to the pi via SSH from the terminal from the folder where the file is stored, I did "C:\Program Files\PuTTY\pscp.exe" socket.io-2.3.0.tgz pi@192.168.4.1:/home/pi
  3. SSH into the PI with Putty and do ls. Your tarball file should be listed there.
  4. Run npm install ./socket.io-2.3.0.tgz --save to install the library in offline mode.

Step 4. Install node-osc

Now we need to install a node osc package (there are plenty online) to be able to send OSC messages between the different parts of the app. We have chosen node-osc.

If your Pi has connection to Internet do simply npm install node-osc --save in the root of the project.

If your Raspberry Pi is offline we need, again, to take the long road:

  1. Download the node-osc zip.
  2. Extract the file and go into the folder cd node-osc-current
  3. Run npm install
  4. Open the packages.json file and copy the names of the dependencies into an array in bundledDependencies like this: "bundledDependencies":["jspack", "osc-min"], (this may change for future versions, this is valid for version 4.1.4.
  5. Run npm pack to get your tarball file.
  6. Copy the file over SSH from the computer terminal to the Pi with the command "C:\Program Files\PuTTY\pscp.exe" node-osc-4.1.4.tgz pi@192.168.4.1:/home/pi
  7. Inside the Raspberry Pi do: npm install ./node-osc-4.1.4.tgz --save. Phew!!

Step 5. Install python-osc

Now we need to install the python library that will communicate with the Python project (in this case, r_e_c_u_r).

This has to be done also on the Pi, if the Raspberry Pi is connected to the internet, do pip3 install python-osc in the folder project. Also copy the py-osc-server.py file to the folder project.

If your rasppi is offline, you need to:

  1. Download the python-osc's zip file on your computer
  2. Transfer the file to the Raspberry pi with our accustomed "C:\Program Files\PuTTY\pscp.exe" etc....
  3. Type tar -xvf python-osc-1.7.3.tar.gz to uncompress the tar to a folder.
  4. Type pip3 install python-osc-1.7.3 and you should be good to go.

Now run python3 py-osc-server.py to have the OSC server listening for messages and do npm start (will run webserver.js) to start up the node server.

And Finally!!!

When you connect to the address http://192.168.4.1:8000 (or whatever port you have configured in webserver), you will be able to send messages to the node app, and from the node app to any application with OSC activated on port 5233 (defined in py-osc-server.py and in webserver.js)

Note:

As a final note I would like to add, that when working on an offline raspberry Pi, you can transfer files files from the Raspberry Pi to the Computer by typing from the terminal of the computer: scp pi@193.168.4.1:myFolder/myFile.tar.gz . myFolder would be the path from /pi/home/. This command will copy the file to the current director in the Terminal.