View source for IoTGateway/SDK/WirelessSensorNetworkSDK


{| style="border-spacing:0;width:15.621cm;"
|- style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| Date
|| Version
|| Description / Major change
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 2015/3/30
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 1.1
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Eric Liang, create draft document
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 2015/10/08
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 1.2
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Eric Liang, add Get/Set API 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
|-
|}



=Abstract=

<div style="margin-left:0cm;margin-right:0cm;">This document defines these Advantech Sensor Network Manager APIs and Sensor Data Format for use in Advantech wireless sensor network device. </div>

=Overview=
==Introduction==

<div style="margin-left:0cm;margin-right:0cm;">This document describes how to use the Advantech Sensor Network Manager (Adv SNM) module to get/set IoT sensor network information, data, or status for your sensor device.</div>

<div style="margin-left:0cm;margin-right:0cm;">The Advantech sensor data format is refer to IPSO Alliance Guide[1]. Use Sensor Markup Language (SENML)[3] defines media types for representing sensor measurements and device parameters in the SenML. Representations are defined in JavaScript {{anchor|OLELINK156}} {{anchor|OLELINK155}} {{anchor|OLELINK154}} Object Notation (JSON)[5].</div>

<div style="margin-left:0cm;margin-right:0cm;">It includes get IoT gateway interface capability, get/set sensor hub information / sensor data, auto register / deregister sensor network hub, and auto report sensor data.</div>


==Terminology==

This specification makes use of the following additional terminology:


'''IoT Gateway (IoTGW):''' It integrates technologies and protocols for networking, embedded control, enterprise-grade security, and easy manageability on which application-specific software can run. Connectivity up to the WISE Cloud and down to sensors and existing controllers embedded in the system. Pre-process filtering and gathering of selected data for delivery.


'''Sensor Hub (SenHub)''': A sensor hub is capable of performing some processing, gathering sensory information and communicating with other connected hubs in the network. A sensor hub should be small in size, consume extremely low energy, operate in high volumetric densities, be autonomous and operate unattended, and be adaptive to the environment. As sensor hubs are typically very small electronic devices, they can only be equipped with a limited power source.


'''Sensor (Sen)''': Sensor is hardware device that produce a measurable response to a change in a physical condition like temperature or pressure. Sensor measures physical data of the parameter to be monitored.


'''Resource Type(rt)''': Each root resource of a function set is assigned a Resource Type parameter, therefore making it possible to discover it. The Resource Type parameter defines the value that MUST be included in the rt= field of the sensor.



=IPSO Application Framework=

<div style="margin-left:0cm;margin-right:0cm;">The IPSO Application Framework makes use of IETF standards as building blocks for a simple and efficient RESTful design model for IP smart objects. The framework may be used over either HTTP or CoAP web transfer protocols.</div>

HTTP, REST, XML, JSON, COAP and other key components of web technology are powerful mechanisms in an Internet of Things application.

<span style="background-color:#ffffff;color:#333333;">'''''Note: The objective of the Alliance is not to define technologies, but to document the use of IP-based technologies defined at the standard organizations such as IETF with focus on support by the Alliance of various use cases.'''''</span>


'''Function Sets''': The framework is organized into groups of resource types called Function Sets. A Function Set has a recommended root path, under which its sub-resources are organized. Each Function Set is assigned a Resource Type parameter, therefore making it possible to discover it.



{| style="border-spacing:0;width:14.75cm;"
|- style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| Function Set
|| Root Path
|| Resource Type
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">General Purpose IO</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/gpio</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">gpio</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Power</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/pwr</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">pwr</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Load Control</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/load</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">load</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Sensors</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/sen</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">sen</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Light Control</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/lt</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lt</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Message</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/msg</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">msg</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Location</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">/loc</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">loc</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Configuration
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | /cfg
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | cfg
|-
|}


==IPSO Smart Object==

<div style="margin-left:0cm;margin-right:0cm;">IPSO Smart Object[2] Guidelines provide a common design pattern, an object model, that can effectively use the IETF CoAP protocol to provide high level interoperability between Smart Object devices and connected software applications on other devices and services</div>

<div style="margin-left:0cm;margin-right:0cm;">The common object model is based on the Lightweight M2M (LWM2M 1.0) specification from the Open Mobile Alliance. OMA LWM2M is a device management and service architecture specification based on IETF CoAP, and provides a simple and flexible object template (object model) for constrained device management.</div>

The object model from OMA LWM2M is reused to define application level IPSO Smart Objects. This enables the OMA Name Authority (OMNA) to be used to register new objects, and enables existing LWM2M compliant device libraries and server software to be used as an infrastructure for IPSO Smart Objects

<div style="margin-left:0cm;margin-right:0cm;">This first IPSO Smart Object Guideline describes 18 Smart Object types '''[Appendix A]''', including a temperature sensor, a light controller, an accelerometer, a presence sensor, and other common sensor and actuator types representing a variety of use case domains. It is intended as a ?tarter pack??and example of how IPSO Smart Objects can be built to address some application specific use cases</div>


==Media Types for Sensor Markup Language (SENML)==

