Difference between revisions of "M2M Bridge"

From AMTech WikiDocs
Jump to: navigation, search
 
(183 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
# [[Functionality]]
+
[[File:AmtechM2mBridge.svg|40px]] M2MBridge is a software stack that implements M2M edge functionality leveraging AMTech IoT Protocol
−
# [[Edge Configuration]]
+
# [[M2MBridge Functionality|Functionality]]
 +
# [[Configuration example]]
 +
# [[M2MBridge network]]
 +
#: [[Aggregation]]
 +
#: [[Edge reasoners]]
 +
#: [[Mesh network]]
 +
# [[Intelligence at the Edge]]
 +
#: [[WhatIsAPlugin|What is a plugin?]]
 +
#: [[EPC (Electronic product code)]]
 +
#: [[Smoothing observations]]
 +
# [[Observations production and consumption]]
 
# [[Cloud Configuration]]
 
# [[Cloud Configuration]]
−
== Cloud Configuration ==
+
#: [[Observation production config]]
−
*Create an amtechM2mBridge instance (See "/amtech/linkeddata/types/composite/entity/amtechM2mBridge")
+
#: [[Validation]]
−
* Create an actor actorX with the polices required by the activity(s) (See [[Access control#Actors|Actors]])
+
#: [[Sample configuration for beacons]]
−
** Add the things type polices the bridge needs to the actor actorX
+
# [[Automatic updates on bridge instance delete]]
−
*Register a follower (See [[Access control#Actors|Roles]])
+
# [[Implementation notes]]
−
** Assign to follower actor actorX access
+
# [[How to implement a new plugin]]
−
*Activity observation configuration (See [[Activities#Observation production configuration|Observation production configuration]])
+
# [[Set up a new Raspberry PI]]
−
** Add the Things types the bridge will use (See [[Activities#Thing types|Thing types]])
+
# [[Edge Configuration|M2MBridge Edge Configuration]]
−
*** Add the observations types from selected thing type the bridge will produce or consume (See [[Sensor's network#Observations and observation types|Observations and observation types]] [[Sensor's network#Crud observation|CRUD observations]])
+
# [[M2MBridge updates]]
−
** Configure the topic that m2mBridge will listen for crud and command observations has to matched with others things' observation production configuration linked to this m2mBridge configuration (See [[Activities#Observation production configuration|Observation production configuration]] [[Sensor's network#Topics|Topics]])
+
# [[How to install & execute]]
−
*Things instance creation
+
# [[HelloWorld plugin]]
−
**Configuring autoDiscover (See [[M2M Bridge#Edge Configuration|Edge Configuration]])
+
# Supported plugins
−
***The bridge will request the DAP to clone templateId instance with the name convention bridgeIdPrefix:(device mac address) from bridgeConfig.json
+
## [[File:wi-fi.svg|35px]] [[File:tcp-ip.svg|35px]] [https://en.wikipedia.org/wiki/Ethernet Wifi or RJ45 Ethernet]
−
***the things instances linked to the templateId property bridgeInstances will be cloned with the name convention bridgeIdPrefix:(device mac address):thing._name from bridgeConfig.json
+
##: [[File:SNMPDevice.svg|35px]] [[SNMPDevice]]
−
***cloned instance will be giving the access control owner to the follower user id of the bridge that requested it.
+
##: [[File:LLRPReader.svg|35px]] [[LLRPReader]]
−
*Monitoring M2MBridge status
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
**Create an SNMPDevice instance and give access to your M2MBridge actor (See "/amtech/linkeddata/types/composite/entity/SNMPDevice")
+
##: [[File:thing-magic.svg|35px]] [[ThingMagicEPCReader]]
−
***Send observations to /m2mBridge/snmp/read a core activity /amtech/activities/monitorM2MBridgeStatus will analyze the data and notify to the user and guestusers of the M2MBridge instance.
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
****This get done by setting at the observation production configuration /observationproductionconfig/SNMPDevice/observationsproducedconfig/snmpRead topic to value /m2mBridge/snmp/ (See [[Activities#Observation production configuration|Observation production configuration]])
+
##: [[File:plc-icon.svg|35px]] [[OPCUADevice]]
−
 
+
##: [[File:modbus.svg|45px]] [[ModbusDevice]]
−
== Implementation notes ==
+
##: [[File:wioGeneric.png|45px]] [[Wio Devices]] (troubleshooting inside)
−
*M2MBridge is an open source stack developed by the AMTEch team; it discovers and loads nodes modules implementing "M2MBridge plugin interface"(See [[Activities#Thing types|Thing types]]) tacking into account thing instances, activity(s) observation production configuration (See [[Activities#Observation production configuration|Observation production configuration]]) and M2MBridge credentials (See [[Access control#Actors|Actors]] and [[M2M Bridge#Edge Configuration|Edge Configuration]]).
+
##:: [[File:wioNode.svg.svg|35px]] [[wioNode]]
−
**It leverages AMTech IoT DAP (See [[Integration Guideline|Integration Guideline]])
+
##:: [[File:wioLink.svg|35px]] [[wioLink]]
−
***Clone configuration from exiting M2MBridge template configuration (See [[M2M Bridge#Edge Configuration|Edge Configuration]])
+
## [[File:bt.svg|35px]] [https://en.wikipedia.org/wiki/Bluetooth_Low_Energy BLE 4.0]
−
***Gets observation production configuration (See [[Integration Guideline#DAP Restful API#Get observation production configuration|Observation production configuration API]])
+
##: [[File:BLEbeaconsScanner.svg|35px]] [[BLEbeaconsScanner]]
−
***Gets thing types instances (See [[Integration Guideline#Get instances by thing type|Observation instances API]])
+
##: [[File:bleOBDScanner.svg|35px]] [[BLEODB2Scanner]]
−
***Creates a web socket to receive asynchronous commands and thing instances changes (crud operations) (See [[Integration Guideline#Commands|CRUD and Commands API]])
+
##: [[File:BLEPeripheralsScanner.svg|35px]] [[BLEPeripheralsScanner]]
−
****Dispatch command observations to plugin instance leveraging thing type instance @id (See [[Activities#Thing types|Thing types]])
+
##: [[File:BluvisioniBEEK.jpg|65px]] [[BLEBluvisionBeeksScanner]]
−
****Restart instance when supported properties change by calling stop and star plugin interface
+
##: [[File:BLEGattCentral.svg|35px]] [[BLEGattCentral]]
−
***Creates configuration information by Thing type leveraging configuration information and client side M2MBridge placeholders (See [[Activities#Observation production configuration|Observation production configuration]] and [[Observation enrichment#Placeholders substitution|Placeholders]])
+
## [[File:i2c.svg|35px]] [https://en.wikipedia.org/wiki/I%C2%B2C I2C]
−
***Load plugin nodes modules required by configuration
+
##: [[File:watersensor.svg|35px]] [[PCA9536I2CWaterDetectionWithBuzzer]]
−
***Creates an instance of plugin for each thing type instance using instance @id as identifier (See [[Activities#Thing types|Thing types]])
+
##: [[File:TSL2561Light.svg|65px]] [[TSL2561I2CLight]]
−
****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] )
+
##: [[File:soundvibration.svg|35px]] [[ADC121C021I2CSoundVibrationShock]]
−
****Properties and methods are injected: (See [https://github.com/AMTechMX/M2MBridge/blob/master/plugins.js for details])
+
##: [[File:ncd-i2c.png|65px]] [https://store.ncd.io/shop/?fwp_interface=i2c-interface NCD I2C devices]
−
*****common logger
+
##: [[File:grove-log.png|65px]] [https://www.seeedstudio.com/category/Grove-c-1003%7C%7C24.html?p=0 Grove devices via I2C]
−
*****methods to send observations with and without enrichment
+
## [[File:usb-logo.svg|35px]] [https://en.wikipedia.org/wiki/USB USB 2.0]
−
*****methods for restarting plugin   
+
##: [[File:thing-magic.svg|35px]] [[ThingMagicEPCReader]]
−
***Creates a centralized observation dispatcher with persistence to ensure:
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
****Observations delivery in the order that observations occurred.
+
##: [[File:Phidgets-Logo.png|65px]] [https://www.phidgets.com/?tier=0&catid=3&pcid=12 Phidgets USB sensors]
−
***Placeholders (See [[Observation enrichment#Placeholders substitution|Placeholders]])
+
<!--##:[[File:modbus.svg|45px]] [[ModbusDevice]]-->
−
**** #{deviceId} m2mBox Id set at bridgeConfig.json configuration file bridgeId property, or a unique id create in absence or this value
+
## [[File:xbee-pro-900hp.svg|35px]] [https://www.digikey.com/catalog/en/partgroup/xbee-pro-900hp/33082?utm_adgroup=RF%20&%20RFID XBee-Pro 900HP]
−
**** #{typeId} Unique id of the thingType that produces the event
+
##: [[File:relay-home-automation.svg|35px]] [[NCDXbee900Relay]]
−
**** #{thingId} Unique id of the instances that produces the event
+
##: [[File:energy-monitor.svg|35px]] [[NCDXbee900EnergyMonitor]]
−
**** #{tenantId} Tenant id used to authenticate the m2mBridge, defined at bridgeConfig.json tenant property
+
##: [[File:ncd-i2c.png|65px]] [https://store.ncd.io/shop/?fwp_interface=900hp-s3b NCD devices supporting XBee-Pro 900HP communication]
−
**** #{userId} User id used to authenticate the m2mBridge, defined at bridgeConfig.json userId property
+
<!-- ## [[File:libelium.svg|45px]] [[waspmoteBLECentral]]-->
−
 
+
##: [[File:libelium.svg|65px]] [http://www.libelium.com/libeliumworld/waspmote/ Libelium waspmote]
−
== How to implement a new plugin ==
+
##:: [[File:SmartEnvironment.jpg|65px]] [[Smart environment PRO]]
−
*Clone git repository (https://github.com/AMTechMX/M2MBridge.git)
+
##:: [[File:SmartAgriculture.png|65px]] [[Smart Agriculture]]
−
**at /.../M2MBridge/plugins create a directory that matched with the Thing type name to bridge example SNMPDevice (See [[Activities#Thing types|Thing types]])
+
##:: [[File:SmartWater.jpg|65px]] [[Smart Water]]
−
*Create a thing type XXXDevice (See [[Activities#Thing types|Thing types]])
+
##:: [[File:SmartWaterIons.png|65px]] [[Smart Water Ions]]
−
*Create the observations type the thing XXXDevice produces or consumes, example XXXDeviceObserv1 (See [[Sensor's network#Observations and observation types|Observations and observation types]])
+
##:: [[File:SmartCities.jpg|65px]] [[Smart Cities]]
−
*Associate the observation XXXDeviceObserv1 type to the XXXDevice
+
##:: [[File:SmartParking.jpg|65px]] [[Smart Parking]]
−
*Implement a nodejs module with the following interface
+
##:: [[File:SmartSecurity.jpg|65px]] [[Smart Security]]
−
 
+
##:: [[File:Radiation.png|65px]] [[Radiation]]
−
<syntaxhighlight lang="javascript">
+
##:: [[File:AmbientControl.png|65px]] [[Ambient Control]]
−
    function XXXThing() {
+
−
    }
+
−
 
+
−
    XXXThing.prototype.start = function ( complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    XXXThing.prototype.stop = function (complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    XXXThing.prototype.command = function (observation, complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    module.exports.XXXThing = XXXThing;
+
−
</syntaxhighlight>
+
−
 
+
−
== How to install ==
+
−
*Clone git repository (https://github.com/AMTechMX/M2MBridge.git)
+
−
*Install nodejs https://nodejs.org/en/download/package-manager/
+
−
*Install npm (http://blog.npmjs.org/post/85484771375/how-to-install-npm)
+
−
*Delete at /.../M2MBridge/plugins/xxx unneeded plug-ins (optional)
+
−
*Install packages for m2mBridge core and plug-ins (https://docs.npmjs.com/cli/install:)
+
−
*Execute npm install at:
+
−
**M2MBridge directory
+
−
**each plug-in directory
+
−
 
+
−
== HelloWorld plugin ==
+
−
=== Create thing type HelloWorld ===
+
−
*add supported property type string hwgreetingLabel (See [[Activities#Thing types|Thing types]])
+
−
**string without space validation regexp ^[^\s]+$
+
−
*add supported property type integer hwSayHelloFrequency
+
−
 
+
−
=== Create observation type obsrvHelloWorld ===
+
−
*add supported property type string hwgreetingLabel (See [[Sensor's network#Observations and observation types|Observations and observation types]])
+
−
*clone obsrvHelloWorld with name commandHelloWorld
+
−
 
+
−
=== Define observation types produce or consume by the Thing ===
+
−
*add obsrvHelloWorldobservation to Observation Production configuration list (See [[Activities#Thing types|Thing types]])
+
−
*add commandHelloWorldobservation to Observation Production configuration list
+
−
*add observationresourcecrud to Observation Production configuration list
+
−
 
+
−
=== Implement plugin HelloWorld interface ===
+
−
*create a directory with the thing type name HelloWorld at (See [https://github.com/AMTechMX/M2MBridge/tree/master/plugins plugin directory] )
+
−
*at the directory HelloWorld create a javascript file HelloWorld.js
+
−
*implement the interface (See [[M2MBridge# How to implement a new plugin| How to implement a new plugin]])
+
−
<syntaxhighlight lang="javascript">
+
−
    function HelloWorld() {
+
−
    }
+
−
 
+
−
    HelloWorld.prototype.start = function (complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    HelloWorld.prototype.stop = function (complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    HelloWorld.prototype.command = function (observation, complete) {
+
−
        try {
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    module.exports.HelloWorld = HelloWorld;
+
−
</syntaxhighlight>
+
−
 
+
−
=== Functionality ===
+
−
*send an observation obsrvHelloWorldobservation with the frequency set by the property hwSayHelloFrequency
+
−
*change hwgreetingLabel value when receive command obsrvHelloWorld observation
+
−
*implement placeholder #{greetingLabel}
+
−
*start method
+
−
**create an observation type obsrvHelloWorld at /amtech/things/observations (See [[Simulator|Simulator]])
+
−
**copy observation instance jsonld
+
−
<syntaxhighlight lang="javascript">
+
−
    var clone = require('clone');
+
−
    var util = require('util');
+
−
 
+
−
    function HelloWorld() {
+
−
    }
+
−
 
+
−
    HelloWorld.prototype.start = function (complete) {
+
−
        var self = this;
+
−
        try {       
+
−
            self.sayHelloInterval = setInterval(function(){
+
−
                var obsrvHelloWorld = clone({
+
−
                    "proximityarea": "",
+
−
                    "topic": "",
+
−
                    "guestusers": [],
+
−
                    "targetthings": "[]",
+
−
                    "location": "",
+
−
                    "@type": "/amtech/linkeddata/types/composite/observation/obsrvHelloWorld",
+
−
                    "hwgreetingLabel": "",
+
−
                    "creationDate": "2016-04-20T03:24:54.099Z",
+
−
                    "guesttenants": [],
+
−
                    "description": "",
+
−
                    "producer": ""
+
−
                });
+
−
                obsrvHelloWorld.hwgreetingLabel = self.hwgreetingLabel;
+
−
                var ph = {'greetingLabel': self.hwgreetingLabel};
+
−
                self.sendObservation(self,obsrvHelloWorld, ph );           
+
−
            }, self.hwSayHelloFrequency);
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    HelloWorld.prototype.stop = function (complete) {
+
−
        try {
+
−
            if (this.sayHelloInterval) {
+
−
                clearInterval(this.sayHelloInterval);
+
−
            }
+
−
            complete(null);
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    HelloWorld.prototype.command = function (observation, complete) {
+
−
        try {
+
−
            if(observation['@type'] === "/amtech/linkeddata/types/composite/observation/commandHelloWorld"){
+
−
                this.hwgreetingLabel = observation.hwgreetingLabel;
+
−
                complete(null);
+
−
            }else{
+
−
                complete(new Error(util.format("HelloWorld %s support commands of observations type commandHelloWorld", this._name)));
+
−
            }
+
−
        } catch (e) {
+
−
            complete(e);
+
−
        }
+
−
    };
+
−
 
+
−
    module.exports.HelloWorld = HelloWorld;
+
−
</syntaxhighlight>
+
−
 
+
−
=== Configure amtechM2MBridge template ===
+
−
*(See [[M2M Bridge#Cloud Configuration|Cloud Configuration]])
+
−
*create activity helloWorld (See [[Activities|Activities]])
+
−
*create helloWord notification (See [[Notifications|Notifications]])
+
−
**add subject with placeholder #{label}
+
−
**add subject with placeholder #{producer} and #{label}
+
−
*create helloWorld actor with access polices (See [[Access control#Actors|Actors]])
+
−
**amtechM2MBridge thing type
+
−
**HelloWord thing type
+
−
**helloWord notification
+
−
**associate helloWorld actor with helloWorld activity
+
−
*configure observation production (See [[Activities#Observation production configuration|Observation production configuration]])
+
−
** thing type HelloWorld
+
−
***observation type obsrvHelloWorld
+
−
****topic /helloWorld/#{greetingLabel}
+
−
****producer #{thingId}
+
−
****guestTeants add m2mcreator to shared the observation
+
−
***observation type observationresourcecrud
+
−
****topic /helloWorld/asynch
+
−
****producer #{thingId}
+
−
** thing type amtechM2mBridge
+
−
***observation type observationresourcecrud
+
−
****topic /helloWorld/asynch
+
−
****producer #{thingId}
+
−
*create observation simulation for observation type obsrvHelloWorld (to be used in observers)
+
−
*create helloWorld observer (See [[Observers|Observers]])
+
−
**type observation obsrvHelloWorld
+
−
**test observer
+
−
*create helloWorld reazoner (See [[Reasoners|Reasoners]])
+
−
**add action send notification type helloWorld
+
−
**add action send command
+
−
**test and validate reasoner
+
−
*publishing activity (See [[Publishing|Publishing]])
+
−
**validate activity
+
−
**deploy activity
+
−
*invite a user as helloWorld actor (See [[Access control#Actors|Invite user]])
+
−
**user id smartsensor@amtech.mx
+
−
*configure helloWorld m2mBridge template
+
−
** create amtechM2MBridge instance with name helloWorld (See [[IoT Semantics|Instances]])
+
−
***it will be the value of templateId at bridgeConfig.json (See [[M2M Bridge#Edge Configuration|Edge Configuration]])
+
−
**create HelloWorld type instace with name helloWorld
+
−
**associate HelloWorld instance to amtechM2MBridge instance
+
−
**give guest access to helloWorld M2MBridge instance to tenant m2mfollower and user smartsensor@amtech.mx
+
−
*add new action send Command to reasoner helloWorld
+
−
**thing type HelloWorld
+
−
**observation type commandHelloWorld
+
−
**set topic to /helloWorld/asynch
+
−
**set target uri to observation producer (See [[Sensor's network#Observations and observation types|targetthings]])
+
−
**set hwgreetingLabel holaFromCommand
+
−
 
+
−
=== bridgeConfig.json ===
+
−
*(See [[M2M Bridge#Edge Configuration|Edge Configuration]])
+
−
<syntaxhighlight lang="jsonld">
+
−
    {
+
−
        "description": "AMTech M2M Bridge Helloworld demo",
+
−
        "description:children" : true,
+
−
        "dap":{
+
−
            "dapUrl": "https://dapdev.amtech.mx",
+
−
            "userId": "smartsensor@amtech.mx",
+
−
            "tenant" : "m2mfollower",
+
−
            "password" :"xxxxxxxx"
+
−
        },
+
−
        "templateId":"helloWorld",
+
−
        "bridgeIdPrefix":"helloWorldDemo",
+
−
        "location:children" : true,
+
−
        "address" :{
+
−
            "country" : "USA",
+
−
            "city": "New York City",
+
−
            "road" : "97th street transverse"
+
−
        }   
+
−
    }
+
−
</syntaxhighlight>
+
−
 
+
−
=== Debug a plugin ===
+
−
*node-inspector &
+
−
**[https://greenido.wordpress.com/2013/08/27/debug-nodejs-like-a-pro/ Debug NodeJS Like A Pro]
+
−
**[https://mattdesl.svbtle.com/debugging-nodejs-in-chrome-devtools Debugging Node.js in Chrome DevTools]
+
−
*visit http://127.0.0.1:8080/?ws=127.0.0.1:8080&port=5858
+
−
 
+
−
== Example plugins (See [https://github.com/AMTechMX/M2MBridge/tree/master/plugins exiting plugins])==
+
−
 
+
−
=== LLRPReader ===
+
−
Bridge EPC Low Level reader protocol to IoT DAP (See [https://github.com/AMTechMX/M2MBridge/tree/master/plugins/LLRPReader LLRPReader]) and /amtech/linkeddata/types/composite/entity/LLRPReader
+
−
*Edge Intelligence
+
−
**Implementing smoothing for new and lost tag
+
−
**EPC decoding
+
−
**Groups tags read by antennas groups
+
−
**Groups tags by EPC decoding.
+
−
*Placeholders (See [[Observation enrichment#Placeholders substitution|Placeholders]])
+
−
** #{antennaId} Llrp protocol antenna Id set at antennas supported property
+
−
** #{smoothingResult} if smoothing has been set to true LLRP reader observations can be sent to a topic depending of the smoothing process result [new|lost]  
+
−
** #{llrpReaderProximity} Set the llrp reader proximity area supported property value to targetThing proximity value field
+
−
** #{antennaProximity} Set the llrp antenna proximity area supported property value to targetThing proximity value field
+
−
** #{tagEncoding} EPC encoding name
+
−
**A component of  decoded epc tag; helpful to organize epc observations; for example company-prefix to inform companies about products arrival or set access control.      
+
−
    #{epcUri|companyPrefix|itemReference|serialNumber|
+
−
    serialReference|locationReference|extension|assetType|
+
−
    individualAssetReference|serviceReference|documentType|
+
−
    managerNumber|objectClass|cAGEOrDODAAC}
+
−
*Produced observations (see /amtech/linkeddata/types/composite/observation)
+
−
**/amtech/linkeddata/types/composite/observation/observationresourcecrud
+
−
**/amtech/linkeddata/types/composite/observation/graiEPC
+
−
**/amtech/linkeddata/types/composite/observation/graiEPC
+
−
**/amtech/linkeddata/types/composite/observation/decode96EPC
+
−
**/amtech/linkeddata/types/composite/observation/sgtinEPC
+
−
**/amtech/linkeddata/types/composite/observation/dodEPC
+
−
**/amtech/linkeddata/types/composite/observation/giaiEPC
+
−
**/amtech/linkeddata/types/composite/observation/ssccEPC
+
−
**/amtech/linkeddata/types/composite/observation/gdtiEPC
+
−
**/amtech/linkeddata/types/composite/observation/llrpError
+
−
**/amtech/linkeddata/types/composite/observation/dataEPC
+
−
**/amtech/linkeddata/types/composite/observation/encoded96EPC
+
−
**/amtech/linkeddata/types/composite/observation/gidEPC
+
−
*Commands (see /amtech/linkeddata/types/composite/observation)
+
−
**/amtech/linkeddata/types/composite/observation/gpoWriteDataEPC
+
−
 
+
−
=== BLEbeaconsScanner ===
+
−
Bridge bluetooth low energy apple's ibecon and google's eddystone protocols to IoT DAP (See [https://github.com/AMTechMX/M2MBridge/tree/master/plugins/BLEbeaconsScanner BLEbeaconsScanner]) and /amtech/linkeddata/types/composite/entity/BLEbeaconsScanner
+
−
*Edge Intelligence
+
−
**Implementing smoothing for new, broadcast and lost tag
+
−
*Placeholders (See [[Observation enrichment#Placeholders substitution|Placeholders]])
+
−
** #{smoothingResult} if smoothing has been set to true EddystoneScan observations can be sent to a topic depending of the smoothing process result [new|lost|broadcast]
+
−
** #{eddystoneType} Eddystone frame types, permissible values are uid, url and tlm
+
−
***uid broadcasts an opaque, unique 16-byte Beacon ID composed of a 10-byte namespace and a 6-byte instance.  
+
−
***url broadcasts a URL using a compressed encoding format in order to fit more within the limited advertisement packet.
+
−
***tlm telemetrics
+
−
** #{eddystoneNamespace} 10-byte ID Namespace
+
−
** #{eddystoneInstance} 6-byte ID Instance
+
−
** #{proximityarea} Set the EddystoneHub proximity area supported property value to targetThing proximity value field
+
−
** #{bleProtocol} [eddystone|ibeacon]  
+
−
** #{ibeaconUuid'} iBeacon advertised uuid
+
−
** #{'ibeaconMajor'} iBeacon advertised major
+
−
** #{'ibeaconMinor'} iBeacon advertised minor
+
−
** #{'ibeaconProximity} current proximity from sacanner [unknown|immediate|near|far]
+
−
*Produced observations (see /amtech/linkeddata/types/composite/observation)
+
−
**/amtech/linkeddata/types/composite/observation/observationresourcecrud
+
−
**/amtech/linkeddata/types/composite/observation/ibeaconScan
+
−
**/amtech/linkeddata/types/composite/observation/eddystoneBrodcast
+
−
**/amtech/linkeddata/types/composite/observation/eddystoneScan
+
−
**/amtech/linkeddata/types/composite/observation/eddystoneScan
+
−
 
+
−
=== SNMPDevice ===
+
−
Bridge simple network management protocol  to IoT DAP (See [https://github.com/AMTechMX/M2MBridge/tree/master/plugins/SNMPDevice SNMPDevice]) and /amtech/linkeddata/types/composite/entity/SNMPDevice
+
−
*Edge Intelligence
+
−
**Groups multiple snmp reads and writes in a single call
+
−
**Maps snmp oid into human readable names
+
−
*Produced observations (see /amtech/linkeddata/types/composite/observation)
+
−
**/amtech/linkeddata/types/composite/observation/observationresourcecrud
+
−
**/amtech/linkeddata/types/composite/observation/snmpError
+
−
**/amtech/linkeddata/types/composite/observation/snmpTrap
+
−
*Commands (see /amtech/linkeddata/types/composite/observation)
+
−
**/amtech/linkeddata/types/composite/observation/snmpSet
+

Latest revision as of 12:16, 14 January 2019

AmtechM2mBridge.svg M2MBridge is a software stack that implements M2M edge functionality leveraging AMTech IoT Protocol

  1. Functionality
  2. Configuration example
  3. M2MBridge network
    Aggregation
    Edge reasoners
    Mesh network
  4. Intelligence at the Edge
    What is a plugin?
    EPC (Electronic product code)
    Smoothing observations
  5. Observations production and consumption
  6. Cloud Configuration
    Observation production config
    Validation
    Sample configuration for beacons
  7. Automatic updates on bridge instance delete
  8. Implementation notes
  9. How to implement a new plugin
  10. Set up a new Raspberry PI
  11. M2MBridge Edge Configuration
  12. M2MBridge updates
  13. How to install & execute
  14. HelloWorld plugin
  15. Supported plugins
    1. Wi-fi.svg Tcp-ip.svg Wifi or RJ45 Ethernet
      SNMPDevice.svg SNMPDevice
      LLRPReader.svg LLRPReader
      LLRPAntenna.svg LLRPAntenna
      Thing-magic.svg ThingMagicEPCReader
      LLRPAntenna.svg LLRPAntenna
      Plc-icon.svg OPCUADevice
      Modbus.svg ModbusDevice
      WioGeneric.png Wio Devices (troubleshooting inside)
      WioNode.svg.svg wioNode
      WioLink.svg wioLink
    2. Bt.svg BLE 4.0
      BLEbeaconsScanner.svg BLEbeaconsScanner
      BleOBDScanner.svg BLEODB2Scanner
      BLEPeripheralsScanner.svg BLEPeripheralsScanner
      BluvisioniBEEK.jpg BLEBluvisionBeeksScanner
      BLEGattCentral.svg BLEGattCentral
    3. I2c.svg I2C
      Watersensor.svg PCA9536I2CWaterDetectionWithBuzzer
      TSL2561Light.svg TSL2561I2CLight
      Soundvibration.svg ADC121C021I2CSoundVibrationShock
      Ncd-i2c.png NCD I2C devices
      Grove-log.png Grove devices via I2C
    4. Usb-logo.svg USB 2.0
      Thing-magic.svg ThingMagicEPCReader
      LLRPAntenna.svg LLRPAntenna
      Phidgets-Logo.png Phidgets USB sensors
    5. Xbee-pro-900hp.svg XBee-Pro 900HP
      Relay-home-automation.svg NCDXbee900Relay
      Energy-monitor.svg NCDXbee900EnergyMonitor
      Ncd-i2c.png NCD devices supporting XBee-Pro 900HP communication
      Libelium.svg Libelium waspmote
      SmartEnvironment.jpg Smart environment PRO
      SmartAgriculture.png Smart Agriculture
      SmartWater.jpg Smart Water
      SmartWaterIons.png Smart Water Ions
      SmartCities.jpg Smart Cities
      SmartParking.jpg Smart Parking
      SmartSecurity.jpg Smart Security
      Radiation.png Radiation
      AmbientControl.png Ambient Control
Retrieved from "http://wiki.amtech.mx/mediawiki/index.php?title=M2M_Bridge&oldid=3918"