Recipes are community-created content. They are neither monitored nor endorsed by IBM. If you find inappropriate content, please use Report Abuse to let us know. For more information on community content, please refer to our Terms of Use.

Overview

Skill Level: Any Skill Level

Basic Knowledge of Watson IoT Platform

In this recipe you will learn how to connect the Pressac EnOcean Gateway to the IBM Watson IoT Platform and visualize Pressac sensor data.

Ingredients

An IBM Bluemix account with a running instance of the Watson IoT service

A suitable web browser to connect to both IBM Bluemix and the Pressac EnOceanÂ Gateway configuration pages.

Detailed Information on how to register and manage your Bluemix account can be foundÂ here

A guide to getting started with the Watson IoT Platform can be foundÂ here

Step-by-step

Introduction

Pressac

Pressac is a privately-owned UK based business with a 60-year history of expertise in the design and manufacture of electrical and electronic solutions for the IoT, industrial and telecommunications markets. Pressac offers its own range of market leading products for the telecoms and building management industries. Our proven expertise and continued success has led a number of blue chip companies to choose Pressac as their preferred development partner and supplier. Pressac’s cutting edge product design and manufacturing facilities are based at the company’s headquarters in Nottingham, UK.

EnOcean

EnOceanÂ is a widely established and global technology, and has been installed in over 250,000 buildings worldwide. The EnOceanÂ wireless standard is the first to be ratified as an international standard – ISO/IEC 14543-3-10: together with the EnOceanÂ Equipment Profiles (EEPs) drawn up by the EnOceanÂ Alliance, this international standard lays the foundation for fully interoperable, open wireless technology comparable to standards such as Bluetooth and WiFi. The standard can be downloaded from www.iso.org.

IBM Watson IoT Platform

The IBM Watson Internet of Things Platform is a fully managed, cloud-hosted service that makes it simple to derive value from Internet of Things (IoT) devices. When combined with the IBM Bluemix platform, Watson IoT Platform provides simple, but powerful application access to IoT devices and data. You can rapidly compose analytics applications, visualization dashboards, and mobile IoT apps. Create IoT applications that feed insights to your backend enterprise applications.

Architecture

This recipe consists of 3 main components, a Pressac EnOcean radio protocol device e.g. CO2 Temperature and Humidity Sensor,Â Pressac EnOcean Gateway and the Watson IoT platform. The Pressac EnOcean deviceÂ is connected to the Pressac EnOcean Gateway via the EnOcean radio protocol, the Pressac EnOcean gateway facilitates the connection to the Watson IoT platform.

About the components

Pressac EnOcean Radio Protocol CO2, Temperature and Humidity Sensor

The Pressac Sensing wireless EnOcean CO2, Temperature and Humidity Sensor is designed to measure and report levels of Carbon Dioxide, ambient temperature and relative humidity in an internal environment. During normal operation, the sensor is powered from ambient room light: in prolonged low light environments, the security of battery back-up ensures continued operation for up to 10 years of maintenance free operation. This version of the sensor supports the open EnOcean standard (ISO/IEC 14543-3-10).

Pressac EnOcean Gateway

The Pressac EnOcean gateway serves as a bridge between the EnOcean radio protocol and a TCP/IP network. Availible in Ethernet only and Ethernet, LTE and WiFi varients the Pressac EnOcean gateway sends sensor data via MQTTÂ along with facilitating direct integration to cloud platforms including IBM Watson IoT platform. With an easy to use web-interface the Pressac EnOcean gateway makes managing your devices and cloud connections easy.

Step 1: Setting up the Pressac EnOcean Gateway

Plug in one end of the Ethernet cable into your network point and plug the opposite end of the cable into the Ethernet port on the Pressac EnOcean gateway.

Connect the EnOcean antenna along by screwing it onto the connection on the Pressac EnOcean Gateway taking care not to cross thread or bend. If your gateway supports LTE and WiFi attach the antennas for these aswell.

Connect your Pressac EnOcean Gatewayâ€™s power supply, connecting the power supply will boot up the Pressac EnOcean Gateway and you will seeÂ the products LED start blinking. The Pressac EnOcean Gateway will take a few seconds to initialise.

Next you need to find the IP Address of the Pressac EnOcean Gateway the most common way of doing this is to check your routers list of connected devices. If this is not possible the following alternative methods can be used.

Windows: The Pressac EnOcean Gateway announces itself over Universal Plug and Play (UPnP) and can be found in the â€śGatewaysâ€ť or â€śOther Devicesâ€ť section of the Windows Network area to find this area click â€śStartâ€ť search for â€śNetworkâ€ť and click â€śViewnetwork connected computers and devicesâ€ť. Double clicking a gateway from here will open up the web-ui.