'''Semantics'''

{| style="border-spacing:0;width:17.009cm;"
|- style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| SenML
|| JSON
|| Type
|| Description
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Base Name</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bn</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">String</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">This is a string that is prepended to the names found in the entries</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Base Time</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bt</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Integer</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">A base time that is added to the time found in an entry</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Base Units</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bu</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">A base unit that is assumed for all entries, unless otherwise indicated</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Version</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">ver</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Number</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Version number of media type format</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Measurement or Parameters</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">e</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Array</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Array of values for sensor measurements or other generic parameters</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Name</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">n</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">String</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Name of the sensor or parameter</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Units
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | u
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Units for a measurement value
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Value
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | v
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Float
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Value of the entry</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String Value
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | sv
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Boolean Value
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | bv
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Boolean
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Value Sum
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | s
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Float
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Integrated sum of the values over time</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Time
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | t
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Integer</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Time when value was recorded</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Update Time
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | ut
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Integer</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Update time. A time in seconds that represents the maximum time before this sensor will provide an updated reading for a measurement.</span>
|-
|}


==The Data Type of Sensor Data Type==


{| style="border-spacing:0;width:9.834cm;"
|- style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| Data Type (type)
|| SenML Field
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | b (boolean)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | bv
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | s (string)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | s
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | e (enum)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | e
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | i (integer)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | v
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | d (decimal)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | v
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | h(hexadecimal)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | s
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | o(octet-stream)
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | s
|-
|}


==Advantech Sensor Semantics==


{| style="border-spacing:0;width:17.009cm;"
|- style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| SenML
|| JSON
|| Type
|| Description
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Min Range Value
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | min
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Float
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">The minimum value that can be measured by the sensor</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Max Range Value
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | max
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Float
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">The maximum value that can be measured by the sensor</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Access Mode
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | asm
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">The access mode of the resource. Ex: read (r), write (w), read/write (rw)</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Standard Format
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | st
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | String
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">The sensor format is which standard format</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Health Status
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Health
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Integer
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">The health status of network or device. Range: -1 ~ 100</span>

<span style="color:#000000;">Good: > 80, Average: 60 ~ 80, Below Average: 40~60, Bad:0~40, -1: Off line or Fault</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 
|-
|}




==Example:==

{"n":"Room Temp","u":"Cel","v":0,"min":0,"max":100,"asm":"r","type":"d","rt":"ucum.Cel","st":"ipso","exten":"sid=3303"}




































=Application Program Interface (API)=


==Event of Callback==

 typedef enum {
  // Interface: 1000 ~ 1999
  SN_Inf_UpdateInterface_Data   = 1000, // Update Interface data
  
  // Sensor Hub: 2000 ~ 2999
  SN_SenHub_Register         = 2000, // A SenHub connected
  SN_SenHub_SendInfoSpec     = 2001, // Report the resource information of SenHub
  SN_SenHub_AutoReportData   = 2002, // Auto report data value of SenHub
  SN_SenHub_Disconnect       = 2003, // A SenHub disconnected  
  
  SN_SetResult			   = 3000, // Return the result of setting value
 } SN_EVENT_ID;

==Command ID==

<span style="color:#0000ff;">typedef</span> <span style="color:#0000ff;">enum</span> {

{{anchor|OLELINK141}} {{anchor|OLELINK140}} {{anchor|OLELINK139}} SN_Set_ReportSNManagerDataCbf <nowiki>= 3000, </nowiki><span style="color:#008000;">// Set Event Callback function point</span>

}{{anchor|OLELINK121}} {{anchor|OLELINK120}} {{anchor|OLELINK119}} SN_CTL_ID<nowiki>;</nowiki>


==Return Code Definition==

<span style="color:#0000ff;">typedef</span> <span style="color:#0000ff;">enum </span>{

SN_ER_NOT_IMPLEMENT <nowiki>= -13, </nowiki><span style="color:#008000;">// Dose Not Support this command (501)</span>

SN_ER_TIMEOUT  <nowiki>= -12 </nowiki><span style="color:#008000;">// Request Timeout  (408)</span>

SN_ER_SYS_BUSY  <nowiki>= -11 </nowiki><span style="color:#008000;">// System is busy (503)</span>

SN_ER_VALUE_OUT_OF_RANGE <nowiki>= -10 </nowiki><span style="color:#008000;">// Value is out of range (416)</span>

SN_ER_SYNTAX_ERROR <nowiki>= -9 </nowiki><span style="color:#008000;">// Format is correct but syntax error (422)</span>

SN_ER_FORMAT_ERROR <nowiki>= -8 </nowiki><span style="color:#008000;">// Format error (415) </span>

SN_ER_REQUEST_ERROR <nowiki>= -7 </nowiki><span style="color:#008000;">// Request error (400)</span>

SN_ER_RESOURCE_LOSE  <nowiki>= -6 </nowiki><span style="color:#008000;">// Resource is lose (410)</span>

SN_ER_RESOURCE_LOCKED <nowiki>= -5, </nowiki><span style="color:#008000;">// Resource is in setting (426)</span>

SN_ER_NOT_FOUND <nowiki>= -4, </nowiki><span style="color:#008000;">// Resource Not Found (404)</span>

SN_ER_WRITE_ONLY <nowiki>= -3, </nowiki><span style="color:#008000;">// Write Only (405)</span>

SN_ER_READ_ONLY <nowiki>= -2, </nowiki><span style="color:#008000;">// Read Only (405)</span>

<div style="margin-left:0cm;margin-right:0cm;">SN_ER_FAILED <nowiki>= -1, </nowiki><span style="color:#008000;">// Failed (500)</span></div>

<div style="margin-left:0cm;margin-right:0cm;">SN_OK <nowiki>= 0, </nowiki><span style="color:#008000;">// Successfully (200)</span></div>

<div style="margin-left:0cm;margin-right:0cm;">SN_INITILIZED <nowiki>= 1, </nowiki><span style="color:#008000;">// Library had initilized</span></div>

} SN_CODE;




