Difference between revisions of "Device-Node.js SDK"

From ESS-WIKI
Jump to: navigation, search
 
(10 intermediate revisions by the same user not shown)
Line 12: Line 12:
 
= How To =
 
= How To =
  
−
== Demo  1, 2, 3 ==
+
== How To Run - SamplePlugin  Setp: 1 -> 2 -> 3 ==
 
<pre>1. == Download ==
 
<pre>1. == Download ==
 
$git clone git@gitlab.edgecenter.io:edgesense-open/device-template-node.js.git sdk-sample
 
$git clone git@gitlab.edgecenter.io:edgesense-open/device-template-node.js.git sdk-sample
Line 21: Line 21:
  
 
3. == Run ==
 
3. == Run ==
−
$node index.js</pre>
+
$node plugin_index.js</pre>
  
 
== Development ==
 
== Development ==
Line 29: Line 29:
 
==== agent_config.json ====
 
==== agent_config.json ====
 
<pre>  - DeivceNam: <XXX> Name of application
 
<pre>  - DeivceNam: <XXX> Name of application
−
&nbsp; - ServiceType: <xxx> Category of application
+
  - ServiceType: <xxx> Category of application
−
&nbsp; - Description: A brief description  
+
  - Description: A brief description  
 
   - version: version of application
 
   - version: version of application
 
   - plugin: path of main entry program => ./module/<xxx>.js
 
   - plugin: path of main entry program => ./module/<xxx>.js
 +
</pre>
 +
 +
&nbsp; &nbsp; Example: iAlarm
 +
<pre lang="json">{
 +
 +
    "DeviceName": "<code>OPCUAClient</code>",
 +
    "ServiceType": "<code>Protocol-Converter</code>",
 +
    "Description": "<code>OPC-UA Client to access OPC-UA Server node</code>",
 +
    "version": "v2.0.2",
 +
    <code>"plugin": "/module/opcua-client-plugin.js"</code>
 +
}
 
</pre>
 
</pre>
  
Line 46: Line 57:
 
*information: log format
 
*information: log format
 
*path: log folder
 
*path: log folder
−
*duration: how long to create a new log file ( default : 1 Hr 3600000 ms, Max: 1 day )
+
*duration: how long to create a new log file ( default&nbsp;: 1 Hr 3600000 ms, Max: 1 day )
 
*buffer: how long to write to file ( default: 1 sec, 1000 ms, Max: 1 min )
 
*buffer: how long to write to file ( default: 1 sec, 1000 ms, Max: 1 min )
 
*files: Max log file
 
*files: Max log file
Line 57: Line 68:
  
 
'''Debug Level'''
 
'''Debug Level'''
−
 
+
<pre>0: NONE
−
*
+
2: ERROR - consloe.error
−
=== 0: NONE ===
+
3: WARN     - console.warn
−
 
+
5: INFO       - consloe.log ( Default )
−
*
+
7: DEBUG   - consloe.debug
−
=== 2: ERROR - consloe.error ===
+
8: TRACE   - consloe.trace</pre>
−
 
 
−
*3: WARN&nbsp; &nbsp; &nbsp;- console.warn
 
−
*5: INFO&nbsp; &nbsp; &nbsp; &nbsp;- consloe.log ( Default )
 
−
*7: DEBUG&nbsp; &nbsp;- consloe.debug
 
−
*8: TRACE&nbsp; &nbsp; - consloe.trace
 
  
 
=== Plugin ===
 
=== Plugin ===
  
−
#Rename the '''Simple-plugin_temp.js''' by your applicaton name
+
#Rename the '''[https://gitlab.edgecenter.io/edgesense-open/device-template-node.js/-/blob/master/module/pluginClassTemp.js pluginClassTemp.js]&nbsp;''' by your applicaton name
−
#Chang the plugin path in '''config/agent_config.json&nbsp;:&nbsp;''''''<span style="color:#0000FF;">plugin</span>'''
+
#Chang the plugin path in index_plugin.js'''&nbsp;:&nbsp;'''var&nbsp;agentplugin&nbsp;=&nbsp;require('./module/pluginClassTest.js');
−
#<span style="color:#0000FF;">'''InitPlugin'''</span>: InitPlugin&nbsp; => Refer &lt; InitTest &gt; in '''Simple-plugin_test.js'''
+
#<span style="color:#0000FF;">'''InitPlugin'''</span>: InitPlugin&nbsp; => Refer &lt; InitTest &gt; in '''pluginClassTest.js'''
−
#<span style="color:#0000FF;">'''AutoReport'''</span>: start auto report interval callback function; Implement to call send data in this=> Refer &lt; AutoUpdateTest &gt; in&nbsp;&nbsp;Simple-plugin_test.js
+
#<span style="color:#0000FF;">'''AutoReport'''</span>: start auto report callback function by interval; To implement send data in this function=> Refer &lt; AutoUpdateTest &gt; in&nbsp;&nbsp;Simple-plugin_test.js
−
#<span style="color:#0000FF;">'''setSenseData'''</span>: DeviceOn server or others apps to set sensor value to the service. This callback function will be called and you need to implement a set function with your application at this.
+
#<span style="color:#0000FF;">'''setSenseData'''</span>: DeviceOn server or other apps&nbsp;to set sensor value to the service. This callback function will be called and you need to implement a set function with your application at this.
−
#<span style="color:#0000FF;">'''sendEventTest'''</span>: You can refer to "sendEventTest" to trigger a event alarm to local MQTT Broker and transfer to DeviceOn server.
+
#<span style="color:#0000FF;">'''sendEvent'''</span>: You can refer to "sendEventTest" in pluginClassTest.js to trigger an event alarm to the local MQTT Broker and transfer to DeviceOn server.
  
