Raspberry Pi Cayenne
In this tutorial I will be looking at how to setup Raspberry Pi cayenne. This is a pretty simple process and will give you access to a powerful IoT software package. If you’re a fan of sensors, collecting data and the overall concept of IoT then this is for you.

There are quite a few features and things you’re able to do with this software but to keep things relatively simple and straightforward I will just touch on the basics in this tutorial. I will be looking at doing further projects using this software in the near future.

One thing that you will probably like especially if you’re a beginner is that you don’t need to do any coding to get a project up and running. All you need to do is connect the sensors up correctly and add the sensors/devices in cayenne. In cayenne itself you can create triggers , events, monitoring widgets and much more.

If you want to see this done visually then be sure to take a look at the video below. I go through all the steps to setting the software up correctly and how you can start building cool projects.

Equipment

Below is all the equipment that you will need for setting up myDevices Cayenne for the Raspberry Pi. You may need extra parts if you’re looking to add more sensors, devices and anything else that you want connected to your Pi. You will also need to make sure you have an internet connection for the Pi.
Required:

Optional:

Installing Raspberry Pi Cayenne

The process of installing Cayenne onto the Raspberry Pi is pretty simple and shouldn’t take you too long to get it up and running. You will need to make sure you have Raspbian installed on your Pi. If you’re unsure how to do this, then be sure to check out my tutorial on setting up Raspbian.

  1. Firstly, head over to myDevices Cayenne and sign up for a free account.
  2. Once you’re signed up you will need to register/connect the Pi up to the account you just created. To do this simply copy the 2 command lines shown after you sign up. Enter these into the terminal for your Pi. (These files are unique for every new install)

Sign Up Screen
Alternatively, you can download the app and it can automatically locate & install Cayenne onto your Pi.(Keep in mind SSH needs to be enabled)

  1. It will take a few minutes to install onto your Pi depending on how fast your internet connection is. The web browser or app should automatically update with information on the installation process.
  2. Once installed the dashboard will display and should look like something below.

Pi cayenne dashboard

Setting up your first sensor

In this example I am going to setup a temperature sensor. The sensor that I use is called DS18B20 and is the same sensor I did a tutorial on not that long ago. Now if you remember the process of setting this up was a little more in-depth but using cayenne makes it super simple.

All you need to do is setup the circuit and have it connected up to the Pi. If you need the full tutorial on how to do this then be sure to check out my Raspberry Pi DS18B20 tutorial or if you know what you’re doing just check out the circuit diagram below. I also added an LED that is connected to pin #17 with a 100 ohm resistor to the ground rail.
Raspberry Pi Temperature Sensor Diagram
Now when I set this up the sensor was automatically detected and added to my dashboard. Which is pretty cool however if it didn’t add automatically then you will need to add it manually. To add it manually simply, do the following.

  1. Go to add new in the upper left corner of the dashboard.
  2. Select device from the dropdown box.
  3. Find the device, in this case it is a DS18B20 temperature sensor.
  4. Add all the details for the device. In this case you will need the slave address for the sensor. To get the slave address enter the following into the Pi’s terminal.
    cd /sys/bus/w1/devices
    ls
  5. The slave address will look similar to this 28-000007602ffa. Simply copy & paste this into the slave field within Cayenne dashboard.
  6. Once entered select add sensor.
  7. The sensor should now be displayed on the dashboard.
  8. If you need to customise your sensor press the cog and it will come up with some options.
  9. You can also see stats/graphs. For example, the temperature sensor can plot data in real time and will keep historical data too.

If you want to also add an LED that you can turn on & off via the dashboard follow the next few instructions.

  1. Now let’s add one more device. Except this one will be an LED.
  2. So go back to add new device.
  3. Now search for digital output and select it.
  4. For this device select your Pi, widget type is button, icon can be whatever you want, and then select integrated GPIO. Finally channel is the pin/channel that our LED is connected to. For this example it is pin #17. (This is the GPIO numbering of the pins).
  5. Now press the add sensor button.
  6. You can now turn the GPIO pin high & low from the dashboard and also use it in a trigger.
  7. We’re now ready to set up our first trigger.

You should now have two devices on your dashboard that should look something like this.
Added Devices
If you’re completely new to setting up sensors and using the GPIO pins then it might be worthwhile checking out my guide for the GPIO pins on the Raspberry Pi.

Setting up your first trigger