==Structure Definition==


<span style="color:#0000ff;">typedef</span> <span style="color:#0000ff;">struct</span> _SenHubInfo

{

<span style="color:#0000ff;">char</span> sMAC[MAX_SN_MAC]; <span style="color:#008000;">// MAC: remove '-' and ':')</span>

<span style="color:#0000ff;">char</span> sHostName[MAX_SN_HOSTNAME]; <span style="color:#008000;">// WISE1020-MAC(4)</span>

<span style="color:#0000ff;">char</span> sSN[MAX_SN_SNO]; <span style="color:#008000;">// MAC: remove '-' and ':')</span>

<span style="color:#0000ff;">char</span> sProduct[MAX_SN_PRODUCT_NAME]; <span style="color:#008000;">// WISE1020</span>

<span style="color:#0000ff;">void</span> <nowiki>*pExtened;</nowiki> 

}{{anchor|OLELINK272}} {{anchor|OLELINK271}} SenHubInfo<nowiki>;</nowiki>




































==Sensor Network Manager API Definition==


'''Syntax'''

<span style="background-color:#d9d9d9;">'''SNMCODE SN_Manager_Initialize( );'''</span>


'''Description'''

This function initializes the Sensor Network Manager API Library. You must call this function before using this module.


'''Parameters'''

None


'''Return Values '''

SNM__OK: Successfully to initialize the Sensor Network Manager module.

SNM_FAILED: Failed to initialize the Sensor Network Manager module.


'''Syntax'''

<span style="background-color:#d9d9d9;">'''SNMCODE SN_Manager_Uninitialize();'''</span>


'''Description'''

This function uninitialized the Sensor Network Manager Module. You must call this function before closing this module to release resources.


'''Parameters'''

None


'''Return Values '''

<div style="margin-left:0cm;margin-right:0cm;">SNM__OK: S{{anchor|OLELINK43}} {{anchor|OLELINK42}} uccessfully to uninitialized {{anchor|OLELINK12}} {{anchor|OLELINK11}} the Sensor Network Manager module.</div>

<div style="margin-left:0cm;margin-right:0cm;">SNM_FAILED : Failed to uninitialized the Sensor Network Manager module.</div>




'''Syntax'''

<span style="background-color:#d9d9d9;">'''SNMCODE SN_Manager_GetCapability(</span><span style="background-color:#d9d9d9;color:#0000ff;">char</span><span style="background-color:#d9d9d9;"> **'''</span><span style="background-color:#d9d9d9;"> ppzDataBuffer</span><span style="background-color:#d9d9d9;">''', </span><span style="background-color:#d9d9d9;color:#0000ff;">int</span><span style="background-color:#d9d9d9;"> *pnLen );'''</span>


'''Description'''

<div style="margin-left:0cm;margin-right:0cm;">This function is used to get all interfaces information of this IoT Gateway in JSON Format.</div>


'''Parameters'''

<div style="margin-left:0cm;margin-right:0cm;"><nowiki>*ppzDataBuffer</nowiki></div>

<div style="margin-left:1.69cm;margin-right:0cm;">[out] {{anchor|OLELINK63}} {{anchor|OLELINK62}} {{anchor|OLELINK61}} the {{anchor|OLELINK60}} {{anchor|OLELINK59}} point to the Sensor Network Interfaces??information data with JSON format</div>

<nowiki>*pnLen</nowiki>

[out] the length of the data in ppzDataBuffer


'''Return Values '''

<div style="margin-left:0cm;margin-right:0cm;">SNM__OK: Get the IoTGW interface information {{anchor|OLELINK41}} {{anchor|OLELINK40}} successfully.</div>

<div style="margin-left:0cm;margin-right:0cm;">SNM_FAILED: Failed to get IoTGW interface information.</div>


{{anchor|OLELINK142}} {{anchor|OLELINK153}} {{anchor|OLELINK152}} '''Example:'''

'''Condition'''

<div style="margin-left:0.423cm;margin-right:0cm;">Communication Type: <span style="background-color:#d8d8d8;">WSN</span></div>

