Difference between revisions of "Implementation notes"

From AMTech WikiDocs
Jump to: navigation, search
Line 3: Line 3:
 
***Clone configuration from exiting M2MBridge template instance (See [[M2M Bridge#Edge Configuration|Edge Configuration]])  
 
***Clone configuration from exiting M2MBridge template instance (See [[M2M Bridge#Edge Configuration|Edge Configuration]])  
 
***Gets observation production configuration (See [[IoT Restful API#Get observation production configuration|Observation production configuration API]])
 
***Gets observation production configuration (See [[IoT Restful API#Get observation production configuration|Observation production configuration API]])
***Gets things instances (See [[IoT Restful API#Get instances by thing type|Get instances by thing type API]])
+
***Gets things (See [[IoT Restful API#Get instances by thing type|Get instances by thing type API]])
***Creates a web socket to receive asynchronous commands and thing instances changes (crud operations) (See [[IoT Restful API#Commands|CRUD and Commands API]])
+
***Receive asynchronous commands and things changes (CRUD operations) (See [[IoT Restful API#Commands|CRUD and Commands API]])
 
****Dispatch command observations to plugin instance leveraging thing type instance @id (See [[Activities#Thing types|Thing types]])
 
****Dispatch command observations to plugin instance leveraging thing type instance @id (See [[Activities#Thing types|Thing types]])
 
****Restart instance when supported properties change by calling stop and star plugin interface
 
****Restart instance when supported properties change by calling stop and star plugin interface
Line 10: Line 10:
 
***Load plugin nodes modules required by configuration
 
***Load plugin nodes modules required by configuration
 
***Creates an instance of plugin for each thing type instance using instance @id as identifier (See [[Activities#Thing types|Thing types]])
 
***Creates an instance of plugin for each thing type instance using instance @id as identifier (See [[Activities#Thing types|Thing types]])
****JavaScript object is extended with the properties values from the thing instance (See [https://github.com/AMTechMX/M2MBridge/blob/master/plugins/SNMPDevice/SNMPDevice.js plugin example] )
+
****Plugin object is extended with the properties values from the thing instance (See [https://github.com/AMTechMX/M2MBridge/blob/master/plugins/SNMPDevice/SNMPDevice.js plugin example] )
 
****Properties and methods are injected: (See [https://github.com/AMTechMX/M2MBridge/blob/master/plugins.js for details])
 
****Properties and methods are injected: (See [https://github.com/AMTechMX/M2MBridge/blob/master/plugins.js for details])
 
*****common logger
 
*****common logger
 
*****methods to send observations with and without enrichment
 
*****methods to send observations with and without enrichment
 
*****methods for restarting plugin     
 
*****methods for restarting plugin     
***Creates a centralized observation dispatcher with persistence to ensure:
+
***Creates a centralized observation dispatcher mechanism with persistence to ensure:
 
****Observations delivery in the order that observations occurred.
 
****Observations delivery in the order that observations occurred.
 
***Placeholders (See [[Observation enrichment#Placeholders substitution|Placeholders]])
 
***Placeholders (See [[Observation enrichment#Placeholders substitution|Placeholders]])

Revision as of 17:29, 27 April 2016

  • M2MBridge discovers and loads node.js modules that implement M2MBridge plugin interface (See Thing types) tacking into account activity observation production configuration (See Observation production configuration) and M2MBridge user access polices (See Actors and Edge Configuration).
    • It leverages AMTech IoT Protocol (See IoT Restful API)
      • Clone configuration from exiting M2MBridge template instance (See Edge Configuration)
      • Gets observation production configuration (See Observation production configuration API)
      • Gets things (See Get instances by thing type API)
      • Receive asynchronous commands and things changes (CRUD operations) (See CRUD and Commands API)
        • Dispatch command observations to plugin instance leveraging thing type instance @id (See Thing types)
        • Restart instance when supported properties change by calling stop and star plugin interface
      • Creates configuration information by Thing type leveraging configuration information and client side M2MBridge placeholders (See Observation production configuration and Placeholders)
      • Load plugin nodes modules required by configuration
      • Creates an instance of plugin for each thing type instance using instance @id as identifier (See Thing types)
        • Plugin object is extended with the properties values from the thing instance (See plugin example )
        • Properties and methods are injected: (See for details)
          • common logger
          • methods to send observations with and without enrichment
          • methods for restarting plugin
      • Creates a centralized observation dispatcher mechanism with persistence to ensure:
        • Observations delivery in the order that observations occurred.
      • Placeholders (See Placeholders)
        • #{deviceId} m2mBox Id set at bridgeConfig.json configuration file bridgeId property, or a unique id create in absence or this value
        • #{typeId} Unique id of the thingType that produces the event
        • #{thingId} Unique id of the instances that produces the event
        • #{tenantId} Tenant id used to authenticate the m2mBridge, defined at bridgeConfig.json tenant property
        • #{userId} User id used to authenticate the m2mBridge, defined at bridgeConfig.json userId property