stevenaeola

Documentation and tutorials

Getting Started

Connecting the parts

You should end up with a screen that looks like this:

Startup screen for Linux on the Raspberry Pi

If you are running on a pitop you will need to switch to the desktop first, icon in the top left hand corner.

This is the Operating System (OS) called Linux, which has similar functions to Windows. Linux is also the basis of the Android operating system used on some mobile phones. The hardware used on the Raspberry Pi is also commonly used in mobile phones, which is why it is so compact.

Starting the software

There are three programs that need to be running:

The node-red server is a web server, although in this case it is running on the same computer as the web browser. So your web browser sends requests to the node-red server, and the node-red server sends responses back. The SuperCollider server is essentially a synthesiser, and it gets its instructions about which sounds to make from the node-red server. The programs fit together like this:

Communication between the programs

You start the two server programs via the terminal which you can start by clicking on this icon in the top left hand corner of the screen (or bottom left on pitop).

Terminal icon

Once you’ve done that you should end up with a a screen that looks like this:

Linux with open terminal

At the terminal (also known as the command prompt) you need to start the first server program called SuperCollider by typing exactly this, with a return at the end

./startsc.sh

You should see various bits of output while SuperCollider gets set up and connected to the audio system on the computer. If you ever get a problem with your SuperCollider server (e.g. a “zombie” synth that keeps on playing) you can restart the SuperCollider server at any time with this command.

Once it is finished you can start the node-red by opening another terminal and typing

node-red

Next start up the web browser with this icon in the top left hand corner

Browser icon

The web browser opens with this documentation as the home page. To keep the documentation available, open a new tab in the browser for accessing node-red. Finally, point the web browser to the node-red server by typing the following URL into the browser

127.0.0.1:1880

This looks a bit different to the kind of URLs you usually see. 127.0.0.1 is the Internet Protocol (IP) address that always points to your own machine. Once we connect the computers together in a network, each machine will have its own IP address. The 1880 is known as the port number.

You should now have a screen that looks like this

Linux node red

and we are ready to look at some node-red basics.