×
IoT platform 
About us 
Media 
Documentation 
Courses 
Downloads 
Forum 
DIY 
Wazihub 
Work with Us 
 

WaziCloud Dashboard User Manual

You can build a full application with Waziup, without programming! In this tutorial, we’ll learn how to build a soil monitoring application able to display the soil moisture and to send notifications on SMS, twitter and voice messages. This documentation is available in PDF format.

Login

The first thing you need to do is to create a login and a password. You should already have a gateway and a sensor node ready and configured. If not, please check this section.

login
login

You can create a new account by clicking on “Register” of by using a social network OpenId procedure. All communications will be secured by SSL.

Step #2: fill in the fields.

register
register

You will receive an email to confirm your registration. Once registered, you can now log in.

IMPORTANT: Once created your login and password, you need to insert them in your gateway!

Devices

Clicking on the “Devices” menu entry will lead you to the devices page. If this is your first time on Waziup, you should not have any devices here:

no_devices
no_devices

At this point, you have two choices:

  1. Let your gateway create the devices for you,
  2. Create your devices manually.

The Waziup gateway will automatically create devices on the WaziCloud dashboard for you. So, if you have a WaziGate, you should already be able to find your devices in this page! For example, your WaziDev should be listed here.

Devices page
Devices page

Each device contains a certain number of sensors and actuators (that are often connected to the device board with some wires). Active sensors are displayed in green, and unactive sensors are in red. A sensor is deemed unactive if it doesn’t send data after 12 hours.

You can filter the list by domain, visibility or status. If you have a lot of devices, you can often find the one you are looking for by filtering by “Active” or “New”. A device is showed as “New” if it has been created in the last 24 hours.

Manual creation

If you want to create your devices yourself on the dashboard, follow this procedure:

Step #1: Click on “Settings” menu.

You will get this screen:

Settings page
Settings page

Step #2: Activate the “Allow manual creation of gateways and devices” option.

This option will allow you to create your own devices.

Step #3: Come back on the devices screen and click on “Add a device” button:

Add a device
Add a device

Step #4: You can now fill in the details of your device.

Device creation
Device creation

On this screen, you can fill in the fields:

  • Device ID
  • Device name
  • Domain
  • Visibility
  • Gateway

The Device ID is the most important. It is a unique ID (across all Waziup Platform) referencing your device. For instance, it will be used by sensors to push data to your device, or applications to retrieve data from this device. Choose it wisely!

The Device name is optional, it is a human-readable name for your device. For example, you can set it as “My garden device”. The Domain is optional, it can be setup to group your devices by use cases, such as “Agriculture”. Visibility can be set to either Public or Private. A Public device can be seen by anyone, while a Private device can be seen only by you. For your first devices, it is advised to set them to “Public”, they will be easier to share with friends. Gateway contains the gateway ID that transmitted this device. It is optional.

Device details

Click on one of your devices. The following page will show you more details.

Devices details
Devices details

In this screen, you can see the details of your device, with its sensors and actuators. You can edit your device, input the following:

  • Name
  • Domain
  • Visibility
  • Gateway

The name of you device is important. You should change it as soon as you can, to something significant such as “My weather station”. The domain allows you to group your devices by topics, such as “Agriculture”. You can also set the gateway that is associated with your device. You normally don’t need to do that, since your gateway will do it automatically.

Finally, using the map you can change the location of your device.

map
map

You can update the position of you device by clicking “Change”. You can update your location with three methods:

  1. Click and drag the pointer on the map,
  2. Click on “Get your location” (only available on some browsers),
  3. Enter your GPS coordinates directly.

Sensors

Click on one of the sensors to open the sensors details page.

Sensor details
Sensor details

Remember that the sensors are automatically created by the gateway. However, we need to “enrich” our sensor by providing some metadata. Click on the little pen icon next to the sensor. This will allow to set up:

  • a sensor name
  • a sensing device. This is the kind of physical sensor used: a temperature sensor, a soil moisture sensor…
  • a quantity kind. This is what you are really measuring with the sensor. For example, air temperature or water temperature?
  • a unit of measurement.

Setting up this metadata is not mandatory, however is it much better to get if you want to exploit your data on the long term. It will also allow you to create nicer graphics.

Gateways

In this section, we’ll learn how to connect and configure your gateway on the Waziup Dashboard. If you install the WaziGate, it should already appear in this page.

Gateways list
Gateways list

The small symbol next to the gateway icon shows if your gateway is currently connected. It should appear green if connected. Now click on your gateway to open the details page.

Gateways list
Gateways list

The details page shows the name, privacy and ID of your gateway. It also shows all the devices that are connected to that gateway. You can click a device to navigate to that device.

You can open the own Gateway UI by clicking on the “Remote access” button. This will open the login screen for your gateway UI.

Finally, you can edit the parameters of your gateway and delete it, using the corresponding buttons.

Notifications

The notifications allow you to program SMS or Twitter messages, triggered by events on your sensors. For instance, if a sensor value becomes too high, a SMS will be sent to the user. The notification list is shown below.

Notification page
Notification page

For each notification, you can see its name, ID, sensor name and condition. Let’s create a notification for your sensor! Click on the “Add notification” button.

New notification
New notification

You need to select your sensor id in the list, and then the measurement id. For instance, select MySensor and TC, to make a notification on the temperature measured by MySensor.

The next field contains the condition for sending the message. Examples of expressions include “TC==10”, “TC==10..30”, “TC>30”, “Color==orange,red”. The list of operators is: “==”, “!=”, “>”, “<”, “>=”, “<=”. Several conditions can be concatenated with “;”, for example: “TC>30; HUM<20”. The Message field contains the message to be sent to the user. It can contain variables, which will be replaced by their values when the message is sent. For example, you can include the current value of a sensor in the message with “Field sensor value is ${TC}”.

The next step is to select the users you want to send it to. Select your own username here. Finally, select the social media to send one. Remember, your account need to be configured with your phone number and Twitter account to receive messages.

Once this is done, you can validate. You should be able to see your notification in the list. You can click on that notification to view the details.

New notification
New notification

Did you receive anything? You should see the number of times this notification was sent, and the time for the last sending in the box “Status”.

Projects

A project allows you to get all your assets in the same place: gateways, devices, notifications, maps, graphics… The first thing to do is to connect your gateways and devices. Once they are connected, you can click on the button “Create a project”.

Project form
Project form

After completing all the steps, your project is ready! You can see on this screen the status of your devices and gateways.

Project resources
Project resources

If your devices are positionned, you should see them on the map. Finally, all devices and sensor values are displayed on the graph.

Project map
Project map