−
Note
+
= Note =
  
−
*If plugin need to send&nbsp;OPTS to DeviceOn, OPTS can not be assigned to 0 in plugin's&nbsp;capability. OPTS need to use current timestamp.
+
*If the plugin needs to send&nbsp;OPTS to DeviceOn, OPTS can not be assigned to 0 in plugin's&nbsp;capability. OPTS must&nbsp;set timestamps according to your application.

Latest revision as of 04:36, 5 February 2021

Introduction

  This is a EdgeSense southbound device service SDK in node.js. User can use this SDK to easy to develop your application to integrate with EdgeSense Core System. 

Device-Node.js SDK

Pre-Requirement

  • MQTT Broker ( Download ) : Please install the MQTT Broker on target platform.
  • Node.js >= 5.x: Please install above 5.x Nodejs on target platform.

How To

How To Run - SamplePlugin  Setp: 1 -> 2 -> 3

1. == Download ==
$git clone git@gitlab.edgecenter.io:edgesense-open/device-template-node.js.git sdk-sample
$cd sdk-sample

2. == Install packages ==
$npm install

3. == Run ==
$node plugin_index.js

Development

config

agent_config.json

  - DeivceNam: <XXX> Name of application
  - ServiceType: <xxx> Category of application
  - Description: A brief description 
  - version: version of application
  - plugin: path of main entry program => ./module/<xxx>.js

    Example: iAlarm 

{

    "DeviceName": "<code>OPCUAClient</code>",
    "ServiceType": "<code>Protocol-Converter</code>",
    "Description": "<code>OPC-UA Client to access OPC-UA Server node</code>",
    "version": "v2.0.2",
    <code>"plugin": "/module/opcua-client-plugin.js"</code>
}

log.json

confinuration of advlog-node.js

https://gitlab.edgecenter.io/edgesense-open/advlog-node.js

static: log file

  • level: debug level
  • information: log format
  • path: log folder
  • duration: how long to create a new log file ( default : 1 Hr 3600000 ms, Max: 1 day )
  • buffer: how long to write to file ( default: 1 sec, 1000 ms, Max: 1 min )
  • files: Max log file

dynamic: print to console

  • level: debug level
  • information: log format
  • trace: enable(1)/disable(0) consloe trace

Debug Level 

0: NONE
2: ERROR - consloe.error
3: WARN     - console.warn
5: INFO       - consloe.log ( Default )
7: DEBUG   - consloe.debug
8: TRACE    - consloe.trace

Plugin

  1. Rename the pluginClassTemp.js  by your applicaton name
  2. Chang the plugin path in index_plugin.js : var agentplugin = require('./module/pluginClassTest.js');
  3. InitPlugin: InitPlugin  => Refer < InitTest > in pluginClassTest.js
  4. AutoReport: start auto report callback function by interval; To implement send data in this function=> Refer < AutoUpdateTest > in  Simple-plugin_test.js
  5. setSenseData: DeviceOn server or other apps to set sensor value to the service. This callback function will be called and you need to implement a set function with your application at this.
  6. sendEvent: You can refer to "sendEventTest" in pluginClassTest.js to trigger an event alarm to the local MQTT Broker and transfer to DeviceOn server.

Note

  • If the plugin needs to send OPTS to DeviceOn, OPTS can not be assigned to 0 in plugin's capability. OPTS must set timestamps according to your application.
Retrieved from "https://ess-wiki.advantech.com.tw/wiki/index.php?title=Device-Node.js_SDK&oldid=19893"