Mac: The Pressac EnOcean Gateway can be discovered using Bonjour. One of the easiest ways of using this method is to open â€śSafariâ€ť go to â€śPreferencesâ€ť then â€śAdvancedâ€ť and tick â€śInclude Bonjour in the Bookmarks menuâ€ť close Preferences navigate to â€śBookmarksâ€ť and you will now see all your networked Bonjour devices including the Pressac EnOcean Gateway.

Now you have the IP Address you can use it to access the Pressac EnOcean Gateways web interface launch your chosen web browser and type http://<your-ip>Â e.g. http://192.168.1.188 This will display the Pressac EnOcean Gatewayâ€™s first boot wizard. Follow the steps on the wizard to set up your Pressac EnOcean Gateway for the first time.

Step 2: Add a Device to the Pressac EnOcean Gateway

Â

To learn-in a new deviceÂ click â€ś– Add Devicesâ€ť in the EnOcean sub-menu on the Pressac EnOcean Gateway web-interface and then click â€śStartâ€ť .

This will initiate a 60 second countdown, during these 60 seconds theÂ Pressac EnOcean Gateway will listen for the learn telegrams of devices in range of theÂ Pressac EnOcean Gateway. This process can be cancelled by clicking â€śCancelâ€ť and re-started for another 60 second duration by clicking â€śSearchâ€ť again.

Ensure theÂ Pressac EnOcean Gateway is listening for learn telegrams and press the â€śLearnâ€ť button on your Pressac device to locate the learn buttonÂ for your device please consult your devices manual.Â InÂ this example we will be using the Pressac CO2, Temperature and Humidity Sensor this devices learn buttonÂ can be exposed by removing the CO2, Temperature and Humidity Sensor back plate as shown in the image below.

Â

Â

A new device entry will now appear in a table with the following columns

LastÂ Seen – The Date and Time theÂ Pressac EnOcean GatewayÂ last received a telegram from the device

Click on “Edit and add” from the menu under the Action column as shown in the above image to edit theÂ device a new screen will appear as shown in the image below.

The only required field is the deviceÂ nameÂ this is the identifier which the IBM Watson platform will use for your device. It is advised to use a device name which resembles the function and location of the device.Â e.g. If your device is a CO2, Temperature and Humidity Sensor and it is situated in Classroom 1, your Device NameÂ could be â€śClassroom1-CO2-Temperature-Humidityâ€ť.

Other optional properties include the location of your physical device. Please note that only characters A-Z, numbers, ‘_’ and ‘-‘ are permitted to be used in any of these fields.

Once you have specified your desired device nameÂ and any of the other optional properties click â€śSaveâ€ť at the bottom of the screen to save the entry.

You can now navigate to the Devices page and see the deviceÂ along with its last state.

Â

Step 3: Configuring the IBM Watson IoT Platform

Create Gateway Device Type

Each Gateway connected to IBM Watson IoT Platform is associated with a device type. For theÂ Pressac EnOcean Gateway to communicate with the IBM Watson IoT Platform we need to create its device type. Please follow the steps below for which you will need a Bluemix account with a running instance of the IBM Watson IoT platform.

From the IBM Watson IoT Platform dashboard click â€śDevicesâ€ť from the left menu then the â€śDevice Typesâ€ť tab then finally the â€ś+ Create Typeâ€ť button as shown in the image below.

Â

You will now be presented with 2 options â€śCreate device typeâ€ť and â€śCreate gateway typeâ€ť as shown in the image below. Click on â€śCreate gateway typeâ€ť

The screen should now automatically proceed to the â€śGeneral Informationâ€ť screen as shown in the image below. In the â€śNameâ€ť field type â€śEnOceanâ€ť this will be the name of ourÂ Pressac EnOcean Gateway Device Type.

Click â€śNextâ€ť located at the bottom right of the page you should now see the â€śDefine Templateâ€ť screen from here you can select attributes for the device type all attributes are optional and for the sake of this recipe we arenâ€™t going to select any.

Click â€śNextâ€ť the Submit Information screen will now appear, if you defined any of this information in the previous step you can confirm it is correct at this point.

Click â€śNextâ€ť the optional Metadata screen will now appear again we will not be defining any.

Now Click â€śCreateâ€ť in the bottom right corner of the screen. You will now be taken back to the Devices Dashboard area of the IBM Watson IoT Platform witch should now have a confirmation message of our device type being successfully created and our new entry of â€śEnOceanâ€ť under â€śDevice Typesâ€ť.

Add Pressac EnOcean Gateway to IBM Watson IoT Platform