Triggers in Cayenne are a way to have your Pi react to a certain change on the Pi itself or through a sensor attached to it. This could be something as simple as a temperature exceeding a certain value or even just your Pi going offline. As you could imagine this can be quite powerful in creating smart devices that react to the surroundings. For example, If the room gets too cold, then turn a heater on.

The process of adding a trigger is super simple and I will go through the basics of getting a couple setup.

  1. Go to add new in the upper left corner of the dashboard.
  2. Select trigger from the down box.
  3. First name your trigger, I will call mine “too hot”.
  4. Now drag and drop your Raspberry Pi from the far left corner into the if box.
  5. Underneath this select the temperature sensor and have checkbox next to “temperature above” selected. (If device options don’t display simply refresh the page)
  6. Now in the then box select notification and add an email address or your phone number for a text message (You can add both). Make sure you tick the checkboxes as well.
  7. Trigger Too Hot

  8. Now click “save trigger”.
  9. It should now be saved and will send you an alert whenever the temperature sensor is over 40 degrees Celsius.
  10. You can also drag the Raspberry Pi into the then box and have it do many things including controlling output devices. For example, in my circuit I have an LED that will be turned on when the temperature exceeds 40 degrees Celsius.
  11. To make the LED trigger click on new trigger located in the upper part of the page. Name this trigger activate LED.
  12. Now drag the Pi into the if box and then select the temperature sensor again with 40 degrees above Celsius.
  13. Now drag the Raspberry Pi into then box. Select our digital output and have the on checkbox ticked.
  14. Now click on save trigger.
  15. Now whenever our temperature sensor connected to the Pi reports a temperature above 40 degrees Celsius it will send an email and turn on the LED. You will also need to add another trigger to turn the LED off when it drops back below 40 but I will leave that for now and move on to events.

mydevices cayennem Triggers

Events

Events in Raspberry Pi Cayenne is somewhat similar to triggers but they are time dependent rather than relying on a change in a sensor or the device itself. Setting up an event is pretty easy, I will just quickly go through how to setup your Pi to restart once a month.

  1. Go to add new in the upper left corner of the dashboard.
  2. Select event from the down box.
  3. You should now see a screen with a calendar and a popup called new event.
  4. Enter the details of your event. For example, mine is called restart monthly and will happen on the first of every month at 2am. Below is an example of the screen.

cayenne events with details

  1. Once done, click on save.
  2. You should now be able to see your event on the calendar. Simply click on it if you wish to edit it.

As you could imagine events can be pretty powerful so it would be worth looking into these more. A good example of using events would be if you need something to run or turn on. A good example is something such as lights needing to be turned on at a specific time.

GPIO Panel

The GPIO panel within Raspberry Pi Cayenne allows you to control and alter the pins on the Pi. For example, you can turn a pin from being an input to an output and vice versa. You can also turn output pins both low & high.
Cayenne GPIO Panel
As you can see it also makes for a great reference sheet if you need to refer back and see which pins are the ones you need. You can also see the devices that are currently assigned to specific pins. You’re also able to see the current status of a pin. (e.g. Input or output & low or high)

Remote Desktop

I have touched on connecting remotely to the Pi twice before. The first time was via secure shell and the second was setting up VNC viewer. If you install cayenne you can also remote desktop to your Raspberry Pi through either the web browser or via the mobile app. You can do this by simply doing the following.

  1. On the dashboard find the widget that says “commands”.
  2. Within this widget click on remote access.
  3. It will now connect to the Pi and open a new window. If a new window doesn’t open your browser most likely blocked it. Simply allow cayenne.mydevices to open new tabs.
  4. Once done you can control your Pi like as if you were there with it.
  5. One of the pros with using Cayenne for remote desktop is that you can access it anywhere in the world quite easily rather than needing to setup a VPN or open up ports on your network.

Future possibilities

Cayenne is still relatively new and has so much more coming in the future. It is already jam packed full of features. I have read of future integrations with the Pi camera and other devices. This would open up to some pretty cool projects.  As I mentioned earlier I will be looking at doing more with Cayenne in the near future as home automation has been something I have been wanting to cover for some time now.

I hope you have been able to get myDevices Cayenne installed onto your Raspberry Pi without any issues. If you haven’t already then be sure to go sign up, register a device over at their website. If you do come across anything that I should’ve mentioned, have feedback or anything else then please feel free to leave a comment below.

Share This!
The Raspberry Pi Crash Course

The Raspberry Pi Crash Course

Enter your email address below to get the

Raspberry Pi crash course delivered straight to your inbox

Please check your inbox for a confirmation email!