Overview

Skill Level: Any Skill Level

Ingredients

Hardware requirements

  • Spectre Network Gateway
  • BM Module for Spectre Network Gateway
  • Wzzard Intelligent Edge Nodes
  • Sensors
  • Wzzard Android App

Step-by-step

  1. Prepare

    Get your device ready

    1. Connect the Spectre router to the internet. Refer to the Gateway Quickstart Guide as the first step for instruction on how to commission your network gateway.

    2. If you are using the Ethernet port on the gateway to connect to the internet. Follow the instructions below:
      • Determine an unused IP address on your network outside the DHCP pool as well as your mask, gateway IP, and DNS server IP.
      • Connect a computer directly to the ETH port on the gateway.
      • Open a browser and log in to the gateway. Default IP address is 192.168.1.1. Username and password are both root
      • Select LAN under the Configuration section on the left side.
      • On Primary LAN set DHCP Client to Disabled
      • Enter the IP address, Mask, Gateway, and DNS server address you determined in step 1.
      • Set Bridged to yes, and Media Type to auto-negotiate
      • Uncheck Enable dynamic DHCP leases.
      • On Secondary LAN set DHCP Client to disabled, and Media Type to auto-negotiation
      • Click Apply button at the bottom of LAN Configuration menu

    3. Make sure the IoT user module is installed:

      • Connect a computer to the Ethernet port on the router.
      • Browse to the IP address of the router (default is 192.168.1.1) and the web interface will load.
      • On the side bar, under Customization, click the link to the User Modules settings page.
      • Ensure the IoT Gateway Module exists.
      • Open the module page and click IoT Gateway, On the IoT Gateway page, ensure the MQTT Broker is enabled on port 1883.
    4. Refer to the Wzzard SmartMesh IP Quick Start Guide for details on connecting sensors and commissioning Wzzard Edge Nodes.
  2. Connect (QuickStart)

    Internet of Things Cloud QuickStart connection

    1. Add the module to the router through the web interface:
      • Browse to the IP address of the router as above. The web interface will load if it is not still up from a previous step
      • On the side bar, under Customization, click the link to the User Modules settings page.
      • On the page, there will be an option to browse your file system for a user module.
      • Click the Add or Update button and wait for the confirmation screen to appear.
      • The new user module should appear in the list as IBM Message Router. Click this and you will be directed to the web interface for this module.

    2. Configure:
      • Set the publish mode to Quickstart and leave the rest of the configuration as is.
      • The module should start automatically. Click on System Log to open log and ensure it is started.
      • If the router fails to connect for any reason (cellular network drop out) it will need restarting which can be done in the web interface for the module by clicking Restart Module.
  3. Visualize

    To view the data, simply visit Quickstart and type in the MAC address of your chosen device.

    (Locate the MAC address of the Spectre Gateway on the General page of the router interface)

  4. Register your Device In Watson IoT Platform

    To explore and make use of full capabilities of Watson IoT Platform, we need to setup and register your device(s) in it. This section shows how you can setup the same.

    Carry out the steps present in this recipe to register your device(s) in IBM Watson Internet of Things Platform.

    At this step, we have successfully created the Watson IoT service and registered your device(s) in it.

  5. Connect (Registered)

    Internet of Things Cloud Registered connection

    1. Configure:
      • Set the publish mode to Registered and supply the organisation ID, device type ID, and authentication token given to you by IBM when you registered the device.
      • Apply the changes and the module should start sending messages to the IBM portal in registered mode.

    2. View system log to check if module is started / running.

      • The module should start automatically but if the router fails to connect to the IBM site for any reason (Cellular network drop out) it will need restarting which can be done in the web interface for the module.
      • The system log will also show whether the module stopped running with a message explaining why.
  6. Troubleshooting

    When setting up the registered connection, you may experience problems entering the token supplied by IBM. The current implementation does not allow the following characters cannot be entered on the IBM Message Router user-module configuration page:

      • ampersand (&)
      • double quotation mark ()
      • greater than symbol (>)
      • less than symbol (<
    The observed behaviour is that these characters are silently removed when the configuration is saved to the settings file. The work around when these characters are required is to edit the settings file manually instead of using the configuration page.
    SSH can be used to log into the router. The settings file for the IBM Message Router can be changed using vi: /opt/ibm_message_router/etc/settings.

Expected Outcome

In a few minutes this tutorial will help you connect your device to Quicktart in IBM's Internet of Things (IoT) Foundation and show you real-time data from your device. It'll then let you register your device ready to write your first application.

Join The Discussion