Once added Gateway devices can register new devices to the IBM Watson IoT Platform then facilitate the sending and receiving of data on behalf of devices connected to them such as our CO2, Temperature and Humidity Sensor. Register your Pressac EnOcean Gateway by following the below steps.

From the IBM Watson IoT Platform dashboard click â€śDevicesâ€ť from the left menu then the â€śBrowseâ€ť tab then finally the â€ś+ Add Deviceâ€ť button as shown in the image below.

Select the â€śEnOceanâ€ť â€śDevice Typeâ€ť we made in the previous step and click â€śNextâ€ť in the bottom right corner of the screen.

A new screen will appear as shown in the image below asking for Device Info in the â€śDevice IDâ€ť field put â€śEnOcean-Gatewayâ€ť this will be the name of our Pressac EnOcean Gateway on the IBM Watson IoT Platform. Once complete click next in the bottom right corner of the screen.

Next is the Optional Metadata screen shown in the image below we leave this screen blank and click â€śNextâ€ť.

In the Security screen we are given the option to provide an authentication token if a token is not provided the IBM Watson IoT Platform will generate one for us. Leaving the field blank click â€śNextâ€ť.

Finally, we are shown a summary of the options we chose throughout the creation process Verify the details and Click â€śAddâ€ť in the bottom right corner of the screen.

The Gateway is now registered; on your screen, you will now see your registration details which need to be added to the Pressac EnOcean Gateway be sure to make a note of them once you are finished click the â€śXâ€ť in the top right corner to return to the IBM Watson IoT Dashboard.

You will now see the â€śEnOcean-Gatewayâ€ś in your list of devices as shown in the image below.

At this point your â€śEnOcean-Gatewayâ€ť device will be displaying a disconnected icon Â this is because we are yet to connect it to our Pressac EnOcean Gateway.

Step 4: Connecting the Pressac EnOcean Gateway

Go back to the Pressac EnOcean Gateway web interface and click the â€śIBM Watson IoTâ€ť entry on the main menu under connections thenÂ from the dropdownÂ at the side of â€śConnectionâ€ť select â€śOnâ€ť and input the IBM Watson IoT Platform registered gateway credentials we took a note of from the previous step and click â€śSaveâ€ť.

Connection will now start if everything goes well you will see the state change to â€śConnectedâ€ť your gateway is now ready to send events from your Pressac deviceÂ to the IBM Watson IoT Platform.Â

Navigate back to your IBM Watson IoT Dashboard and select â€śDevicesâ€ť from the left menu you will now see the â€śEnOcean-Gatewayâ€ť shows as connected Â and it has added our CO2, Temperature and Humidity Sensor as a device .

On the IBM Watson IoT Platform dashboard click â€śBoardsâ€ť on the menu then the â€ś+ Create New Boardâ€ť button as shown in the image below.

A pop up will appear asking you to give a name to your new board in the field marked â€śBoard Nameâ€ť type the name you want to give your board we have called ours â€śClassroom 1 CO2, Temperature and Humidity Sensorâ€ť click â€śNextâ€ť.

The next screen will ask you to define other members of the board (if any) to add another member to the board click â€ś+ add user IDâ€ť once finished click â€śCreateâ€ť

Now you will see your new board in the â€śyour boardsâ€ť section as shown in the image below to access your new board click on it.

Your new board will be empty click on the â€ś+ Add New Cardâ€ť button at the upper right of the screen.

You will now be asked to select a card type for this example we will be using a â€śGaugeâ€ť

For this example, we are going to display the CO2, Temperature and Humidity Sensors concentration value to do this we defined the following field values.Â The field values required for your device may vary, if data is availible clicking into the fields will list availible options.

The Precision, Min and Max can be changed to suit your requirement for this instance we have left them as default. When finished click â€śNextâ€ť

Now select the size you want to display the Gauge we have selected â€śLargeâ€ť once you have selected click â€śNextâ€ť

Now we give our new card a title and select a colour we have gave ours the title of â€śClassroom 1 Concentrationâ€ť and selected Blue as the colour once you are finished click â€śSubmitâ€ť

You will now be taken back to the Board you created in the IBM Watson IoT PlatformÂ and canÂ now see your newly created card showing the data from your Pressac device for our example we can see our concentration value of the CO2, Temperature and Humidity Sensor in a gauge format.

These steps can be repeated to add other device data to your board for example we can display the additional Temperature and Humidity values availible from our CO2, Temperature and Humidity Sensor.

If any of the properties for your devicesÂ are not being displayed it may be because the Watson IoT Platform has not yet received event data for the property. Once the deviceÂ sends a telegram containing the required values they will be show.