nCube Thyme Arduino

nCube-Thyme-Arduino

Introduction

nCube-Thyme-Arduino is a light version nCube for arduino devices. The project name: “nCube-Base”. nCube-Base is a type of AE(oneM2M Resource Type) in software level.

Hardware

• Arduino Zero + WiFi Module or Adafruit Feather M0 WiFi Board

Connectivity

The sample source introduces how to use Adafruit Feather M0 WiFi Board to connect CO2 sensor, RGB LED light connect to Mobius server platform.

• CM1106 CO2 Sensor
• RGB LED Module

Service Endpoint (URL):

http://ota.iotocean.org:8730

nCube-Thyme-Arduino

Introduction

nCube-Thyme-Arduino is a light version nCube for arduino devices. The project name: “nCube-Mint”. nCube-Mint is a type of AE(oneM2M Resource Type) in software level.

Installation

• Download Arduino IDE.
• Install Arduino IDE.
• Download nCube-Thyme-Arduino.
• Copy the libraries file to Arduino IDE libraries folder.
  We provide nCube-Mint source as Arduino libraries and you need to copy or overwrite it to the Arduino IDE library home “c:\Users[user name]\Document\Arduino\libraries”.

Configuration

Adafruit Feather M0 is not an Arduino official device. Therefore, some configurations for the Arduino IDE to work well with Adafruit Feather M0 device were made. Configuration details are available at Adafruit Feather M0 offical site or nCube-mint guide document.

Running

• Connect the debug cable to PC
  
• Open “File>Examples>oneM2MClient>nCube-Mint”

• Open “Tools>Serial Monitor” for view the log.

• Modifications of the source can be made if needed.
• Click “upload” button at top of the Arduino IDE.
• Connect PC WiFi to SSID “wifi101-3B3E”.
• Open the link “http://wifi101.local“.

• Input WiFi connection information on the page and click connection button.

Over The Air(OTA)

OTA (Over The Air) means programmers can code on local and send it to the device to upgrade or replace with new firmware through the cloud. In Arduino, some developer finds a new way to update the Arduino sketch online. It enables developers to install wireless Arduino devices in a place where there is a difficulty of accessibility can be updated without uninstallation.

nCube-Mint-OTA

&Cube-Mint is a software for the light weight WiFi devices(e.g. Arduino Yun or Arduino UNO) with WiFi shield and direct internet access without gateway. It is a light weight C++ program that make connections between Adafruit Feather M0 WiFi board and Mobius IoT Server Platform (see more in IoT-OCEAN official website). As mentioned above, we also provide a software named &Cube-Mint OTA to support a remote software upgrade with the internet connection in a situation where there is a difficulty of accessibility.

OTA(Over The Air) stands for the remote software upgrade that can code local and send it to the device to upgrade or replace with new firmware through the cloud. In Arduino, some developer finds a new way to update the Arduino sketch online. It enables developers to install wireless Arduino devices in a place where there is a difficulty of accessibility.

Example

1. First firmware

• Open “File>Examples>oneM2MClient>nCube-Mint-OTA”.
• Check “FIRMWARE_VERSION”, “AE_ID” and “buildResource()”.
• Upload sketch to the board.

2. Update firmware

• Check “FIRMWARE_VERSION”, “AE_ID”(raise the version number).
• Compile new “.Hex” file.

C:\Users\[user]\AppData\Local\Temp\arduino_build_********

• Open OTA Server website “http://203.253.128.161:8730” 
• Upload “.Hex” file.
• Send update command with HTTP request

POST /mobius-yt/[your-ae]/update
Host: 203.253.128.161:7579
Accept: application/json
X-M2M-RI: 12345
X-M2M-Origin: [your-ae]
Content-Type: application/vnd.onem2m-res+json; ty=4

{"m2m:cin":{"con":"active"}}

OTA Result

Dependency Libraries

• ArduinoJson
• FlashStorage
• PubSubClient
• WiFi101
• WiFi101OTA
• TasCO2: CM1106 CO2 Sensor library(Made by KETI)
• OneM2MClient: Mobius client library(Made by KETI)
• OverTheAir: Device Online upgrade module(Made by KETI)

Document

For more information, please refer to the installation guide document as below.

• nCube-Mint installation guide.
• nCube-Mint-OTA installation guide.

BSD 3-Clause License

Copyright (c) 2017, IoTKETI All rights reserved Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

* Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.