Difference between revisions of "M2M Bridge"

From AMTech WikiDocs
Jump to: navigation, search
(→‎Configuration)
 
(468 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
−
* Configurable edge intelligence
+
# [[M2MBridge Functionality|Functionality]]
−
* Bridges standard and proprietary protocols to AMTech IoT DAP.
+
# [[Configuration example]]
−
* Device-to-device or device-to-server communications.
+
# [[M2MBridge network]]
−
** MQTT, LLRP, CoAP, STOMP, SmartM2M, LWM2M, PLC, Zigbee and others
+
#: [[Aggregation]]
−
* Allow remote and centralized control of IoT devices and gateways.
+
#: [[Edge reasoners]]
−
** SNMP/MIB/TRAP, Reader Management and other
+
#: [[Mesh network]]
−
* Configurable autodiscover
+
# [[Intelligence at the Edge]]
−
* Implements common functionality and host the execution of the protocols
+
#: [[WhatIsAPlugin|What is a plugin?]]
−
* Network failure detection and recovery
+
#: [[EPC (Electronic product code)]]
−
* Get centralized configuration information at startup and real time modifications
+
#: [[Smoothing observations]]
−
* Access control policies to manage observation production and consumption
+
# [[Observations production and consumption]]
−
[[File:Example.jpg]]
+
# [[Cloud Configuration]]
−
 
+
#: [[Observation production config]]
−
== Configuration ==
+
#: [[Validation]]
−
*Edge/Device(s) site configuration bridgeConfig.json #1
+
#: [[Sample configuration for beacons]]
−
**located at M2MBridge root directory.
+
# [[Automatic updates on bridge instance delete]]
−
    {
+
# [[Implementation notes]]
−
    <span style="color:red">//text to label bridge instance</span>
+
# [[How to implement a new plugin]]
−
    "description": "AMTech M2M Bridge",
+
# [[Set up a new Raspberry PI]]
−
        "dap":{
+
# [[Edge Configuration|M2MBridge Edge Configuration]]
−
            <span style="color:red">//amtech IoT DAP ur</span>
+
# [[M2MBridge updates]]
−
            "dapUrl": "https://dap.amtech.mx",   
+
# [[How to install & execute]]
−
            <span style="color:red">//userid for the m2mBridge instance</span>
+
# [[HelloWorld plugin]]
−
            "userId": "xxxxxxx@amtech.mx",
+
# Supported plugins
−
            <span style="color:red">// tenant where bridge been configured</span>     
+
## [[File:wi-fi.svg|35px]] [[File:tcp-ip.svg|35px]] [https://en.wikipedia.org/wiki/Ethernet Wifi or RJ45 Ethernet]
−
            "tenant" : "xxxxxxx", 
+
##: [[File:SNMPDevice.svg|35px]] [[SNMPDevice]]
−
            <span style="color:red">//m2mBridge userId password</span> 
+
##: [[File:LLRPReader.svg|35px]] [[LLRPReader]]
−
            "password" :"xxxxxxxx",
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
            <span style="color:red">//topic to get crud and command observations</span>
+
##: [[File:thing-magic.svg|35px]] [[ThingMagicEPCReader]]
−
            "crudCommandUrl" :"/xx/xx/"
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
        },
+
##: [[File:plc-icon.svg|35px]] [[OPCUADevice]]
−
        <span style="color:red">//access control information add to send observations</span>
+
##: [[File:modbus.svg|45px]] [[ModbusDevice]]
−
        "guestSecurity":{
+
##: [[File:wioGeneric.png|45px]] [[Wio Devices]] (troubleshooting inside)
−
            <span style="color:red">//add guest tenants to observations send from bridge</span>
+
##:: [[File:wioNode.svg.svg|35px]] [[wioNode]]
−
            "guesttenants":["progressnext2016"],   
+
##:: [[File:wioLink.svg|35px]] [[wioLink]]
−
            <span style="color:red">//add guest users to observations send from bridge</span>
+
## [[File:bt.svg|35px]] [https://en.wikipedia.org/wiki/Bluetooth_Low_Energy BLE 4.0]
−
            "guestusers":[]      
+
##: [[File:BLEbeaconsScanner.svg|35px]] [[BLEbeaconsScanner]]
−
        },
+
##: [[File:bleOBDScanner.svg|35px]] [[BLEODB2Scanner]]
−
        "networkFailed" :{
+
##: [[File:BLEPeripheralsScanner.svg|35px]] [[BLEPeripheralsScanner]]
−
            "retries" : 5,
+
##: [[File:BluvisioniBEEK.jpg|65px]] [[BLEBluvisionBeeksScanner]]
−
            "failedWait" : 3000,
+
##: [[File:BLEGattCentral.svg|35px]] [[BLEGattCentral]]
−
            "reconnectWait" : 60000         //re-connection delay after an instance of plug in failed
+
## [[File:i2c.svg|35px]] [https://en.wikipedia.org/wiki/I%C2%B2C I2C]
−
        },
+
##: [[File:watersensor.svg|35px]] [[PCA9536I2CWaterDetectionWithBuzzer]]
−
        "pluginLoad" :{         //bridge startup configuration
+
##: [[File:TSL2561Light.svg|65px]] [[TSL2561I2CLight]]
−
            "sendM2mBridgeError" : true //send observations error when errors occurred at bridge layer
+
##: [[File:soundvibration.svg|35px]] [[ADC121C021I2CSoundVibrationShock]]
−
        },
+
##: [[File:ncd-i2c.png|65px]] [https://store.ncd.io/shop/?fwp_interface=i2c-interface NCD I2C devices]
−
        "logger" :{
+
##: [[File:grove-log.png|65px]] [https://www.seeedstudio.com/category/Grove-c-1003%7C%7C24.html?p=0 Grove devices via I2C]
−
            "colorize" : true, //colorize log console messages
+
## [[File:usb-logo.svg|35px]] [https://en.wikipedia.org/wiki/USB USB 2.0]
−
            "level": "debug" //log level
+
##: [[File:thing-magic.svg|35px]] [[ThingMagicEPCReader]]
−
        },
+
##:: [[File:LLRPAntenna.svg|35px]] [[LLRPAntenna]]
−
        "address" :{ //Address use to geo locate m2mBridge instance
+
##: [[File:Phidgets-Logo.png|65px]] [https://www.phidgets.com/?tier=0&catid=3&pcid=12 Phidgets USB sensors]
−
            "country" : "usa",
+
<!--##:[[File:modbus.svg|45px]] [[ModbusDevice]]-->
−
            "city": "Las Vegas",
+
## [[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]
−
            "road": "Las Vegas Boulevard South",
+
##: [[File:relay-home-automation.svg|35px]] [[NCDXbee900Relay]]
−
            "number":"3960"
+
##: [[File:energy-monitor.svg|35px]] [[NCDXbee900EnergyMonitor]]
−
        },
+
##: [[File:ncd-i2c.png|65px]] [https://store.ncd.io/shop/?fwp_interface=900hp-s3b NCD devices supporting XBee-Pro 900HP communication]
−
        "bridgeId":"m2mBridgeProgressNext",      //Id to uniquely identify m2m Bridge instance, in absence of this    property a unique identifier gets created
+
<!-- ## [[File:libelium.svg|45px]] [[waspmoteBLECentral]]-->
−
        "autoDiscover":{
+
##: [[File:libelium.svg|65px]] [http://www.libelium.com/libeliumworld/waspmote/ Libelium waspmote]
−
            "execute" : false,                        //create things type instances at startup time
+
##:: [[File:SmartEnvironment.jpg|65px]] [[Smart environment PRO]]
−
            "instances":{"SNMPDevice":[{...}], ...} //Jsonld instances to be created
+
##:: [[File:SmartAgriculture.png|65px]] [[Smart Agriculture]]
−
        }
+
##:: [[File:SmartWater.jpg|65px]] [[Smart Water]]
−
    }
+
##:: [[File:SmartWaterIons.png|65px]] [[Smart Water Ions]]
−
 
+
##:: [[File:SmartCities.jpg|65px]] [[Smart Cities]]
−
== Extensible ==
+
##:: [[File:SmartParking.jpg|65px]] [[Smart Parking]]
−
 
+
##:: [[File:SmartSecurity.jpg|65px]] [[Smart Security]]
−
== Pluggable architecture ==
+
##:: [[File:Radiation.png|65px]] [[Radiation]]
−
 
+
##:: [[File:AmbientControl.png|65px]] [[Ambient Control]]
−
== Existing plugins ==
+
−
 
+
−
=== LLRP ===
+
−
 
+
−
=== Bluetooth ===
+

Latest revision as of 11: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"