1) Download the library above (includes examples) and unzip it inside your "libraries" folder of your Arduino IDE.

2) Open a main sketch with your code from where you will make use of the write() and read() functions of the library. You can use ReadOneSignal.ino or WriteOneSignal.ino as good start points for your sketch

3) Place your account token in the variable of your sketch. Also define the variables with your wifi SSID, wifi password and with the key you want to write/read at Circus.

For the different scripts to work you will need to set up the global environment variable CIRCUSTOKEN which will let the server recognize you as a valid user.

Place it at the end of your /etc/bash.bashrc file, like this:

To find your token, log in, go to up-rigth corner photo and select account.

Follow the next steps to get get the circus commands described above available in your Raspberry.

• Make a temporary file and get in it
  sudo mkdir ~/temp
  cd ~/temp
• Get the debian package with all you need from our site
  sudo wget https://circusofthings.com/deb/raspi/CircusRaspiLib.deb
• Unpack it and let it be installed
  sudo dpkg -i CircusRaspiLib.deb
• Give permissions to the new files to be executable by your user
  
  sudo chmod 755 /usr/local/bin/circus*

Once you end with the steps above, these are the available commands in linux:

Now you are done, you can use our Circus commands.

Remember when you access your raspi GPIO pins that these have to be set as input/output in accordance with the command you are going to run. For instance, if your are going to write what is shown in a signal in Circus to your GPIO 8 using circussignaltopin command, GPIO 8 has to be set as an output

Setting GPIOs as input/output from command line is clearly described here

But, you can also use the -F option from commands. In that case, you should run them preceeded by sudo -E

Just read the temperature in Celsius degrees in Madrid, as we have a device feeding the signal with key 943874351

I use it to post my deposit desired level on 110cm at the signal with key=137572561 and my pump controller will read it there to fix it

For the different scripts to work you will need to set up the global environment variable CIRCUSTOKEN which will let the server recognize you as a valid user.

Place it at the end of your /etc/bash.bashrc file, like this:

To find your token, log in, go to up-rigth corner photo and select account.

Follow the next steps to get get the circus commands described above available in your Raspberry.

• Make a temporary file and get in it
  sudo mkdir ~/temp
  cd ~/temp
• Get the debian package with all you need from our site
  sudo wget https://circusofthings.com/deb/raspi/CircusRaspiLib.deb
• Unpack it and let it be installed
  sudo dpkg -i CircusRaspiLib.deb
• Give permissions to the new files to be executable by your user
  
  sudo chmod 755 /usr/local/bin/circus*

Once you end with the steps above, these are the available commands in linux:

Now you are done, you can use our Circus commands.

Remember when you access your raspi GPIO pins that these have to be set as input/output in accordance with the command you are going to run. For instance, if your are going to write what is shown in a signal in Circus to your GPIO 8 using circussignaltopin command, GPIO 8 has to be set as an output

Setting GPIOs as input/output from command line is clearly described here

But, you can also use the -F option from commands. In that case, you should run them preceeded by sudo -E

Just read the temperature in Celsius degrees in Madrid, as we have a device feeding the signal with key 943874351

I use it to post my deposit desired level on 110cm at the signal with key=137572561 and my pump controller will read it there to fix it

Will show wheter is raining or not in Madrid flashing a led in my local GPIO 6. Note that -F option will force GPIO 6 to be an output.

Now, we try just the same but setting port mannually

This is the code I use to feed my signal Is it rainning in Algaida? from the open/closed contact of my rain sensor connected to my Raspberry on GPIO 4

I made a class named IncreasingValue which is used to feed the Increasing value posted at Circus for test purposes.

package com.circusofthings.examples.javaclient;

import com.circusofthings.api.ver110.CircusLib;
import org.json.JSONObject;

public class IncreasingValue extends Thread
{
    private final String key;
    private final String token;
    private static final long FREC = 20000L;

    public IncreasingValue(String key, String token)
    {
      this.key = key;
      this.token = token;
    }

    public void run()
    {
        CircusLib commands = new CircusLib(token);
        double value = 0;
        for (;;) {
            value++;
            if(value>1000){value=0;}
            JSONObject json = commands.writeValue(key, value);
            System.out.println(json.toString());
            try {
                Thread.sleep(FREC);
            } catch (InterruptedException ex) {
                Thread.currentThread().interrupt();
            }
        }
    }
}
                

It can be run adding this two lines in your code:

Note! Only public signals can be embeded in a web (no token is needed).

1) Invoke the downloaded circuslib.js script (right before closing BODY tag). Do the same with jquery lib:

2) Place this DIV in your HTML code, one for each signal to show, pasting key where asked, like this:

    <div class='circus' id='your_key_here'>
        <div class='value'>
            <!--VALUE will be placed here-->
        </div>
        <div class='location' style='display:none'>
            <div class='loclabel'>Latitude: </div><div class='lat locelement'><!--LAT will be placed here--></div>
            <div class='loclabel'>Longitude: </div><div class='lon locelement'><!--LON will be placed here--></div>
            <div class='loclabel'>Altitude: </div><div class='alt locelement'><!--ALT will be placed here--></div>
            <div class='loclabel'>Is moving: </div><div class='ismobile locelement'><!--ISMOBILE will be placed here--></div>
        </div>
    </div>
                