<div style="margin-left:0.423cm;margin-right:0cm;">Number of WSN Interface: <span style="background-color:#d8d8d8;">2</span></div>

<div style="margin-left:0.423cm;margin-right:0cm;">Name of Interfaces: <span style="background-color:#d8d8d8;">WSN0, WSN1</span></div>

<div style="margin-left:0.423cm;margin-right:0cm;">MAC of Interfaces: <span style="background-color:#d8d8d8;">0000852CF4B7B0E8, 0000852CF4B7B0E7</span></div>




"IoTGW": {

"WSN": {

"WSN0": { 

"Info": {

"e": [{"n":"SenHubList","sv":"","asm":"r"},

{"n":"Topology","sv":"","asm":"r"},{"n":"Health","v":100,"asm":"r"},

{"n":"Name","sv":"WSN0","asm":"r"}],

 "bn":"Info"

},

 "bn":"0000852CF4B7B0E8",

 "ver":1

}, 


"WSN1": {

"Info": {

"e": [{"n":"SenHubList","sv":"","asm":"r"},

<div style="margin-left:0cm;margin-right:0cm;">{"n":"Topology","sv":"","asm":"r"},{"n":"Health","v":100,"asm":"r"},</div>

{"n":"Name","sv":"WSN1","asm":"r"}],

"bn":"Info"

},

 "bn":"0000852CF4B7B0E7",

 "ver":1

},

"bn":"WSN"

},

"ver": 1

}




'''Syntax'''

<span style="background-color:#d9d9d9;">'''SNMCODE SN_Manager_ActionProc'''</span><span style="background-color:#d9d9d9;">( </span><span style="background-color:#d9d9d9;color:#0000ff;">const</span><span style="background-color:#d9d9d9;"> </span><span style="background-color:#d9d9d9;color:#0000ff;">int</span><span style="background-color:#d9d9d9;"> nCtlId, </span>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*</nowiki></span>{{anchor|OLELINK124}} {{anchor|OLELINK123}} {{anchor|OLELINK122}} <span style="background-color:#d9d9d9;">pParam1</span><span style="background-color:#d9d9d9;">, </span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*pParam2, </nowiki></span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*pRev1, </nowiki></span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*pRev2 );</nowiki></span></div>

'''Description'''

<div style="margin-left:0cm;margin-right:0cm;">This function is used to set callback function or others parameters depended on nCtlId. </div>


'''Parameters'''

<div style="margin-left:0cm;margin-right:0cm;">nCtlId</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] control id. Refer to <span style="background-color:#d8d8d8;">SN_CTL_ID</span></div>

{{anchor|OLELINK125}} {{anchor|OLELINK126}} <nowiki>*</nowiki>{{anchor|OLELINK146}} {{anchor|OLELINK145}} pParam1

[in] the point to parameter 1 ( data type depend on SN_CTL_ID)

<nowiki>*pParam2</nowiki>

[in] the point to parameter 2 ( data type depend on SN_CTL_ID)

<nowiki>*pPev1</nowiki>

[in] {{anchor|OLELINK202}} {{anchor|OLELINK201}} {{anchor|OLELINK200}} {{anchor|OLELINK199}} reserved for later use. Must be ?ULL??
<div style="margin-left:0cm;margin-right:0cm;"><nowiki>*pPev2</nowiki></div>

[in] reserved for later use. Must be ?ULL??

'''Return Values '''

<div style="margin-left:0cm;margin-right:0cm;">SNM__OK: Successfully {{anchor|OLELINK137}} {{anchor|OLELINK136}} {{anchor|OLELINK135}} to call this function.</div>

<div style="margin-left:1.905cm;margin-right:0cm;">>0 : Failed to call this function.</div>






'''Example:'''

<div style="margin-left:0cm;margin-right:0cm;">nCtlId: <span style="background-color:#d8d8d8;">SN_Set_ReportSNManagerDataCbf</span></div>

<nowiki>*</nowiki>pParam1: {{anchor|OLELINK151}} {{anchor|OLELINK150}} {{anchor|OLELINK149}} <span style="background-color:#d9d9d9;">ReportSNManagerDataCbf</span>


the <u>ReportSNManagerDataCbf</u> that specify the callback function to be used to notify event.


'''Syntax'''

