Newline Proliferating Maniac
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    svd-xbeepublic

    NOTE!

    Check out xbee-api. It separates out the API component and is aimed at being a more solid and tested module for working with XBees. New higher level modules based on xbee-api are in development here: xbee-stream and here xbee-nodes.

    SVD-XBEE

    Digi's xbee modules are good for quickly building low power wireless networks. They can be used to send/receive text data from serial ports of different devices. XBees can also be used alone for their on board digital and analog I/O capabilities.

    svd-xbee is a high level, actively maintained fork of Richard Morrison's node-xbee. It talks the ZigBee API with XBee radio modules over serial connections and provides high level abstractions of the XBee's functionality.

    Nutshell

    var XBee = require('svd-xbee');
     
    var xbee = new XBee({
      port: 'COM3',   // replace with yours 
      baudrate: 9600 // 9600 is default 
    }).init();
     
    var robot = xbee.addNode([0x00,0x13,0xa2,0x00,0x40,0x61,0xaa,0xe2]);
     
    var robot.on("data", function(data) {
        console.log("robot>", data);
        if (data == "ping") robot.send("pong");
    });

    Features

    • Asynchronous architecture
    • Event-based Node Discovery
    • Local and remote AT commands
    • High-level abstraction of common tasks
    • Parse API frames into meaningful objects
      • Regular text data
      • Analog & Digital I/O Samples
      • Modem Status
      • Transmission Reports

    Installation

    npm install svd-xbee
    

    Documentation

    For documentation, see the Documentation.

    EXAMPLES

    See the examples folder in the repository for more examples.

    SUPPORTED XBEE MODELS

    Both ZNet 2.5 and ZIGBEE modules should be supported. Since ZIGBEE offers more features and is more robust, you might be interested in upgrading your modules from ZNet 2.5 to ZIGBEE: upgradingfromznettozb.pdf.
    Development is done using Series 2 XBee modules with XB24-ZB (ZIGBEE) firmware. In specific, this document is used as reference: 90000976_M.pdf.

    MODULE CONFIGURATION

    The module communicating with svd-xbee must be set to use an API function set with escape characters enabled (ATAP = 2). Other nodes in the network can be configured however you find it convenient. See Module Configuration for more details.

    ACKNOWLEDGMENTS

    LICENSE

    This work by Jan Kolkmeier is licensed under a Creative Commons Attribution-ShareAlike 2.0 UK: England & Wales License.
    Creative Commons License
    Based on a work at github.com.

    install

    npm i svd-xbee

    Downloadslast 7 days

    19

    version

    0.3.6

    license

    none

    repository

    github.com

    last publish

    collaborators

    • avatar