Note: if location is set to style='display:none' this div won't show and no queries about location will be done in order to free browser's load. Turn it to style='display:block' to work

3) Invoke function pollCircus() once. For instance, when your page loads, in the BODY tag:

optional) Give it some style, include this css file in your header

Of course, it's just an idea... feel free to change it

In the example example_js_randomsignal there is displayed a single value from the signal Random Signal ignoring any location data (style='display:none')

In the example example_js_madridtemp there is displayed a temperature from the signal Temperature in Madrid reading location data (style='display:block')

You can send data within or from Second Life and connect it to your real life gadgets and apps.

It can be done fast with some ready-to-use scripted objects you can get in the Marketplace.

Or you can make your own objects inside SL using its LSL language to communicate.

A sample of this object can be used in our parcel.

This Transmitter object will send from SL signals to circusofthings.com. circusofthings.com is a platform where the values of sensors from RL, or values from apps or metaverses can be published or read. This means it may let you connect physical devices (Arduino, Raspberry or any kind) among them, or with second life or with a web. The possibilities are infinite. So, use this transmitter to send a signal defined by a "key" that is published in circusofthings.com. You will need a valid account there to have a "token" that identifies you. (When you want to read values at Circus rather than feeding it, use our available "Circus_Receiver") ------------------------------------------ Usage ------------------------------------------ Touch the device to get the main menu. Press "configure" to set the proper params. You will see the parameters as they actually are set. "KEY" identifies the signal published at Circus that you want to feed/write. "TXCHANNEL" is the local channel in SL where the transmitter will listen for a pair key/value to post at Circus. "RESPONSECHANNEL" is the local channel in SL where the server response will be shown. Set any of the above params pressing its button. PLEASE REMEMBER: To set a valid token provided in the account at circusofthings.com. You or your scripted object has to write on TXCHANNEL: [key_of_target_signal] [space_character] [float_value_to_post_at_signal] for instance: "23780 100" (without quotes), means "write value 100 for signal published at Circus identified by key 23780" ------------------------------------------ Goal ------------------------------------------ Type or send from objects values from SL to RL.
This receiver object will get in SL the signals from circusofthings.com. circusofthings.com is a platform where the values of sensors from RL, or values from apps or metaverses can be published or read. This means it may let you connect physical devices (Arduino, Raspberry or any kind) among them, or with second life or with a web. The possibilities are infinite. So, use this receiver to read a signal defined by a "key" that is published in circusofthings.com. You will need a valid account there to have a "token" that identifies you. (When you want to publish/change values at Circus rather than reading it, use our available "Circus_Transmitter") ------------------------------------------ Usage ------------------------------------------ Touch the device to get the main menu. Press "configure" to set the proper params. You will see the parameters as they actually are set. "KEY" identifies the signal published at Circus that you want to read. "VALUECHANNEL" is the local channel in SL where the read value will be broadcasted. "LABELCHANNEL" is the local channel in SL where the label of signal defined by the publisher will be broadcasted. "UNITSCHANNEL" is the local channel in SL where the units of signal defined by the publisher will be broadcasted. "DESCRIPTIONCHANNEL" is the local channel in SL where the description of signal defined by the publisher will be broadcasted. "Refresh rate": Defined in seconds. Is the period of each scan for a new Value at Circus. It can't be less than 5 seconds. You may to make it bigger to optimize lag in your parcel. Set any of the above params pressing its button. PLEASE REMEMBER: To set a valid token provided in the account at circusofthings.com. ------------------------------------------ Goal ------------------------------------------ Use the broadcasted value from RL to trigger actions on other objects in SL. For instance, you can use a "Circus_Monitor" to display the values in RL.
This Monitor object will display what is broadcast from a "Circus_receiver" that is getting info from circusofthings.com. circusofthings.com is a platform where the values of sensors from RL, or values from apps or metaverses can be published or read. This means it may let you connect physical devices (Arduino, Raspberry or any kind) among them, or with second life or with a web. The possibilities are infinite. So, use this monitor to display what is heard from the channels you set. Note: It can be used as a universal monitor if you or your object sends the messages to be displayed in proper channels. Hovewer the length and layout is strongly designed to use with a a "Circus_Receiver" ------------------------------------------ Usage ------------------------------------------ Touch the device to get the main menu. You will see the parameters as they actually are set. "KEY" identifies the signal published at Circus that you want to read. "VALUECHANNEL" is the local channel in SL where the read value will be heard. "LABELCHANNEL" is the local channel in SL where the label of signal defined by the publisher will be heard. "UNITSCHANNEL" is the local channel in SL where the units of signal defined by the publisher will be heard. "DESCRIPTIONCHANNEL" is the local channel in SL where the description of signal defined by the publisher will be heard. Set any of the above params pressing its button. Press "Signal info" to get the received description from publisher for this signal. ------------------------------------------ Goal ------------------------------------------ Use the "Circus_Monitor" to display what the "Circus_receiver" gets from RL