<span style="background-color:#d9d9d9;color:#0000ff;">typedef</span><span style="background-color:#d9d9d9;"> </span><span style="background-color:#d9d9d9;color:#0000ff;">int</span><span style="background-color:#d9d9d9;"> (*</span>{{anchor|OLELINK148}} {{anchor|OLELINK147}} <span style="background-color:#d9d9d9;">'''ReportSNManagerDataCbf'''</span><span style="background-color:#d9d9d9;">) ( </span><span style="background-color:#d9d9d9;color:#0000ff;">const</span><span style="background-color:#d9d9d9;"> </span><span style="background-color:#d9d9d9;color:#0000ff;">int</span><span style="background-color:#d9d9d9;"> </span>{{anchor|OLELINK44}} <span style="background-color:#d9d9d9;">nEventI</span><span style="background-color:#d9d9d9;">D, </span>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">const</span><span style="background-color:#d9d9d9;"> </span><span style="background-color:#d9d9d9;color:#0000ff;">char</span><span style="background-color:#d9d9d9;"> *pzDataBuffer, </span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">const</span><span style="background-color:#d9d9d9;"> </span><span style="background-color:#d9d9d9;color:#0000ff;">int</span><span style="background-color:#d9d9d9;"> nDataLen, </span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>**</nowiki></span>{{anchor|OLELINK87}} {{anchor|OLELINK86}} {{anchor|OLELINK85}} <span style="background-color:#d9d9d9;">ppOutParam</span><span style="background-color:#d9d9d9;">, </span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*</nowiki></span>{{anchor|OLELINK263}} {{anchor|OLELINK262}} <span style="background-color:#d9d9d9;">pParam1</span><span style="background-color:#d9d9d9;">,</span></div>

<div style="margin-left:0cm;margin-right:0cm;"><span style="background-color:#d9d9d9;color:#0000ff;">void</span><span style="background-color:#d9d9d9;"> <nowiki>*pRev1 );</nowiki></span></div>


'''Description'''

<div style="margin-left:0cm;margin-right:0cm;">This function is used to receive events that trigger by Sensor Network Manager module. (ex: A New SenHub Connected/Disconnected/Auto Report Sensor Data/Auto Report Interface Data).</div>


'''Parameters'''

<div style="margin-left:0cm;margin-right:0cm;">nEventID</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] event id. Refer to <span style="background-color:#d9d9d9;">SN_EVENT_ID</span></div>

{{anchor|OLELINK82}} {{anchor|OLELINK84}} {{anchor|OLELINK83}}  *{{anchor|OLELINK213}} {{anchor|OLELINK212}} {{anchor|OLELINK211}} {{anchor|OLELINK181}} {{anchor|OLELINK180}} {{anchor|OLELINK79}} {{anchor|OLELINK78}} {{anchor|OLELINK77}} pzDataBuffer

[in] the point to data with JSON format

{{anchor|OLELINK66}} {{anchor|OLELINK65}} {{anchor|OLELINK64}} nDataLen

{{anchor|OLELINK69}} {{anchor|OLELINK68}} {{anchor|OLELINK67}} [in] the length of the data in pzDataBuffer

{{anchor|OLELINK256}} {{anchor|OLELINK255}} <nowiki>**</nowiki>{{anchor|OLELINK217}} {{anchor|OLELINK216}} {{anchor|OLELINK215}} ppOutParam

[out] {{anchor|OLELINK257}} User can {{anchor|OLELINK260}} {{anchor|OLELINK259}} {{anchor|OLELINK258}} specify the address or context value when ?{anchor|OLELINK220}} {{anchor|OLELINK219}} {{anchor|OLELINK218}} <span style="color:#ff0000;">SN_SenHub_Register</span>??event called,

<div style="margin-left:0cm;margin-right:0cm;">It would be sent back when callback function gets called with this SenHub? </div>

<div style="margin-left:2.54cm;margin-right:0cm;">events (SN_SenHub_SendInfoSpec, SN_SenHub_AutoReportData,</div>

<div style="margin-left:2.54cm;margin-right:0cm;">,SN_SenHub_Disconnect)</div>

{{anchor|OLELINK108}} {{anchor|OLELINK107}} <nowiki>*</nowiki>{{anchor|OLELINK261}}  {{anchor|OLELINK266}} {{anchor|OLELINK265}} {{anchor|OLELINK264}} pParam1

[in] the point of data. The data type depends on ?N Event ID??

<nowiki>*pRev1</nowiki>

[in] reserved for later use.


{{anchor|OLELINK157}} {{anchor|OLELINK159}} {{anchor|OLELINK158}} '''Return Values '''

<div style="margin-left:0cm;margin-right:0cm;">SNM__OK: Process the callback event successfully.</div>

<div style="margin-left:0cm;margin-right:0cm;">SNM_FAILED: Failed to process the callback event</div>

'''Example of Event Code:'''


# <span style="background-color:#d8d8d8;">'''SN_Inf_UpdateInterface_Data:'''</span>



<div style="margin-left:1.482cm;margin-right:0cm;"></div>

<div style="margin-left:1.482cm;margin-right:0cm;">'''Condition'''</div>

<div style="margin-left:0.423cm;margin-right:0cm;">Communication Type: <span style="background-color:#d8d8d8;">WSN</span></div>

<div style="margin-left:0.563cm;margin-right:0cm;">Name of Interface: <span style="background-color:#d8d8d8;">WSN0</span></div>

<div style="margin-left:0.423cm;margin-right:0cm;">MAC of Interface: <span style="background-color:#d8d8d8;">0000852CF4B7B0E8</span></div>

<div style="margin-left:1.482cm;margin-right:0cm;">{{anchor|OLELINK191}} {{anchor|OLELINK190}} {{anchor|OLELINK189}} Sensor Hubs connected: <span style="background-color:#d8d8d8;">0000000EC6F0F830 ,0000000EC6F0F831</span></div>

