M2MLIGHT USER GUIDE
Version 1.3
Date: Oct 15 2018



1. Introduction
2. Register User
3. IP cameras
4. Sensors
5.
Actuators
6. Alerts
7. Subdomains
8. REST services and M2MData arduino library

9. Related links
10. Credits


1. INTRODUCTION


This platform is aimed at enthusiasts who have a basic knowledge of Internet of Thing (IoT) devices. M2mlight.com is a free basic platform service for IoT devices. You can store your cameras, sensors, actuators and alerts data in the cloud. Then, using your desktop or smartphone via the Internet, you can see the videos, graphs, maps and statistics of these devices.

Cameras, sensors and actuators can receive and send data using a microcontroller like Arduino, Raspberry Pi or Esp8266; and then, through a gateway or router can send this information to the m2mlight platform in the cloud.

HTTP and RTSP protocols are used for cameras; and, sensors, actuators and alarms use the HTTP and MQTT protocols

Examples of using this platform you can see in this link caletagreen.com.
 

2. REGISTER USER

In order to use this platform you need to register as a user using the option Login and then Register User.






A user account has the following main fields:
If you want to change your account information, including your password, you have to use the Account option.


3. IP CAMERAS

An IP camera is a device connecting directly to an Ethernet network.

The IP CAMERAS option allows you to manage your Ip cameras. You can add, delete and edit a camera. It permits you to stop and start the motion characteristic of a camera. Also, you can monitor and see camera videos.


With the second part of this dialog, you can add or register a new camera. The maximum number of cameras that you can register is 4.

A camera has the following required fields:

In the first part of this dialog, you will find the list of your cameras. Using the Edit button you can update the camera properties. With the Delete button you remove a camera and its motion registers; you need to confirm this previously. The Stop button allow to stop motion property and the Start button allow to start motion property.

Api_key is the unique identifier of the camera and you can not change this value.

The Status of a camera can be:
Daemons process check periodically each camera and set this status.

Using the Monitor button you can see online the camera and its motions videos of the last month.




With the Live Cameras Panel button, you can see all cameras on line.




4. SENSORS

A sensor is a device that detects changes in the ambient conditions and transmits this information. For example, there are sensors of temperature, light, humidity, motion, electric current, power consumption, etc.

The SENSORS option allows you to manage your sensors. You can add, delete and edit a sensor. With this option you define sensors that have periodically values: singles values or location values (longitude and latitude). In this platform, coordinates values obtained from GPS devices are considered sensors.

For a sensor, you can upload data and see its status. For example, you can see if the sensors values are out of range, according to defined min and max limits.

Also, you can display and download stored data, and see graphs of these data.






With the second part of this dialog, you can add or register a new sensor. The maximum number of sensors you can register is 10.
 
A sensor has the following fields:

If you define minimum or maximum value, after each insert of a new value the system checks if this value exceeded the defined range and it informs you with an email.

In the first part of this dialog, you will find the list of your sensors. Using the Edit button you can update the sensor properties. With the Delete button you remove a sensor and its register values; you need to confirm this previously.  The Stop button set the disable status and the Start button set the enable status.

The Status of a sensor can be:

Daemons process check periodically each sensor and set this status. If a sensor has not registered a value in the cloud in the last 10 minutes, the system changes its state and sends a email message to user if Email-messages property is enable.

For a sensor, the minimum interval between two inserted values is 10 seconds. Namely, if you try to insert a value in a range of less than 10 seconds, the value will not inserted.

Also, for a sensor, the minimum interval between two emails sent is 3,600 seconds (one hour). Namely, if there are continuous news, you will receive a separate email for at least one hour.

Api_key is the unique identifier of the sensor and you can not change this value. You can add sensor values using this api_key and the Server functions or M2MData library.

The Graphics button allow you to see line graphs of these data, graphs by 5 minutes, an hour, a day, a week or a month. These graphics work with most popular browsers: Chrome and Firefox.




Using the Data button you can display and download stored data.