1. Demonstration high level architecture
Lighting control based on luminosity level using oneM2M platform.
The following tools are required to run this demonstration.
- JAVA 1.8
- Arduino IDE 1.8.5 or Eclipse IDE (Version Neon along with "Eclipse C++ IDE for Arduino 2.0" plug-in)
- Your favorite IDE
- Postman (Optional)
3. Download the project
Download the oneM2M demo project from Github from the following link:
The project contains the following folders:
4. Start oneM2M platform instance
The oneM2M platform is available on folder “oneM2M Platform”
4.1. Configure the platform
You can keep the default configuration for a local demonstration. The platform will listen on ports 8080 and 8443. The database is reset after each restart.
If needed, you can change the configuration of the platform by editing the file “configuration/config.ini”.
4.2. Start the platform
Start the platform by executing the "start.bat" script on Windows or "start.sh" on Linux and Mac OS.
4.3. Login to oneM2M web interface
Open the following URL in your browser to access the oneM2M platform web interface: http://127.0.0.1:8080/webpage
Enter "Cae-admin" as originator then click on “connect” .
5. Connect your IoT Device
The arduino source code and required libraries are available on the folder onem2m-device.
Connect the LED and luminosity sensor to the Nodemcu board using the following components:
- Nodemcu board
- Luminosity Sensor
- 1Kohm resistance
NOTE about using Eclipse: If you would rather use the Eclipse IDE for your Nodemcu application development there is another Hackster.io project that details how to develop Arduino type projects within Eclipse. If interested the project name is "Using Eclipse Arduino plug-in with ESP8266 NodeMCU board" and can be found at https://www.hackster.io/dallas-onem2m/using-eclipse-arduino-plug-in-with-esp8266-nodemcu-board-cb77ef . Be sure to complete the application Wi-Fi configuration as detailed in step "5.5. Configure the oneM2M sketch" in this document. At the completion of that "how to" and the configuration changes you should be able to continue this project at step 5.9.
5.2. Download and install arduino IDE
Download and install the Arduino IDE v1.8.5 from the following link:
NB: We don’t recommend to use the Arduino Web Editor for this demonstration because the nodemcu board is not supported.
If the NodeMCU port is not detected, then you need to download and install the USB driver manually using the following link:
5.3. Add Nodemcu board to Arduino IDE
Firstly open the Arduino IDEGo to files and click on the preference in the Arduino IDE
Copy the below URL in the Additional boards Manager URLS
click OK to close the preference Tab.
After completing the above steps , go to Tools and board, and then select board Manager
Navigate to esp8266 by esp8266 community and install the software for Arduino.
Go to Tools and board, and then select "NodeMCU 1.0" board.
Once all the above process been completed you are ready to program the nodemcu board with Arduino IDE.
5.4. Add Arduino “Timer.h” library
The “Timer.h” library is available on the zip folder “Timer-master.zip”.
Go to Sketch, and then select “include library”.
Chose the “Add .ZIP library” option
Select the zip folder “Timer-master.zip” then confirm.NB: You don’t have to extract the zip content.
5.5. Configure the oneM2M sketch
Open the sketch “onem2m-adn.ino” in your Arduino IDE.
Set your WIFI parameters
- const char* ssid = "XXXXXXXX";
- const char* password = "XXXXXXXX";
Set the IP address of the oneM2M platform
- const char* host = "XXXXXXXX";
5.6. Compile the oneM2M sketch
Click on verify button to compile the sketch.
5.7. Upload the oneM2M sketch to Nodemcu board
Click on upload button to upload the sketch to the nodemcu board.
5.8. Debug the code execution using serial monitor
Click on button to open the Arduino Serial Monitor to display the Nodemcu console.
Then after opening the Serial Monitor select 115200 from the drop-down list.
5.9. Check IoT device resources on oneM2M web interface
You should see “mydevice1” Application Entity resource with “luminosity” and “led” containers created on the oneM2M web interface.
6. Connect your IoT application
The luminosity monitoring application source code is available on the folder onem2m-app
6.1. Configure application
Set the IP address of the oneM2M platform. You can keep localhost if you are running the oneM2M platform and the application in the same machine.
6.2. Start the application
Install the following node modules using the npm tool:
> npm install express
> npm install request
Start the nodejs oneM2M application using the following command:
> node onem2m-monitor.js
6.3. Check IoT application resource on oneM2M web interface
You should see “mymonitor1” Application Entity resource created on the oneM2M web interface.
If you hide the luminosity sensor with your hand for few seconds, you should see the led switched ON by the monitoring application and vice versa.
8. Additional oneM2M resources
- onem2mlib by Andreas Kraft .This Python3 module implements a library to access and manage resources on a oneM2M CSE. https://github.com/ankraft/onem2mlib
- oneM2M developer guide: http://www.onem2m.org/application-developer-guide