<div style="margin-left:1.482cm;margin-right:0cm;">Network Health Status: <span style="background-color:#d8d8d8;">60</span></div>

<div style="margin-left:1.482cm;margin-right:0cm;">Neighbor: <span style="background-color:#d8d8d8;">0000000EC6F0F830</span></div>


<div style="margin-left:0cm;margin-right:0cm;">pzDataBuffer : Update Interface Data</div>

"IoTGW": {

"WSN": {

"WSN0"{ 

"Info": {

"e": [{"n":"SenHubList","sv":"{{anchor|OLELINK188}} {{anchor|OLELINK187}} {{anchor|OLELINK186}} 0000000EC6F0F830 ,0000000EC6F0F831"},

 {"n":"Neighbor","sv":"0000000EC6F0F830"},

 {"n":"Health","v":60}],

"bn":"Info"

}

 "bn":"0000852CF4B7B0E8",

 "ver":1

},

"bn":"WSN"

}, 

"ver": 1


<div style="color:#ff0000;"></div># <span style="background-color:#d8d8d8;">'''SN_SenHub_Register'''</span>



<div style="margin-left:1.482cm;margin-right:0cm;"></div>

<div style="margin-left:1.482cm;margin-right:0cm;">'''Condition'''</div>

<div style="margin-left:1.905cm;margin-right:0cm;">Sensor Hub: <span style="background-color:#d8d8d8;">0000000EC6F0F830 </span></div>

<div style="margin-left:1.905cm;margin-right:0cm;">Name of Sensor Hub: <span style="background-color:#d8d8d8;">Room</span></div>


<div style="margin-left:0cm;margin-right:0cm;">pzDataBuffer </div>

<div style="margin-left:0.847cm;margin-right:0cm;">[in] Empty char buffer point</div>

<div style="margin-left:0cm;margin-right:0cm;">ppOutParam</div>

 [out] the point that storage the user specify address or context value.

<div style="margin-left:0cm;margin-right:0cm;">pParam1</div>

<div style="margin-left:0cm;margin-right:0cm;">[in] the point of data structure. ??span style="color:#ff0000;">SenHubInfo</span>??/div>


# <span style="background-color:#d8d8d8;">'''SN_SenHub_SendInfoSpec:'''</span>



<div style="margin-left:1.482cm;margin-right:0cm;"></div>

<div style="margin-left:1.482cm;margin-right:0cm;">{{anchor|OLELINK222}} {{anchor|OLELINK224}} {{anchor|OLELINK223}} '''Condition'''</div>

<div style="margin-left:0.423cm;margin-right:0cm;">''' '''{{anchor|OLELINK207}} {{anchor|OLELINK206}} {{anchor|OLELINK205}} {{anchor|OLELINK204}} {{anchor|OLELINK203}} Sensor Hub: <span style="background-color:#d8d8d8;">0000000EC6F0F830</span><span style="background-color:#d8d8d8;"> </span></div>

<div style="margin-left:1.482cm;margin-right:0cm;">Name of Sensor Hub: <span style="background-color:#d8d8d8;">Room</span></div>

<div style="margin-left:0cm;margin-right:0cm;">Sensors of SenHub: <span style="background-color:#d8d8d8;">temp1, co2, digital output</span></div>


pzDataBuffer : Send SenHub Information

{

"SenHub":{

 "SenData": {

"e": [{"n":" temp1", "u":"Cel","v":0,"min":0,"max":100,"asm":"r","type":"d","rt":"ucum.Cel","st":"ipso","exten":""},

<div style="margin-left:0cm;margin-right:0cm;">{"n":"co2","u":"ppm","v":0,"min":0,"max":100000,"asm":"r","type":"d","rt":"ucum.ppm","st":"ipso","exten":""},</div>

<div style="margin-left:0cm;margin-right:0cm;">{"n":"digital output", "u":"","bv":0,"asm":"rw","type":"b","rt":"gpio.dout","st":"ipso","exten":""}], </div>

"bn":"SenData" 

<div style="margin-left:0cm;margin-right:0cm;">},</div>

"Info": {

"e": [ {"n":"Name","sv":"{{anchor|OLELINK210}} {{anchor|OLELINK209}} {{anchor|OLELINK208}} Room","asm":"rw"},

{"n":"sw","sv":"1.0.0.2","asm":"r"},

{"n":"reset","bv":0,"asm":"rw"}],

"bn":"Info"

},

?et??{

"e": [ {"n":"Neighbor","sv":"0000000EC6F0F831","asm":"r"},

{"n":"Health","v":88,"asm":"r"},

{"n":"sw","sv":??.0.0.1??"asm":"r"}],

"bn":"Net"

<div style="margin-left:0cm;margin-right:0cm;">},</div>

"ver": 1

}

}

{{anchor|OLELINK228}} {{anchor|OLELINK229}} ppOutParam:

[in] the point of address or context value that pass by user at <span style="color:#ff0000;">SN_SenHub_Register </span>event<span style="color:#ff0000;">.</span>


# <span style="background-color:#d8d8d8;">'''SN_SenHub_AutoReportData'''</span>



<div style="margin-left:1.482cm;margin-right:0cm;">{{anchor|OLELINK235}} {{anchor|OLELINK237}} {{anchor|OLELINK236}} </div>

<div style="margin-left:1.482cm;margin-right:0cm;">'''Condition'''</div>

<div style="margin-left:1.905cm;margin-right:0cm;">Sensor Hub: <span style="background-color:#d8d8d8;">0000000EC6F0F830</span><span style="background-color:#d8d8d8;"> </span></div>

<div style="margin-left:1.905cm;margin-right:0cm;">Name of Sensor Hub: <span style="background-color:#d8d8d8;">Room</span></div>

<div style="margin-left:1.905cm;margin-right:0cm;">{{anchor|OLELINK225}} {{anchor|OLELINK227}} {{anchor|OLELINK226}} Sensors of SenHub: <span style="background-color:#d8d8d8;">temp1 (v:17), co2(v:1001), digital output(bv:0)</span></div>


<div style="margin-left:0cm;margin-right:0cm;">pzDataBuffer : Update SenHub Data</div>

{

"SenHub":{

"SenData": {

"e": [{"n":"temp1","v":17},

{"n":"co2", "v":1001},

{"n":"digital output", "bv":0}], 

"bn":"SenData",

"ver":1 

},

"Info": {

"e": [{"n":"Health","v":100,"asm":"r"},

  {"n":"Name","sv":"Room","asm":"rw"},

 {"n":"IoTGW","sv":"0000852CF4B7B0E8","asm":"r"}],

"bn":"Info"

},

 "ver": 1

}

}


ppOutParam:

[in] the point of address or context value that pass by user at <span style="color:#ff0000;">SN_SenHub_Register </span>event<span style="color:#ff0000;">.</span>


<div style="margin-left:0.847cm;margin-right:0cm;"></div># <span style="background-color:#d8d8d8;">'''SN_SenHub_Disconnect'''</span>



<div style="margin-left:1.482cm;margin-right:0cm;"></div>

<div style="margin-left:1.482cm;margin-right:0cm;">Condition</div>

<div style="margin-left:2.328cm;margin-right:0cm;">Sensor Hub: <span style="background-color:#d8d8d8;">0000000EC6F0F830</span></div>

<div style="margin-left:0cm;margin-right:0cm;">pzDataBuffer : {{anchor|OLELINK252}} {{anchor|OLELINK251}} {{anchor|OLELINK250}} Empty char buffer point</div>

<div style="margin-left:0cm;margin-right:0cm;">ppOutParam:</div>

 [in] the point of address or context value that pass by user at <span style="color:#ff0000;">SN_SenHub_Register </span>event<span style="color:#ff0000;">.</span>


'''Syntax'''

<span style="background-color:#d9d9d9;">'''char* SN_Manager_GetData(const char *pszInURI, const ACTION_MODE mode);'''</span>


'''Description'''

This function is used to get values of resource of sensor network manager 

( ex: network interface, sensor hub, or sensor ).


'''Parameters'''

<div style="margin-left:0cm;margin-right:0cm;">pszInURI</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] uri path of resource. </div>

