oneM2MBrowser

oneM2MBrowser Wiki

This is oneM2MBrowser Wiki site for introducing the internal architecture and function.

What is oneM2MBrowser?

oneM2MBrowser is a tool for monitoring the oneM2M resources in the Mobius Yellow Turtle(Mobius-yt). It is working base on oneM2M HTTP RESTful API and MQTT Client. It was designed for helping developer to easily work with Mobius-yt.

What platform does oneM2MBrowser support?

From now on. It only works on Windows OS (windows XP, Vista, 7, 8, 10) and it also require the OS must be installed the .NET Framework.

What can oneM2MBrowser do?

1. Display the oneM2M resource as tree.
2. Retrieve the resource information.
3. Create new resource.
4. Real-time monitoring resource (delete, create).

Architecture

• System Architecture

The oneM2MBrowser connects with Mobius IoT Server Platform and MQTT Broker. Mobius is a kind of IoT Server Platform collection all oneM2M(IoT Standard) Resources and provides a set of open API which binding with HTTP, COAP, MQTT protocol for managing resource inside. In oneM2MBrowser case, it retrieves the resource structure by discovery API and display it as GUI and create subscription for necessary resources for receiving resource creating or deleting notification message.

• Software Architecture

The oneM2MBrowser architecture can be divided into four big modules. “NotificationReceiver” can receive MQTT notification message and parse it then add or delete matched resource in “ResourceManager”. “ResourceManager” provide a series of oneM2M API accessing function and it can discovery Mobius inside resource structure by these API then store it in the memory as objects. “GUI” provides some windows and dialogs for user interaction. “ConfigLoader” is used to store local application parameter.

User Interface

When you start the oneM2MBrowser you will get a window as above.

1. A text box for input resource path. In oneM2M standard, every resource should have a unique path.
2. Start and stop button for starting monitoring resource process or stop it.
3. Content Instance Display Number is used to limit the display content instance number. Too much content instance display on the view that maybe cause a crash in program. So, we only support to show latest 5, 3 or 1 content instance in application.
4. This is resource tree viewer of oneM2MBrowser. In here you can see all the child resources of the resource which you input in the ① area. If some new resource was created or some resource was deleted then it will synchronously display on the viewer. In the version 1.0.3.5 we have already added the resource creation and deleting function. So user can use the mouse to right click resource for create and delete resource directly.
5. Show the resource color of each supported resource type.
6. Show the resource information. In oneM2M standard, each type of resource has a series of attributes and it can be serialized to a JSON or XML string message.

References

• Mobius API Document

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.

oneM2MBrowser

oneM2MBrowser is a tool for monitoring the oneM2M resources in the Mobius Yellow Turtle(Mobius). It is working base on oneM2M HTTP RESTful API and MQTT Message. It was designed for helping developer to easily work with Mobius.

Getting Started

Download the source file from oneM2MBrowser github site.

Installation

The oneM2MBrowser project is a Vistual Studio project. So it only can work on window PC.

If you don’t have the winPC that we suggest to insall the VMware WorkStation Player and run a Virtrual Machine on it.

1. Download the Visual Studio.
2. Install the Visual Studio follow the guide.
3. Open the oneM2MBrowser home and double click oneM2MBrowser.sln file.

Running

1. Press the F5 key in Visual studio or click the start button on top of Visual studio IDE.
2. Input a resource URL into oneM2MBrowser and click start button. oneM2MBrowser will show the all child resources of yours after finishing discovery process.

Development

The oneM2MBrowser is developed base on WPF application which include in .net framework.

So the UI part is written with XAML language and logic part is written with C#.

If you are not familiar with XAML language the Microsoft also provide Microsoft Blend for helping developer to edit UI XAML.

Build

Basic framework

• WPF – The UI framework used

Nuget libraries

• Newtonsoft.Json – The JSON format parser
• M2Mqtt – The MQTT message protocol used

Document

If you want more detail, please refer the guide document