<div style="margin-left:1.69cm;margin-right:0cm;"> Example:</div>

<div style="margin-left:0cm;margin-right:0cm;">SenHub: SenHub? UID/bn/bn/n or SenHub? UUID/bn/bn</div>

<div style="margin-left:1.69cm;margin-right:0cm;"> Interface: bn/bn/Interface? MAC/bn/n</div>

<div style="margin-left:1.69cm;margin-right:0cm;">mode</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] mode of getting ( cache or direct mode)</div>


'''Return Values '''

{?tatusCode??200, ?esult??{JSON Object}}


StatusCode : Please refer [Appendix C] for status code.

Result : Result of getting in JSON format


'''Example:'''

Get the SenHub (0000000EC6F0F830)? temp1 value

pzInURI: 0000000EC6F0F830/SenHub/SenData/temp1 mode: cache

'''Result:'''

{?tatusCode??200, ?esult?? {"n":"temp1","v":17}}


'''Syntax'''

<span style="background-color:#d9d9d9;">'''char* SN_Manager_SetData(const char *pszInURI, const char *pszValue );'''</span>


'''Description'''

This function is used to get value of resource of sensor network manager in asynchronous.

( ex: network interface, sensor hub, or sensor ). This function would check the set resource and value is correct and settable. If all parameters are correct and returns accept this request immediately. Then it will set value to resource and return the result in asynchronous.


'''Parameters'''

<div style="margin-left:0cm;margin-right:0cm;">pszInURI</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] path of resource. (Note: Need to specify to ???resource not ?n??)</div>

<div style="margin-left:1.69cm;margin-right:0cm;">pszValue</div>

<div style="margin-left:1.69cm;margin-right:0cm;">[in] the set value in JSON format</div>


'''Return Values '''

{?tatusCode??200, ?esult??{JSON Object}}


StatusCode : Please refer [Appendix C] for status code.

Result : Result of setting in JSON format




'''2.5 Application Sample Code'''

Please refer to the distribution package for the sample code.
































<div style="text-align:center;">{{anchor|OLELINK114}} {{anchor|OLELINK116}} {{anchor|OLELINK115}} '''Appendix A:'''</div>

<div style="text-align:center;">Smart Objects defined by this Technical Guideline</div>


{| align="center" style="border-spacing:0;width:14.75cm;"
|- style="background-color:#eeece1;border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
| align=center| '''Object'''
| align=center| '''Object ID'''
| align=center| '''Multiple Instances?'''
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Digital Input '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3200 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Digital Output '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3201 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Analogue Input '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3202 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Analogue Output '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3203 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Generic Sensor '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3300 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Illuminance Sensor '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3301 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Presence Sensor '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3302 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Temperature Sensor '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3303 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Humidity Sensor '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3304 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Power Measurement '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3305 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Actuation '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3306 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Set Point '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3308 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Load Control '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3310 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Light Control '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3311 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Accelerometer '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3313 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Magnetometer '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3314 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | '''IPSO Barometer '''
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | 3315 
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;color:#000000;" | Yes 
|-
|}
<div style="text-align:center;">'''Table 1'''</div>


































<div style="text-align:center;">'''Appendix B:'''</div>

<div style="margin-left:3.387cm;margin-right:0cm;">'''The Unified Code for Units of Measure (UCUM)'''</div>


<div style="text-align:center;">[http://unitsofmeasure.org/ucum.html http://unitsofmeasure.org/ucum.html]</div>


{| align="center" style="border-spacing:0;width:9.832cm;"
|- style="background-color:#eeece1;border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| Symbol
|| Description
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | m
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | meter
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | kg
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | kilogram
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">s</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">second</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">A</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">ampere</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">K</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">kelvin</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">cd</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">candela</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">mol</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">mole</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Hz</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">hertz</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">rad</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">radian</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">sr</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">steradian</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">N</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">newton</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Pa</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">pascal</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">J</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">joule</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">W</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">watt</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">C</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">coulomb</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">V</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">volt</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | F
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | farad
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Ohm
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | ohm
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | S
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | siemens
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Wb
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | weber
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | T
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | tesla
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | H
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | henry
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Cel</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">degrees Celsius</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lm</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lumen</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lx</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lux</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Bq</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">becquerel</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Gy</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">gray</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Sv</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">sievert</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">kat</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">katal</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">pH</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">pH acidity</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">%</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Value of a switch. A value of 0.0 indicates the switch is off while 100.0 indicates on.</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">count</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">counter value</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">%RH</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Relative Humidity</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">m2</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">area</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">l</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">volume in liters</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">m/s</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">velocity</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">m/s2</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">acceleration</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">l/s</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">flow rate in liters per second</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">W/m2</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">irradiance</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">cd/m2</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">luminance</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Bspl</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bel sound pressure level</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bit/s</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">bits per second</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">lat</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">degrees latitude. Assumed to be in WGS84 unless another reference frame is known for the sensor.</span>
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | lon
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | degrees longitude. Assumed to be in WGS84 unless another reference frame is known for the sensor.
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | %EL
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | remaining battery energy level in percents
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | EL
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | remaining battery energy level in seconds
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | beet/m
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Heart rate in beets per minute
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | beets
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Cumulative number of heart beats
|-
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | h
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Hour.
|-
|}
<div style="text-align:center;">'''Table 2'''</div>
















<div style="text-align:center;">'''Appendix C:'''</div>

<div style="text-align:center;">Status Code</div>


{| style="border-spacing:0;width:12.021cm;"
|- style="background-color:#eeece1;border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;"
|| Status Code
|| Description
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 200
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | OK
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | 201
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | Created
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">202</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Accepted</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">203</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Non-Authoritative Information</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">204</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">No Content</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">400</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Bad Request</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">401</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Unauthorized</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">403</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Forbidden</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">404</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Not Found</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">405</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Method Not Allowed</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">406</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Not Acceptable</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">408</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Request Timeout</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">409</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Conflict</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">410</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Resource is Gone</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">415</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Unsupported Media Type</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">416</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Requested Range Not Satisfiable</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">426</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Locked</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">500</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Internal Server Error</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">501</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Not Implemented</span>
|-
| align=center style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">503</span>
| style="border:0.5pt solid #00000a;padding-top:0cm;padding-bottom:0cm;padding-left:0.199cm;padding-right:0.191cm;" | <span style="color:#000000;">Service Unavailable</span>
|-
|}
<div style="text-align:center;">'''Table 3'''</div>


'''Reference'''

'''[1] IPSO Alliance: [http://www.ipso-alliance.org/ http://www.ipso-alliance.org/]

'''[2] IPSO Smart Object: IPSO-Smart-Objects-1.0.pdf'''

'''[3] SenML: [https://datatracker.ietf.org/doc/draft-jennings-senml/ https://datatracker.ietf.org/doc/draft-jennings-senml/]

'''[4] UCUM: [http://unitsofmeasure.org/trac/ http://unitsofmeasure.org/trac/]

'''[5] JavaScript Object Notation (JSON) [http://json.org/ http://json.org/]